Social Fetch

MCP hospedado para dados sociais públicos (TikTok, Instagram, Reddit, X, YouTube e mais) como JSON estruturado.

Documentação

Social Fetch MCP

Deixe seu agente de codificação buscar dados reais de mídias sociais e da web enquanto ele desenvolve.

Documentação | Referência da API | Créditos e cobrança

URL do servidor: https://api.socialfetch.dev/mcp

O que é isso?

O Social Fetch MCP conecta Cursor, VS Code, Claude, Windsurf e outros clientes MCP à API do Social Fetch. Uma vez instalado, seu agente pode consultar criadores, buscar posts, pesquisar em plataformas, ler páginas da web, verificar seu saldo e ler a documentação do Social Fetch diretamente do seu editor.

Use-o quando quiser que seu agente responda perguntas como:

"Encontre este criador do TikTok e adicione os vídeos mais recentes ao meu app."
"Puxe a transcrição deste vídeo do YouTube e resuma os patrocínios."
"Busque este post do Instagram, inspecione a forma da resposta e conecte-o ao meu backend."
"Leia a documentação do Social Fetch e escolha o endpoint certo para busca no Reddit."

O próprio servidor MCP é hospedado pelo Social Fetch:

https://api.socialfetch.dev/mcp

Não há servidor local para clonar, compilar ou executar a partir deste repositório. Os clientes se conectam ao endpoint hospedado via Streamable HTTP e autenticam com OAuth no navegador.

Por que usar?

Os agentes são melhores quando podem trabalhar com a mesma API que seu app usa. Isso dá a eles uma rota direta e autenticada para o Social Fetch, em vez de fazer você alternar entre documentação, dashboards, scripts e JSON colado.

Menos configuração: chame as ferramentas do Social Fetch diretamente do seu agente.
Respostas melhores: o agente pode pesquisar e ler a documentação ao vivo antes de escolher um endpoint.
Dados reais no fluxo: teste com TikTok, Instagram, YouTube, X/Twitter, Reddit, Spotify, web e mais, direto do seu editor.
Sem chaves de API na configuração do editor: faça login uma vez com OAuth.
A mesma API em todos os lugares: as ferramentas MCP mapeiam para a API REST pública, SDK e documentação.

O que você pode buscar

O Social Fetch MCP expõe ferramentas de endpoint para:

Dados de TikTok, Instagram, YouTube, X/Twitter, Telegram, Facebook, Threads, LinkedIn, Reddit e Spotify.
Perfis, posts, vídeos, comentários, transcrições, resultados de busca e metadados específicos da plataforma.
Geração de markdown para web e perguntas sobre páginas web assistidas por IA.
Identidade da conta e saldo de créditos.
Documentação do Social Fetch via docs_search e docs_read.

As ferramentas de endpoint são medidas, assim como a API REST. Ferramentas de documentação, auth_whoami e billing_balance_get não consomem créditos de consulta.

Requisitos

Uma conta no Social Fetch.
Créditos para rotas de API medidas.
Um cliente MCP com suporte a Streamable HTTP remoto e OAuth, como Cursor, VS Code, Claude Code, Claude Desktop ou MCP Inspector.

Instalação com um clique

Complete o fluxo do navegador OAuth após a instalação. Se um link de um clique não fizer nada - seu editor não está instalado, bloqueia esquemas de URL personalizados ou não tem handler - use a configuração manual abaixo.

Configuração manual

Cursor

Adicione isso a ~/.cursor/mcp.json ou a um projeto .cursor/mcp.json:

{
  "mcpServers": {
    "socialfetch": {
      "url": "https://api.socialfetch.dev/mcp"
    }
  }
}

Reinicie o Cursor, abra as configurações de MCP e complete o fluxo do navegador OAuth quando solicitado.

VS Code

Adicione isso a settings.json:

{
  "mcp": {
    "servers": {
      "socialfetch": {
        "url": "https://api.socialfetch.dev/mcp"
      }
    }
  }
}

Claude Code

claude mcp add --transport http socialfetch https://api.socialfetch.dev/mcp

Depois execute /mcp e autentique o Social Fetch para finalizar o fluxo OAuth.

Claude Desktop

Adicione um conector MCP remoto personalizado com esta URL:

https://api.socialfetch.dev/mcp

Autorize o Social Fetch quando o Claude solicitar.

Clientes apenas para stdio

Se o seu cliente só suporta servidores MCP stdio, use mcp-remote como ponte para o servidor hospedado:

npx mcp-remote https://api.socialfetch.dev/mcp

Aponte seu cliente para o processo stdio que esse comando inicia.

Autenticação

O Social Fetch MCP usa OAuth 2.1. Seu cliente MCP cuida do fluxo:

O cliente abre o login do Social Fetch no seu navegador.
Você entra ou cria uma conta e aprova o acesso.
O cliente recebe um token de acesso e o envia em cada solicitação MCP.

Não cole uma chave de API do Social Fetch na configuração do MCP. Os créditos são debitados da conta conectada, assim como nas solicitações de API REST.

Ferramentas

tools/list expõe ferramentas de endpoint e ferramentas de documentação.

Os nomes das ferramentas de endpoint correspondem aos IDs de operação da API, com pontos substituídos por sublinhados:

Nome da ferramenta	Operação da API
`tiktok_profile_get`	`tiktok.profile.get`
`instagram_post_get`	`instagram.post.get`
`web_markdown_generate`	`web.markdown.generate`
`auth_whoami`	`auth.whoami`
`billing_balance_get`	`billing.balance.get`

Os argumentos de cada ferramenta de endpoint espelham os parâmetros da rota correspondente da API. Veja a referência da API para o catálogo completo de endpoints, esquemas de argumentos, formas de resposta e preços.

Duas ferramentas de documentação também estão disponíveis:

Nome da ferramenta	Finalidade
`docs_search`	Pesquisar a documentação do Social Fetch em API, SDK, autenticação, erros, créditos e integrações.
`docs_read`	Ler uma página completa de documentação como markdown pelo pathname, como `/docs/sdk`.

Prompt sugerido para o agente:

Use a documentação do MCP do Social Fetch para adicionar consulta de perfil do TikTok a este app com o SDK TypeScript.

Exemplo: Perfil do TikTok

No Cursor, MCP Inspector ou outro cliente MCP, chame tiktok_profile_get com:

{ "handle": "nike" }

O resultado contém o mesmo envelope data e meta retornado pela API REST. Verifique meta.creditsCharged e meta.requestId após chamadas medidas.

Solução de problemas

Sintoma	O que verificar
`401` em todas as chamadas	Reconecte o servidor e complete o OAuth novamente. Seu token pode estar ausente ou expirado.
Loop de redirecionamento OAuth	Termine o login no Social Fetch e depois aprove o acesso para voltar ao seu cliente.
Respostas com `402`	Sua conta está sem créditos para a rota medida. Recarregue em Créditos e cobrança.
Nenhuma ferramenta listada	Reconecte o servidor. Se persistir, reinicie o cliente MCP.
Cliente suporta apenas stdio	Use `npx mcp-remote https://api.socialfetch.dev/mcp`.

Conteúdo do repositório

server.json - Metadados do registro MCP para o servidor remoto hospedado.
examples/ - Trechos de configuração de clientes MCP para copiar e colar.
assets/socialfetch-mark.svg - Cópia local da marca do Social Fetch (também servida em https://api.socialfetch.dev/mcp/icon.svg).

A implementação vive no serviço de API privado do Social Fetch, não neste repositório de listagem pública.

Relacionados

Licença

MIT (c) Social Freak Ltd