SocialDataX Instagram MCP

Servidor MCP de SocialDataX Instagram para publicaciones públicas, comentarios y respuestas, perfiles y publicaciones de creadores, y transcripciones de voz a texto de videos/Reels.

GitHubPrueba este MCPPatrocinado

Documentación

Instagram MCP

Este repositorio público proporciona documentación de conexión pública y metadatos MCP para un servicio MCP de Instagram alojado por SocialDataX.

Si buscas un MCP de Instagram para flujos de trabajo de investigación en redes sociales, este repositorio incluye:

Metadatos MCP públicos y ejemplos de configuración de clientes
El endpoint alojado streamable-http para clientes que admiten MCP remoto
Un ejemplo de respaldo mcp-remote para clientes MCP que solo admiten comandos/stdio

La implementación del negocio está alojada de forma privada. Este repositorio expone únicamente la superficie de conexión pública para flujos de trabajo de inteligencia de contenido en redes sociales.

Aliases de búsqueda

Frases de búsqueda comunes para este servicio MCP:

Instagram MCP
Instagram 数据 MCP
Instagram data MCP
Instagram 帖子 MCP
Instagram 评论 MCP
Instagram 回复 MCP
Instagram 用户信息 MCP
Instagram 用户帖子 MCP
Instagram Reels transcript MCP
Instagram 口播转文字 MCP
Instagram post MCP
Instagram post research MCP
Instagram comments MCP
Instagram comment replies MCP
Instagram user info MCP
Instagram user posts MCP

Servicio

Endpoint MCP alojado: https://mcp.socialdatax.com/instagram/mcp
Transporte alojado: streamable-http
Autenticación: Authorization: Bearer <SOCIALDATAX_API_KEY>
Producto: SocialDataX / 社媒数据助手
Sitio web y acceso a la clave API: https://socialdatax.com/ai?from=github
Nombre del registro: com.52choujiang/instagram-insights
Nombre futuro del registro: com.socialdatax/instagram-insights
Versión de capacidad pública actual: 0.1.5

MCP de plataforma

Usa el endpoint alojado streamable-http directamente desde clientes que admitan MCP remoto autenticado. Para clientes que solo admiten servidores MCP de comandos/stdio, usa mcp-remote como proxy de compatibilidad local.

Alcance del flujo de trabajo

Este servicio MCP está diseñado para flujos de trabajo de inteligencia de contenido en redes sociales. No proporciona inicio de sesión de cuenta, publicación, edición, me gusta, comentarios, seguimiento, transmisión en vivo ni otras acciones de cuenta.

Los flujos de trabajo admitidos incluyen:

Consultar el saldo de puntos SocialDataX de la cuenta de clave API actual.
Buscar publicaciones públicas de Instagram por palabra clave; continúa con el next_page_token devuelto como page_token.
Leer los detalles de una publicación cuando el llamador ya tiene un post_id.
Resolver una URL de compartir publicación de Instagram en detalles estructurados de la publicación.
Obtener comentarios de primer nivel paginados desde una URL de compartir publicación de Instagram; cuando solo hay un post_id disponible, primero llama a instagram_get_post_detail_by_post_id y reutiliza el share_url devuelto.
Obtener respuestas paginadas bajo un comentario de primer nivel por post_id y comment_id de primer nivel; usa un post_id válido y comment_id de primer nivel proporcionados directamente por el usuario. Si falta un ID y hay una URL de publicación disponible, llama a instagram_get_post_comments_by_post_url, luego reutiliza items[*].post_id y items[*].comment_id del mismo comentario. Si solo hay post_id disponible, primero llama a instagram_get_post_detail_by_post_id para obtener share_url, luego llama a instagram_get_post_comments_by_post_url y reutiliza los IDs del comentario de primer nivel objetivo. Si no hay URL de publicación ni post_id disponible, pide al usuario la URL o el ID de la publicación.
Obtener información pública de usuario de Instagram por username o URL de perfil.
Obtener publicaciones públicas paginadas publicadas por un usuario de Instagram por username o URL de perfil.
Enviar y verificar trabajos de transcripción de voz a texto para publicaciones de video ordinarias y Reels; las publicaciones de fotos y carrusel no son compatibles.

Herramientas

