Socialcrawl MCP

Chave de API única para acessar dados de redes sociais em tempo real de mais de 21 fontes

Documentação

socialcrawl-mcp

Dê ao seu agente de IA acesso a 44 plataformas — mídias sociais, comércio e avaliações de produtos, lojas de aplicativos, lugares e viagens, reputação empresarial, pesquisa na web, web scraping completo e automação de navegador, mercados de previsão, tendências de busca, composites Prism entre plataformas e uma meta-busca universal entre plataformas — por meio de uma única API

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 44 plataformas e 357 endpoints.

Recupere perfis, postagens, comentários, resultados de busca, conteúdo em alta e análises de TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Reddit, GitHub, Hacker News, Polymarket e mais 30 plataformas. Obtenha produtos, avaliações e vendedores da Amazon e do Google Shopping; aplicativos, gráficos e avaliações do Google Play e da Apple App Store; lugares, hotéis e avaliações de viajantes do Tripadvisor e do Google Business; reputação de marca da Trustpilot; busca em coreano em 11 corpora do Naver; menções à marca na web com sentimento via Content Analysis; manchetes do Google News e cotações do Google Finance — além de pesquisa na web via Tavily e Perplexity, busca no X com IA via Grok e um único endpoint /search/everywhere que se expande por mais de 12 fontes em uma chamada.

Novidades nesta versão: uma grande expansão do LinkedIn (44 endpoints — perfis completos e páginas de empresas, postagens/repostagens/reações, comentários e respostas, busca de pessoas e pessoas-empresa, sub-recursos estruturados de perfil, empregos, insights de empresas e grupos), cobertura mais profunda do Instagram (seguidores/seguindo, contas semelhantes, curtidores de postagens, stories, feeds de marcados e localização, estatísticas de compartilhamento de postagens, análises de engajamento e feeds de reels/postagens em uma chamada com contagens de compartilhamento por item) e novas capacidades do YouTube (busca em alta e avançada, sugestões de autocompletar, itens de playlist e arquivos de mídia para download — áudio, vídeo, legendas, miniaturas). Além da família Prism — endpoints compostos no lado do servidor que se expandem por muitas plataformas e consolidam os resultados em um único relatório (URL universal lookup, coleta completa de comments, reputation entre fontes, share-of-voice, previsões de menção à marca e demanda do consumidor, consenso de IA answers, radar de crises, verificação de criadores e inteligência de vídeo/aplicativo/produto). Uma chave de API, um formato de resposta consistente, todas as plataformas.

O que o servidor MCP faz:

Descobre plataformas e endpoints disponíveis dinamicamente
Busca dados ao vivo de mídias sociais em seu nome
Valida solicitações localmente antes de fazer chamadas à API (economiza créditos)
Fornece documentação integrada da API que o agente pode consultar sob demanda

Instalação

Servidor remoto (hospedado — sem instalação)

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

