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.

GitHubExperimente este MCPPatrocinado

Documentação

Instagram MCP

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

Se você está procurando um Instagram MCP 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 comando/stdio

A implementação comercial é hospedada de forma privada. Este repositório expõe apenas a superfície de conexão pública 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 à chave de API: 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.5

Plataforma MCP

Use o endpoint streamable-http hospedado diretamente em clientes que suportam MCP remoto autenticado. Para clientes que suportam apenas servidores MCP comando/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 em contas, 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 chave de API atual.
Pesquisar postagens públicas do Instagram por palavra-chave; continuar 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 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 estiver disponível, pergunte ao usuário pela URL ou 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 chave de API atual.
`instagram_search_posts`	Pesquisar 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 do usuário ou postagens do usuário correspondente. Suporta continuação `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 `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` estiver disponível, pergunte ao usuário pela URL ou 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 `post_id` de Reels. Postagens de foto e carrossel não são suportadas.
`instagram_get_video_speech_text_job`	Verificar o trabalho de transcrição retornado por uma ferramenta de envio do Instagram usando o mesmo `job_id`.

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 chave de API antes do uso.

Para clientes MCP somente comando/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 / Conectores quando disponível. Se um arquivo de configuração local na sua versão suportar apenas servidores comando/stdio, use o fallback mcp-remote.

Exemplos de Cliente

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

Chave de API

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 chave de API 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-fonte privado para a entrada com.52choujiang/instagram-insights atual.
mcp.json: configuração genérica de fallback comando/stdio usando mcp-remote.
glama.json: metadados de propriedade do repositório Glama.
SUBMISSION_CHECKLIST.md: lista de verificação para submissões de diretório MCP.

Licença

Os arquivos neste repositório público são lançados 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.