跳到正文
界面语言
AGENT 接入

把 教育前沿观察 接进你的 Agent

MCP、RSS、API 三种方式读的是同一份数据:精选、热点、日报、周报和月报,按你用的工具选一种就行。全部匿名只读,不用注册,也不用 API Key。

服务正常版本 4.0.0匿名只读 · 无需 Key
REST API · 4.0.0

匿名 GET,拿来就能用

不用 token;浏览器跨域、curl 和各语言默认的 HTTP 客户端都能直接调。路径是 /api/v1,字段和错误码以OpenAPI为准。

第一个请求
curl --compressed 'https://edufrontwatch.org/api/v1/items?mode=selected&window=24h&limit=20'

按分类筛选

在资讯请求中加上 category,只取对应分类;不传则包含全部分类。返回条目的 category 也使用下表中的值。

分类请求参数
教育观察category=education-policy
科技与教育category=education-technology
学术前沿category=education-research
证据与实践category=evidence-practice

用得省,也更快

  1. 01
    开压缩

    curl 加 --compressed,其他客户端打开 gzip 或 br。JSON 压缩后只有原来的 1/4 到 1/8。

  2. 02
    带上 ETag

    保存响应里的 ETag,下次带 If-None-Match;内容没变时返回 304,不传正文。

  3. 03
    按节奏取

    Updates and trending can be checked once per minute at most. Briefings have no fixed publication schedule; check the latest endpoints or feeds for new issues. When paging back, stop once you reach an item you already have.

采集更新持续运行;公开简报经编辑审核发布后可在对应接口与 RSS 中读取,没有固定出刊时点。

接口一览

路径用来做什么多久取一次
资讯
/api/v1/items精选或最近 7 天全部动态,可按分类、时间窗、关键词筛最快 1 分钟一次
热点与事件
/api/v1/hot-topics当前热点榜 Top 10最快 1 分钟一次
/api/v1/stories/{publicId}一个事件的报道时间线、AI 综述和关联事件需要时
日报
/api/v1/dailies/latest最新一期日报新一期编辑审核发布后
/api/v1/dailies/{date}指定日期日报;撤稿会移除引用缓存过期后使用前验证 ETag
/api/v1/dailies日报日期索引按需查询
周报与月报
/api/v1/weeklies/latest最新一期周报:头条、总述和一周重点,按栏目分好新一期编辑审核发布后
/api/v1/weeklies/{week}指定一周,ISO 周如 2026-W39;撤稿会移除引用缓存过期后使用前验证 ETag
/api/v1/weeklies周报索引按需查询
/api/v1/monthlies/latest最新一期月报新一期编辑审核发布后
/api/v1/monthlies/{month}指定月份,如 2026-09缓存过期后使用前验证 ETag
/api/v1/monthlies月报索引按需查询
给 AI 助手
/api/v1/agent给 Agent 的使用说明,列出的地址返回整理好的中文 Markdown需要时
完整精选同步
/api/v1/selected/snapshot当前全部精选,分页一次拿全只在第一次
/api/v1/selected/changes之后的新增、修改和撤选几分钟一次

常见用法

bash
# First request: save the ETag response header
curl --compressed -i 'https://edufrontwatch.org/api/v1/items?mode=selected&window=24h&limit=20'
# Then poll at most once per minute with the ETag; 304 means unchanged
curl --compressed -i -H 'If-None-Match: <previous ETag>' 'https://edufrontwatch.org/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。

能匿名调用不等于所有用途都获许可,见使用规则.