git:20260602.08c4de8 to git:20260604.cdf46a5

---

name: douyin-search

description: 抖音爆款作品查询工具。根据用户输入的关键词搜索抖音热门爆款作品，结果以表格展示。当用户想要查找抖音热门内容、搜索抖音爆款视频、查询抖音作品数据、了解某类内容在抖音的表现时使用。触发词包括：抖音爆款、抖音热门、抖音热榜、抖音作品查询、抖音搜索、爆款视频、热门视频。

---

# 抖音作品查询

请前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 获取API KEY

```bash

{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }

```

方案2: 终端配置

```bash

export REDFOX_API_KEY="ak_xxxx..."

```

```

| 字段 | 说明 |

| ------------------ | ---------------- |

| articles | 搜索匹配的作品列表（按点赞数降序） |

| latestHotArticles | 近期热门推荐作品列表 |

| hotTopics | 热门话题列表 |

每条作品（articles / latestHotArticles）包含字段：

| 字段 | 说明 |

| -------------- | -------- |

| title | 作品标题 |

| author | 作者名称 |

| like_count | 点赞数 |

| comment_count | 评论数 |

| share_count | 分享数 |

| collect_count | 收藏数 |

| work_url | 作品链接 |

| publish_time | 发布时间 |

| follower_count | 粉丝数 |

**A1. 告知用户数据查询范围**

首先输出一句提示，告知用户本次查询的范围：

> 📊 关键词「**XXX**」共匹配到 **N 条**抖音爆款作品，以下是详细数据：

**A2. 展示作品表格（默认前 20 条）**

将 `articles` 渲染为 Markdown 表格，默认展示前 **20 条**（按点赞数降序），格式如下：

```markdown

```

**数字格式化规则：**

- 小于 10000：直接展示原始数字（如 `320`）

- 大于等于 10000：使用 `x.xw` 格式（如 `1.2w` 代表 12000）

**标题链接规则：**

- 作品标题使用 Markdown 链接格式 `[标题](work_url)`，点击可跳转到抖音作品页

- 如果标题过长（超过 30 字），截断并加 `...`

**A3. 查看全部数据（当结果超过 20 条时）**

如果 `articles` 总条数 > 20，在表格下方输出提示后**不等待，立刻继续**输出 A4：

> 以上展示了前 20 条数据，还剩 **N 条**未展示。需要查看全部数据吗？回复「查看全部」即可。

**当用户在后续对话中回复「查看全部」时**：将第 21 条起的所有剩余数据，以相同表格格式续接展示，编号从 #21 开始连续递增，直到全部展示完毕。

**articles ≤ 20 时**：跳过本步骤，直接进入 A4。

**A4. 展示热门推荐数据（latestHotArticles）**

**仅在 `articles` 总条数 ≤ 10 时执行本步骤。**

如果 `articles` 总条数 ≤ 10 且 `latestHotArticles` 不为空，展示热门推荐作品表格（最多 10 条），标题为：

> 🔥 **近期热门推荐作品**

使用与 A2 相同的表格格式和数字格式化规则。**若为空或 articles > 10 则跳过本模块，不输出任何内容。**

**A5. 展示热门话题（hotTopics）**

**仅在 `articles` 总条数 ≤ 10 时执行本步骤。**

如果 `articles` 总条数 ≤ 10 且 `hotTopics` 不为空，以列表形式展示热门话题：

> 🏷️ **热门话题**

>

> - #话题1

> - #话题2

> - ...

**若为空或 articles > 10 则跳过本模块，不输出任何内容。**

**B1. 抱歉提示 + 拓词推荐**

> 😔 抱歉，未找到与「**XXX**」直接相关的内容，你可以尝试用更短或更宽泛的关键词重试（扩展词1,扩展词2,扩展词3,扩展词4,扩展词5,扩展词6,扩展词7,扩展词8,扩展词9,扩展词10）

AI 必须根据用户搜索的关键词生成 **固定 10 个**扩展搜索词，以英文逗号 `,` 分隔展示在一行括号内。

生成规则：

- 基于原始关键词进行语义扩展（如同义词、上下位词、相关场景词）

- 每个扩展词保持在 2-6 个汉字

- 优先推荐更细分或更宽泛的相关方向

- **必须生成恰好 10 个，不得少于 10 个**

**B2. 热门推荐数据（latestHotArticles）**

如果 `latestHotArticles` 不为空，展示热门推荐作品：

> 💡 我们为您推荐了近期的其他热门作品供参考，或许对您有帮助：

随后以表格格式展示 `latestHotArticles`（最多 10 条），格式同情况 A 的表格。**若为空则跳过本模块，不输出任何内容。**

**B3. 展示热门话题（hotTopics）**

如果 `hotTopics` 不为空，以列表形式展示，格式同 A5。**若为空则跳过本模块，不输出任何内容。**

全部内容展示完毕后，**不等待、立刻结束输出**，仅在末尾附上订阅提示：

> 📩 是否订阅「**XXX**」的每日推送？订阅后每天 10:00 自动推送最新爆款作品。回复「确认订阅」即可创建定时任务。

优先使用当前平台内置的定时任务/自动化能力创建订阅，若无则提供通用配置方案：

**1. 平台内置定时任务**（优先）

如果当前平台提供定时任务或 cron 自动化功能：直接调用该功能创建订阅，配置如下：

- 任务名称：`抖音爆款作品订阅 - <关键词>`

- 执行频率：每天 10:00（北京时间，cron 表达式 `0 10 * * *`）

**2. 通用配置方案**（平台无内置定时任务时）

向用户提供以下信息，由用户自行配置：

- **其他平台**：参照对应平台的定时任务文档配置上述命令

创建成功后告知用户："已成功订阅关键词「<关键词>」的爆款作品推送，每天 10:00 将自动查询最新数据并通知你。"