SocialAPIs — Facebook & Instagram Data

oficial

Dados do Facebook e Instagram para agentes de IA — páginas, posts, grupos, Biblioteca de Anúncios, Marketplace, perfis e reels. 47 ferramentas somente leitura, saída estruturada. Plano gratuito: 200 chamadas/mês.

O que você pode fazer com SocialAPIs — Facebook & Instagram Data MCP?

  • Dados de páginas e grupos do Facebook — Obtenha detalhes de páginas ou grupos, publicações, vídeos, reels e álbuns de fotos por link ou ID.
  • Busca de publicações e comentários do Facebook — Obtenha detalhes da publicação, anexos, comentários e respostas a comentários a partir do link de uma publicação.
  • Busca na Biblioteca de Anúncios da Meta — Pesquise anúncios por palavra-chave ou anunciante, obtenha detalhes da página do anunciante e liste os países compatíveis.
  • Dados de perfis e publicações do Instagram — Recupere detalhes do perfil, publicações, reels, destaques e detalhes completos de publicações por nome de usuário ou shortcode.
  • Busca e locais do Instagram — Pesquise usuários, hashtags e lugares por palavra-chave ou liste publicações marcadas em um local.
  • Busca no Facebook Marketplace — Pesquise anúncios, veículos e aluguéis com filtros e obtenha detalhes do anúncio ou do vendedor.

Servidor MCP hospedado

npx add-mcp 'https://mcp.socialapis.io/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Dê aos assistentes de IA acesso direto a dados públicos do Facebook e Instagram com o servidor Model Context Protocol (MCP) do SocialAPIs.

O servidor disponibiliza 12 ferramentas somente de leitura que abrangem 50 ações: páginas, publicações, comentários, grupos, Meta Ads Library, Marketplace, perfis do Instagram, publicações, reels e locais. Cada ferramenta abrange um recurso e recebe um argumento action. Cada chamada retorna uma saída estruturada, incluindo os créditos cobrados e os créditos restantes.

1. Obtenha uma chave de API

Cadastre-se em socialapis.io e copie sua chave no painel. O plano gratuito inclui 200 créditos por mês, sem necessidade de cartão de crédito.

2. Conecte seu cliente

Há duas maneiras de se conectar.

Endpoint hospedado (recomendado)

Não é necessário instalar nada. Configure qualquer cliente compatível com servidores MCP remotos para usar:

https://mcp.socialapis.io/mcp

Envie sua chave em um cabeçalho:

Authorization: Bearer YOUR_API_KEY

x-api-token: YOUR_API_KEY também funciona. Nunca coloque a chave na URL.

Servidor local (npx)

Para clientes que executam apenas servidores locais, como o Claude Desktop. Requer Node.js 18 ou mais recente.

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

Configuração do cliente

Claude Code

claude mcp add --transport http socialapis https://mcp.socialapis.io/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

VS Code

Adicione a .vscode/mcp.json. O VS Code solicita a chave quando o servidor é iniciado, portanto ela não fica armazenada no arquivo:

