Socialcrawl MCP

---

Visão geral

socialcrawl-mcp é um servidor MCP (Model Context Protocol) que conecta agentes de IA à API SocialCrawl — uma API de dados unificada que cobre 65 plataformas e 575 endpoints.

Recupere perfis, postagens, comentários, resultados de busca, conteúdo em alta e análises do TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Reddit, Threads, Douyin, Telegram, Quora, Apple Music, GitHub, Hacker News, Polymarket e mais 30 plataformas. Extraia produtos, ofertas, histórico de preços, avaliações e vendedores da Amazon, Walmart, Target, Home Depot, eBay, Klarna, AliExpress, Etsy, Sephora, H&M, Kohl's, Wayfair, Gumtree e Google Shopping; aplicativos, rankings e avaliações do Google Play e da Apple App Store; hotéis, restaurantes, atrações, cruzeiros e avaliações de viajantes do Tripadvisor, além de dados de negócios locais do Yelp e Google Business; reputação de marca do Trustpilot e avaliações de software do G2; listas de empregos e faixas salariais do LinkedIn, Indeed, Bing e Xing; cotações de mercado, histórico de preços, demonstrações financeiras e cadeias de opções; divulgações de negociações do congresso dos EUA; séries de tendências de busca e Data Lab do Naver (Coreia); menções de marca na web com análise de sentimento via Content Analysis; manchetes do Google News e curvas de interesse do Google Trends — além de pesquisa na web via Tavily e Perplexity, busca em X com IA via Grok, auditorias de SEO on-page e um único endpoint /search/everywhere que se distribui por 14 fontes em uma única chamada.

Novo nesta versão (v1.12.0): uma nova sincronização do registro que adiciona três endpoints e duas novas alavancas de preço.

• Os próprios rankings do TikTok. tiktok/hashtags/popular lê o quadro de hashtags em alta para um mercado e janela de tempo — o quadro geral mais 15 quadros do setor, 2cr por hashtag retornada (um quadro custa 6cr; industry=all contém 96 e se estabiliza em torno de 88-92). tiktok/videos/popular lê o quadro de Top Vídeos para EUA, Japão, Vietnã, Tailândia ou Indonésia a 25cr por quadro mais 1cr por vídeo. Ambos são rankings classificados sem segunda página.
• google_trends/trending — Tendências Agora por localização, com filtros de janela de hora, categoria, status e ordenação (5cr).
• coverage=full em instagram/followers e instagram/following. Uma varredura mesclada que nunca repete uma conta entre páginas até que as linhas atinjam o total do próprio perfil. Isso dobra o preço da página para 10cr, o que moveu ambos os endpoints de uma taxa fixa em escada para uma faixa medida de 5-10cr — e uma lista completa é genuinamente cara (uma lista de 2.652 contas seguidas levou 54 páginas, 540 créditos, medido em 13/09). socialcrawl_pricing cita a faixa e nomeia coverage como a alavanca.
• feed=global|local em tiktok/trending — o feed web mundial, ou o feed Para Você como um telefone em region veria (mais conteúdo do país, mais lento, mais vídeos).
• instagram/location/posts agora pagina corretamente com um cursor em vez de ser uma grade única de 60 postagens.

Preços, parâmetros, formatos de resposta e descritores de paginação foram ressincronizados em mais 24 endpoints. A hidratação de linhas (as junções opcionais include= adicionadas na v1.11.0) permanece inalterada em 33 junções em 28 endpoints.

O que o servidor MCP faz:

• Descobre plataformas e endpoints dinamicamente, ou por busca de texto livre em todos os 575
• Busca dados ao vivo em seu nome em todas as plataformas, métodos e compostos
• Precifica cada chamada antecipadamente — escada, fixo ou faixa medida — para que um agente possa orçar antes de gastar
• Valida solicitações localmente antes de chamar a API: parâmetros obrigatórios, grupos oneOf, valores de enum, intervalos inteiros, acoplamentos de parâmetros e limites de CSV. Uma chamada inválida falha gratuitamente em vez de queimar créditos
• Fornece documentação de API integrada que o agente pode consultar sob demanda, paginada em vez de truncada

Instalação

Servidor remoto (hospedado — sem instalação)

Conecte-se diretamente ao endpoint HTTP Streamable hospedado — nada para instalar ou executar:

Claude Code (funciona na CLI e no Claude Code na web / sandboxes na nuvem)

claude mcp add --scope user --transport http socialcrawl https://mcp.socialcrawl.dev/mcp \
  --header "Authorization: Bearer sc_your_key_here"

