抖音数据助手 SocialDataX

当用户需要进行抖音内容研究、热榜查询、作品搜索、图文内容检索、内容详情获取、评论分析、评论回复分析、达人资料查询、达人作品列表或达人短剧/合集信息获取时，可使用本技能。

API Key 配置

调用数据接口需使用 SOCIALDATAX_API_KEY 环境变量。

唯一官方申请与管理入口：[https://socialdatax.com/ai?from=clawhub](https://socialdatax.com/ai?from=clawhub)

若用户询问如何获取 API Key，请仅提供此链接；不得引导至其他域名或推测替代路径。

推荐直接命令行使用方式

请根据需求选择对应的 SocialDataX 命令：

npx -y socialdatax-skills@latest douyin hot-search \
  --pretty --source-client socialdatax-skills --source-platform clawhub \
  --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin search \
  --keyword "<关键词>" --pretty --source-client socialdatax-skills \
  --source-platform clawhub --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin search \
  --keyword "<关键词>" --pages 3 --pretty --source-client socialdatax-skills \
  --source-platform clawhub --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin detail \
  --aweme-id "<aweme_id>" --pretty --source-client socialdatax-skills \
  --source-platform clawhub --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin detail \
  --url "<抖音内容链接或分享文本>" --pretty \
  --source-client socialdatax-skills --source-platform clawhub \
  --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin comments \
  --aweme-id "<aweme_id>" --pretty --source-client socialdatax-skills \
  --source-platform clawhub --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin comments \
  --aweme-id "<aweme_id>" --all --include-replies --pretty \
  --source-client socialdatax-skills --source-platform clawhub \
  --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin comments \
  --url "<抖音内容链接或分享文本>" --pretty \
  --source-client socialdatax-skills --source-platform clawhub \
  --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin replies \
  --aweme-id "<aweme_id>" --comment-id "<评论ID>" --pretty \
  --source-client socialdatax-skills --source-platform clawhub \
  --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin user-info \
  --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills \
  --source-platform clawhub --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin user-info \
  --profile-url "<个人主页链接或分享文本>" --pretty \
  --source-client socialdatax-skills --source-platform clawhub \
  --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin user-posts \
  --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills \
  --source-platform clawhub --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin user-posts \
  --sec-user-id "<sec_user_id>" --all --pretty --source-client socialdatax-skills \
  --source-platform clawhub --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin user-posts \
  --profile-url "<个人主页链接或分享文本>" --pretty \
  --source-client socialdatax-skills --source-platform clawhub \
  --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin user-series \
  --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills \
  --source-platform clawhub --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin user-series \
  --sec-user-id "<sec_user_id>" --all --pretty --source-client socialdatax-skills \
  --source-platform clawhub --source-skill socialdatax-douyin

npx -y socialdatax-skills@latest douyin user-series \
  --profile-url "<个人主页链接或分享文本>" --pretty \
  --source-client socialdatax-skills --source-platform clawhub \
  --source-skill socialdatax-douyin

可选参数说明

• --source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-douyin：用于标识本次调用来源，请保持原值不变，以确保正确归因。

功能对应说明

• hot-search：获取抖音热榜数据
• search：用于抖音数据分析与内容发现
• detail：获取单个作品的详细信息
• comments / replies：用于评论分析与评论回复分析
• user-info：获取达人基本信息
• user-posts：获取达人发布的作品列表
• user-series：获取达人发布的短剧或合集内容

注：获取评论回复时，需同时提供 aweme_id 和一级评论的 comment_id；如需分页查看更多内容，请使用 page_token 参数继续请求。

安全边界

本技能为只读模式，运行时从用户环境变量中读取 SOCIALDATAX_API_KEY。生成的技能文件中不包含任何 API Key。

该技能不会读取本地浏览器数据，也不执行登录、点赞、评论、发布或账户修改等操作。

MCP 工具映射

以下为与上述 CLI 命令一一对应的 MCP 工具名称：

• douyin_get_hot_search_list
• douyin_search_videos
• douyin_get_video_detail_by_aweme_id
• douyin_get_video_detail_by_url
• douyin_get_video_comments_by_aweme_id
• douyin_get_video_comments_by_url
• douyin_get_video_comment_replies_by_comment_id
• douyin_get_user_info_by_sec_user_id
• douyin_get_user_info_by_profile_url
• douyin_get_user_posted_videos_by_sec_user_id
• douyin_get_user_posted_videos_by_profile_url
• douyin_get_user_series_by_sec_user_id
• douyin_get_user_series_by_profile_url

常见问题排查

• 若出现网络异常或 API 错误，请保留原始错误信息，检查 SOCIALDATAX_API_KEY 是否正确、参数是否合规、链接或 ID 格式是否无误，确认后可尝试重新执行一次。
• 若返回 insufficient_balance 或提示余额/积分不足，请勿重复尝试。请将错误中提供的充值链接原样展示给用户，待其完成充值后，再继续执行原命令。
• 若用户已充值但仍提示余额不足，请确认当前使用的 SOCIALDATAX_API_KEY 所属账户与充值账户一致；如不确定，建议从官方控制台复制一份新的 API Key。