--- name: douyin-content-engineer description: 抖音内容引擎 — AI驱动的内容电商助手。覆盖带货视频分析、竞品账号分析、抖音爆款视频挖掘、短视频爆款逻辑分析。提供4个能力：①关键词搜索（可按点赞/最新排序、时间窗、时长、图文类型筛选）②博主主页作品抓取 ③视频/图文评论抓取 ④实时热榜。输出结构化 JSON（含作者、互动数据、标签、链接）。当用户需要搜抖音视频、抓博主作品、看抖音评论、查抖音热榜、做竞品/对标账号监控、短视频选题调研、评论舆情分析、热点追踪、爆款挖掘时使用。触发词：抖音搜索、抖音热榜、抖音评论、抖音作品、博主作品、对标账号、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点、舆情监控、热点追踪、爆款挖掘、douyin search、douyin content、douyin post、douyin hot search、douyin comments。 license: MIT version: "1.4.0" metadata: display-name: 抖音搜索·作品·评论·热榜 openclaw: emoji: "🎬" primaryEnv: GUAIKEI_API_TOKEN requires: bins: - node env: - GUAIKEI_API_TOKEN enabled: true runtime: "nodejs@16.14.0+" env_desc: GUAIKEI_API_TOKEN: "抖音数据 API 访问令牌。未配置时无法调用接口；可通过 https://www.guaikei.com 开通，或联系开发者(wx 13395823479)获取支持。" keywords: - "抖音" - "抖音搜索" - "抖音热搜" - "抖音热榜" - "抖音评论" - "博主作品" - "对标账号" - "短视频数据分析" - "douyin" - "douyin search" - "douyin hot" - "douyin comments" category: - "数据分析" - "内容创作" - "Data&APIs" tags: - "抖音" - "抖音搜索" - "抖音热搜" - "抖音热榜" - "抖音评论" - "抖音作品" - "博主主页" - "对标账号" - "选题" - "竞品分析" - "舆情监控" - "短视频运营" - "短视频" - "舆情监控" - "热点追踪" - "爆款挖掘" - "营销分析" - "douyin" - "douyin-search" - "douyin-hot" - "douyin-comments" - "content-analysis" - "competitor-analysis" - "marketing" - "trend-tracking" schemas: - name: "输出信封" file: "assets/output_envelope.schema.json" - name: "搜索入参" file: "assets/search_cli_req.schema.json" - name: "搜索出参" file: "assets/search_cli_resp.schema.json" - name: "作品入参" file: "assets/post_cli_req.schema.json" - name: "作品出参" file: "assets/post_cli_resp.schema.json" - name: "热榜出参" file: "assets/hot_cli_resp.schema.json" - name: "评论入参" file: "assets/comment_cli_req.schema.json" - name: "评论出参" file: "assets/comment_cli_resp.schema.json" examples: - '抖音上"AI 教程"最火的视频 → node src/douyin/search-cli.js --keyword "AI 教程" --sort 1' - '最近一周关于"AI 模型"的最新内容，要 20 条 → node src/douyin/search-cli.js --keyword "AI 模型" --sort 2 --time 7 --limit 20' - "今天抖音有什么热点 / 热搜榜 → node src/douyin/hot-cli.js" - '这个博主最近 30 条作品 → node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 30' - '看看这个对标账号多少粉丝、多少获赞 → node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 0' - '这条视频的评论区都在说什么 → node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 40' - '帮我找 1 分钟以内的减肥短视频，先来 50 条 → node src/douyin/search-cli.js --keyword "减肥" --duration 1 --limit 50' - '半年内最火的 AI 教程图文 → node src/douyin/search-cli.js --keyword "AI 教程" --sort 1 --time 180 --content 2' --- # 🚀 抖音内容引擎 - 抖音关键词搜索、竞品分析、舆情监控与热榜跟踪工具 提炼自实战内容创作经验，适用于抖音、小红书等短视频/图文平台的选题策划与标题创作。支持**关键词搜索排序**、**博主作品抓取**、**视频/图文评论抓取**、**实时热榜获取**，输出结构化 JSON，适用于短视频选题、竞品监控、舆情分析、热点追踪。 ## 1. ⚠️ 执行前置清单（每次执行前必须过一遍，缺一不可） 1. **先 `cd` 到本 SKILL.md 所在目录**，再执行下面的 `node src/douyin/*.js` 命令。 2. **确认环境变量 `GUAIKEI_API_TOKEN` 已配置且有效**。未配置 → 不执行命令，直接走 §8 的 `AUTH_REQUIRED` 话术，禁止先跑一遍"试试看"。 3. **一次只跑一条命令，跑完等它自己结束**。单条查询一般几十秒到 2 分钟，`--limit` 很大时最长约 15–22 分钟。**进程未退出前不要判定失败，不要并发或重复发起同一条命令。** 4. **必填参数不齐就先追问**（见 §9），禁止猜测关键词或链接。 ## 2. 💎 价值与典型场景（10 秒判断该不该用） | 你是谁 | 你要做的事 | 用哪个命令 | | ----------- | -------------------------------- | ------------------------ | | 短视频运营 | 找爆款选题、看高赞内容的共同点 | `search-cli.js --sort 1` | | 品牌 / 投放 | 监控对标账号的发文节奏与内容策略 | `post-cli.js` | | 舆情 / 客服 | 判断一条视频的评论区在骂还是在夸 | `comment-cli.js` | | 所有人 | 今天抖音在火什么，追热点 | `hot-cli.js` | **典型产出**：结构化 JSON（标题、作者、点赞/评论/收藏/分享、标签、链接、发布时间），可直接导入 Excel / BI，或交给 AI 生成选题库、竞品对比表、舆情周报。结果还会自动落盘到技能目录的 `logs/` 下便于复盘。 **为什么用它而不是自己爬**：无需登录抖音账号，无风控封号风险；零第三方依赖，Node.js 内置模块直接跑；单次最多 1 万条；stdout 纯 JSON、日志走 stderr，AI 可直接解析。 > **合规前置**：调用本技能会把用户提供的关键词/链接发送至第三方数据 API（域名 `www.guaikei.com`）以换取结果。本技能不上传本地文件、不登录账号、无任何写操作（不发布/点赞/评论/关注）。仅处理抖音公开数据，数据仅限个人/团队内部分析。 ## 3. 🎯 识别卡（选命令，命中即停） | 用户要什么 | 命令 | 最少要有 | | ---------------------------------- | -------------------------------- | --------------------- | | 搜视频/图文、爆款、选题 | `node src/douyin/search-cli.js` | `--keyword` | | 博主作品、主页、对标账号、粉丝数据 | `node src/douyin/post-cli.js` | 主页链接或 `sec_uid` | | 某条视频/图文的评论 | `node src/douyin/comment-cli.js` | 视频链接或 `aweme_id` | | 热搜、热榜、今天什么火 | `node src/douyin/hot-cli.js` | 无参数 | ## 4. 🛠️ 命令与参数 > 完整取值含义见 `references/options.md`（**仅在需要确认枚举含义时才读取**，不要每次都读）。 ### 4.1 关键词搜索 `search-cli.js` | 参数 | 缩写 | 必填 | 取值 | 默认 | | ------------ | ---- | ---- | ---------------------------------------------- | ---- | | `--keyword` | `-k` | ✅ | 2–50 个字符，不能是链接，不含 `< > " ' &` | — | | `--sort` | `-s` | | 0 综合 / 1 最多点赞 / 2 最新发布 | 0 | | `--time` | `-t` | | 0 全部 / 1 一天内 / 7 七天内 / 180 半年内 | 0 | | `--duration` | `-d` | | 0 不限 / 1 1分钟以下 / 2 1-5分钟 / 3 5分钟以上 | 0 | | `--content` | `-c` | | 0 不限 / 1 视频 / 2 图文 | 0 | | `--limit` | `-l` | | 1–10000 | 10 | **数量约定**：未指定 `--limit` 时只返回 10 条。用户说"全部/越多越好"再显式设 `--limit`，不要自作主张抓 10000 条。 ### 4.2 博主作品 `post-cli.js` | 参数 | 缩写 | 必填 | 取值 | 默认 | | --------- | ---- | ---- | ------------------------------------------------------------------------------ | ---- | | `--url` | `-u` | ✅ | `douyin.com/user/xxx`、`v.douyin.com/xxx` 短链，或 `sec_uid`（`MS4wLjA` 开头） | — | | `--limit` | `-l` | | 0–10000，**`0` = 只取博主互动数据**（关注数、粉丝数、总获赞） | 10 | 成功时 `results` 是**对象**，含 `post`（作品数组）和 `user`（博主信息）。 ### 4.3 视频评论 `comment-cli.js` | 参数 | 缩写 | 必填 | 取值 | 默认 | | --------- | ---- | ---- | -------------------------------------------------------------------------------------- | ---- | | `--url` | `-u` | ✅ | `douyin.com/video/xxx`、`douyin.com/note/xxx`、`v.douyin.com/xxx`，或纯数字 `aweme_id` | — | | `--limit` | `-l` | | 1–10000 | 10 | ### 4.4 实时热榜 `hot-cli.js` 不接受任何参数，直接 `node src/douyin/hot-cli.js`。返回约 50 条。 ## 5. 🔀 意图路由决策树（按顺序判断，命中即停） ``` 1. 提到"热榜/热搜/热点/今天什么火/榜单" → hot-cli.js（无参数） 2. 提到"评论/留言"且指向某个视频 → comment-cli.js（需视频链接或 aweme_id） 3. 提到"作品/主页/账号/博主/对标账号" → post-cli.js（需主页链接或 sec_uid） 4. 有关键词且无 1/2/3 的信号 → search-cli.js（需关键词） 5. 以上都不明确 → 先追问（§9），禁止猜测执行 ``` > ⚠️ 消歧规则：单独出现"视频"二字**不要默认归 post**。有关键词且无"评论" → search；"这个视频的评论/留言" → comment；只有出现"作品/主页/账号/博主"才用 post。 > ⚠️ 链接类型冲突：`/user/` 链接只能给 post，`/video/`、`/note/` 链接只能给 comment，传错会得到 `INVALID_URL`，此时请用户确认他要的是作品还是评论。 ## 6. 🗣️ 自然语言 → 命令映射（执行前对照） | 用户口语 | 命令 | 参数推导 | | ------------------------------- | -------------------------------------------- | --------------------------- | | "搜一下 AI 相关的视频" | `--keyword "AI"` | 带关键词即搜索 | | "找点赞最多的 / 最火的 AI 视频" | `--keyword "AI" --sort 1` | 最火/点赞最多 → sort=1 | | "最新的 AI 教程，要 20 条" | `--keyword "AI 教程" --sort 2 --limit 20` | 最新 → sort=2；数量 → limit | | "近一周最火的短视频" | `--keyword "短视频" --time 7 --sort 1` | 一周 → time=7 | | "半年内最火的 AI 教程" | `--keyword "AI 教程" --sort 1 --time 180` | 半年 → time=180 | | "减肥视频，只要 1 分钟以下的" | `--keyword "减肥" --duration 1` | 1分钟以下 → duration=1 | | "AI 模型的图文内容，前 50 条" | `--keyword "AI 模型" --content 2 --limit 50` | 图文 → content=2 | | "看看这个博主最近发了啥" | `post-cli.js --url <主页链接> --limit 20` | 未说条数 → 默认 10，可问 | | "他多少粉丝" | `post-cli.js --url <主页链接> --limit 0` | 只要互动数据 → limit=0 | | "这条视频评论区在骂什么" | `comment-cli.js --url <视频链接> --limit 40` | 舆情场景 → 适当加大 limit | ## 7. 📜 输出契约 stdout 只有一份统一信封（成功 / 空结果 / 错误结构相同）： ```json { "status": "success | empty | error", "error_code": "OK | NO_MATCH | INVALID_KEYWORD | INVALID_URL | INVALID_ARGS | AUTH_REQUIRED | AUTH_ERROR | TIMEOUT | NETWORK_ERROR | HTTP_5xx | ...", "message": "人类可读的说明", "timestamp": "2026/10/20 21:30:00", "request": { "command": "search", "keyword": "AI 教程", "sort": 1, "limit": 20 }, "metadata": { "skill_version": "1.4.0", "runtime_version": "22.x", "execution_time": 34210 }, "results": [ { "aweme_id": "7xxx", "desc": "…", "author_nickname": "…", "digg_count": 123456, "url": "…", "create_time_str": "2026/9/4 20:13:20" } ] } ``` - `status=error` 时 `results` 为 `null`，原因看 `error_code` + `message`。 - 信封字段见 `assets/output_envelope.schema.json`。搜索、评论、热榜成功时 `results` 是数组。作品成功时 `results` 是对象，包含 `post`（作品数组）和 `user`（博主信息）。条目字段见 `assets/*_cli_resp.schema.json`； - **向用户汇报时只摘关键字段**（标题/作者/点赞/链接/时间），不要把整份 JSON 原样粘贴——单条结果含大量封面与播放 URL，会撑爆上下文。 - 适合衔接的后续动作：选题汇总、高赞对比、评论观点聚类、竞品内容风格总结、博主发文节奏分析、报告与表格生成。 ## 8. 🚨 退出码与错误码 → Agent 应对 | error_code | 退出码 | 含义 | Agent 必须做什么 | | ------------------------------ | ------ | -------------------------------------- | ------------------------------------------------------------------------------- | | `AUTH_REQUIRED` / `AUTH_ERROR` | 3 | token 未配置 / 无效或过期 | **禁止重试**。引导到 https://www.guaikei.com 自助开通并配置 `GUAIKEI_API_TOKEN` | | `INVALID_KEYWORD` | 1 | 关键词不合法（长度/是链接/含特殊符号） | 转述 `message`，请用户换词；**禁止自动改词重试** | | `INVALID_URL` | 1 | 无法识别链接或 ID，或链接类型传错 | 请用户提供：主页链接（post）或视频/图文链接（comment） | | `INVALID_ARGS` | 2 | 参数解析失败，或枚举/范围越界 | 按 `--help` 修正后重试**一次**；**禁止改成默认值后自动再跑** | | `NO_MATCH`（status=empty） | 0 | 无结果，**不是失败** | 如实告知；可建议放宽（`--time 0`、换更常用词），**经用户同意后**再试 | | `TIMEOUT` / `NETWORK_ERROR` | 1 | 超时/网络错误 | 可告知用户后重试，**最多 1 次** | | `HTTP_5xx` / 其他 | 1 | 服务端或未知错误 | 如实报告 `message`，不编造原因，不反复重试 | ## 9. 🛑 硬性禁止条款 - 不得编造数据；不得把空结果说成有结果。 - 不得在未征得用户同意的情况下自动修改搜索条件重试。 - `AUTH_REQUIRED` / `AUTH_ERROR` 后不得重试。 - 不得把 stderr 中的日志文案原样转述给用户（stderr 仅诊断用，对外只报 `message` 与关键参数）。 - 不得用本技能做登录态、私密数据获取或任何写操作。 - 不得在未 cd 到技能目录的情况下执行 `node src/douyin/*.js`。 ## 10. 🧠 追问模板（输入不足时使用） - 缺关键词：「你想搜索抖音里的什么内容？给我一个关键词，例如"AI 教程"。」 - 缺博主链接：「请提供博主主页链接（douyin.com/user/xxx 或 v.douyin.com 短链），或直接给 sec_uid。」 - 缺视频链接：「请提供视频或图文链接（douyin.com/video/xxx、douyin.com/note/xxx 或 v.douyin.com 短链）。」 - 链接类型不明：「你给的这个链接，是想看这个博主的作品，还是这条视频的评论？」 - 数量不明：「默认返回 10 条，需要更多的话告诉我具体条数。」 ## 11. 🔧 环境与合规 - 环境：Node.js 16.14.0+，Windows / Linux / macOS；必需环境变量 `GUAIKEI_API_TOKEN`。 - 配置方式：Windows cmd `set GUAIKEI_API_TOKEN=你的TOKEN`；Windows PowerShell `$env:GUAIKEI_API_TOKEN="你的TOKEN"`；Linux/macOS `export GUAIKEI_API_TOKEN=你的TOKEN`。令牌为 16–256 位字母、数字、下划线或连字符。 - 合规：仅处理抖音公开数据；调用会把关键词/链接发送至第三方 API（www.guaikei.com），使用前请确认数据外发与授权范围；数据仅限个人/团队内部分析，禁止违规分发。 - 更多帮助：[抖音内容引擎官网](https://www.guaikei.com)。 ## 12. ❓ 常见问题 - 没结果：放宽关键词或减少限定（`--time 0`），换更常用的词；空结果退出码是 0，属正常。 - 结果太多：补场景/人群/品牌/时间/账号，并控制 `--limit`。 - 调用失败：先看退出码——3 = token 问题；2 = 参数问题；1 = 关键词/链接/网络/服务端。 - 播放地址和分享链接有时效，过期后需要重新获取。 - 计费与单次上限以官网说明为准，技能侧上限为 10000 条/次。 - 账号安全：只读能力，不登录/不发布/不点赞/不评论，无封号风险。