Herramienta	Propósito público
`socialdatax_get_points_balance`	Consultar el saldo de puntos SocialDataX de la cuenta de clave API actual.
`instagram_search_posts`	Buscar publicaciones públicas de Instagram por término de búsqueda. Usa esta herramienta cuando el usuario necesite publicaciones encontradas por un término de búsqueda; cuando ya haya un enlace de publicación disponible, usa la herramienta de detalles o comentarios correspondiente; cuando solo haya un `post_id` disponible, usa la herramienta de detalles por ID, luego usa el `share_url` devuelto para comentarios; cuando haya un enlace de perfil o nombre de usuario disponible, usa la herramienta de información de usuario o publicaciones de usuario correspondiente. Admite continuación con `page_token`.
`instagram_get_post_detail_by_post_id`	Obtener detalles estructurados de la publicación cuando el llamador ya tiene un `post_id`.
`instagram_get_post_detail_by_post_url`	Resolver una URL de compartir publicación de Instagram en detalles estructurados de la publicación.
`instagram_get_post_comments_by_post_url`	Obtener comentarios de primer nivel paginados desde una URL de compartir publicación de Instagram. Cuando solo hay un `post_id` disponible, primero llama a `instagram_get_post_detail_by_post_id` y reutiliza el `share_url` devuelto; pasa `page_token` para continuar la paginación.
`instagram_get_post_comment_replies_by_comment_id`	Obtener respuestas paginadas bajo un comentario de primer nivel por `post_id` y `comment_id` de primer nivel. Usa un `post_id` válido y `comment_id` de primer nivel proporcionados directamente por el usuario. Si falta un ID y hay una URL de publicación disponible, llama a `instagram_get_post_comments_by_post_url`, luego reutiliza `items[].post_id` y `items[].comment_id` del mismo comentario. Si solo hay `post_id` disponible, primero llama a `instagram_get_post_detail_by_post_id` para obtener `share_url`, luego llama a `instagram_get_post_comments_by_post_url` y reutiliza los IDs del comentario de primer nivel objetivo. Si no hay URL de publicación ni `post_id` disponible, pide al usuario la URL o el ID de la publicación; pasa `page_token` para continuar la paginación.
`instagram_get_user_info_by_username`	Obtener información pública de usuario de Instagram por nombre de usuario.
`instagram_get_user_info_by_profile_url`	Obtener información pública de usuario de Instagram por URL de perfil.
`instagram_get_user_posts_by_username`	Obtener publicaciones públicas paginadas publicadas por un usuario de Instagram por nombre de usuario.
`instagram_get_user_posts_by_profile_url`	Obtener publicaciones públicas paginadas publicadas por un usuario de Instagram por URL de perfil.
`instagram_submit_video_speech_text_by_post_url`	Enviar un trabajo de transcripción de voz a texto para una publicación de video de Instagram o URL de Reels. Las publicaciones de fotos y carrusel no son compatibles.
`instagram_submit_video_speech_text_by_post_id`	Enviar un trabajo de transcripción de voz a texto para una publicación de video de Instagram o `post_id` de Reels. Las publicaciones de fotos y carrusel no son compatibles.
`instagram_get_video_speech_text_job`	Verificar el trabajo de transcripción devuelto por una herramienta de envío de Instagram usando el mismo `job_id`.

Inicio rápido

Para clientes que admiten streamable-http autenticado, usa el endpoint alojado directamente:

{
  "mcpServers": {
    "socialdatax-instagram": {
      "type": "streamable_http",
      "url": "https://mcp.socialdatax.com/instagram/mcp",
      "headers": {
        "Authorization": "Bearer <SOCIALDATAX_API_KEY>"
      }
    }
  }
}

Hay una plantilla de configuración disponible en examples/streamable_http_config.json. Reemplaza <SOCIALDATAX_API_KEY> con tu clave API antes de usarla.

Para clientes MCP que solo admiten comandos/stdio, usa mcp-remote:

{
  "mcpServers": {
    "socialdatax-instagram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.socialdatax.com/instagram/mcp",
        "--header",
        "Authorization: Bearer <SOCIALDATAX_API_KEY>"
      ]
    }
  }
}

Claude Code puede usar HTTP remoto directamente:

claude mcp add --transport http socialdatax-instagram https://mcp.socialdatax.com/instagram/mcp --header 'Authorization: Bearer ${SOCIALDATAX_API_KEY}'

Persiste SOCIALDATAX_API_KEY en el entorno de ejecución o en el secreto del cliente antes de reiniciar Claude Code.

Claude Desktop debe usar su interfaz de MCP remoto / Conectores cuando esté disponible. Si un archivo de configuración local en tu versión solo admite servidores de comandos/stdio, usa el respaldo mcp-remote.

Ejemplos de clientes

Hay ejemplos de configuración disponibles en examples:

Clave API

Solicita o gestiona el acceso a la API desde el sitio web del producto:

https://socialdatax.com/ai?from=github

Usa la clave como token Bearer en el encabezado de solicitud Authorization. No comprometas valores reales de claves API en código, documentación, problemas o capturas de pantalla.

Metadatos del directorio

Archivos de metadatos públicos en este repositorio:

server-card.json: metadatos orientados al directorio para el servicio alojado. La publicación oficial del Registro MCP usa el registry/instagram/server.json del repositorio fuente privado para la entrada actual de com.52choujiang/instagram-insights.
mcp.json: configuración genérica de respaldo de comandos/stdio usando mcp-remote.
glama.json: metadatos de propiedad del repositorio de Glama.
SUBMISSION_CHECKLIST.md: lista de verificación para envíos a directorios MCP.

Licencia

Los archivos de este repositorio público se publican bajo la Licencia MIT. La licencia cubre únicamente la documentación pública y los ejemplos de configuración de este repositorio. No cubre la implementación del servicio gestionado, la infraestructura alojada ni ningún código de backend privado fuera de este repositorio.