SocialDataX Instagram MCP

Servidor MCP do SocialDataX Instagram para posts públicos, comentários e respostas, perfis e posts de criadores, e transcrições de fala para texto de vídeos/Reels.

GitHub

Documentação

Instagram MCP

Este repositório público fornece documentação pública de conexão e metadados MCP para um serviço MCP de Instagram hospedado pela SocialDataX.

Se você está procurando um MCP de Instagram para fluxos de trabalho de pesquisa em mídias sociais, este repositório inclui:

metadados MCP públicos e exemplos de configuração de cliente
o endpoint streamable-http hospedado para clientes que suportam MCP remoto
um exemplo de fallback mcp-remote para clientes MCP somente command/stdio

A implementação do negócio é hospedada de forma privada. Este repositório expõe apenas a superfície pública de conexão para fluxos de trabalho de inteligência de conteúdo em mídias sociais.

Aliases de Busca

Frases de busca comuns para este serviço 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

Serviço

Endpoint MCP hospedado: https://mcp.socialdatax.com/instagram/mcp
Transporte hospedado: streamable-http
Autenticação: Authorization: Bearer <SOCIALDATAX_API_KEY>
Produto: SocialDataX / 社媒数据助手
Site e acesso à API Key: https://socialdatax.com/ai?from=github
Nome no registro: com.52choujiang/instagram-insights
Nome futuro no registro: com.socialdatax/instagram-insights
Versão atual da capacidade pública: 0.1.7 (15 ferramentas), incluindo busca de tags na primeira página; descoberta autenticada de ferramentas e uma chamada de busca de tags foram verificadas em 11/10/2026.
Registro oficial: 0.1.7, publicado em 11/10/2026.

MCP da Plataforma

Use o endpoint streamable-http hospedado diretamente a partir de clientes que suportam MCP remoto autenticado. Para clientes que suportam apenas servidores MCP command/stdio, use mcp-remote como um proxy de compatibilidade local.

Escopo do Fluxo de Trabalho

Este serviço MCP é projetado para fluxos de trabalho de inteligência de conteúdo em mídias sociais. Ele não fornece login de conta, publicação, edição, curtidas, comentários, seguir, transmissão ao vivo ou outras ações de conta.

Os fluxos de trabalho suportados incluem:

Consultar o saldo de pontos SocialDataX da conta da API Key atual / 积分余额、剩余积分或点数.
Buscar usuários do Instagram por palavra-chave; use os nomes de usuário ou URLs de perfil retornados para detalhes de usuário e postagens.
Buscar postagens públicas do Instagram por palavra-chave; continue com o next_page_token retornado como page_token.
Ler detalhes da postagem quando o chamador já possui um post_id.
Resolver uma URL de compartilhamento de postagem do Instagram em detalhes estruturados da postagem.
Buscar comentários de primeiro nível paginados a partir de uma URL de compartilhamento de postagem do Instagram; quando apenas um post_id estiver disponível, primeiro chame instagram_get_post_detail_by_post_id e reutilize o share_url retornado.
Buscar respostas paginadas sob um comentário de primeiro nível por post_id e comment_id de primeiro nível; use um post_id válido e o comment_id de primeiro nível fornecidos diretamente pelo usuário. Se um ID estiver ausente e uma URL de postagem estiver disponível, chame instagram_get_post_comments_by_post_url, depois reutilize items[*].post_id e items[*].comment_id do mesmo comentário. Se apenas post_id estiver disponível, primeiro chame instagram_get_post_detail_by_post_id para obter share_url, depois chame instagram_get_post_comments_by_post_url e reutilize os IDs do comentário de primeiro nível alvo. Se nem uma URL de postagem nem post_id estiverem disponíveis, peça ao usuário a URL ou o ID da postagem.
Buscar informações públicas de usuário do Instagram por username ou URL de perfil.
Buscar postagens públicas paginadas publicadas por um usuário do Instagram por username ou URL de perfil.
Enviar e verificar trabalhos de transcrição de fala para texto para postagens de vídeo comuns e Reels; postagens de foto e carrossel não são suportadas.

Ferramentas

