plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "supadata",
  "version": "1.0.2",
  "description": "Get transcripts, metadata and structured data from YouTube, TikTok, Instagram, X and Facebook videos, and read any public web page as Markdown.",
  "author": {
    "name": "Dumpling Software UG (haftungsbeschr\u00e4nkt)",
    "email": "support@supadata.ai",
    "url": "https://supadata.ai"
  },
  "homepage": "https://supadata.ai",
  "repository": "https://github.com/supadata-ai/mcp",
  "keywords": [
    "transcript",
    "youtube",
    "tiktok",
    "instagram",
    "video",
    "metadata",
    "web scraping",
    "crawl",
    "markdown",
    "research"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Supadata",
        "shortDescription": "Video transcripts & web pages",
        "longDescription": "Supadata gives ChatGPT access to what is said in online video and to the content of public web pages.\n\nPaste a link to a video on YouTube, TikTok, Instagram, X or Facebook and ChatGPT can fetch its transcript, with timestamps and in the caption languages available. When a video has no captions, Supadata can generate a transcript with AI. ChatGPT can also fetch a post's metadata (title, description, author, views, likes, comments, tags and publish date) and extract structured data from a video using a prompt or a JSON Schema.\n\nFor the web, ChatGPT can read a single page as clean Markdown, list the URLs on a site, or crawl a site and read its pages.\n\nWhat you can do with it:\n- Summarise, quote or fact-check a video without watching it\n- Turn talks, podcasts and tutorials into notes, articles or study guides\n- Compare engagement across videos and posts\n- Pull structured data out of video, such as products, recipes or steps\n- Bring documentation sites and articles into a conversation\n\nSupadata only reads publicly available content. It does not post, edit or delete anything on any platform, and it does not download video or audio files. Use retrieved content in line with the source site's terms.\n\nYou need a Supadata account. Sign in when you connect; there is no API key to copy. Requests count against your Supadata plan, and website crawling is available on plans that include it. Video extraction and crawls run as background jobs and can take from a few seconds to a few minutes.",
        "developerName": "Dumpling Software UG (haftungsbeschr\u00e4nkt)",
        "category": "Productivity",
        "capabilities": [
          "Fetch transcripts of YouTube, TikTok, Instagram, X and Facebook videos, with timestamps and available caption languages",
          "Generate an AI transcript when a video has no captions",
          "Fetch post metadata: title, description, author, views, likes, comments, tags and publish date",
          "Extract structured data from a video using a prompt or a JSON Schema",
          "Read a public web page as clean Markdown",
          "List the URLs on a website",
          "Crawl a website and read its pages"
        ],
        "websiteURL": "https://supadata.ai",
        "supportURL": "https://feedback.supadata.ai",
        "privacyPolicyURL": "https://supadata.ai/legal/privacy",
        "termsOfServiceURL": "https://supadata.ai/legal/terms",
        "defaultPrompt": [
          "Get the English transcript of https://www.youtube.com/watch?v=jNQXAC9IVRw and summarise it in two sentences.",
          "Who posted https://www.youtube.com/watch?v=jNQXAC9IVRw, when, and how many views and likes does it have?",
          "Read https://docs.supadata.ai/integrations/mcp and give me the setup steps for ChatGPT."
        ],
        "brandColor": "#111111",
        "brandColorDark": "#FFFFFF",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "demo_recording_url": "https://youtu.be/cfuAHhN8wDc",
        "test_cases": {
          "positive": [
            {
              "description": "Transcript of a public YouTube video in a requested language",
              "prompt": "Get the English transcript of this video: https://www.youtube.com/watch?v=jNQXAC9IVRw",
              "tools_triggered": "supadata_transcript",
              "expected_behavior": "Calls supadata_transcript with the URL and lang \"en\" and returns the English transcript of the 19-second video \"Me at the zoo\". The text says the speaker is in front of the elephants and that the cool thing about them is that they have really, really long trunks. No job polling is needed for this video."
            },
            {
              "description": "Metadata for a public YouTube video",
              "prompt": "Who posted https://www.youtube.com/watch?v=jNQXAC9IVRw, when, and how many views and likes does it have?",
              "tools_triggered": "supadata_metadata",
              "expected_behavior": "Calls supadata_metadata and reports that the video \"Me at the zoo\" was posted by \"jawed\" on 23 April 2005, with its current public view count (over 400 million) and like count (about 20 million). The counts are live, so the exact numbers vary."
            },
            {
              "description": "Structured data extraction from a video with background job polling",
              "prompt": "Analyze https://www.youtube.com/watch?v=jNQXAC9IVRw and give me the location, the animals shown, and the main point the speaker makes.",
              "tools_triggered": "supadata_extract, supadata_check_extract_status",
              "expected_behavior": "Calls supadata_extract with the URL and a prompt (optionally a JSON schema), receives a jobId, then calls supadata_check_extract_status until the status is \"completed\". Returns structured fields: the location is a zoo (San Diego Zoo), the animals are elephants, and the main point is that elephants have very long trunks and the speaker thinks that is cool. Typically completes in under one minute."
            },
            {
              "description": "Discover the pages of a site, then read one page",
              "prompt": "List every page on docs.supadata.ai, then read https://docs.supadata.ai/integrations/mcp and give me the setup steps for ChatGPT.",
              "tools_triggered": "supadata_map, supadata_scrape",
              "expected_behavior": "Calls supadata_map for https://docs.supadata.ai and gets a list of about 55 documentation URLs, including https://docs.supadata.ai/integrations/mcp. Then calls supadata_scrape for that URL and summarizes the ChatGPT steps from the page: open Settings, go to Apps & Connectors, create a connector named Supadata with the URL https://api.supadata.ai/mcp, and save."
            },
            {
              "description": "Crawl a small section of a site with background job polling",
              "prompt": "Crawl up to 3 pages under https://docs.supadata.ai/web and summarize what each page covers.",
              "tools_triggered": "supadata_crawl, supadata_check_crawl_status",
              "expected_behavior": "Calls supadata_crawl with the URL and limit 3, receives a jobId, then calls supadata_check_crawl_status until the status is \"completed\". Returns up to 3 pages from the Web section of the Supadata documentation (for example the Scrape and Crawl pages) with a short summary of each. The test account's plan includes crawling."
            }
          ],
          "negative": [
            {
              "description": "Private or login-protected content. Supadata only reads publicly available content and never collects passwords, so it should not attempt this request or ask for credentials.",
              "prompt": "Here is my Instagram username and password. Log in and get the transcript of a private reel from my close friends list.",
              "expected_behavior": "Does not call any Supadata tool with credentials and does not ask for or accept the password. Explains that only public videos are supported and offers to transcribe a public link instead."
            },
            {
              "description": "Downloading media files and posting on a platform. Supadata is read-only: it returns transcripts, metadata, and page text, and cannot download video or audio files or take actions on other platforms.",
              "prompt": "Download https://www.youtube.com/watch?v=jNQXAC9IVRw as an MP4 file and then post a comment on the video saying 'first'.",
              "expected_behavior": "Does not download a file or post a comment. Explains that Supadata cannot download media or post to platforms, and offers the transcript or metadata of the video instead."
            },
            {
              "description": "Unrelated request with no video or web page to read. Supadata should not be invoked for general questions that built-in capabilities answer.",
              "prompt": "What is 18% of 240, and can you suggest a name for my cat?",
              "expected_behavior": "Answers directly without calling any Supadata tool."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. Users sign in to an existing Supadata account and use the features already included in that account."
      },
      "publication": {
        "release_notes": "Initial release. Adds video transcripts, video and post metadata, AI structured data extraction from video, and web page reading, site mapping and crawling through the hosted Supadata MCP server, plus two skills for video insights and web research. Listing copy aligned with the Supadata connector in the Claude directory."
      },
      "apps": "./.app.json"
    }
  }
}