convez.ai
MCP ServerIntegração & APIsIntermediário
supadata-ai

Supadata MCP Server

supadata-ai/mcp

Extração de transcrições e scraping de vídeos/web para LLMs

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que integra extração de transcrições de vídeos, web scraping, crawling e descoberta de URLs através da API Supadata. Suporta YouTube, TikTok, Instagram, Twitter e URLs diretas, com extração de dados estruturados alimentada por IA.

Instalação

$npx convez-ai supadata-ai/mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
63
Forks
11
Acompanhando
0
Saúde
37%
Último commit
há 2 semanas
Versão
v1.3.6
Issues abertas
6
Contribuidores
3

Casos de uso

  • Extrair transcrições de vídeos do YouTube, TikTok, Instagram e Twitter
  • Fazer scraping e crawling de conteúdo web de múltiplas páginas
  • Descobrir URLs disponíveis em websites
  • Extrair metadados e dados estruturados de mídia com IA

Veredito

Ferramenta robusta de integração que estende significativamente as capacidades de processamento de mídia dos clientes LLM. Útil para automação de pesquisa, análise de conteúdo e coleta de dados em escala, com suporte a retry e rate limiting.

README

A tradução para o português deste README ainda está na fila.

Supadata MCP Server

supadata-ai/mcp 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
  • Automatic retries and rate limiting

Installation

For setup instructions for Claude, ChatGPT, Cursor, Windsurf, VS Code, and other clients, see the integration guide.

Configuration

Environment Variables

  • SUPADATA_API_KEY: Your Supadata API key

System Configuration

The server includes configurable retry and rate limiting parameters:

const CONFIG = {
  retry: {
    maxAttempts: 3,           // Number of retry attempts
    initialDelay: 1000,       // Initial delay (milliseconds)
    maxDelay: 10000,          // Maximum delay between retries (milliseconds)
    backoffFactor: 2          // Exponential backoff multiplier
  }
};

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:

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:

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:

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:

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:

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

Scrape (supadata_scrape)

Extract content from a single URL with advanced options.

Usage:

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:

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

Crawl (supadata_crawl)

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

Usage:

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:

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

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm 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

Ver o original no GitHub

Bom para