.codex-plugin/plugin.json

{
  "name": "reelyze",
  "version": "0.1.0",
  "description": "Instagram Reels, TikTok and YouTube Shorts analytics: find out why a video underperformed, score the hook, get the transcript, and see what is trending.",
  "author": {
    "name": "Reelyze",
    "url": "https://getreelyze.com"
  },
  "homepage": "https://getreelyze.com",
  "keywords": [
    "instagram",
    "instagram reels",
    "instagram reel",
    "reels",
    "reel",
    "ig reels",
    "instagram analytics",
    "reel analytics",
    "tiktok",
    "tiktok analytics",
    "tiktoks",
    "youtube",
    "youtube shorts",
    "youtube short",
    "shorts",
    "short",
    "yt shorts",
    "short form video",
    "video analysis",
    "retention",
    "hook",
    "watch time",
    "views",
    "engagement",
    "transcript",
    "captions",
    "hashtags",
    "creator tools",
    "social media",
    "content creator"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Reelyze",
    "shortDescription": "Find why reels lose viewers",
    "longDescription": "Reelyze is a retention analyser for short-form video. Give it a link to an Instagram Reel, a TikTok or a YouTube Short and it reports where viewers are predicted to stop watching, how strong the opening three seconds are, and what to change.\n\nIt works by downloading the video, transcribing its audio and reading its frames, so it can answer questions about a video whose page cannot simply be fetched, where the content is in the video and the audio rather than in the HTML.\n\nOther tasks it supports: scoring a hook on its own, transcribing a video, writing hooks, captions and hashtags from a topic, searching what is currently performing in a niche, and answering questions about the posts on a connected account.\n\nIntended users: creators, social media managers and content teams who publish short-form video and want to understand why one specific video held attention or lost it.\n\nLimitations: the retention read is a prediction derived from the video itself, not a platform's measured analytics. Reelyze does not read private platform insights unless the user connects their own account, it does not post or schedule content, and it cannot analyse a private or deleted video.",
    "developerName": "Reelyze",
    "category": "Productivity",
    "capabilities": [
      "Interactive"
    ],
    "websiteURL": "https://getreelyze.com",
    "privacyPolicyURL": "https://getreelyze.com/privacy",
    "termsOfServiceURL": "https://getreelyze.com/terms",
    "defaultPrompt": [
      "Analyse my Instagram Reel and show where viewers drop off",
      "Is 2,400 views good for an account with 1,800 followers?",
      "Get the transcript of this YouTube Short"
    ],
    "brandColor": "#00B4D8",
    "composerIcon": "./assets/composer-icon.svg",
    "logo": "./assets/logo.png",
    "supportURL": "https://getreelyze.com/contact"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Score the hook on a reel",
              "prompt": "Score the hook on this reel: https://www.instagram.com/reel/DeMhURstibE/",
              "tools_triggered": "score_hook, check_hook_score",
              "expected_behavior": "score_hook returns an id, status queued. check_hook_score returns status completed with score 1 to 10 for the first three seconds and a one sentence verdict. Spends no analysis."
            },
            {
              "description": "Transcribe a reel",
              "prompt": "Get the transcript of this reel: https://www.instagram.com/reel/DeMhURstibE/",
              "tools_triggered": "get_transcript, check_job",
              "expected_behavior": "get_transcript returns a job_id. check_job returns status completed and transcript_text with the spoken words, transcribed from the downloaded audio rather than the page. Spends no analysis."
            },
            {
              "description": "Diagnose why a reel underperformed",
              "prompt": "Why did this reel flop? https://www.instagram.com/reel/DeMhURstibE/",
              "tools_triggered": "analyze_reel, check_job",
              "expected_behavior": "analyze_reel returns a job_id and takes several minutes. check_job returns status completed and report_markdown naming where viewers are predicted to stop watching and what to change. Spends one analysis."
            },
            {
              "description": "Write hooks for a topic",
              "prompt": "Write hooks for a reel about meal prep for busy parents",
              "tools_triggered": "write_hooks_or_caption",
              "expected_behavior": "write_hooks_or_caption with tool reel-hook-generator returns 8 to 10 short opening lines for the topic, directly in the reply. No video, no job to poll, no account needed. Spends no analysis."
            },
            {
              "description": "Write a reel script for a topic",
              "prompt": "Write me a 30 second reel script about meal prep for busy parents",
              "tools_triggered": "generate_script",
              "expected_behavior": "generate_script returns a reel script for the topic directly in the reply, with the opening written to hold the first three seconds. No video and no job to poll. Spends from the monthly content allowance."
            }
          ],
          "negative": [
            {
              "description": "A link that is not a short-form video",
              "prompt": "Analyse this: https://en.wikipedia.org/wiki/Instagram",
              "expected_behavior": "analyze_reel refuses with an unsupported source error naming what it does accept. The page is not analysed and no analysis is spent, because the URL is probed before any work is queued."
            },
            {
              "description": "No connected account",
              "prompt": "Get the transcript of this reel: https://www.instagram.com/reel/DeMhURstibE/",
              "expected_behavior": "With Reelyze disconnected the server answers HTTP 401 with a WWW-Authenticate header pointing at its protected resource metadata, which starts the OAuth connect flow. No partial or invented transcript is returned."
            },
            {
              "description": "A tool the account does not have access to",
              "prompt": "Why did this reel flop? https://www.instagram.com/reel/DeMhURstibE/",
              "expected_behavior": "Signed in with the second account provided, which has never paid, analyze_reel refuses and does not run. The message says this tool is not included in what the account currently has access to and that nothing was spent. Other tools still work on the same account."
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=R115wuhdCVw",
        "commerce": false,
        "commerce_description": "This plugin does not sell anything or process payments. It does not display plans, start subscriptions or link to checkout. A tool the account cannot use refuses with an explanation and nothing else."
      },
      "publication": {
        "release_notes": "Initial release. Retention analysis, hook scoring, transcripts, drop-off diagnosis, hook and caption and hashtag generation, trending search, and a measured benchmark for judging a view count against account size."
      }
    }
  },
  "apps": "./.app.json"
}