AGENT SKILL

douyin-search-keyword

抖音公开内容智能搜索,精准检索视频/图文/用户数据,支持多维度排序与时间筛选,输出结构化JSON/Markdown,助力短视频营销、竞品分析与热点追踪。

License 许可
MIT
所属仓库
bg-szy/TOP-SKILLS
最近更新
2026-11-15
Stars
★ 6
Forks
0

01 前言 Front Matter

name
douyin-search-keyword
license
MIT
version
1.1.1
metadata
{ "openclaw": { "tags": [ "douyin", "search", "crawler", "data-mining", "social-media" ], "type": "command", "safety": [ "内置敏感/违规关键词检测拦截机制", "仅采集公开数据,不存储/泄露用户隐私信息", "完全符合OpenClaw安全规范与数据采集合规要求", "环境变量TOKEN校验,默认TOKEN仅用于体验(效率/频率受限)" ], "enabled": true, "runtime": "nodejs@16+", "examples": [ { "name": "基础搜索", "command": "node scripts/search.js AI", "description": "搜索关键词\"AI\"的抖音内容,返回10条综合排序结果,JSON格式输出", "outputFormat": "json" }, { "name": "带空格的关键词搜索", "command": "node scripts/search.js \"AI 教程\"", "description": "搜索关键词\"AI 教程\"的抖音内容,返回10条综合排序结果", "outputFormat": "json" }, { "name": "按最多点赞排序搜索", "command": "node scripts/search.js AI --sort 1", "description": "搜索关键词\"AI\",返回10条最多点赞的抖音内容", "outputFormat": "json" }, { "name": "筛选近1天发布的内容", "command": "node scripts/search.js AI --time 1", "description": "搜索关键词\"AI\",返回近1天内发布的10条抖音内容", "outputFormat": "json" }, { "name": "自定义返回结果数量", "command": "node scripts/search.js AI --limit 20", "description": "搜索关键词\"AI\",返回20条综合排序的抖音内容", "outputFormat": "json" }, { "name": "Markdown格式输出", "command": "node scripts/search.js AI --output markdown", "description": "搜索关键词\"AI\",返回10条结果并以Markdown格式输出", "outputFormat": "markdown" }, { "name": "复杂多参数搜索", "command": "node scripts/search.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20", "description": "搜索关键词\"AI 教程\",返回半年内最新发布的20条抖音内容", "outputFormat": "json" } ], "requires": { "env": [ "GUAIKEI_API_TOKEN" ], "bins": [ "node" ], "permissions": [ "read:api-results", "write:local_logs" ] }, "arguments": [ { "name": "keyword", "type": "string", "required": true, "maxLength": 50, "minLength": 2, "description": "抖音搜索关键词(支持中文、英文、数字)" }, { "enum": [ 0, 1, 2 ], "name": "sort", "type": "number", "default": 0, "required": false, "description": "排序依据:0-综合排序(默认)、1-最多点赞、2-最新发布" }, { "enum": [ 0, 1, 7, 180 ], "name": "time", "type": "number", "default": 0, "required": false, "description": "发布时间筛选:0-全部(默认)、1-一天内、7-七天内、180-半年内" }, { "name": "limit", "type": "number", "default": 10, "maximum": 60, "minimum": 1, "required": false, "description": "返回结果数量,默认10条,最大60条" }, { "enum": [ "json", "markdown" ], "name": "output", "type": "string", "default": "json", "required": false, "description": "输出格式:json(默认)、markdown" } ], "entrypoint": "scripts/search.js", "limitations": [ "仅支持公开API返回的抖音数据,无权限获取私密内容", "仅提供视频/图片CDN链接,不支持直接下载(链接可能过期)", "结果返回可能因网络波动延迟,建议间隔>2秒调用", "关键词长度限制:2-50字符,禁止包含<>'&及HTTP链接", "返回结果数量限制:1-60 条", "API调用频率限制:2次/秒(超频率可能触发限流)" ], "performance": [ "平均响应时间:< 30 秒(网络良好)", "成功调用成功率:>95%", "支持并发调用(需私有TOKEN授权)", "创建任务超时时间:10秒/次,查询结果超时时间:5秒/次" ], "capabilities": [ "实时搜索抖音公开内容(视频/图文)", "提取内容标题、发布人、播放链接、互动数据(点赞/评论/收藏/分享)", "支持多关键词组合搜索(空格分隔)", "自定义排序(综合/最多点赞/最新发布)、发布时间范围(1天/7天/半年)", "自定义返回结果数量(1-60条)、输出格式(JSON/Markdown)", "结构化JSON输出(完全适配OpenClaw生态解析规范)", "内置超时控制+自动重试机制(创建任务3次重试、查询结果60次轮询)", "自动关键词清洗(过滤特殊字符)、参数合法性校验", "搜索结果本地文件持久化(保存至last-search.json)", "支持音乐信息、封面/图文URL提取" ], "outputFormat": { "default": "json", "terminal": [ "json", "markdown" ], "jsonFields": [ { "name": "status", "type": "string", "required": true, "description": "请求状态: success|empty|error" }, { "name": "keyword", "type": "string", "required": true, "description": "清洗后的搜索关键词" }, { "name": "results", "type": "array", "items": { "type": "object", "properties": [ { "name": "desc", "type": "string", "description": "内容标题/描述" }, { "name": "author_nickname", "type": "string", "description": "发布人昵称" }, { "name": "author_avatar", "type": "string", "description": "发布人头像URL" }, { "name": "comment_count", "type": "number", "description": "评论数" }, { "name": "digg_count", "type": "number", "description": "点赞数" }, { "name": "share_count", "type": "number", "description": "分享数" }, { "name": "collect_count", "type": "number", "description": "收藏数" }, { "name": "dynamic_cover", "type": "array", "items": { "type": "string", "description": "封面图片URL" }, "description": "动态封面URL列表" }, { "name": "play_addr", "type": "string", "description": "视频播放URL" }, { "name": "images", "type": "array", "items": { "type": "string", "description": "图片URL" }, "description": "图文内容URL列表" }, { "name": "tags", "type": "array", "items": { "type": "string", "description": "标签文本" }, "description": "内容标签列表" }, { "name": "url", "type": "string", "description": "抖音内容原生链接" }, { "name": "author_url", "type": "string", "description": "发布人主页链接" }, { "name": "create_time_str", "type": "string", "description": "发布时间(本地化字符串)" } ], "description": "单条抖音内容数据" }, "required": true, "description": "搜索结果列表(视频/图文)" }, { "name": "total", "type": "number", "description": "搜索结果总数" }, { "name": "timestamp", "type": "string", "required": true, "description": "搜索执行时间(本地化字符串)" }, { "name": "sort", "type": "number", "required": true, "description": "排序依据: 0-综合|1-最多点赞|2-最新发布" }, { "name": "time", "type": "number", "required": true, "description": "发布时间筛选: 0-全部|1-1天内|7-7天内|180-半年内" }, { "name": "limit", "type": "number", "required": true, "description": "请求返回结果数量" }, { "enum": [ "json", "markdown" ], "name": "output_format", "type": "string", "required": true, "description": "输出格式" }, { "name": "message", "type": "string", "required": true, "description": "提示信息或错误信息" }, { "name": "error_code", "type": "string", "description": "错误代码" } ] }, "schemaVersion": "1.1" } }
description
抖音公开内容智能搜索,精准检索视频/图文/用户数据,支持多维度排序与时间筛选,输出结构化JSON/Markdown,助力短视频营销、竞品分析与热点追踪。