Qualquer cliente que leia .mcp.json

{
  "mcpServers": {
    "socialcrawl": {
      "type": "http",
      "url": "https://mcp.socialcrawl.dev/mcp",
      "headers": { "Authorization": "Bearer ${SOCIALCRAWL_API_KEY}" }
    }
  }
}

Cursor / Windsurf / VS Code — escolha o tipo de servidor HTTP ("streamable-http") com a mesma URL e cabeçalho. x-api-key: sc_your_key_here funciona como cabeçalho alternativo.

As ferramentas de descoberta (socialcrawl_list_platforms, socialcrawl_list_endpoints, socialcrawl_get_docs) funcionam sem chave, para que você possa explorar antes de se inscrever. Conectores personalizados do claude.ai (Configurações → Conectores) exigem OAuth, que será lançado em uma versão futura — use a configuração baseada em cabeçalho acima enquanto isso.

Prefere executar localmente? Todas as opções stdio abaixo funcionam exatamente como antes.

npm

npm install -g socialcrawl-mcp

Disponível no npm. A maioria dos usuários não precisa disso — as configurações do cliente MCP abaixo usam npx e instalam automaticamente na primeira execução.

Claude Code (mais rápido)

claude mcp add --scope user socialcrawl -- npx -y socialcrawl-mcp

Em seguida, defina sua chave de API:

claude mcp add-env socialcrawl SOCIALCRAWL_API_KEY sc_your_key_here

Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "socialcrawl": {
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "sc_your_key_here"
      }
    }
  }
}

Cursor

Adicione ao .cursor/mcp.json na raiz do seu projeto ou ~/.cursor/mcp.json globalmente:

{
  "mcpServers": {
    "socialcrawl": {
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "sc_your_key_here"
      }
    }
  }
}

VS Code (Claude Code)

Adicione ao .vscode/mcp.json no seu projeto ou nas configurações do usuário:

{
  "servers": {
    "socialcrawl": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "sc_your_key_here"
      }
    }
  }
}

Windsurf

Adicione à sua configuração MCP do Windsurf:

{
  "mcpServers": {
    "socialcrawl": {
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "sc_your_key_here"
      }
    }
  }
}

Outros clientes compatíveis com MCP

Qualquer cliente MCP que suporte transporte stdio pode usar este servidor. O padrão geral é:

• Comando: npx
• Argumentos: ["-y", "socialcrawl-mcp"]
• Ambiente: SOCIALCRAWL_API_KEY definido com sua chave de API

Reinicie seu cliente de IA após salvar a configuração.

Configuração

1. Obtenha sua chave de API

Cadastre-se em socialcrawl.dev e pegue sua chave de API no painel. Toda conta começa com 100 créditos gratuitos — sem necessidade de cartão de crédito.

2. Adicione a chave à sua configuração

Substitua sc_your_key_here na configuração de instalação acima pela sua chave de API real (começa com sc_).

[!TIP] Você também pode definir SOCIALCRAWL_API_KEY como uma variável de ambiente do sistema em vez de colocá-la na configuração MCP. As ferramentas de descoberta e documentação funcionam mesmo sem chave — apenas solicitações reais de API precisam de uma.

Uso

Pergunte ao seu agente de IA em linguagem natural. O servidor MCP cuida do resto.

Buscar um perfil

Get the TikTok profile for @charlidamelio

O agente chama socialcrawl_request com platform: "tiktok", resource: "profile", params: { handle: "charlidamelio" } e retorna dados estruturados do perfil, incluindo seguidores, biografia, status de verificação e métricas de engajamento.

Buscar entre plataformas

Search YouTube for "machine learning tutorials"

Obter comentários de postagens

Get the comments on this Instagram post: https://instagram.com/p/CwA1234abcd

Pesquisa entre plataformas

Compare the follower counts of @mkbhd on TikTok, Instagram, YouTube, and Twitter

O agente faz 4 chamadas sequenciais de API — uma por plataforma — e compila os resultados em uma comparação.

Comprar em varejistas

Find the cheapest 65-inch OLED TV across Amazon, Walmart, Target, and eBay

Explorar endpoints disponíveis

What social media platforms can you access?

Show me all the TikTok endpoints

Which endpoints can give me video transcripts?

O último é uma busca socialcrawl_list_endpoints entre plataformas — sem necessidade de plataforma, ele procura em todos os 575 endpoints.

Aprenda a API a partir da API

How do I get started with SocialCrawl?

Show me exactly how to call the Prism comments endpoint

Is this MCP server's endpoint list up to date?

