AGENT 接入
把晨昏线接进你的 Agent
MCP、RSS、API 三种方式读的是同一份数据：精选、热点、日报、晚报和专题报，按你用的工具选一种就行。全部匿名只读，不用注册，也不用 API Key。
服务正常版本 6.0.0匿名只读 · 无需 Key
REST API · 6.0.0
匿名 GET，拿来就能用
不用 token；浏览器跨域、curl 和各语言默认的 HTTP 客户端都能直接调。路径是 /api/v1，字段和错误码以 OpenAPI 为准。
第一个请求
curl --compressed 'https://terminator-line.de5.net/api/v1/items?mode=selected&window=24h&limit=20'用得省，也更快
- 01开压缩
curl 加
--compressed，其他客户端打开 gzip 或 br。JSON 压缩后只有原来的 1/4 到 1/8。 - 02带上 ETag
保存响应里的 ETag，下次带
If-None-Match；内容没变时返回 304，不传正文。 - 03按节奏取
资讯和热点最快一分钟一次；日报、晚报、专题报各在出刊后取一次；往回翻页翻到已有的那条就停。
内容多久变一次：新资讯全天陆续进来，精选每天变几次到几十次，日报每天 08:00、晚报每天 20:00（北京时间）各一期，专题报每周三、六 12:00 一期。
接口一览
| 路径 | 用来做什么 | 多久取一次 |
|---|---|---|
| 资讯 | ||
/api/v1/items | 精选或最近 7 天全部动态，可按分类、时间窗、关键词筛 | 最快 1 分钟一次 |
| 热点与事件 | ||
/api/v1/hot-topics | 当前热点榜 Top 10 | 最快 1 分钟一次 |
/api/v1/stories/{publicId} | 一个事件的报道时间线、AI 综述和关联事件 | 需要时 |
| 日报与晚报 | ||
/api/v1/dailies/latest | 最新一期日报（前一晚到早上） | 每天 08:00 后一次 |
/api/v1/dailies/{date} | 指定日期日报；撤稿会移除引用 | 缓存过期后使用前验证 ETag |
/api/v1/dailies | 日报日期索引 | 每天一次 |
/api/v1/evenings/latest | 最新一期晚报（当天白天），结构同日报 | 每天 20:00 后一次 |
/api/v1/evenings/{date} | 指定日期晚报；撤稿会移除引用 | 缓存过期后使用前验证 ETag |
/api/v1/evenings | 晚报日期索引 | 每天一次 |
| 专题报 | ||
/api/v1/specials/latest | 最新一期专题报：标题、导语、各章正文和引用的报道 | 每周三、六 12:00 后一次 |
/api/v1/specials/{date} | 指定出刊日期的一期；引用的报道撤稿后，那一章不再给正文 | 缓存过期后使用前验证 ETag |
/api/v1/specials | 专题报索引：出刊日期、主题和标题 | 每周两次 |
| 给 AI 助手 | ||
/api/v1/agent | 给 Agent 的使用说明，列出的地址返回整理好的中文 Markdown | 需要时 |
| 完整精选同步 | ||
/api/v1/selected/snapshot | 当前全部精选，分页一次拿全 | 只在第一次 |
/api/v1/selected/changes | 之后的新增、修改和撤选 | 几分钟一次 |
常见用法
bash
# 第一次：保存响应头里的 ETag
curl --compressed -i 'https://terminator-line.de5.net/api/v1/items?mode=selected&window=24h&limit=20'
# 之后最快每分钟一次，带上 ETag；返回 304 就是没变化
curl --compressed -i -H 'If-None-Match: <上次的 ETag>' 'https://terminator-line.de5.net/api/v1/items?mode=selected&window=24h&limit=20'需要往回翻页时，把 page.nextCursor 作为 cursor 传回去，翻到已经有的那条就停，不要每次把 7 天重翻一遍。
出错了怎么办
- 400
- 参数不对：按 OpenAPI 和返回的 code 修正，不要自动换成更宽的查询。cursor 无效或滑出时间窗返回 invalid_cursor，从第一页重来。
- 409
- snapshot_required：增量没法安全续上，重新取一次完整快照。
- 429
- 请求太密：按 Retry-After 等待，不要并发重试。
- 5xx
- 指数退避，先用上次成功的结果；公开服务不承诺 SLA。
能匿名调用不等于所有用途都获许可，见使用规则。