How do I install the douyin mcp mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `SOCIALDATAX_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Douyin MCP Server

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

Remote serverstreamable-http

What is the Douyin MCP Server?

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
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
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
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 pri
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 pr
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 awe
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,
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
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;

How to install the Douyin MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
SOCIALDATAX_API_KEY	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Douyin MCP to douyin get hot search list.”
“Use Douyin MCP to douyin search videos.”
“Use Douyin MCP to douyin get video detail by aweme id.”

Frequently asked questions

This public repository provides public connection docs and MCP metadata for a hosted 抖音 MCP / Douyin MCP service by SocialDataX. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.