| name | wechat-channels-crawler |
| description | 视频号作品查询工具。根据用户输入的关键词搜索视频号热门作品，支持按最新、最多点赞、最多收藏和综合排序，结果以结构化表格展示。当用户想要查找视频号热门内容、搜索视频号爆款视频、查询视频号作品数据、了解某类内容在视频号的表现时使用。触发词包括：视频号搜索、视频号作品查询、视频号爆款、视频号热门、视频号内容搜索、搜视频号、微信视频号搜索。 |
视频号作品搜索
输入关键词 → 搜索视频号热门作品 → 结构化表格展示 → 支持订阅每日推送
简介
输入关键词即可查询视频号热门作品，以结构化表格呈现点赞、评论、转发、收藏等互动数据，帮你快速掌握各类内容在视频号的真实表现。
功能特性
| 功能 | 说明 |
|---|
| 🔍 关键词搜索 | 输入内容主题关键词，返回视频号平台相关作品列表 |
| 📊 多维排序 | 支持按综合、最新、最多点赞、最多收藏四种方式排序 |
| 📋 结构化表格 | 默认展示前 20 条，含作品标题、作者、发布时间、互动数据 |
| 🔔 订阅推送 | 查询后可订阅关键词，每天 10:00 自动查询并推送最新作品 |
使用方式
CLI 命令行
python3 ~/.agents/skills/wechat-channels-crawler/scripts/search_wechat_channels.py "美食"
python3 ~/.agents/skills/wechat-channels-crawler/scripts/search_wechat_channels.py "美食" --sort 最新
python3 ~/.agents/skills/wechat-channels-crawler/scripts/search_wechat_channels.py "美食" --sort 最多点赞
python3 ~/.agents/skills/wechat-channels-crawler/scripts/search_wechat_channels.py "美食" --page 2
python3 ~/.agents/skills/wechat-channels-crawler/scripts/search_wechat_channels.py "美食" -o result.json
参数说明
| 参数 | 说明 |
|---|
keyword | 搜索关键词（必需） |
--sort | 排序方式：综合 / 最新 / 最多点赞 / 最多收藏，默认 综合 |
--page | 页码，从 1 开始，默认 1 |
--size | 每页条数，默认 20，最大 50 |
--output / -o | 输出到 JSON 文件（UTF-8），避免 shell 重定向乱码 |
依赖
本脚本仅使用 Python 标准库，无需安装额外依赖。
Agent 集成指南
触发词
- 视频号搜索 / 视频号作品查询
- 视频号爆款 / 视频号热门
- 视频号内容搜索 / 搜视频号
- 微信视频号搜索
执行流程
Step 1: 🔍 用户意图理解
⚠️ 核心规则：优先提取细分方向词，而非泛化的大类词
| 用户输入 | 处理方式 |
|---|
| 无赛道关键词（"最近热门作品"） | 关键词传空字符串 ""，查询全站热门 |
| 有细分词（"职场穿搭"、"减脂餐"） | 直接搜索，无需拓展 |
| 有泛化词（"穿搭"、"美食"） | 执行拓展策略（Step 2） |
细分词判断原则：有场景/人群/风格/意图修饰 → 细分词；纯大类无修饰 → 泛化词。
提取精确关键词：从用户描述中提取细分领域词，而非泛化词。例：用户说“帮我找电影领域热门话题”且自称“小众电影、港台文化” → 搜索“小众电影、港台电影、电影乐评”，❌ 而非只搜“电影”。
过滤触发钩子词：用户输入中的「热门文章」「热门作品」「爆款」「热门内容」「查询」「搜索」等词是调用 Skill 的触发钩子，不属于搜索关键词，必须剥离。例：用户说“查询AI热门文章” → 关键词为「AI」，❌ 而非「AI热门文章」。
Step 2: 🔄 泛化词拓展策略
⚠️ 必须等待用户明确回复后再调用脚本！
| 步骤 | 操作 |
|---|
| 1. 生成细分词 | 生成10个适中大小的细分词（趋势词、人群词、场景词、意图词各2-3个），禁止调用脚本 |
| 2. 等待用户回复 | 用户未回复时禁止调用脚本 |
| 3. 执行 | 回复「拓展」→ 10词以英文逗号连接，仅调用一次脚本；回复「不拓展」→ 搜索原关键词 |
输出示例：
我识别到「中产」是较大的分类，推荐以下细分方向：
老钱,轻奢,品质生活,松弛感,高级感穿搭,体面,法式穿搭,律师,医生,品质家居
回复「拓展」将同时搜索这10个词，回复「不拓展」将继续搜索「中产」
Step 3: 📡 调用 API 接口
python3 ~/.agents/skills/wechat-channels-crawler/scripts/search_wechat_channels.py "<关键词>" [--sort 排序]
脚本返回 JSON：
{
"total": 10877641,
"list": [
{
"title": "作品描述...",
"author": "作者名称",
"like_count": 3052000,
"comment_count": 71000,
"share_count": 510000,
"collect_count": 147000,
"work_url": "https://findermp.video.qq.com/...",
"publish_time": "2026-07-22 14:12:18",
"topics": ["美食", "三明治"],
"duration": 57
}
]
}
字段说明：
| 字段 | 说明 | 字段 | 说明 |
|---|
| title | 作品描述 | share_count | 转发数 |
| author | 作者名称 | collect_count | 收藏数 |
| like_count | 点赞数 | work_url | 视频链接 |
| comment_count | 评论数 | publish_time | 发布时间 |
| topics | 话题标签数组 | duration | 视频时长(秒) |
Step 4: 格式化输出表格
将返回数据渲染为 Markdown 表格，默认展示前 20 条：
| # | 作品标题 | 作者 | 点赞数 | 评论数 | 转发数 | 收藏数 | 发布时间 |
|---|---------|------|-------|-------|-------|-------|---------|
| 1 | 标题文字 | 作者名 | 305.2w | 7.1w | 51.0w | 14.7w | 07-22 |
数字格式化规则：
- 小于 10000：直接展示原始数字（如
320）
- 大于等于 10000：使用
x.xw 格式（如 1.2w = 12000）
发布时间格式化规则：
- 取
publish_time 的月-日部分，格式为 MM-DD（如 2026-07-22 14:12:18 → 07-22）
标题展示规则：
- 标题以纯文本展示，不加链接
- 标题超过 30 字时截断并加
...
Step 5: 查看更多数据（当还能翻页时）
在表格下方提示：
当前为第x页，是否查看下一页数据？
使用 AskUserQuestion 询问：
question: "是否查看下一页数据？"
header: "下一页/翻页"
options:
- label: "下一页/翻页" description: "展示下一页数据（续接 #21 开始编号）"
- label: "不用了" description: "仅查看前 20 条"
- 查看全部：从 #21 起续接展示，编号连续递增，完成后进入 Step 6
- 不用了：直接进入 Step 6
Step 6: 提示订阅
表格展示完成后，使用 AskUserQuestion 询问：
question: "是否订阅该搜索？订阅后将每天自动推送相关视频号爆款作品数据。"
header: "订阅"
options:
- label: "确认订阅" description: "创建定时任务，每天 10:00 自动查询并推送"
- label: "暂不订阅" description: "仅查看本次数据，不创建定时任务"
Step 7: 创建定时任务（仅用户确认订阅时执行）
使用 qoder_cron 工具创建：
{
"action": "add",
"job": {
"name": "视频号爆款作品订阅 - <关键词>",
"description": "每天查询视频号关键词 <关键词> 的爆款作品数据并推送",
"schedule": {
"kind": "cron",
"expr": "0 10 * * *",
"tz": "Asia/Shanghai"
},
"payload": {
"kind": "agentTurn",
"message": "请执行视频号作品查询：运行 python3 ~/.agents/skills/wechat-channels-crawler/scripts/search_wechat_channels.py \"<关键词>\"，将结果整理为表格展示（表头：作品标题 | 作者 | 点赞数 | 评论数 | 转发数 | 收藏数 | 发布时间，展示前 20 条，数字 >= 10000 用 x.xw 格式，发布时间取 MM-DD 格式，标题纯文本不加链接，不展示总条数）。完成后将结果推送到当前对话。"
},
"missedRunPolicy": "skip"
}
}
创建成功后告知用户："已成功订阅关键词「<关键词>」的视频号爆款作品推送，每天 10:00 将自动查询最新数据并通知你。"
输出规范
⛔ 强制规则
Agent 必须完整展示所有返回数据，禁止省略任何条目。数字必须按规则格式化，发布时间取 MM-DD 格式，标题纯文本不加链接，不展示总条数。
API 说明
认证方式
本技能需要 REDFOX_API_KEY 环境变量。
获取方式： 前往 红狐hub 注册并获取 API Key。
配置方式：
方案 1 — 配置文件（推荐）：
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
方案 2 — 终端环境变量：
export REDFOX_API_KEY="ak_xxxx..."
接口信息
| 项目 | 说明 |
|---|
| 端点 | POST https://redfox.hk/story/api/sphAllData/searchWork |
| 认证 | Header X-API-Key |
| source 参数 | 视频号作品爬虫-GitHub |
常见问题
Q：搜索结果为空怎么办？
A：可能是关键词过于小众或暂时缺少相关数据。尝试更换关键词重新搜索，如将"母婴好物"改为"母婴"。
Q：排序方式有什么区别？
A：「综合」按平台推荐权重排序，「最新」按发布时间倒序，「最多点赞」和「最多收藏」分别按对应互动数据排序。
Q：订阅推送后如何取消？
A：通过 qoder_cron 工具使用 action: "list" 查看已创建的定时任务，找到对应订阅后使用 action: "remove" 删除即可。
Q：数据多久更新一次？
A：每天更新昨日数据。订阅推送默认每天 10:00（北京时间）自动执行一次查询。
