SocialAPIs — Facebook & Instagram Data
oficialDatos de Facebook e Instagram para agentes de IA: páginas, publicaciones, grupos, Biblioteca de Anuncios, Marketplace, perfiles y reels. 47 herramientas de solo lectura, salida estructurada. Plan gratuito: 200 llamadas/mes.
¿Qué puedes hacer con SocialAPIs — Facebook & Instagram Data MCP?
- Datos de páginas y grupos de Facebook — Obtén detalles de páginas o grupos, publicaciones, videos, reels y álbumes de fotos mediante un enlace o ID.
- Búsqueda de publicaciones y comentarios de Facebook — Obtén detalles de publicaciones, archivos adjuntos, comentarios y respuestas a comentarios a partir del enlace de una publicación.
- Búsqueda en la biblioteca de anuncios de Meta — Busca anuncios por palabra clave o anunciante, obtén detalles de la página del anunciante y consulta los países admitidos.
- Datos de perfiles y publicaciones de Instagram — Recupera detalles de perfiles, publicaciones, reels, historias destacadas y detalles completos de publicaciones mediante un nombre de usuario o shortcode.
- Búsqueda y ubicaciones de Instagram — Busca usuarios, hashtags y lugares por palabra clave, o consulta las publicaciones etiquetadas en una ubicación.
- Búsqueda en Facebook Marketplace — Busca anuncios, vehículos y alquileres con filtros, y obtén detalles de los anuncios o vendedores.
Servidor MCP alojado
npx add-mcp 'https://mcp.socialapis.io/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Ofrece a los asistentes de IA acceso directo a datos públicos de Facebook e Instagram con el servidor Model Context Protocol (MCP) de SocialAPIs.
El servidor ofrece 12 herramientas de solo lectura que cubren 50 acciones: páginas, publicaciones, comentarios, grupos, la biblioteca de anuncios de Meta, Marketplace, perfiles de Instagram, publicaciones, reels y ubicaciones. Cada herramienta cubre un recurso y acepta un argumento action. Cada llamada devuelve resultados estructurados, incluidos los créditos cobrados y los créditos restantes.
1. Obtén una clave de API
Regístrate en socialapis.io y copia tu clave desde el panel. El plan gratuito incluye 200 créditos al mes y no requiere tarjeta de crédito.
2. Conecta tu cliente
Hay dos formas de conectarse.
Endpoint alojado (recomendado)
No hay que instalar nada. Configura cualquier cliente compatible con servidores MCP remotos para que use:
https://mcp.socialapis.io/mcp
Envía tu clave en un encabezado:
Authorization: Bearer YOUR_API_KEY
También funciona x-api-token: YOUR_API_KEY. Nunca incluyas la clave en la URL.
Servidor local (npx)
Para clientes que solo ejecutan servidores locales, como Claude Desktop. Requiere Node.js 18 o posterior.
{
"mcpServers": {
"socialapis": {
"command": "npx",
"args": ["-y", "@socialapis/mcp"],
"env": {
"SOCIALAPIS_API_KEY": "YOUR_API_KEY"
}
}
}
}
Configuración del cliente
Claude Code
claude mcp add --transport http socialapis https://mcp.socialapis.io/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
VS Code
Añádelo a .vscode/mcp.json. VS Code solicita la clave cuando se inicia el servidor, por lo que no se guarda en el archivo:
{
"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
En MCP Servers → Configure, añádelo a cline_mcp_settings.json:
{
"mcpServers": {
"socialapis": {
"type": "streamableHttp",
"url": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Windsurf
Añádelo a ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"socialapis": {
"serverUrl": "https://mcp.socialapis.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Herramientas disponibles
Versión actual: 2.0.2. El servidor tiene 12 herramientas de solo lectura. Cada una cubre un recurso y acepta un argumento action, además de las entradas de esa acción:
| Herramienta | Acciones |
|---|---|
facebook_page | details, id, posts, videos, reels, albums, album_items |
facebook_group | details, id, posts, videos, albums, album_items |
facebook_post | details, details_extended, id, attachments, video, comments, comment_replies |
facebook_search | pages, people, posts, videos, locations |
facebook_ads | search, keywords, page_details, archive_details, countries |
facebook_marketplace | search, vehicles, rentals, listing, seller, categories, city_coordinates |
facebook_media_download | download |
instagram_profile | details, id, posts, reels, highlights, highlight_details |
instagram_post | details, id |
instagram_reels | feed, by_audio |
instagram_search | search |
instagram_location | posts, nearby |
Ejemplo de llamada:
{ "name": "facebook_post", "arguments": { "action": "comments", "link": "https://www.facebook.com/nike/posts/POST_ID", "limit": 20 } }
Si falta action o alguna entrada obligatoria, se devuelve un error antes de gastar créditos. La descripción de cada herramienta en tu cliente enumera las mismas entradas para cada acción.
¿Actualizas desde la versión 1.x? Los nombres antiguos de herramientas por endpoint (como facebook_get_page_details) siguen funcionando si se llaman directamente, así que los scripts existentes seguirán ejecutándose. Si tu cliente aprueba automáticamente las herramientas o las incluye en una lista de permitidas por nombre, añade los nuevos nombres indicados arriba.
Entradas por acción
Los créditos se cobran por llamada, salvo que se indique lo contrario. Paginación: pasa el end_cursor de una respuesta para obtener la página siguiente.
facebook_page
Páginas de Facebook: detalles del perfil, ID de página, publicaciones, videos, reels y álbumes de fotos.
| Acción | Entradas obligatorias | Entradas opcionales | Créditos |
|---|---|---|---|
details | link | exact_followers_count | 1 (5 con exact_followers_count=true) |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 por cada 3 publicaciones devueltas (mín. 1) |
videos | link o profile_id | limit, end_cursor | 1 |
reels | link | end_cursor | 1 |
albums | profile_id (de id) | limit (8-16), end_cursor | 1 |
album_items | album_id (de albums) | end_cursor | 1 |
facebook_group
Grupos públicos de Facebook: detalles, ID del grupo, publicaciones, videos y álbumes de fotos.
| Acción | Entradas obligatorias | Entradas opcionales | Créditos |
|---|---|---|---|
details | link | — | 1 |
id | link | — | 1 |
posts | link | limit, end_cursor, after_time, before_time, timezone | 1 por cada 3 publicaciones devueltas (mín. 1) |
videos | link | end_cursor | 1 |
albums | group_id (de id) | limit (8-16) | 1 |
album_items | album_id (de albums) | end_cursor | 1 |
facebook_post
Publicaciones, videos y comentarios de Facebook: detalles de publicaciones, archivos adjuntos, comentarios y respuestas.
| Acción | Entradas obligatorias | Entradas opcionales | Créditos |
|---|---|---|---|
details | link | — | 1 |
details_extended | link | — | 1 |
id | link | — | 1 |
attachments | post_id | — | 5 |
video | video_id | — | 1 |
comments | link | limit, end_cursor, include_reply_info | 1 |
comment_replies | comment_feedback_id, expansion_token | — | 1 |
facebook_search
Busca en Facebook por palabra clave: páginas, personas, publicaciones, videos y ubicaciones.
| Acción | Entradas obligatorias | Entradas opcionales | Créditos |
|---|---|---|---|
pages | query | location_uid, end_cursor | 1 |
people | query | location_uid, end_cursor | 1 |
posts | query | location_uid, start_time, end_time, recent_posts, end_cursor | 1 |
videos | query | most_recent, videos_live, fields, end_cursor | 1 |
locations | query | — | 1 |
facebook_ads
Biblioteca de anuncios de Meta: busca anuncios, encuentra anunciantes por palabra clave, consulta detalles de páginas de anunciantes y de anuncios individuales, y países admitidos.
| Acción | Entradas obligatorias | Entradas opcionales | Créditos |
|---|---|---|---|
search | — | query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor | 1 |
keywords | query | country | 1 |
page_details | page_id | — | 1 |
archive_details | ad_archive_id | page_id, country, is_ad_non_political, is_ad_not_aaa_eligible | 1 |
countries | — | — | 1 |
facebook_marketplace
Facebook Marketplace: busca anuncios, vehículos y alquileres; consulta detalles de anuncios y vendedores, categorías y coordenadas de ciudades.
| Acción | Entradas obligatorias | Entradas opcionales | Cré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_cursor | 1 |
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_cursor | 1 |
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_cursor | 1 |
listing | listing_id | — | 1 |
seller | seller_id | — | 1 |
categories | — | — | 1 |
city_coordinates | city | country, exactly_one | 1 |
facebook_media_download
Descarga contenido multimedia de Facebook (imágenes, videos, audio) desde una URL.
| Acción | Entradas obligatorias | Entradas opcionales | Créditos |
|---|---|---|---|
download | url | — | 1 |
instagram_profile
Perfiles de Instagram: detalles, ID de usuario, publicaciones, reels, historias destacadas e historias de las destacadas.
| Acción | Entradas obligatorias | Entradas opcionales | Créditos |
|---|---|---|---|
details | username | link | 1 |
id | — | link, username | 1 |
posts | — | username, user_id, end_cursor | 1 |
reels | user_id | end_cursor | 1 |
highlights | user_id | — | 1 |
highlight_details | highlight_id | — | 1 |
instagram_post
Publicaciones de Instagram: detalles completos de una publicación o el shortcode de la URL de una publicación.
| Acción | Entradas obligatorias | Entradas opcionales | Créditos |
|---|---|---|---|
details | shortcode | — | 1 |
id | link | — | 1 |
instagram_reels
Reels de Instagram: el feed de tendencias o reels que usan una pista de audio determinada.
| Acción | Entradas obligatorias | Entradas opcionales | Créditos |
|---|---|---|---|
feed | — | clips_media_id | 1 |
by_audio | audio_id | max_id | 1 |
instagram_search
Busca en Instagram por palabra clave usuarios populares, hashtags y lugares.
| Acción | Entradas obligatorias | Entradas opcionales | Créditos |
|---|---|---|---|
search | keyword | end_cursor | 1 |
instagram_location
Ubicaciones de Instagram: publicaciones etiquetadas en un lugar y lugares cercanos.
| Acción | Entradas obligatorias | Entradas opcionales | Créditos |
|---|---|---|---|
posts | location_id | tab, end_cursor | 1 |
nearby | location_id | — | 1 |
Ejemplos de indicaciones
"Obtén los detalles de la página de Facebook de Nike y resume sus últimas 10 publicaciones."
"Compara el número de seguidores de Adidas y Nike en Instagram."
"Encuentra anuncios activos en la biblioteca de anuncios de Meta que mencionen 'running shoes' en EE. UU."
Solución de problemas
| Síntoma | Solución |
|---|---|
Missing SocialAPIs API key | Añade el encabezado Authorization: Bearer <key> (alojado) o SOCIALAPIS_API_KEY (npx). |
| HTTP 401 o 403 en un resultado | Vuelve a copiar la clave desde el panel. |
Insufficient credits | Mejora el plan o recarga créditos en socialapis.io/pricing. |
| No aparece ninguna herramienta | Reinicia el cliente después de editar su configuración y comprueba que https://mcp.socialapis.io/health responda (ábrelo en un navegador). |
Dónde encontrarnos
El servidor aparece en el registro oficial de MCP como io.github.SocialAPIsHub/social-media-api, y también en Smithery, Glama, cursor.directory, LobeHub, mcp.so y mcpservers.org. Consulta socialapis.io/integrations para ver los enlaces.
Código fuente: github.com/SocialAPIsHub/mcp-server. Preguntas: support@socialapis.io.