wechat-channels-crawler

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

# 输出到文件（推荐，避免 Windows GBK 乱码）
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（北京时间）自动执行一次查询。