gzh-search-crawler
公众号搜索爬虫 — 通过关键词搜索微信公众号文章,终端表格展示(标题/作者/阅读/点赞/分享/收藏/发布时间/文章链接),自动导出 CSV 并生成交互式 HTML 报告。当用户需要搜索、爬取或浏览公众号文章时使用;也适用于行业热点追踪、竞品内容分析、素材灵感搜集等场景。
Install
npx skills add https://github.com/redfox-data/redfox-community/tree/main/skills/gzh-search
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install redfox-data-redfox-community@llmmart
git clone https://github.com/redfox-data/redfox-community.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole redfox-data/redfox-community collection as a plugin from our marketplace. Git is the plain clone.
README
公众号搜索爬虫 / gzh-search-crawler
简介
输入关键词搜索微信公众号文章,终端表格展示并自动导出 CSV + 交互式 HTML 报告。
核心价值
- 关键词搜索:实时查询全量微信公众号文章,覆盖腰部以上公众号近 30 天内容
- 智能评分排序:综合关键词相关性、阅读热度、时效新鲜度三维评分
- 多格式输出:终端表格 + CSV 导出 + 交互式 HTML 报告,满足不同场景
- 交互式报告:HTML 页面内置搜索框,封面图稳定展示,卡片点击跳转原文
适用对象
- 🔍 行业研究员 — 追踪行业热点,批量导出数据做趋势分析
- 📝 内容创作者 — 发现爆款选题,搜集素材灵感
- 🏢 竞品分析师 — 监控竞争对手公众号内容策略
功能特性
核心功能
- 关键词搜索:输入任意关键词(不超过 10 字),实时搜索公众号文章
- 智能排序:三维评分(相关性 + 热度 + 时效),同分按阅读量降序
- 分层降级:充足时正常浏览 / 较少时引导宽泛搜索 / 无结果时热门兜底
- 终端表格:标题、作者、阅读、点赞、分享、收藏、发布时间、文章链接
- CSV 导出:自动生成 UTF-8 BOM 编码 CSV,便于数据分析
- HTML 报告:内置搜索框(300ms 防抖),封面图展示(自动绕过防盗链),分页加载
- 本地代理服务:页面搜索请求经本地服务转发,无跨域限制,API Key 不写入 HTML 报告
密钥获取与安全说明
- 本技能需要使用环境变量:
REDFOX_API_KEY。 REDFOX_API_KEY由 红狐 hub (https://redfox.hk)提供。- 请前往 红狐 hub 注册账号,获取
REDFOX_API_KEY。 - 配置设备环境变量
REDFOX_API_KEY后使用本技能。 - 在提供密钥前,请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。
- 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。
使用指南
直接用自然语言说出你想搜的关键词即可。
常用说法速查
| 意图 | 示例话术 | 效果 |
|---|---|---|
| 搜索热点 | 「搜一下 AI 相关的公众号文章」 | 返回 AI 相关热门文章,按评分排序 |
| 竞品分析 | 「搜大模型方向最近的文章」 | 抓取竞品内容策略,导出 CSV 分析 |
| 素材搜集 | 「搜小红书运营的爆款文章」 | 获取同赛道选题和写作角度 |
| 趋势研究 | 「搜 2026 经济相关的公众号文章」 | 批量导出数据做研究报告 |
使用场景
| 场景 | 角色 | 示例问法 | 收益 |
|---|---|---|---|
| 行业热点追踪 | 行业分析师 | 「AI 领域最近在讨论什么?」 | 快速了解行业动态与讨论风向 |
| 竞品内容分析 | 内容运营 | 「搜一下竞品公众号的文章」 | 掌握竞品发文策略与爆款规律 |
| 素材灵感搜集 | 创作者 | 「搜小红书运营的爆款选题」 | 获取同赛道灵感,提升创作效率 |
| 趋势研究报告 | 研究员 | 「批量导出某话题的文章数据」 | CSV 导出,方便深度数据分析 |
Skill manifest
公众号搜索爬虫
输入关键词搜索微信公众号文章,终端表格展示 + CSV 导出 + 交互式 HTML 报告。
需先配置 API Key,通过环境变量 REDFOX_API_KEY 或 --api-key 参数传入。 爬取范围:腰部以上公众号近 30 天内发布的文章。 关键词限制:不超过 10 个字符,超出会提示精简。
使用场景
当你需要执行以下任务时,应优先使用本技能:
| 场景 | 示例 |
|---|---|
| 行业热点追踪 | 搜 "AI" 了解近期 AI 领域公众号都在讨论什么 |
| 竞品内容分析 | 搜 "大模型" 爬取竞争对手公众号的文章策略 |
| 素材灵感搜集 | 搜 "小红书运营" 获取爆款选题和写作角度 |
| 趋势研究报告 | 搜 "2026 经济" 批量导出 CSV 做数据分析 |
| 寻找优质账号 | 搜 "科技" 发现相关领域的头部公众号 |
| 话题舆情监控 | 搜 "品牌名" 查看公众号对该品牌的讨论风向 |
如果你想搜某个特定公众号的全部历史文章,应使用
gzh-subscribe技能(公众号文章订阅),它专门针对单账号订阅追踪。
使用方法
# 基础搜索
python3 "$SKILL_PATH/assets/search.py" "关键词"
# 指定数量(多页自动翻页)
python3 "$SKILL_PATH/assets/search.py" "AI" --count 50
# 仅导出 CSV
python3 "$SKILL_PATH/assets/search.py" "大模型" --csv-only
# 不自动打开浏览器
python3 "$SKILL_PATH/assets/search.py" "AI" --no-open
终端输出按综合评分(关键词相关性 + 阅读热度 + 时效新鲜度)降序排列,同分时按阅读量高的优先;结果较少或无结果时自动分层提示。
HTML 报告特性:深色主题 · 实时搜索(300ms 防抖)· 文章卡片点击跳转原文 · 分页加载 · 零结果时引导热门话题。
CSV / HTML 默认保存在 ~/Downloads/QoderGzhSearch/。
参数说明
| 参数 | 说明 | 默认值 |
|---|---|---|
keyword |
搜索关键词(必填,位置参数) | — |
--count |
获取文章数量 | 20 |
--sort-type |
排序方式:default / time |
default |
--output-dir |
输出目录 | ~/Downloads/QoderGzhSearch |
--api-key |
指定 API Key | — |
--no-open |
不自动打开浏览器 | — |
--csv-only |
仅生成 CSV,不生成 HTML | — |
--port |
HTML 本地服务端口 | 8766 |
API Key 配置
任选一种方式配置个人 Key:
| 方式 | 命令 |
|---|---|
| 环境变量(推荐) | export REDFOX_API_KEY=ak_你的密钥 |
| 命令行参数 | --api-key ak_你的密钥 |
| 配置文件 | echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json |
注册地址:redfox.hk
功能特点
- 关键词搜索:实时查询全量微信公众号文章
- 智能评分排序:三因子(相关性 + 热度 + 时效)综合评分,同分按阅读量降序
- 分层响应降级:充足时正常浏览 / 较少时引导宽泛搜索 / 无结果时热门兜底
- 终端表格:标题、作者、阅读、点赞、分享、收藏、发布时间、文章链接
- CSV 导出:自动生成 UTF-8 BOM 编码的 CSV
- HTML 交互报告:内置搜索框,支持封面图展示,点击卡片跳转原文
- 本地代理服务:避免浏览器跨域限制
依赖
pip3 install requests
常见问题
Q:搜索范围? A:目前覆盖腰部以上公众号近 30 天内发布的文章,不保证覆盖所有账号和全部历史。
Q:我想搜某个特定公众号的所有文章怎么办?
A:请使用 gzh-subscribe 技能(公众号文章订阅),它支持按公众号 ID 订阅追踪单账号的全部文章。
Q:最多返回多少条?
A:单次默认 20 条,通过 --count 调整,HTML 页面支持分页加载更多。
Q:数据保存在哪?
A:~/Downloads/QoderGzhSearch/,文件名格式 公众号搜索_[关键词]_YYYY-MM-DD.csv/html。
Q:为什么需要本地服务? A:浏览器直接打开 HTML 有跨域限制,内置 HTTP 代理中转 API 请求。
Q:额度用完怎么办? A:前往 redfox.hk 注册获取 Token。
Files (redfox-community)
-
assets
-
report_template.html 31.8 KB · in bundle
-
search.py 38.4 KB
Loading…
-
-
README.en.md 3.4 KB
Loading… -
README.md 3.3 KB
# 公众号搜索爬虫 / gzh-search-crawler --- ## 简介 输入关键词搜索微信公众号文章,终端表格展示并自动导出 CSV + 交互式 HTML 报告。 **核心价值** - **关键词搜索**:实时查询全量微信公众号文章,覆盖腰部以上公众号近 30 天内容 - **智能评分排序**:综合关键词相关性、阅读热度、时效新鲜度三维评分 - **多格式输出**:终端表格 + CSV 导出 + 交互式 HTML 报告,满足不同场景 - **交互式报告**:HTML 页面内置搜索框,封面图稳定展示,卡片点击跳转原文 **适用对象** - 🔍 **行业研究员** — 追踪行业热点,批量导出数据做趋势分析 - 📝 **内容创作者** — 发现爆款选题,搜集素材灵感 - 🏢 **竞品分析师** — 监控竞争对手公众号内容策略 --- ## 功能特性 ### 核心功能 - **关键词搜索**:输入任意关键词(不超过 10 字),实时搜索公众号文章 - **智能排序**:三维评分(相关性 + 热度 + 时效),同分按阅读量降序 - **分层降级**:充足时正常浏览 / 较少时引导宽泛搜索 / 无结果时热门兜底 - **终端表格**:标题、作者、阅读、点赞、分享、收藏、发布时间、文章链接 - **CSV 导出**:自动生成 UTF-8 BOM 编码 CSV,便于数据分析 - **HTML 报告**:内置搜索框(300ms 防抖),封面图展示(自动绕过防盗链),分页加载 - **本地代理服务**:页面搜索请求经本地服务转发,无跨域限制,API Key 不写入 HTML 报告 --- ## 密钥获取与安全说明 - 本技能需要使用环境变量:`REDFOX_API_KEY`。 - `REDFOX_API_KEY` 由 [红狐 hub](https://redfox.hk/settings/api-keys?source=github) (`https://redfox.hk`)提供。 - 请前往 [红狐 hub](https://redfox.hk?source=github) 注册账号,获取 `REDFOX_API_KEY`。 - 配置设备环境变量 `REDFOX_API_KEY` 后使用本技能。 - 在提供密钥前,请先确认密钥来源、可用范围、有效期及是否支持重置/撤销。 - 禁止在代码、提示词、日志或输出文件中硬编码/明文暴露密钥。 --- ## 使用指南 直接用自然语言说出你想搜的关键词即可。 ### 常用说法速查 | 意图 | 示例话术 | 效果 | |------|---------|------| | 搜索热点 | 「搜一下 AI 相关的公众号文章」 | 返回 AI 相关热门文章,按评分排序 | | 竞品分析 | 「搜大模型方向最近的文章」 | 抓取竞品内容策略,导出 CSV 分析 | | 素材搜集 | 「搜小红书运营的爆款文章」 | 获取同赛道选题和写作角度 | | 趋势研究 | 「搜 2026 经济相关的公众号文章」 | 批量导出数据做研究报告 | --- ## 使用场景 | 场景 | 角色 | 示例问法 | 收益 | |------|------|---------|------| | 行业热点追踪 | 行业分析师 | 「AI 领域最近在讨论什么?」 | 快速了解行业动态与讨论风向 | | 竞品内容分析 | 内容运营 | 「搜一下竞品公众号的文章」 | 掌握竞品发文策略与爆款规律 | | 素材灵感搜集 | 创作者 | 「搜小红书运营的爆款选题」 | 获取同赛道灵感,提升创作效率 | | 趋势研究报告 | 研究员 | 「批量导出某话题的文章数据」 | CSV 导出,方便深度数据分析 | -
SKILL.md 5.4 KB
--- name: gzh-search-crawler description: 公众号搜索爬虫 — 通过关键词搜索微信公众号文章,终端表格展示(标题/作者/阅读/点赞/分享/收藏/发布时间/文章链接),自动导出 CSV 并生成交互式 HTML 报告。当用户需要搜索、爬取或浏览公众号文章时使用;也适用于行业热点追踪、竞品内容分析、素材灵感搜集等场景。 --- # 公众号搜索爬虫 输入关键词搜索微信公众号文章,终端表格展示 + CSV 导出 + 交互式 HTML 报告。 > 需先配置 API Key,通过环境变量 REDFOX_API_KEY 或 --api-key 参数传入。 > 爬取范围:**腰部以上公众号**近 30 天内发布的文章。 > 关键词限制:**不超过 10 个字符**,超出会提示精简。 --- ## 使用场景 当你需要执行以下任务时,应优先使用本技能: | 场景 | 示例 | | ---------------- | ------------------------------------------ | | **行业热点追踪** | 搜 "AI" 了解近期 AI 领域公众号都在讨论什么 | | **竞品内容分析** | 搜 "大模型" 爬取竞争对手公众号的文章策略 | | **素材灵感搜集** | 搜 "小红书运营" 获取爆款选题和写作角度 | | **趋势研究报告** | 搜 "2026 经济" 批量导出 CSV 做数据分析 | | **寻找优质账号** | 搜 "科技" 发现相关领域的头部公众号 | | **话题舆情监控** | 搜 "品牌名" 查看公众号对该品牌的讨论风向 | > 如果你想搜**某个特定公众号的全部历史文章**,应使用 `gzh-subscribe` 技能(公众号文章订阅),它专门针对单账号订阅追踪。 --- ## 使用方法 ```bash # 基础搜索 python3 "$SKILL_PATH/assets/search.py" "关键词" # 指定数量(多页自动翻页) python3 "$SKILL_PATH/assets/search.py" "AI" --count 50 # 仅导出 CSV python3 "$SKILL_PATH/assets/search.py" "大模型" --csv-only # 不自动打开浏览器 python3 "$SKILL_PATH/assets/search.py" "AI" --no-open ``` 终端输出按**综合评分**(关键词相关性 + 阅读热度 + 时效新鲜度)降序排列,同分时按阅读量高的优先;结果较少或无结果时自动分层提示。 HTML 报告特性:深色主题 · 实时搜索(300ms 防抖)· 文章卡片点击跳转原文 · 分页加载 · 零结果时引导热门话题。 CSV / HTML 默认保存在 `~/Downloads/QoderGzhSearch/`。 --- ## 参数说明 | 参数 | 说明 | 默认值 | | -------------- | ---------------------------- | ---------------------------- | | `keyword` | 搜索关键词(必填,位置参数) | — | | `--count` | 获取文章数量 | `20` | | `--sort-type` | 排序方式:`default` / `time` | `default` | | `--output-dir` | 输出目录 | `~/Downloads/QoderGzhSearch` | | `--api-key` | 指定 API Key | — | | `--no-open` | 不自动打开浏览器 | — | | `--csv-only` | 仅生成 CSV,不生成 HTML | — | | `--port` | HTML 本地服务端口 | `8766` | --- ## API Key 配置 任选一种方式配置个人 Key: | 方式 | 命令 | | ---------------- | -------------------------------------------------------------- | | 环境变量(推荐) | `export REDFOX_API_KEY=ak_你的密钥` | | 命令行参数 | `--api-key ak_你的密钥` | | 配置文件 | `echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json` | 注册地址:[redfox.hk](https://redfox.hk/settings/api-keys?source=github) --- ## 功能特点 - **关键词搜索**:实时查询全量微信公众号文章 - **智能评分排序**:三因子(相关性 + 热度 + 时效)综合评分,同分按阅读量降序 - **分层响应降级**:充足时正常浏览 / 较少时引导宽泛搜索 / 无结果时热门兜底 - **终端表格**:标题、作者、阅读、点赞、分享、收藏、发布时间、文章链接 - **CSV 导出**:自动生成 UTF-8 BOM 编码的 CSV - **HTML 交互报告**:内置搜索框,支持封面图展示,点击卡片跳转原文 - **本地代理服务**:避免浏览器跨域限制 --- ## 依赖 ```bash pip3 install requests ``` --- ## 常见问题 **Q:搜索范围?** A:目前覆盖**腰部以上公众号**近 30 天内发布的文章,不保证覆盖所有账号和全部历史。 **Q:我想搜某个特定公众号的所有文章怎么办?** A:请使用 `gzh-subscribe` 技能(公众号文章订阅),它支持按公众号 ID 订阅追踪单账号的全部文章。 **Q:最多返回多少条?** A:单次默认 20 条,通过 `--count` 调整,HTML 页面支持分页加载更多。 **Q:数据保存在哪?** A:`~/Downloads/QoderGzhSearch/`,文件名格式 `公众号搜索_[关键词]_YYYY-MM-DD.csv/html`。 **Q:为什么需要本地服务?** A:浏览器直接打开 HTML 有跨域限制,内置 HTTP 代理中转 API 请求。 **Q:额度用完怎么办?** A:前往 [redfox.hk](https://redfox.hk/settings/api-keys?source=github) 注册获取 Token。
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.