Social APIS Hub

La API unificada para datos de redes sociales, diseñada para desarrolladores y agentes de IA.

GitHub

Prueba este MCPPatrocinado

Documentación

SocialAPIs MCP Server

API unificada de redes sociales para agentes de IA

Website • Documentación • Discord • npm

SDK oficiales: Python • JavaScript / TypeScript • Go

🚀 Inicio rápido

Instalación

npm install -g @socialapis/mcp

Configuración

Añade a tu configuración de Claude Desktop:

macOS:

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

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

🔧 Configuración

Método 1: Argumento de línea de comandos (recomendado para Claude Desktop)

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

Método 2: Variable de entorno

# Set environment variable
export SOCIALAPIS_API_KEY=your_api_key_here

# Run without argument
npx @socialapis/mcp

Método 3: Archivo .env (para desarrollo)

# Copy example file
cp .env.example .env

# Edit with your values
nano .env

Archivo .env:

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

Variables de entorno

Variable	Descripción	Predeterminado
`SOCIALAPIS_API_KEY`	Tu clave de API de SocialAPIs	Ninguna (obligatoria)
`MCP_PROXY_URL`	URL del servidor proxy MCP	`https://mcp.socialapis.io`
`PORT`	Puerto del servidor HTTP	`3001`
`API_BASE_URL`	URL de la API de backend	`https://api.socialapis.io`

Obtener clave de API

Regístrate en socialapis.io
Ve a Dashboard
Copia tu clave de API
Reemplaza YOUR_API_KEY en la configuración

Pruébalo

Reinicia Claude Desktop y pregunta:

Get Nike's Facebook page details

📋 Características

🌐 API unificada: una interfaz para múltiples plataformas
🤖 Pensada para IA: creada para Claude, Cursor y agentes de IA
📊 Datos enriquecidos: publicaciones, comentarios, métricas de interacción
🔍 Filtrado avanzado: rangos de tiempo, paginación
🎯 Autenticación sencilla: sin la complejidad de OAuth
⚡ Rápido: red perimetral global
🔒 Seguro: las claves de API permanecen locales

🛠️ Herramientas disponibles

47 herramientas para Facebook e Instagram. Cada herramienta se corresponde 1:1 con un endpoint REST en api.socialapis.io: las notas de precios en la descripción de cada herramienta indican el coste de créditos por llamada.

Facebook — Páginas

facebook_get_page_id — Extrae el ID de página de una URL
facebook_get_page_details — Información de la página, seguidores, me gusta, categoría. Establece exact_followers_count=true para el entero exacto (cobra 5 créditos en lugar de 1)
facebook_get_page_posts — Obtén publicaciones con after_time / before_time para filtrar por fecha. limit 3-9, los cargos escalan por ceil(returned / 3)
facebook_get_page_videos — Vídeos de la página, limit 6-12
facebook_get_page_reels — Reels / vídeos cortos

Facebook — Grupos

facebook_get_group_id — Extrae el ID de grupo de una URL
facebook_get_group_details — Detalles completos (miembros, descripción, reglas)
facebook_get_group_posts — Publicaciones del grupo, mismo limit + filtrado por fecha que las publicaciones de página
facebook_get_group_videos — Vídeos del grupo con paginación

Facebook — Publicaciones

facebook_get_post_id — Extrae el ID de publicación de una URL
facebook_get_post_details — Reacciones, número de comentarios, compartidos, medios
facebook_get_post_details_extended — Campos ampliados: recuentos de visualizaciones (esencial para reels / publicaciones de vídeo), URLs de vídeo, metadatos de música/audio, verificación del autor
facebook_get_post_attachments — Adjuntos multimedia completos (5 créditos por llamada)
facebook_get_video_details — Metadatos de publicaciones de vídeo + estadísticas
facebook_get_post_comments — Comentarios de nivel superior, limit hasta 30
facebook_get_comment_replies — Respuestas a un comentario específico

Facebook — Búsqueda

