SocialDataX 抖音 Douyin MCP

com.52choujiangPublished by 52choujiang.comv0.2.8Updated Oct 30, 2026

hot search、suggestions、video/user/product search、comments/replies、users/works/series、transcript

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & CommerceMedia & Design

Overview

AI-generated overview

Remote MCP server for Douyin (TikTok China) data: hot search, search, videos, users, comments, transcripts and products.

What you can do
  • Read the Douyin hot search list and search input suggestions
  • Search videos, users and products by keyword, with paging
  • Fetch video or image-post details from an ID, link or share text, and generate share links
  • List first-level comments and replies, and submit video speech-to-text jobs and poll their status
  • Look up user profiles, posted videos and short-drama series by user ID, Douyin ID or profile link
  • Read product details by product ID or link, and check the API key's points balance
When to use it
Useful when you need Douyin research or monitoring inside an assistant: trending topics, keyword searches, creator and video lookups, comment reading, spoken-content transcripts, or product data for e-commerce analysis.
Requirements
A remote streamable HTTP endpoint; no local install. Requires a SocialDataX API key sent as a bearer token in the Authorization header. Calls consume account points, and network access to the provider is needed.
Before you install
The API key is a billable credential: every call draws on the account's points balance, so watch usage and top-ups. The server reads public Douyin content and submits transcription jobs on the provider's side, so queries and the IDs or links you send go to SocialDataX. Share-link generation produces outward-facing links.

Installation

In SourceWeft

  1. Open SocialDataX 抖音 Douyin MCP in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.52choujiang%2Fdouyin-insights/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Tools

25

douyin_get_hot_search_list

获取抖音主热榜；当前不支持翻页。

Takes no parameters.

douyin_search_suggestions

获取抖音普通搜索输入框联想词；不用于搜索作品、用户或商品，也不要传 page_token。

Parameterskeywordrequired

douyin_get_video_detail_by_aweme_id

根据抖音作品 aweme_id 获取视频或图文作品详情；已知 aweme_id 时优先使用此入口。

Parametersaweme_idrequired

douyin_get_video_detail_by_url

根据抖音作品页面链接、作品短链接或包含作品链接的分享文案获取视频或图文作品详情。

Parametersurlrequired

douyin_submit_video_speech_text_by_video_url

提交抖音作品视频口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。

Parametersvideo_urlrequired

douyin_submit_video_speech_text_by_aweme_id

根据抖音 aweme_id 提交视频口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。

Parametersaweme_idrequired

douyin_get_video_speech_text_job

根据用户提供的有效 job_id，或 submit 工具返回的 job_id 查询抖音视频口播转文字任务状态；用于继续未完成任务，每次最多等待 240 秒，不触发重处理，也不要重复提交任务。

Parametersjob_idrequired

douyin_get_video_comments_by_aweme_id

根据抖音作品 aweme_id 获取一级评论列表，支持 page_token 翻页。

Parametersaweme_idrequiredpage_token

douyin_get_video_comments_by_url

根据抖音作品页面链接、作品短链接或包含作品链接的分享文案获取一级评论列表，支持 page_token 翻页。

Parametersurlrequiredpage_token

douyin_get_video_comment_replies_by_comment_id

根据 aweme_id 和一级评论 comment_id 获取抖音评论回复；需同时传入 aweme_id 和 comment_id。用户已提供完整合法组合时直接使用；已有 aweme_id、作品链接或分享文案但缺少必需 ID 时，调用对应一级评论工具补全；缺少作品定位信息时向用户索取；不要传回复项自身的 comment_id；支持 page_token 翻页。

Parametersaweme_idrequiredcomment_idrequiredpage_token

douyin_get_user_info_by_sec_user_id

根据抖音用户 sec_user_id 获取用户资料；已知 sec_user_id 时优先使用此入口。

Parameterssec_user_idrequired

douyin_get_user_info_by_douyin_id

根据用户主页展示的抖音号 douyin_id 获取用户资料。

Parametersdouyin_idrequired

douyin_get_user_info_by_profile_url

根据抖音主页长链接、短链接或分享文案获取用户资料。

Parametersprofile_urlrequired

douyin_get_user_posted_videos_by_sec_user_id

根据抖音用户 sec_user_id 获取该用户发布的作品列表，支持 page_token 翻页。

Parameterspage_tokensec_user_idrequired

douyin_get_user_posted_videos_by_profile_url

根据抖音主页长链接、短链接或分享文案获取用户发布的作品列表，支持 page_token 翻页。

Parameterspage_tokenprofile_urlrequired

douyin_get_user_series_by_sec_user_id

根据抖音用户 sec_user_id 获取该用户短剧列表，支持 page_token 翻页。

Parameterspage_tokensec_user_idrequired

douyin_get_user_series_by_profile_url

根据抖音主页长链接、短链接或分享文案获取用户短剧列表，支持 page_token 翻页。

Parameterspage_tokenprofile_urlrequired

douyin_search_users

搜索抖音用户、账号、博主、创作者或达人，支持 page_token 翻页。用户需要按搜索词查找用户时使用；已有 sec_user_id 或用户主页链接时使用相应用户资料或列表工具；不用于搜索作品。

Parameterskeywordrequireduser_typepage_tokenfollower_count_range

douyin_search_videos

搜索抖音视频和图文作品。用户需要按搜索词查找作品时使用；已有作品链接或 aweme_id 且需要单篇信息时使用相应详情、评论或口播转文字工具；作品通常为视频，也可能包含图文内容；支持 page_token 翻页。

Parameterskeywordrequiredsort_typepage_tokencontent_typeduration_rangepublish_time_range

douyin_search_products

用户需要按关键词查找抖音全局搜索中的商品时使用；支持排序、价格、服务和卖点筛选，返回归一化商品列表与不透明分页令牌。当前服务提供详情工具时：已有 product_id 时直接使用 douyin_get_product_detail_by_product_id；已有商品链接或分享文案时使用 douyin_get_product_detail_by_url。不用于搜索作品或用户，也不表示商城频道内完整搜索链路。

Parameterskeywordrequiredmax_pricemin_priceonly_livesort_typepage_tokenselling_pointofficial_storeseven_day_returnshipping_insurancedispatch_within_24h

douyin_get_product_detail_by_product_id

根据 product_id 读取抖音商品详情；已有完整商品 ID（包括用户直接提供）时直接使用，无需先搜索；否则可从 douyin_search_products 获取。只有商品链接或分享文案时使用 douyin_get_product_detail_by_url。

Parametersproduct_idrequired

douyin_get_product_detail_by_url

根据抖音商品链接或分享文案读取商品详情；只有链接类输入时使用此入口。

Parametersurlrequired

socialdatax_get_points_balance

查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。

Takes no parameters.

Version history

3
  1. v0.2.8LatestSep 29, 2026
  2. v0.2.7Sep 20, 2026
  3. v0.2.5Sep 16, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.