微信公众号热门文章获取

基于 Just One API 的微信公众号热门文章搜索技能，支持多维筛选和可视化报告输出。

前置条件

此技能依赖 Just One API（https://docs.justoneapi.com）。使用前需要：

注册 Just One API 账号获取 API Token
设置环境变量 JUSTONE_API_TOKEN，或在每次调用时通过 --token 参数传入

export JUSTONE_API_TOKEN="your_api_token_here"

若在中国大陆访问 API 不稳定，可设置备用地址：

export JUSTONE_API_BASE_URL="http://47.117.133.51:30015"

工作流程

第一步：确认用户需求

根据用户输入，提取以下筛选参数：

| 参数 | 说明 | 必填 | 默认值 | |------|------|------|--------| | start_day | 开始日期 (yyyy-MM-dd) | 是 | - | | end_day | 结束日期 (yyyy-MM-dd) | 是 | - | | keyword | 搜索关键词 | 否 | 空 | | category | 文章分类 | 否 | ALL | | publish_type | 发布类型 | 否 | IMAGE_TEXT |

若用户未指定日期范围，默认搜索最近 7 天。

若用户指定了中文分类名，使用 scripts/fetch_hot_articles.py 中的 CATEGORY_MAP 进行中英文映射。

第二步：调用 API 获取数据

使用 scripts/fetch_hot_articles.py 调用 API：

cd <skill-dir>/scripts

# 基础查询：最近7天热门
python fetch_hot_articles.py \
    --start-day 2026-07-02 --end-day 2026-07-09

# 按关键词 + 分类查询（自动翻页）
python fetch_hot_articles.py \
    --start-day 2026-07-02 --end-day 2026-07-09 \
    --keyword "人工智能" \
    --category TECHNOLOGY \
    --all-pages --max-pages 5

# 指定发布类型
python fetch_hot_articles.py \
    --start-day 2026-07-02 --end-day 2026-07-09 \
    --publish-type VIDEO

重要：执行脚本前，先检查 JUSTONE_API_TOKEN 环境变量是否已设置。若未设置且用户未提供 token，提示用户先设置。

第三步：生成可视化报告

将 JSON 输出通过管道传给报告生成器：

python fetch_hot_articles.py --start-day 2026-07-02 --end-day 2026-07-09 --all-pages \
  | python generate_report.py -o <workspace>/outputs/wechat_hot_articles.html

或者先保存 JSON，再生成报告：

python fetch_hot_articles.py --start-day 2026-07-02 --end-day 2026-07-09 --all-pages \
  -o /tmp/articles.json
python generate_report.py /tmp/articles.json -o <workspace>/outputs/wechat_hot_articles.html

生成报告后，使用 present_files 展示 HTML 文件给用户。

第四步：呈现结果

简要总结搜索结果：

共获取到多少篇文章
日期范围和筛选条件
如有，提及前几篇热门文章的标题

API 错误处理

| 错误码 | 含义 | 处理方式 | |--------|------|----------| | 0 | 成功 | 正常处理 | | 100 | Token 无效 | 提示用户检查 Token | | 301 | 采集失败 | 建议重试 | | 302 | 速率限制 | 等待后重试 | | 303 | 超出配额 | 提示用户升级配额 | | 400 | 参数错误 | 检查参数格式 | | 500 | 服务器错误 | 稍后重试 | | 601 | 余额不足 | 提示用户充值 | | 602 | Token 限额超限 | 提示用户调整限额 |

可用分类

代码值及其对应的中文名：

| 代码 | 中文名 | 代码 | 中文名 | |------|--------|------|--------| | ALL | 全部分类 | INTERNATIONAL | 国际 | | SPORTS | 体育 | ENTERTAINMENT | 娱乐 | | SOCIETY | 社会 | FINANCE | 财经 | | CURRENT_AFFAIRS | 时事 | TECHNOLOGY | 科技 | | EMOTION | 情感 | AUTOMOTIVE | 汽车 | | EDUCATION | 教育 | FASHION | 时尚 | | GAMES | 游戏 | MILITARY | 军事 | | TRAVEL | 旅游 | FOOD | 美食 | | CULTURE | 文化 | HEALTH | 健康 | | HUMOR | 幽默 | HOME | 家居 | | ANIMATION | 动漫 | PETS | 宠物 | | PARENTING | 育儿 | ASTROLOGY | 星座 | | HISTORY | 历史 | MUSIC | 音乐 | | WORKPLACE | 职场 | AGRICULTURE | 三农 |

注意事项

API 请求超时设置为 120 秒，部分查询可能较慢
自动翻页时每页之间有短暂延迟，避免触发速率限制
报告中的文章链接可直接点击跳转到微信文章页面
日期范围不宜过大（建议 7 天内），否则可能数据量过大
若用户只想要原始 JSON 数据而非报告，可跳过第三步直接输出 JSON