{"id":"423344c7-42ba-4649-a33a-2f3479f9ee54","entityType":"agent","slug":"clawhub-redfox-data-douyin-search-redfox","name":"抖音作品查询","canonicalUrl":"https://www.xpersona.co/agent/clawhub-redfox-data-douyin-search-redfox","canonicalPath":"/agent/clawhub-redfox-data-douyin-search-redfox","generatedAt":"2026-10-10T21:51:02.937Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T18:27:55.954Z","emptyReason":null},"description":"抖音作品查询工具。根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词：抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。 Skill: 抖音作品查询 Owner: redfox-data Summary: 抖音作品查询工具。根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词：抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-07-29T02:45:57.623Z | auto - Improved keyword extraction: trigger phrases like \"热门文章\" and \"爆款\" are now filtered and will not be included in the search keywords. - Streamlined the generic workflow description","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s171kp1a76rjevha5b9m61sxv984vncz:douyin-search-redfox","sourceUrl":"https://clawhub.ai/redfox-data/douyin-search-redfox","homepage":"https://clawhub.ai/redfox-data/skills/douyin-search-redfox","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/redfox-data/douyin-search-redfox","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/redfox-data/skills/douyin-search-redfox","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":62,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"抖音作品查询工具。根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词：抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。 Skill: 抖音作品查询 Owner: redfox-data Summar"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T18:27:55.954Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T18:27:55.954Z","emptyReason":null},"stars":null,"forks":null,"downloads":1296,"packageName":null,"latestVersion":"1.0.5","tractionLabel":"1.3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T18:27:55.954Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T18:27:55.954Z","lastCrawledAt":"2026-10-10T18:27:55.954Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T18:27:55.954Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.5","createdAt":"2026-07-29T02:45:57.623Z","changelog":"- Improved keyword extraction: trigger phrases like \"热门文章\" and \"爆款\" are now filtered and will not be included in the search keywords. - Streamlined the generic workflow description and removed redundant recommendation and topic output (no more latestHotArticles/hotTopics logic). - Updated data fields: search now focuses on articles list, with clear definitions for total, pageNum, and pageSize. - Updated README and documentation for enhanced clarity on how to use the skill. - Removed unnecessary files and refactored steps to focus only on the main search and subscription flow.","fileCount":6,"zipByteSize":12046},{"version":"1.0.4","createdAt":"2026-07-21T09:59:11.048Z","changelog":"- Removed the file skill-card.md. - No changes to feature scope or workflow. - Minor update: enterprise purchase/link mention added at the end of subscription prompt in SKILL.md.","fileCount":6,"zipByteSize":12250},{"version":"1.0.3","createdAt":"2026-06-04T07:22:11.372Z","changelog":"- Improved documentation: SKILL.md rewritten for clarity, brevity, and better structure. - Simplified and clarified workflow steps for user input handling, search, and result display. - Feature tables and example formats added to highlight key functionalities and usage. - Removed redundant or lengthy procedural explanations; core logic and rules are now concise. - skill-card.md file removed as part of documentation cleanup.","fileCount":6,"zipByteSize":12161},{"version":"1.0.2","createdAt":"2026-06-04T02:48:03.661Z","changelog":"- Removed the file skill-card.md for cleaner packaging. - Completely rewrote and condensed usage documentation in SKILL.md, focusing on workflow steps over extensive scenarios and Q&A. - Standardized and clarified the rules for keyword extraction, search workflow, time phrase parsing, and search result display. - Updated table fields to include and consistently format the \"发布时间\" column as “MM-DD HH:MM”. - Aligned subscription/定时推送 setup instructions to newer, more concise conventions. - Removed installation, troubleshooting, technical stack details, and usage examples for a more focused, step-by-step process.","fileCount":6,"zipByteSize":14105},{"version":"1.0.1","createdAt":"2026-06-02T09:41:06.047Z","changelog":"- Major documentation update: overhauled SKILL.md for improved clarity and detail. - Added comprehensive instructions for advanced search, keyword extraction, and data display strategies. - Introduced procedures for handling generalized keywords, including fine-grained expansion recommendations. - Detailed full process for result presentation, popular recommendations, topic listing, and subscription workflows. - Removed file: skill-card.md (no longer included in this version). - Clarified commands, installation steps, and frequent Q&A for all user types.","fileCount":6,"zipByteSize":14853},{"version":"1.0.0","createdAt":"2026-05-29T01:54:56.210Z","changelog":"Initial release of douyin-search: A tool for searching trending Douyin/TikTok videos. - Enables keyword-based search for Douyin viral videos, displaying results in a formatted table. - Extracts and generalizes keywords for more accurate searches (removes date/modifier terms). - Presents top 20 results with formatted numbers and clickable titles; offers option to view all results if more exist. - Provides an option for users to subscribe to daily automated searches via scheduled tasks. - Includes clear API Key setup instructions and step-by-step workflow guidance.","fileCount":6,"zipByteSize":10784}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171kp1a76rjevha5b9m61sxv984vncz:douyin-search-redfox","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T21:51:02.932Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T18:27:55.954Z","emptyReason":null},"readme":"Skill: 抖音作品查询\n\nOwner: redfox-data\n\nSummary: 抖音作品查询工具。根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词：抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。\n\nTags: latest:1.0.5\n\nVersion history:\n\nv1.0.5 | 2026-07-29T02:45:57.623Z | auto\n\n- Improved keyword extraction: trigger phrases like \"热门文章\" and \"爆款\" are now filtered and will not be included in the search keywords.\n- Streamlined the generic workflow description and removed redundant recommendation and topic output (no more latestHotArticles/hotTopics logic).\n- Updated data fields: search now focuses on articles list, with clear definitions for total, pageNum, and pageSize.\n- Updated README and documentation for enhanced clarity on how to use the skill.\n- Removed unnecessary files and refactored steps to focus only on the main search and subscription flow.\n\nv1.0.4 | 2026-07-21T09:59:11.048Z | user\n\n- Removed the file skill-card.md.\n- No changes to feature scope or workflow.\n- Minor update: enterprise purchase/link mention added at the end of subscription prompt in SKILL.md.\n\nv1.0.3 | 2026-06-04T07:22:11.372Z | auto\n\n- Improved documentation: SKILL.md rewritten for clarity, brevity, and better structure.\n- Simplified and clarified workflow steps for user input handling, search, and result display.\n- Feature tables and example formats added to highlight key functionalities and usage.\n- Removed redundant or lengthy procedural explanations; core logic and rules are now concise.\n- skill-card.md file removed as part of documentation cleanup.\n\nv1.0.2 | 2026-06-04T02:48:03.661Z | user\n\n- Removed the file skill-card.md for cleaner packaging.\n- Completely rewrote and condensed usage documentation in SKILL.md, focusing on workflow steps over extensive scenarios and Q&A.\n- Standardized and clarified the rules for keyword extraction, search workflow, time phrase parsing, and search result display.\n- Updated table fields to include and consistently format the \"发布时间\" column as “MM-DD HH:MM”.\n- Aligned subscription/定时推送 setup instructions to newer, more concise conventions.\n- Removed installation, troubleshooting, technical stack details, and usage examples for a more focused, step-by-step process.\n\nv1.0.1 | 2026-06-02T09:41:06.047Z | user\n\n- Major documentation update: overhauled SKILL.md for improved clarity and detail.\n- Added comprehensive instructions for advanced search, keyword extraction, and data display strategies.\n- Introduced procedures for handling generalized keywords, including fine-grained expansion recommendations.\n- Detailed full process for result presentation, popular recommendations, topic listing, and subscription workflows.\n- Removed file: skill-card.md (no longer included in this version).\n- Clarified commands, installation steps, and frequent Q&A for all user types.\n\nv1.0.0 | 2026-05-29T01:54:56.210Z | auto\n\nInitial release of douyin-search: A tool for searching trending Douyin/TikTok videos.\n\n- Enables keyword-based search for Douyin viral videos, displaying results in a formatted table.\n- Extracts and generalizes keywords for more accurate searches (removes date/modifier terms).\n- Presents top 20 results with formatted numbers and clickable titles; offers option to view all results if more exist.\n- Provides an option for users to subscribe to daily automated searches via scheduled tasks.\n- Includes clear API Key setup instructions and step-by-step workflow guidance.\n\nArchive index:\n\nArchive v1.0.5: 6 files, 12046 bytes\n\nFiles: README.en.md (6200b), README.md (4937b), scripts/search_douyin.py (4336b), skill-card.md (2195b), SKILL.md (6862b), _meta.json (139b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: douyin-search\ndescription: 抖音作品查询工具。根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词：抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。\n---\n\n# 抖音作品查询\n\n## 📝 简介\n\n根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，返回点赞、评论、分享、收藏、发布时间等互动数据，结果以结构化表格展示。\n\n## ✨ 功能特性\n\n| 功能模块 | 能力描述 | 核心价值 |\n|---------|---------|---------|\n| 爆款搜索 | 关键词搜索抖音爆款作品 | 精准发现高热度内容 |\n| 日期筛选 | 支持按日期范围筛选 | 定位特定时间段的热门内容 |\n| 智能拓展 | 泛化词自动拓展为 10 个细分词 | 避免泛化词搜索结果偏差 |\n| 可点击链接 | 作品标题以超链接格式输出 | 一键跳转查看原作品 |\n| 订阅推送 | 支持关键词每日推送 | 定时获取最新爆款动态 |\n\n## 🔑 鉴权\n\n- 获取 API Key：前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub)\n- 配置方式1：写入 `~/.openclaw/openclaw.json` → `{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }`\n- 配置方式2：终端执行 `export REDFOX_API_KEY=\"ak_xxxx...\"`\n\n## ⚙️ 工作流程\n\n### Step 1: 🔍 用户意图理解\n\n**⚠️ 核心规则：优先提取细分方向词，而非泛化的大类词**\n\n| 用户输入 | 处理方式 |\n|---------|--------|\n| 无赛道关键词（\"最近热门作品\"） | 关键词传空字符串 `\"\"`，查询全站热门 |\n| 有细分词（\"职场穿搭\"、\"减脂餐\"） | 直接搜索，无需拓展 |\n| 有泛化词（\"穿搭\"、\"美食\"） | 执行拓展策略（Step 2） |\n\n细分词判断原则：有场景/人群/风格/意图修饰 → 细分词；纯大类无修饰 → 泛化词。\n\n**提取精确关键词**：从用户描述中提取细分领域词，而非泛化词。例：用户说“帮我找电影领域热门话题”且自称“小众电影、港台文化” → 搜索“小众电影、港台电影、电影乐评”，❌ 而非只搜“电影”。\n\n**过滤触发钩子词**：用户输入中的「热门文章」「热门作品」「爆款」「热门内容」「查询」「搜索」等词是调用 Skill 的触发钩子，不属于搜索关键词，必须剥离。例：用户说“查询AI热门文章” → 关键词为「AI」，❌ 而非「AI热门文章」。\n\n### Step 2: 🔄 泛化词拓展策略\n\n**⚠️ 必须等待用户明确回复后再调用脚本！**\n\n| 步骤 | 操作 |\n|------|------|\n| 1. 生成细分词 | 生成10个适中大小的细分词（趋势词、人群词、场景词、意图词各2-3个），禁止调用脚本 |\n| 2. 等待用户回复 | 用户未回复时禁止调用脚本 |\n| 3. 执行 | 回复「拓展」→ 10词以英文逗号连接，仅调用一次脚本；回复「不拓展」→ 搜索原关键词 |\n\n输出示例：\n```text\n我识别到「中产」是较大的分类，推荐以下细分方向：\n老钱,轻奢,品质生活,松弛感,高级感穿搭,体面,法式穿搭,律师,医生,品质家居\n回复「拓展」将同时搜索这10个词，回复「不拓展」将继续搜索「中产」\n```\n\n### Step 3: 📡 调用 API 接口\n\n**3.1 时间解析规则**\n\n| 用户输入 | 解析方式 | 示例 |\n|---------|---------|------|\n| 绝对日期 | 解析为 `YYYY-MM-DD` | `6月1号` → `2026-06-01` |\n| 相对日期 | 基于当前日期计算 | `最近7天` → start=7天前, end=今天 |\n| 日期范围 | 分别解析为 startDate/endDate | `5月30日到6月2日` |\n| 模糊时间 | **不解析**，保持默认空字符串 | `最近的`、`最新的` |\n\n- `startDate`/`endDate` 默认空字符串，表示不限定时间\n- 单日期 → startDate = endDate；年份省略取当前年份\n\n**3.2 执行脚本**\n\n```bash\n# 无时间参数\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\"\n\n# 有时间参数\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\" --start-date --end-date \n```\n\n仅传入非空的时间参数。脚本返回 JSON：\n\n| 字段 | 说明 |\n|------|------|\n| articles | 搜索匹配的作品列表（按点赞数降序） |\n| total | 总记录数 |\n| pageNum | 当前页码 |\n| pageSize | 每页大小 |\n\n每条作品字段：`title`、`author`、`like_count`、`comment_count`、`share_count`、`collect_count`、`work_url`、`publish_time`\n\n### Step 4: 📊 结果展示\n\n**⚠️ 总数校验**：展示的 N 必须取自 `articles` 数组长度，禁止人工计数。\n\n#### 情况 A：articles > 0\n\n**A1.** 输出查询范围：\n\n> 📊 关键词「**XXX**」共匹配到 **N 条**抖音爆款作品，以下是详细数据：\n\n**A2.** 展示前 20 条表格：\n\n```markdown\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\n|---|---------|------|--------|--------|--------|--------|----------|\n| 1 | [标题](work_url) | 作者名 | 305.2w | 7.1w | 51.0w | 14.7w | 06-02 19:55 |\n```\n\n格式化规则：\n- 数字 < 10000 直接展示；≥ 10000 用 `x.xw` 格式\n- `publish_time` 转为 `MM-DD HH:MM`；无论是否指定时间范围均展示\n- 标题超 30 字截断加 `...`，使用 `[标题](work_url)` 链接格式\n\n**A3.** articles > 20 时提示：\n\n> 以上展示了前 20 条数据，还剩 **N 条**未展示。回复「查看全部」展开剩余数据。\n\n**⚠️ A1~A3 同一轮输出连续完成，A3 后紧跟 Step 5。**\n\n#### 情况 B：articles = 0\n\n**B1.** 抱歉提示 + 10个扩展词（以英文逗号分隔）：\n\n> 😔 抱歉，未找到与「**XXX**」相关的内容，可尝试（扩展词1,扩展词2,...,扩展词10）\n\n扩展词规则：基于原关键词语义扩展，每词2-6字，固定10个。\n\n**⚠️ B1 后紧跟 Step 5。**\n\n### Step 5: 📩 提示订阅\n\n展示完毕后末尾附上：\n\n> 📩 是否订阅「**XXX**」的每日推送？订阅后每天 10:00 自动推送最新爆款作品。回复「确认订阅」即可创建定时任务。\n\n### Step 6: ⏰ 创建定时任务（用户回复「确认订阅」时执行）\n\n优先使用平台内置定时任务，若无则提供通用方案：\n\n- 任务名称：`抖音爆款作品订阅 - <关键词>`\n- 执行频率：每天 10:00（cron `0 10 * * *`）\n- 执行命令：`python3 <脚本路径>/search_douyin.py \"<关键词>\"`（有时间参数则附加 `--start-date`/`--end-date`）\n- 通用 crontab：`0 10 * * * python3 /path/to/search_douyin.py \"<关键词>\"`\n\n创建成功后告知：\"已成功订阅关键词「<关键词>」的爆款作品推送，每天 10:00 将自动查询最新数据并通知你。\"\n\nFile v1.0.5:README.md\n\n# 抖音作品查询 / douyin-search\n\n---\n\n## 简介\n\n输入关键词即可查询抖音热门爆款作品，以结构化表格呈现点赞、评论、分享、收藏等互动数据，帮你快速掌握各类内容在抖音的真实表现。\n\n**核心价值**\n\n- **即搜即看**：输入任意内容关键词，立刻获取按点赞数排序的爆款作品列表。\n- **数据全面**：每条作品展示作者、点赞数、评论数、分享数、收藏数及可跳转的原文链接。\n- **持续关注**：支持订阅感兴趣的关键词，每天定时推送最新爆款数据，不错过任何趋势。\n\n**适用对象**\n\n- 📝 **内容创作者** — 追踪同赛道爆款，为选题与创作提供数据参考。\n- 🏢 **MCN / 品牌运营** — 快速了解特定品类在抖音的热度与头部内容表现。\n- 📊 **增长 / 市场团队** — 按关键词洞察内容趋势，辅助投放与选题决策。\n\n---\n\n## 功能特性\n\n### 核心功能\n\n- **爆款搜索**：关键词搜索抖音爆款作品，精准发现高热度内容。\n- **日期筛选**：支持按日期范围筛选，定位特定时间段的热门内容。\n- **智能拓展**：泛化词自动拓展为 10 个细分词，避免泛化词搜索结果偏差。\n- **热门推荐**：无结果时推荐热门作品和话题，兜底保障不空手而归。\n- **可点击链接**：作品标题以超链接格式输出，一键跳转查看原作品。\n- **订阅推送**：支持关键词每日推送，定时获取最新爆款动态。\n\n### 特色亮点\n\n- **泛化保命中**：不要求精确关键词，口语化输入也能获得有效结果，降低使用门槛。\n- **一键订阅**：无需额外操作，查完即订，每日自动推送，持续追踪趋势变化。\n- **数据可点击**：表格中每条作品标题均可直接跳转到抖音原始页面，方便深度查看。\n\n---\n\n## 密钥获取与安全说明\n\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\n- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\n\n---\n\n## 使用指南\n\n直接用自然语言说出你想查的内容方向即可，无需记忆固定命令。\n\n### 常用说法速查\n\n| 意图 | 示例话术 | 效果 |\n| ---------------- | ---------------------------------- | ----------------------------------- |\n| 查某类内容的爆款 | \"今日美食热门作品\" | 自动泛化为\"美食\"，返回爆款表格 |\n| 查某个赛道表现 | \"帮我看看旅行类在抖音火不火\" | 以\"旅行\"查询，按点赞排序展示 |\n| 口语化随意搜 | \"最近搞笑视频挺火的\" | 自动提取\"搞笑\"，返回热门作品 |\n| 按时间筛选 | \"5月30号到6月2号的旅游作品\" | 解析日期范围，返回该时段爆款作品 |\n| 查看全部结果 | 表格展示后选择\"查看全部\" | 续接展示剩余数据（最多 50 条） |\n| 订阅每日推送 | 查询后选择\"确认订阅\" | 每天 10:00 自动推送该关键词最新爆款 |\n\n### 输出示例\n\n查询完成后，你将看到类似以下格式的表格（示意）：\n\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\n| --- | ------------------------------- | --------- | ------ | ------ | ------ | ------ | --------- |\n| 1 | [跟我一起来做这道菜…](链接) | 美食达人A | 305.2w | 7.1w | 51.0w | 14.7w | 06-01 19:55 |\n| 2 | [旅行vlog：周末说走就走…](链接) | 旅行博主B | 158.3w | 3.2w | 22.1w | 8.5w | 05-30 15:30 |\n\n（共展示 20 条，数据超过 20 条时提示查看全部。）\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 示例问法 | 收益 |\n| -------- | ---------- | -------------------------------- | -------------------------------- |\n| 选题调研 | 内容创作者 | \"帮我看看美食赛道最近什么内容火\" | 快速锁定高互动方向，减少盲目试错 |\n| 竞品监控 | 品牌运营 | \"查一下母婴品类在抖音的爆款表现\" | 了解头部内容形态，辅助投放策略 |\n| 趋势追踪 | 市场团队 | \"搞笑类内容在抖音还火吗\" | 按数据判断赛道热度，及时调整方向 |\n| 日常关注 | 个人用户 | \"每日推送旅行类爆款作品\" | 订阅后自动获取，不错过任何热点 |\n\n---\n\nFile v1.0.5:_meta.json\n\n{\n \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n \"slug\": \"douyin-search-redfox\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1785293157623\n}\n\nFile v1.0.5:README.en.md\n\n# Douyin Content Search / douyin-search\n\n---\n\n## Overview\n\nEnter a keyword to search for trending viral content on Douyin, presented in a structured table with engagement data including likes, comments, shares, and saves—helping you quickly understand how different content categories are performing on the platform.\n\n**Core Value**\n\n- **Instant search**: Enter any content keyword and immediately receive a list of viral works sorted by like count.\n- **Comprehensive data**: Each result shows the author, likes, comments, shares, saves, and a clickable link to the original work.\n- **Continuous tracking**: Subscribe to keywords of interest and receive daily push notifications with the latest trending data—never miss a trend.\n\n**Intended Users**\n\n- 📝 **Content creators** — Track viral content in your niche for data-driven topic and creative inspiration.\n- 🏢 **MCN / brand operators** — Quickly gauge the popularity and top-performing content for a specific category on Douyin.\n- 📊 **Growth / marketing teams** — Gain keyword-based content trend insights to inform ad placement and topic strategy.\n\n---\n\n## Features\n\n### Core Capabilities\n\n- **Viral Search**: Keyword-based search for Douyin viral works — precisely discover high-engagement content.\n- **Date Filtering**: Filter by date range to pinpoint popular content within a specific timeframe.\n- **Smart Expansion**: Automatically broadens generic keywords into 10 niche terms, avoiding skewed search results.\n- **Hot Recommendations**: Recommends trending works and topics when no results found — never leave empty-handed.\n- **Clickable Links**: Work titles output as hyperlinks — one click to the original Douyin video.\n- **Subscription Push**: Subscribe to keywords for daily automated updates with the latest viral trends.\n\n### Highlights\n\n- **Generalization for guaranteed hits**: No need for precise keywords—casual, conversational input still yields effective results, lowering the learning curve.\n- **One-click subscription**: No extra steps—search, subscribe, and receive daily push notifications to stay on top of trend changes.\n- **Clickable data**: Every work title in the table links directly to the original Douyin page for deeper inspection.\n\n---\n\n## API Key Acquisition & Security\n\n- This skill requires the environment variable: `REDFOX_API_KEY`.\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`).\n- Register at [RedFoxHub](https://redfox.hk?source=github) to obtain `REDFOX_API_KEY`.\n- Configure `REDFOX_API_KEY` on your device before using this skill.\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\n\n---\n\n## Usage Guide\n\nSimply describe the content category you want to explore in natural language—no fixed commands to memorize.\n\n### Quick Reference\n\n| Intent | Example phrase | Result |\n| -------------------------------- | ------------------------------------------------------ | --------------------------------------------------------------------- |\n| Search viral content by category | \"Today's trending food content\" | Auto-generalizes to \"food,\" returns a viral content table |\n| Check a niche's performance | \"Is travel content popular on Douyin?\" | Queries \"travel,\" displays results sorted by likes |\n| Casual conversational search | \"Funny videos seem hot lately\" | Auto-extracts \"funny,\" returns trending works |\n| Filter by date range | \"Travel content from May 30 to June 2\" | Parses date range, returns viral works from that period |\n| View all results | Select \"View all\" after the table appears | Continues displaying remaining data (up to 50) |\n| Subscribe to daily updates | Select \"Subscribe\" after a search | Daily push at 10:00 AM with the latest viral content for that keyword |\n\n### Output Example\n\nAfter a search, you'll see a table like this (illustrative):\n\n| # | Work Title | Author | Likes | Comments | Shares | Saves | Published |\n| --- | ------------------------------------------------ | -------------- | ------ | -------- | ------ | ------ | ----------- |\n| 1 | [Let me show you how to make this dish…](link) | FoodieA | 305.2w | 7.1w | 51.0w | 14.7w | 06-01 19:55 |\n| 2 | [Travel vlog: A spontaneous weekend trip…](link) | TravelBloggerB | 158.3w | 3.2w | 22.1w | 8.5w | 05-30 15:30 |\n\n(20 results shown by default; when there are more, you'll be prompted to view all.)\n\n---\n\n## Use Cases\n\n| Scenario | Role | Example question | Benefit |\n| ---------------------- | --------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------- |\n| Topic research | Content creator | \"What food content is trending on Douyin lately?\" | Quickly pinpoint high-engagement directions, reduce blind trial-and-error |\n| Competitive monitoring | Brand operator | \"Check the viral performance of the baby & maternity category on Douyin\" | Understand top content formats, inform ad strategy |\n| Trend tracking | Marketing team | \"Is comedy content still popular on Douyin?\" | Judge niche heat by data, adjust direction in time |\n| Daily monitoring | Individual user | \"Push me daily updates on travel viral content\" | Subscribe once and receive automatic updates—never miss a trend |\n\n---\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\nSearches Douyin trending works by keyword and optional date range, then returns engagement data in a structured table.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[redfox-data](https://clawhub.ai/user/redfox-data)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal content creators, MCN and brand operators, and marketing teams use this skill to research Douyin content trends, compare engagement for a keyword or date range, and optionally set up daily keyword tracking.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends Douyin search keywords and date filters to Redfox and requires a local REDFOX_API_KEY.\n\nMitigation: Use the skill only when sharing those query details with Redfox is acceptable, store the API key locally, and avoid exposing it in code, prompts, logs, or output files.\n\nRisk: Daily subscription instructions can persist unsafe shell commands built from user keywords.\n\nMitigation: Avoid confirming daily subscriptions until scheduler commands use structured arguments or safe quoting, and review any created scheduled task so it can be removed later.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/redfox-data/skills/douyin-search-redfox)\n- [RedFoxHub API key settings](https://redfox.hk/settings/api-keys?source=clawhub)\n- [Redfox Douyin search API endpoint](https://redfox.hk/story/api/dy/data/searchWork)\n\n## Skill Output:\n\n**Output Type(s):** [Markdown, JSON, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown tables with links, JSON from the search script, and shell commands for API-key setup or scheduled searches]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Search results include title, author, engagement counts, source URL, publish time, total, pageNum, and pageSize.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.4: 6 files, 12250 bytes\n\nFiles: README.en.md (6658b), README.md (5310b), scripts/search_douyin.py (4101b), skill-card.md (2236b), SKILL.md (7362b), _meta.json (139b)\n\nFile v1.0.4:SKILL.md\n\n---\r\nname: douyin-search\r\ndescription: 抖音爆款作品查询工具。根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词：抖音爆款、抖音热门、抖音热榜、抖音作品查询、抖音搜索、爆款视频、热门视频。\r\n---\r\n\r\n# 抖音作品查询\r\n\r\n## 📝 简介\r\n\r\n根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，返回点赞、评论、分享、收藏、发布时间等互动数据，结果以结构化表格展示。\r\n\r\n## ✨ 功能特性\r\n\r\n| 功能模块 | 能力描述 | 核心价值 |\r\n|---------|---------|---------|\r\n| 爆款搜索 | 关键词搜索抖音爆款作品 | 精准发现高热度内容 |\r\n| 日期筛选 | 支持按日期范围筛选 | 定位特定时间段的热门内容 |\r\n| 智能拓展 | 泛化词自动拓展为 10 个细分词 | 避免泛化词搜索结果偏差 |\r\n| 热门推荐 | 无结果时推荐热门作品和话题 | 兜底保障不空手而归 |\r\n| 可点击链接 | 作品标题以超链接格式输出 | 一键跳转查看原作品 |\r\n| 订阅推送 | 支持关键词每日推送 | 定时获取最新爆款动态 |\r\n\r\n## 🔑 鉴权\r\n\r\n- 获取 API Key：前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub)\r\n- 配置方式1：写入 `~/.openclaw/openclaw.json` → `{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }`\r\n- 配置方式2：终端执行 `export REDFOX_API_KEY=\"ak_xxxx...\"`\r\n\r\n## ⚙️ 工作流程\r\n\r\n### Step 1: 🔍 用户意图理解\r\n\r\n**⚠️ 核心规则：优先提取细分方向词，而非泛化的大类词**\r\n\r\n| 用户输入 | 处理方式 |\r\n|---------|--------|\r\n| 无赛道关键词（\"最近热门作品\"） | 关键词传空字符串 `\"\"`，查询全站热门 |\r\n| 有细分词（\"职场穿搭\"、\"减脂餐\"） | 直接搜索，无需拓展 |\r\n| 有泛化词（\"穿搭\"、\"美食\"） | 执行拓展策略（Step 2） |\r\n\r\n细分词判断原则：有场景/人群/风格/意图修饰 → 细分词；纯大类无修饰 → 泛化词。\r\n\r\n**提取精确关键词**：从用户描述中提取细分领域词，而非泛化词。例：用户说\"帮我找电影领域热门话题\"且自称\"小众电影、港台文化\" → 搜索\"小众电影、港台电影、电影乐评\"，❌ 而非只搜\"电影\"。\r\n\r\n### Step 2: 🔄 泛化词拓展策略\r\n\r\n**⚠️ 必须等待用户明确回复后再调用脚本！**\r\n\r\n| 步骤 | 操作 |\r\n|------|------|\r\n| 1. 生成细分词 | 生成10个适中大小的细分词（趋势词、人群词、场景词、意图词各2-3个），禁止调用脚本 |\r\n| 2. 等待用户回复 | 用户未回复时禁止调用脚本 |\r\n| 3. 执行 | 回复「拓展」→ 10词以英文逗号连接，仅调用一次脚本；回复「不拓展」→ 搜索原关键词 |\r\n\r\n输出示例：\r\n```text\r\n我识别到「中产」是较大的分类，推荐以下细分方向：\r\n老钱,轻奢,品质生活,松弛感,高级感穿搭,体面,法式穿搭,律师,医生,品质家居\r\n回复「拓展」将同时搜索这10个词，回复「不拓展」将继续搜索「中产」\r\n```\r\n\r\n### Step 3: 📡 调用 API 接口\r\n\r\n**3.1 时间解析规则**\r\n\r\n| 用户输入 | 解析方式 | 示例 |\r\n|---------|---------|------|\r\n| 绝对日期 | 解析为 `YYYY-MM-DD` | `6月1号` → `2026-06-01` |\r\n| 相对日期 | 基于当前日期计算 | `最近7天` → start=7天前, end=今天 |\r\n| 日期范围 | 分别解析为 startDate/endDate | `5月30日到6月2日` |\r\n| 模糊时间 | **不解析**，保持默认空字符串 | `最近的`、`最新的` |\r\n\r\n- `startDate`/`endDate` 默认空字符串，表示不限定时间\r\n- 单日期 → startDate = endDate；年份省略取当前年份\r\n\r\n**3.2 执行脚本**\r\n\r\n```bash\r\n# 无时间参数\r\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\"\r\n\r\n# 有时间参数\r\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\" --start-date --end-date \r\n```\r\n\r\n仅传入非空的时间参数。脚本返回 JSON：\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| articles | 搜索匹配的作品列表（按点赞数降序） |\r\n| latestHotArticles | 近期热门推荐作品列表 |\r\n| hotTopics | 热门话题列表 |\r\n\r\n每条作品字段：`title`、`author`、`like_count`、`comment_count`、`share_count`、`collect_count`、`work_url`、`publish_time`、`follower_count`\r\n\r\n### Step 4: 📊 结果展示\r\n\r\n**⚠️ 总数校验**：展示的 N 必须取自 `articles` 数组长度，禁止人工计数。\r\n\r\n#### 情况 A：articles > 0\r\n\r\n**A1.** 输出查询范围：\r\n\r\n> 📊 关键词「**XXX**」共匹配到 **N 条**抖音爆款作品，以下是详细数据：\r\n\r\n**A2.** 展示前 20 条表格：\r\n\r\n```markdown\r\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\r\n|---|---------|------|--------|--------|--------|--------|----------|\r\n| 1 | [标题](work_url) | 作者名 | 305.2w | 7.1w | 51.0w | 14.7w | 06-02 19:55 |\r\n```\r\n\r\n格式化规则：\r\n- 数字 < 10000 直接展示；≥ 10000 用 `x.xw` 格式\r\n- `publish_time` 转为 `MM-DD HH:MM`；无论是否指定时间范围均展示\r\n- 标题超 30 字截断加 `...`，使用 `[标题](work_url)` 链接格式\r\n\r\n**A3.** articles > 20 时提示：\r\n\r\n> 以上展示了前 20 条数据，还剩 **N 条**未展示。回复「查看全部」展开剩余数据。\r\n\r\n**A4-A5.** 仅 articles ≤ 10 时执行：\r\n- `latestHotArticles` 非空 → 展示「🔥 近期热门推荐作品」表格（最多10条）\r\n- `hotTopics` 非空 → 展示「🏷️ 热门话题」列表\r\n- 为空则跳过，不输出\r\n\r\n**⚠️ A1~A5 同一轮输出连续完成，A5 后紧跟 Step 5。**\r\n\r\n#### 情况 B：articles = 0\r\n\r\n**B1.** 抱歉提示 + 10个扩展词（以英文逗号分隔）：\r\n\r\n> 😔 抱歉，未找到与「**XXX**」相关的内容，可尝试（扩展词1,扩展词2,...,扩展词10）\r\n\r\n扩展词规则：基于原关键词语义扩展，每词2-6字，固定10个。\r\n\r\n**B2-B3.** 展示 `latestHotArticles`（💡 推荐提示）和 `hotTopics`，为空则跳过。\r\n\r\n**⚠️ B1~B3 同一轮输出连续完成，B3 后紧跟 Step 5。**\r\n\r\n### Step 5: 📩 提示订阅\r\n\r\n展示完毕后末尾附上：\r\n\r\n> 📩 是否订阅「**XXX**」的每日推送？订阅后每天 10:00 自动推送最新爆款作品。回复「确认订阅」即可创建定时任务。\r\n>\r\n> 💼 另外红狐配套全量数据库可提供完整详实数据，如需了解采购方案，可前往红狐hub[企业服务](https://redfox.hk/dashboard/enterprise)对接咨询\r\n\r\n### Step 6: ⏰ 创建定时任务（用户回复「确认订阅」时执行）\r\n\r\n优先使用平台内置定时任务，若无则提供通用方案：\r\n\r\n- 任务名称：`抖音爆款作品订阅 - <关键词>`\r\n- 执行频率：每天 10:00（cron `0 10 * * *`）\r\n- 执行命令：`python3 <脚本路径>/search_douyin.py \"<关键词>\"`（有时间参数则附加 `--start-date`/`--end-date`）\r\n- 通用 crontab：`0 10 * * * python3 /path/to/search_douyin.py \"<关键词>\"`\r\n\r\n创建成功后告知：\"已成功订阅关键词「<关键词>」的爆款作品推送，每天 10:00 将自动查询最新数据并通知你。\"\n\nFile v1.0.4:README.md\n\n# 抖音作品查询 / douyin-search\r\n\r\n---\r\n\r\n## 简介\r\n\r\n输入关键词即可查询抖音热门爆款作品，以结构化表格呈现点赞、评论、分享、收藏等互动数据，帮你快速掌握各类内容在抖音的真实表现。\r\n\r\n**核心价值**\r\n\r\n- **即搜即看**：输入任意内容关键词，立刻获取按点赞数排序的爆款作品列表。\r\n- **数据全面**：每条作品展示作者、点赞数、评论数、分享数、收藏数及可跳转的原文链接。\r\n- **持续关注**：支持订阅感兴趣的关键词，每天定时推送最新爆款数据，不错过任何趋势。\r\n\r\n**适用对象**\r\n\r\n- 📝 **内容创作者** — 追踪同赛道爆款，为选题与创作提供数据参考。\r\n- 🏢 **MCN / 品牌运营** — 快速了解特定品类在抖音的热度与头部内容表现。\r\n- 📊 **增长 / 市场团队** — 按关键词洞察内容趋势，辅助投放与选题决策。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n\r\n- **爆款搜索**：关键词搜索抖音爆款作品，精准发现高热度内容。\r\n- **日期筛选**：支持按日期范围筛选，定位特定时间段的热门内容。\r\n- **智能拓展**：泛化词自动拓展为 10 个细分词，避免泛化词搜索结果偏差。\r\n- **热门推荐**：无结果时推荐热门作品和话题，兜底保障不空手而归。\r\n- **可点击链接**：作品标题以超链接格式输出，一键跳转查看原作品。\r\n- **订阅推送**：支持关键词每日推送，定时获取最新爆款动态。\r\n\r\n### 特色亮点\r\n\r\n- **智能拓展引导**：输入泛化大类词（如\"美食\"\"穿搭\"）时，自动生成 10 个细分方向供选择，精准锁定目标赛道，避免搜索结果偏差。\r\n- **无结果兜底推荐**：关键词无匹配时，自动推荐近期热门作品和话题，不会空手而归。\r\n- **一键订阅推送**：查完即订，每日 10:00 自动推送该关键词最新爆款作品，持续追踪趋势变化。\r\n- **数据可点击直达**：表格中每条作品标题均为可点击超链接，一键跳转抖音原始页面查看完整内容。\r\n\r\n---\r\n\r\n## 密钥获取与安全说明\r\n\r\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\r\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\r\n- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。\r\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\r\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\r\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n直接用自然语言说出你想查的内容方向即可，无需记忆固定命令。\r\n\r\n### 常用说法速查\r\n\r\n| 意图 | 示例话术 | 效果 |\r\n| ---------------- | ---------------------------------- | ----------------------------------- |\r\n| 查某类内容的爆款 | \"今日美食热门作品\" | 识别为泛化词，推荐 10 个细分方向供选择 |\r\n| 查细分赛道表现 | \"帮我看看减脂餐在抖音火不火\" | 直接搜索细分词，按点赞排序展示 |\r\n| 口语化随意搜 | \"最近搞笑视频挺火的\" | 自动提取\"搞笑\"，返回热门作品 |\r\n| 按时间筛选 | \"5月30号到6月2号的旅游作品\" | 解析日期范围，返回该时段爆款作品 |\r\n| 无结果也不落空 | 搜索小众关键词无匹配时 | 自动展示近期热门作品和话题推荐 |\r\n| 订阅每日推送 | 查询后选择\"确认订阅\" | 每天 10:00 自动推送该关键词最新爆款 |\r\n\r\n### 输出示例\r\n\r\n查询完成后，你将看到类似以下格式的表格（示意）：\r\n\r\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\r\n| --- | ------------------------------- | --------- | ------ | ------ | ------ | ------ | --------- |\r\n| 1 | [跟我一起来做这道菜…](链接) | 美食达人A | 305.2w | 7.1w | 51.0w | 14.7w | 06-01 19:55 |\r\n| 2 | [旅行vlog：周末说走就走…](链接) | 旅行博主B | 158.3w | 3.2w | 22.1w | 8.5w | 05-30 15:30 |\r\n\r\n（默认展示前 20 条；超过 20 条时提示查看全部；无匹配结果时自动展示热门推荐。）\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n| 场景 | 角色 | 示例问法 | 收益 |\r\n| -------- | ---------- | -------------------------------- | -------------------------------- |\r\n| 选题调研 | 内容创作者 | \"帮我看看美食赛道最近什么内容火\" | 快速锁定高互动方向，减少盲目试错 |\r\n| 竞品监控 | 品牌运营 | \"查一下母婴品类在抖音的爆款表现\" | 了解头部内容形态，辅助投放策略 |\r\n| 趋势追踪 | 市场团队 | \"搞笑类内容在抖音还火吗\" | 按数据判断赛道热度，及时调整方向 |\r\n| 日常关注 | 个人用户 | \"每日推送旅行类爆款作品\" | 订阅后自动获取，不错过任何热点 |\r\n\r\n---\n\nFile v1.0.4:_meta.json\n\n{\n \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n \"slug\": \"douyin-search-redfox\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1784627951048\n}\n\nFile v1.0.4:README.en.md\n\n# Douyin Content Search / douyin-search\r\n\r\n---\r\n\r\n## Overview\r\n\r\nEnter a keyword to search for trending viral content on Douyin, presented in a structured table with engagement data including likes, comments, shares, and saves—helping you quickly understand how different content categories are performing on the platform.\r\n\r\n**Core Value**\r\n\r\n- **Instant search**: Enter any content keyword and immediately receive a list of viral works sorted by like count.\r\n- **Comprehensive data**: Each result shows the author, likes, comments, shares, saves, and a clickable link to the original work.\r\n- **Continuous tracking**: Subscribe to keywords of interest and receive daily push notifications with the latest trending data—never miss a trend.\r\n\r\n**Intended Users**\r\n\r\n- 📝 **Content creators** — Track viral content in your niche for data-driven topic and creative inspiration.\r\n- 🏢 **MCN / brand operators** — Quickly gauge the popularity and top-performing content for a specific category on Douyin.\r\n- 📊 **Growth / marketing teams** — Gain keyword-based content trend insights to inform ad placement and topic strategy.\r\n\r\n---\r\n\r\n## Features\r\n\r\n### Core Capabilities\r\n\r\n- **Viral Search**: Keyword-based search for Douyin viral works — precisely discover high-engagement content.\r\n- **Date Filtering**: Filter by date range to pinpoint popular content within a specific timeframe.\r\n- **Smart Expansion**: Automatically broadens generic keywords into 10 niche terms, avoiding skewed search results.\r\n- **Hot Recommendations**: Recommends trending works and topics when no results found — never leave empty-handed.\r\n- **Clickable Links**: Work titles output as hyperlinks — one click to the original Douyin video.\r\n- **Subscription Push**: Subscribe to keywords for daily automated updates with the latest viral trends.\r\n\r\n### Highlights\r\n\r\n- **Smart expansion guidance**: When entering broad category terms (e.g., \"food,\" \"fashion\"), the system automatically generates 10 niche sub-directions for you to choose from, precisely targeting the right track and avoiding skewed search results.\r\n- **Fallback hot recommendations**: When a keyword returns no matches, trending works and topics are automatically recommended—you'll never leave empty-handed.\r\n- **One-click subscription**: No extra steps—search, subscribe, and receive daily 10:00 AM push notifications with the latest viral content for that keyword.\r\n- **Clickable deep links**: Every work title in the table is a clickable hyperlink, taking you directly to the original Douyin page for full content viewing.\r\n\r\n---\r\n\r\n## API Key Acquisition & Security\r\n\r\n- This skill requires the environment variable: `REDFOX_API_KEY`.\r\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`).\r\n- Register at [RedFoxHub](https://redfox.hk?source=github) to obtain `REDFOX_API_KEY`.\r\n- Configure `REDFOX_API_KEY` on your device before using this skill.\r\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\r\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\nSimply describe the content category you want to explore in natural language—no fixed commands to memorize.\r\n\r\n### Quick Reference\r\n\r\n| Intent | Example phrase | Result |\r\n| -------------------------------- | ------------------------------------------------------ | --------------------------------------------------------------------- |\r\n| Search viral content by category | \"Today's trending food content\" | Recognized as broad term, suggests 10 niche directions to choose from |\r\n| Search a specific niche | \"Is low-carb meal content popular on Douyin?\" | Searches the niche term directly, displays results sorted by likes |\r\n| Casual conversational search | \"Funny videos seem hot lately\" | Auto-extracts \"funny,\" returns trending works |\r\n| Filter by date range | \"Travel content from May 30 to June 2\" | Parses date range, returns viral works from that period |\r\n| No results? No problem | When a niche keyword finds no matches | Auto-displays trending works and hot topic recommendations |\r\n| Subscribe to daily updates | Select \"Subscribe\" after a search | Daily push at 10:00 AM with the latest viral content for that keyword |\r\n\r\n### Output Example\r\n\r\nAfter a search, you'll see a table like this (illustrative):\r\n\r\n| # | Work Title | Author | Likes | Comments | Shares | Saves | Published |\r\n| --- | ------------------------------------------------ | -------------- | ------ | -------- | ------ | ------ | ----------- |\r\n| 1 | [Let me show you how to make this dish…](link) | FoodieA | 305.2w | 7.1w | 51.0w | 14.7w | 06-01 19:55 |\r\n| 2 | [Travel vlog: A spontaneous weekend trip…](link) | TravelBloggerB | 158.3w | 3.2w | 22.1w | 8.5w | 05-30 15:30 |\r\n\r\n(20 results shown by default; when more than 20, prompted to view all; when no matches found, hot recommendations are shown automatically.)\r\n\r\n---\r\n\r\n## Use Cases\r\n\r\n| Scenario | Role | Example question | Benefit |\r\n| ---------------------- | --------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------- |\r\n| Topic research | Content creator | \"What food content is trending on Douyin lately?\" | Quickly pinpoint high-engagement directions, reduce blind trial-and-error |\r\n| Competitive monitoring | Brand operator | \"Check the viral performance of the baby & maternity category on Douyin\" | Understand top content formats, inform ad strategy |\r\n| Trend tracking | Marketing team | \"Is comedy content still popular on Douyin?\" | Judge niche heat by data, adjust direction in time |\r\n| Daily monitoring | Individual user | \"Push me daily updates on travel viral content\" | Subscribe once and receive automatic updates—never miss a trend |\r\n\r\n---\n\nFile v1.0.4:skill-card.md\n\n## Description:
\nSearches Douyin for viral content by keyword and optional date range, then presents engagement data in structured result tables.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[redfox-data](https://clawhub.ai/user/redfox-data)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nContent creators, MCN and brand operators, growth teams, and marketing teams use this skill to find high-engagement Douyin works, compare content performance, and monitor keyword trends.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill sends a RedFox API key and Douyin search terms to redfox.hk.
\nMitigation: Confirm the key scope, retention policy, and reset or revocation process before use; keep the key in environment configuration rather than prompts, logs, or source files.
\nRisk: The subscription feature can create persistent daily scheduled tasks.
\nMitigation: Before enabling daily pushes, confirm where the task will be created, how to pause or delete it, and what keyword and date data will be retained.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/redfox-data/skills/douyin-search-redfox)
\n- [RedFoxHub API key settings](https://redfox.hk/settings/api-keys?source=clawhub)
\n- [RedFoxHub](https://redfox.hk)
\n- [RedFoxHub enterprise service](https://redfox.hk/dashboard/enterprise)
\n\n\n## Skill Output:
\n**Output Type(s):** [Markdown, Shell commands, Configuration, Guidance]
\n**Output Format:** [Markdown tables and text, with helper-script JSON used as the source data.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Search output includes clickable Douyin work links, engagement counts, publication time, hot recommendations, and optional subscription guidance.]
\n\n## Skill Version(s):
\n1.0.4 (source: release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.3: 6 files, 12161 bytes\n\nFiles: README.en.md (6200b), README.md (4937b), scripts/search_douyin.py (3985b), skill-card.md (2463b), SKILL.md (7019b), _meta.json (139b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: douyin-search\ndescription: 抖音爆款作品查询工具。根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词：抖音爆款、抖音热门、抖音热榜、抖音作品查询、抖音搜索、爆款视频、热门视频。\n---\n\n# 抖音作品查询\n\n## 📝 简介\n\n根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，返回点赞、评论、分享、收藏、发布时间等互动数据，结果以结构化表格展示。\n\n## ✨ 功能特性\n\n| 功能模块 | 能力描述 | 核心价值 |\n|---------|---------|---------|\n| 爆款搜索 | 关键词搜索抖音爆款作品 | 精准发现高热度内容 |\n| 日期筛选 | 支持按日期范围筛选 | 定位特定时间段的热门内容 |\n| 智能拓展 | 泛化词自动拓展为 10 个细分词 | 避免泛化词搜索结果偏差 |\n| 热门推荐 | 无结果时推荐热门作品和话题 | 兜底保障不空手而归 |\n| 可点击链接 | 作品标题以超链接格式输出 | 一键跳转查看原作品 |\n| 订阅推送 | 支持关键词每日推送 | 定时获取最新爆款动态 |\n\n## 🔑 鉴权\n\n- 获取 API Key：前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub)\n- 配置方式1：写入 `~/.openclaw/openclaw.json` → `{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }`\n- 配置方式2：终端执行 `export REDFOX_API_KEY=\"ak_xxxx...\"`\n\n## ⚙️ 工作流程\n\n### Step 1: 🔍 用户意图理解\n\n**⚠️ 核心规则：优先提取细分方向词，而非泛化的大类词**\n\n| 用户输入 | 处理方式 |\n|---------|--------|\n| 无赛道关键词（\"最近热门作品\"） | 关键词传空字符串 `\"\"`，查询全站热门 |\n| 有细分词（\"职场穿搭\"、\"减脂餐\"） | 直接搜索，无需拓展 |\n| 有泛化词（\"穿搭\"、\"美食\"） | 执行拓展策略（Step 2） |\n\n细分词判断原则：有场景/人群/风格/意图修饰 → 细分词；纯大类无修饰 → 泛化词。\n\n**提取精确关键词**：从用户描述中提取细分领域词，而非泛化词。例：用户说\"帮我找电影领域热门话题\"且自称\"小众电影、港台文化\" → 搜索\"小众电影、港台电影、电影乐评\"，❌ 而非只搜\"电影\"。\n\n### Step 2: 🔄 泛化词拓展策略\n\n**⚠️ 必须等待用户明确回复后再调用脚本！**\n\n| 步骤 | 操作 |\n|------|------|\n| 1. 生成细分词 | 生成10个适中大小的细分词（趋势词、人群词、场景词、意图词各2-3个），禁止调用脚本 |\n| 2. 等待用户回复 | 用户未回复时禁止调用脚本 |\n| 3. 执行 | 回复「拓展」→ 10词以英文逗号连接，仅调用一次脚本；回复「不拓展」→ 搜索原关键词 |\n\n输出示例：\n```text\n我识别到「中产」是较大的分类，推荐以下细分方向：\n老钱,轻奢,品质生活,松弛感,高级感穿搭,体面,法式穿搭,律师,医生,品质家居\n回复「拓展」将同时搜索这10个词，回复「不拓展」将继续搜索「中产」\n```\n\n### Step 3: 📡 调用 API 接口\n\n**3.1 时间解析规则**\n\n| 用户输入 | 解析方式 | 示例 |\n|---------|---------|------|\n| 绝对日期 | 解析为 `YYYY-MM-DD` | `6月1号` → `2026-06-01` |\n| 相对日期 | 基于当前日期计算 | `最近7天` → start=7天前, end=今天 |\n| 日期范围 | 分别解析为 startDate/endDate | `5月30日到6月2日` |\n| 模糊时间 | **不解析**，保持默认空字符串 | `最近的`、`最新的` |\n\n- `startDate`/`endDate` 默认空字符串，表示不限定时间\n- 单日期 → startDate = endDate；年份省略取当前年份\n\n**3.2 执行脚本**\n\n```bash\n# 无时间参数\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\"\n\n# 有时间参数\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\" --start-date --end-date \n```\n\n仅传入非空的时间参数。脚本返回 JSON：\n\n| 字段 | 说明 |\n|------|------|\n| articles | 搜索匹配的作品列表（按点赞数降序） |\n| latestHotArticles | 近期热门推荐作品列表 |\n| hotTopics | 热门话题列表 |\n\n每条作品字段：`title`、`author`、`like_count`、`comment_count`、`share_count`、`collect_count`、`work_url`、`publish_time`、`follower_count`\n\n### Step 4: 📊 结果展示\n\n**⚠️ 总数校验**：展示的 N 必须取自 `articles` 数组长度，禁止人工计数。\n\n#### 情况 A：articles > 0\n\n**A1.** 输出查询范围：\n\n> 📊 关键词「**XXX**」共匹配到 **N 条**抖音爆款作品，以下是详细数据：\n\n**A2.** 展示前 20 条表格：\n\n```markdown\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\n|---|---------|------|--------|--------|--------|--------|----------|\n| 1 | [标题](work_url) | 作者名 | 305.2w | 7.1w | 51.0w | 14.7w | 06-02 19:55 |\n```\n\n格式化规则：\n- 数字 < 10000 直接展示；≥ 10000 用 `x.xw` 格式\n- `publish_time` 转为 `MM-DD HH:MM`；无论是否指定时间范围均展示\n- 标题超 30 字截断加 `...`，使用 `[标题](work_url)` 链接格式\n\n**A3.** articles > 20 时提示：\n\n> 以上展示了前 20 条数据，还剩 **N 条**未展示。回复「查看全部」展开剩余数据。\n\n**A4-A5.** 仅 articles ≤ 10 时执行：\n- `latestHotArticles` 非空 → 展示「🔥 近期热门推荐作品」表格（最多10条）\n- `hotTopics` 非空 → 展示「🏷️ 热门话题」列表\n- 为空则跳过，不输出\n\n**⚠️ A1~A5 同一轮输出连续完成，A5 后紧跟 Step 5。**\n\n#### 情况 B：articles = 0\n\n**B1.** 抱歉提示 + 10个扩展词（以英文逗号分隔）：\n\n> 😔 抱歉，未找到与「**XXX**」相关的内容，可尝试（扩展词1,扩展词2,...,扩展词10）\n\n扩展词规则：基于原关键词语义扩展，每词2-6字，固定10个。\n\n**B2-B3.** 展示 `latestHotArticles`（💡 推荐提示）和 `hotTopics`，为空则跳过。\n\n**⚠️ B1~B3 同一轮输出连续完成，B3 后紧跟 Step 5。**\n\n### Step 5: 📩 提示订阅\n\n展示完毕后末尾附上：\n\n> 📩 是否订阅「**XXX**」的每日推送？订阅后每天 10:00 自动推送最新爆款作品。回复「确认订阅」即可创建定时任务。\n\n### Step 6: ⏰ 创建定时任务（用户回复「确认订阅」时执行）\n\n优先使用平台内置定时任务，若无则提供通用方案：\n\n- 任务名称：`抖音爆款作品订阅 - <关键词>`\n- 执行频率：每天 10:00（cron `0 10 * * *`）\n- 执行命令：`python3 <脚本路径>/search_douyin.py \"<关键词>\"`（有时间参数则附加 `--start-date`/`--end-date`）\n- 通用 crontab：`0 10 * * * python3 /path/to/search_douyin.py \"<关键词>\"`\n\n创建成功后告知：\"已成功订阅关键词「<关键词>」的爆款作品推送，每天 10:00 将自动查询最新数据并通知你。\"\n\nFile v1.0.3:README.md\n\n# 抖音作品查询 / douyin-search\n\n---\n\n## 简介\n\n输入关键词即可查询抖音热门爆款作品，以结构化表格呈现点赞、评论、分享、收藏等互动数据，帮你快速掌握各类内容在抖音的真实表现。\n\n**核心价值**\n\n- **即搜即看**：输入任意内容关键词，立刻获取按点赞数排序的爆款作品列表。\n- **数据全面**：每条作品展示作者、点赞数、评论数、分享数、收藏数及可跳转的原文链接。\n- **持续关注**：支持订阅感兴趣的关键词，每天定时推送最新爆款数据，不错过任何趋势。\n\n**适用对象**\n\n- 📝 **内容创作者** — 追踪同赛道爆款，为选题与创作提供数据参考。\n- 🏢 **MCN / 品牌运营** — 快速了解特定品类在抖音的热度与头部内容表现。\n- 📊 **增长 / 市场团队** — 按关键词洞察内容趋势，辅助投放与选题决策。\n\n---\n\n## 功能特性\n\n### 核心功能\n\n- **爆款搜索**：关键词搜索抖音爆款作品，精准发现高热度内容。\n- **日期筛选**：支持按日期范围筛选，定位特定时间段的热门内容。\n- **智能拓展**：泛化词自动拓展为 10 个细分词，避免泛化词搜索结果偏差。\n- **热门推荐**：无结果时推荐热门作品和话题，兜底保障不空手而归。\n- **可点击链接**：作品标题以超链接格式输出，一键跳转查看原作品。\n- **订阅推送**：支持关键词每日推送，定时获取最新爆款动态。\n\n### 特色亮点\n\n- **泛化保命中**：不要求精确关键词，口语化输入也能获得有效结果，降低使用门槛。\n- **一键订阅**：无需额外操作，查完即订，每日自动推送，持续追踪趋势变化。\n- **数据可点击**：表格中每条作品标题均可直接跳转到抖音原始页面，方便深度查看。\n\n---\n\n## 密钥获取与安全说明\n\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\n- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\n\n---\n\n## 使用指南\n\n直接用自然语言说出你想查的内容方向即可，无需记忆固定命令。\n\n### 常用说法速查\n\n| 意图 | 示例话术 | 效果 |\n| ---------------- | ---------------------------------- | ----------------------------------- |\n| 查某类内容的爆款 | \"今日美食热门作品\" | 自动泛化为\"美食\"，返回爆款表格 |\n| 查某个赛道表现 | \"帮我看看旅行类在抖音火不火\" | 以\"旅行\"查询，按点赞排序展示 |\n| 口语化随意搜 | \"最近搞笑视频挺火的\" | 自动提取\"搞笑\"，返回热门作品 |\n| 按时间筛选 | \"5月30号到6月2号的旅游作品\" | 解析日期范围，返回该时段爆款作品 |\n| 查看全部结果 | 表格展示后选择\"查看全部\" | 续接展示剩余数据（最多 50 条） |\n| 订阅每日推送 | 查询后选择\"确认订阅\" | 每天 10:00 自动推送该关键词最新爆款 |\n\n### 输出示例\n\n查询完成后，你将看到类似以下格式的表格（示意）：\n\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\n| --- | ------------------------------- | --------- | ------ | ------ | ------ | ------ | --------- |\n| 1 | [跟我一起来做这道菜…](链接) | 美食达人A | 305.2w | 7.1w | 51.0w | 14.7w | 06-01 19:55 |\n| 2 | [旅行vlog：周末说走就走…](链接) | 旅行博主B | 158.3w | 3.2w | 22.1w | 8.5w | 05-30 15:30 |\n\n（共展示 20 条，数据超过 20 条时提示查看全部。）\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 示例问法 | 收益 |\n| -------- | ---------- | -------------------------------- | -------------------------------- |\n| 选题调研 | 内容创作者 | \"帮我看看美食赛道最近什么内容火\" | 快速锁定高互动方向，减少盲目试错 |\n| 竞品监控 | 品牌运营 | \"查一下母婴品类在抖音的爆款表现\" | 了解头部内容形态，辅助投放策略 |\n| 趋势追踪 | 市场团队 | \"搞笑类内容在抖音还火吗\" | 按数据判断赛道热度，及时调整方向 |\n| 日常关注 | 个人用户 | \"每日推送旅行类爆款作品\" | 订阅后自动获取，不错过任何热点 |\n\n---\n\nFile v1.0.3:_meta.json\n\n{\n \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n \"slug\": \"douyin-search-redfox\",\n \"version\": \"1.0.3\",\n \"publishedAt\": 1780557731372\n}\n\nFile v1.0.3:README.en.md\n\n# Douyin Content Search / douyin-search\n\n---\n\n## Overview\n\nEnter a keyword to search for trending viral content on Douyin, presented in a structured table with engagement data including likes, comments, shares, and saves—helping you quickly understand how different content categories are performing on the platform.\n\n**Core Value**\n\n- **Instant search**: Enter any content keyword and immediately receive a list of viral works sorted by like count.\n- **Comprehensive data**: Each result shows the author, likes, comments, shares, saves, and a clickable link to the original work.\n- **Continuous tracking**: Subscribe to keywords of interest and receive daily push notifications with the latest trending data—never miss a trend.\n\n**Intended Users**\n\n- 📝 **Content creators** — Track viral content in your niche for data-driven topic and creative inspiration.\n- 🏢 **MCN / brand operators** — Quickly gauge the popularity and top-performing content for a specific category on Douyin.\n- 📊 **Growth / marketing teams** — Gain keyword-based content trend insights to inform ad placement and topic strategy.\n\n---\n\n## Features\n\n### Core Capabilities\n\n- **Viral Search**: Keyword-based search for Douyin viral works — precisely discover high-engagement content.\n- **Date Filtering**: Filter by date range to pinpoint popular content within a specific timeframe.\n- **Smart Expansion**: Automatically broadens generic keywords into 10 niche terms, avoiding skewed search results.\n- **Hot Recommendations**: Recommends trending works and topics when no results found — never leave empty-handed.\n- **Clickable Links**: Work titles output as hyperlinks — one click to the original Douyin video.\n- **Subscription Push**: Subscribe to keywords for daily automated updates with the latest viral trends.\n\n### Highlights\n\n- **Generalization for guaranteed hits**: No need for precise keywords—casual, conversational input still yields effective results, lowering the learning curve.\n- **One-click subscription**: No extra steps—search, subscribe, and receive daily push notifications to stay on top of trend changes.\n- **Clickable data**: Every work title in the table links directly to the original Douyin page for deeper inspection.\n\n---\n\n## API Key Acquisition & Security\n\n- This skill requires the environment variable: `REDFOX_API_KEY`.\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`).\n- Register at [RedFoxHub](https://redfox.hk?source=github) to obtain `REDFOX_API_KEY`.\n- Configure `REDFOX_API_KEY` on your device before using this skill.\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\n\n---\n\n## Usage Guide\n\nSimply describe the content category you want to explore in natural language—no fixed commands to memorize.\n\n### Quick Reference\n\n| Intent | Example phrase | Result |\n| -------------------------------- | ------------------------------------------------------ | --------------------------------------------------------------------- |\n| Search viral content by category | \"Today's trending food content\" | Auto-generalizes to \"food,\" returns a viral content table |\n| Check a niche's performance | \"Is travel content popular on Douyin?\" | Queries \"travel,\" displays results sorted by likes |\n| Casual conversational search | \"Funny videos seem hot lately\" | Auto-extracts \"funny,\" returns trending works |\n| Filter by date range | \"Travel content from May 30 to June 2\" | Parses date range, returns viral works from that period |\n| View all results | Select \"View all\" after the table appears | Continues displaying remaining data (up to 50) |\n| Subscribe to daily updates | Select \"Subscribe\" after a search | Daily push at 10:00 AM with the latest viral content for that keyword |\n\n### Output Example\n\nAfter a search, you'll see a table like this (illustrative):\n\n| # | Work Title | Author | Likes | Comments | Shares | Saves | Published |\n| --- | ------------------------------------------------ | -------------- | ------ | -------- | ------ | ------ | ----------- |\n| 1 | [Let me show you how to make this dish…](link) | FoodieA | 305.2w | 7.1w | 51.0w | 14.7w | 06-01 19:55 |\n| 2 | [Travel vlog: A spontaneous weekend trip…](link) | TravelBloggerB | 158.3w | 3.2w | 22.1w | 8.5w | 05-30 15:30 |\n\n(20 results shown by default; when there are more, you'll be prompted to view all.)\n\n---\n\n## Use Cases\n\n| Scenario | Role | Example question | Benefit |\n| ---------------------- | --------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------- |\n| Topic research | Content creator | \"What food content is trending on Douyin lately?\" | Quickly pinpoint high-engagement directions, reduce blind trial-and-error |\n| Competitive monitoring | Brand operator | \"Check the viral performance of the baby & maternity category on Douyin\" | Understand top content formats, inform ad strategy |\n| Trend tracking | Marketing team | \"Is comedy content still popular on Douyin?\" | Judge niche heat by data, adjust direction in time |\n| Daily monitoring | Individual user | \"Push me daily updates on travel viral content\" | Subscribe once and receive automatic updates—never miss a trend |\n\n---\n\nFile v1.0.3:skill-card.md\n\n## Description:
\n抖音爆款作品查询工具，根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，并以结构化表格展示结果。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[redfox-data](https://clawhub.ai/user/redfox-data)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nContent creators, brand operators, MCN teams, growth teams, and marketing teams use this skill to search Douyin viral content by keyword, filter by date range, and review engagement metrics for trend research and content planning.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires a locally stored RedFox API key.
\nMitigation: Store REDFOX_API_KEY in an environment or agent secret store, avoid hard-coding it in prompts or files, and rotate or revoke it if exposure is suspected.
\nRisk: Search terms are sent to RedFox when the Douyin search script runs.
\nMitigation: Avoid submitting sensitive, confidential, or regulated terms unless that data sharing is acceptable for the deployment.
\nRisk: Subscription behavior may create recurring background jobs.
\nMitigation: Before enabling a subscription, confirm the schedule, where the task is stored, and the exact procedure to view, disable, and delete it.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/redfox-data/douyin-search-redfox)
\n- [RedFox API key settings](https://redfox.hk/settings/api-keys?source=clawhub)
\n- [RedFoxHub](https://redfox.hk)
\n- [Chinese README](README.md)
\n- [English README](README.en.md)
\n\n\n## Skill Output:
\n**Output Type(s):** [Markdown, Shell commands, Configuration, Guidance]
\n**Output Format:** [Markdown tables with linked Douyin works, concise text guidance, and shell command examples.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires REDFOX_API_KEY. May include date-filtered search results, hot recommendations, topic lists, and subscription scheduling guidance.]
\n\n## Skill Version(s):
\n1.0.3 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.2: 6 files, 14105 bytes\n\nFiles: README.en.md (6560b), README.md (5340b), scripts/search_douyin.py (3985b), skill-card.md (2561b), SKILL.md (12530b), _meta.json (139b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: douyin-search\ndescription: 抖音爆款作品查询工具。根据用户输入的关键词搜索抖音热门爆款作品，结果以表格展示。当用户想要查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据、了解某类内容在抖音的表现时使用。触发词包括：抖音爆款、抖音热门、抖音热榜、抖音作品查询、抖音搜索、爆款视频、热门视频。\n---\n\n# 抖音作品查询\n\n## 鉴权\n\n### 获取 API Key\n\n请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 获取API KEY\n\n### 配置 API Key\n\n方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下：\n\n```bash\n{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }\n```\n\n方案2: 终端配置\n\n```bash\nexport REDFOX_API_KEY=\"ak_xxxx...\"\n```\n\n## 工作流程\n\n### Step 1: 用户意图理解（查询脚本前）\n\n**⚠️ 核心规则：应该语义理解，优先提取用户描述中的细分方向词，而非泛化的大类词**\n\n**1. 判断用户是否提到赛道关键词**：\n- **无赛道关键词**（如\"最近的热门作品有哪些\"、\"最近有什么热门内容\"、\"看看热门数据\"）→ 直接调用脚本，关键词传空字符串 `\"\"`，查询全站热门\n- **有赛道关键词** → 继续提取和判断\n\n**2. 提取精确搜索关键词**（仅当用户提到赛道时执行）：\n- **分析用户描述**：从用户自我介绍或需求描述中提取明确的细分领域词\n- 示例分析：\n - 用户输入：\"我是一个文艺类自媒体万粉抖音博主，平时会发小众电影审美积累、书评、乐评、港台文化等相关内容，帮我找电影领域热门话题\"\n - 分析结果：用户提到的细分方向 = 小众电影、书评、乐评、港台文化\n - 将前文场景和\"电影\"相关，得到细分词 = 小众电影、港台电影、电影乐评\n - 搜索关键词：小众电影、港台电影、电影乐评\n - ❌ 错误做法：只提取泛化词「电影」去搜索\n\n**3. 关键词类型判断**（仅当提取到关键词时执行）：\n- **细分词/垂直赛道**（含具体场景/属性修饰的词，如\"职场穿搭\"、\"减脂餐\"、\"小个子穿搭\"）→ 直接搜索，无需拓展询问\n- **泛化词/分类**（纯大类词，如\"穿搭\"、\"美食\"、\"美妆\"，无任何修饰）→ 执行拓展策略（Step 2）\n- **判断原则**：有修饰词（场景/人群/风格/意图）= 细分词，直接搜索；无修饰词 = 泛化词，需要拓展\n\n### Step 2: 泛化词拓展策略\n\n**泛化词处理流程（⚠️ 必须等待用户明确回复后再调用脚本！）**：\n\n**第一步：生成细分词**（禁止调用脚本搜索数据）\n- 拓展词生成原则：\n - **词的大小适中**：词语不要加组合，避免过细（如\"中产穿搭\"太细，查不到数据）\n - **必须覆盖不同场景**：趋势词、人群词、场景词、意图词各 2-3 个\n- 输出示例：\n ```\n 我识别到「中产」是较大的分类，已查询近期热门趋势，推荐以下细分方向：\n 老钱,轻奢,品质生活,松弛感,高级感穿搭,体面,法式穿搭,律师,医生,品质家居\n 回复「拓展」将同时搜索这 10 个词，回复「不拓展」将继续搜索「中产」\n ```\n\n**第二步：等待用户回复**\n- ❌ **禁止**：用户未回复时调用脚本\n- ✅ **正确**：只等待用户明确回复「拓展」或「不拓展」后再执行\n\n**第三步：根据用户明确回复执行**\n- 用户回复「拓展」 → 将 10 个细分词以英文逗号 `,` 连接为一个字符串（不加空格），**仅调用一次脚本**传入（如 `\"老钱,轻奢,品质生活\"`），禁止逐个词多次调用\n- 用户回复「不拓展」或「继续」 → 调用脚本搜索原关键词\n- 用户未回复或回复其他内容 → 识别对应意图\n\n### Step 3: 调用搜索接口\n\n**3.1 时间解析规则**\n\n在调用脚本前，需判断用户 query 中是否包含时间信息，并解析为 `startDate` 和 `endDate` 参数：\n\n- **默认值**：`startDate` 和 `endDate` 均为空字符串 `\"\"`，表示不限定时间范围\n- **需要解析时间的场景**：用户 query 中包含明确的时间表达，例如：\n - 绝对日期：`2025年6月1日`、`2025-06-01`、`6月1号` → 解析为 `2025-06-01`\n - 相对日期：`昨天`、`前天`、`最近3天`、`最近一周`、`最近7天` → 根据当前日期计算\n - 日期范围：`6月1日到6月3日`、`上周` → 分别解析为 startDate 和 endDate\n - 模糊时间：`最近的`、`最新的` → **不解析为日期**，保持默认空字符串，由接口返回最新数据\n\n- **解析规则**：\n - 仅解析绝对日期或明确相对日期，不解析模糊时间词\n - 日期格式统一为 `YYYY-MM-DD`\n - 若用户只提到单个日期（如`6月1日`），则 `startDate` = `endDate` = 该日期\n - 若用户提到时间范围（如`最近7天`），则 `startDate` = 范围起始日，`endDate` = 范围结束日（今天）\n - 年份省略时默认取当前年份\n\n**3.2 执行脚本**\n\n根据时间解析结果，构建脚本调用命令：\n\n**无时间参数时**：\n```bash\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\"\n```\n\n**有时间参数时**：\n```bash\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\" --start-date --end-date \n```\n\n仅传入非空的时间参数，空字符串的参数无需传入（脚本默认值为空字符串）。\n\n脚本返回 JSON 对象，包含以下字段：\n\n| 字段 | 说明 |\n| ------------------ | ---------------- |\n| articles | 搜索匹配的作品列表（按点赞数降序） |\n| latestHotArticles | 近期热门推荐作品列表 |\n| hotTopics | 热门话题列表 |\n\n每条作品（articles / latestHotArticles）包含字段：\n\n| 字段 | 说明 |\n| -------------- | -------- |\n| title | 作品标题 |\n| author | 作者名称 |\n| like_count | 点赞数 |\n| comment_count | 评论数 |\n| share_count | 分享数 |\n| collect_count | 收藏数 |\n| work_url | 作品链接 |\n| publish_time | 发布时间 |\n| follower_count | 粉丝数 |\n\n### Step 4: 判断搜索结果并展示\n\n根据 `articles` 数量选择不同的展示策略：\n\n#### 情况 A：articles 数量 > 0（有匹配结果）\n\n**A1. 告知用户数据查询范围**\n\n首先输出一句提示，告知用户本次查询的范围：\n\n> 📊 关键词「**XXX**」共匹配到 **N 条**抖音爆款作品，以下是详细数据：\n\n**⚠️ 总数校验规则**：N 必须直接取自脚本返回 JSON 中 `articles` 数组的长度（`len(articles)`），禁止人工计数或估算，确保总数准确无误。\n\n**A2. 展示作品表格（默认前 20 条）**\n\n将 `articles` 渲染为 Markdown 表格，默认展示前 **20 条**（按点赞数降序），格式如下：\n\n```markdown\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\n| --- | -------------------- | ------ | ------ | ------ | ------ | ------ | -------- |\n| 1 | [标题文字](作品链接) | 作者名 | 305.2w | 7.1w | 51.0w | 14.7w | 06-02 19:55 |\n| 2 | [标题文字](作品链接) | 作者名 | 158.3w | 3.2w | 22.1w | 8.5w | 05-30 15:30 |\n```\n\n**数字格式化规则：**\n\n- 小于 10000：直接展示原始数字（如 `320`）\n- 大于等于 10000：使用 `x.xw` 格式（如 `1.2w` 代表 12000）\n\n**发布时间格式化规则：**\n\n- 将 `publish_time`（格式 `YYYY-MM-DD HH:MM:SS`）转换为 `MM-DD HH:MM` 格式展示（如 `2026-06-02 19:55:03` → `06-02 19:55`）\n- 不管用户是否指定了时间范围查询，均展示发布时间列\n\n**标题链接规则：**\n\n- 作品标题使用 Markdown 链接格式 `[标题](work_url)`，点击可跳转到抖音作品页\n- 如果标题过长（超过 30 字），截断并加 `...`\n\n**A3. 查看全部数据（当结果超过 20 条时）**\n\n如果 `articles` 总条数 > 20，在表格下方输出提示后**不等待，立刻继续**输出 A4：\n\n> 以上展示了前 20 条数据，还剩 **N 条**未展示。需要查看全部数据吗？回复「查看全部」即可。\n\n**当用户在后续对话中回复「查看全部」时**：将第 21 条起的所有剩余数据，以相同表格格式续接展示，编号从 #21 开始连续递增，直到全部展示完毕。\n\n**articles ≤ 20 时**：跳过本步骤，直接进入 A4。\n\n**A4. 展示热门推荐数据（latestHotArticles）**\n\n**仅在 `articles` 总条数 ≤ 10 时执行本步骤。**\n\n如果 `articles` 总条数 ≤ 10 且 `latestHotArticles` 不为空，展示热门推荐作品表格（最多 10 条），标题为：\n\n> 🔥 **近期热门推荐作品**\n\n使用与 A2 相同的表格格式和数字格式化规则。**若为空或 articles > 10 则跳过本模块，不输出任何内容。**\n\n**A5. 展示热门话题（hotTopics）**\n\n**仅在 `articles` 总条数 ≤ 10 时执行本步骤。**\n\n如果 `articles` 总条数 ≤ 10 且 `hotTopics` 不为空，以列表形式展示热门话题：\n\n> 🏷️ **热门话题**\n>\n> - #话题1\n> - #话题2\n> - ...\n\n**若为空或 articles > 10 则跳过本模块，不输出任何内容。**\n\n**⚠️ A1~A5 必须在同一轮输出中连续完成，输出 A5 后紧跟 Step 5 订阅提示，不得中断。**\n\n#### 情况 B：articles 数量 = 0（无匹配结果）\n\n**B1. 抱歉提示 + 拓词推荐**\n\n> 😔 抱歉，未找到与「**XXX**」直接相关的内容，你可以尝试用更短或更宽泛的关键词重试（扩展词1,扩展词2,扩展词3,扩展词4,扩展词5,扩展词6,扩展词7,扩展词8,扩展词9,扩展词10）\n\nAI 必须根据用户搜索的关键词生成 **固定 10 个**扩展搜索词，以英文逗号 `,` 分隔展示在一行括号内。\n\n生成规则：\n- 基于原始关键词进行语义扩展（如同义词、上下位词、相关场景词）\n- 每个扩展词保持在 2-6 个汉字\n- 优先推荐更细分或更宽泛的相关方向\n- **必须生成恰好 10 个，不得少于 10 个**\n\n**B2. 热门推荐数据（latestHotArticles）**\n\n如果 `latestHotArticles` 不为空，展示热门推荐作品：\n\n> 💡 我们为您推荐了近期的其他热门作品供参考，或许对您有帮助：\n\n随后以表格格式展示 `latestHotArticles`（最多 10 条），格式同情况 A 的表格。**若为空则跳过本模块，不输出任何内容。**\n\n**B3. 展示热门话题（hotTopics）**\n\n如果 `hotTopics` 不为空，以列表形式展示，格式同 A5。**若为空则跳过本模块，不输出任何内容。**\n\n**⚠️ B1~B3 必须在同一轮输出中连续完成，输出 B3 后紧跟 Step 5 订阅提示，不得中断。**\n\n### Step 5: 提示订阅\n\n全部内容展示完毕后，**不等待、立刻结束输出**，仅在末尾附上订阅提示：\n\n> 📩 是否订阅「**XXX**」的每日推送？订阅后每天 10:00 自动推送最新爆款作品。回复「确认订阅」即可创建定时任务。\n\n### Step 6: 创建定时任务（用户在后续对话中回复「确认订阅」时执行）\n\n优先使用当前平台内置的定时任务/自动化能力创建订阅，若无则提供通用配置方案：\n\n**1. 平台内置定时任务**（优先）\n如果当前平台提供定时任务或 cron 自动化功能：直接调用该功能创建订阅，配置如下：\n- 任务名称：`抖音爆款作品订阅 - <关键词>`\n- 执行频率：每天 10:00（北京时间，cron 表达式 `0 10 * * *`）\n- 执行内容：运行 `python3 <脚本路径>/search_douyin.py \"<关键词>\"`（如有时间参数则附加 `--start-date` 和 `--end-date`），将结果按 SKILL.md 中 Step 4-5 的格式展示并推送到当前对话\n\n**2. 通用配置方案**（平台无内置定时任务时）\n向用户提供以下信息，由用户自行配置：\n- 执行命令：`python3 <脚本路径>/search_douyin.py \"<关键词>\"`（如有时间参数则附加 `--start-date` 和 `--end-date`）\n- **Linux/macOS crontab**：`0 10 * * * python3 /path/to/search_douyin.py \"<关键词>\"`（如有时间参数则附加 `--start-date` 和 `--end-date`）\n- **其他平台**：参照对应平台的定时任务文档配置上述命令\n\n创建成功后告知用户：\"已成功订阅关键词「<关键词>」的爆款作品推送，每天 10:00 将自动查询最新数据并通知你。\"\n\nFile v1.0.2:README.md\n\n# 抖音作品查询 / douyin-search\n\n---\n\n## 简介\n\n输入关键词即可查询抖音热门爆款作品，以结构化表格呈现点赞、评论、分享、收藏等互动数据，帮你快速掌握各类内容在抖音的真实表现。\n\n**核心价值**\n\n- **即搜即看**：输入任意内容关键词，立刻获取按点赞数排序的爆款作品列表。\n- **数据全面**：每条作品展示作者、点赞数、评论数、分享数、收藏数及可跳转的原文链接。\n- **持续关注**：支持订阅感兴趣的关键词，每天定时推送最新爆款数据，不错过任何趋势。\n\n**适用对象**\n\n- 📝 **内容创作者** — 追踪同赛道爆款，为选题与创作提供数据参考。\n- 🏢 **MCN / 品牌运营** — 快速了解特定品类在抖音的热度与头部内容表现。\n- 📊 **增长 / 市场团队** — 按关键词洞察内容趋势，辅助投放与选题决策。\n\n---\n\n## 功能特性\n\n### 核心功能\n\n- **关键词搜索**：输入内容主题关键词，返回抖音平台上与该主题相关的高互动爆款作品。\n- **时间范围筛选**：支持按日期范围筛选作品，如「5月30日到6月2日的美食作品」，自动解析为接口参数精确查询。\n- **智能关键词泛化**：自动去除\"今日\"\"热门\"\"爆款\"等修饰词，提取核心主题，确保每次搜索都有结果。例如输入\"今日美食热门\"，会自动以\"美食\"进行查询。\n- **结构化表格展示**：默认展示前 20 条作品，包含可点击跳转的作品标题、作者、点赞数、评论数、分享数、收藏数及发布时间，超过 1 万的数字自动转为\"x.xw\"格式，一目了然。\n- **查看全部数据**：当结果超过 20 条时，可一键展开查看最多 50 条完整数据。\n- **关键词订阅推送**：查询完成后可订阅当前关键词，每天 10:00 自动查询最新爆款作品并推送通知。\n\n### 特色亮点\n\n- **泛化保命中**：不要求精确关键词，口语化输入也能获得有效结果，降低使用门槛。\n- **一键订阅**：无需额外操作，查完即订，每日自动推送，持续追踪趋势变化。\n- **数据可点击**：表格中每条作品标题均可直接跳转到抖音原始页面，方便深度查看。\n\n---\n\n## 密钥获取与安全说明\n\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\n- 请前往 [红狐 hub](https://redfox.hk?source=clawhub) 注册账号，获取 `REDFOX_API_KEY`。\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\n\n---\n\n## 使用指南\n\n直接用自然语言说出你想查的内容方向即可，无需记忆固定命令。\n\n### 常用说法速查\n\n| 意图 | 示例话术 | 效果 |\n| ---------------- | ---------------------------------- | ----------------------------------- |\n| 查某类内容的爆款 | \"今日美食热门作品\" | 自动泛化为\"美食\"，返回爆款表格 |\n| 查某个赛道表现 | \"帮我看看旅行类在抖音火不火\" | 以\"旅行\"查询，按点赞排序展示 |\n| 口语化随意搜 | \"最近搞笑视频挺火的\" | 自动提取\"搞笑\"，返回热门作品 |\n| 按时间筛选 | \"5月30号到6月2号的旅游作品\" | 解析日期范围，返回该时段爆款作品 |\n| 查看全部结果 | 表格展示后选择\"查看全部\" | 续接展示剩余数据（最多 50 条） |\n| 订阅每日推送 | 查询后选择\"确认订阅\" | 每天 10:00 自动推送该关键词最新爆款 |\n\n### 输出示例\n\n查询完成后，你将看到类似以下格式的表格（示意）：\n\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\n| --- | ------------------------------- | --------- | ------ | ------ | ------ | ------ | --------- |\n| 1 | [跟我一起来做这道菜…](链接) | 美食达人A | 305.2w | 7.1w | 51.0w | 14.7w | 06-01 19:55 |\n| 2 | [旅行vlog：周末说走就走…](链接) | 旅行博主B | 158.3w | 3.2w | 22.1w | 8.5w | 05-30 15:30 |\n\n（共展示 20 条，数据超过 20 条时提示查看全部。）\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 示例问法 | 收益 |\n| -------- | ---------- | -------------------------------- | -------------------------------- |\n| 选题调研 | 内容创作者 | \"帮我看看美食赛道最近什么内容火\" | 快速锁定高互动方向，减少盲目试错 |\n| 竞品监控 | 品牌运营 | \"查一下母婴品类在抖音的爆款表现\" | 了解头部内容形态，辅助投放策略 |\n| 趋势追踪 | 市场团队 | \"搞笑类内容在抖音还火吗\" | 按数据判断赛道热度，及时调整方向 |\n| 日常关注 | 个人用户 | \"每日推送旅行类爆款作品\" | 订阅后自动获取，不错过任何热点 |\n\n---\n\nFile v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n \"slug\": \"douyin-search-redfox\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1780541283661\n}\n\nFile v1.0.2:README.en.md\n\n# Douyin Content Search / douyin-search\n\n---\n\n## Overview\n\nEnter a keyword to search for trending viral content on Douyin, presented in a structured table with engagement data including likes, comments, shares, and saves—helping you quickly understand how different content categories are performing on the platform.\n\n**Core Value**\n\n- **Instant search**: Enter any content keyword and immediately receive a list of viral works sorted by like count.\n- **Comprehensive data**: Each result shows the author, likes, comments, shares, saves, and a clickable link to the original work.\n- **Continuous tracking**: Subscribe to keywords of interest and receive daily push notifications with the latest trending data—never miss a trend.\n\n**Intended Users**\n\n- 📝 **Content creators** — Track viral content in your niche for data-driven topic and creative inspiration.\n- 🏢 **MCN / brand operators** — Quickly gauge the popularity and top-performing content for a specific category on Douyin.\n- 📊 **Growth / marketing teams** — Gain keyword-based content trend insights to inform ad placement and topic strategy.\n\n---\n\n## Features\n\n### Core Capabilities\n\n- **Keyword search**: Enter a content topic keyword to retrieve high-engagement viral works on Douyin related to that topic.\n- **Date range filtering**: Filter works by date range, e.g. \"food content from May 30 to June 2\"—automatically parsed into API parameters for precise queries.\n- **Smart keyword generalization**: Automatically removes modifiers like \"today,\" \"trending,\" or \"viral\" to extract the core topic, ensuring every search returns results. For example, \"today's food trending videos\" is automatically queried as \"food.\"\n- **Structured table display**: Shows the top 20 results by default, including clickable work titles, author, likes, comments, shares, saves, and publish time. Numbers above 10,000 are auto-formatted as \"x.xw\" for quick readability.\n- **View all data**: When results exceed 20, expand to view up to 50 entries in one click.\n- **Keyword subscription**: After a search, subscribe to the keyword and receive automatic daily updates at 10:00 AM with the latest viral works.\n\n### Highlights\n\n- **Generalization for guaranteed hits**: No need for precise keywords—casual, conversational input still yields effective results, lowering the learning curve.\n- **One-click subscription**: No extra steps—search, subscribe, and receive daily push notifications to stay on top of trend changes.\n- **Clickable data**: Every work title in the table links directly to the original Douyin page for deeper inspection.\n\n---\n\n## API Key Acquisition & Security\n\n- This skill requires the environment variable: `REDFOX_API_KEY`.\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`).\n- Register at [RedFoxHub](https://redfox.hk?source=clawhub) to obtain `REDFOX_API_KEY`.\n- Configure `REDFOX_API_KEY` on your device before using this skill.\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\n\n---\n\n## Usage Guide\n\nSimply describe the content category you want to explore in natural language—no fixed commands to memorize.\n\n### Quick Reference\n\n| Intent | Example phrase | Result |\n| -------------------------------- | ------------------------------------------------------ | --------------------------------------------------------------------- |\n| Search viral content by category | \"Today's trending food content\" | Auto-generalizes to \"food,\" returns a viral content table |\n| Check a niche's performance | \"Is travel content popular on Douyin?\" | Queries \"travel,\" displays results sorted by likes |\n| Casual conversational search | \"Funny videos seem hot lately\" | Auto-extracts \"funny,\" returns trending works |\n| Filter by date range | \"Travel content from May 30 to June 2\" | Parses date range, returns viral works from that period |\n| View all results | Select \"View all\" after the table appears | Continues displaying remaining data (up to 50) |\n| Subscribe to daily updates | Select \"Subscribe\" after a search | Daily push at 10:00 AM with the latest viral content for that keyword |\n\n### Output Example\n\nAfter a search, you'll see a table like this (illustrative):\n\n| # | Work Title | Author | Likes | Comments | Shares | Saves | Published |\n| --- | ------------------------------------------------ | -------------- | ------ | -------- | ------ | ------ | ----------- |\n| 1 | [Let me show you how to make this dish…](link) | FoodieA | 305.2w | 7.1w | 51.0w | 14.7w | 06-01 19:55 |\n| 2 | [Travel vlog: A spontaneous weekend trip…](link) | TravelBloggerB | 158.3w | 3.2w | 22.1w | 8.5w | 05-30 15:30 |\n\n(20 results shown by default; when there are more, you'll be prompted to view all.)\n\n---\n\n## Use Cases\n\n| Scenario | Role | Example question | Benefit |\n| ---------------------- | --------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------- |\n| Topic research | Content creator | \"What food content is trending on Douyin lately?\" | Quickly pinpoint high-engagement directions, reduce blind trial-and-error |\n| Competitive monitoring | Brand operator | \"Check the viral performance of the baby & maternity category on Douyin\" | Understand top content formats, inform ad strategy |\n| Trend tracking | Marketing team | \"Is comedy content still popular on Douyin?\" | Judge niche heat by data, adjust direction in time |\n| Daily monitoring | Individual user | \"Push me daily updates on travel viral content\" | Subscribe once and receive automatic updates—never miss a trend |\n\n---\n\nFile v1.0.2:skill-card.md\n\n## Description:
\nSearches Douyin for trending works by keyword and returns structured engagement data, including likes, comments, shares, saves, authors, links, and publish times.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[redfox-data](https://clawhub.ai/user/redfox-data)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nContent creators, brand operators, MCN teams, marketers, and individual users use this skill to research viral Douyin content, compare engagement by keyword, filter by date range, and optionally set up daily keyword monitoring.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Search terms and filters are sent to a third-party RedFox API.
\nMitigation: Avoid confidential business plans, private names, sensitive investigation terms, or other protected information unless the user trusts the provider.
\nRisk: The skill requires a REDFOX_API_KEY credential.
\nMitigation: Store the key in an environment variable, avoid hard-coding it in prompts, scripts, logs, or output files, and confirm the key can be reset or revoked.
\nRisk: Daily subscription or scheduled-query setup can repeatedly send the chosen keyword to the provider.
\nMitigation: Review the subscription or scheduled task configuration before confirming it, including keyword, timing, and execution command.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/redfox-data/douyin-search-redfox)
\n- [Publisher profile](https://clawhub.ai/user/redfox-data)
\n- [RedFoxHub API key settings](https://redfox.hk/settings/api-keys?source=clawhub)
\n- [RedFoxHub](https://redfox.hk)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown tables and prompts, with JSON returned by the search helper script and shell commands for API key setup or scheduled runs.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Search results are sorted by like count and may include recent hot works, hot topics, date filters, and daily subscription instructions.]
\n\n## Skill Version(s):
\n1.0.2 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.1: 6 files, 14853 bytes\n\nFiles: README.en.md (6062b), README.md (4942b), scripts/search_douyin.py (3367b), skill-card.md (2246b), SKILL.md (16255b), _meta.json (139b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: douyin-search\ndescription: 抖音爆款作品查询工具。根据用户输入的关键词搜索抖音热门爆款作品，结果以表格展示。当用户想要查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据、了解某类内容在抖音的表现时使用。触发词包括：抖音爆款、抖音热门、抖音热榜、抖音作品查询、抖音搜索、爆款视频、热门视频。\n---\n\n# 抖音作品查询\n\n## 1. 简介\n\n抖音爆款作品查询工具，根据用户输入的关键词，一键搜索抖音热门爆款作品，结果以清晰的 Markdown 表格展示。专注服务于内容创作者、自媒体运营者和 MCN 机构，帮助用户快速发现抖音热门趋势、获取创作灵感、洞悉爆款规律。\n\n## 2. 功能特性\n\n- 🔍 **关键词精准搜索** — 输入任意关键词，即可搜索全平台抖音爆款作品，支持多关键词逗号分隔组合查询\n- 📊 **多维数据表格** — 以 Markdown 表格直观展示点赞数、评论数、分享数、收藏数、粉丝数等核心数据\n- 🧠 **语义理解与细分** — 智能理解用户意图，优先提取细分方向词而非泛化大类词，精准匹配搜索需求\n- 🌐 **泛化词智能拓展** — 当用户输入泛化词时，自动推荐 10 个细分方向供选择，避免搜索结果过于宽泛\n- 🔥 **热门推荐展示** — 搜索结果较少时自动展示近期热门推荐作品和热门话题，提供更多参考\n- 📩 **订阅推送** — 支持创建每日定时推送任务，每天 10:00 自动推送指定关键词的最新爆款作品\n- 📈 **数据可视化** — 数字智能格式化（万级显示），标题链接可点击跳转至抖音作品页\n\n## 3. 一键安装\n\n### 鉴权\n\n#### 获取 API Key\n\n请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 获取API KEY\n\n#### 配置 API Key\n\n方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中：\n\n```bash\n{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }\n```\n\n方案2: 终端配置\n\n```bash\nexport REDFOX_API_KEY=\"ak_xxxx...\"\n```\n\n### 依赖安装\n\n本 Skill 使用 Python 3 标准库，无需额外安装第三方依赖。确保系统中已安装 Python 3.x 即可。\n\n### 环境变量配置\n\n| 环境变量 | 说明 | 是否必填 | 获取方式 |\n| -------- | ---- | -------- | -------- |\n| `REDFOX_API_KEY` | 红狐数据 API Key | 是 | [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) |\n\n## 4. 使用指南\n\n### 基础使用（3 步完成查询）\n\n**Step 1 — 提取关键词**：从用户的自然语言描述中提取搜索关键词。优先提取细分方向词（如\"小众电影\"\"港台电影\"），而非泛化大类词（如仅提取\"电影\"）。\n\n**Step 2 — 调用脚本**：在终端执行以下命令查询数据：\n\n```bash\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\"\n```\n\n- 无赛道关键词时传空字符串 `\"\"`，查询全站热门\n- 多个关键词用英文逗号 `,` 连接为一个字符串（不加空格），仅调用一次脚本\n\n**Step 3 — 查看结果**：脚本返回 JSON，根据返回数据量自动选择合适的展示策略（详见下方\"数据展示策略\"）。\n\n---\n\n### 高级使用\n\n#### 泛化词拓展策略\n\n当用户输入的关键词为**泛化词**（纯大类词，如\"穿搭\"\"美食\"\"美妆\"，无任何修饰词）时，系统会启动拓展策略：\n\n**判断原则**：有修饰词（场景/人群/风格/意图）= 细分词，直接搜索；无修饰词 = 泛化词，需要拓展。\n\n**泛化词处理流程（⚠️ 必须等待用户明确回复后再调用脚本！）**：\n\n**第一步：生成细分词**（禁止调用脚本搜索数据）\n\n拓展词生成原则：\n- **词的大小适中**：词语不要加组合，避免过细（如\"中产穿搭\"太细，查不到数据）\n- **必须覆盖不同场景**：趋势词、人群词、场景词、意图词各 2-3 个\n\n输出示例：\n```\n我识别到「中产」是较大的分类，已查询近期热门趋势，推荐以下细分方向：\n老钱,轻奢,品质生活,松弛感,高级感穿搭,体面,法式穿搭,律师,医生,品质家居\n回复「拓展」将同时搜索这 10 个词，回复「不拓展」将继续搜索「中产」\n```\n\n**第二步：等待用户回复**\n- ❌ **禁止**：用户未回复时调用脚本\n- ✅ **正确**：只等待用户明确回复「拓展」或「不拓展」后再执行\n\n**第三步：根据用户明确回复执行**\n- 用户回复「拓展」 → 将 10 个细分词以英文逗号 `,` 连接为一个字符串（不加空格），**仅调用一次脚本**传入，禁止逐个词多次调用\n- 用户回复「不拓展」或「继续」 → 调用脚本搜索原关键词\n- 用户未回复或回复其他内容 → 识别对应意图\n\n---\n\n#### 数据展示策略\n\n##### 数据字段说明\n\n| 字段 | 说明 |\n| ------------------ | ---------------- |\n| articles | 搜索匹配的作品列表（按点赞数降序） |\n| latestHotArticles | 近期热门推荐作品列表 |\n| hotTopics | 热门话题列表 |\n\n每条作品（articles / latestHotArticles）包含字段：\n\n| 字段 | 说明 |\n| -------------- | -------- |\n| title | 作品标题 |\n| author | 作者名称 |\n| like_count | 点赞数 |\n| comment_count | 评论数 |\n| share_count | 分享数 |\n| collect_count | 收藏数 |\n| work_url | 作品链接 |\n| publish_time | 发布时间 |\n| follower_count | 粉丝数 |\n\n##### 情况 A：articles 数量 > 0（有匹配结果）\n\n**A1. 告知用户数据查询范围**\n\n首先输出一句提示，告知用户本次查询的范围：\n\n> 📊 关键词「**XXX**」共匹配到 **N 条**抖音爆款作品，以下是详细数据：\n\n**A2. 展示作品表格（默认前 20 条）**\n\n将 `articles` 渲染为 Markdown 表格，默认展示前 **20 条**（按点赞数降序），格式如下：\n\n```markdown\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 |\n| --- | -------------------- | ------ | ------ | ------ | ------ | ------ |\n| 1 | [标题文字](作品链接) | 作者名 | 305.2w | 7.1w | 51.0w | 14.7w |\n| 2 | [标题文字](作品链接) | 作者名 | 158.3w | 3.2w | 22.1w | 8.5w |\n```\n\n**数字格式化规则：**\n\n- 小于 10000：直接展示原始数字（如 `320`）\n- 大于等于 10000：使用 `x.xw` 格式（如 `1.2w` 代表 12000）\n\n**标题链接规则：**\n\n- 作品标题使用 Markdown 链接格式 `[标题](work_url)`，点击可跳转到抖音作品页\n- 如果标题过长（超过 30 字），截断并加 `...`\n\n**A3. 查看全部数据（当结果超过 20 条时）**\n\n如果 `articles` 总条数 > 20，在表格下方输出提示后**不等待，立刻继续**输出 A4：\n\n> 以上展示了前 20 条数据，还剩 **N 条**未展示。需要查看全部数据吗？回复「查看全部」即可。\n\n**当用户在后续对话中回复「查看全部」时**：将第 21 条起的所有剩余数据，以相同表格格式续接展示，编号从 #21 开始连续递增，直到全部展示完毕。\n\n**articles ≤ 20 时**：跳过本步骤，直接进入 A4。\n\n**A4. 展示热门推荐数据（latestHotArticles）**\n\n**仅在 `articles` 总条数 ≤ 10 时执行本步骤。**\n\n如果 `articles` 总条数 ≤ 10 且 `latestHotArticles` 不为空，展示热门推荐作品表格（最多 10 条），标题为：\n\n> 🔥 **近期热门推荐作品**\n\n使用与 A2 相同的表格格式和数字格式化规则。**若为空或 articles > 10 则跳过本模块，不输出任何内容。**\n\n**A5. 展示热门话题（hotTopics）**\n\n**仅在 `articles` 总条数 ≤ 10 时执行本步骤。**\n\n如果 `articles` 总条数 ≤ 10 且 `hotTopics` 不为空，以列表形式展示热门话题：\n\n> 🏷️ **热门话题**\n>\n> - #话题1\n> - #话题2\n> - ...\n\n**若为空或 articles > 10 则跳过本模块，不输出任何内容。**\n\n**⚠️ A1~A5 必须在同一轮输出中连续完成，输出 A5 后紧跟订阅提示，不得中断。**\n\n##### 情况 B：articles 数量 = 0（无匹配结果）\n\n**B1. 抱歉提示 + 拓词推荐**\n\n> 😔 抱歉，未找到与「**XXX**」直接相关的内容，你可以尝试用更短或更宽泛的关键词重试（扩展词1,扩展词2,扩展词3,扩展词4,扩展词5,扩展词6,扩展词7,扩展词8,扩展词9,扩展词10）\n\nAI 必须根据用户搜索的关键词生成 **固定 10 个**扩展搜索词，以英文逗号 `,` 分隔展示在一行括号内。\n\n生成规则：\n- 基于原始关键词进行语义扩展（如同义词、上下位词、相关场景词）\n- 每个扩展词保持在 2-6 个汉字\n- 优先推荐更细分或更宽泛的相关方向\n- **必须生成恰好 10 个，不得少于 10 个**\n\n**B2. 热门推荐数据（latestHotArticles）**\n\n如果 `latestHotArticles` 不为空，展示热门推荐作品：\n\n> 💡 我们为您推荐了近期的其他热门作品供参考，或许对您有帮助：\n\n随后以表格格式展示 `latestHotArticles`（最多 10 条），格式同情况 A 的表格。**若为空则跳过本模块，不输出任何内容。**\n\n**B3. 展示热门话题（hotTopics）**\n\n如果 `hotTopics` 不为空，以列表形式展示，格式同 A5。**若为空则跳过本模块，不输出任何内容。**\n\n**⚠️ B1~B3 必须在同一轮输出中连续完成，输出 B3 后紧跟订阅提示，不得中断。**\n\n---\n\n#### 订阅推送\n\n全部内容展示完毕后，**不等待、立刻结束输出**，仅在末尾附上订阅提示：\n\n> 📩 是否订阅「**XXX**」的每日推送？订阅后每天 10:00 自动推送最新爆款作品。回复「确认订阅」即可创建定时任务。\n\n##### 创建定时任务（用户在后续对话中回复「确认订阅」时执行）\n\n优先使用当前平台内置的定时任务/自动化能力创建订阅，若无则提供通用配置方案：\n\n**1. 平台内置定时任务**（优先）\n\n如果当前平台提供定时任务或 cron 自动化功能：直接调用该功能创建订阅，配置如下：\n- 任务名称：`抖音爆款作品订阅 - <关键词>`\n- 执行频率：每天 10:00（北京时间，cron 表达式 `0 10 * * *`）\n- 执行内容：运行 `python3 <脚本路径>/search_douyin.py \"<关键词>\"`，将结果按本指南中数据展示策略的格式展示并推送到当前对话\n\n**2. 通用配置方案**（平台无内置定时任务时）\n\n向用户提供以下信息，由用户自行配置：\n- 执行命令：`python3 <脚本路径>/search_douyin.py \"<关键词>\"`\n- **Linux/macOS crontab**：`0 10 * * * python3 /path/to/search_douyin.py \"<关键词>\"`\n- **其他平台**：参照对应平台的定时任务文档配置上述命令\n\n创建成功后告知用户：\"已成功订阅关键词「<关键词>」的爆款作品推送，每天 10:00 将自动查询最新数据并通知你。\"\n\n---\n\n### 常用命令速查表\n\n| 场景 | 命令 |\n| ---- | ---- |\n| 关键词搜索 | `python3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"关键词\"` |\n| 全站热门 | `python3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"\"` |\n| 多关键词搜索 | `python3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"词1,词2,词3\"` |\n| 订阅创建 | 回复「确认订阅」后在对话中创建每日推送 |\n\n## 5. 使用场景\n\n### 场景一：内容创作者寻找选题灵感\n\n- **角色**：抖音内容创作者\n- **需求**：想了解近期\"职场穿搭\"领域有哪些爆款作品，寻找选题灵感\n- **使用方式**：直接输入细分关键词「职场穿搭」，系统返回点赞数最高的作品列表\n- **预期收益**：快速获得同赛道的爆款作品数据，了解热门选题方向和内容特征\n\n### 场景二：MCN 机构监控赛道趋势\n\n- **角色**：MCN 机构内容运营\n- **需求**：需要实时了解\"美妆\"赛道整体趋势，但\"美妆\"范围太广\n- **使用方式**：输入泛化词「美妆」后，系统推荐 10 个细分方向（如\"口红试色\"\"底妆测评\"等），回复「拓展」批量搜索所有细分方向\n- **预期收益**：一次性覆盖多个细分领域，全面掌握赛道热度分布\n\n### 场景三：品牌方竞品分析\n\n- **角色**：品牌市场人员\n- **需求**：分析竞品在抖音的爆款内容策略\n- **使用方式**：搜索竞品品牌名或相关品类关键词，查看高点赞作品的标题套路、互动数据\n- **预期收益**：通过数据对比了解竞品内容打法，为自身品牌内容策略提供参考\n\n### 场景四：自媒体博主每日热点追踪\n\n- **角色**：抖音自媒体博主\n- **需求**：每天上午自动获取特定领域的爆款作品列表\n- **使用方式**：搜索关键词后回复「确认订阅」，创建每天 10:00 的定时推送\n- **预期收益**：无需手动重复搜索，每日自动获取最新爆款数据，保持对赛道热点的持续追踪\n\n## 6. 项目架构\n\n### 目录结构\n\n```\ndouyin-search/\n├── SKILL.md # Skill 定义与使用文档（本文件）\n├── scripts/\n│ └── search_douyin.py # 核心搜索脚本，调用红狐 API 获取数据\n└── references/\n └── (数据格式参考文档)\n```\n\n### 技术栈\n\n| 组件 | 技术 | 说明 |\n| ---- | ---- | ---- |\n| 运行环境 | Python 3.x | 标准库，无第三方依赖 |\n| 数据接口 | 红狐 API (Redfox) | 通过 REDFOX_API_KEY 鉴权 |\n| 输出格式 | JSON (stdout) | 脚本通过标准输出返回结构化 JSON 数据 |\n| 展示格式 | Markdown 表格 | AI 代理将 JSON 渲染为表格展示 |\n\n### 核心模块说明\n\n| 模块 | 路径 | 功能 |\n| ---- | ---- | ---- |\n| 搜索脚本 | `scripts/search_douyin.py` | 调用红狐接口搜索抖音作品，返回 articles、latestHotArticles、hotTopics 三部分数据 |\n| SKILL 定义 | `SKILL.md` | 定义 Skill 的元数据、工作流程、展示策略和订阅逻辑 |\n\n### 资源索引\n\n- **核心脚本**：`scripts/search_douyin.py` — 调用红狐 API 获取抖音爆款作品数据\n- **参考文档**：`references/` 目录 — 包含数据字段格式说明（按需读取）\n\n## 7. 常见问答\n\n### 安装\n\n**Q: 需要安装哪些依赖？**\nA: 本工具使用 Python 3 标准库（urllib、json、os、sys、argparse），无需安装任何第三方依赖。只需确保系统已安装 Python 3.x。\n\n**Q: 如何获取 API Key？**\nA: 请访问 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 注册并获取 API Key，然后按本文\"一键安装\"章节配置环境变量。\n\n### 使用\n\n**Q: 泛化词和细分词有什么区别？**\nA: 泛化词是纯大类词（如\"穿搭\"\"美食\"），无任何修饰；细分词含有具体场景/人群/风格等修饰（如\"小个子穿搭\"\"减脂餐\"）。泛化词会触发拓展策略，细分词直接搜索。\n\n**Q: 为什么我的搜索没有返回结果？**\nA: 可能关键词过于细分或小众。系统会自动提示 10 个扩展搜索词，建议尝试更短或更宽泛的关键词重试。\n\n**Q: 如何查看超过 20 条的完整结果？**\nA: 当搜索结果超过 20 条时，系统会在表格下方提示剩余条数，回复「查看全部」即可展示所有数据。\n\n### 故障排除\n\n**Q: 脚本执行报错怎么办？**\nA: 常见原因包括：(1) 未配置 REDFOX_API_KEY 环境变量；(2) API Key 已过期；(3) 网络问题导致接口调用失败。请逐一排查。\n\n**Q: 返回的数据为空或与预期不符？**\nA: 尝试使用更短的关键词，或者使用全站热门模式（传空字符串关键词）查看是否有数据。如果全站热门也没有数据，可能是接口临时故障。\n\n### 安全许可\n\n**Q: API Key 如何安全存储？**\nA: 推荐使用方案 1（配置到 openclaw.json 的 env 字段中），避免在终端历史中泄露。请勿将 API Key 直接硬编码在脚本中或上传到公开仓库。\n\n**Q: 数据使用有什么限制？**\nA: 数据来源于红狐 API，请遵守红狐平台的使用条款。本工具仅供个人学习和内容创作参考使用。\n\nFile v1.0.1:README.md\n\n# 抖音作品查询 / douyin-search\n\n---\n\n## 简介\n\n输入关键词即可查询抖音热门爆款作品，以结构化表格呈现点赞、评论、分享、收藏等互动数据，帮你快速掌握各类内容在抖音的真实表现。\n\n**核心价值**\n\n- **即搜即看**：输入任意内容关键词，立刻获取按点赞数排序的爆款作品列表。\n- **数据全面**：每条作品展示作者、点赞数、评论数、分享数、收藏数及可跳转的原文链接。\n- **持续关注**：支持订阅感兴趣的关键词，每天定时推送最新爆款数据，不错过任何趋势。\n\n**适用对象**\n\n- 📝 **内容创作者** — 追踪同赛道爆款，为选题与创作提供数据参考。\n- 🏢 **MCN / 品牌运营** — 快速了解特定品类在抖音的热度与头部内容表现。\n- 📊 **增长 / 市场团队** — 按关键词洞察内容趋势，辅助投放与选题决策。\n\n---\n\n## 功能特性\n\n### 核心功能\n\n- **关键词搜索**：输入内容主题关键词，返回抖音平台上与该主题相关的高互动爆款作品。\n- **智能关键词泛化**：自动去除\"今日\"\"热门\"\"爆款\"等修饰词，提取核心主题，确保每次搜索都有结果。例如输入\"今日美食热门\"，会自动以\"美食\"进行查询。\n- **结构化表格展示**：默认展示前 20 条作品，包含可点击跳转的作品标题、作者、点赞数、评论数、分享数、收藏数，超过 1 万的数字自动转为\"x.xw\"格式，一目了然。\n- **查看全部数据**：当结果超过 20 条时，可一键展开查看最多 50 条完整数据。\n- **关键词订阅推送**：查询完成后可订阅当前关键词，每天 10:00 自动查询最新爆款作品并推送通知。\n\n### 特色亮点\n\n- **泛化保命中**：不要求精确关键词，口语化输入也能获得有效结果，降低使用门槛。\n- **一键订阅**：无需额外操作，查完即订，每日自动推送，持续追踪趋势变化。\n- **数据可点击**：表格中每条作品标题均可直接跳转到抖音原始页面，方便深度查看。\n\n---\n\n## 密钥获取与安全说明\n\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?souce=github) (`https://redfox.hk`)提供。\n- 请前往 [红狐 hub](https://redfox.hk?souce=github) 注册账号，获取 `REDFOX_API_KEY`。\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\n\n---\n\n## 使用指南\n\n直接用自然语言说出你想查的内容方向即可，无需记忆固定命令。\n\n### 常用说法速查\n\n| 意图 | 示例话术 | 效果 |\n| ---------------- | ---------------------------- | ----------------------------------- |\n| 查某类内容的爆款 | \"今日美食热门作品\" | 自动泛化为\"美食\"，返回爆款表格 |\n| 查某个赛道表现 | \"帮我看看旅行类在抖音火不火\" | 以\"旅行\"查询，按点赞排序展示 |\n| 口语化随意搜 | \"最近搞笑视频挺火的\" | 自动提取\"搞笑\"，返回热门作品 |\n| 查看全部结果 | 表格展示后选择\"查看全部\" | 续接展示剩余数据（最多 50 条） |\n| 订阅每日推送 | 查询后选择\"确认订阅\" | 每天 10:00 自动推送该关键词最新爆款 |\n\n### 输出示例\n\n查询完成后，你将看到类似以下格式的表格（示意）：\n\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 |\n| --- | ------------------------------- | --------- | ------ | ------ | ------ | ------ |\n| 1 | [跟我一起来做这道菜…](链接) | 美食达人A | 305.2w | 7.1w | 51.0w | 14.7w |\n| 2 | [旅行vlog：周末说走就走…](链接) | 旅行博主B | 158.3w | 3.2w | 22.1w | 8.5w |\n\n（共展示 20 条，数据超过 20 条时提示查看全部。）\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 示例问法 | 收益 |\n| -------- | ---------- | -------------------------------- | -------------------------------- |\n| 选题调研 | 内容创作者 | \"帮我看看美食赛道最近什么内容火\" | 快速锁定高互动方向，减少盲目试错 |\n| 竞品监控 | 品牌运营 | \"查一下母婴品类在抖音的爆款表现\" | 了解头部内容形态，辅助投放策略 |\n| 趋势追踪 | 市场团队 | \"搞笑类内容在抖音还火吗\" | 按数据判断赛道热度，及时调整方向 |\n| 日常关注 | 个人用户 | \"每日推送旅行类爆款作品\" | 订阅后自动获取，不错过任何热点 |\n\n---\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n \"slug\": \"douyin-search-redfox\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1780393266047\n}\n\nFile v1.0.1:README.en.md\n\n# Douyin Content Search / douyin-search\n\n---\n\n## Overview\n\nEnter a keyword to search for trending viral content on Douyin, presented in a structured table with engagement data including likes, comments, shares, and saves—helping you quickly understand how different content categories are performing on the platform.\n\n**Core Value**\n\n- **Instant search**: Enter any content keyword and immediately receive a list of viral works sorted by like count.\n- **Comprehensive data**: Each result shows the author, likes, comments, shares, saves, and a clickable link to the original work.\n- **Continuous tracking**: Subscribe to keywords of interest and receive daily push notifications with the latest trending data—never miss a trend.\n\n**Intended Users**\n\n- 📝 **Content creators** — Track viral content in your niche for data-driven topic and creative inspiration.\n- 🏢 **MCN / brand operators** — Quickly gauge the popularity and top-performing content for a specific category on Douyin.\n- 📊 **Growth / marketing teams** — Gain keyword-based content trend insights to inform ad placement and topic strategy.\n\n---\n\n## Features\n\n### Core Capabilities\n\n- **Keyword search**: Enter a content topic keyword to retrieve high-engagement viral works on Douyin related to that topic.\n- **Smart keyword generalization**: Automatically removes modifiers like \"today,\" \"trending,\" or \"viral\" to extract the core topic, ensuring every search returns results. For example, \"today's food trending videos\" is automatically queried as \"food.\"\n- **Structured table display**: Shows the top 20 results by default, including clickable work titles, author, likes, comments, shares, and saves. Numbers above 10,000 are auto-formatted as \"x.xw\" for quick readability.\n- **View all data**: When results exceed 20, expand to view up to 50 entries in one click.\n- **Keyword subscription**: After a search, subscribe to the keyword and receive automatic daily updates at 10:00 AM with the latest viral works.\n\n### Highlights\n\n- **Generalization for guaranteed hits**: No need for precise keywords—casual, conversational input still yields effective results, lowering the learning curve.\n- **One-click subscription**: No extra steps—search, subscribe, and receive daily push notifications to stay on top of trend changes.\n- **Clickable data**: Every work title in the table links directly to the original Douyin page for deeper inspection.\n\n---\n\n## API Key Acquisition & Security\n\n- This skill requires the environment variable: `REDFOX_API_KEY`.\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?souce=github) (`https://redfox.hk`).\n- Register at [RedFoxHub](https://redfox.hk?souce=github) to obtain `REDFOX_API_KEY`.\n- Configure `REDFOX_API_KEY` on your device before using this skill.\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\n\n---\n\n## Usage Guide\n\nSimply describe the content category you want to explore in natural language—no fixed commands to memorize.\n\n### Quick Reference\n\n| Intent | Example phrase | Result |\n| -------------------------------- | ----------------------------------------- | --------------------------------------------------------------------- |\n| Search viral content by category | \"Today's trending food content\" | Auto-generalizes to \"food,\" returns a viral content table |\n| Check a niche's performance | \"Is travel content popular on Douyin?\" | Queries \"travel,\" displays results sorted by likes |\n| Casual conversational search | \"Funny videos seem hot lately\" | Auto-extracts \"funny,\" returns trending works |\n| View all results | Select \"View all\" after the table appears | Continues displaying remaining data (up to 50) |\n| Subscribe to daily updates | Select \"Subscribe\" after a search | Daily push at 10:00 AM with the latest viral content for that keyword |\n\n### Output Example\n\nAfter a search, you'll see a table like this (illustrative):\n\n| # | Work Title | Author | Likes | Comments | Shares | Saves |\n| --- | ------------------------------------------------ | -------------- | ------ | -------- | ------ | ----- |\n| 1 | [Let me show you how to make this dish…](link) | FoodieA | 305.2w | 7.1w | 51.0w | 14.7w |\n| 2 | [Travel vlog: A spontaneous weekend trip…](link) | TravelBloggerB | 158.3w | 3.2w | 22.1w | 8.5w |\n\n(20 results shown by default; when there are more, you'll be prompted to view all.)\n\n---\n\n## Use Cases\n\n| Scenario | Role | Example question | Benefit |\n| ---------------------- | --------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------- |\n| Topic research | Content creator | \"What food content is trending on Douyin lately?\" | Quickly pinpoint high-engagement directions, reduce blind trial-and-error |\n| Competitive monitoring | Brand operator | \"Check the viral performance of the baby & maternity category on Douyin\" | Understand top content formats, inform ad strategy |\n| Trend tracking | Marketing team | \"Is comedy content still popular on Douyin?\" | Judge niche heat by data, adjust direction in time |\n| Daily monitoring | Individual user | \"Push me daily updates on travel viral content\" | Subscribe once and receive automatic updates—never miss a trend |\n\n---\n\nFile v1.0.1:skill-card.md\n\n## Description:
\nSearches Douyin for high-engagement content by keyword and helps an agent present the results as structured tables with engagement metrics and links.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[redfox-data](https://clawhub.ai/user/redfox-data)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal content creators, MCN operators, brand teams, and growth marketers use this skill to inspect Douyin trend performance for keywords, compare viral works, and optionally set up daily keyword monitoring.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Search keywords are sent to Redfox using REDFOX_API_KEY.
\nMitigation: Use a scoped, revocable key when possible, store it in the agent environment rather than prompts or logs, and rotate or revoke it if exposure is suspected.
\nRisk: The optional subscription flow can create recurring automated searches without clear review or cancellation controls.
\nMitigation: Confirm where the scheduled task will run, how often it will execute, and how to disable it before approving a subscription.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/redfox-data/douyin-search-redfox)
\n- [RedFoxHub API key settings](https://redfox.hk/settings/api-keys?source=clawhub)
\n- [RedFoxHub](https://redfox.hk)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with tables, inline shell commands, and JSON returned by the search script]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires REDFOX_API_KEY; search results can include Douyin work links, engagement counts, authors, publish times, follower counts, hot recommendations, and hot topics.]
\n\n## Skill Version(s):
\n1.0.1 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.0: 6 files, 10784 bytes\n\nFiles: README.en.md (6064b), README.md (4944b), scripts/search_douyin.py (3086b), skill-card.md (2481b), SKILL.md (5234b), _meta.json (139b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: douyin-search\ndescription: 抖音爆款作品查询工具。根据用户输入的关键词搜索抖音热门爆款作品，结果以表格展示。当用户想要查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据、了解某类内容在抖音的表现时使用。触发词包括：抖音爆款、抖音热门、抖音热榜、抖音作品查询、抖音搜索、爆款视频、热门视频。\n---\n\n# 抖音作品查询\n\n## 鉴权\n\n### 获取 API Key\n\n请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub) 获取API KEY\n\n### 配置 API Key\n\n方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中，部分内容如下：\n\n```bash\n{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }\n```\n\n方案2: 终端配置\n\n```bash\nexport REDFOX_API_KEY=\"ak_xxxx...\"\n```\n\n## 工作流程\n\n### Step 1: 提取关键词与泛化\n\n从用户输入中提取核心搜索关键词，并进行**泛化处理**以确保搜索命中率：\n\n**泛化规则：**\n\n1. **去除时间限定词**：移除\"今日\"\"本周\"\"最近\"\"本月\"等时间词（API 不支持时间过滤）\n2. **去除修饰词**：移除\"热门\"\"爆款\"\"排行\"\"推荐\"等非内容词\n3. **提取核心主题**：保留用户真正想查的内容主题\n\n**示例：**\n\n- \"今日美食热门\" → `美食`\n- \"最近旅行爆款视频\" → `旅行`\n- \"本周搞笑类热门\" → `搞笑`\n- \"母婴好物推荐\" → `母婴好物`\n- \"健身减脂热门内容\" → `健身减脂`\n\n### Step 2: 调用搜索接口\n\n执行脚本查询数据：\n\n```bash\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\"\n```\n\n脚本返回 JSON 数组，每条包含字段：\n\n| 字段 | 说明 |\n| -------------- | -------- |\n| title | 作品标题 |\n| author | 作者名称 |\n| like_count | 点赞数 |\n| comment_count | 评论数 |\n| share_count | 分享数 |\n| collect_count | 收藏数 |\n| work_url | 作品链接 |\n| publish_time | 发布时间 |\n| follower_count | 粉丝数 |\n\n### Step 3: 格式化输出表格\n\n将返回数据渲染为 Markdown 表格，默认展示前 **20 条**（按点赞数降序），格式如下：\n\n```markdown\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 |\n| --- | -------------------- | ------ | ------ | ------ | ------ | ------ |\n| 1 | [标题文字](作品链接) | 作者名 | 305.2w | 7.1w | 51.0w | 14.7w |\n| 2 | [标题文字](作品链接) | 作者名 | 158.3w | 3.2w | 22.1w | 8.5w |\n```\n\n**数字格式化规则：**\n\n- 小于 10000：直接展示原始数字（如 `320`）\n- 大于等于 10000：使用 `x.xw` 格式（如 `1.2w` 代表 12000）\n\n**标题链接规则：**\n\n- 作品标题使用 Markdown 链接格式 `[标题](work_url)`，点击可跳转到抖音作品页\n- 如果标题过长（超过 30 字），截断并加 `...`\n\n### Step 4: 查看全部数据（当结果超过 20 条时）\n\n如果接口返回的总条数 > 20，在表格下方提示用户：\n\n> 以上展示了前 20 条数据，还剩 **N 条**未展示。\n\n然后使用 AskUserQuestion 工具询问：\n\n```\nquestion: \"是否查看全部 N 条数据？\"\nheader: \"查看全部\"\noptions:\n - label: \"查看全部\" description: \"展示剩余的全部 N 条数据（续接 #21 开始编号）\"\n - label: \"不用了\" description: \"仅查看前 20 条\"\n```\n\n**用户选择「查看全部」时**：将第 21 条起的所有剩余数据，以相同表格格式续接展示，编号从 #21 开始连续递增，直到全部展示完毕。展示完成后继续进入 Step 5。\n\n**用户选择「不用了」时**：直接进入 Step 5。\n\n### Step 5: 提示订阅\n\n表格展示完成后，使用 AskUserQuestion 工具询问用户是否订阅该搜索：\n\n```\nquestion: \"是否订阅该搜索？订阅后将每天自动推送相关爆款作品数据。\"\nheader: \"订阅\"\noptions:\n - label: \"确认订阅\" description: \"创建定时任务，每天 10:00 自动查询并推送相关爆款作品\"\n - label: \"暂不订阅\" description: \"仅查看本次数据，不创建定时任务\"\n```\n\n### Step 6: 创建定时任务（仅用户确认订阅时执行）\n\n使用 `qoder_cron` 工具创建定时任务：\n\n```json\n{\n \"action\": \"add\",\n \"job\": {\n \"name\": \"抖音爆款作品订阅 - <关键词>\",\n \"description\": \"每天查询抖音关键词 <关键词> 的爆款作品数据并推送\",\n \"schedule\": {\n \"kind\": \"cron\",\n \"expr\": \"0 10 * * *\",\n \"tz\": \"Asia/Shanghai\"\n },\n \"payload\": {\n \"kind\": \"agentTurn\",\n \"message\": \"请执行抖音爆款作品查询：运行 python3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \\\"<关键词>\\\"，将结果整理为表格展示（表头：作品标题（可点击跳转）| 作者 | 点赞数 | 评论数 | 分享数 | 收藏数，展示前 20 条，数字 >= 10000 用 x.xw 格式，标题用 Markdown 链接 [标题](work_url)）。完成后将结果推送到当前对话。\"\n },\n \"missedRunPolicy\": \"skip\"\n }\n}\n```\n\n创建成功后告知用户：\"已成功订阅关键词「<关键词>」的爆款作品推送，每天 10:00 将自动查询最新数据并通知你。\"\n\nFile v1.0.0:README.md\n\n# 抖音作品查询 / douyin-search\n\n---\n\n## 简介\n\n输入关键词即可查询抖音热门爆款作品，以结构化表格呈现点赞、评论、分享、收藏等互动数据，帮你快速掌握各类内容在抖音的真实表现。\n\n**核心价值**\n\n- **即搜即看**：输入任意内容关键词，立刻获取按点赞数排序的爆款作品列表。\n- **数据全面**：每条作品展示作者、点赞数、评论数、分享数、收藏数及可跳转的原文链接。\n- **持续关注**：支持订阅感兴趣的关键词，每天定时推送最新爆款数据，不错过任何趋势。\n\n**适用对象**\n\n- 📝 **内容创作者** — 追踪同赛道爆款，为选题与创作提供数据参考。\n- 🏢 **MCN / 品牌运营** — 快速了解特定品类在抖音的热度与头部内容表现。\n- 📊 **增长 / 市场团队** — 按关键词洞察内容趋势，辅助投放与选题决策。\n\n---\n\n## 功能特性\n\n### 核心功能\n\n- **关键词搜索**：输入内容主题关键词，返回抖音平台上与该主题相关的高互动爆款作品。\n- **智能关键词泛化**：自动去除\"今日\"\"热门\"\"爆款\"等修饰词，提取核心主题，确保每次搜索都有结果。例如输入\"今日美食热门\"，会自动以\"美食\"进行查询。\n- **结构化表格展示**：默认展示前 20 条作品，包含可点击跳转的作品标题、作者、点赞数、评论数、分享数、收藏数，超过 1 万的数字自动转为\"x.xw\"格式，一目了然。\n- **查看全部数据**：当结果超过 20 条时，可一键展开查看最多 50 条完整数据。\n- **关键词订阅推送**：查询完成后可订阅当前关键词，每天 10:00 自动查询最新爆款作品并推送通知。\n\n### 特色亮点\n\n- **泛化保命中**：不要求精确关键词，口语化输入也能获得有效结果，降低使用门槛。\n- **一键订阅**：无需额外操作，查完即订，每日自动推送，持续追踪趋势变化。\n- **数据可点击**：表格中每条作品标题均可直接跳转到抖音原始页面，方便深度查看。\n\n---\n\n## 密钥获取与安全说明\n\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?souce=clawhub) (`https://redfox.hk`)提供。\n- 请前往 [红狐 hub](https://redfox.hk?souce=clawhub) 注册账号，获取 `REDFOX_API_KEY`。\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\n\n---\n\n## 使用指南\n\n直接用自然语言说出你想查的内容方向即可，无需记忆固定命令。\n\n### 常用说法速查\n\n| 意图 | 示例话术 | 效果 |\n| ---------------- | ---------------------------- | ----------------------------------- |\n| 查某类内容的爆款 | \"今日美食热门作品\" | 自动泛化为\"美食\"，返回爆款表格 |\n| 查某个赛道表现 | \"帮我看看旅行类在抖音火不火\" | 以\"旅行\"查询，按点赞排序展示 |\n| 口语化随意搜 | \"最近搞笑视频挺火的\" | 自动提取\"搞笑\"，返回热门作品 |\n| 查看全部结果 | 表格展示后选择\"查看全部\" | 续接展示剩余数据（最多 50 条） |\n| 订阅每日推送 | 查询后选择\"确认订阅\" | 每天 10:00 自动推送该关键词最新爆款 |\n\n### 输出示例\n\n查询完成后，你将看到类似以下格式的表格（示意）：\n\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 |\n| --- | ------------------------------- | --------- | ------ | ------ | ------ | ------ |\n| 1 | [跟我一起来做这道菜…](链接) | 美食达人A | 305.2w | 7.1w | 51.0w | 14.7w |\n| 2 | [旅行vlog：周末说走就走…](链接) | 旅行博主B | 158.3w | 3.2w | 22.1w | 8.5w |\n\n（共展示 20 条，数据超过 20 条时提示查看全部。）\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 示例问法 | 收益 |\n| -------- | ---------- | -------------------------------- | -------------------------------- |\n| 选题调研 | 内容创作者 | \"帮我看看美食赛道最近什么内容火\" | 快速锁定高互动方向，减少盲目试错 |\n| 竞品监控 | 品牌运营 | \"查一下母婴品类在抖音的爆款表现\" | 了解头部内容形态，辅助投放策略 |\n| 趋势追踪 | 市场团队 | \"搞笑类内容在抖音还火吗\" | 按数据判断赛道热度，及时调整方向 |\n| 日常关注 | 个人用户 | \"每日推送旅行类爆款作品\" | 订阅后自动获取，不错过任何热点 |\n\n---\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n \"slug\": \"douyin-search-redfox\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1780019696210\n}\n\nFile v1.0.0:README.en.md\n\n# Douyin Content Search / douyin-search\n\n---\n\n## Overview\n\nEnter a keyword to search for trending viral content on Douyin, presented in a structured table with engagement data including likes, comments, shares, and saves—helping you quickly understand how different content categories are performing on the platform.\n\n**Core Value**\n\n- **Instant search**: Enter any content keyword and immediately receive a list of viral works sorted by like count.\n- **Comprehensive data**: Each result shows the author, likes, comments, shares, saves, and a clickable link to the original work.\n- **Continuous tracking**: Subscribe to keywords of interest and receive daily push notifications with the latest trending data—never miss a trend.\n\n**Intended Users**\n\n- 📝 **Content creators** — Track viral content in your niche for data-driven topic and creative inspiration.\n- 🏢 **MCN / brand operators** — Quickly gauge the popularity and top-performing content for a specific category on Douyin.\n- 📊 **Growth / marketing teams** — Gain keyword-based content trend insights to inform ad placement and topic strategy.\n\n---\n\n## Features\n\n### Core Capabilities\n\n- **Keyword search**: Enter a content topic keyword to retrieve high-engagement viral works on Douyin related to that topic.\n- **Smart keyword generalization**: Automatically removes modifiers like \"today,\" \"trending,\" or \"viral\" to extract the core topic, ensuring every search returns results. For example, \"today's food trending videos\" is automatically queried as \"food.\"\n- **Structured table display**: Shows the top 20 results by default, including clickable work titles, author, likes, comments, shares, and saves. Numbers above 10,000 are auto-formatted as \"x.xw\" for quick readability.\n- **View all data**: When results exceed 20, expand to view up to 50 entries in one click.\n- **Keyword subscription**: After a search, subscribe to the keyword and receive automatic daily updates at 10:00 AM with the latest viral works.\n\n### Highlights\n\n- **Generalization for guaranteed hits**: No need for precise keywords—casual, conversational input still yields effective results, lowering the learning curve.\n- **One-click subscription**: No extra steps—search, subscribe, and receive daily push notifications to stay on top of trend changes.\n- **Clickable data**: Every work title in the table links directly to the original Douyin page for deeper inspection.\n\n---\n\n## API Key Acquisition & Security\n\n- This skill requires the environment variable: `REDFOX_API_KEY`.\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?souce=clawhub) (`https://redfox.hk`).\n- Register at [RedFoxHub](https://redfox.hk?souce=clawhub) to obtain `REDFOX_API_KEY`.\n- Configure `REDFOX_API_KEY` on your device before using this skill.\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\n\n---\n\n## Usage Guide\n\nSimply describe the content category you want to explore in natural language—no fixed commands to memorize.\n\n### Quick Reference\n\n| Intent | Example phrase | Result |\n| -------------------------------- | ----------------------------------------- | --------------------------------------------------------------------- |\n| Search viral content by category | \"Today's trending food content\" | Auto-generalizes to \"food,\" returns a viral content table |\n| Check a niche's performance | \"Is travel content popular on Douyin?\" | Queries \"travel,\" displays results sorted by likes |\n| Casual conversational search | \"Funny videos seem hot lately\" | Auto-extracts \"funny,\" returns trending works |\n| View all results | Select \"View all\" after the table appears | Continues displaying remaining data (up to 50) |\n| Subscribe to daily updates | Select \"Subscribe\" after a search | Daily push at 10:00 AM with the latest viral content for that keyword |\n\n### Output Example\n\nAfter a search, you'll see a table like this (illustrative):\n\n| # | Work Title | Author | Likes | Comments | Shares | Saves |\n| --- | ------------------------------------------------ | -------------- | ------ | -------- | ------ | ----- |\n| 1 | [Let me show you how to make this dish…](link) | FoodieA | 305.2w | 7.1w | 51.0w | 14.7w |\n| 2 | [Travel vlog: A spontaneous weekend trip…](link) | TravelBloggerB | 158.3w | 3.2w | 22.1w | 8.5w |\n\n(20 results shown by default; when there are more, you'll be prompted to view all.)\n\n---\n\n## Use Cases\n\n| Scenario | Role | Example question | Benefit |\n| ---------------------- | --------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------- |\n| Topic research | Content creator | \"What food content is trending on Douyin lately?\" | Quickly pinpoint high-engagement directions, reduce blind trial-and-error |\n| Competitive monitoring | Brand operator | \"Check the viral performance of the baby & maternity category on Douyin\" | Understand top content formats, inform ad strategy |\n| Trend tracking | Marketing team | \"Is comedy content still popular on Douyin?\" | Judge niche heat by data, adjust direction in time |\n| Daily monitoring | Individual user | \"Push me daily updates on travel viral content\" | Subscribe once and receive automatic updates—never miss a trend |\n\n---\n\nFile v1.0.0:skill-card.md\n\n## Description:
\n抖音爆款作品查询工具。根据用户输入的关键词搜索抖音热门爆款作品，结果以表格展示。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[redfox-data](https://clawhub.ai/user/redfox-data)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nContent creators, brand operators, marketing teams, and individual users use this skill to search Douyin works by keyword, compare engagement metrics, and optionally subscribe to daily keyword updates.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires REDFOX_API_KEY and sends Douyin search keywords to RedFoxHub.
\nMitigation: Install only if you trust RedFoxHub with the API key and search terms; confirm key scope, reset options, and revocation before use.
\nRisk: The subscription flow can create persistent daily scheduled searches.
\nMitigation: Confirm the exact keyword and daily schedule before enabling a subscription, and verify how to find and delete the created cron job.
\nRisk: Security evidence notes a hard-coded script path and limited cancellation or scoping guidance.
\nMitigation: Verify the installed script path and cron payload before enabling automation; avoid persistent subscriptions when the path or deletion workflow is unclear.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/redfox-data/douyin-search-redfox)
\n- [RedFoxHub API key settings](https://redfox.hk/settings/api-keys?source=clawhub)
\n- [RedFoxHub](https://redfox.hk)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown tables with clickable result links, plus JSON returned by the search script and configuration instructions for API key setup or optional scheduled searches.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Search results are sorted by like count and shown as the top 20 by default, with an option to show more results when available.]
\n\n## Skill Version(s):
\n1.0.0 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
","readmeExcerpt":"Skill: 抖音作品查询 Owner: redfox-data Summary: 抖音作品查询工具。根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词：抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-07-29T02:45:57.623Z | auto - Improved keyword extraction: trigger phrases like \"热门文章\" and \"爆款\" are now filtered and will not be included in the search keywords. - Streamlined the generic workflow description","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"我识别到「中产」是较大的分类，推荐以下细分方向：\n老钱,轻奢,品质生活,松弛感,高级感穿搭,体面,法式穿搭,律师,医生,品质家居\n回复「拓展」将同时搜索这10个词，回复「不拓展」将继续搜索「中产」"},{"language":"bash","snippet":"# 无时间参数\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\"\n\n# 有时间参数\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\" --start-date --end-date "},{"language":"markdown","snippet":"| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\n|---|---------|------|--------|--------|--------|--------|----------|\n| 1 | [标题](work_url) | 作者名 | 305.2w | 7.1w | 51.0w | 14.7w | 06-02 19:55 |"},{"language":"text","snippet":"我识别到「中产」是较大的分类，推荐以下细分方向：\n老钱,轻奢,品质生活,松弛感,高级感穿搭,体面,法式穿搭,律师,医生,品质家居\n回复「拓展」将同时搜索这10个词，回复「不拓展」将继续搜索「中产」"},{"language":"bash","snippet":"# 无时间参数\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\"\n\n# 有时间参数\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\" --start-date --end-date "},{"language":"markdown","snippet":"| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\n|---|---------|------|--------|--------|--------|--------|----------|\n| 1 | [标题](work_url) | 作者名 | 305.2w | 7.1w | 51.0w | 14.7w | 06-02 19:55 |"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: douyin-search\ndescription: 抖音作品查询工具。根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词：抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。\n---\n\n# 抖音作品查询\n\n## 📝 简介\n\n根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，返回点赞、评论、分享、收藏、发布时间等互动数据，结果以结构化表格展示。\n\n## ✨ 功能特性\n\n| 功能模块 | 能力描述 | 核心价值 |\n|---------|---------|---------|\n| 爆款搜索 | 关键词搜索抖音爆款作品 | 精准发现高热度内容 |\n| 日期筛选 | 支持按日期范围筛选 | 定位特定时间段的热门内容 |\n| 智能拓展 | 泛化词自动拓展为 10 个细分词 | 避免泛化词搜索结果偏差 |\n| 可点击链接 | 作品标题以超链接格式输出 | 一键跳转查看原作品 |\n| 订阅推送 | 支持关键词每日推送 | 定时获取最新爆款动态 |\n\n## 🔑 鉴权\n\n- 获取 API Key：前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub)\n- 配置方式1：写入 `~/.openclaw/openclaw.json` → `{ \"env\": { \"REDFOX_API_KEY\": \"ak_xxxx...\" } }`\n- 配置方式2：终端执行 `export REDFOX_API_KEY=\"ak_xxxx...\"`\n\n## ⚙️ 工作流程\n\n### Step 1: 🔍 用户意图理解\n\n**⚠️ 核心规则：优先提取细分方向词，而非泛化的大类词**\n\n| 用户输入 | 处理方式 |\n|---------|--------|\n| 无赛道关键词（\"最近热门作品\"） | 关键词传空字符串 `\"\"`，查询全站热门 |\n| 有细分词（\"职场穿搭\"、\"减脂餐\"） | 直接搜索，无需拓展 |\n| 有泛化词（\"穿搭\"、\"美食\"） | 执行拓展策略（Step 2） |\n\n细分词判断原则：有场景/人群/风格/意图修饰 → 细分词；纯大类无修饰 → 泛化词。\n\n**提取精确关键词**：从用户描述中提取细分领域词，而非泛化词。例：用户说“帮我找电影领域热门话题”且自称“小众电影、港台文化” → 搜索“小众电影、港台电影、电影乐评”，❌ 而非只搜“电影”。\n\n**过滤触发钩子词**：用户输入中的「热门文章」「热门作品」「爆款」「热门内容」「查询」「搜索」等词是调用 Skill 的触发钩子，不属于搜索关键词，必须剥离。例：用户说“查询AI热门文章” → 关键词为「AI」，❌ 而非「AI热门文章」。\n\n### Step 2: 🔄 泛化词拓展策略\n\n**⚠️ 必须等待用户明确回复后再调用脚本！**\n\n| 步骤 | 操作 |\n|------|------|\n| 1. 生成细分词 | 生成10个适中大小的细分词（趋势词、人群词、场景词、意图词各2-3个），禁止调用脚本 |\n| 2. 等待用户回复 | 用户未回复时禁止调用脚本 |\n| 3. 执行 | 回复「拓展」→ 10词以英文逗号连接，仅调用一次脚本；回复「不拓展」→ 搜索原关键词 |\n\n输出示例：\n```text\n我识别到「中产」是较大的分类，推荐以下细分方向：\n老钱,轻奢,品质生活,松弛感,高级感穿搭,体面,法式穿搭,律师,医生,品质家居\n回复「拓展」将同时搜索这10个词，回复「不拓展」将继续搜索「中产」\n```\n\n### Step 3: 📡 调用 API 接口\n\n**3.1 时间解析规则**\n\n| 用户输入 | 解析方式 | 示例 |\n|---------|---------|------|\n| 绝对日期 | 解析为 `YYYY-MM-DD` | `6月1号` → `2026-06-01` |\n| 相对日期 | 基于当前日期计算 | `最近7天` → start=7天前, end=今天 |\n| 日期范围 | 分别解析为 startDate/endDate | `5月30日到6月2日` |\n| 模糊时间 | **不解析**，保持默认空字符串 | `最近的`、`最新的` |\n\n- `startDate`/`endDate` 默认空字符串，表示不限定时间\n- 单日期 → startDate = endDate；年份省略取当前年份\n\n**3.2 执行脚本**\n\n```bash\n# 无时间参数\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\"\n\n# 有时间参数\npython3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py \"<关键词>\" --start-date --end-date \n```\n\n仅传入非空的时间参数。脚本返回 JSON：\n\n| 字段 | 说明 |\n|------|------|\n| articles | 搜索匹配的作品列表（按点赞数降序） |\n| total | 总记录数 |\n| pageNum | 当前页码 |\n| pageSize | 每页大小 |\n\n每条作品字段：`title`、`author`、`like_count`、`comment_count`、`share_count`、`collect_count`、`work_url`、`publish_time`\n\n### Step 4: 📊 结果展示\n\n**⚠️ 总数校验**：展示的 N 必须取自 `articles` 数组长度，禁止人工计数。\n\n#### 情况 A：articles > 0\n\n**A1.** 输出查询范围：\n\n> 📊 关键词「**XXX**」共匹配到 **N 条**抖音爆款作品，以下是详细数据：\n\n**A2.** 展示前 20 条表格：\n\n```markdown\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\n|---|---------|------|--------|--------|--------|--------|----------|\n| 1 | [标题](work_url) | 作者名 | 305.2w | 7.1w | 51.0w | 14.7w | 06-02 19:55 |\n```\n\n格式化规则：\n- 数字 < 10000 直接展示；≥ 10000 用 `x.xw` 格式\n- `publish_time` 转为 `MM-DD HH:MM`；无论是否指定时间范围均展示\n- 标题超 30 字截断加 `...`，使用 `[标题](work_url)` 链接格式\n\n**A3.** articles > 20 时提示：\n\n> 以上展示了前 20 条数据，还剩 **N 条**未展示。回复「查看全部」展开剩余"},{"path":"README.md","content":"# 抖音作品查询 / douyin-search\n\n---\n\n## 简介\n\n输入关键词即可查询抖音热门爆款作品，以结构化表格呈现点赞、评论、分享、收藏等互动数据，帮你快速掌握各类内容在抖音的真实表现。\n\n**核心价值**\n\n- **即搜即看**：输入任意内容关键词，立刻获取按点赞数排序的爆款作品列表。\n- **数据全面**：每条作品展示作者、点赞数、评论数、分享数、收藏数及可跳转的原文链接。\n- **持续关注**：支持订阅感兴趣的关键词，每天定时推送最新爆款数据，不错过任何趋势。\n\n**适用对象**\n\n- 📝 **内容创作者** — 追踪同赛道爆款，为选题与创作提供数据参考。\n- 🏢 **MCN / 品牌运营** — 快速了解特定品类在抖音的热度与头部内容表现。\n- 📊 **增长 / 市场团队** — 按关键词洞察内容趋势，辅助投放与选题决策。\n\n---\n\n## 功能特性\n\n### 核心功能\n\n- **爆款搜索**：关键词搜索抖音爆款作品，精准发现高热度内容。\n- **日期筛选**：支持按日期范围筛选，定位特定时间段的热门内容。\n- **智能拓展**：泛化词自动拓展为 10 个细分词，避免泛化词搜索结果偏差。\n- **热门推荐**：无结果时推荐热门作品和话题，兜底保障不空手而归。\n- **可点击链接**：作品标题以超链接格式输出，一键跳转查看原作品。\n- **订阅推送**：支持关键词每日推送，定时获取最新爆款动态。\n\n### 特色亮点\n\n- **泛化保命中**：不要求精确关键词，口语化输入也能获得有效结果，降低使用门槛。\n- **一键订阅**：无需额外操作，查完即订，每日自动推送，持续追踪趋势变化。\n- **数据可点击**：表格中每条作品标题均可直接跳转到抖音原始页面，方便深度查看。\n\n---\n\n## 密钥获取与安全说明\n\n- 本技能需要使用环境变量：`REDFOX_API_KEY`。\n- `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。\n- 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号，获取 `REDFOX_API_KEY`。\n- 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。\n- 在提供密钥前，请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。\n- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。\n\n---\n\n## 使用指南\n\n直接用自然语言说出你想查的内容方向即可，无需记忆固定命令。\n\n### 常用说法速查\n\n| 意图 | 示例话术 | 效果 |\n| ---------------- | ---------------------------------- | ----------------------------------- |\n| 查某类内容的爆款 | \"今日美食热门作品\" | 自动泛化为\"美食\"，返回爆款表格 |\n| 查某个赛道表现 | \"帮我看看旅行类在抖音火不火\" | 以\"旅行\"查询，按点赞排序展示 |\n| 口语化随意搜 | \"最近搞笑视频挺火的\" | 自动提取\"搞笑\"，返回热门作品 |\n| 按时间筛选 | \"5月30号到6月2号的旅游作品\" | 解析日期范围，返回该时段爆款作品 |\n| 查看全部结果 | 表格展示后选择\"查看全部\" | 续接展示剩余数据（最多 50 条） |\n| 订阅每日推送 | 查询后选择\"确认订阅\" | 每天 10:00 自动推送该关键词最新爆款 |\n\n### 输出示例\n\n查询完成后，你将看到类似以下格式的表格（示意）：\n\n| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |\n| --- | ------------------------------- | --------- | ------ | ------ | ------ | ------ | --------- |\n| 1 | [跟我一起来做这道菜…](链接) | 美食达人A | 305.2w | 7.1w | 51.0w | 14.7w | 06-01 19:55 |\n| 2 | [旅行vlog：周末说走就走…](链接) | 旅行博主B | 158.3w | 3.2w | 22.1w | 8.5w | 05-30 15:30 |\n\n（共展示 20 条，数据超过 20 条时提示查看全部。）\n\n---\n\n## 使用场景\n\n| 场景 | 角色 | 示例问法 | 收益 |\n| -------- | ---------- | -------------------------------- | -------------------------------- |\n| 选题调研 | 内容创作者 | \"帮我看看美食赛道最近什么内容火\" | 快速锁定高互动方向，减少盲目试错 |\n| 竞品监控 | 品牌运营 | \"查一下母婴品类在抖音的爆款表现\" | 了解头部内容形态，辅助投放策略 |\n| 趋势追踪 | 市场团队 | \"搞笑类内容在抖音还火吗\" | 按数据判断赛道热度，及时调整方向 |\n| 日常关注 | 个人用户 | \"每日推送旅行类爆款作品\" | 订阅后自动获取，不错过任何热点 |\n\n---"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn73hdehkbe5dwfzckzj8yhcw984t4cc\",\n \"slug\": \"douyin-search-redfox\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1785293157623\n}"},{"path":"README.en.md","content":"# Douyin Content Search / douyin-search\n\n---\n\n## Overview\n\nEnter a keyword to search for trending viral content on Douyin, presented in a structured table with engagement data including likes, comments, shares, and saves—helping you quickly understand how different content categories are performing on the platform.\n\n**Core Value**\n\n- **Instant search**: Enter any content keyword and immediately receive a list of viral works sorted by like count.\n- **Comprehensive data**: Each result shows the author, likes, comments, shares, saves, and a clickable link to the original work.\n- **Continuous tracking**: Subscribe to keywords of interest and receive daily push notifications with the latest trending data—never miss a trend.\n\n**Intended Users**\n\n- 📝 **Content creators** — Track viral content in your niche for data-driven topic and creative inspiration.\n- 🏢 **MCN / brand operators** — Quickly gauge the popularity and top-performing content for a specific category on Douyin.\n- 📊 **Growth / marketing teams** — Gain keyword-based content trend insights to inform ad placement and topic strategy.\n\n---\n\n## Features\n\n### Core Capabilities\n\n- **Viral Search**: Keyword-based search for Douyin viral works — precisely discover high-engagement content.\n- **Date Filtering**: Filter by date range to pinpoint popular content within a specific timeframe.\n- **Smart Expansion**: Automatically broadens generic keywords into 10 niche terms, avoiding skewed search results.\n- **Hot Recommendations**: Recommends trending works and topics when no results found — never leave empty-handed.\n- **Clickable Links**: Work titles output as hyperlinks — one click to the original Douyin video.\n- **Subscription Push**: Subscribe to keywords for daily automated updates with the latest viral trends.\n\n### Highlights\n\n- **Generalization for guaranteed hits**: No need for precise keywords—casual, conversational input still yields effective results, lowering the learning curve.\n- **One-click subscription**: No extra steps—search, subscribe, and receive daily push notifications to stay on top of trend changes.\n- **Clickable data**: Every work title in the table links directly to the original Douyin page for deeper inspection.\n\n---\n\n## API Key Acquisition & Security\n\n- This skill requires the environment variable: `REDFOX_API_KEY`.\n- `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`).\n- Register at [RedFoxHub](https://redfox.hk?source=github) to obtain `REDFOX_API_KEY`.\n- Configure `REDFOX_API_KEY` on your device before using this skill.\n- Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked.\n- Do not hard-code or expose keys in plain text in code, prompts, logs, or output files.\n\n---\n\n## Usage Guide\n\nSimply describe the content category you want to explore in natural language—no fixed commands to memorize.\n\n### Quick Reference\n\n| Intent | Example"},{"path":"skill-card.md","content":"## Description:\n\nSearches Douyin trending works by keyword and optional date range, then returns engagement data in a structured table.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[redfox-data](https://clawhub.ai/user/redfox-data)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal content creators, MCN and brand operators, and marketing teams use this skill to research Douyin content trends, compare engagement for a keyword or date range, and optionally set up daily keyword tracking.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends Douyin search keywords and date filters to Redfox and requires a local REDFOX_API_KEY.\n\nMitigation: Use the skill only when sharing those query details with Redfox is acceptable, store the API key locally, and avoid exposing it in code, prompts, logs, or output files.\n\nRisk: Daily subscription instructions can persist unsafe shell commands built from user keywords.\n\nMitigation: Avoid confirming daily subscriptions until scheduler commands use structured arguments or safe quoting, and review any created scheduled task so it can be removed later.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/redfox-data/skills/douyin-search-redfox)\n- [RedFoxHub API key settings](https://redfox.hk/settings/api-keys?source=clawhub)\n- [Redfox Douyin search API endpoint](https://redfox.hk/story/api/dy/data/searchWork)\n\n## Skill Output:\n\n**Output Type(s):** [Markdown, JSON, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown tables with links, JSON from the search script, and shell commands for API-key setup or scheduled searches]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Search results include title, author, engagement counts, source URL, publish time, total, pageNum, and pageSize.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"抖音作品查询工具。根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词：抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。 Skill: 抖音作品查询 Owner: redfox-data Summary: 抖音作品查询工具。根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词：抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-07-29T02:45:57.623Z | auto - Improved keyword extraction: trigger phrases like \"热门文章\" and \"爆款\" are now filtered and will not be included in the search keywords. - Streamlined the generic workflow description","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1547,"uniquenessScore":50,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T18:27:55.954Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T18:27:55.954Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T21:51:02.937Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}