Social Fetch

MCP hospedado para datos públicos de redes sociales (TikTok, Instagram, Reddit, X, YouTube y más) como JSON estructurado.

GitHub

Documentación

Social Fetch MCP

Deja que tu agente de codificación obtenga datos reales de redes sociales y web mientras construye.

Documentación | Referencia de API | Créditos y facturación

URL del servidor: https://api.socialfetch.dev/mcp

¿Qué es esto?

Social Fetch MCP conecta Cursor, VS Code, Claude, Windsurf y otros clientes MCP a la API de Social Fetch. Una vez instalado, tu agente puede buscar creadores, obtener publicaciones, buscar en plataformas, leer páginas web, consultar tu saldo y leer la documentación de Social Fetch desde tu editor.

Úsalo cuando quieras que tu agente responda preguntas como:

"Encuentra a este creador de TikTok y añade sus últimos videos a mi aplicación."
"Extrae la transcripción de este video de YouTube y resume los patrocinios."
"Obtén esta publicación de Instagram, inspecciona la forma de la respuesta y conéctala a mi backend."
"Lee la documentación de Social Fetch y elige el endpoint correcto para la búsqueda en Reddit."

El propio servidor MCP está alojado por Social Fetch:

https://api.socialfetch.dev/mcp

No hay servidor local que clonar, compilar o ejecutar desde este repositorio. Los clientes se conectan al endpoint HTTP Streamable alojado y se autentican con OAuth en el navegador.

¿Por qué usarlo?

Los agentes funcionan mejor cuando pueden trabajar con la misma API que usa tu aplicación. Esto les proporciona una ruta directa y autenticada a Social Fetch, en lugar de hacerte saltar entre documentación, paneles, scripts y JSON pegado.

Menos configuración: llama a las herramientas de Social Fetch directamente desde tu agente.
Mejores respuestas: el agente puede buscar y leer la documentación en vivo antes de elegir un endpoint.
Datos reales en el bucle: prueba con TikTok, Instagram, YouTube, X/Twitter, Reddit, Spotify, web y más desde tu editor.
Sin claves de API en la configuración del editor: inicia sesión una vez con OAuth.
La misma API en todas partes: las herramientas MCP se asignan a la API REST pública, el SDK y la documentación.

Qué puedes obtener

Social Fetch MCP expone herramientas de endpoints para:

Datos de TikTok, Instagram, YouTube, X/Twitter, Telegram, Facebook, Threads, LinkedIn, Reddit y Spotify.
Perfiles, publicaciones, videos, comentarios, transcripciones, resultados de búsqueda y metadatos específicos de la plataforma.
Generación de markdown web y preguntas sobre páginas web asistidas por IA.
Identidad de cuenta y saldo de créditos.
Documentación de Social Fetch a través de docs_search y docs_read.

Las herramientas de endpoints se miden como la API REST. Las herramientas de documentación, auth_whoami y billing_balance_get no consumen créditos de consulta.

Requisitos

Una cuenta de Social Fetch.
Créditos para rutas de API medidas.
Un cliente MCP con soporte remoto para Streamable HTTP y OAuth, como Cursor, VS Code, Claude Code, Claude Desktop o MCP Inspector.

Instalación con un clic

Completa el flujo del navegador OAuth después de instalar. Si un enlace de un clic no hace nada (tu editor no está instalado, bloquea esquemas de URL personalizados o no tiene un controlador), usa la configuración manual a continuación.

Configuración manual

Cursor

Añade esto a ~/.cursor/mcp.json o a un proyecto .cursor/mcp.json:

{
  "mcpServers": {
    "socialfetch": {
      "url": "https://api.socialfetch.dev/mcp"
    }
  }
}

Reinicia Cursor, abre la configuración de MCP y completa el flujo del navegador OAuth cuando se te solicite.

VS Code

Añade esto a settings.json:

