Social APIS Hub

A API unificada para dados de mídias sociais - construída para desenvolvedores e agentes de IA.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP do SocialAPIs

API unificada de mídias sociais para agentes de IA

Website • Documentação • Discord • npm

SDKs oficiais: Python • JavaScript / TypeScript • Go

🚀 Início Rápido

Instalação

npm install -g @socialapis/mcp

Configuração

Adicione à sua configuração do Claude Desktop:

macOS:

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

🔧 Configuração

Método 1: Argumento de Linha de Comando (Recomendado para Claude Desktop)

{
  "mcpServers": {
    "socialapis": {
      "command": "npx",
      "args": ["-y", "@socialapis/mcp", "YOUR_API_KEY"]
    }
  }
}

Método 2: Variável de Ambiente

# Set environment variable
export SOCIALAPIS_API_KEY=your_api_key_here

# Run without argument
npx @socialapis/mcp

Método 3: Arquivo .env (Para Desenvolvimento)

# Copy example file
cp .env.example .env

# Edit with your values
nano .env

Arquivo .env:

SOCIALAPIS_API_KEY=your_api_key_here
MCP_PROXY_URL=https://mcp.socialapis.io

Variáveis de Ambiente

Variável	Descrição	Padrão
`SOCIALAPIS_API_KEY`	Sua chave de API do SocialAPIs	Nenhum (obrigatório)
`MCP_PROXY_URL`	URL do servidor proxy MCP	`https://mcp.socialapis.io`
`PORT`	Porta do servidor HTTP	`3001`
`API_BASE_URL`	URL da API de backend	`https://api.socialapis.io`

Obter Chave de API

Cadastre-se em socialapis.io
Acesse o Dashboard
Copie sua chave de API
Substitua YOUR_API_KEY na configuração

Teste

Reinicie o Claude Desktop e pergunte:

Get Nike's Facebook page details

📋 Recursos

🌐 API Unificada - Uma interface para múltiplas plataformas
🤖 Primeiro IA - Construída para Claude, Cursor e agentes de IA
📊 Dados Ricos - Posts, comentários, métricas de engajamento
🔍 Filtragem Avançada - Intervalos de tempo, paginação
🎯 Autenticação Simples - Sem complexidade de OAuth
⚡ Rápido - Rede global de edge
🔒 Seguro - Chaves de API permanecem locais

🛠️ Ferramentas Disponíveis

47 ferramentas entre Facebook e Instagram. Cada ferramenta mapeia 1:1 para um endpoint REST em api.socialapis.io — as notas de preço em cada descrição de ferramenta indicam o custo de créditos por chamada.

Facebook — Páginas

facebook_get_page_id — Extrai o ID da página a partir da URL
facebook_get_page_details — Informações da página, seguidores, curtidas, categoria. Defina exact_followers_count=true para o inteiro exato (cobra 5 créditos em vez de 1)
facebook_get_page_posts — Busca posts com after_time / before_time para filtragem por data. limit 3-9, os custos escalam por ceil(returned / 3)
facebook_get_page_videos — Vídeos da página, limit 6-12
facebook_get_page_reels — Reels / vídeos curtos

Facebook — Grupos

facebook_get_group_id — Extrai o ID do grupo a partir da URL
facebook_get_group_details — Detalhes completos (membros, descrição, regras)
facebook_get_group_posts — Posts do grupo, mesmo limit + filtragem por data que os posts de página
facebook_get_group_videos — Vídeos do grupo com paginação

Facebook — Posts

facebook_get_post_id — Extrai o ID do post a partir da URL
facebook_get_post_details — Reações, contagem de comentários, compartilhamentos, mídia
facebook_get_post_details_extended — Campos estendidos: contagens de visualização (essenciais para reels / posts de vídeo), URLs de vídeo, metadados de música/áudio, verificação do autor
facebook_get_post_attachments — Anexos de mídia completos (5 créditos por chamada)
facebook_get_video_details — Metadados + estatísticas de posts de vídeo
facebook_get_post_comments — Comentários de nível superior, limit até 30
facebook_get_comment_replies — Respostas a um comentário específico

Facebook — Busca

facebook_search_pages — Busca páginas por palavra-chave + filtro de localização opcional
facebook_search_people — Busca perfis públicos por palavra-chave
facebook_search_locations — Consulta UIDs de localização do Facebook (para uso em outros endpoints)
facebook_search_posts — Busca posts por palavra-chave, recência, localização
facebook_search_videos — Busca vídeos do Facebook Watch

