Supadata

io.github.supadata-aiPublished by GitHub account supadata-aiv1.3.6Updated Oct 24, 2026

Video transcripts, metadata and structured data from YouTube, TikTok, Instagram, X; web scraping.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingMedia & Design

Overview

AI-generated overview

Supadata lets an assistant pull video transcripts and media metadata from YouTube, TikTok, Instagram and X, and scrape, map and crawl websites.

What you can do
  • Extract transcripts from supported video platforms and file URLs, and check transcript job status
  • Fetch media metadata such as title, description, author, engagement stats and tags
  • Extract AI-structured data from video content via a prompt or JSON Schema, and check job status
  • Scrape a single known page into markdown or HTML
  • Discover indexed URLs on a site and crawl multiple pages asynchronously, with status checks
When to use it
Useful when an assistant needs the text of a video, details about a social media post, or content from web pages it must read, summarize or analyze. It suits research, content monitoring and data collection tasks that would otherwise require manual copying.
Requirements
A remote endpoint at api.supadata.ai/mcp with OAuth sign-in, or an x-api-key header; a local stdio option runs via npx with the SUPADATA_API_KEY environment variable. A Supadata account is needed, and OAuth connections expire after 30 days without use.
Before you install
Requires a Supadata account and API credentials; usage is presumably billed by Supadata, so check plan limits. Scrape, map and crawl send target URLs to Supadata's servers, and extract sends video content for AI processing. Transcript and extract jobs run asynchronously and must be polled by job ID.

Installation

In SourceWeft

  1. Open Supadata in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.supadata-ai%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "supadata": {
      "type": "http",
      "url": "https://api.supadata.ai/mcp"
    }
  }
}

README

Supadata MCP Server

[supadata-ai/mcp MCP server]

Use Supadata in your AI agent: video transcripts, media metadata, web scraping, crawling, and site discovery. This repository is the Supadata MCP server (Model Context Protocol), which AI agents like Claude, ChatGPT and Cursor use to call Supadata.

Add to your AI agent

[Add to Claude] [Add to ChatGPT] [Add to Cursor]

Click a button, then sign in with your Supadata account. No API key to copy.

  • Claude: click Add to Claude, click Connect and sign in. Works in claude.ai, Claude Desktop and the mobile apps. On Team/Enterprise plans an Owner enables Supadata first in Admin settings → Connectors.
  • ChatGPT: click Add to ChatGPT, click Connect and sign in.
  • Cursor: click Add to Cursor, confirm Install, and Cursor opens the Supadata sign-in page.

Claude Code / Codex

bash
# Claude Code: then run /mcp and choose Authenticateclaude mcp add --transport http supadata https://api.supadata.ai/mcp
# Codexcodex mcp add supadata --url https://api.supadata.ai/mcpcodex mcp login supadata

Other MCP clients can connect to the hosted server at https://api.supadata.ai/mcp (OAuth, or an x-api-key header), or run the local server below.

Features

  • Video transcript extraction from YouTube, TikTok, Instagram, Twitter, and file URLs
  • Web scraping, crawling, and URL discovery
  • Media metadata retrieval from YouTube, TikTok, Instagram, and Twitter
  • AI-powered structured data extraction from video content

Installation

For step-by-step setup in Claude, ChatGPT, Cursor, Claude Code, Codex, Windsurf, VS Code and other AI agents, see the AI agents guide.

Running

Stdio (default)

Running the package starts an MCP server on stdio. Use this when your AI agent should spawn the server locally with your API key instead of using the hosted server (for example a custom agent, or VS Code / Windsurf config files):

bash
SUPADATA_API_KEY=your-api-key npx -y @supadata/mcp

Example client configuration:

json
{  "mcpServers": {    "supadata": {      "command": "npx",      "args": ["-y", "@supadata/mcp"],      "env": { "SUPADATA_API_KEY": "your-api-key" }    }  }}

Streamable HTTP (hosted)

The same tools are served over Streamable HTTP by the Cloudflare Worker in src/worker.ts, deployed at https://api.supadata.ai/mcp with OAuth 2.1. Run it locally with npm run dev (wrangler). Direct x-api-key header authentication is also accepted on /mcp.

An OAuth connection stays alive while it is used and expires after 30 days without use. Then clients have to log in again; Codex keeps retrying the expired login instead of asking, so run codex mcp login supadata if Supadata tools stop working in Codex.

Configuration

Environment Variables

  • SUPADATA_API_KEY: Your Supadata API key (required for the stdio server). Get one at dash.supadata.ai
  • DEBUG: set to true for verbose logging
  • RUN_STDIO: set to true to force the stdio server to start when the module is imported rather than executed directly

How to Choose a Tool

Select the right tool based on your needs:

  • Transcript: Extract video transcripts from platforms and file URLs
  • Scrape: Extract content from a single page when you know the exact URL
  • Map: Discover all available URLs on a website
  • Crawl: Extract content from multiple related pages comprehensively
  • Metadata: Fetch metadata from media URLs (YouTube, TikTok, Instagram, Twitter)
  • Extract: Extract structured data from video content using AI
ToolBest forReturns
transcriptVideo transcript extractiontext/markdown
metadataMedia metadata retrievalJSON object
extractAI-powered structured extractionJSON object
scrapeSingle page contentmarkdown/html
mapURL discovery on a siteURL[]
crawlMulti-page extractionmarkdown/html[]

Available Tools

Transcript (supadata_transcript)

Extract transcripts from supported video platforms (YouTube, TikTok, Instagram, Twitter) and file URLs.

Usage:

bash
supadata_transcript --url "https://youtube.com/watch?v=example" --lang "en"

Check Transcript Status (supadata_check_transcript_status)

Check the progress of a transcript extraction job using the job ID.

Usage:

bash
supadata_check_transcript_status --id "550e8400-e29b-41d4-a716-446655440000"

Metadata (supadata_metadata)

Fetch metadata from a media URL on supported platforms (YouTube, TikTok, Instagram, Twitter). Returns platform info, title, description, author details, engagement stats, media details, tags, and creation date.

Usage:

bash
supadata_metadata --url "https://youtube.com/watch?v=example"

Extract (supadata_extract)

Extract structured data from a video URL using AI. Provide a prompt for what to extract, a JSON Schema for the output format, or both. Returns a job ID for async processing.

Usage:

bash
supadata_extract --url "https://youtube.com/watch?v=example" --prompt "Extract the main topics discussed"

Check Extract Status (supadata_check_extract_status)

Check the progress of an extract job using the job ID.

Usage:

bash
supadata_check_extract_status --id "550e8400-e29b-41d4-a716-446655440000"

Scrape (supadata_scrape)

Extract content from a single URL with advanced options.

Usage:

bash
supadata_scrape --url "https://example.com" --lang "en"

Map (supadata_map)

Discover all indexed URLs on a website to find relevant pages before scraping.

Usage:

bash
supadata_map --url "https://example.com"

Crawl (supadata_crawl)

Start an asynchronous crawl job to extract content from multiple pages on a site.

Usage:

bash
supadata_crawl --url "https://example.com/blog" --limit 100

Check Crawl Status (supadata_check_crawl_status)

Check the progress of a crawl job using the job ID.

Usage:

bash
supadata_check_crawl_status --id "550e8400-e29b-41d4-a716-446655440000"

Development

bash
# Install dependenciesnpm install
# Buildnpm run build
# Run testsnpm test

Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Run tests: npm test
  4. Submit a pull request

License

MIT License - see LICENSE file for details

Source: README.md at commit ae23ee6

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v1.3.6LatestOct 23, 2026
  2. v1.3.2Oct 13, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts