【宝哥】公众号选题关键词搜索
> 作者：宝哥聊AI
功能概述
给定一个或多个关键词，调用红狐(RedFox)公众号爆款文章接口，拉取相关爆款文章（阅读 5000+），按总分降序排序，导出成：
- Excel（
.xlsx）：含排名/标题/作者/发布时间/阅读·在看·点赞·评论/相关性·热度·时效·总分/摘要/原文链接，冻结首行 + 自动筛选，总分 ≥13 标红，链接可点击。 - HTML（表格视图）：同数据的可筛选网页（带搜索框），方便预览与分享。
适用场景：宝哥做内容选题情报、从爆款里挑可二创的公众号文章、批量产出选题表格。
前置依赖
REDFOX_API_KEY（红狐接口密钥）：必填。两种配置方式二选一，详见下方「配置 API Key」一节。- openpyxl：仅导出 Excel 时需要。已装在受管虚拟环境：
C:/Users/Administrator/.workbuddy/binaries/python/envs/default/Scripts/python.exe
该环境未装时，HTML 导出仍可用（纯标准库）。
配置 API Key（二选一）
脚本运行必须拿到 REDFOX_API_KEY（红狐接口密钥）。两种方式任选其一：
方式 A：配置文件（推荐新手 / 不想改系统环境变量）
技能目录已附带 config.example.env 模板：
# 1. 复制模板并重命名
cp "C:/Users/Administrator/.workbuddy/skills/wechat-article-keyword-search/config.example.env" \
"C:/Users/Administrator/.workbuddy/skills/wechat-article-keyword-search/config.env"
# 2. 用编辑器打开 config.env，把 your_redfox_api_key_here 换成真实 Key，保存
# 3. 运行脚本时自动读取该文件，无需另设环境变量
> 安全：含真实 Key 的 config.env 不要提交到公开仓库或分享；config.example.env 只是模板，不含密钥，可安全提交与分发。
方式 B：系统 / 用户环境变量
- Windows 用户级：新建
REDFOX_API_KEY=<你的key>，设好后重启 WorkBuddy 生效。 - Bash 临时：
export REDFOX_API_KEY=<你的key>（Bash 工具因源生.bashrc当下即可用）。
两种方式同时存在时，环境变量优先，config.env 作为兜底。
还没有红狐 Key？前往 https://redfox.hk/dashboard/keys 注册并获取 API Key。
运行方式
脚本：scripts/fetch_and_export.py
# 用受管 venv 的 python（已含 openpyxl，可同时出 Excel + HTML）
VENV="C:/Users/Administrator/.workbuddy/binaries/python/envs/default/Scripts/python.exe"
# 同时导出 Excel 和 HTML（默认）
"$VENV" "$HOME/.workbuddy/skills/wechat-article-keyword-search/scripts/fetch_and_export.py" \
--keyword "企业AI" --output both --outdir "F:/zimeiti"
# 只出 Excel
"$VENV" ".../fetch_and_export.py" --keyword "制造业降本" --output excel
# 多关键词（逗号分隔，自动合并去重）
"$VENV" ".../fetch_and_export.py" --keyword "AI培训,老板获客" --output both
# 指定时间范围（不自动拓展）
"$VENV" ".../fetch_and_export.py" --keyword "企业AI" --start-date 2026-07-01
> 💡 多关键词用法提示（用户常问）：一次搜多个词时，用半角逗号 , 分隔，例如
> --keyword "企业AI,workbuddy"。脚本会对每个词分别查询红狐接口，再按文章 id 自动合并去重、
> 统一排序。注意不要用空格（会被当成一整个长词）或中文逗号（脚本已自动纠正为半角，但建议直接打半角）。
> 多关键词的输出文件名用下划线连接，如 企业AI_workbuddy_爆款文章数据.xlsx。
参数说明：
| 参数 | 必填 | 说明 | 默认 |
|---|---|---|---|
--keyword |
是 | 搜索关键词，多个用逗号分隔 | - |
--output |
否 | excel / html / both |
both |
--outdir |
否 | 输出目录 | 当前目录 |
--max-items |
否 | 最大条数 | 50 |
--start-date |
否 | 开始日期 YYYY-MM-DD（不填则近7天，不足自动扩到30天） | 自动 |
--debug |
否 | 打印接口请求与响应状态 | 关 |
⚠️ 本机必坑点：Windows 路径翻译
本机是 Git Bash + 原生 Windows Python，原生 Python 会把 /c/Users/... 这种 POSIX 路径误当成相对当前盘符、拼成 C:\c\Users\... 报错 "No such file"。
规则：凡是把脚本路径传给 python.exe，必须先用 cygpath -w 转成 Windows 原生路径：
SCRIPT_WIN="$(cygpath -w "$HOME/.workbuddy/skills/wechat-article-keyword-search/scripts/fetch_and_export.py")"
"$VENV" "$SCRIPT_WIN" --keyword "企业AI" --output both --outdir "F:/zimeiti"
（脚本内部读写 --outdir 用普通路径即可，只有「脚本自身路径」需要转 Windows 原生。）
输出文件命名
F:/zimeiti/企业AI_爆款文章数据.xlsxF:/zimeiti/企业AI_爆款文章数据.html
多关键词时文件名用 _ 连接，如 AI培训_老板获客_爆款文章数据.xlsx。
数据说明
- 爆款范围：阅读数 5000+ 的文章，每日早 7 点更新昨日数据；互动数为入库时快照，非实时。
- 排序：有关键词时按 相关性(10) + 热度(3) + 时效(2) 加权，总分 15 分；总分 ≥13 视为强爆款信号。
- 字段来源见
references/data_format.md（红狐 article 对象字段映射）。
选题跟进建议
导出后可进一步：从总分 ≥13 的条目里挑 3–5 条最贴合「宝哥聊 AI」定位（老板获客、制造业降本、AI 培训）的文章做二创选题；或加一列「二创适配度」人工标注。