{
  "servers": {
    "socialapis": {
      "type": "http",
      "url": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer ${input:socialapis-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "socialapis-key",
      "description": "SocialAPIs API key",
      "password": true
    }
  ]
}

Cline

Em MCP Servers → Configure, adicione a cline_mcp_settings.json:

{
  "mcpServers": {
    "socialapis": {
      "type": "streamableHttp",
      "url": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "socialapis": {
      "serverUrl": "https://mcp.socialapis.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Ferramentas disponíveis

Versão atual: 2.0.2. O servidor tem 12 ferramentas somente de leitura. Cada uma abrange um recurso e recebe um argumento action, além das entradas da ação:

FerramentaAções
facebook_pagedetails, id, posts, videos, reels, albums, album_items
facebook_groupdetails, id, posts, videos, albums, album_items
facebook_postdetails, details_extended, id, attachments, video, comments, comment_replies
facebook_searchpages, people, posts, videos, locations
facebook_adssearch, keywords, page_details, archive_details, countries
facebook_marketplacesearch, vehicles, rentals, listing, seller, categories, city_coordinates
facebook_media_downloaddownload
instagram_profiledetails, id, posts, reels, highlights, highlight_details
instagram_postdetails, id
instagram_reelsfeed, by_audio
instagram_searchsearch
instagram_locationposts, nearby

Exemplo de chamada:

{ "name": "facebook_post", "arguments": { "action": "comments", "link": "https://www.facebook.com/nike/posts/POST_ID", "limit": 20 } }

Um action ausente ou uma entrada obrigatória ausente gera um erro antes que qualquer crédito seja gasto. A descrição de cada ferramenta no seu cliente lista as mesmas entradas para cada ação.

Atualizando da versão 1.x? Os nomes antigos de ferramentas por endpoint (como facebook_get_page_details) ainda funcionam quando chamados diretamente, então os scripts existentes continuam funcionando. Se o seu cliente aprova automaticamente ou permite ferramentas por nome, adicione os novos nomes acima.

Entradas por ação

Os créditos são cobrados por chamada, salvo indicação em contrário. Paginação: passe o end_cursor de uma resposta para obter a próxima página.

facebook_page

Páginas do Facebook: detalhes do perfil, ID da página, publicações, vídeos, reels e álbuns de fotos.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
detailslinkexact_followers_count1 (5 com exact_followers_count=true)
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 a cada 3 publicações retornadas (mín. 1)
videoslink ou profile_idlimit, end_cursor1
reelslinkend_cursor1
albumsprofile_id (de id)limit (8-16), end_cursor1
album_itemsalbum_id (de albums)end_cursor1

facebook_group

Grupos públicos do Facebook: detalhes, ID do grupo, publicações, vídeos e álbuns de fotos.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
detailslink—1
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 a cada 3 publicações retornadas (mín. 1)
videoslinkend_cursor1
albumsgroup_id (de id)limit (8-16)1
album_itemsalbum_id (de albums)end_cursor1

facebook_post

Publicações, vídeos e comentários do Facebook: detalhes das publicações, anexos, comentários e respostas.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
detailslink—1
details_extendedlink—1
idlink—1
attachmentspost_id—5
videovideo_id—1
commentslinklimit, end_cursor, include_reply_info1
comment_repliescomment_feedback_id, expansion_token—1

facebook_search

Pesquise no Facebook por palavra-chave: páginas, pessoas, publicações, vídeos e locais.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
pagesquerylocation_uid, end_cursor1
peoplequerylocation_uid, end_cursor1
postsquerylocation_uid, start_time, end_time, recent_posts, end_cursor1
videosquerymost_recent, videos_live, fields, end_cursor1
locationsquery—1

facebook_ads

Meta Ads Library: pesquise anúncios, encontre anunciantes por palavra-chave, consulte detalhes da página do anunciante, detalhes de um anúncio e países compatíveis.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
search—query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor1
keywordsquerycountry1
page_detailspage_id—1
archive_detailsad_archive_idpage_id, country, is_ad_non_political, is_ad_not_aaa_eligible1
countries——1

facebook_marketplace

Facebook Marketplace: pesquise anúncios, veículos e aluguéis; consulte detalhes de anúncios e vendedores, categorias e coordenadas de cidades.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
search—query, category_url, commerce_search_sort_by, commerce_search_and_rp_condition, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, posted_today, exact_match, limit, end_cursor1
vehicles—sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, is_c2c_listing_only, end_cursor1
rentals—sort_by, filter_location_latitude, filter_location_longitude, filter_price_lower_bound, filter_price_upper_bound, filter_radius_km, filter_bedrooms_min, filter_bedrooms_max, filter_bathrooms_min, filter_bathrooms_max, end_cursor1
listinglisting_id—1
sellerseller_id—1
categories——1
city_coordinatescitycountry, exactly_one1

facebook_media_download

Baixe mídias do Facebook (imagens, vídeos, áudio) a partir de uma URL.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
downloadurl—1

instagram_profile

Perfis do Instagram: detalhes, ID do usuário, publicações, reels, destaques e stories dos destaques.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
detailsusernamelink1
id—link, username1
posts—username, user_id, end_cursor1
reelsuser_idend_cursor1
highlightsuser_id—1
highlight_detailshighlight_id—1

instagram_post

Publicações do Instagram: detalhes completos da publicação ou o shortcode de uma URL de publicação.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
detailsshortcode—1
idlink—1

instagram_reels

Instagram Reels: feed de tendências ou reels que usam uma determinada faixa de áudio.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
feed—clips_media_id1
by_audioaudio_idmax_id1

instagram_search

Pesquise no Instagram por palavra-chave para encontrar usuários populares, hashtags e locais.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
searchkeywordend_cursor1

instagram_location

Locais do Instagram: publicações marcadas em um lugar e locais próximos.

AçãoEntradas obrigatóriasEntradas opcionaisCréditos
postslocation_idtab, end_cursor1
nearbylocation_id—1

Exemplos de prompts

"Obtenha os detalhes da página do Facebook da Nike e resuma as 10 publicações mais recentes."

"Compare o número de seguidores da Adidas e da Nike no Instagram."

"Encontre anúncios ativos na Meta Ads Library que mencionem 'running shoes' nos EUA."

Solução de problemas

SintomaSolução
Missing SocialAPIs API keyAdicione o cabeçalho Authorization: Bearer <key> (hospedado) ou SOCIALAPIS_API_KEY (npx).
HTTP 401 ou 403 em um resultadoCopie novamente a chave do painel.
Insufficient creditsFaça upgrade ou adicione créditos em socialapis.io/pricing.
Nenhuma ferramenta listadaReinicie o cliente após editar a configuração e verifique se https://mcp.socialapis.io/health responde (abra-o em um navegador).

Onde nos encontrar

O servidor está listado no registro oficial do MCP como io.github.SocialAPIsHub/social-media-api, e também no Smithery, Glama, cursor.directory, LobeHub, mcp.so e mcpservers.org. Consulte socialapis.io/integrations para ver os links.

Código-fonte: github.com/SocialAPIsHub/mcp-server. Dúvidas: support@socialapis.io.