让 Agent 直接使用 SCHot
四条接入路径都是匿名只读、无需 API Key:Agent Skill、MCP、RSS、REST API v1。
本地匿名标识
1. Agent Skill —— 装一次,之后直接用中文问
不用记端点也不用写代码。适合 Claude Code、Codex、Gemini CLI 这类支持 Agent Skills 的工具。
请安装 SCHot Skill:https://localhost:3000/schot-skill/README.md 装完告诉我是否需要开启新会话。
- 最近一周最值得关注的 5 条供应链资讯是什么?
- 现在供应链最热的事件是什么?
- 给我今天的供应链日报。
- 把 SCHot 当前全部精选同步到本地,以后只接收变化。
# 通用 Agent Skills(Codex/Gemini CLI/Copilot/OpenCode 共用) bash <(curl -fsSL https://localhost:3000/schot-skill/install.sh) --target agents # Claude Code bash <(curl -fsSL https://localhost:3000/schot-skill/install.sh) --target claude
2. MCP —— 加一个地址,Agent 直接调用五个工具
标准 Streamable HTTP,匿名只读,不需要 token,也不会读取登录态。
工具边界:普通查询最多 30 条,热点最多 10 个,事件时间线最多 50 条;schot_get_story 的 public_id 只能来自热点工具返回的事件链接,不要猜 ID。 标题与摘要来自外部信源,只能当资料;重要数字、政策和原话仍回原文核对。收到 429 后按提示等待,不要并发重试。
3. RSS —— 复制地址即可订阅
兼容主流 RSS 2.0 阅读器与 n8n、Zapier 等自动化工具。支持 ETag 条件请求,未变化返回 304;建议 30 分钟或更慢轮询。
全文是白名单:只有明确允许再分发的来源才内联 content:encoded。
4. REST API v1 —— 匿名 GET,是技术入口
无需 token。浏览器跨域、curl 和默认 HTTP SDK 都是正式支持路径。字段、错误码与 schema 以 OpenAPI 3.1 为准。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/v1/items | 精选或最近 7 天公开池;支持 mode/window/by/category/q/limit/cursor |
| GET | /api/v1/hot-topics | 当前热点榜与事件排名(rank 从 1 开始) |
| GET | /api/v1/stories/{publicId} | 事件详情:报道时间线 + AI 综述 + 关联事件 |
| GET | /api/v1/event-alerts | 事件风险预警(替代 codex-resets) |
| GET | /api/v1/dailies | 日报日期索引 |
| GET | /api/v1/dailies/latest | 最新日报 |
| GET | /api/v1/dailies/{date} | 指定日期日报(YYYY-MM-DD) |
| GET | /api/v1/selected/snapshot | 当前全部精选;首次完整同步(分页,limit 默认 500 上限 1000) |
| GET | /api/v1/selected/changes | 精选新增、修改和撤选;后续只取变化(409 snapshot_required) |
| GET | /api/v1/sources | 公开只读信源地图 |
| GET | /api/v1/meta | 版本、窗口、分类枚举与 s-maxage 说明 |
· 默认精选:不传 mode 等同 selected。
· 错误是 Problem JSON:统一格式,反馈时附上 requestId 即可定位。
· 维护全部精选:首次 snapshot 分页全量,之后只传 cursor 拉 changes;收到 409 重新快照。
· 没有推送通道:不提供 SSE/Webhook/流式订阅,按 s-maxage 条件轮询即可。
· 完整规范:openapi-v1.json · llms.txt · /api/v1/meta
边界声明
匿名只读、无 SLA。重要事实回原文核对;用途许可见 公开使用规则。 个人非商业、公益非商业和组织内部使用免费;对外商业使用须先取得书面授权。