抖音作品查询
抖音作品查询工具。根据关键词搜索抖音热门爆款作品,支持按日期范围筛选,结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词:抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。 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
Rank
62
Safety
84
Downloads
1.3k
Updated
Oct 10, 2026
Version
1.0.5
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.3K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.0.5release · observed Jul 29, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s171kp1a76rjevha5b9m61sxv984vncz:douyin-search-redfox- 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: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/snapshot"
Documentation
CLAWHUB
102,700 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: douyin-search
description: 抖音作品查询工具。根据关键词搜索抖音热门爆款作品,支持按日期范围筛选,结果以结构化表格展示。当用户查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据时使用。触发词:抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。
---
# 抖音作品查询
## 📝 简介
根据关键词搜索抖音热门爆款作品,支持按日期范围筛选,返回点赞、评论、分享、收藏、发布时间等互动数据,结果以结构化表格展示。
## ✨ 功能特性
| 功能模块 | 能力描述 | 核心价值 |
|---------|---------|---------|
| 爆款搜索 | 关键词搜索抖音爆款作品 | 精准发现高热度内容 |
| 日期筛选 | 支持按日期范围筛选 | 定位特定时间段的热门内容 |
| 智能拓展 | 泛化词自动拓展为 10 个细分词 | 避免泛化词搜索结果偏差 |
| 可点击链接 | 作品标题以超链接格式输出 | 一键跳转查看原作品 |
| 订阅推送 | 支持关键词每日推送 | 定时获取最新爆款动态 |
## 🔑 鉴权
- 获取 API Key:前往 [红狐hub](https://redfox.hk/settings/api-keys?source=clawhub)
- 配置方式1:写入 `~/.openclaw/openclaw.json` → `{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }`
- 配置方式2:终端执行 `export REDFOX_API_KEY="ak_xxxx..."`
## ⚙️ 工作流程
### Step 1: 🔍 用户意图理解
**⚠️ 核心规则:优先提取细分方向词,而非泛化的大类词**
| 用户输入 | 处理方式 |
|---------|--------|
| 无赛道关键词("最近热门作品") | 关键词传空字符串 `""`,查询全站热门 |
| 有细分词("职场穿搭"、"减脂餐") | 直接搜索,无需拓展 |
| 有泛化词("穿搭"、"美食") | 执行拓展策略(Step 2) |
细分词判断原则:有场景/人群/风格/意图修饰 → 细分词;纯大类无修饰 → 泛化词。
**提取精确关键词**:从用户描述中提取细分领域词,而非泛化词。例:用户说“帮我找电影领域热门话题”且自称“小众电影、港台文化” → 搜索“小众电影、港台电影、电影乐评”,❌ 而非只搜“电影”。
**过滤触发钩子词**:用户输入中的「热门文章」「热门作品」「爆款」「热门内容」「查询」「搜索」等词是调用 Skill 的触发钩子,不属于搜索关键词,必须剥离。例:用户说“查询AI热门文章” → 关键词为「AI」,❌ 而非「AI热门文章」。
### Step 2: 🔄 泛化词拓展策略
**⚠️ 必须等待用户明确回复后再调用脚本!**
| 步骤 | 操作 |
|------|------|
| 1. 生成细分词 | 生成10个适中大小的细分词(趋势词、人群词、场景词、意图词各2-3个),禁止调用脚本 |
| 2. 等待用户回复 | 用户未回复时禁止调用脚本 |
| 3. 执行 | 回复「拓展」→ 10词以英文逗号连接,仅调用一次脚本;回复「不拓展」→ 搜索原关键词 |
输出示例:
```text
我识别到「中产」是较大的分类,推荐以下细分方向:
老钱,轻奢,品质生活,松弛感,高级感穿搭,体面,法式穿搭,律师,医生,品质家居
回复「拓展」将同时搜索这10个词,回复「不拓展」将继续搜索「中产」
```
### Step 3: 📡 调用 API 接口
**3.1 时间解析规则**
| 用户输入 | 解析方式 | 示例 |
|---------|---------|------|
| 绝对日期 | 解析为 `YYYY-MM-DD` | `6月1号` → `2026-06-01` |
| 相对日期 | 基于当前日期计算 | `最近7天` → start=7天前, end=今天 |
| 日期范围 | 分别解析为 startDate/endDate | `5月30日到6月2日` |
| 模糊时间 | **不解析**,保持默认空字符串 | `最近的`、`最新的` |
- `startDate`/`endDate` 默认空字符串,表示不限定时间
- 单日期 → startDate = endDate;年份省略取当前年份
**3.2 执行脚本**
```bash
# 无时间参数
python3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py "<关键词>"
# 有时间参数
python3 ~/.qoderwork/skills/douyin-search/scripts/search_douyin.py "<关键词>" --start-date <startDate> --end-date <endDate>
```
仅传入非空的时间参数。脚本返回 JSON:
| 字段 | 说明 |
|------|------|
| articles | 搜索匹配的作品列表(按点赞数降序) |
| total | 总记录数 |
| pageNum | 当前页码 |
| pageSize | 每页大小 |
每条作品字段:`title`、`author`、`like_count`、`comment_count`、`share_count`、`collect_count`、`work_url`、`publish_time`
### Step 4: 📊 结果展示
**⚠️ 总数校验**:展示的 N 必须取自 `articles` 数组长度,禁止人工计数。
#### 情况 A:articles > 0
**A1.** 输出查询范围:
> 📊 关键词「**XXX**」共匹配到 **N 条**抖音爆款作品,以下是详细数据:
**A2.** 展示前 20 条表格:
```markdown
| # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 |
|---|---------|------|--------|--------|--------|--------|----------|
| 1 | [标题](work_url) | 作者名 | 305.2w | 7.1w | 51.0w | 14.7w | 06-02 19:55 |
```
格式化规则:
- 数字 < 10000 直接展示;≥ 10000 用 `x.xw` 格式
- `publish_time` 转为 `MM-DD HH:MM`;无论是否指定时间范围均展示
- 标题超 30 字截断加 `...`,使用 `[标题](work_url)` 链接格式
**A3.** articles > 20 时提示:
> 以上展示了前 20 条数据,还剩 **N 条**未展示。回复「查看全部」展开剩余README.md
# 抖音作品查询 / douyin-search --- ## 简介 输入关键词即可查询抖音热门爆款作品,以结构化表格呈现点赞、评论、分享、收藏等互动数据,帮你快速掌握各类内容在抖音的真实表现。 **核心价值** - **即搜即看**:输入任意内容关键词,立刻获取按点赞数排序的爆款作品列表。 - **数据全面**:每条作品展示作者、点赞数、评论数、分享数、收藏数及可跳转的原文链接。 - **持续关注**:支持订阅感兴趣的关键词,每天定时推送最新爆款数据,不错过任何趋势。 **适用对象** - 📝 **内容创作者** — 追踪同赛道爆款,为选题与创作提供数据参考。 - 🏢 **MCN / 品牌运营** — 快速了解特定品类在抖音的热度与头部内容表现。 - 📊 **增长 / 市场团队** — 按关键词洞察内容趋势,辅助投放与选题决策。 --- ## 功能特性 ### 核心功能 - **爆款搜索**:关键词搜索抖音爆款作品,精准发现高热度内容。 - **日期筛选**:支持按日期范围筛选,定位特定时间段的热门内容。 - **智能拓展**:泛化词自动拓展为 10 个细分词,避免泛化词搜索结果偏差。 - **热门推荐**:无结果时推荐热门作品和话题,兜底保障不空手而归。 - **可点击链接**:作品标题以超链接格式输出,一键跳转查看原作品。 - **订阅推送**:支持关键词每日推送,定时获取最新爆款动态。 ### 特色亮点 - **泛化保命中**:不要求精确关键词,口语化输入也能获得有效结果,降低使用门槛。 - **一键订阅**:无需额外操作,查完即订,每日自动推送,持续追踪趋势变化。 - **数据可点击**:表格中每条作品标题均可直接跳转到抖音原始页面,方便深度查看。 --- ## 密钥获取与安全说明 - 本技能需要使用环境变量:`REDFOX_API_KEY`。 - `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`)提供。 - 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号,获取 `REDFOX_API_KEY`。 - 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。 - 在提供密钥前,请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。 - 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。 --- ## 使用指南 直接用自然语言说出你想查的内容方向即可,无需记忆固定命令。 ### 常用说法速查 | 意图 | 示例话术 | 效果 | | ---------------- | ---------------------------------- | ----------------------------------- | | 查某类内容的爆款 | "今日美食热门作品" | 自动泛化为"美食",返回爆款表格 | | 查某个赛道表现 | "帮我看看旅行类在抖音火不火" | 以"旅行"查询,按点赞排序展示 | | 口语化随意搜 | "最近搞笑视频挺火的" | 自动提取"搞笑",返回热门作品 | | 按时间筛选 | "5月30号到6月2号的旅游作品" | 解析日期范围,返回该时段爆款作品 | | 查看全部结果 | 表格展示后选择"查看全部" | 续接展示剩余数据(最多 50 条) | | 订阅每日推送 | 查询后选择"确认订阅" | 每天 10:00 自动推送该关键词最新爆款 | ### 输出示例 查询完成后,你将看到类似以下格式的表格(示意): | # | 作品标题 | 作者 | 点赞数 | 评论数 | 分享数 | 收藏数 | 发布时间 | | --- | ------------------------------- | --------- | ------ | ------ | ------ | ------ | --------- | | 1 | [跟我一起来做这道菜…](链接) | 美食达人A | 305.2w | 7.1w | 51.0w | 14.7w | 06-01 19:55 | | 2 | [旅行vlog:周末说走就走…](链接) | 旅行博主B | 158.3w | 3.2w | 22.1w | 8.5w | 05-30 15:30 | (共展示 20 条,数据超过 20 条时提示查看全部。) --- ## 使用场景 | 场景 | 角色 | 示例问法 | 收益 | | -------- | ---------- | -------------------------------- | -------------------------------- | | 选题调研 | 内容创作者 | "帮我看看美食赛道最近什么内容火" | 快速锁定高互动方向,减少盲目试错 | | 竞品监控 | 品牌运营 | "查一下母婴品类在抖音的爆款表现" | 了解头部内容形态,辅助投放策略 | | 趋势追踪 | 市场团队 | "搞笑类内容在抖音还火吗" | 按数据判断赛道热度,及时调整方向 | | 日常关注 | 个人用户 | "每日推送旅行类爆款作品" | 订阅后自动获取,不错过任何热点 | ---
_meta.json
{
"ownerId": "kn73hdehkbe5dwfzckzj8yhcw984t4cc",
"slug": "douyin-search-redfox",
"version": "1.0.5",
"publishedAt": 1785293157623
}README.en.md
# Douyin Content Search / douyin-search --- ## Overview Enter 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. **Core Value** - **Instant search**: Enter any content keyword and immediately receive a list of viral works sorted by like count. - **Comprehensive data**: Each result shows the author, likes, comments, shares, saves, and a clickable link to the original work. - **Continuous tracking**: Subscribe to keywords of interest and receive daily push notifications with the latest trending data—never miss a trend. **Intended Users** - 📝 **Content creators** — Track viral content in your niche for data-driven topic and creative inspiration. - 🏢 **MCN / brand operators** — Quickly gauge the popularity and top-performing content for a specific category on Douyin. - 📊 **Growth / marketing teams** — Gain keyword-based content trend insights to inform ad placement and topic strategy. --- ## Features ### Core Capabilities - **Viral Search**: Keyword-based search for Douyin viral works — precisely discover high-engagement content. - **Date Filtering**: Filter by date range to pinpoint popular content within a specific timeframe. - **Smart Expansion**: Automatically broadens generic keywords into 10 niche terms, avoiding skewed search results. - **Hot Recommendations**: Recommends trending works and topics when no results found — never leave empty-handed. - **Clickable Links**: Work titles output as hyperlinks — one click to the original Douyin video. - **Subscription Push**: Subscribe to keywords for daily automated updates with the latest viral trends. ### Highlights - **Generalization for guaranteed hits**: No need for precise keywords—casual, conversational input still yields effective results, lowering the learning curve. - **One-click subscription**: No extra steps—search, subscribe, and receive daily push notifications to stay on top of trend changes. - **Clickable data**: Every work title in the table links directly to the original Douyin page for deeper inspection. --- ## API Key Acquisition & Security - This skill requires the environment variable: `REDFOX_API_KEY`. - `REDFOX_API_KEY` is issued by [RedFoxHub](https://redfox.hk/settings/api-keys?source=clawhub) (`https://redfox.hk`). - Register at [RedFoxHub](https://redfox.hk?source=github) to obtain `REDFOX_API_KEY`. - Configure `REDFOX_API_KEY` on your device before using this skill. - Before providing your key, confirm its source, scope, validity period, and whether it can be reset or revoked. - Do not hard-code or expose keys in plain text in code, prompts, logs, or output files. --- ## Usage Guide Simply describe the content category you want to explore in natural language—no fixed commands to memorize. ### Quick Reference | Intent | Example
skill-card.md
## Description: Searches Douyin trending works by keyword and optional date range, then returns engagement data in a structured table. This skill is ready for commercial/non-commercial use. ## Publisher: [redfox-data](https://clawhub.ai/user/redfox-data) ### License/Terms of Use: MIT-0 ## Use Case: External 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. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill sends Douyin search keywords and date filters to Redfox and requires a local REDFOX_API_KEY. Mitigation: 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. Risk: Daily subscription instructions can persist unsafe shell commands built from user keywords. Mitigation: 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. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/redfox-data/skills/douyin-search-redfox) - [RedFoxHub API key settings](https://redfox.hk/settings/api-keys?source=clawhub) - [Redfox Douyin search API endpoint](https://redfox.hk/story/api/dy/data/searchWork) ## Skill Output: **Output Type(s):** [Markdown, JSON, Shell commands, Configuration, Guidance] **Output Format:** [Markdown tables with links, JSON from the search script, and shell commands for API-key setup or scheduled searches] **Output Parameters:** [1D] **Other Properties Related to Output:** [Search results include title, author, engagement counts, source URL, publish time, total, pageNum, and pageSize.] ## Skill Version(s): 1.0.5 (source: server release evidence) ## Ethical Considerations: Users 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.
AionUi
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!
activepieces
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/redfox-data/skills/douyin-search-redfox",
"sourceUrl": "https://clawhub.ai/redfox-data/skills/douyin-search-redfox",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T18:27:55.954Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T18:27:55.954Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.3K downloads",
"href": "https://clawhub.ai/redfox-data/douyin-search-redfox",
"sourceUrl": "https://clawhub.ai/redfox-data/douyin-search-redfox",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T18:27:55.954Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.5",
"href": "https://clawhub.ai/redfox-data/douyin-search-redfox",
"sourceUrl": "https://clawhub.ai/redfox-data/douyin-search-redfox",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-29T02:45:57.623Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-redfox-data-douyin-search-redfox/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.5",
"description": "- 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.",
"href": "https://clawhub.ai/redfox-data/douyin-search-redfox",
"sourceUrl": "https://clawhub.ai/redfox-data/douyin-search-redfox",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-29T02:45:57.623Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