facebook_search_pages — Busca páginas por palabra clave + filtro de ubicación opcional
facebook_search_people — Busca perfiles públicos por palabra clave
facebook_search_locations — Consulta UIDs de ubicación de Facebook (para usar en otros endpoints)
facebook_search_posts — Busca publicaciones por palabra clave, actualidad, ubicación
facebook_search_videos — Busca vídeos de Facebook Watch

Facebook — Biblioteca de anuncios (transparencia de anuncios de Meta)

facebook_ads_search — Busca anuncios por palabra clave, país, estado
facebook_ads_page_details — Todos los anuncios de una página específica
facebook_ads_archive_details — Detalles completos del archivo de anuncios
facebook_ads_keywords — Busca anuncios por palabra clave
facebook_ads_countries — Lista de códigos de país admitidos

Facebook — Marketplace

facebook_marketplace_search — Búsqueda de artículos con filtros de ubicación, precio, categoría, estado
facebook_marketplace_listing — Detalles de un anuncio individual
facebook_marketplace_seller — Perfil del vendedor + sus anuncios
facebook_marketplace_categories — Explora la jerarquía de categorías
facebook_marketplace_city_coordinates — Lat/long de una ciudad (para búsqueda por radio)
facebook_marketplace_vehicles — Búsqueda de anuncios específicos de vehículos
facebook_marketplace_rentals — Anuncios de propiedades en alquiler

Facebook — Medios

facebook_download_media — URL de descarga directa para medios de FB (imágenes, vídeos)

Instagram — Perfil

instagram_get_user_id — Resuelve nombre de usuario → ID numérico
instagram_get_profile_details — Información del perfil, número de seguidores, biografía, número de publicaciones
instagram_get_profile_posts — Publicaciones recientes de un perfil
instagram_get_profile_reels — Reels de un perfil
instagram_get_profile_highlights — Lista de destacados de historias
instagram_get_highlight_details — Contenido completo de un destacado específico

Instagram — Publicaciones + Reels

instagram_get_post_id — Resuelve URL de publicación → ID
instagram_get_post_details — Me gusta, comentarios, medios, pie de foto
instagram_get_reels_feed — Feed de reels de un perfil
instagram_get_reels_by_audio — Reels que usan un ID de audio/música específico

Instagram — Descubrimiento

instagram_popular_search — Consultas / sugerencias en tendencia
instagram_get_location_posts — Publicaciones etiquetadas en una ubicación específica
instagram_get_nearby_locations — IDs de ubicaciones cercanas (para usar en publicaciones por ubicación)

Próximamente

TikTok (vídeos, perfiles, hashtags)
X / Twitter (tweets, perfiles, búsqueda)
LinkedIn (páginas de empresa, publicaciones, empleados)
YouTube (vídeos, canales, comentarios)

Sigue la hoja de ruta de la plataforma en socialapis.io/api-sources.

💡 Ejemplos de uso

Cada prompt a continuación es una sesión real de Claude Desktop. Algunos son patrones de una sola llamada a herramienta («dame X»); otros requieren que Claude encadene varias llamadas + agregue los resultados (indicado donde corresponde).

Patrones de una sola llamada (rápidos y económicos)

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)

Patrones de múltiples llamadas (Claude los orquesta — pero es más lento y más 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).

Lo que este servidor MCP NO hace

Algunas consultas parecen naturales en un chat («compara la interacción del último mes») pero requieren agregaciones que la API aún no expone como una sola herramienta. Claude puede responderlas igualmente, pero se ramificará en muchas llamadas a herramientas, lo que es lento y caro.