Facebook — Biblioteca de Anúncios (Transparência de Anúncios da Meta)

facebook_ads_search — Busca anúncios por palavra-chave, país, status
facebook_ads_page_details — Todos os anúncios de uma página específica
facebook_ads_archive_details — Detalhes completos do arquivo de anúncios
facebook_ads_keywords — Busca anúncios por palavra-chave
facebook_ads_countries — Lista de códigos de país suportados

Facebook — Marketplace

facebook_marketplace_search — Busca de itens com filtros de localização, preço, categoria, condição
facebook_marketplace_listing — Detalhes de um único anúncio
facebook_marketplace_seller — Perfil do vendedor + seus anúncios
facebook_marketplace_categories — Navega pela hierarquia de categorias
facebook_marketplace_city_coordinates — Lat/long de uma cidade (para busca por raio)
facebook_marketplace_vehicles — Busca de anúncios específicos de veículos
facebook_marketplace_rentals — Anúncios de imóveis para aluguel

Facebook — Mídia

facebook_download_media — URL de download direto para mídia do FB (imagens, vídeos)

Instagram — Perfil

instagram_get_user_id — Resolve nome de usuário → ID numérico
instagram_get_profile_details — Informações do perfil, contagem de seguidores, bio, contagem de posts
instagram_get_profile_posts — Posts recentes de um perfil
instagram_get_profile_reels — Reels de um perfil
instagram_get_profile_highlights — Lista de destaques de stories
instagram_get_highlight_details — Conteúdo completo de um destaque específico

Instagram — Posts + Reels

instagram_get_post_id — Resolve URL do post → ID
instagram_get_post_details — Curtidas, comentários, mídia, legenda
instagram_get_reels_feed — Feed de reels de um perfil
instagram_get_reels_by_audio — Reels usando um ID específico de áudio/música

Instagram — Descoberta

instagram_popular_search — Consultas / sugestões em alta
instagram_get_location_posts — Posts marcados em uma localização específica
instagram_get_nearby_locations — IDs de localizações próximas (para uso em posts de localização)

Em breve

TikTok (vídeos, perfis, hashtags)
X / Twitter (tweets, perfis, busca)
LinkedIn (páginas de empresas, posts, funcionários)
YouTube (vídeos, canais, comentários)

Acompanhe o roadmap de plataformas em socialapis.io/api-sources.

💡 Exemplos de uso

Cada prompt abaixo é uma sessão real do Claude Desktop. Alguns são padrões de chamada única de ferramenta ("me dê X"); outros exigem que o Claude encadeie múltiplas chamadas + agregue os resultados (indicado onde aplicável).

Padrões de chamada única (rápidos, baratos)

What's Nike's follower count on Facebook?
→ Uses facebook_get_page_details (1 credit)

Get the latest 9 posts from facebook.com/EngenSA
→ Uses facebook_get_page_posts with limit=9 (1-3 credits depending on actual returned count)

Show me the Meta ads currently running for "Apple Vision Pro" in Germany
→ Uses facebook_ads_search (1 credit)

Padrões de múltiplas chamadas (Claude orquestra estes — mas é mais lento + mais caro)

Compare engagement on Nike vs Adidas's last 9 Facebook posts
→ Claude calls facebook_get_page_posts twice (~2-6 credits total),
  aggregates reactions/comments/shares per post, returns a comparison.

What are people saying in the comments on Coca-Cola's last 3 posts?
→ Claude calls facebook_get_page_posts (1 credit) then
  facebook_get_post_comments 3 times (3 credits) and summarizes.

Show me marketplace listings for "PlayStation 5" under $400 in Berlin
→ Claude calls facebook_marketplace_city_coordinates (1 credit) +
  facebook_marketplace_search with filters (1 credit).

O que este servidor MCP NÃO faz

Algumas consultas parecem naturais em um chat ("compare o engajamento no último mês") mas exigem agregações que a API ainda não expõe como uma única ferramenta. Claude ainda pode respondê-las, mas fará muitas chamadas de ferramenta — o que é lento + caro.

Formato da consulta	Por que é difícil
"Taxa de engajamento nos últimos 30 dias" de uma página	Exige buscar todos os posts no intervalo de datas (paginado, `limit` limitado a 9 por chamada) e calcular o engajamento de cada post. Estoura o orçamento de chamadas de ferramenta do LLM em páginas movimentadas.
"Compare as taxas de engajamento entre as Marcas A, B, C no último mês"	Mesmo problema, 3× — uma busca paginada por marca, depois o cálculo de comparação. Funciona para janelas pequenas; lento para "último mês" em páginas de alto volume.
Arquivo histórico mais antigo do que o próprio Facebook disponibiliza	Exibimos o que o Facebook torna publicamente visível. Posts que saíram do feed visível do Facebook não podem ser recuperados.
Séries temporais no servidor (engajamento diário, crescimento semanal)	Ainda não — no roadmap como um futuro endpoint `engagement-stats` com agregação integrada.

