mcpField
W
wechat-search

wechat-search

github.com/redfox-dataマーケティング・グロース450320 回インストール今日更新
リポジトリ

wechat-search について

wechat-searchは、WeChat公式アカウントの制作者やメディア運営者向けに人気記事を検索するスキルです。関連性・人気度・新しさで結果を並べ、テーマの細分化、定期購読、HTMLレポートにも対応します。

主な機能

  1. 01キーワードと複数語の検索
  2. 02関連性・人気度・新しさの採点
  3. 03テーマの細分化候補
  4. 04期間の自動拡張
  5. 05記事の定期購読配信
  6. 06HTMLレポート生成

活用シーン

  1. 01公式アカウント投稿の最近のテーマ探し
  2. 02競合アカウントの内容傾向の分析
  3. 03複数分野にまたがる投稿計画
  4. 04選んだテーマの記事を定期受信

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/redfox-data/redfox-community --skill wechat-search

インストール後、Claude Code で/wechat-searchを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.en.md
README.md
references/
alipay-recharge.md
gzh_trend_data_format.md
scripts/
fetch_gzh_trends.py

詳細

公众号热门文章查询

1. 简介

公众号热门爆款文章查询工具，支持按关键词搜索微信公众号爆款文章，并基于相关性、热度、时效三维评分智能排序推荐。专注服务于公众号内容创作者、新媒体运营者和自媒体团队，帮助用户快速发现热门选题、分析爆款规律、获取创作灵感。

2. 功能特性

  • 🔍 关键词智能搜索 — 支持关键词精确搜索和多关键词组合查询（逗号分隔），覆盖全品类公众号文章
  • 📊 三维评分排序 — 基于相关性（满分10分）、热度（满分3分）、时效（满分2分）加权计算总分（满分15分），智能排序推荐
  • ⏱️ 灵活时间范围 — 默认查询最近7天，支持自动拓展时间（1天→7天→30天），数据每日早上7点更新
  • 🧠 赛道词识别与拓展 — 自动识别泛化赛道词并推荐10个细分方向，帮助用户精准定位
  • 🔥 热门推荐文章 — 结果较少时自动展示近期热门推荐文章和热门话题
  • 📩 定时订阅推送 — 支持创建日历订阅任务，到达设定时间自动推送最新爆款文章
  • 📄 HTML 报告生成 — 可选生成 HTML 可视化文件，方便独立查看和分享
  • 📋 数字智能格式化 — 万级以上阅读数自动转换（如 10.0w），总分字段加粗突出显示

3. 一键安装

鉴权
获取 API Key

请前往 红狐hub 获取API KEY

配置 API Key

方案1: 以OpenClaw为例，将REDFOX_API_KEY添加到~/.openclaw/openclaw.json中：

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

方案2: 终端配置

export REDFOX_API_KEY="ak_xxxx..."
依赖安装

本 Skill 使用 Python 3.13+ 纯标准库（urllib.request、json、os、sys、argparse、datetime），无需安装任何第三方依赖。

环境变量配置
环境变量说明是否必填获取方式
REDFOX_API_KEY红狐数据 API Key是红狐hub

4. 使用指南

基础使用（3 步完成查询）

Step 1 — 提取关键词：从用户描述中提取搜索关键词，判断是赛道词还是细分词。

  • 赛道词：较大的分类词，如"职场""情感""亲子""美妆"等
  • 非赛道词：具体细分词，如"职场沟通技巧""异地恋怎么维持"等

Step 2 — 调用脚本：

python scripts/fetch_gzh_trends.py --keyword <关键词> --start-date <日期>
  • 有赛道关键词：python scripts/fetch_gzh_trends.py --keyword <关键词> --start-date <日期>
  • 无赛道关键词（查询全站热门）：python scripts/fetch_gzh_trends.py --keyword "" --start-date <日期>
  • 多个关键词用逗号分隔：python scripts/fetch_gzh_trends.py --keyword "职场沟通,恋爱技巧,亲子教育" --start-date <日期>

⚠️ 防重复调用规则（强制）：

  • ❌ 禁止先用 head/tail/2>/dev/null | head -5 等方式"试运行"或"预览"脚本输出
  • ❌ 禁止在同一次查询中对同一参数多次调用脚本
  • ✅ 每次查询只执行一次脚本命令，直接读取完整的 stdout 输出
  • ✅ 唯一允许多次调用的场景：数据不足时按规定的自动拓展时间（近1天→近7天→近30天），每次使用不同的 --start-date

Step 3 — 查看结果：脚本返回结构化 JSON 数据，按本指南规定的展示策略输出结果。

