SocialDataX 抖音 Douyin MCP

MCP somente leitura do Douyin / 抖音 para pesquisa de tendências, pesquisa de trabalhos, detalhes de trabalhos, comentários, respostas a comentários, perfis de criadores, trabalhos de criadores e séries de criadores.

GitHub

Experimente este MCPPatrocinado

Documentação

抖音 MCP | Douyin MCP

Este repositório público fornece documentação pública de conexão e metadados MCP para um serviço hospedado de 抖音 MCP / Douyin MCP da SocialDataX.

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

metadados públicos MCP e exemplos de configuração de cliente
o endpoint hospedado streamable-http 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:

抖音 MCP
抖音数据 MCP
抖音热榜 MCP
抖音作品 MCP
抖音评论 MCP
抖音达人 MCP
Douyin MCP
Douyin data MCP
Douyin hot search MCP
Douyin work research MCP
Douyin comments MCP
Douyin creator MCP

Serviço

Endpoint MCP hospedado: https://mcp.socialdatax.com/douyin/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 do registro: com.52choujiang/douyin-insights
Nome futuro do registro: com.socialdatax/douyin-insights
Versão atual da capacidade pública: 0.2.7 com 24 ferramentas rastreadas. Produção hospedada, o Registro oficial e o repositório público do GitHub estão todos em 0.2.7 com 24 ferramentas. A ponte npm stdio é douyin-mcp@0.2.13.

MCP da Plataforma

Use o endpoint hospedado streamable-http diretamente 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.

Ponte npm stdio

Requer Node.js 20.18.1 ou posterior.

Clientes MCP somente command/stdio podem instalar e iniciar a ponte diretamente do npm:

{
  "mcpServers": {
    "socialdatax-douyin": {
      "command": "npx",
      "args": ["-y", "douyin-mcp"],
      "env": {
        "SOCIALDATAX_API_KEY": "<SOCIALDATAX_API_KEY>"
      }
    }
  }
}

O pacote apenas encaminha mensagens MCP stdio locais para o endpoint hospedado SocialDataX Douyin. Ele não contém a implementação privada do serviço nem armazena a chave de API.

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 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 / 积分余额、剩余积分或点数.
Ler a lista de buscas quentes do Douyin / 抖音.
Pesquisar obras do Douyin por palavra-chave com paginação e filtros opcionais.
Pesquisar produtos na busca global do Douyin com paginação opcional e filtros estáveis; os resultados incluem dados normalizados de produto e SKU.
Pesquisar criadores/contas do Douyin por palavra-chave com paginação e filtros opcionais.
Resolver um link de página de conteúdo do Douyin, link curto ou texto de compartilhamento em detalhes estruturados da obra.
Ler detalhes da obra quando o chamador já possui um aweme_id.
Buscar comentários de primeiro nível paginados para análise de comentários.
Buscar respostas paginadas sob um comentário de primeiro nível. Se o usuário fornecer um par completo e válido de aweme_id e comment_id de primeiro nível, use-o diretamente. Se um aweme_id, link de obra ou texto de compartilhamento estiver disponível, mas um ID obrigatório estiver ausente, busque primeiro os comentários de primeiro nível; sem um localizador de obra, pergunte ao usuário. Não use o comment_id de um item de resposta como o comment_id de primeiro nível; ambos aweme_id e comment_id são obrigatórios. Use page_token para continuar a paginação.
Ler dados de perfil do criador a partir de um link de perfil, link curto, texto de compartilhamento ou sec_user_id.
Buscar listas de obras do criador a partir de um link de perfil, link curto, texto de compartilhamento ou sec_user_id.
Buscar listas de mini-dramas / séries do criador a partir de um link de perfil, link curto, texto de compartilhamento ou sec_user_id.
Enviar uma tarefa de transcrição de fala para texto de vídeo de obra; a chamada de envio pode aguardar até 240 segundos, e trabalhos não concluídos devem continuar consultando o mesmo job_id até o estado terminal.

Ferramentas

