FastSocial Instagram Data

npx add-mcp 'https://data.fastsocial.co/mcp'

Servidor MCP de Datos de Instagram

Conecta tu asistente de IA a la API de Datos de Instagram de FastSocial, y podrá consultar perfiles públicos de Instagram, publicaciones, reels, historias, destacados, comentarios, hashtags, lugares y audio. Solo lectura: nunca publica, sigue, da me gusta ni envía mensajes.

El servidor es remoto. No hay nada que instalar o ejecutar: tu asistente se comunica con

https://data.fastsocial.co/mcp

a través de Streamable HTTP. La primera vez que se conecta, se abre una página de fastsocial.co en tu navegador donde inicias sesión y haces clic en Permitir.

Este repositorio contiene los manifiestos del plugin (plugin.json, mcp.json y la copia que Cursor lee en .cursor-plugin/), el server.json que lista el servidor en el Registro oficial de MCP como io.github.FastSocialCo/instagram-data-mcp, y un manifiesto de LobeHub. No contiene código que se ejecute en tu máquina. El código del servidor no está aquí.

Instalación

Cursor

Instala el plugin desde cursor.directory, o añade el servidor a .cursor/mcp.json (un proyecto) o ~/.cursor/mcp.json (todos los proyectos):

{
  "mcpServers": {
    "instagram-data": {
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

Abre Configuración, luego MCP, y conéctate. Cursor abre la página de inicio de sesión de FastSocial.

Claude Code

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp

Luego ejecuta /mcp dentro de Claude Code, elige instagram-data e inicia sesión.

Aplicación Claude (web y escritorio)

1. Abre Configuración, luego Conectores, y añade un conector personalizado.
2. Pega https://data.fastsocial.co/mcp como URL del servidor.
3. Deja el ID de cliente OAuth y el secreto vacíos.
4. Conéctate e inicia sesión en la página de FastSocial que se abre.

VS Code y otros clientes

Cualquier cliente que hable MCP sobre Streamable HTTP puede conectarse con la URL del servidor. En VS Code, añade esto a .vscode/mcp.json y pulsa Iniciar:

{
  "servers": {
    "instagram-data": {
      "type": "http",
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

Qué hace este plugin y qué datos envía

El plugin en sí

El plugin son dos archivos JSON que le indican a tu cliente la dirección del servidor. No ejecuta código, no tiene scripts de instalación y no almacena nada. Tu cliente hace cada solicitud por sí mismo, directamente a https://data.fastsocial.co/mcp a través de HTTPS.

Lo que envía tu cliente

• El protocolo de enlace MCP: el nombre y la versión de tu cliente, y la versión del protocolo que habla.
• Cada llamada a herramienta: el nombre de la herramienta y sus argumentos, que son las cosas sobre las que preguntaste: un nombre de usuario o ID de usuario de Instagram, un enlace de publicación o reel, un hashtag, palabras de búsqueda, una ubicación, ID de audio o destacado, y un cursor de paginación. La lista completa está en la tabla siguiente.
• Tu token de inicio de sesión o clave API, en un encabezado de solicitud. Nunca en la URL.
• Los detalles habituales de cualquier solicitud web, como tu dirección IP y el agente de usuario de tu cliente.

No se envía nada más. El servidor nunca ve tus archivos, tu editor o tu conversación, solo los argumentos que tu asistente pone en una llamada a herramienta.

Lo que devuelve

Datos públicos de Instagram como JSON, más meta.credits_remaining. Las fotos y videos se devuelven como enlaces, no como archivos. Las cuentas privadas devuelven un error private_account. Los propietarios de cuentas de Instagram pueden optar por no participar; después de eso, la API devuelve 451 opted_out para su cuenta.

Solo lectura

Cada herramienta lee. Ninguna cambia nada en Instagram. Lo único que cambia una llamada es tu propio saldo de créditos del mes. El servidor marca cada herramienta como readOnlyHint: true y openWorldHint: true en tools/list. No hay herramientas que escriban o eliminen.

Inicio de sesión

La primera vez que tu cliente se conecta, el servidor responde que necesita inicio de sesión y dice dónde encontrar información al respecto. Tu cliente entonces abre una página en fastsocial.co en tu navegador. Allí:

1. introduces tu correo electrónico y el código que FastSocial te envía por correo,
2. ves qué aplicación está solicitando, y haces clic en Permitir (o Denegar).

Si aún no tienes un plan, se crea un plan Gratuito para ti cuando haces clic en Permitir. Nunca escribes una contraseña en tu asistente, y el plugin nunca ve ni almacena tus credenciales. Tu cliente conserva los tokens que recibe. Un token de acceso dura una hora, y tu cliente lo renueva con un token de actualización que dura 30 días y cambia cada vez que se usa.

Para cortar el acceso a todas las aplicaciones que has conectado, inicia sesión en https://fastsocial.co/cart/api/account y pulsa Nueva clave. Los inicios de sesión vinculados a la clave antigua dejan de funcionar de inmediato.

Para desarrolladores de clientes: el descubrimiento comienza en https://data.fastsocial.co/.well-known/oauth-protected-resource/mcp. El servidor de autorización admite OAuth 2.1 con PKCE (solo S256), registro dinámico de clientes y revocación de tokens, para clientes públicos.

Uso de una clave API en su lugar

Si tu cliente puede establecer un encabezado pero no puede iniciar sesión, obtén una clave en https://fastsocial.co/instagram-api?ref=github y envíala en cada solicitud como X-API-Key: YOUR_KEY (o Authorization: Bearer YOUR_KEY). Para Claude Code:

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp --header "X-API-Key: YOUR_KEY"

Mantén la clave fuera de los archivos que confirmes.

Políticas

• Política de privacidad: https://fastsocial.co/privacy
• Términos: https://fastsocial.co/terms
• Política de uso de los datos (solo datos públicos, sin rastrear ni acosar a personas, nada sobre menores): https://fastsocial.co/instagram-api/docs?ref=github
• Informar de un problema de seguridad: SECURITY.md

Las 28 herramientas

Cada llamada cuesta créditos de tu asignación mensual. Las llamadas fallidas no cuestan nada. Cada herramienta es de solo lectura.

Herramienta	Qué hace	Argumentos	Créditos
instagram_profile	Obtener un perfil de Instagram	username o user_id	1
instagram_user_id	Nombre de usuario de Instagram a ID de usuario	username o user_id	1
instagram_username	ID de usuario de Instagram a nombre de usuario	user_id	2
instagram_check	Comprobar si un identificador de Instagram existe y es público	username	1
instagram_posts	Obtener publicaciones recientes de Instagram	username o user_id, cursor	1
instagram_reels	Obtener los reels de Instagram de una cuenta	username o user_id, cursor	1
instagram_tagged	Obtener publicaciones en las que una cuenta está etiquetada	username o user_id, cursor	1
instagram_post	Obtener una publicación o reel de Instagram	url o shortcode	1
instagram_media	URLs de descarga para una publicación, reel o carrusel	url o shortcode	1
instagram_comments	Obtener comentarios en una publicación de Instagram	url o shortcode	3
instagram_comment_replies	Obtener respuestas a un comentario de Instagram	url o shortcode, comment_id, cursor	3
instagram_likers	Obtener cuentas que dieron me gusta a una publicación de Instagram	url o shortcode	3
instagram_insights	Calculadora de tasa de interacción de Instagram	username o user_id	2
instagram_followers	Obtener los seguidores de una cuenta	username o user_id, cursor	3
instagram_following	Obtener cuentas que una cuenta sigue	username o user_id, cursor	3
instagram_similar	Encontrar cuentas similares de Instagram	username o user_id	1
instagram_stories	Ver historias de Instagram de forma anónima	username o user_id	3
instagram_highlights	Obtener destacados de historias de Instagram	username o user_id	3
instagram_highlight	Obtener los elementos de un destacado	id	3
instagram_search	Buscar cuentas, hashtags y lugares de Instagram	q	1
instagram_hashtag	Obtener publicaciones para un hashtag de Instagram	tag, cursor	1
instagram_place	Obtener una ubicación de Instagram	id	3
instagram_place_posts	Obtener publicaciones etiquetadas en una ubicación de Instagram	id, cursor	1
instagram_audio	Obtener una pista de audio de Instagram y los reels que la usan	id	1
instagram_audio_search	Buscar música y sonidos de Instagram	q	3
instagram_reels_search	Buscar reels de Instagram por palabra clave	q, cursor	3
instagram_top_accounts	Ranking diario de las 2,000 cuentas más seguidas	sort, limit	0
instagram_usage	Tus créditos usados y restantes este mes	ninguno	0

Referencia completa: https://fastsocial.co/instagram-api/docs?ref=github

Cosas para preguntarle

• "Compara la tasa de interacción de @nasa y @spacex."
• "Descarga cada diapositiva de este carrusel: https://www.instagram.com/p/..."
• "Muéstrame las historias actuales de @natgeo y resúmelas."
• "Encuentra 10 cuentas similares a @humansofny."

Versión local

Si tu cliente solo ejecuta servidores locales (stdio), las mismas herramientas están en PyPI como instagram-data-mcp. No forma parte de este plugin. Su código fuente está en FastSocialCo/instagram-data-mcp-python.

Enlaces

• API de Datos de Instagram: https://fastsocial.co/instagram-api?ref=github
• Documentación: https://fastsocial.co/instagram-api/docs?ref=github
• Especificación OpenAPI: https://fastsocial.co/instagram-api/openapi.json
• Entrada del Registro MCP: io.github.FastSocialCo/instagram-data-mcp

Licencia

MIT. Ver LICENSE.