ilovefiniki Instagram Reels Analyzer
Downloads public Instagram Reels safely without authenticating to any personal Instagram account (0% account ban risk), respects IP rate limits, and performs multimodal video, speech, and on-screen text analysis locally.
🛡️ Safety & Rate Limiting Rules
- Zero Personal Credentials: Never asks for or uses personal Instagram credentials or cookies. All downloads are performed anonymously.
- Built-in Rate Guard:
- Maximum 10 Reels per hour (rolling 60-minute window).
- Mandatory 15-second cooldown between consecutive downloads.
- Guard state is maintained in
~/.cache/reels_rate_limit.json.
- Graceful Handling on Limit: If the rate limit is hit, informs the user of the exact reset cooldown without crashing.
🚀 Execution Workflow
Step 1: Download with Rate Limiting
Run the downloader script passing the Reel URL and an output directory:
python3 scripts/download_reel.py "<INSTAGRAM_REEL_URL>" --output-dir "./output"
The script outputs structured JSON:
{
"success": true,
"file_path": "/path/to/video.mp4",
"id": "C7xxxxxx",
"title": "...",
"uploader": "username",
"duration": 28
}
Step 2: Multimodal Video & Audio Inspection
Use local video inspection tools or ffmpeg/whisper to extract:
- On-Screen Text (OCR): Subtitles, key text overlays, and hooks.
- Visual Progression: Scene transitions, product demonstrations, and visual actions.
- Spoken Dialogue: Full spoken transcript.
Step 3: Structured Output Format
### 🎬 Instagram Reel Breakdown
* **Creator:** @{uploader}
* **Duration:** {duration}s
* **Quota Remaining:** {remaining}/{max_per_hour}
---
#### 🎯 Hook & Core Thesis
{1-2 sentences explaining what the Reel is about and why it hooks attention}
#### 👁️ On-Screen Text (Captions / Overlays)
> "{Verbatim text overlays and on-screen cards}"
#### 🎞️ Visual Sequence & Scene Pacing
1. **00:00 - 00:03:** {Hook shot, visual setup, movement}
2. **00:04 - 00:15:** {Core demonstration / storytelling}
3. **00:16 - end:** {CTA, ending frame}
#### 💡 Key Takeaways
* {Insight 1}
* {Insight 2}