SocialDataX 抖音 Douyin MCP

com.52choujiang/douyin-insights

Provides programmatic access to Douyin (the Chinese version of TikTok) through a streamable HTTP interface. You get endpoints for hot search trends, work search and details, comments and replies, creator profiles, their published works, and series content. Reach for this when you're building analytics dashboards, content monitoring tools, or research applications that need to pull Douyin data without scraping. The remote URL setup means you don't need to handle authentication or API rate limiting yourself, just point your MCP client at their hosted service and start querying Chinese short video platform data.

tools: 26
auth: Secret needed
transport: HTTP
last updated: Sep 29, 2026

Open website

Install

From registry metadata

$ npx add-mcp https://mcp.socialdatax.com/douyin/mcp --name douyin-insights --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http douyin-insights https://mcp.socialdatax.com/douyin/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 26 tools

Verified live against the running server on Nov 6, 2026.

douyin_get_video_statistics按单个作品 ID 查询视频或图文播放量、点赞数、评论数和下载数，每次仅传一个 ID；未提供的互动指标为 null，未返回统计的 ID 单独列出。1 params

按单个作品 ID 查询视频或图文播放量、点赞数、评论数和下载数，每次仅传一个 ID；未提供的互动指标为 null，未返回统计的 ID 单独列出。

Parameters* required

aweme_id*string

单个抖音视频或图文作品 ID，1–32 位数字字符串。可复用搜索或详情结果中的 aweme_id，不传链接或分享文案。

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

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

No parameters. Call it with no arguments.

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

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

Parameters* required

keyword*string

搜索词，用于获取抖音普通搜索输入框中的联想词；不要传作品链接、用户主页链接、aweme_id、sec_user_id 或 page_token。

douyin_get_video_detail_by_aweme_id根据抖音作品 aweme_id 获取视频或图文作品详情及播放量；播放量未获取到时为 null，不影响其余详情，不额外收费。已知 aweme_id 时优先使用此入口。1 params

根据抖音作品 aweme_id 获取视频或图文作品详情及播放量；播放量未获取到时为 null，不影响其余详情，不额外收费。已知 aweme_id 时优先使用此入口。

Parameters* required

aweme_id*string

抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串

douyin_get_video_detail_by_url根据抖音作品页面链接、作品短链接或包含作品链接的分享文案获取视频或图文作品详情及播放量；播放量未获取到时为 null，不影响其余详情，不额外收费。1 params

根据抖音作品页面链接、作品短链接或包含作品链接的分享文案获取视频或图文作品详情及播放量；播放量未获取到时为 null，不影响其余详情，不额外收费。

Parameters* required

url*string

抖音作品页面链接、作品短链接或包含作品链接的完整分享文案；不要传 video.play_url 这类播放资源链接，也不要传用户主页链接；已知 aweme_id 时优先使用 ID 入口

douyin_get_video_share_link_by_aweme_id根据作品 aweme_id 生成抖音分享短链接和可复制的完整分享文案；用户已提供 aweme_id 时直接使用，无需先搜索或读取详情。读取作品内容请使用详情工具。1 params

根据作品 aweme_id 生成抖音分享短链接和可复制的完整分享文案；用户已提供 aweme_id 时直接使用，无需先搜索或读取详情。读取作品内容请使用详情工具。

Parameters* required

aweme_id*string

抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串

douyin_get_video_share_link_by_url根据作品页面链接、短链接或包含作品链接的分享文案生成抖音分享短链接和完整分享文案；已知 aweme_id 时使用 ID 入口。读取作品内容请使用详情工具。1 params

根据作品页面链接、短链接或包含作品链接的分享文案生成抖音分享短链接和完整分享文案；已知 aweme_id 时使用 ID 入口。读取作品内容请使用详情工具。

Parameters* required

url*string

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

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

Parameters* required

video_url*string

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

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

Parameters* required

aweme_id*string

抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串

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

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

Parameters* required

job_id*string

