跳到正文

AGENT 接入

把 AMZNEWS 接进你的 Agent

Skill、MCP、RSS、API 四种方式读的是同一份公开数据：精选、热点、事件和日报。按你用的工具选一种就行，全部匿名只读，不用注册，也不用 API Key。

服务正常MCP 2.0.0匿名只读 · 无需 Key
llms.txt Skill 安装说明 Skill 文件 MCP Server OpenAPI 3.1

REST API · v1

匿名 GET，拿来就能用

不用 token；浏览器跨域、curl 和默认 HTTP SDK 都可以直接调。临时查最近内容用 items，长期维护全部精选用一次快照加增量游标。字段与错误码以 OpenAPI 3.1 为准。

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

用得省，也更快

  1. 01

    开压缩

    curl 加 --compressed；其他客户端开启 gzip 或 br，减少响应体积。

  2. 02

    带上 ETag

    保存响应的 ETag，下次带 If-None-Match，304 表示内容没变。

  3. 03

    按节奏取

    遵守响应缓存时间；资讯最快一分钟一次，日报出刊后再取。

接口一览

方法路径说明
GET/api/v1/items精选或最近 7 天公开动态；支持分类、时间和关键词
GET/api/v1/hot-topics当前热点榜与事件排名
GET/api/v1/stories/{publicId}事件详情：报道时间线、综述与关联事件
GET/api/v1/dailies亚马逊日报日期索引
GET/api/v1/dailies/latest最新亚马逊日报
GET/api/v1/dailies/{date}指定日期的亚马逊日报
GET/api/v1/selected/snapshot当前全部精选；首次完整同步（分页）
GET/api/v1/selected/changes精选的新增、修改和撤选；之后只取变化

先知道这几件事

  • 不传 mode 等同 selected（精选）；只有明确需要全部公开动态才用 all。
  • 完整精选不限 7 天：snapshot 首次拿全，changes 只取变化；items 只看最近 7 天。
  • items 不带正文：返回摘要、推荐理由、站内阅读页与原文链接。
  • 没有推送通道：按响应的 s-maxage 带 If-None-Match 轮询，没变化时是 304。
  • 错误是 Problem JSON；反馈时附上 requestId 即可定位。

维护全部精选：一次快照，之后只拉变化

bash
# 首次：分页拿当前全部精选，保存第一页响应里的 cursor（逐页相同）
curl 'https://aiamz.news/api/v1/selected/snapshot?fields=minimal&limit=500'
# hasMore 为 true 就带 nextPage 继续翻
curl 'https://aiamz.news/api/v1/selected/snapshot?fields=minimal&limit=500&page=<上一页的 nextPage>'
# 翻完之后：原样回传 cursor，只拿新增、修改和撤选
curl 'https://aiamz.news/api/v1/selected/changes?cursor=<第一页响应的 cursor>&limit=100'

每页成功应用后再保存新 cursor。返回 409 snapshot_required 时重新取一次快照即可，接口不会静默漏数。

错误与恢复

  • 400：参数不合法；按 OpenAPI 修正，不要自动改成更宽的查询。
  • 409 snapshot_required：增量游标无法安全续传，重新取一次完整快照。
  • 429：遵守 Retry-After，不要增加并发重试。
  • 5xx：指数退避，并使用上次成功的缓存。