02 资源文件 3

03 SKILL.md 正文

抖音搜索关键词技能 (Douyin Search Keyword)

1. 技能概述

1.1 核心定位

抖音公开内容智能搜索,精准检索视频/图文/用户数据,支持多维度排序与时间筛选,输出结构化JSON/Markdown,助力短视频营销、竞品分析与热点追踪。

1.2 核心能力

  • 🔍 抖音热门搜索:精准检索视频/图文/用户数据
  • 🎯 多维度排序:按点赞数、最新发布智能排序
  • 📅 时间筛选:支持1天/7天/半年内数据精准筛选
  • 📊 互动数据:提取点赞、评论、收藏、分享等核心指标
  • 🛠️ 智能纠错:自动清洗关键词,提升检索准确率
  • 📦 多格式输出:JSON(程序处理)/Markdown(人工阅读)双格式

1.3 适用场景

场景 用户痛点 技能如何解决
短视频营销 缺乏爆款视频创意灵感 一键获取“抖音热门”视频数据,分析热门趋势
竞品分析 难以追踪竞品内容策略 精准搜索竞品账号视频,分析互动数据
热点追踪 错过热点话题黄金期 实时搜索“抖音热门”话题,掌握最新动态
  • 链接提取:直接获取视频下载地址和图文原始链接

1.4 技能特性

  • 实时搜索:获取最新的抖音公开内容
  • 参数灵活:支持排序、时间、数量、格式自定义
  • 安全可靠:仅采集公开数据,符合数据采集合规要求
  • 易于集成:支持 OpenClaw 环境和直接命令行调用
  • 多维度数据:返回视频、图文等多种类型内容
  • 详细信息:包含标题、发布人、互动数据等完整信息