Todos os três acessam socialcrawl_discover e não custam nada.

Verifique quanto algo custa antes de executar

What would it cost to run a Prism brand-mentions report?

Show me everything I can call for 1 credit

Why did that last call charge me 7 credits instead of 2?

Os dois primeiros acessam socialcrawl_pricing; o terceiro lê o razão de créditos via socialcrawl_check_balance com view: "transactions" e mostra as linhas de dedução e reembolso para aquele request_id.

Acessar documentação

How does the SocialCrawl credit system work?

How do I page through a list endpoint?

Exemplo de resposta

Toda resposta segue um formato de envelope unificado:

{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/profile",
  "data": {
    "content": { "text": "...", "media_urls": ["..."] },
    "author": { "username": "charlidamelio", "followers": 156000000 },
    "engagement": { "likes": 5200, "engagement_rate": 0.045 },
    "metadata": { "language": "en", "content_category": "entertainment" }
  },
  "credits_used": 1,
  "credits_remaining": 99
}

[!NOTE] A mesma estrutura de resposta é retornada para todas as plataformas — sem necessidade de lógica de análise por plataforma.

Ferramentas disponíveis

O servidor MCP expõe 10 ferramentas:

Ferramenta	Descrição	Precisa de chave de API?
socialcrawl_list_platforms	Descubra todas as 65 plataformas, agrupadas por categoria, com contagens de endpoints e faixas de crédito por plataforma	Não
socialcrawl_list_endpoints	Endpoints com seu contrato completo de parâmetros — tipos, intervalos inteiros, valores de enum, acoplamentos de parâmetros, limites de CSV, estilo de paginação, TTL de cache e preços. Passe um platform, ou um termo search para encontrar um endpoint entre todos os 575. Filtre por method e maxCost	Não
socialcrawl_pricing	Custo exato em créditos para cada endpoint: a escada de níveis, todos os valores fixos, todas as faixas medidas com suas regras de cobrança e parâmetros que afetam o preço, tabelas de custo por plataforma, rankings filtrados por orçamento (maxCost, model, sort), o catálogo completo de junções de linha include= e uma cotação exata antecipada para uma chamada que você descrever	Não
socialcrawl_request	Faça qualquer chamada à API SocialCrawl — perfis, postagens, comentários, busca, tendências, análises, compostos Prism. Endpoints GET aceitam params de consulta; endpoints POST em lote (ex.: youtube/videos, prism/profiles) aceitam seu body de array/objeto. Suporta um idempotencyKey opcional para chamadas seguras contra repetição	Sim
socialcrawl_check_balance	Saldo de créditos e deduções recentes, ou o razão detalhado (view: "transactions") — cada dedução e reembolso identificado por request_id. Chama /v1/credits/{balance,transactions} — custa 0 créditos	Sim
socialcrawl_monitors	Crie e gerencie monitores com estado que reexecutam qualquer receita em uma cadência, entregam resultados a um webhook assinado e acumulam uma série temporal. Ações: criar, listar, obter, execuções, série temporal, pausar, retomar, excluir	Sim
socialcrawl_web	Raspagem completa da web e automação de navegador (a plataforma web). Raspagem síncrona busca/mapa/extração; trabalhos assíncronos de rastreamento/lote_raspagem/agente com sondagem/cancelamento/erros; pré-visualização gratuita de parâmetros de rastreamento; monitores com estado; sessões interativas de navegador. Um action por endpoint	Sim
socialcrawl_cohorts	Busca de menções filtrada por público (/v1/cohorts/*) — envie até 10.000 identidades públicas que você já acompanha e pergunte quais delas postaram suas palavras-chave. Ações: criar, adicionar_membros, estimar_custo (local, gratuito), consultar, status_consulta, resultados_consulta, cancelar_consulta, obter, excluir. Tudo exceto a consulta custa 0 créditos	Sim
socialcrawl_discover	A API descrevendo a si mesma, ao vivo, a 0 créditos (/v1/utility/*) — início rápido, o catálogo completo de endpoints com preços ao vivo cientes de faixas medidas, o guia de uso completo de um endpoint, o corpus de contexto do agente, uma verificação de atualização que informa se o catálogo incluído neste servidor ficou desatualizado em relação à API, e o status ao vivo do disjuntor de cada plataforma status	Opcional
socialcrawl_get_docs	Documentação da API por tópico ou plataforma — visão geral, autenticação, créditos, preços, erros, idempotência, paginação, cache, esquema de resposta, limites, monitores, coortes, descoberta ou qualquer slug de plataforma. Tópicos longos são paginados, nunca truncados	Não
Quatro das dez ferramentas funcionam sem chave de API — elas consultam dados locais empacotados gerados a partir do registro do backend. socialcrawl_request, socialcrawl_check_balance, socialcrawl_monitors, socialcrawl_web e socialcrawl_cohorts exigem uma chave. socialcrawl_discover usa uma chave quando tem uma e recorre aos dados empacotados quando não tem (sua ação status não precisa de chave alguma).

Descoberta — a API descrevendo a si mesma, de graça

socialcrawl_discover impulsiona a família /v1/utility/*: quatro endpoints que permitem que qualquer cliente conheça toda a API de dentro da própria API, a 0 créditos. Eles são servidos em processo a partir do registro de endpoints — sem chamada upstream, sem salto de rede — então nunca podem divergir do que é realmente chamável.

Ação	Endpoint	O que você obtém
quickstart	/v1/utility/quickstart	Autenticação, URL base, uma primeira chamada executável, os envelopes de sucesso e erro, o modelo de cobrança, a taxonomia completa de erros, limites de taxa e o contrato de paginação — em uma única resposta
catalog	/v1/utility/endpoints	Cada endpoint com seu rótulo de preço dinâmico e ciente de medição, parâmetros obrigatórios e opcionais, grupos oneOf e flag de paginação. Filtre por platform / search / method
endpoint	/v1/utility/endpoint	O guia de uso completo de um endpoint — cada parâmetro com tipo e exemplo, a regra exata de preço, TTL de cache, receita de paginação, uma resposta de exemplo, um curl copiável e endpoints relacionados
llms	/v1/utility/llms	O corpus de contexto do agente para toda a API ou uma plataforma, como markdown ou JSON — inicialize um agente em uma chamada em vez de rastrear a documentação
freshness	—	Compare o registro ao vivo com o catálogo empacotado deste servidor

Por que freshness importa. Este servidor acompanha um catálogo gerado quando foi construído; a API continua evoluindo. Chamadas de dados sempre atingem a API ao vivo e continuam funcionando — mas descoberta, preços e validação local respondem a partir desse instantâneo, então um endpoint recém-adicionado parece desconhecido até você atualizar. Uma chamada gratuita diz em qual situação você está:

socialcrawl_discover  action: "freshness"

Empacotado vs. ao vivo. list_platforms, list_endpoints, pricing e get_docs respondem instantaneamente a partir de dados empacotados e não precisam de chave — prefira-os para navegação. Recorra a socialcrawl_discover quando a precisão importar mais que a latência: um endpoint parece ausente, você precisa do preço ao vivo exato de um endpoint medido, ou está gerando código que deve corresponder à produção hoje. Sem chave, ele ainda responde tudo, exceto llms, a partir de dados empacotados, então a descoberta nunca exige autenticação de forma rígida.

Esses mesmos endpoints são HTTP puro, então uma integração de terceiros ou um framework de agente não-MCP obtém a informação idêntica com um curl.

Preços — saiba o custo antes de gastar

socialcrawl_pricing existe porque um único número é uma mentira para a maior parte da superfície. O SocialCrawl cobra de três formas:

• Escada (443 endpoints) — a taxa por nível por requisição: padrão 1cr, avançado 5cr, premium 10cr.
• Fixo (61 endpoints, 18 deles gratuitos) — uma substituição por endpoint, ex.: /v1/search/everywhere a 20cr fixos.
• Medido (71 endpoints) — a cobrança depende da requisição. Um teto inicial é deduzido e reembolsado até o trabalho realmente realizado.

Citar o custo base de um endpoint medido subestima cada chamada: /v1/search/news tem uma base de 1cr, mas realmente cobra 2–62cr — um crédito por etapa de país do Google que retorna artigos, mais cobrança por artigo quando o mecanismo bing é adicionado. A ferramenta retorna a faixa real, a regra de cobrança do próprio registro, os parâmetros que movem a conta e o pior caso para orçar:

action: "overview"   → ladder, every free endpoint, every flat override, every metered band + rule, cache TTLs, full refund matrix
action: "endpoint"   → one endpoint's price, rule, price-driving params, paging cost, worst case
action: "platform"   → a whole platform's cost table
action: "list"       → rank/filter by cost — "everything I can call for 1 credit", "the 10 most expensive endpoints"
action: "hydration"  → every include= row join: what it fills, per-row rate, row cap, fully-joined ceiling

Passe o include que você pretende enviar para action: "endpoint" e a faixa vira aritmética — a retenção exata, detalhada por junção, usando a mesma fórmula que o precificador do backend executa:

action: "endpoint", platform: "linkedin", resource: "search/people", include: "profile", rows: 3
→ holds 22 credits (10cr page + 12cr for 3 rows of `profile`), settling anywhere down to 10

Também declara as regras que fazem a cobrança real diferir do preço de etiqueta: acertos de cache, repetições idempotentes, resultados vazios e falhas upstream são todos 0 créditos.

Hidratação de linhas — uma chamada em vez de uma página mais uma consulta por linha

Algumas listas são enxutas porque o upstream não publica nada além delas: um resultado de busca do Pinterest não tem contagem de salvamentos, uma linha de reações do LinkedIn não tem contagem de seguidores, uma playlist do YouTube não tem contagens de visualizações ou durações. Outro endpoint do SocialCrawl responde a cada um desses para uma única linha — então 28 endpoints agora aceitam um token include= que junta cada linha àquele endpoint irmão na mesma chamada.

GET /v1/pinterest/search?query=kitchen&include=engagement      → saves, likes, comments, shares on every row
GET /v1/youtube/playlist?playlistId=PL...&include=engagement,channel
GET /v1/linkedin/search/people?keywords=cto&include=profile&limit=3

• Opt-in. Sem token, sem junção, sem crédito extra, sem latência extra — um chamador que nunca pede paga exatamente o que sempre pagou.
• Cobrado por linha realmente preenchida. O teto é retido antecipadamente; um crédito é mantido apenas para uma linha que uma consulta irmã nova preencheu. Linhas servidas do cache do irmão são gratuitas, linhas não preenchíveis são reembolsadas, e uma página que foi totalmente unida é armazenada em cache inteira, então uma repetição imediata é 0 créditos.
• Um limite de linhas limita a conta. limit=3&include=profile no LinkedIn retém 22 créditos, não 50.
• Ele informa o que fez. data.hydration relata linhas, consultas, acertos de cache, créditos retidos vs. mantidos e milissegundos; _warnings carrega <token>_partial quando apenas algumas linhas foram preenchidas.

socialcrawl_pricing com action: "hydration" lista cada junção e seu preço; socialcrawl_list_endpoints com hydrating: true encontra os endpoints que oferecem uma; o tópico socialcrawl_get_docs hydration é o contrato completo.

Monitores — agende qualquer receita

socialcrawl_monitors envolve qualquer endpoint do registro ou composto Prism em um monitor agendado e com estado (/v1/monitors/*). Ele reexecuta a receita de hora em hora/diariamente/semanalmente (ou em um cron), entrega cada resultado a um webhook assinado por HMAC, gera alertas em limites de métricas ou mudanças e mantém uma série temporal por execução que você pode ler de volta. "O Prism responde uma vez; os monitores observam por você." Gerenciar monitores custa 0 créditos; cada execução agendada cobra o custo normal da receita mais um prêmio de agendamento de 1 crédito. Veja o tópico socialcrawl_get_docs monitors para o contrato completo.

Web — raspe, rastreie, navegue

socialcrawl_web impulsiona toda a superfície de raspagem web e automação de navegador (a plataforma web, /v1/web/*) através de um único parâmetro action:

• Leituras síncronas — scrape (URL → markdown/HTML/captura de tela/links), search (busca web com conteúdo da página), map (descubra as URLs de um site), extract (dados estruturados por LLM de uma página).
• Trabalhos assíncronos — crawl um site inteiro, batch_scrape muitas URLs ou agent (tarefa web autônoma de múltiplas etapas); cada um retorna um trabalho que você consulta com job_get/job_list, inspeciona com job_errors (falhas por página) e interrompe com job_cancel. crawl_preview testa os parâmetros de um rastreamento gratuitamente antes de você pagar por ele.
• Monitores — monitor_create/list/get/update/delete/checks re verificam uma URL em uma cadência e entregam mudanças a um webhook.
• Sessões — session_create/get/list, session_execute (execute código na página ao vivo), session_close.

A maior parte da superfície web paga é medida em vez de fixa: um rastreamento retém limit créditos e reembolsa cada página que não rastreou; uma sessão retém contra ttl_seconds e liquida no fechamento. Gerenciamento de trabalhos, monitores e sessões é 0 créditos. Veja o tópico socialcrawl_get_docs web, ou socialcrawl_pricing com platform: "web".

Validação inteligente

Antes de fazer qualquer chamada de API, socialcrawl_request espelha o validador pré-cobrança do backend contra os dados do registro empacotado: a plataforma e o recurso existem, parâmetros obrigatórios e grupos oneOf são satisfeitos, valores de enum são legais, inteiros estão dentro da faixa declarada, acoplamentos de parâmetros são válidos (order precisa de sort; o timeframe do Reddit precisa de sort=top) e listas CSV estão dentro dos limites de entrada. Uma chamada malformada falha instantaneamente e de graça em vez de custar uma ida e volta — e um agente recebe exatamente o que corrigir em vez de repetir uma chamada que nunca pode ter sucesso.

Requisições seguras contra repetição

Passe um idempotencyKey para socialcrawl_request (UUIDv4 recomendado) para tornar a chamada segura contra repetição. Se a requisição for repetida dentro de 24h, o servidor retorna a resposta original e deduz 0 créditos (X-Idempotent-Replay: true).

Plataformas Suportadas

Plataforma	Endpoints	Dados disponíveis
LinkedIn	45	Perfis e páginas de empresas, posts, republicações, reações, comentários e respostas, busca de pessoas/empresas, sub-recursos de perfil (experiência, educação, habilidades, certificações…), arquivo completo do histórico de posts (medido por post), empregos (busca, empregos de empresas, detalhes), insights de empresas, grupos, transcrições, Ad Library, perfil-360
Instagram	37	Perfis, transparência de conta (perfil/sobre), posts, reels, comentários e respostas a comentários, destaques, stories, feeds de marcados e localização, seguidores/seguindo, contas semelhantes, curtidores de posts, estatísticas de compartilhamento, feeds de reels/posts em uma única chamada com contagem de compartilhamentos, análises de engajamento, busca universal + de posts populares, busca de reels/hashtag/perfil/localização/música, tendências, transcrições, perfil-360
TikTok	36	Perfis, vídeos, comentários e respostas, extração de texto na tela, busca por palavra-chave/hashtag/usuário/música + sugestões, detalhes de hashtag, tendências (global ou Para Você no país), quadros de hashtags populares e Top Vídeos do próprio TikTok, audiência, seguidores, vídeos curtidos, playlists e coleções, feeds de locais, efeitos, ao vivo, músicas, transcrições, Ad Library, perfil-360
Prism	33	Composições multiplataforma — consulta de URL, coleta de comentários, consulta em lote de comentários/perfis, auditoria de identificadores, menções à marca, sinais de demanda, visibilidade de IA, radar de crise/autópsia, reputação, share of voice, verificação de criadores e cartões de criador, radar de organizações, lacuna da Coreia, respostas de consenso de IA, inteligência de vídeo/aplicativo/produto
YouTube	29	Canais, vídeos, shorts, comentários e respostas, patrocinadores, playlists e itens, posts da comunidade, busca (avançada + autocompletar), tendências, transmissões ao vivo, consulta de e-mail de contato do canal, arquivos de mídia (áudio/vídeo/legendas/miniaturas), transcrições, vídeos/canais/transcrições em lote, perfil-360
Facebook	24	Páginas, grupos e posts de grupos, posts, comentários, fotos, reels (incluindo feed completo de reels com contagem de visualizações), eventos, Marketplace, transcrições, Ad Library completa
Web Scraping	22	Raspagem, busca na web, mapa do site, extração com LLM, rastreamento assíncrono/raspagem em lote/trabalhos de agente com feeds de erro por página, monitores de alterações, sessões interativas de navegador, análise de documentos — orientado por socialcrawl_web
Negociações do Congresso dos EUA	19	Divulgações STOCK Act do Congresso dos EUA — feeds de negociações (todas/48h/7d), membros, estatísticas e negociações por político e por ticker, delegações estaduais e o conjunto completo de estatísticas (partido, setores, emissores, volume, atividade incomum, proporção compra/venda, arquivamentos tardios)
Klarna	18	Detalhes de produtos e todas as ofertas de comerciantes, busca por palavra-chave + sugestões, avaliações de usuários e profissionais com resumos de pontuação, histórico de preços, comparação de produtos, navegação por categoria com filtros/palavras-chave/guias de compra, listagens de lojas
Tripadvisor	16	Hotéis, restaurantes, atrações e cruzeiros — busca e detalhes completos de cada um, avaliações de viajantes com respostas dos proprietários, consulta de local por URL, autocompletar de destinos, tipos de experiência
Twitter/X	15	Perfis, tweets e respostas, busca de tweets e usuários, mídia de usuários, seguidores, seguindo, retweetadores, comunidades, transcrições de vídeo, busca com IA via Grok, perfil-360
Naver	14	Portal nº 1 da Coreia — blog, notícias, enciclopédia, cafe, KiN, local, imagens, busca na web, classificadores de errata e adultos, séries de tendências de busca do Data Lab e insights de compras, resumo
Reddit	14	Subreddits, detalhes de posts, comentários, perfis de usuários com histórico de posts e comentários, busca por palavra-chave/comentário/mídia, descoberta de subreddits, transcrições, varredura omni-search de VoC
GitHub	12	Usuários, repositórios, issues, PRs, READMEs, releases, busca, dossiê de repositório, velocidade de perfil de usuário
Gumtree	11	Classificados do Reino Unido — busca e detalhes de anúncios, anúncios semelhantes, perfis de vendedores e seus anúncios, sugestões de busca, buscas em tendência, árvore de categorias com filtros, consulta de localização
Empregos	11	Busca de empregos e detalhes de anúncios no LinkedIn, Indeed, Bing e Xing, resolução de ID de organização do LinkedIn e faixas salariais por cargo e país
Sephora	11	Detalhes de produtos, avaliações, busca por palavra-chave + sugestões, navegação pela árvore de categorias, listagens de marcas e produtos por marca, consulta de lojas, disponibilidade na loja por SKU
Análise de Conteúdo	10	Menções à marca na web, sentimento, distribuições de avaliações, tendências de frases/categorias
Google	10	Busca na web, Ads Transparency, Perfil da Empresa (informações, avaliações, atualizações, Q&A), hotéis do Travel
AliExpress	9	Detalhes de produtos, busca por palavra-chave, produtos semelhantes, avaliações, envio por SKU, produtos populares, promoções em destaque, árvore de categorias
Apple App Store	9	Busca de aplicativos, sugestões de busca, detalhes de aplicativos, avaliações, rankings, banco de dados de listagens, dados de referência
Google Play	9	Busca de aplicativos, sugestões de busca, detalhes de aplicativos, avaliações, rankings, banco de dados de listagens, dados de referência
Amazon	8	Busca de produtos, detalhes de ASIN, avaliações, vendedores, páginas de lojas, rankings de Mais Vendidos, ofertas atuais, perfis de vendedores — ~13 marketplaces
Douyin	8	TikTok da China — busca de vídeos, perfis e feeds de criadores, detalhes de vídeos, comentários e respostas a comentários, busca de criadores, quadro de buscas populares (majoritariamente medido por linha)
Finanças	7	Cotações de instrumentos, busca por ticker, visão geral de mercados, notícias de instrumentos, histórico diário de preços, demonstrações financeiras de empresas, cadeias de opções
G2	7	Marketplace de software — páginas de produtos, avaliações, listagens de categorias e o índice de categorias, perfis de fornecedores e seu catálogo, índice de URLs de produtos
Quora	7	Busca e detalhes de perguntas, busca de respostas, busca de posts em Spaces, busca de perfis, busca de Spaces/tópicos
H&M	6	Busca por palavra-chave + sugestões, listagens de lojas por país, países/idiomas, árvore de categorias, divulgação de fornecedor e fábrica por produto
Spotify	6	Artistas, faixas, álbuns, podcasts, episódios, busca
Threads	6	Perfis, posts, comentários em posts, busca por palavra-chave, busca de usuários
Google Shopping	5	Busca de produtos, detalhes de produtos, histórico de preços, avaliações entre varejistas, ofertas por vendedor
Kohl's	5	Busca por palavra-chave, avaliações, perguntas e respostas de produtos, consulta de lojas, árvore de categorias
Pinterest	5	Pins, quadros, busca, contagens de salvamento de URLs
Rumble	5	Busca, vídeos de canais, detalhes de vídeos, comentários, transcrições
Target	5	Detalhes de produtos por TCIN, avaliações, navegação por categoria, taxonomia completa, consulta de lojas
TikTok Shop	5	Produtos, avaliações, listagens, busca, vitrines de criadores
Walmart	5	Detalhes de produtos, avaliações, busca por palavra-chave, navegação por categoria, ofertas de vendedores
Yelp	5	Perfis de empresas por encid, avaliações de empresas, busca de empresas (compacta e cartão completo), sugestões de busca
Apple Music	4	Busca no catálogo, artista, álbum, faixa
Etsy	4	Listagens por id ou URL, catálogo de uma loja, listagens semelhantes, sugestões de busca
Hacker News	4	Busca de histórias, história, árvore de comentários, perfil
Home Depot	4	Busca por palavra-chave, detalhes de produtos por id do item ou URL (preços cientes de loja/CEP), avaliações, consulta de lojas por CEP
Tavily	4	Busca na web (com resposta de LLM), extração de URLs, sitemap, rastreamento completo
Twitch	4	Perfis, clipes, vídeos, agendas
Busca Universal	4	Uma consulta distribuída por 14 plataformas (US$ 0,20 fixo); faixa de fóruns; faixa de notícias multinacional (medida); faixa de descoberta de criadores em TikTok/Threads/Instagram
Utilitário	4	Autodescoberta gratuita da API — início rápido, catálogo de endpoints, guia de uso por endpoint, payload de contexto para LLM. 0 créditos, servido a partir do registro ao vivo. Orientado por socialcrawl_discover
Bluesky	3	Perfis, posts
Kwai	3	Perfis, posts
Telegram	3	Perfis de canais públicos, feeds de posts de canais, consulta de post único
Truth Social	3	Perfis, posts
Wayfair	3	Busca de produtos, detalhes de produtos por SKU, avaliações
eBay	2	Busca de anúncios incl. vendidos/concluídos com preços realizados, detalhes de anúncios
Google Trends	3	Interesse ao longo do tempo (explorar), consultas relacionadas em alta/emergentes e Tendências Agora por localização
Snapchat	2	Perfis, comentários do Spotlight
Trustpilot	2	Busca de empresas, avaliações de empresas
Google News	1	Busca em tempo real no SERP do Google News
Kick	1	Clipes
Komi	1	Páginas de links
LinkBio	1	Páginas de links
LinkMe	1	Páginas de links
Linktree	1	Páginas de links
On-Page	1	Auditoria de SEO on-page de URL única — as verificações técnicas, de conteúdo e meta em uma única chamada
Perplexity	1	Pesquisa web Sonar com fontes citadas
Pillar	1	Páginas de links
Polymarket	1	Pesquisa de mercado de previsão — distribuição multi-consulta + ranking

Total: 575 endpoints em 65 plataformas.

Tratamento de Erros

O servidor MCP trata erros com elegância e dá ao agente orientação acionável. Cada erro de API passa o error.message do próprio servidor, seguido por reason: … quando a API nomeia um e request_id: req-… em sua própria linha (lido do corpo, ou do cabeçalho X-Request-Id quando o corpo não é JSON). Cite o request_id ao relatar um problema: é assim que uma chamada é encontrada nos logs e no razão de créditos.

Erro	O que o agente vê
Chave de API ausente	Solicita definir SOCIALCRAWL_API_KEY com link para cadastro
Chave de API inválida	Pede para verificar a configuração da chave
Créditos insuficientes	Mostra o saldo e link para a página de cobrança
Plataforma/recurso inválido	Sugere usar ferramentas de descoberta para encontrar o endpoint certo
Parâmetros ausentes	Lista exatamente o que está faltando com exemplos — detectado localmente, antes da cobrança
Valor de parâmetro inválido	Nomeia o valor de enumeração ilegal, inteiro fora do intervalo, acoplamento quebrado ou CSV longo demais — detectado localmente, antes da cobrança
Recurso não encontrado (404)	A razão do servidor para o item estar ausente (ex.: reason: video_gone) e se você foi cobrado (BIL-01)
Conflito de chave de idempotência (409)	Informa ao agente que a chave foi usada por outra conta — gere uma nova
Incompatibilidade de payload da chave de idempotência (422)	Informa ao agente que a mesma chave foi reutilizada com parâmetros diferentes
Método não permitido (405)	Relata o método HTTP errado para aquela rota
Payload grande demais (413)	Corpo da requisição acima do limite de tamanho JSON; rejeitado antes da análise
Limite de taxa (429)	Acima da janela de 600 req/min por chave — sem cobrança; recue e tente novamente
Limite de concorrência (429)	Pede ao chamador para recuar (50 concorrentes/chave no máximo)
Orçamento da chave excedido (402)	O limite de gastos desta chave foi atingido enquanto a conta ainda tem créditos — aumente o limite, não recarregue
Erro upstream (502)	O relato do servidor sobre qual plataforma falhou, o reembolso e quando tentar novamente
Plataforma indisponível (503)	A causa do servidor (disjuntor aberto ou limitação upstream) e dica de nova tentativa; créditos reembolsados

Links

• Obtenha Sua Chave de API — 100 créditos gratuitos, sem necessidade de cartão de crédito
• Documentação da API — referência completa de endpoints, créditos e códigos de erro
• Site do SocialCrawl
• Pacote npm
• Registro MCP
• Guia de Introdução
• Como Funciona