口播转文字任务 ID；用户已提供时直接使用，否则使用 submit 工具返回的 job_id；不要传 aweme_id、作品链接或其他 ID。

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

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

Parameters* required

aweme_id*string

抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串

page_tokenstring

page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品评论分页链路的下一页，不能跨能力或作品复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。default:

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

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

Parameters* required

page_tokenstring

url*string

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

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

Parameters* required

aweme_id*string

抖音作品的数字 aweme_id，通常可从搜索、详情或评论结果中的 aweme_id 字段复用；不要传作品链接、分享文案或带引号的字符串；用户已提供时直接使用；调用评论回复工具时必填，需与 comment_id 同时传入，且两者须属于同一作品

comment_id*string

一级评论 ID comment_id；用户已提供时直接使用，否则可从一级评论结果 items[*].comment_id 复用；调用评论回复工具时必须同时传入同一作品的 aweme_id；不要传评论回复结果里的 items[*].comment_id

page_tokenstring

page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一作品下同一一级评论的回复分页链路，不能跨能力、作品或评论复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。default:

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

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

Parameters* required

sec_user_id*string

抖音用户 sec_user_id，不透明标识；请传实际字段值，可从结果中的 sec_user_id 或 author.sec_user_id 复用；不要传公开抖音号 douyin_id、字段名或占位文本；只有主页链接时使用 profile_url 入口

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

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

Parameters* required

douyin_id*string

用户主页展示的公开抖音号 douyin_id；不要传昵称、搜索关键词、sec_user_id、用户主页链接或作品链接

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

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

Parameters* required

profile_url*string

抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口

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

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

Parameters* required

page_tokenstring

page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户作品分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。default:

sec_user_id*string

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

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

Parameters* required

page_tokenstring

profile_url*string

抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口

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

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

Parameters* required

page_tokenstring

page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一用户短剧列表分页链路的下一页，不能跨能力或用户复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。default:

sec_user_id*string

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

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

Parameters* required

page_tokenstring

profile_url*string

抖音用户主页链接、用户短链接或用户分享文案；不要传作品链接。已知 sec_user_id 时优先使用 ID 入口

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

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

Parameters* required

follower_count_rangestring

用户粉丝数量筛选，可选：all（不限，默认）、under_1k（1000 以下）、1k_to_10k（1000-1 万）、10k_to_100k（1 万-10 万）、100k_to_1m（10 万-100 万）、over_1m（100 万以上）。如无明确筛选需求，保持 all。one of all · under_1k · 1k_to_10k · 10k_to_100k · 100k_to_1m · over_1mdefault: all

keyword*string

搜索词，可传昵称、抖音号、账号名、达人名称或创作者/博主名称；不用于搜索作品；不要传作品链接、用户主页链接、sec_user_id 或 page_token。

page_tokenstring

page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一搜索链路，不能跨能力、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。default:

user_typestring

用户类型筛选，可选：all（不限，默认）、regular_user（普通用户）、enterprise_verified（企业认证）、individual_verified（个人认证）。如无明确筛选需求，保持 all。one of all · regular_user · enterprise_verified · individual_verifieddefault: all

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

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

Parameters* required

content_typestring

内容形式筛选，可选：all（不限，默认）、video（视频）、image（图文）。如无明确筛选需求，保持 all。one of all · video · imagedefault: all

duration_rangestring

视频时长筛选，可选：all（不限，默认）、under_1_minute（1 分钟以下）、one_to_five_minutes（1-5 分钟）、over_5_minutes（5 分钟以上）。如无明确筛选需求，保持 all。one of all · under_1_minute · one_to_five_minutes · over_5_minutesdefault: all

keyword*string

搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传作品链接、用户主页链接、aweme_id、sec_user_id 或 page_token。

page_tokenstring

publish_time_rangestring

发布时间范围筛选，可选：all（不限，默认）、day（一天内）、week（一周内）、half_year（半年内）。如无明确筛选需求，保持 all。one of all · day · week · half_yeardefault: all

sort_typestring

