Skip to content

Bot usage ​

Everything user-facing happens in the Telegram bot. Each chat is a separate user with its own accounts, cookie sets and defaults.

Commands ​

CommandWhat it does
/startMain menu
/accountsTracked accounts (tap one for stats, settings, pause, remove)
/addTrack an account: /add name, @name, a profile link or a t.me link
/removeStop tracking an account
/statsFollowers / following / posts with deltas, recent changes and trend charts
/settingsPer-account interval (5m → 1d), posts/stories/videos/stats toggles, cookie set
/defaultsInterval and toggles for accounts you add later
/loginAdd cookies (string, cookies.txt file, or browser cookie table)
/cookiesCookie sets: choose the ⭐ default, rename, delete (🌐 server sets are read-only)
/whoamiYour configuration
/cancelAbort the current input step
/helpHelp

Any command cancels a pending input step.

Adding accounts ​

/add natgeo (or ➕ Add account and then the name) fetches the profile and asks for confirmation:

You:   /add https://www.instagram.com/natgeo/
Bot:   👤 natgeo — National Geographic
       👥 283,000,000 followers · 🧑 150 following · 🖼 30,000 posts
       Track it?                        [✅ Track] [❌ Cancel]
  • Only new content is delivered from now on (no backfill).
  • The account starts with your /defaults (interval and toggles).
  • If the input is invalid or the profile can't be fetched, just send another name. The step stays open until you cancel it.

➕ From my following lists the accounts you follow (using your own ⭐ default cookie set) page by page; tap ➕ to add them one by one.

Managing an account ​

📊 natgeo
👤 National Geographic
👥 283,000,000 followers · 🧑 150 following · 🖼 30,000 posts
📅 tracked since 2026-08-10 12:34 UTC
⏱ every 30m · 🕒 last check 2m ago
📷 posts ✅ · 📖 stories ❌ · 🎬 videos ✅ · 👥 stats ✅

[📈 Stats] [⚙️ Settings] [⏸ Pause] [🗑 Remove] [◀️ Back]

In ⚙️ Settings you pick the check interval, toggle posts, stories, videos and stats, and choose the cookies for this account.

  • Videos off: video posts and stories arrive as caption + link.
  • Stats off: counters are still shown on the card but no history is kept.

Cookies ​

Instagram cookies unlock stories, private profiles and the following list. They are stored in the bot's database and only sent to Instagram.

Send them as:

  • a k=v; k2=v2 string. The minimum is sessionid, csrftoken, ds_user_id;
  • a cookies.txt file (Netscape format) sent as a document;
  • the cookie table copied from a browser extension.
You:   /login
Bot:   🔑 Add cookies — send k=v; k2=v2, a cookies.txt file, or a table
You:   sessionid=…; csrftoken=…; ds_user_id=…
Bot:   ✅ Cookies parsed (3 fields) — send your User-Agent or ⏭ Skip
You:   ⏭ Skip
Bot:   🏷 Name this cookie set — or ⏭ Skip (automatic name)
You:   work
Bot:   🔑 Cookies saved as work ⭐ (your default)
       ✅ Authenticated as Instagram id 123456789
  • The name step appears only when you add new cookies next to existing sets.
  • Sending cookies you already saved refreshes that set (and its User-Agent) in place.
  • The most recently saved set becomes your ⭐ default; switch it in /cookies.
  • Deleting a set unlinks it from accounts (they fall back to Auto); deleting the default promotes your newest remaining set.

Cookies per account ​

⚙️ Settings → 🔑 Cookies:

  • Auto: your ⭐ default set, else the server's 🌐 set, else anonymous;
  • a specific set, e.g. one belonging to an account that follows a private profile;
  • None: anonymous, public data only.

Statistics ​

When stats are on, a row is stored whenever followers, following or posts change. /stats shows the current counts with the delta to the previous change, sparkline trends and the most recent changes.

Notes ​

  • Stories need cookies of an Instagram account that can see them.
  • If a check fails, you get one warning when the account starts failing; the account shows ⚠️ until a check succeeds again.
  • Media is re-uploaded to Telegram; nothing is kept on disk.
  • Account names in messages link to the Instagram profile (no @-mentions).

Released under the MIT License. Not affiliated with Instagram or Meta.