Skill: um-why/douyin-search-keyword (version 1.1.3)

--- name: douyin-search-keyword description: 抖音公开数据智能分析工具。支持关键词搜索排序、抖人作品抓取、实时热榜获取，适用于短视频营销、竞品分析和热点监控，助力爆款内容策划与流量追踪。 version: 1.1.3 license: MIT metadata: openclaw: enabled: true type: command runtime: "nodejs@16.14.0+" requires: bins: - "node" env: - "GUAIKEI_API_TOKEN" category: - "Data&APIs" - "内容创作" tags: - "douyin" - "抖音" - "search" - "搜索" - "数据挖掘" - "content-analysis" - "营销分析" - "数据分析" - "competitor-analysis" - "竞品分析" - "热点追踪" - "marketing" - "trend-tracking" - "workflow" - "insight" - "automation" parameters: search-cli: keyword: {type: string, required: true, minLength: 2, maxLength: 50, alias: "k"} sort: {type: number, enum: [0, 1, 2], default: 0, desc: "0=综合/1=最多点赞/2=最新", alias: "s"} time: {type: number, enum: [0, 1, 7, 180], default: 0, desc: "0=全部/1=1天/7=7天/180=半年", alias: "t"} limit: {type: number, min:1, max:200, default:10, alias: "l"} output: {type: string, enum: ["json", "markdown"], default: "json", alias: "o"} post-cli: url: {type: string, required: true, desc: "创作者主页URL/sec_uid", alias: "u"} limit: {type: number, min:1, max:200, default:10, alias: "l"} examples: - name: 搜索"AI 教程"获取10条综合排序的抖音内容 command: 'node src/douyin/search-cli.js --keyword "AI 教程"' description: 快速获取关键词相关视频数据，助力内容创作灵感 - name: 搜索"AI"获取最多点赞的10条抖音内容 command: 'node src/douyin/search-cli.js --keyword "AI" --sort 1' description: 挖掘爆款视频特征，优化内容策略 - name: 获取近7天"AI 模型"的抖音内容 command: 'node src/douyin/search-cli.js --keyword "AI 模型" --time 7' description: 追踪近期热点趋势，把握内容窗口期 - name: 获取半年内最新20条"AI 教程"的抖音内容 command: 'node src/douyin/search-cli.js --keyword "AI 教程" --sort 2 --time 180 --limit 20' description: 监控长期内容趋势，制定内容规划 - name: 获取抖人 MS4wLjABxxx 已发布的作品 command: 'node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx"' description: 获取抖人已发布的作品，助力竞品分析 - name: 获取抖音实时热搜榜单 command: "node src/douyin/hot-cli.js" description: 实时掌握平台热点，快速响应热门话题 --- # 🚀 抖音关键词搜索、竞品分析与热榜监控工具 (Douyin Search & Analytics) > **💡一句话价值**：一键抓取抖音公开视频/作者/热榜数据，帮你做爆款选题、竞品分析、热点追踪。 > > **🔥核心优势** > > - 轻量: 无需部署服务，Node.js 一键运行 > - 灵活: 支持多维度筛选、批量操作、多格式导出 > - 实用: 日志自动归档，适配营销报告 / 内容策划场景 > - 安全: 无需登录你的抖音账号，不担心风控风险 / 封号问题 ## 1. ✅ 我能帮你解决什么（10 秒判断） - 🔍 按关键词搜抖音视频（点赞/最新排序）：找爆款选题、分析高赞视频规律 - 🦸 竞品监控：批量抓取对标账号所有公开作品数据，分析内容策略 - 📡 热点追流：实时获取抖音热榜，抢占流量风口 - 📊 数据导出：自动生成JSON日志，方便二次使用 ## 2. 🚀 最快上手（复制就能跑，30 秒出结果） > **Note:** 请先通过微信 <13395823479> 申请 API TOKEN，配置环境变量 `GUAIKEI_API_TOKEN` 后才能正常运行。 ### 2.1 🔎 抖音关键词搜索（最简单） ```bash node src/douyin/search-cli.js AI ``` ### 2.2 🔎 按点赞排序找爆款（最常用） ```bash node src/douyin/search-cli.js --keyword "AI" --sort 1 ``` ### 2.3 🦸 抓取抖音抖人全部作品 ```bash node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" ``` ### 2.4 📡 获取抖音实时热榜 ```bash node src/douyin/hot-cli.js ``` ## 3. 📌 适用场景（我该不该用？） - 你需要做短视频选题 → 关键词搜索 + 点赞排序 - 你需要模仿爆款文案 → 查看高赞视频详情 - 你需要监控竞品账号 → 批量抓取对方作品 - 你需要快速追热点 → 实时获取抖音热榜 - 你需要做营销报告 → 导出结构化数据 ## 4. 🔧 参数详解表 ### 🔎 抖音关键词搜索 | 参数 | 缩写 | 作用 | 可选值 | 必填 | | :---------- | :--: | :--------- | :------------------------------------------ | :--: | | `--keyword` | `-k` | 搜索关键词 | 2-50 个汉字 | 是 | | `--sort` | `-s` | 排序方式 | 0 = 综合 / 1 = 点赞 / 2 = 最新 | 否 | | `--time` | `-t` | 时间范围 | 0 = 全部 / 1 = 1 天 / 7 = 7 天 / 180 = 半年 | 否 | | `--limit` | `-l` | 获取数量 | 1-200 条 | 否 | | `--output` | `-o` | 输出格式 | json / markdown | 否 | ### 🦸 抖音抖人作品获取 | 参数 | 缩写 | 类型 | 说明 | | :-------- | :--- | :----- | :------------------------- | | `--url` | `-u` | 字符串 | 必填，抖人主页URL或sec_uid | | `--limit` | `-l` | 1-200 | 获取作品数量 (默认10) | > **💡"抖人主页URL"说明** > > - PC端 ( 格式：<https://www.douyin.com/user/MS4wLjABxxx> ) > - 移动端 ( 格式：<https://v.douyin.com/xxx> ) > - 本技能关键词搜索返回的author_sec_uid字段 ## 5. ⚠️ 重要限制（不踩坑） - 仅抓取抖音公开数据，不支持私密 / 隐藏内容 - 需要配置 GUAIKEI_API_TOKEN 才能正常运行 - 数据仅限个人 / 团队内部使用，禁止违规分发 ## 6. ❓ 常见问题（秒解决） > **💡Q：运行报错，提示无权限？** > > A：先配置环境变量：`set GUAIKEI_API_TOKEN=你的TOKEN` > > - 私有TOKEN申请后请留意使用安全，避免泄露给他人 > > **💡Q：搜索结果为空？** > > A：换常用关键词，或把 `--time` 改为 0（全部时间） > > **💡Q：输出文件在哪里？** > > A：自动保存在技能目录的 `logs` 文件夹下 > > - 搜索任务日志: 默认保存为「时间戳_关键词_排序_时间_search.json」 > - 抖人作品获取日志: 默认保存为「时间戳_(抖人author_sec_uid)_post.json」 > > **💡Q：支持 Windows/Mac/Linux 吗？** > > A：全平台支持，仅需安装 Node.js 环境 ## 7. 📞 帮助与支持 TOKEN 申请 / 使用问题：微信 13395823479（备注抖音技能）


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)