reelminner

Instagram Reel Scraper

Scrape Instagram reels using the user's own logged-in session (cookies). Two phases: Phase 1 scrapes each reel (username, music, likes, status), Phase 2 (optional, default on) visits each owner's profile to fetch the followers count.

Prerequisites

• storage_state.json in the project folder (created by logging in once via the GUI, or by import_cookies). If missing, tools return session_ready: false and every reel comes back session_expired.
• Playwright Chromium installed (python -m playwright install chromium).
• Respect rate limits: keep delay >= 1, workers <= 3 for large batches.

MCP Tools

scrape_reels

Signature: scrape_reels(urls: list[str], workers?: int = 2, delay?: float = 1.0, headless?: bool = true, with_profiles?: bool = true) -> dict

Scrapes the given reel URLs. Returns:

{
  "results": [
    {
      "reel_url": "https://www.instagram.com/reel/ABC/",
      "username": "shubham__travels",
      "followers": "32K",
      "music_title": "Dilbar (From \"Satyameva Jayate\")",
      "music_artist": "Neha Kakkar",
      "likes": "12,345",
      "comments": "89",
      "plays": "1.2M",
      "status": "ok"
    }
  ]
}

Param	Type	Default	Notes
urls	list[str]	—	Required. Full reel URLs (any Instagram URL form is normalized).
workers	int	2	Parallel browser windows, 1-8. Use 2-3 for big batches.
delay	float	1.0	Seconds between reels per worker. Raise to 2-3 on rate limits.
headless	bool	true	Agents should keep true (no visible browsers).
with_profiles	bool	true	Phase 2: fetch owner profile + followers. Adds time per reel.

Status values: ok, timeout (retry already happened once), error, session_expired (cookies stale — ask the user to re-login), unavailable (deleted/private reel — expected).

Example call (via MCP client):

{
  "urls": ["https://www.instagram.com/reel/ABC/", "https://www.instagram.com/reel/DEF/"],
  "with_profiles": true,
  "delay": 2
}