高级使用
赛道词处理流程（仅当识别为赛道词时执行）

第一步：识别并询问用户（⚠️ 仅当用户明确要求时才执行）

我识别到「职场」是较大的分类，已查询近期热门趋势，推荐以下细分方向：
工作、打工人、职场穿搭、职场干货、成长、冷门职业、向上管理、职场焦虑、升职、财务自由
回复「拓展」将同时搜索这10个词，回复「不拓展」将继续搜索「职场」

第二步：等待用户回复

  • ❌ 禁止：用户未回复时调用脚本
  • ❌ 禁止：自动执行拓展搜索（必须等用户明确回复「拓展」）
  • ✅ 正确：只等待用户明确回复后再执行

第三步：根据用户明确回复执行

  • 用户回复「拓展」 → 调用脚本搜索10个细分词
  • 用户回复「不拓展」或「继续」 → 调用脚本搜索原关键词
  • 用户未回复或回复其他内容 → 识别对应意图
时间范围与数据查询

时间范围：

  • 数据库只包含昨天至30天前的数据
  • "最近"的默认定义：最近7天（startDate = 今天 - 7天）
  • 日期计算（将用户表达转换为 startDate）：
    • 今天：直接用昨天日期，startDate = 昨天
    • 最近/近7天：startDate = 今天 - 7天
    • 近N天：startDate = 今天 - N天
    • 示例：用户说"近15天" → startDate = 今天 - 15天

数据不足时的自动拓展时间：

  • ✅ 当 articles 数量不足时，自动按顺序拓展时间范围：近1天 → 近7天 → 近30天
  • ✅ 每次拓展后重新调用脚本查询，直到获取到数据或拓展到30天为止
  • ❌ 禁止自动扩展关键词搜索：搜索结果不足10条时，禁止用拓展词/相关词/同义词再次调用接口搜索
  • ❌ 禁止自动尝试相关搜索建议
  • ✅ 拓展时间后仍无数据，直接返回 articles=0 的结果

超出范围或未更新数据的道歉说明：

  • 用户说"今天/今日"时：回答"非常抱歉，今天的数据暂未更新，已为您展示最近可用的数据"
  • 用户要求的时间超出30天时：回答"非常抱歉，当前仅支持最近30天的数据，已为您展示最接近的数据"

输出文件：

  • JSON数据：输出到标准输出（stdout）
  • HTML文件：{keyword}_趋势数据.html（可选）
前置说明（在展示数据前必须告知用户）
  • 数据说明：爆款文章范围为阅读数5000+以上的文章，每日早上7点更新昨日数据。文章互动数据截止为入库时间，不是实时数据，入库后互动数据可能持续增长。
  • 排序说明（有关键词搜索时）：根据相关性（满分10分）、热度（满分3分）、时效（满分2分）三个维度加权计算，总分共15分
  • 排序说明（全站热门/无关键词时）：按阅读数排序
数据展示策略（核心）

⚠️ 强制输出规则：

  • ✅ 必须严格按照本步骤规定的格式输出
  • ❌ 禁止在输出前添加任何分析或解读
  • ❌ 禁止自作主张给建议或方案
  • ❌ 禁止询问用户的真实目的或需求
  • ✅ 直接读取脚本返回的JSON数据，按照对应策略输出即可

数据字段说明：

  • articles：正常文章数据（主要展示内容）
  • latestHotArticles：推荐热门文章（辅助内容，默认展示10条，表格不含评分字段）
  • hotTopics：热门话题（接口返回，仅供参考，不在对话中展示）
A. articles数量 ≥ 10条

展示内容：

  1. 时间范围说明：必须告知用户查询的时间范围，如"📅 查询时间范围：5月8日 - 5月19日"
  2. 正常文章数据（按totalScore降序排序）
  3. 拓词推荐（relatedSearches）

Markdown表格格式：

⚠️ 表格字段顺序必须严格按以下顺序展示： | 文章标题 | 作者 | 阅读数 | 发布时间 | 相关性 | 热度 | 时效 | 总分 |

注意：总分字段需要加粗显示（使用**分数**格式）

示例： 📅 查询时间范围：5月8日 - 5月19日

文章标题作者阅读数发布时间相关性热度时效总分
职场新人必看：5个让你快速融入团队的技巧职场成长社10.0w2026-05-159.83.02.014.8

🔤 拓词推荐：职场沟通、职场晋升、打工人

B. articles数量 < 10条但 > 0

