SocialDataX 抖音 Douyin MCP

MCP de solo lectura para Douyin / 抖音 que permite búsqueda de tendencias, búsqueda de trabajos, detalles de trabajos, comentarios, respuestas a comentarios, perfiles de creadores, trabajos de creadores y series de creadores.

GitHub

Prueba este MCPPatrocinado

Documentación

抖音 MCP | Douyin MCP

Este repositorio público proporciona documentación de conexión pública y metadatos MCP para un servicio alojado de 抖音 MCP / Douyin MCP de SocialDataX.

Si buscas un Douyin MCP o 抖音 MCP para flujos de trabajo de investigación en redes sociales, este repositorio incluye:

metadatos MCP públicos y ejemplos de configuración de cliente
el endpoint alojado streamable-http para clientes que admiten MCP remoto
un ejemplo de respaldo mcp-remote para clientes MCP solo de comando/stdio

La implementación comercial 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:

抖音 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

Servicio

Endpoint MCP alojado: https://mcp.socialdatax.com/douyin/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/douyin-insights
Nombre futuro del registro: com.socialdatax/douyin-insights
Versión de capacidad pública actual: 0.2.7 con 24 herramientas rastreadas. La producción alojada, el Registro oficial y el repositorio público de GitHub están todos en 0.2.7 con 24 herramientas. El puente npm stdio es douyin-mcp@0.2.13.

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 comando/stdio, usa mcp-remote como proxy de compatibilidad local.

Puente npm stdio

Requiere Node.js 20.18.1 o posterior.

Los clientes MCP solo de comando/stdio pueden instalar e iniciar el puente directamente desde npm:

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

El paquete solo reenvía mensajes MCP stdio locales al endpoint alojado de SocialDataX Douyin. No contiene la implementación del servicio privado ni almacena la clave API.

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 ni otras acciones de cuenta.

Los flujos de trabajo admitidos incluyen:

Consultar el saldo de puntos SocialDataX de la cuenta de la clave API actual / 积分余额、剩余积分或点数.
Leer la lista de búsquedas populares de Douyin / 抖音.
Buscar obras de Douyin por palabra clave con paginación y filtros opcionales.
Buscar productos en la búsqueda global de Douyin con paginación y filtros estables opcionales; los resultados incluyen datos normalizados de productos y SKU.
Buscar creadores/cuentas de Douyin por palabra clave con paginación y filtros opcionales.
Resolver un enlace de página de contenido de Douyin, enlace corto o texto compartido en detalles estructurados de la obra.
Leer detalles de la obra cuando el llamador ya tiene un aweme_id.
Obtener comentarios de primer nivel paginados para análisis de comentarios.
Obtener respuestas paginadas bajo un comentario de primer nivel. Si el usuario proporciona un par completo y válido de aweme_id y comment_id de primer nivel, úsalo directamente. Si hay un aweme_id, enlace de obra o texto compartido disponible pero falta un ID requerido, obtén primero los comentarios de primer nivel; sin un localizador de obra, pregunta al usuario. No uses el comment_id propio de un elemento de respuesta como comment_id de primer nivel; tanto aweme_id como comment_id son obligatorios. Usa page_token para continuar la paginación.
Leer datos de perfil de creador desde un enlace de perfil, enlace corto, texto compartido o sec_user_id.
Obtener listas de obras de creadores desde un enlace de perfil, enlace corto, texto compartido o sec_user_id.
Obtener listas de series/dramas cortos de creadores desde un enlace de perfil, enlace corto, texto compartido o sec_user_id.
Enviar una tarea de transcripción de voz a texto de video de obra; la llamada de envío puede esperar hasta 240 segundos, y los trabajos no terminados deben continuar consultando el mismo job_id hasta el estado final.

Herramientas

