SocialAPIs — Facebook & Instagram Data

oficial

Datos 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:

HerramientaAcciones
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

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ónEntradas obligatoriasEntradas opcionalesCréditos
detailslinkexact_followers_count1 (5 con exact_followers_count=true)
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 por cada 3 publicaciones devueltas (mín. 1)
videoslink o 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 de Facebook: detalles, ID del grupo, publicaciones, videos y álbumes de fotos.

AcciónEntradas obligatoriasEntradas opcionalesCréditos
detailslink—1
idlink—1
postslinklimit, end_cursor, after_time, before_time, timezone1 por cada 3 publicaciones devueltas (mín. 1)
videoslinkend_cursor1
albumsgroup_id (de id)limit (8-16)1
album_itemsalbum_id (de albums)end_cursor1

facebook_post

Publicaciones, videos y comentarios de Facebook: detalles de publicaciones, archivos adjuntos, comentarios y respuestas.

AcciónEntradas obligatoriasEntradas opcionalesCré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

Busca en Facebook por palabra clave: páginas, personas, publicaciones, videos y ubicaciones.

AcciónEntradas obligatoriasEntradas opcionalesCré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

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ónEntradas obligatoriasEntradas opcionalesCré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: busca anuncios, vehículos y alquileres; consulta detalles de anuncios y vendedores, categorías y coordenadas de ciudades.

AcciónEntradas obligatoriasEntradas opcionalesCré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

Descarga contenido multimedia de Facebook (imágenes, videos, audio) desde una URL.

AcciónEntradas obligatoriasEntradas opcionalesCréditos
downloadurl—1

instagram_profile

Perfiles de Instagram: detalles, ID de usuario, publicaciones, reels, historias destacadas e historias de las destacadas.

AcciónEntradas obligatoriasEntradas opcionalesCréditos
detailsusernamelink1
id—link, username1
posts—username, user_id, end_cursor1
reelsuser_idend_cursor1
highlightsuser_id—1
highlight_detailshighlight_id—1

instagram_post

Publicaciones de Instagram: detalles completos de una publicación o el shortcode de la URL de una publicación.

AcciónEntradas obligatoriasEntradas opcionalesCréditos
detailsshortcode—1
idlink—1

instagram_reels

Reels de Instagram: el feed de tendencias o reels que usan una pista de audio determinada.

AcciónEntradas obligatoriasEntradas opcionalesCréditos
feed—clips_media_id1
by_audioaudio_idmax_id1

instagram_search

Busca en Instagram por palabra clave usuarios populares, hashtags y lugares.

AcciónEntradas obligatoriasEntradas opcionalesCréditos
searchkeywordend_cursor1

instagram_location

Ubicaciones de Instagram: publicaciones etiquetadas en un lugar y lugares cercanos.

AcciónEntradas obligatoriasEntradas opcionalesCréditos
postslocation_idtab, end_cursor1
nearbylocation_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íntomaSolución
Missing SocialAPIs API keyAñade el encabezado Authorization: Bearer <key> (alojado) o SOCIALAPIS_API_KEY (npx).
HTTP 401 o 403 en un resultadoVuelve a copiar la clave desde el panel.
Insufficient creditsMejora el plan o recarga créditos en socialapis.io/pricing.
No aparece ninguna herramientaReinicia 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.