展示内容：

  1. 时间范围说明：必须告知用户查询的时间范围，如"📅 查询时间范围：5月8日 - 5月19日"
  2. 提示信息："💡当前关键词当前时间段仅找到 X 条结果，您可以尝试拓展词或者拓展时间，我们还为您推荐了近期的热门文章"
  3. 正常文章数据
  4. 推荐热门文章（latestHotArticles，带"推荐热门文章"标题分区，默认展示10条）
  5. 推荐热门话题
  6. 拓词推荐（relatedSearches）

Markdown格式示例：

📅 查询时间范围：5月8日 - 5月19日

💡当前关键词当前时间段仅找到 3 条结果，

文章标题作者阅读数发布时间相关性热度时效总分
文章1作者110.0w2026-05-159.83.02.014.8

您可以尝试拓展词或者拓展时间，我们还为您推荐了近期的热门文章供参考：

⚠️ 推荐热门文章表格不需要评分字段，格式为：

文章标题作者阅读数发布时间
热门文章1作者A8.5w2026-05-14
热门文章2作者B6.2w2026-05-13

📈 推荐热门话题：

您可以尝试搜索以下热门赛道： 人文、知识、养生、时尚、美食、生活、旅游、搞笑、情感、体育娱乐、美妆、文摘、民生资讯、财富理财、科技数码、创投商业、汽车、房产楼市、职场、教育考试、学术

C. articles数量 = 0

⚠️ 必须严格按照以下格式输出，禁止自作主张给建议或分析

展示内容：

🔍 抱歉，爆款文章收录原则为阅读数5000+以上的文章,该搜索词在查询时间范围（5月8日 - 5月19日）内太小众，未找到与"XXX"直接相关的内容，你可以尝试用更短/宽泛的关键词重试 。

💡 或者您可以尝试搜索以下热门赛道：
人文、知识、养生、时尚、美食、生活、旅游、搞笑、情感、体育娱乐、美妆、文摘、民生资讯、财富理财、科技数码、创投商业、汽车、房产楼市、职场、教育考试、学术

我们为您推荐近期最热门的文章，您也可以关注~

在以上内容之后，展示latestHotArticles数据（如果有），热门推荐表格不需要评分字段：

文章标题作者阅读数发布时间
热门文章1作者A8.5w2026-05-14
热门文章2作者B6.2w2026-05-13

输出规则：

  • ✅ 必须直接输出上述格式内容
  • ❌ 禁止添加额外的分析或建议
  • ❌ 禁止解释为什么搜不到数据
  • ❌ 禁止主动提供其他搜索方案
  • ❌ 禁止询问用户的真实目的
展示逻辑（分页）

当articles数量 > 10条时：

  1. 初始默认只展示前10条数据
  2. 必须提示用户： 
    💡 当前共找到 X 条相关文章，已展示前10条。是否需要查看全部？
  3. 等待用户回复：
    • 用户回复"是"/"查看全部"/"全部" → 展示全部数据
    • 用户回复"否"/"不用"/"不需要" → 不展示更多

展示全部数据时的格式：

📊 全部结果（共X条）：

| 文章标题 | 作者 | 阅读数 | 发布时间 | 相关性 | 热度 | 时效 | **总分** |
|---------|------|--------|----------|--------|------|------|------|
| ...（全部数据）...
智能筛选热门内容（可选）

⚠️ 此步骤为可选，仅在用户明确要求"筛选"、"推荐"时执行

筛选原则：

  • 统一排序：脚本已自动将所有数据按totalScore排序
  • 目标数量：最多10条，如实展示实际数据量
订阅服务询问（必须执行）

当articles数量 > 0时，结果输出完成后必须询问：

📬 订阅服务
1️⃣ 是否需要订阅当前搜索条件文章，订阅后将定时推送给您？
2️⃣ 暂不需要

处理用户回复：

  • 用户选择1️⃣ → 使用 calendar_create 工具创建日程，订阅当前搜索条件
  • 用户选择2️⃣ → 结束当前对话

订阅实现步骤：

  1. 告知数据更新时间并询问推送时间：

    📅 数据更新时间：每日早上7点更新昨日数据

请告诉我您希望推送的具体时间~

  2. 用户选择后，调用 calendar_create 工具：

    • title：公众号趋势订阅：{关键词}
    • description：记录当前搜索参数（关键词、时间范围）
    • start_time：根据用户选择的时间设置
    • remind_type：设置为定期提醒
    • 其他参数使用当前查询参数

  3. 订阅成功后提示：

    ✅ 订阅创建成功！

📌 订阅信息：
- 关键词：{关键词}
- 时间范围：{当前时间范围}
- 推送时间：{用户选择的时间}
- 数据更新：每日早上7点更新昨日数据

到达设定时间后，将自动为您推送最新的公众号爆款文章。

