用途:从微信公众号中筛选出相对账号平均阅读量“跑出”的爆款文章,用于账号增长的选题参考。
主要能力:按分类、时间范围、最低阅读量、阅读量与月均阅读比值等条件检索热文;通过 /api/v2/hot/articles 获取热文,再从 content_url 提取 __biz,经 /api/v2/accounts/detail 补全账号信息;按 breakout_score、read_month_avg_ratio、read_num 排序;输出 JSON 供自动化使用,或 Markdown 供人工选题。
使用方式:在技能目录运行脚本,例如: python3 scripts/search_wechat_viral_topic.py --category ai --days 7 --min-read 10000 --min-read-month-avg-ratio 2 --limit 50 --format markdown 可用 --exclude-account、--exclude-accounts 追加排除账号,--no-default-excluded-accounts 关闭默认排除列表。实时调用需设置环境变量: export WECHAT_HOT_API_BASE="https://example.com" export WECHAT_HOT_APP_ID="..." export WECHAT_HOT_APP_SECRET="..." 若已设置 WECHAT_HOT_ACCESS_TOKEN 则直接使用。published_at 需用 datetime 格式,如 2026-06-07T00:00:00。
适用场景:为公众号新账号寻找可借鉴的爆款选题,或按分类批量筛选高相对阅读文章。
限制:默认排除新智元、机器之心、差评、智东西、极客公园、量子位、CSDN 等机构媒体账号;follower_count 不稳定,仅作参考不作筛选;month_read_avg 缺失时不能判定为确认的爆款;账号未收录导致详情失败时,仅在用户接受延迟或设置 --account-retry-seconds 后重试;文章 URL 仅用于研究选题,不得整篇复制内容;切勿将 app id、secret 或 token 写入技能文件。