PinMon

A self-hosted Pinterest monitoring bot that watches a Pinterest profile's RSS feed and automatically forwards new pins to a Telegram channel — with adaptive polling, image caching, dual-layer deduplication, and a scraper-based safety net to catch anything the RSS feed misses.

Configuration

[pinterest]
username = <pinterest username to monitor>

[telegram]
channel  = @your_channel
token    = <token_here>

[timing]
count_poll       = 3600
send_delay       = 3
fail_alert_at    = 3
min_interval     = 600
max_interval     = 7200
initial_interval = 1800

[paths]
db  = data/pins.db
log = logs/monitor.log

[logging]
file_level    = INFO
console_level = INFO

Running

python main.py

On startup you'll be asked:

1. Use username from config? — y to use config.ini, n to type one in.
2. Enable streamer mode? — y to mask the username as @**** in all output.

Telegram commands

Command	Description
/status	Live stats: interval, fail streak, pins, board sync state
/resync	Force an immediate board-count check and queue gaps

---

Project Structure

phs/
├── main.py             
├── tiny_db.py          # lightweight key-value store
├── config.ini          # configuration
├── data/               # pin database
├── logs/               # rotating log files
└── media/              # cached pin images

No warranty - Private source code