搜索排序方式，可选：general（综合，默认）、time_descending（最新发布优先）、like_count_descending（最多点赞优先）。综合或默认排序请传 general，最新发布请传 time_descending，最多点赞请传 like_count_descending。hot、latest、time、relevance、relevance_desc、default...one of general · time_descending · like_count_descendingdefault: general

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

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

Parameters* required

dispatch_within_24hboolean

true 时仅返回支持 24 小时内发货的商品；false 表示不限（默认）。default: false

keyword*string

抖音商品搜索词，必填，去除首尾空白后不能为空；可传关键词或短语，例如“iPhone 16”或“露营桌”；keyword 只传搜索词，不要传商品链接、抖音平台对象 ID（如 sku_id、promotion_id、aweme_id、sec_user_id）或 page_token；不要把价格、排序或服务条件拼进 keyword，请使用对应筛选参数。

max_pricevalue

最高价格，正整数，单位：元；必须大于 0，不传表示不限；与 min_price 同时传入时不得小于 min_price。

min_pricevalue

最低价格，正整数，单位：元；必须大于 0，不传表示不限；与 max_price 同时传入时不得大于 max_price。

official_storeboolean

true 时仅返回带“抖音旗舰”标识的商品；false 表示不限（默认）。default: false

only_liveboolean

true 时仅返回当前正在直播的商品（抖音原生筛选“直播中”）；false 表示不限（默认）。default: false

page_tokenstring

page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一抖音商品搜索链路、关键词、排序和筛选条件，不能跨能力复用；翻页时 keyword、sort_type、min_price、max_price 及全部筛选参数必须与上一页保持一致；需要修改任一条件时，清空 page_to...default:

selling_pointstring

卖点筛选：all（不限，默认）、high_sales（月销过万）、high_rating（好评多）。one of all · high_sales · high_ratingdefault: all

seven_day_returnboolean

true 时仅返回支持 7 天无理由退货的商品；false 表示不限（默认）。default: false

shipping_insuranceboolean

true 时仅返回支持运费险的商品；false 表示不限（默认）。default: false

sort_typestring

商品排序：general（综合，默认）、sales_descending（销量降序）、price_ascending（价格升序）、price_descending（价格降序）。one of general · sales_descending · price_ascending · price_descendingdefault: general

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

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

Parameters* required

product_id*string

抖音商品 ID；用户已提供完整 ID 时原样使用，无需先搜索；否则可从 douyin_search_products 返回的 items[*].product_id 原样复制；不要传 sku_id、商品链接或搜索词。

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

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

Parameters* required

url*string

抖音商品短链接、商品页面链接或包含商品链接的分享文案；不要传 product_id、sku_id 或搜索词。

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

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

No parameters. Call it with no arguments.

Details

Categories: Search & Web Crawling, Media & Entertainment
Transport: HTTP
Auth: Required
Registry: MCP registry, active
Resources: 2
Tools verified: Nov 6, 2026

Related Search & Web Crawling MCP servers

View all

SocialDataX 快手 Kuaishou MCPcom.52choujiang/kuaishou-insightsKuaishou hot, suggestions, video/user search, details, comments/replies, profiles/posts, transcript.0stars

Admit Coach — College Search & Costscom.admit-coach/university-dataSearch US colleges and compare historical admissions, costs and aid using public federal data.0stars

Jobscom.alleskralle/jobsJob search engine with 500k+ listings across Austria, Germany and Switzerland (alleskralle.com).0stars

Nursing Home Databasejmtroller/nhd-mcp-public-documentationMCP server for US nursing facility search and ownership lookup (NursingHomeDatabase).0stars

BLS Employment & Wagescom.olyport/blsUnemployment rates, labor force, and Consumer Price Index from the Bureau of Labor Statistics0stars

Shepherd Bible APIcom.simplecohortllc.bible/shepherd-bible-apiBible translations, books, chapters, verses, and search0stars

SocialDataX 抖音 Douyin MCP

Install

Tools

Details

More from 52choujiang

Related Search & Web Crawling MCP servers