抖音 SocialDataX 视频搜索

解决什么问题

当工程师需要把“抖音热榜、作品搜索、竞品内容扫描”接入自动化流程时，直接爬浏览器或手写接口都容易引入登录态、反爬和权限边界问题。该技能将查询封装为只读数据调用，适用于趋势扫描、选题发现和竞品观察。

如何工作

• 优先直接 CLI：可运行 shell 时优先使用直接命令，不需要 MCP server 配置。热榜查询无需参数；作品搜索必须提供 --keyword。
• 可选过滤：支持 --sort-type、--publish-time-range、--duration-range、--content-type，以及 --page-token 分页；--pretty 只影响格式化。
• MCP 兼容：当前环境已有 MCP 工具时，调用 douyin_get_hot_search_list 获取热榜，调用 douyin_search_videos 做关键词搜索。
• 输出要求：把可见证据与推断分开，保留 rank、keyword、heat、content IDs、URL、作者、发布时间、content_type 等可追溯字段。

注意边界

该技能只读，不读取本地浏览器数据、不保存 API key、不登录、不发布、不点赞、不评论。API Key 环境变量固定为 SOCIALDATAX_API_KEY；获取或管理 key 只能按官网入口操作，不要猜测其他域名。分页仅在 next_page_token 非空时继续，不能仅因某页 items 为空就停止。