技能介绍

解决什么问题

手动搜集微信公众号的热门文章往往依赖平台内部的推荐流，数据难以批量导出，更无法按特定时间段或关键词进行结构化分析。这个技能通过调用 Just One API，将公众号热文数据拉取到本地工作流中，让你能基于时间范围、关键词和分类进行精准检索，并直接生成可视化的 HTML 报告，方便做内容趋势分析或竞品监控。

核心能力与工作流程

技能的核心逻辑封装在 scripts/fetch_hot_articles.py 中，整体分为四个标准步骤：

参数提取与映射：解析用户的自然语言需求，提取 start_day 和 end_day（默认最近 7 天）、keyword、category 以及 publish_type。如果用户输入中文分类，脚本内置的 CATEGORY_MAP 会自动将其映射为 API 所需的英文代码（如将“科技”转为 TECHNOLOGY）。
环境检查与 API 调用：在执行脚本前，会校验 JUSTONE_API_TOKEN 环境变量。确认无误后调用接口拉取 JSON 数据。
生成可视化报告：获取到 JSON 后，通过管道将数据传给报告生成器，输出包含可点击跳转链接的 HTML 文件，并调用 present_files 展示给用户。
结果总结：对返回的文章数量、筛选条件及头部热门标题进行简要汇总。

适用边界与注意事项

虽然该技能简化了数据获取流程，但在工程化落地时仍需注意以下几点：

网络与配额：API 请求超时设置为 120 秒，若在中国大陆访问不稳定，需配置备用地址。遇到速率限制（错误码 302）或配额超限（303）时需调整重试策略或升级账户。
数据量控制：日期范围不宜过大，建议控制在 7 天以内，否则可能导致返回数据过大甚至接口超时。
灵活降级：如果下游系统只需要原始数据进行二次开发，可以跳过 HTML 报告生成步骤，直接输出或保存 JSON 文件。