Se o seu caso de uso se enquadra em um desses padrões e você quer a agregação pré-computada em vez de orquestrada pelo LLM, entre em contato com o suporte com a consulta específica — estamos priorizando o endpoint de agregação com base na demanda dos clientes.

🏗️ Arquitetura

Claude Desktop
    ↓
@socialapis/mcp (local MCP client)
    ↓
https://mcp.socialapis.io (global proxy)
    ↓
https://api.socialapis.io (data API)

Por que esta arquitetura?

✅ Baixa latência (rede global de edge)
✅ Alta confiabilidade (99,9% de disponibilidade)
✅ Limitação de taxa automática
✅ Cache inteligente
✅ Sua chave de API permanece local

🔧 Desenvolvimento

Configuração Local

# Clone repository
git clone https://github.com/SocialAPIsHub/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Run MCP client
npm start YOUR_API_KEY

# Run HTTP proxy server
npm run serve

Estrutura do Projeto

mcp-server/
├── src/
│   └── tools.js          # Tool definitions
├── mcp-wrapper.js        # MCP client (runs locally)
├── server.js             # HTTP proxy server
├── package.json
├── Dockerfile
└── README.md

Testes

# Test MCP client locally
node mcp-wrapper.js YOUR_API_KEY

# Test HTTP proxy
curl http://localhost:3001/health
curl http://localhost:3001/tools

# Test specific tool
curl -X POST http://localhost:3001/proxy \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"facebook_get_page_details","arguments":{"link":"https://facebook.com/nike"}}'

📊 Preços

Plano	Requisições/Mês	Preço
Grátis	200	$0
Iniciante	30.000	$49
Profissional	120.000	$179
Empresarial	Ilimitado	Personalizado

Ver preços detalhados →

🤝 Contribuindo

Aceitamos contribuições! Consulte CONTRIBUTING.md para detalhes.

Guia Rápido de Contribuição

Faça um fork do repositório
Crie um branch de funcionalidade (git checkout -b feature/amazing-feature)
Faça commit das suas alterações (git commit -m 'Add amazing feature')
Envie para o branch (git push origin feature/amazing-feature)
Abra um Pull Request

📖 Documentação

💬 Suporte

📧 E-mail: support@socialapis.io
💬 Discord: discord.gg/D5bQskrwV
🐛 Problemas: GitHub Issues
📚 Documentação: docs.socialapis.io

🗺️ Roadmap

Entregue:

Suporte à API do Facebook — 31 ferramentas (Páginas, Grupos, Posts, Busca, Biblioteca de Anúncios, Marketplace, Mídia)
Suporte ao Instagram — 16 ferramentas (Perfis, Posts, Reels, Destaques, Descoberta / Localizações)
Implementação do servidor MCP
Servidor proxy HTTP
Pacote npm publicado — @socialapis/mcp
Listagem no Registro MCP — registry.modelcontextprotocol.io
SDK Python — socialapis-sdk no PyPI (51 endpoints, MIT)
SDK JavaScript / TypeScript — socialapis-sdk no npm (Node 18+, Bun, Deno, navegadores)
SDK Go — github.com/SocialAPIsHub/socialapis-go (idiomático, zero dependências)

Próximos:

Suporte ao TikTok
Suporte ao X (Twitter)
Suporte ao LinkedIn
Suporte ao YouTube
Análises avançadas — endpoints de agregação no servidor (engajamento ao longo do tempo, comparações de marcas) para que padrões de múltiplas chamadas se tornem uma única chamada de ferramenta
Webhooks em tempo real — notificações push sobre novos posts / limites de engajamento
Integração com LangChain

As prioridades de plataforma mudam com base na demanda dos clientes. A forma mais rápida de subir algo na fila é enviar um e-mail para support@socialapis.io ou mandar uma DM para @socialapis no Telegram com o caso de uso.

📄 Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

🙏 Agradecimentos

Construído com Model Context Protocol
Alimentado por Anthropic Claude
Inspirado pela comunidade de agentes de IA

🌟 Histórico de Estrelas

Feito com ❤️ pela equipe SocialAPIs

Website • Twitter • Discord

Python SDK • JS SDK • Go SDK