向善数据抖音 API

要解决什么问题

做抖音相关的数据分析或竞品调研时，你往往需要从用户主页、单条视频或关键词拿到结构化数据：粉丝与简介、作品列表、点赞评论、以及很多接口并不返回的播放量。手工在 App 里翻页复制既慢，也难和脚本、报表流水线对接。本技能把 向善数据 的抖音 API 封装成「按意图选接口」的助手流程，减少你在文档里来回查路径和参数。

技能如何工作

技能以 https://api.xsdata.top 为基址，在请求 Header 中携带 x-api-key（优先读环境变量 XS_API_KEY，未配置时再向用户索取）。根据你的描述自动匹配七类能力：

• 用户侧：fetch-user-video-list（主页视频列表，支持 count / max_cursor）、fetch-user-data（粉丝数、简介等资料）
• 视频侧：fetch-video-detail（作品详情）、fetch-video-comment（一级评论与翻页）、fetch-video-statistics（播放数及点赞、下载、分享等统计）
• 搜索：search-user（昵称/抖音号）、search-video（关键词，可选排序、发布时间、时长筛选）

输入解析有固定规则：抖音短链 https://v.douyin.com/... 作为 share_text；纯数字作 aweme_id；以 MS4wLjAB 开头的字符串作 sec_user_id；只有昵称时先搜用户再拉资料。执行路径大致为：判断意图 → 选接口 → 补齐参数 → 发请求 → 提炼关键字段展示，并提示是否翻页、看评论或进详情。

适用边界与注意点

• 每次调用都会消耗平台 API 积分，发起前应心里有数。
• 返回体可能很大，技能会侧重展示你关心的字段，而不是整包 dump。
• search-user 的 raw_data 是 JSON 字符串，需要二次解析。
• 若你明确要播放量，应走统计接口；其它视频详情接口不保证带 play_count。