Ferramenta	Propósito público
`socialdatax_get_points_balance`	Consultar o saldo de pontos SocialDataX da conta da chave de API atual / 积分余额、剩余积分或点数.
`douyin_get_hot_search_list`	Obter a lista principal de buscas quentes do Douyin / 抖音 atual.
`douyin_search_videos`	Pesquisar vídeos do Douyin e obras de imagem/texto por termo de busca. Use esta ferramenta quando o usuário precisar de obras encontradas por um termo de busca; quando um link de obra ou `aweme_id` já estiver disponível, use a ferramenta correspondente de detalhes, comentários ou fala para texto. Suporta continuação `page_token`.
`douyin_search_products`	Pesquisar produtos na busca global do Douyin com filtros de ordenação, preço, serviço e pontos de venda. Não passe URLs de produto, `product_id`, `sku_id` ou `page_token` como termo de busca. Retorna dados normalizados de produto e SKU e suporta continuação opaca `page_token`; não representa o fluxo completo de busca no canal da loja.
`douyin_get_product_detail_by_product_id`	Buscar detalhes estruturados de preço, loja, imagem, garantia, envio e especificações usando um `product_id` completo. Use um ID fornecido diretamente pelo usuário; nenhuma busca prévia é necessária. Se necessário, obtenha `product_id` de `douyin_search_products`; não passe `sku_id`, links de produto ou termos de busca.
`douyin_get_product_detail_by_url`	Buscar os mesmos detalhes estruturados de produto a partir de um link curto de produto suportado, link de página de produto ou texto de compartilhamento.
`douyin_search_users`	Pesquisar usuários, contas, criadores ou influenciadores do Douyin por termo de busca. Use esta ferramenta quando o usuário precisar de usuários encontrados por um termo de busca; quando `sec_user_id` ou um link de perfil já estiver disponível, use a ferramenta correspondente de perfil ou lista de criador. Não use para pesquisar obras. Suporta continuação `page_token`.
`douyin_get_video_detail_by_aweme_id`	Buscar detalhes estruturados de vídeo ou obra de imagem/texto quando o chamador já possui um `aweme_id`.
`douyin_get_video_detail_by_url`	Resolver um link de página de conteúdo do Douyin, link curto ou texto de compartilhamento em detalhes estruturados de vídeo ou obra de imagem/texto.
`douyin_get_video_share_link_by_aweme_id`	Gerar um link curto de compartilhamento de obra e texto de compartilhamento copiável por aweme_id.
`douyin_get_video_share_link_by_url`	Gerar um link curto de compartilhamento e texto de compartilhamento copiável a partir de um link de página de obra, link curto ou texto de compartilhamento.
`douyin_get_video_comments_by_aweme_id`	Buscar comentários de primeiro nível paginados quando o chamador já possui um `aweme_id`.
`douyin_get_video_comments_by_url`	Buscar comentários de primeiro nível paginados diretamente de um link de página de conteúdo do Douyin, link curto ou texto de compartilhamento.
`douyin_get_video_comment_replies_by_comment_id`	Buscar respostas paginadas sob um comentário de primeiro nível. Se o usuário fornecer um par completo e válido de `aweme_id` e `comment_id` de primeiro nível, use-o diretamente. Se um `aweme_id`, link de obra ou texto de compartilhamento estiver disponível, mas um ID obrigatório estiver ausente, busque primeiro os comentários de primeiro nível; sem um localizador de obra, pergunte ao usuário. Não use o `comment_id` de um item de resposta como o `comment_id` de primeiro nível; ambos `aweme_id` e `comment_id` são obrigatórios. Use `page_token` para continuar a paginação.
`douyin_get_user_info_by_sec_user_id`	Buscar dados de perfil do criador quando o chamador já possui um `sec_user_id`.
`douyin_get_user_info_by_douyin_id`	Buscar dados de perfil do criador quando o chamador possui o ID público da conta Douyin / `douyin_id`.
`douyin_get_user_info_by_profile_url`	Resolver um link de perfil do Douyin, link curto ou texto de compartilhamento em dados de perfil do criador.
`douyin_get_user_posted_videos_by_sec_user_id`	Buscar uma lista paginada de obras publicadas por um criador quando o chamador já possui um `sec_user_id`.
`douyin_get_user_posted_videos_by_profile_url`	Buscar uma lista paginada de obras publicadas por um criador a partir de um link de perfil, link curto ou texto de compartilhamento.
`douyin_get_user_series_by_sec_user_id`	Buscar listas de mini-dramas / séries do criador quando o chamador já possui um `sec_user_id`.
`douyin_get_user_series_by_profile_url`	Buscar listas de mini-dramas / séries do criador a partir de um link de perfil, link curto ou texto de compartilhamento.
`douyin_submit_video_speech_text_by_video_url`	Enviar uma tarefa de transcrição de fala para texto de vídeo de obra a partir de um link de página de obra, link curto ou texto de compartilhamento. A chamada de envio pode aguardar até 240 segundos; se não concluída, continue consultando o mesmo `job_id` até o estado terminal.
`douyin_submit_video_speech_text_by_aweme_id`	Enviar uma tarefa de transcrição de fala para texto de vídeo de obra a partir de um `aweme_id`. A chamada de envio pode aguardar até 240 segundos; se não concluída, continue consultando o mesmo `job_id` até o estado terminal.
`douyin_get_video_speech_text_job`	Verificar um trabalho de transcrição de fala para texto de vídeo de obra usando um `job_id` válido fornecido pelo usuário, ou um `job_id` retornado por uma ferramenta de envio, sem criar uma nova tarefa; não passe `aweme_id` ou um link de obra. Cada chamada aguarda até 240 segundos. Se não concluída, continue consultando o mesmo `job_id` até o estado terminal. Esta superfície v1 retorna transcrição mais contexto de conteúdo, não resumo.

Início Rápido

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

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

Um exemplo pronto para copiar está disponível em examples/streamable_http_config.json.

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

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

O Claude Code pode usar HTTP remoto diretamente:

claude mcp add --transport http socialdatax-douyin https://mcp.socialdatax.com/douyin/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 command/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 acesso à API no site do produto:

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

Use a chave como um token Bearer no cabeçalho de solicitação Authorization. Não envie valores reais de chave de API para 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/douyin/server.json do repositório de origem privado para a entrada atual com.52choujiang/douyin-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 envios 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.