Forma de la consulta	Por qué es difícil
«Tasa de interacción de los últimos 30 días» de una página	Requiere obtener todas las publicaciones del rango de fechas (paginadas, `limit` limitado a 9 por llamada) y calcular la interacción de cada publicación. Agota el presupuesto de llamadas a herramientas del LLM en páginas con mucho tráfico.
«Comparar tasas de interacción entre las marcas A, B y C durante el último mes»	El mismo problema, ×3: una obtención paginada por marca y luego el cálculo de comparación. Funciona para ventanas pequeñas; es lento para «el último mes» en páginas de alto volumen.
Archivo histórico anterior a lo que el propio Facebook sirve	Mostramos lo que Facebook hace visible públicamente. Las publicaciones que han salido del feed visible de Facebook no se pueden recuperar.
Series temporales del lado del servidor (interacción diaria, crecimiento semanal)	Aún no: está en la hoja de ruta como un futuro endpoint `engagement-stats` con agregación integrada.

Si tu caso de uso encaja en uno de estos patrones y quieres la agregación precalculada en lugar de orquestada por el LLM, contacta con soporte con la consulta específica: estamos priorizando el endpoint de agregación según la demanda de los clientes.

🏗️ Arquitectura

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

¿Por qué esta arquitectura?

✅ Baja latencia (red perimetral global)
✅ Alta fiabilidad (99,9 % de disponibilidad)
✅ Límite de velocidad automático
✅ Caché inteligente
✅ Tu clave de API permanece local

🔧 Desarrollo

Configuración 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

Estructura del proyecto

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

Pruebas

# 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"}}'

📊 Precios

Plan	Solicitudes/mes	Precio
Free	200	$0
Starter	30,000	$49
Pro	120,000	$179
Enterprise	Ilimitado	Personalizado

Ver precios detallados →

🤝 Contribuciones

¡Agradecemos las contribuciones! Consulta CONTRIBUTING.md para más detalles.

Guía rápida de contribución

Haz un fork del repositorio
Crea una rama de funcionalidad (git checkout -b feature/amazing-feature)
Haz commit de tus cambios (git commit -m 'Add amazing feature')
Sube los cambios a la rama (git push origin feature/amazing-feature)
Abre un Pull Request

📖 Documentación

💬 Soporte

📧 Correo electrónico: support@socialapis.io
💬 Discord: discord.gg/D5bQskrwV
🐛 Problemas: GitHub Issues
📚 Documentación: docs.socialapis.io

🗺️ Hoja de ruta

Publicado:

Soporte de la API de Facebook: 31 herramientas (páginas, grupos, publicaciones, búsqueda, biblioteca de anuncios, marketplace, medios)
Soporte de Instagram: 16 herramientas (perfiles, publicaciones, reels, destacados, descubrimiento / ubicaciones)
Implementación del servidor MCP
Servidor proxy HTTP
Paquete npm publicado: @socialapis/mcp
Listado en el registro MCP: registry.modelcontextprotocol.io
Python SDK: socialapis-sdk en PyPI (51 endpoints, MIT)
JavaScript / TypeScript SDK: socialapis-sdk en npm (Node 18+, Bun, Deno, navegadores)
Go SDK: github.com/SocialAPIsHub/socialapis-go (idiomático, cero dependencias)

Próximamente:

Soporte de TikTok
Soporte de X (Twitter)
Soporte de LinkedIn
Soporte de YouTube
Analítica avanzada: endpoints de agregación del lado del servidor (interacción a lo largo del tiempo, comparaciones de marcas) para que los patrones de múltiples llamadas se conviertan en una sola llamada a herramienta
Webhooks en tiempo real: notificaciones push de nuevas publicaciones / umbrales de interacción
Integración con LangChain

Las prioridades de la plataforma cambian según la demanda de los clientes. La forma más rápida de adelantar algo en la cola es enviar un correo a support@socialapis.io o un mensaje directo a @socialapis en Telegram con el caso de uso.

📄 Licencia

Este proyecto está bajo la Licencia MIT: consulta el archivo LICENSE para más detalles.

🙏 Agradecimientos

Construido con Model Context Protocol
Impulsado por Anthropic Claude
Inspirado por la comunidad de agentes de IA

🌟 Historial de estrellas

Hecho con ❤️ por el equipo de SocialAPIs

Website • Twitter • Discord

Python SDK • JS SDK • Go SDK