实时热搜查询

痛点与目标

构建舆情监控或热点聚合系统时，最棘手的问题是各平台热搜接口高度异构。微博返回 hot_value，知乎使用 hot_value_desc，而 B 站甚至不提供热度数值。此外，高频请求极易触发上游 429 限流，导致数据流中断。

实现原理与调用方式

该技能通过封装 scripts/hotsearch.mjs 脚本，基于 Node.js 环境统一拉取 11 个主流平台的实时榜单。核心执行逻辑分为三步：

1. 解析 Skill 绝对路径，确保脚本不依赖当前工作目录（CWD）。
2. 调用时始终显式附加 --json 参数，将 stdout 格式化为统一的 JSON 文档，便于 Agent 解析。
3. 通过 --limit 控制单榜输出规模，或使用 all 命令获取包含 boards_ok 与 boards_failed 的聚合快照。此外，配置 HOTSEARCH_BASE_URL 可切换至自部署的上游实例。

适用边界与避坑指南

• 字段映射：title 是唯一跨平台稳定的共性字段。处理 baidu 或 dongchedi 时需解析 score_desc 字符串，切勿硬编码数值类型。
• 并发控制：CLI 已内置 429/5xx 退避重试，但严禁开启多进程并发刷榜。在循环查询时，请保持 1 至 2 秒的调用间隔。