Instagram Analyzer
A comprehensive Instagram profile and post analysis tool with engagement metrics, view tracking, and Reels-focused analytics.
---
name: instagram-analyzer
description: Analyze Instagram profiles and posts with engagement metrics, view counts, follower ratios, and Reels analytics.
emoji: 📊
version: 1.0.0
author: Sencer
tags:
- instagram
- analytics
- engagement
- reels
- influencer
metadata:
clawdbot:
requires:
bins:
- python3
- chromium
pip:
- playwright
- beautifulsoup4
- lxml
config:
stateDirs:
- data/output
- data/profiles
- data/posts
outputFormats:
- json
- csv
---
🎯 Features
📊 Single Post Analysis
- ✅ Like count
- ✅ Comment count
- ✅ Save count
- ✅ View count (Reels)
- ✅ Follower count
- ✅ View-to-Follower ratio (%)
- ✅ Time posted (hours/days ago)
👤 Profile Analysis
- ✅ Minimum 60 posts analyzed
- ✅ Reels-focused analytics
- ✅ All Reels links extraction
- ✅ Engagement rate calculations
- ✅ JSON/CSV export
🔧 Technical
- 🌐 Browser simulation with Playwright
- 🛡️ Stealth mode (human behavior)
- 📁 Structured JSON/CSV output
- ⚡ Batch processing support
🚀 Usage
Profile Analysis (Default: Reels Only! 🎯)
# Full profile analysis - REELS FOCUS (default behavior)
analyze-profile "username"
# With custom post count
analyze-profile "username" --posts 60
# All posts (including regular posts)
analyze-profile "username" --include-posts
Single Post Analysis
# Analyze a Reel/post URL
analyze-post "https://www.instagram.com/reel/ABC123xyz/"
# With JSON output
analyze-post "https://www.instagram.com/reel/ABC123xyz/" --output json
📊 Output Examples
Single Post Response
{
"post_type": "reel",
"url": "https://www.instagram.com/reel/ABC123xyz/",
"username": "example_user",
"metrics": {
"views": 125000,
"likes": 8542,
"comments": 312,
"saves": 892,
"followers": 125000,
"shares": 156
},
"ratios": {
"view_to_follower_percent": 100.0,
"like_to_view_percent": 6.83,
"comment_to_view_percent": 0.25,
"save_to_view_percent": 0.71
},
"timing": {
"posted_at": "2026-02-11T14:30:00",
"time_ago": "6 hours ago",
"age_hours": 6
}
}
Profile Analysis Response
{
"profile": {
"username": "example_user",
"full_name": "Example User",
"followers": 125000,
"following": 1500,
"posts_count": 450,
"is_verified": false
},
"analysis_summary": {
"total_posts_analyzed": 60,
"reels_analyzed": 45,
"analysis_mode": "reels_only",
"total_views": 5420000,
"average_views": 120444,
"average_engagement_rate": 8.2,
"top_reels": [...],
"reels_links": [
"https://www.instagram.com/reel/ABC123/",
"https://www.instagram.com/reel/DEF456/",
...
]
},
"engagement_breakdown": {
"avg_likes": 8542,
"avg_comments": 312,
"avg_saves": 892,
"engagement_rate": 7.8
}
}
📈 Engagement Metrics Explained
| Metric | Formula | Interpretation |
|---|---|---|
| View Rate | (Views / Followers) × 100 | How many followers actually watched |
| Engagement Rate | ((Likes + Comments + Saves) / Views) × 100 | Overall audience interaction |
| Like Rate | (Likes / Views) × 100 | Content appreciation |
| Save Rate | (Saves / Views) × 100 | Content value indicator |
⚙️ Configuration
Edit config/analyzer_config.json:
{
"scraper": {
"headless": false,
"min_followers": 1000,
"posts_to_analyze": 60,
"scroll_pause": 2,
"timeout": 30000
},
"browser": {
"stealth_mode": true,
"human_behavior": true,
"user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X)"
},
"output": {
"default_format": "json",
"save_reels_links": true,
"export_csv": true
}
}
📁 File Outputs
- Profile data:
data/profiles/{username}.json - Post analysis:
data/posts/{post_id}.json - Batch results:
data/output/batch_{timestamp}.json - Reels links:
data/output/{username}_reels.txt
🔧 Troubleshooting
Login Required
- Some metrics require login (view count, saves)
- Configure Instagram credentials in
.env
Rate Limiting
- Increase
scroll_pausein config - Reduce batch size
- Use multiple accounts
Missing Data
- Check if account is private
- Verify post exists and is accessible
- Instagram may hide some metrics
📝 Requirements
- Python 3.8+
- Playwright
- Chromium browser
- BeautifulSoup4
- lxml parser
