guaikei-douyin-raw-to-structured-pipeline

4 项能力 × 5 维筛选 × 1 个上限：抖音关键词搜索（排序/时间/时长/内容类型/条数）、博主作品批量抓取、视频评论获取、实时热榜查询，单次最多 10000 条。用户提抖音搜索/热榜/评论/博主/竞品/选题/舆情时触发，其他平台不适用。

1. 🛠️ 技能概述

抖音公开数据获取与智能分析工具。支持关键词搜索排序、博主作品抓取、视频评论分析、实时热榜获取，适用于短视频选题、竞品监控、舆情分析、热点追踪，助力爆款内容策划与流量运营。

🔥核心优势

• 安全：无需登录抖音账号，无风控 / 封号风险
• 强大：单次最多可获取 1W 条数据，内置批量与多维筛选
• 全面：出参覆盖作者、互动、标签、链接等可用数据及有价值数据都会返回
• 轻量：无需部署服务，Node.js 一键运行，仅依赖内置模块
• 友好：stdout 纯 JSON、日志走 stderr，便于 AI 稳定解析与二次分析

2. ✅ 何时调用与能力边界

🎯 在以下场景优先调用：

• 用户明确要查 抖音 的公开内容（视频 / 图文 / 作者 / 评论 / 热榜）。
• 用户要做 关键词搜索、爆款选题调研、竞品监控、评论洞察、博主作品追踪、热点追流。
• 用户提供了抖音关键词、视频链接、博主主页链接，希望拿到结构化数据。
• 用户后续还要基于结果做总结、对比、筛选、报告生成。

🚫 不应调用

• 用户只想要文案/标题/脚本，未要求查抖音数据。
• 平台不是抖音（小红书、B站、微博、公众号）→ 路由到对应技能。
• 要求私密/登录态/隐藏数据。
• 既无关键词也无可识别抖音链接且目标不明 → 先追问。

意图不明确时先追问，不要盲目执行命令。

🛑 本技能不需要、不负责：

登录账号、发布/点赞/评论/关注等写操作、获取非公开数据、替用户做营销策略判断。职责是先把数据拿回来，再交上层分析。

3. 🔀 调用路由

Note: 请先通过 抖音数据获取技能官网 开通并配置环境变量 GUAIKEI_API_TOKEN 后，再按意图路由：

意图	脚本	必填	典型结果
搜关键词内容	src/douyin/search-cli.js	keyword	视频/图文列表、作者、互动、链接
看热搜/热点/榜单	src/douyin/hot-cli.js	无	热榜词条、热度、搜索量
看博主最近作品	src/douyin/post-cli.js	主页 URL 或 sec_uid	博主公开作品列表
看视频/图文评论	src/douyin/comment-cli.js	视频 URL 或 aweme_id	评论内容、评论者、互动

🧭 消歧义（重要）

• 单独出现"视频"二字时，不要默认归 post。
• 有"关键词"且无"评论" → search（用户想搜某个视频）。
• "这个视频的评论/留言" → comment。
• 仅当"作品/主页/账号/博主"出现时才用 post。

4. 🧺 输入收集规则

执行前先收集足够输入，避免无效调用。

4.1 🔍 关键词搜索（search-cli）

至少要确认：keyword（2-50 字符）。可选：

• sort：0 综合 / 1 最多点赞 / 2 最新发布
• time：0 全部 / 1 一天内 / 7 七天内 / 180 半年内
• duration：0 不限 / 1 1分钟内 / 2 1-5分钟 / 3 5分钟以上
• content：0 不限 / 1 视频 / 2 图文
• limit：1-10000，默认 10

4.2 📡 博主作品（post-cli）

至少要确认：url（主页 URL 或 sec_uid）。可选：limit（1-10000，默认 10）。 适用链接：https://www.douyin.com/user/MS4wLjABxxx、https://v.douyin.com/xxx、或直接使用 sec_uid。

4.3 💬 评论分析（comment-cli）

至少要确认：url（视频 / 图文 URL 或 aweme_id）。可选：limit（1-10000，默认 10）。 适用链接：https://www.douyin.com/video/xxx、https://www.douyin.com/note/xxx、或直接使用 aweme_id。

5. 📜 执行与输出约定

• 在技能根目录执行；只输出纯 JSON 到 stdout，日志/banner 走 stderr。
• 没有关键词：先追问关键词。
• 没有链接：先追问视频 / 主页链接或 ID。
• 链接类型不明确：先确认这是视频还是博主主页。
• 没有 GUAIKEI_API_TOKEN：提醒用户先配置环境变量，再执行。
• 退出码：0=成功（含 empty），1=运行错误（接口异常/网络/超时），3=auth_required（缺/错 token）。
• 失败须向用户说明原因，不编造数据，不把空结果当成功。空结果退出码 0 属正常。
• 完整选项见 可参阅 完整选项说明 ；LLM理解技能的详细选项，可参阅技能 assets 目录中文件。
• 执行完成后，优先返回：本次目标、关键参数、结构化 JSON 结果，必要时再补一小段摘要。
• 适合衔接的后续动作：选题汇总、高赞对比、评论观点聚类、竞品内容风格总结、博主发文节奏分析、报告与表格生成。

6. 💡 调用示例

bash

node src/douyin/search-cli.js --keyword "AI 教程" --sort 1
node src/douyin/search-cli.js --keyword "AI模型" --sort 2 --time 7 --limit 20
node src/douyin/hot-cli.js
node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 50
node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 100

• 🤖 自然语言触发示例："帮我搜抖音里'AI 教程'最火的视频""抖音今天有什么热点""分析这条抖音视频评论区的主要观点"。
• 🧠 若用户表达笼统（如"帮我做抖音竞品分析"），优先拆成两步：① 确认关键词 / 竞品链接 / 博主主页；② 再调用对应脚本拿回数据。

7. 🎧 环境、合规与支持

• 环境：Node.js 16.14.0+，兼容 Windows/Linux/macOS；必需 GUAIKEI_API_TOKEN；官网 https://www.guaikei.com。
• 合规：仅处理抖音公开数据，不支持私密/隐藏/登录态数据；数据仅限个人/团队内部分析，禁止违规分发；依赖第三方 API（guaikei.com），使用前确认数据外发与授权范围。
• 支持：官网 <抖音数据获取技能官网>（自助开通 TOKEN）；微信 13395823479（备注：抖音技能）。

8. ❓ 常见问题

• 没结果：放宽关键词或减少限定（--time 0）、换更贴近的词。
• 结果太多：补场景/人群/品牌/时间/账号。
• 调用失败：先确认 GUAIKEI_API_TOKEN 已配置有效（退出码 3 即 token 问题）。
• 账号安全：只读能力，不登录/发帖/点赞/评论。