Ferramenta	Propósito público
`socialdatax_get_points_balance`	Consultar o saldo de pontos SocialDataX da conta da API Key atual / 积分余额、剩余积分或点数.
`instagram_search_users`	Buscar contas por palavra-chave; continue com `next_page_token`. Use o nome de usuário ou URL de perfil retornado para detalhes de usuário e postagens. Um nome desconhecido é uma string vazia; um avatar, status de verificação ou status de conta privada desconhecido é null.
`instagram_search_tags`	Buscar nomes de tags e contagens de postagens por palavra-chave. Apenas primeira página; não retorna postagens sob uma tag nem suporta paginação. Disponível na capacidade pública `0.1.7`.
`instagram_search_posts`	Buscar postagens públicas do Instagram por termo de busca. Use esta ferramenta quando o usuário precisar de postagens encontradas por um termo de busca; quando um link de postagem já estiver disponível, use a ferramenta de detalhes ou comentários correspondente; quando apenas um `post_id` estiver disponível, use a ferramenta de detalhes por ID, depois use o `share_url` retornado para comentários; quando um link de perfil ou nome de usuário estiver disponível, use a ferramenta de informações de usuário ou postagens de usuário correspondente. Suporta continuação por `page_token`.
`instagram_get_post_detail_by_post_id`	Buscar detalhes estruturados da postagem quando o chamador já possui um `post_id`.
`instagram_get_post_detail_by_post_url`	Resolver uma URL de compartilhamento de postagem do Instagram em detalhes estruturados da postagem.
`instagram_get_post_comments_by_post_url`	Buscar comentários de primeiro nível paginados a partir de uma URL de compartilhamento de postagem do Instagram. Quando apenas um `post_id` estiver disponível, primeiro chame `instagram_get_post_detail_by_post_id` e reutilize o `share_url` retornado; passe `page_token` para continuar a paginação.
`instagram_get_post_comment_replies_by_comment_id`	Buscar respostas paginadas sob um comentário de primeiro nível por `post_id` e `comment_id` de primeiro nível. Use um `post_id` válido e o `comment_id` de primeiro nível fornecidos diretamente pelo usuário. Se um ID estiver ausente e uma URL de postagem estiver disponível, chame `instagram_get_post_comments_by_post_url`, depois reutilize `items[].post_id` e `items[].comment_id` do mesmo comentário. Se apenas `post_id` estiver disponível, primeiro chame `instagram_get_post_detail_by_post_id` para obter `share_url`, depois chame `instagram_get_post_comments_by_post_url` e reutilize os IDs do comentário de primeiro nível alvo. Se nem uma URL de postagem nem `post_id` estiverem disponíveis, peça ao usuário a URL ou o ID da postagem; passe `page_token` para continuar a paginação.
`instagram_get_user_info_by_username`	Buscar informações públicas de usuário do Instagram por nome de usuário.
`instagram_get_user_info_by_profile_url`	Buscar informações públicas de usuário do Instagram por URL de perfil.
`instagram_get_user_posts_by_username`	Buscar postagens públicas paginadas publicadas por um usuário do Instagram por nome de usuário.
`instagram_get_user_posts_by_profile_url`	Buscar postagens públicas paginadas publicadas por um usuário do Instagram por URL de perfil.
`instagram_submit_video_speech_text_by_post_url`	Enviar um trabalho de transcrição de fala para texto para uma postagem de vídeo do Instagram ou URL de Reels. Postagens de foto e carrossel não são suportadas.
`instagram_submit_video_speech_text_by_post_id`	Enviar um trabalho de transcrição de fala para texto para uma postagem de vídeo do Instagram ou Reels `post_id`. Postagens de foto e carrossel não são suportadas.
`instagram_get_video_speech_text_job`	Verificar um trabalho de transcrição do Instagram usando um `job_id` válido fornecido pelo usuário ou um retornado por uma ferramenta de envio.

Início Rápido

Para clientes que suportam streamable-http autenticado, use o endpoint hospedado diretamente:

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

Um modelo de configuração está disponível em examples/streamable_http_config.json. Substitua <SOCIALDATAX_API_KEY> pela sua API Key antes do uso.

Para clientes MCP somente command/stdio, use mcp-remote:

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

O Claude Code pode usar HTTP remoto diretamente:

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

Persista SOCIALDATAX_API_KEY no ambiente de execução ou no Secret do cliente antes de reiniciar o Claude Code.

O Claude Desktop deve usar sua interface remota de MCP / Connectors quando disponível. Se um arquivo de configuração local na sua versão suportar apenas servidores command/stdio, use o fallback mcp-remote.

Exemplos de Cliente

Exemplos de configuração estão disponíveis em examples:

API Key

Solicite ou gerencie o acesso à API no site do produto:

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

Use a chave como um token Bearer no cabeçalho de requisição Authorization. Não comprometa valores reais de API Key em código, documentação, issues ou capturas de tela.

Metadados do Diretório

Arquivos de metadados públicos neste repositório:

server-card.json: metadados orientados a diretório para o serviço hospedado. A publicação oficial no Registro MCP usa o registry/instagram/server.json do repositório de origem privado para a entrada atual do com.52choujiang/instagram-insights.
mcp.json: configuração genérica de fallback command/stdio usando mcp-remote.
glama.json: metadados de propriedade do repositório Glama.
SUBMISSION_CHECKLIST.md: lista de verificação para submissões em diretórios MCP.

Licença

Os arquivos neste repositório público são liberados sob a Licença MIT. A licença cobre apenas a documentação pública e os exemplos de configuração neste repositório. Ela não cobre a implementação do serviço gerenciado, a infraestrutura hospedada ou qualquer código de backend privado fora deste repositório.