1.5 技术原理

该技能通过调用抖音搜索API,实现关键词搜索功能。具体流程如下:

  1. 接收用户输入的搜索关键词
  2. 清洗关键词,移除特殊符号
  3. 验证关键词格式
  4. 调用API创建搜索任务
  5. 轮询获取搜索结果
  6. 格式化输出结果
  7. 保存结果到本地文件

2. 快速调用指南

2.1 前置条件

  • 安装Node.js 16+环境
  • 配置环境变量 GUAIKEI_API_TOKEN(默认TOKEN仅用于体验,私有TOKEN需申请)

2.2 基础语法

# 语法:node scripts/search.js [关键词] [选项]

2.3 选项说明

选项 类型 可选值 默认值 说明
--keyword string 2-50字符(无特殊符号) 无 搜索关键词(必传)
--sort number 0/1/2 0 排序方式(0 - 综合 / 1 - 最多点赞 / 2 - 最新)
--time number 0/1/7/180 0 发布时间范围(0 - 全部 / 1-1 天 / 7-7 天 / 180 - 半年)
--limit number 10-60 10 返回结果数量
--output string json/markdown json 输出格式
--help/-h - - - 显示帮助信息

2.4 典型示例

# 示例1:基础搜索(JSON格式)
node scripts/search.js AI
# 示例2:带空格的关键词
node scripts/search.js "AI 教程"
# 示例3:自定义排序(最多点赞)
node scripts/search.js AI --sort 1
# 示例4:自定义发布时间(半年)
node scripts/search.js "AI 模型" --time 180
# 示例5:自定义返回结果数量(20条)
node scripts/search.js AI --limit 20
# 示例6:自定义输出格式(Markdown)
node scripts/search.js "AI 教程" --output markdown
# 示例7:复杂搜索(最新+近半年+20条结果+JSON格式)
node scripts/search.js --keyword "AI 教程" --sort 2 --time 180 --limit 20

3. 输出数据规范

3.1 JSON格式(默认)

{
  "status": "success",
  "keyword": "AI 教程",
  "message": "搜索任务完成",
  "sort": 0,
  "time": 0,
  "limit": 20,
  "output_format": "json",
  "total": 18,
  "timestamp": "2026/3/29 09:05:51",
  "results": [
    {
      "aweme_id": "7622261059679800627",
      "desc": "#刘慈欣称AI不可能完全代替人类作者  科幻作家谈#AI快速发展对科幻产业影响几何",
      "create_time": 1774695958,
      "author_uid": "98524606968",
      "author_nickname": "央视财经",
      "author_avatar": "https://...",
      "author_sec_uid": "MS4wLjABAAAAt6AsGhjrHeoxZNkceYg2J0FWvrWKzEaTAvF44-sPYco",
      "comment_count": 4,
      "digg_count": 356,
      "share_count": 6,
      "collect_count": 17,
      "share_url": "https://www.iesdouyin.com/share/video/...",
      "dynamic_cover": ["https://...", "https://..."],
      "play_addr": "https://...",
      "play_uri": "v0200fg10000d73r95fog65tmhj30190",
      "music_id": "7622261065841150756",
      "music_title": "@央视财经创作的原声",
      "music_author": "央视财经",
      "tags": [
        "刘慈欣称AI不可能完全代替人类作者",
        "AI快速发展对科幻产业影响几何"
      ],
      "url": "https://www.douyin.com/video/xxx",
      "author_url": "https://www.douyin.com/user/xxx",
      "create_time_str": "2026/3/28 19:05:58"
    }
  ]
}

3.2 Markdown格式(人工阅读)

以结构化列表形式展示搜索结果,非常适合内容创作者快速浏览和整理灵感素材。

## **抖音综合搜索结果**: AI 教程

**1 .** 刘慈欣称AI不可能完全代替人类作者 科幻作家谈#AI快速发展对科幻产业影响几何
**发布人**: 央视财经
**发布时间**: 2026/3/28 19:05:58
**链接**: https://www.douyin.com/video/xxx
**封面**: https://...
**视频**: https://...
**点赞**: 364 **评论**: 4 **收藏**: 18 **分享**: 7

---

**共 20 条结果**

4. 注意事项

4.1 合规要求

  • 仅用于抖音公开数据采集,禁止爬取私密 / 违规内容
  • 符合 OpenClaw 安全规范与数据采集合规要求

