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
  }
}