← Back to directory
S

Supadata MCP Server

Official
Video transcripts and web scraping for LLM clients via Supadata
GitHub source repository ↗
★ 62 Stars Category · Dev Tools Popular Source revision e5c895904cbe
54FMRS · D
Reliability
8/20
Security and permissions
12/20
Maintenance
11/20
Documentation
13/20
Setup experience
10/20

Supadata MCP Server is an officially maintained server covering video transcripts, web scraping/crawling, and AI-powered structured extraction, with built-in retry and rate-limiting. It suits developers needing multi-platform content ingestion, but relies on a third-party Supadata API key and service, making it unsuitable for use cases that can't tolerate sending data off-device or that have strict compliance requirements.

Read the FMRS scoring method →

Supadata MCP Server is the official Model Context Protocol server for Supadata, adding video transcript extraction, web scraping, crawling, and site discovery to Cursor, Claude, and other LLM clients. It extracts transcripts from YouTube, TikTok, Instagram, Twitter, and file URLs, retrieves media metadata (platform info, title, description, author details, engagement stats, tags, creation date), and uses AI to pull structured data from video content. On the web side it offers single-page scraping, multi-page crawling, and site-wide URL discovery. Built-in configurable retry and rate-limiting logic handles transient failures. Requires a SUPADATA_API_KEY environment variable to authenticate against Supadata's backend API.

Tools

supadata_transcript
Extracts transcripts from supported video platforms (YouTube, TikTok, Instagram, Twitter) and file URLs, with an optional language parameter.
supadata_check_transcript_status
Checks the progress of a transcript extraction job using its job ID.
supadata_metadata
Fetches metadata for a media URL, including platform info, title, description, author details, engagement stats, media details, tags, and creation date.
supadata_extract
Uses AI to extract structured data from a video URL; accepts a prompt and/or JSON Schema for the output format, returning a job ID for async processing.
supadata_check_extract_status
Checks the progress of an AI extraction job using its job ID.
supadata_scrape
Extracts content from a single URL with advanced options such as language.
supadata_map
Discovers all indexed URLs on a website to find relevant pages before scraping.
supadata_crawl
Starts an asynchronous crawl job that extracts content from multiple related pages on a site.
supadata_check_crawl_status
Checks the progress of a crawl job using its job ID.

Setup

  1. Get a Supadata API key and set it as the SUPADATA_API_KEY environment variable. 2. Follow Supadata's integration guide (docs.supadata.ai/integrations/mcp) to configure the MCP server for Claude, ChatGPT, Cursor, Windsurf, VS Code, or other clients. 3. For local development, clone the repo and run npm install and npm run build.

Fit and risk

Best for

  • Developers integrating video transcripts into content pipelines
  • AI application builders needing combined web and video data for research or summarization
  • Automation workflows requiring site-wide URL discovery and multi-page crawling

Not for

  • General-purpose browser automation requiring clicks, logins, or form interaction
  • Scraping targets with strict terms-of-service constraints that haven't been reviewed
  • Privacy-sensitive scenarios where sending target URLs or content to a third-party API is unacceptable

Required permissions

  • Requires a valid SUPADATA_API_KEY to call the Supadata API
  • Requires outbound network access to reach target video platforms and web URLs

Risks and side effects

  • Target URLs and scraped content are sent to and processed by the third-party Supadata service
  • A misconfigured or leaked API key could be misused and incur unexpected usage costs
  • Scraping or crawling target sites may violate their terms of service or copyright restrictions
  • Async jobs (transcript, extract, crawl) depend on Supadata's service availability and rate limits

Troubleshooting

  1. Confirm the SUPADATA_API_KEY environment variable is set correctly
  2. Transcript, extract, and crawl operations are asynchronous — poll the matching check_status tool with the returned job ID
  3. Verify the target URL belongs to a supported platform (YouTube, TikTok, Instagram, Twitter) or is an accessible file/web URL
  4. On failures, check network connectivity and the retry/rate-limit configuration (maxAttempts, initialDelay, maxDelay, backoffFactor)

Use cases

Bulk-extracting transcripts from YouTube, TikTok, Instagram, or Twitter videos
Scraping a single web page for summarization or knowledge-base ingestion
Crawling a blog or documentation site across multiple related pages
Discovering the full set of URLs on a site before scraping
Fetching video metadata (title, author, engagement stats, etc.)
Extracting AI-driven structured data from video content

Supported clients

ClaudeFull support
ChatGPTFull support
CursorFull support
WindsurfFull support
VS CodeFull support