gzh-search-crawlerlisted

# 公众号搜索爬虫 输入关键词搜索微信公众号文章，终端表格展示 + CSV 导出 + 交互式 HTML 报告。 > API 请求均携带 `公众号搜索爬虫-SkillHub` 标识。需先配置 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： | 方式 | 命令 | |------|-----