{
  "mcp": {
    "servers": {
      "socialfetch": {
        "url": "https://api.socialfetch.dev/mcp"
      }
    }
  }
}

Claude Code

claude mcp add --transport http socialfetch https://api.socialfetch.dev/mcp

Luego ejecuta /mcp y autentica Social Fetch para completar el flujo OAuth.

Claude Desktop

Añade un conector MCP remoto personalizado con esta URL:

https://api.socialfetch.dev/mcp

Autoriza Social Fetch cuando Claude te lo solicite.

Clientes solo stdio

Si tu cliente solo admite servidores MCP stdio, conecta con el servidor alojado mediante mcp-remote:

npx mcp-remote https://api.socialfetch.dev/mcp

Apunta tu cliente al proceso stdio que inicia ese comando.

Autenticación

Social Fetch MCP usa OAuth 2.1. Tu cliente MCP maneja el flujo:

El cliente abre el inicio de sesión de Social Fetch en tu navegador.
Inicias sesión o creas una cuenta y apruebas el acceso.
El cliente recibe un token de acceso y lo envía con cada solicitud MCP.

No pegues una clave de API de Social Fetch en la configuración de MCP. Los créditos se cargan a la cuenta con sesión iniciada, igual que en las solicitudes a la API REST.

Herramientas

tools/list expone herramientas de endpoints y de documentación.

Los nombres de las herramientas de endpoints coinciden con los ID de operación de la API con puntos reemplazados por guiones bajos:

Nombre de herramienta	Operación de API
`tiktok_profile_get`	`tiktok.profile.get`
`instagram_post_get`	`instagram.post.get`
`web_markdown_generate`	`web.markdown.generate`
`auth_whoami`	`auth.whoami`
`billing_balance_get`	`billing.balance.get`

Los argumentos de cada herramienta de endpoint reflejan los parámetros de la ruta de API correspondiente. Consulta la referencia de API para ver el catálogo completo de endpoints, esquemas de argumentos, formas de respuesta y precios.

También hay disponibles dos herramientas de documentación:

Nombre de herramienta	Propósito
`docs_search`	Buscar en la documentación de Social Fetch entre API, SDK, autenticación, errores, créditos e integraciones.
`docs_read`	Leer una página completa de documentación como markdown por nombre de ruta, como `/docs/sdk`.

Indicación recomendada para el agente:

Usa la documentación de MCP de Social Fetch para añadir la búsqueda de perfil de TikTok a esta aplicación con el SDK de TypeScript.

Ejemplo: Perfil de TikTok

En Cursor, MCP Inspector u otro cliente MCP, llama a tiktok_profile_get con:

{ "handle": "nike" }

El resultado contiene el mismo envoltorio data y meta que devuelve la API REST. Comprueba meta.creditsCharged y meta.requestId después de llamadas medidas.

Solución de problemas

Síntoma	Qué comprobar
`401` en cada llamada	Vuelve a conectar el servidor y completa OAuth de nuevo. Tu token puede faltar o haber expirado.
Bucle de redirección de OAuth	Termina de iniciar sesión en Social Fetch y luego aprueba el acceso para volver a tu cliente.
Respuestas `402`	Tu cuenta no tiene créditos para la ruta medida. Recarga en Créditos y facturación.
No se listan herramientas	Vuelve a conectar el servidor. Si persiste, reinicia tu cliente MCP.
El cliente solo admite stdio	Usa `npx mcp-remote https://api.socialfetch.dev/mcp`.

Contenido del repositorio

server.json - Metadatos del registro MCP para el servidor remoto alojado.
examples/ - Fragmentos de configuración de cliente MCP para copiar y pegar.
assets/socialfetch-mark.svg - Copia local de la marca de Social Fetch (también servida en https://api.socialfetch.dev/mcp/icon.svg).

La implementación vive en el servicio de API privado de Social Fetch, no en este repositorio de listado público.

Relacionados

Licencia

MIT (c) Social Freak Ltd