⚠️ 强制规则：

  • ✅ 必须在结果输出完成后立即询问
  • ✅ 用户选择订阅时，必须使用 calendar_create 工具
  • ✅ 参数必须使用当前查询参数（关键词、时间范围等）
  • ❌ 禁止跳过此步骤
  • ❌ 禁止在展示结果前询问
常用命令速查表
场景命令
关键词搜索（默认近7天）python scripts/fetch_gzh_trends.py --keyword "关键词" --start-date <日期>
全站热门python scripts/fetch_gzh_trends.py --keyword "" --start-date <日期>
多关键词搜索python scripts/fetch_gzh_trends.py --keyword "词1,词2,词3" --start-date <日期>
指定时间范围python scripts/fetch_gzh_trends.py --keyword "关键词" --start-date 2026-05-08
生成 HTML 报告脚本自动生成 {keyword}_趋势数据.html
订阅创建回复1️⃣后使用 calendar_create 工具创建定时任务
💳 积分不足充值（支付宝接管）

当脚本以退出码 3 结束、并在 stdout 打印 ===PAYMENT_REQUIRED_JSON_START=== 区块时，表示当前 API Key 积分不足（接口 code=3210，兼容 3201）。响应体 data 内含结构化支付信息：cashierUrl（支付宝收银台链接）、amount（订单金额，元）、goodsName（商品名称）、outTradeNo（订单号）。

脚本退出码说明：0 = 正常返回（含"暂无数据"），按标准输出格式呈现结果；1 = 参数/鉴权/接口错误，按脚本提示告知用户；3 = 积分不足，需要充值，按 references/alipay-recharge.md 唤起支付宝充值，到账后自动用原始参数重跑脚本。

完整的前置检查、alipay-bot trigger-payment-signal → submit-payment → poll-payment-status 编排步骤、钱包绑定处理、支付接管规则与失败处理，统一见 references/alipay-recharge.md（通用流程，可被其他 skill 复用）。submit-payment 后由 Agent 用 poll-payment-status --out-shake-no <查询单号> 自动监听支付回调到账，无需用户再手动确认；到账（outcome=success）后自动用用户原始的查询参数重新运行 scripts/fetch_gzh_trends.py 输出结果。

5. 使用场景

场景一：公众号创作者寻找选题灵感
  • 角色：公众号内容创作者
  • 需求：想了解近期"职场"领域有哪些爆款文章，寻找下一篇选题灵感
  • 使用方式：输入赛道词「职场」后，系统推荐 10 个细分方向（如"职场穿搭""向上管理"等），回复「拓展」批量搜索
  • 预期收益：通过三维评分排序快速锁定高价值选题方向，了解同赛道爆款文章的内容特征
场景二：新媒体运营竞品分析
  • 角色：新媒体运营经理
  • 需求：需要分析竞品公众号近期发布了哪些爆款文章，了解其内容策略
  • 使用方式：搜索竞品公众号名称或相关领域关键词，查看按 totalScore 排序的文章列表
  • 预期收益：系统了解竞品的内容选题、标题套路和发布节奏，为自身运营策略提供数据支撑
场景三：自媒体矩阵内容规划
  • 角色：MCN 机构内容总监
  • 需求：需要一次性查看多个领域（职场、情感、亲子）的近期爆款文章，规划矩阵内容排期
  • 使用方式：使用逗号分隔多关键词 --keyword "职场,情感,亲子" 进行跨领域查询
  • 预期收益：一个命令覆盖多个领域，高效获取跨品类热门趋势，提升内容规划效率
シナリオ四：毎日の人気記事を定時配信
  • 役割：セルフメディアのブロガー
  • ニーズ：特定分野の人気公式アカウント記事の一覧を、毎朝自動で受け取りたい
  • 使用方法：キーワードを検索して「1️⃣ 購読」を選択し、配信時刻を設定して、カレンダーの定期タスクを作成します
  • 期待される効果：繰り返し手動で検索する必要がなく、最新の人気記事を毎日定時に取得して、分野の動向を継続的に追跡できます

6. プロジェクトアーキテクチャ

ディレクトリ構成
wechat-search/
├── SKILL.md                          # Skill 定义与使用文档（本文件）
├── scripts/
│   └── fetch_gzh_trends.py           # 核心搜索脚本，调用红狐 API 获取公众号爆款文章
└── references/
    └── gzh_trend_data_format.md      # 数据字段格式参考文档