4.2 风控提示

  • 默认 TOKEN 有调用频率限制,生产环境建议使用私有 TOKEN
  • CDN 链接(视频 / 图片)为临时链接,建议及时下载留存
  • 关键词包含违规内容时,技能会直接拦截并提示

04 同仓库更多 Skills

bg-szy
bg-szy/TOP-SKILLS

serpmaven

Scrape Google search results (SERP) to JSON with SERP Maven (serpmaven) - a real Chrome browser on a residential proxy with sticky sessions. Run it as a CLI, a Python library, a local HTTP search API (`serve`), an MCP server or a Docker image; set the proxy login, workers, pages and cost tracking. Use when the user wants Google results, rank tracking, a self-hosted SERP API, or live Google search for an AI agent.

★ 6
bg-szy
bg-szy/TOP-SKILLS

revnu-landing-page-audit

Find out why a landing page isn't turning visitors into signups, demos or sales. Audits one page against what the ad, post or search that sends people there promised, then checks the first screen, proof, call to action, friction and mobile. Returns at most 7 prioritized fixes, plus what is fine and what could not be checked; rewrites specific lines and fixes the page in the repo when asked. Never promises a conversion lift. Works without a Revnu account. Use when the user says or asks: "audit my landing page", "why isn't this page converting", "review my homepage", "my ads get clicks but no signups", "people bounce from the pricing page", "CRO review", "improve conversion rate", "is my hero section clear", "roast my landing page", "rewrite my headline", "what's wrong with this page", "landing page feedback", "make the signup page convert better". Not for SEO or AI-search audits, page speed engineering on its own, or building a new page from scratch.

★ 6
bg-szy
bg-szy/TOP-SKILLS

revnu-growth-context

Write down once who buys, what they're stuck on, what it costs, what proof you have and what you've already tried, so every growth task starts from facts instead of a questionnaire. Creates or updates .agents/revnu-growth.md from the repo, the live site and the user, and imports an existing product-marketing.md. Use when the user says "set up our marketing context", "who is our ideal customer", "write our ICP", "describe the product for marketing", "positioning doc", "what's our brand voice", "remember this about our customers", "log what we tried", "what have we learned from marketing", "we changed pricing, update the context", "update our growth notes", "summarize the business for the agent", "import my product-marketing.md", "start a growth doc", or before a first marketing, SEO, outreach or launch task when no context file exists. Works without a Revnu account.

★ 6
bg-szy
bg-szy/TOP-SKILLS

revnu-get-listed

Get onto the third-party pages AI answers and search cite when buyers ask for the best tool in your category: "best X" roundups, directories, review sites, GitHub awesome lists, community threads and comparison pages. Finds which ones are cited, ranks them by fit and effort, and drafts each submission, PR or pitch by the target's own rules. Use when the user says "get us listed", "which directories should we submit to", "how do we get into best-of lists", "why does ChatGPT recommend competitors and not us", "get mentioned in AI answers", "submit to awesome lists", "get on G2", "where are our competitors listed", "pitch listicle authors", "find backlink opportunities", "launch directories", "get into roundups", "Product Hunt alternatives", "where should we be listed", "get cited by Perplexity". Never submits, pays or posts without a yes. Works without a Revnu account.

★ 6
bg-szy
bg-szy/TOP-SKILLS

revnu-ai-readiness-audit

Audit whether your website gives ChatGPT, Perplexity, Claude, Gemini and Google's AI Overviews something worth quoting, and fix the pages that don't. Use when the user says or asks "is my site ready for AI search", "audit my site for AI answers", "AEO audit", "GEO audit", "why doesn't ChatGPT quote our pricing", "make our pages citable by AI", "do I need llms.txt", "does schema help with ChatGPT", "check our structured data", "is our content visible without JavaScript", "AI SEO audit", "optimize our homepage for AI answers", "LLM SEO check", "why does AI get our product wrong", "fix our site for AI Overviews". Checks fetchability and indexability, answers in the raw HTML, entity facts, schema (including JS-injected markup), headings, dates and llms.txt, then gives at most 10 prioritised fixes and edits the repo when asked. Works without a Revnu account.

★ 6
bg-szy
bg-szy/TOP-SKILLS

proxy-troubleshooting

Diagnose residential proxy failures, with NodeMaven's gateway as the reference - 407 with correct credentials, 406, 410, 500, a connection that hangs, ERR_TUNNEL_CONNECTION_FAILED in a browser, Playwright or Puppeteer ignoring proxy credentials, a sticky session that changes IP, geo-targeting that is silently ignored, passwords with special characters, and unexpected traffic from headless Chrome. Use when a proxy connection fails, returns the wrong location, or costs more traffic than expected.

★ 6