抖音 MCP | Douyin MCP

This public repository provides public connection docs and MCP metadata for a hosted 抖音 MCP / Douyin MCP service by SocialDataX.

If you are looking for a Douyin MCP or 抖音 MCP for social media research workflows, this repository includes:

• public MCP metadata and client configuration examples
• the hosted streamable-http endpoint for clients that support remote MCP
• an mcp-remote fallback example for command/stdio-only MCP clients

The business implementation is privately hosted. This repository exposes only the public connection surface for social media content intelligence workflows.

Search Aliases

Common search phrases for this MCP service:

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

Service

• Hosted MCP endpoint: https://mcp.socialdatax.com/douyin/mcp
• Hosted transport: streamable-http
• Authentication: Authorization: Bearer <SOCIALDATAX_API_KEY>
• Product: SocialDataX / 社媒数据助手
• Website and API Key access: https://socialdatax.com/ai?from=github
• Registry name: com.52choujiang/douyin-insights
• Future registry name: com.socialdatax/douyin-insights
• Current public capability version: 0.2.7 with 24 tracked tools. Hosted production, the official Registry, and the public GitHub repository are all at 0.2.7 with 24 tools. The npm stdio bridge is [email protected].

Platform MCP

Use the hosted streamable-http endpoint directly from clients that support authenticated remote MCP. For clients that only support command/stdio MCP servers, use mcp-remote as a local compatibility proxy.

npm stdio bridge

Requires Node.js 20.18.1 or later.

Command/stdio-only MCP clients can install and start the bridge directly from npm:

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

The package only forwards local stdio MCP messages to the hosted SocialDataX Douyin endpoint. It does not contain the private service implementation or store the API Key.

Workflow Scope

This MCP service is designed for social media content intelligence workflows. It does not provide account login, posting, editing, liking, commenting, or other account actions.

Supported workflows include:

• Query the current API Key account's SocialDataX points balance / 积分余额、剩余积分或点数.
• Read the Douyin / 抖音 hot search list.
• Search Douyin works by keyword with optional paging and filters.
• Search products in Douyin global search with optional paging and stable filters; results include normalized product and SKU data.
• Search Douyin creators/accounts by keyword with optional paging and filters.
• Resolve a Douyin content page link, short link, or share text into structured work details.
• Read work details when the caller already has an aweme_id.
• Fetch paginated first-level comments for comment analysis.
• Fetch paginated replies under a first-level comment. If the user supplies a complete, valid aweme_id and first-level comment_id pair, use it directly. If an aweme_id, work link or share text is available but a required ID is missing, fetch first-level comments first; without a work locator, ask the user. Do not use a reply item's own comment_id as the first-level comment_id; both aweme_id and comment_id are required. Use page_token to continue pagination.
• Read creator profile data from a profile link, short link, share text, or sec_user_id.
• Fetch creator work lists from a profile link, short link, share text, or sec_user_id.
• Fetch creator short-drama / series lists from a profile link, short link, share text, or sec_user_id.
• Submit a work video speech-to-text transcript task; the submit call may wait up to 240 seconds, and unfinished jobs should continue polling the same job_id until terminal.

Tools