技術スタック
コンポーネント技術説明
実行環境Python 3.13+標準ライブラリのみを使用し、サードパーティー依存なし
標準ライブラリurllib.request, json, os, sys, argparse, datetimeHTTP リクエスト、JSON 処理、引数解析、日付計算に使用
データインターフェース红狐 API (Redfox)REDFOX_API_KEY による認証
出力形式JSON (stdout) + HTML (ファイル)AI による解析用に JSON を stdout に出力し、HTML は任意の可視化ファイルとして出力
表示形式Markdown テーブルAI エージェントが JSON をテーブルにレンダリングして表示
コアモジュールの説明
モジュールパス機能
検索スクリプトscripts/fetch_gzh_trends.py红狐 インターフェースを呼び出して公式アカウントの人気記事を取得します。--keyword、--start-date、--max-items、--output-format パラメーターをサポートします
データ形式リファレンスreferences/gzh_trend_data_format.mdインターフェースから返されるデータフィールドの形式と意味を詳しく説明します
SKILL 定義SKILL.mdSkill のメタデータ、ワークフロー、表示方針、購読ロジックを定義します
リソース一覧
  • コアスクリプト：scripts/fetch_gzh_trends.py — 红狐 API を呼び出して公式アカウントの人気記事データを取得します。パラメーター：--keyword（必須）、--start-date（任意）、--max-items（任意）、--output-format（任意）
  • 参考ドキュメント：references/gzh_trend_data_format.md — 読み込むタイミング：インターフェースのデータ形式やフィールドの説明を確認する必要があるとき

7. よくある質問

インストール

Q: どの依存関係をインストールする必要がありますか？ A: このツールは Python 3.13+ の標準ライブラリ（urllib.request、json、os、sys、argparse、datetime）のみを使用するため、サードパーティー依存関係をインストールする必要はありません。Python 3.13 以降がシステムにインストールされていることを確認してください。

Q: API Key はどのように取得しますか？ A: 红狐hub にアクセスして登録し、API Key を取得してください。その後、この記事の「ワンクリックインストール」セクションに従って環境変数を設定してください。

使用方法

Q: 分野キーワードと分野外キーワードの違いは何ですか？ A: 分野キーワードは大きな分類を表す語句（例：「職場」「恋愛」）で、識別されると拡張方針が適用されます。分野外キーワードは具体的な細分化された語句（例：「職場でのコミュニケーション術」）で、拡張について確認せずにそのまま検索します。

Q: データの対象期間はどのくらいですか？ A: データベースには昨日から30日前までのデータのみが含まれており、既定では直近7日間を検索します。データが不足している場合は、期間を自動的に拡張します（1日→7日→30日）。昨日のデータは毎朝7時に更新されます。

Q: テーブル内にスコアが表示される項目と、表示されない項目があるのはなぜですか？ A: キーワード検索時は totalScore（関連性＋人気度＋鮮度）で並べ替え、スコアフィールドを表示します。全体の人気記事は閲覧数で並べ替えるため、スコアフィールドはありません。おすすめ人気記事のテーブルにもスコアは含まれません。

Q: 10件を超える結果をすべて確認するにはどうすればよいですか？ A: 結果が10件を超えると、システムから「すべて表示しますか？」と確認されます。「はい」「すべて表示」または「全部」と返信すると、すべてのデータが表示されます。

トラブルシューティング

Q: スクリプトを実行すると結果が空になります。 A: 人気記事として収録される条件は、閲覧数が5000以上であることです。キーワードがニッチすぎる場合や期間が短すぎる場合は、データがないことがあります。システムは期間を自動的に拡張しますが、30日まで拡張してもデータがなければ空の結果を返します。より短い、またはより一般的なキーワードを試してください。

Q: 「今日のデータはまだ更新されていません」と表示されます。 A: データベースは毎朝7時に昨日のデータを更新するため、当日のデータはまだ登録されていません。システムは自動的に利用可能な最新のデータを表示します。

Q: スクリプトでエラーが発生した場合はどうすればよいですか？ A: よくある原因：(1) REDFOX_API_KEY が設定されていない、または期限切れになっている。(2) Python のバージョンが 3.13 未満。(3) ネットワークの問題。順に確認してください。

セキュリティとライセンス

Q: API Key を安全に保存するにはどうすればよいですか？ A: 方案 1（openclaw.json の env フィールドに設定）を推奨します。ターミナルの履歴から漏えいするのを防げます。API Key をスクリプトにハードコードしたり、公開リポジトリにアップロードしたりしないでください。

Q: データの出典と著作権について教えてください。 A: データは红狐 API が収録した、公式アカウントで公開されている記事に基づいています。記事の著作権は原作者に帰属します。本ツールは学習およびコンテンツ制作の参考用途に限ってご利用ください。

コメント

Markdown 対応