비디오 transcript 추출, 웹 스크랩, 크롤링, 사이트 발견에 대한 Supadata와 통합하는 모델 Context Protocol (MCP) 서버.

특징

• ** YouTube, TikTok, Instagram, Twitter 및 파일 URL에서 비디오 성적 추출 **
• 웹 스크랩, 크롤링 및 URL 발견
• YouTube, TikTok, Instagram 및 Twitter에서 미디어 메타데이터 검색
• 비디오 콘텐츠의 AI-powered 구조화 데이터 추출

설치

Claude, ChatGPT, Cursor, Windsurf, VS Code 및 기타 클라이언트에 대한 설정 지침은 통합 가이드를 참조하십시오.

실행

Stdio (과태)

패키지를 실행하면 stdio에서 MCP 서버를 시작합니다. MCP 클라이언트는 (Claude Desktop, Cursor, VS Code, Windsurf, …)는 서버를 스파게 할 때 사용합니다.

클라이언트 구성 보기:

Streamable HTTP (호스트 됨)

같은 도구는 Cloudflare Worker가 스트리밍 가능한 HTTP를 통해 제공됩니다. src/worker.ts, 배포 https://api.supadata.ai/mcp OAuth 2.1. 로컬로 실행 npm run dev (wrangler). x-api-key 헤더 인증은 /mcp]에서 가능합니다.

OAuth 연결은 30 일 후에 사용되고 만료되는 동안 살아납니다 사용 없이.

Supadata MCP Server

A Model Context Protocol (MCP) server that integrates with Supadata for video transcript extraction, web scraping, crawling, and site discovery.

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 setup instructions for Claude, ChatGPT, Cursor, Windsurf, VS Code, and other clients, see the integration guide.

Running

Stdio (default)

Running the package starts an MCP server on stdio. This is what MCP clients (Claude Desktop, Cursor, VS Code, Windsurf, …) use when they spawn the server:

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

Example client configuration:

{
  "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