| Tool | Public purpose | | --- | --- | | socialdatax_get_points_balance | Query the current API Key account's SocialDataX points balance / 积分余额、剩余积分或点数. | | douyin_get_hot_search_list | Get the current Douyin / 抖音 main hot search list. | | douyin_search_videos | Search Douyin video and image/text works by search term. Use this tool when the user needs works found by a search term; when a work link or aweme_id is already available, use the corresponding detail, comment, or speech-to-text tool. Supports page_token continuation. | | douyin_search_products | Search products in Douyin global search with sorting, price, service, and selling-point filters. Do not pass product URLs, product_id, sku_id, or page_token as the search term. Returns normalized product and SKU data and supports opaque page_token continuation; it does not represent the full in-mall-channel search flow. | | douyin_get_product_detail_by_product_id | Fetch structured price, shop, image, assurance, shipping, and specification details using a complete product_id. Use an ID supplied by the user directly; no prior search is required. If needed, obtain product_id from douyin_search_products; do not pass sku_id, product links, or search terms. | | douyin_get_product_detail_by_url | Fetch the same structured product details from a supported product short link, product page link, or share text. | | douyin_search_users | Search Douyin users, accounts, creators, or influencers by search term. Use this tool when the user needs users found by a search term; when sec_user_id or a profile link is already available, use the corresponding profile or creator-list tool. Do not use it to search works. Supports page_token continuation. | | douyin_get_video_detail_by_aweme_id | Fetch structured video or image/text work details when the caller already has an aweme_id. | | douyin_get_video_detail_by_url | Resolve a Douyin content page link, short link, or share text into structured video or image/text work details. | | douyin_get_video_share_link_by_aweme_id | Generate a work share short link and copyable share text by aweme_id. | | douyin_get_video_share_link_by_url | Generate a share short link and copyable share text from a work page link, short link, or share text. | | douyin_get_video_comments_by_aweme_id | Fetch paginated first-level comments when the caller already has an aweme_id. | | douyin_get_video_comments_by_url | Fetch paginated first-level comments directly from a Douyin content page link, short link, or share text. | | douyin_get_video_comment_replies_by_comment_id | Fetch paginated replies under a first-level comment. If the user supplies a complete, valid aweme_id and first-level comment_id pair, use it directly. If an aweme_id, work link or share text is available but a required ID is missing, fetch first-level comments first; without a work locator, ask the user. Do not use a reply item's own comment_id as the first-level comment_id; both aweme_id and comment_id are required. Use page_token to continue pagination. | | douyin_get_user_info_by_sec_user_id | Fetch creator profile data when the caller already has a sec_user_id. | | douyin_get_user_info_by_douyin_id | Fetch creator profile data when the caller has the public Douyin account ID / douyin_id. | | douyin_get_user_info_by_profile_url | Resolve a Douyin profile link, short link, or share text into creator profile data. | | douyin_get_user_posted_videos_by_sec_user_id | Fetch a paginated list of works published by a creator when the caller already has a sec_user_id. | | douyin_get_user_posted_videos_by_profile_url | Fetch a paginated list of works published by a creator from a profile link, short link, or share text. | | douyin_get_user_series_by_sec_user_id | Fetch creator short-drama / series lists when the caller already has a sec_user_id. | | douyin_get_user_series_by_profile_url | Fetch creator short-drama / series lists from a profile link, short link, or share text. | | douyin_submit_video_speech_text_by_video_url | Submit a work video speech-to-text transcript task from a work page link, short link, or share text. The submit call may wait up to 240 seconds; if unfinished, continue polling the same job_id until terminal. | | douyin_submit_video_speech_text_by_aweme_id | Submit a work video speech-to-text transcript task from an aweme_id. The submit call may wait up to 240 seconds; if unfinished, continue polling the same job_id until terminal. | | douyin_get_video_speech_text_job | Check a work video speech-to-text transcript job using a valid job_id supplied by the user, or a job_id returned by a submit tool, without creating a new task; do not pass aweme_id or a work link. Each call waits up to 240 seconds. If unfinished, continue querying the same job_id until terminal. This v1 surface returns transcript plus content context, not summary. |

Quick Start

For clients that support authenticated streamable-http, use the hosted endpoint directly:

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

A ready-to-copy example is available in examples/streamable_http_config.json.

For command/stdio-only MCP clients, 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>"
      }
    }
  }
}

Claude Code can use remote HTTP directly:

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

Persist SOCIALDATAX_API_KEY in the runtime environment or client Secret before restarting Claude Code.

Claude Desktop should use its remote MCP / Connectors UI when available. If a local configuration file in your version only supports command/stdio servers, use the mcp-remote fallback.

Client Examples

Configuration examples are available in examples:

• Command/stdio fallback config
• Claude Desktop fallback config
• Cursor remote HTTP config
• Codex remote HTTP config
• Direct streamable HTTP config

API Key

Request or manage API access from the product website:

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

Use the key as a Bearer token in the Authorization request header. Do not commit real API Key values to code, docs, issues, or screenshots.

Directory Metadata

Public metadata files in this repository:

• server-card.json: directory-oriented metadata for the hosted service. Official MCP Registry publishing uses the private source repo's registry/douyin/server.json for the current com.52choujiang/douyin-insights entry.
• mcp.json: generic command/stdio fallback config using mcp-remote.
• glama.json: Glama repository ownership metadata.
• SUBMISSION_CHECKLIST.md: checklist for MCP directory submissions.

License

The files in this public repository are released under the MIT License. The license covers the public documentation and configuration examples in this repository only. It does not cover the managed service implementation, hosted infrastructure, or any private backend code outside this repository.