Herramienta	Propósito público
`socialdatax_get_points_balance`	Consultar el saldo de puntos SocialDataX de la cuenta de la clave API actual / 积分余额、剩余积分或点数.
`douyin_get_hot_search_list`	Obtener la lista principal de búsquedas populares actual de Douyin / 抖音.
`douyin_search_videos`	Buscar obras de video e imagen/texto de Douyin por término de búsqueda. Usa esta herramienta cuando el usuario necesite obras encontradas por un término de búsqueda; cuando ya haya un enlace de obra o `aweme_id` disponible, usa la herramienta correspondiente de detalle, comentario o voz a texto. Admite continuación con `page_token`.
`douyin_search_products`	Buscar productos en la búsqueda global de Douyin con filtros de ordenación, precio, servicio y puntos de venta. No pases URL de productos, `product_id`, `sku_id` o `page_token` como término de búsqueda. Devuelve datos normalizados de productos y SKU y admite continuación opaca con `page_token`; no representa el flujo completo de búsqueda en el canal de la tienda.
`douyin_get_product_detail_by_product_id`	Obtener detalles estructurados de precio, tienda, imagen, garantía, envío y especificaciones usando un `product_id` completo. Usa un ID proporcionado directamente por el usuario; no se requiere búsqueda previa. Si es necesario, obtén `product_id` de `douyin_search_products`; no pases `sku_id`, enlaces de productos ni términos de búsqueda.
`douyin_get_product_detail_by_url`	Obtener los mismos detalles estructurados de producto desde un enlace corto de producto admitido, enlace de página de producto o texto compartido.
`douyin_search_users`	Buscar usuarios, cuentas, creadores o influencers de Douyin por término de búsqueda. Usa esta herramienta cuando el usuario necesite usuarios encontrados por un término de búsqueda; cuando ya haya `sec_user_id` o un enlace de perfil disponible, usa la herramienta correspondiente de perfil o lista de creadores. No la uses para buscar obras. Admite continuación con `page_token`.
`douyin_get_video_detail_by_aweme_id`	Obtener detalles estructurados de obras de video o imagen/texto cuando el llamador ya tiene un `aweme_id`.
`douyin_get_video_detail_by_url`	Resolver un enlace de página de contenido de Douyin, enlace corto o texto compartido en detalles estructurados de obras de video o imagen/texto.
`douyin_get_video_share_link_by_aweme_id`	Generar un enlace corto de compartir de obra y texto compartido copiable por aweme_id.
`douyin_get_video_share_link_by_url`	Generar un enlace corto de compartir y texto compartido copiable desde un enlace de página de obra, enlace corto o texto compartido.
`douyin_get_video_comments_by_aweme_id`	Obtener comentarios de primer nivel paginados cuando el llamador ya tiene un `aweme_id`.
`douyin_get_video_comments_by_url`	Obtener comentarios de primer nivel paginados directamente desde un enlace de página de contenido de Douyin, enlace corto o texto compartido.
`douyin_get_video_comment_replies_by_comment_id`	Obtener respuestas paginadas bajo un comentario de primer nivel. Si el usuario proporciona un par completo y válido de `aweme_id` y `comment_id` de primer nivel, úsalo directamente. Si hay un `aweme_id`, enlace de obra o texto compartido disponible pero falta un ID requerido, obtén primero los comentarios de primer nivel; sin un localizador de obra, pregunta al usuario. No uses el `comment_id` propio de un elemento de respuesta como `comment_id` de primer nivel; tanto `aweme_id` como `comment_id` son obligatorios. Usa `page_token` para continuar la paginación.
`douyin_get_user_info_by_sec_user_id`	Obtener datos de perfil de creador cuando el llamador ya tiene un `sec_user_id`.
`douyin_get_user_info_by_douyin_id`	Obtener datos de perfil de creador cuando el llamador tiene el ID público de cuenta de Douyin / `douyin_id`.
`douyin_get_user_info_by_profile_url`	Resolver un enlace de perfil de Douyin, enlace corto o texto compartido en datos de perfil de creador.
`douyin_get_user_posted_videos_by_sec_user_id`	Obtener una lista paginada de obras publicadas por un creador cuando el llamador ya tiene un `sec_user_id`.
`douyin_get_user_posted_videos_by_profile_url`	Obtener una lista paginada de obras publicadas por un creador desde un enlace de perfil, enlace corto o texto compartido.
`douyin_get_user_series_by_sec_user_id`	Obtener listas de series/dramas cortos de creadores cuando el llamador ya tiene un `sec_user_id`.
`douyin_get_user_series_by_profile_url`	Obtener listas de series/dramas cortos de creadores desde un enlace de perfil, enlace corto o texto compartido.
`douyin_submit_video_speech_text_by_video_url`	Enviar una tarea de transcripción de voz a texto de video de obra desde un enlace de página de obra, enlace corto o texto compartido. La llamada de envío puede esperar hasta 240 segundos; si no termina, continúa consultando el mismo `job_id` hasta el estado final.
`douyin_submit_video_speech_text_by_aweme_id`	Enviar una tarea de transcripción de voz a texto de video de obra desde un `aweme_id`. La llamada de envío puede esperar hasta 240 segundos; si no termina, continúa consultando el mismo `job_id` hasta el estado final.
`douyin_get_video_speech_text_job`	Verificar un trabajo de transcripción de voz a texto de video de obra usando un `job_id` válido proporcionado por el usuario, o un `job_id` devuelto por una herramienta de envío, sin crear una nueva tarea; no pases `aweme_id` ni un enlace de obra. Cada llamada espera hasta 240 segundos. Si no termina, continúa consultando el mismo `job_id` hasta el estado final. Esta superficie v1 devuelve transcripción más contexto de contenido, no resumen.

Inicio rápido

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

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

Hay un ejemplo listo para copiar disponible en examples/streamable_http_config.json.

Para clientes MCP solo de comando/stdio, usa 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>"
      }
    }
  }
}

Claude Code puede usar HTTP remoto directamente:

claude mcp add --transport http socialdatax-douyin https://mcp.socialdatax.com/douyin/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 comando/stdio, usa el respaldo mcp-remote.

Ejemplos de cliente

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 en el Registro MCP usa el registry/douyin/server.json del repositorio fuente privado para la entrada actual de com.52choujiang/douyin-insights.
mcp.json: configuración genérica de respaldo de comando/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 backend privado fuera de este repositorio.