Claude Code (funciona na CLI e no Claude Code na web / sandboxes em 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, então você pode explorar antes de se inscrever. Os conectores personalizados do claude.ai (Settings → Connectors) 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 de 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 a ~/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 a .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 a .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 como 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 do MCP. As ferramentas de descoberta e documentação funcionam mesmo sem chave — apenas solicitações reais à 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.

Pesquisar em várias 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 à API — uma por plataforma — e compila os resultados em uma comparação.

Explorar endpoints disponíveis

What social media platforms can you access?

Show me all the TikTok endpoints

Acessar documentação

How does the SocialCrawl credit system work?

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 — nenhuma lógica de análise por plataforma é necessária.

Ferramentas Disponíveis

O servidor MCP expõe 7 ferramentas:

Ferramenta	Descrição	Precisa de chave de API?
`socialcrawl_list_platforms`	Descubra todas as 44 plataformas com seus endpoints e capacidades	Não
`socialcrawl_list_endpoints`	Veja todos os endpoints, parâmetros obrigatórios e custos de créditos para uma plataforma	Não
`socialcrawl_request`	Faça qualquer chamada à API SocialCrawl — perfis, postagens, comentários, busca, tendências, análises, composites Prism. Endpoints GET aceitam `params` de consulta; endpoints POST em lote (ex.: youtube/videos, prism/profiles) aceitam seu array/objeto `body`. Suporta um `idempotencyKey` opcional para chamadas seguras com retry.	Sim
`socialcrawl_check_balance`	Verifique os créditos restantes e o resumo de deduções recentes. Chama `/v1/credits/balance` — 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`	Web scraping completo e automação de navegador (a plataforma `web`). Scrape/busca/mapa/extração síncronos; jobs assíncronos de crawl/batch_scrape/agente com poll/cancel; monitores com estado; sessões interativas de navegador. Um `action` por endpoint.	Sim
`socialcrawl_get_docs`	Acesse documentação detalhada da API por tópico ou plataforma	Não

Três das sete ferramentas funcionam sem chave de API — elas consultam dados locais incluídos. socialcrawl_request, socialcrawl_check_balance, socialcrawl_monitors e socialcrawl_web exigem uma chave.

Monitores — agende qualquer receita

socialcrawl_monitors envolve qualquer endpoint do registro ou composite Prism em um monitor agendado e com estado (/v1/monitors/*). Ele reexecuta a receita a cada hora/dia/semana (ou em um cron), entrega cada resultado a um webhook assinado com HMAC, gera alertas em limites ou alterações de métricas e mantém uma série temporal por execução que você pode consultar. "Prism responde uma vez; 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 — scrape, crawl, navegação

socialcrawl_web conduz toda a superfície de web scraping e automação de navegador (a plataforma web, /v1/web/*) por meio de um único parâmetro action:

Leituras síncronas — scrape (URL → markdown/HTML/screenshot/links), search (busca na web com conteúdo da página), map (descobrir URLs de um site), extract (dados estruturados por LLM de uma página).
Jobs assíncronos — crawl um site inteiro, batch_scrape muitas URLs, ou agent (tarefa web autônoma de múltiplas etapas); cada um retorna um job que você consulta com job_get/job_list e interrompe com job_cancel.
Monitores — monitor_create/list/get/update/delete/checks re-verificam uma URL em uma cadência e entregam alterações a um webhook.
Sessões — session_create/get/list, session_execute (executar código na página ao vivo), session_close.

O preço varia por ação (scrape 1cr, busca 2cr, extract e session_create 5cr, agent 25cr; gerenciamento de job/monitor/sessão 0cr). Veja o tópico socialcrawl_get_docs web.

Validação inteligente

Antes de fazer qualquer chamada à API, socialcrawl_request valida localmente se a plataforma existe, se o endpoint existe e se todos os parâmetros obrigatórios estão presentes. Se algo estiver errado, ele diz ao agente exatamente como corrigir — sem consumir nenhum crédito.

Solicitações seguras com retry

Passe um idempotencyKey para socialcrawl_request (UUIDv4 recomendado) para tornar a chamada segura com retry. Se a solicitaçã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	44	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…), empregos (busca, vagas de empresas, detalhes), insights de empresas, grupos, transcrições, Ad Library, profile-360
Instagram	33	Perfis, posts, reels, comentários (incl. consulta de comentário individual), destaques, stories, feeds de marcação e localização, seguidores/seguindo, contas semelhantes, curtidores de posts, estatísticas de compartilhamento, feeds de reels/posts em uma única chamada com contagens de compartilhamento, análises de engajamento, busca (reels/hashtag/perfil/localização/música), tendências, transcrições, profile-360
Prism	33	Compostos entre plataformas — consulta de URL, coleta de comentários, consulta em lote de comentários e perfis, auditoria de handles, menções à marca, sinais de demanda, visibilidade de IA, radar de crise/pós-mortem, reputação, share of voice, verificação de criadores, respostas de consenso de IA, inteligência de vídeo/aplicativos/produtos
YouTube	28	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, arquivos de mídia (áudio/vídeo/legendas/miniaturas), transcrições, vídeos/canais/transcrições em lote, profile-360
Facebook	22	Páginas, posts, comentários, grupos, fotos, reels, eventos, Marketplace, transcrições, Ad Library completa
Web Scraping	22	Scrape, busca na web, mapa do site, extração via LLM, crawl assíncrono/trabalhos em lote de scrape/agentes, monitores de alterações, sessões de navegador interativas, parse de documentos — impulsionado por `socialcrawl_web`
TikTok	20	Perfis, vídeos, comentários e respostas (incl. consulta de comentário individual), busca, tendências, público, seguidores, ao vivo, músicas, transcrições, profile-360
GitHub	12	Usuários, repositórios, issues, PRs, READMEs, releases, busca, dossiê de repositório, velocidade de perfil do usuário
Naver	12	Portal nº 1 da Coreia — blog, notícias, livros, enciclopédia, café, KiN, local, compras, doc, imagens, busca web, brief
Content Analysis	10	Menções à marca na web, sentimento, distribuições de avaliações, tendências de frases/categorias
Google	10	Busca web, Ads Transparency, Perfil da Empresa (informações, avaliações, atualizações, Q&A), hotéis do Travel
Apple App Store	9	Busca de apps, sugestões de busca, detalhes de apps, avaliações, rankings, banco de listagens, dados de referência
Google Play	9	Busca de apps, sugestões de busca, detalhes de apps, avaliações, rankings, banco de listagens, dados de referência
Twitter/X	8	Perfis, tweets, comunidades, transcrições de vídeo, busca com IA via Grok, profile-360
Reddit	7	Subreddits, posts, comentários, busca, transcrições, varredura omni-search de VoC
Spotify	6	Artistas, faixas, álbuns, podcasts, episódios, busca
Amazon	5	Busca de produtos, detalhes de ASIN, avaliações, vendedores, páginas de loja
Pinterest	5	Pins, quadros, busca, contagens de salvamento de URL
Rumble	5	Busca, vídeos do canal, detalhes de vídeo, comentários, transcrições
Threads	5	Perfis, posts, busca por palavra-chave, busca de usuários
TikTok Shop	5	Produtos, avaliações, listagens, busca, vitrines de criadores
Google Shopping	4	Busca de produtos, detalhes de produtos, avaliações entre varejistas, vendedores
Hacker News	4	Busca de histórias, história, árvore de comentários, perfil
Tavily	4	Busca web (com resposta via LLM), extração de URL, sitemap, crawl completo
Twitch	4	Perfis, clipes, vídeos, programação
Bluesky	3	Perfis, posts
Google Finance	3	Cotações de instrumentos, visão geral de mercados, busca de tickers
Kwai	3	Perfis, posts
Truth Social	3	Perfis, posts
Google Trends	2	Interesse ao longo do tempo (explorar) + consultas relacionadas em alta/destaque
Tripadvisor	2	Busca de lugares, avaliações de viajantes
Trustpilot	2	Busca de empresas, avaliações de empresas
Universal Search	2	Uma única consulta distribuída por 12+ plataformas (20cr); faixa de fóruns
Google News	1	Busca em tempo real do 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
Perplexity	1	Pesquisa web Sonar com fontes citadas
Pillar	1	Páginas de links
Polymarket	1	Pesquisa de mercados de previsão — distribuição multi-consulta + ranqueamento
Snapchat	1	Perfis
Utility	1	Detecção de idade e gênero

Total: 357 endpoints em 44 plataformas.

Tratamento de Erros

O servidor MCP trata erros com elegância e fornece orientação acionável ao agente:

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 saldo e link para a página de cobrança
Plataforma/recurso incorreto	Sugere usar ferramentas de descoberta para encontrar o endpoint certo
Parâmetros ausentes	Lista exatamente o que está faltando com exemplos
Recurso não encontrado (404)	Informa que o recurso upstream não existe; créditos reembolsados automaticamente (BIL-01)
Conflito de Idempotency-Key (409)	Informa ao agente que a chave foi usada por outra conta — gere uma nova
Incompatibilidade de payload da Idempotency-Key (422)	Informa que a mesma chave foi reutilizada com parâmetros diferentes
Método não permitido (405)	Lembra ao chamador que `/v1/*` é somente GET
Limite de concorrência (429)	Pede ao chamador para recuar (máx. 50 concorrentes/por chave)
Erro upstream (502)	Relata a falha; créditos reembolsados automaticamente
Plataforma indisponível (503)	Circuit breaker aberto; créditos reembolsados; tente novamente em 30s