Agent 接入

把 AITOP 接进你的工作流（测试版）

让 Claude Code、RSS reader、任意 Agent 直接读到 AITOP 的全部 AI 动态和每日精编日报。匿名免费、无需 token。

Skill · 任意 Agent · SKILL.md 标准

一份 Skill，任何 Agent 都能用

SKILL.md 标准格式，跨 Claude Code · Codex CLI · Cursor · Gemini CLI · GitHub Copilot · OpenCode · Cline · Windsurf 等任意 Agent 平台都能装。装好后用最自然的中文一句话拿到 AITOP 数据，不需要 API Key、不需要配 MCP server。

安装

在你的 Agent 里直接发这句话，Agent 会自己装到对应目录，不用你操心路径：

帮我安装这个 skill：https://aitop.news/aihot-skill/

本 Skill 同步到 AITOP 官方 Skills 集合 AITOP-NEWS/SKILLS。

触发示例

"今天 AI 圈有什么新东西"
"看一下今天的 AI 日报"
"最近 OpenAI 有什么发布"
"看下精选条目"
"最近一周的 AI 论文"
"AI 模型发布列表"
"最近 3 天 AI 行业动态"
"AI 圈昨天发生了什么"

Skill 内部能做的事

Skill 根据用户意图智能分流端点。默认走精选；只有用户明确说"日报"才走 daily，明确说"全部 / 完整 / 所有 / 全量"才走 mode=all。

用户意图	调用的端点
默认（宽问题）："今天 AI 圈"、"过去 24 小时"、"最近 AI 圈"	`GET /api/public/items?mode=selected&since=<语义窗>`
明确说"日报"："AI 日报"、"今天的日报"	`GET /api/public/daily` 或 `/daily/{date}`
明确说"全部 / 完整 / 所有 / 全量"	`GET /api/public/items?mode=all`
"AI 模型 / 产品 / 论文 / 技巧"（带分类）	`GET /api/public/items?mode=selected&category=...`
"最近 N 天 ..." 时间窗	`GET /api/public/items?mode=selected&since=ISO-8601`
"OpenAI / Anthropic 最近发的" / 关键词搜索	`GET /api/public/items?q=OpenAI`（服务端 ILIKE，走 PostgreSQL pg_trgm GIN 2-6ms；不要拉一批回客户端 jq grep）
"哪些日期有日报"（discovery）	`GET /api/public/dailies?take=N`

SKILL.md 完整的工作流、JSON 响应 shape、输出模板见 /aihot-skill/SKILL.md（也是 Skill 装到本地的真身）。

RSS · 任意 reader 订阅

三个 feed，按需订阅

所有主流 RSS reader（Feedly / Inoreader / NetNewsWire / Reeder / Reader.app / Tiny Tiny RSS …）都能直接订阅。复制下面的 URL 粘到 reader 里即可。

三个 feed

AITOP — 精选

每日精编候选池，最新 50 条

推荐订阅 — 大多数人想要的就是这个

https://aitop.news/feed.xml

AITOP — 全部 AI 动态

抓取的全部 AI 行业内容流，最新 50 条

信息密度高 / 想自己筛选的人

https://aitop.news/feed/all.xml

AITOP 日报

每天 08:00 北京时间发布的精编日报，最新 30 期

每天一条，最适合阅读类 RSS reader

https://aitop.news/feed/daily.xml

技术规范（给 reader 实现者 / Agent）

格式：RSS 2.0，所有 reader 都吃。
编码：UTF-8，Content-Type: application/rss+xml。
缓存：响应带 ETag + Last-Modified。reader 带 If-None-Match / If-Modified-Since 时未变返回 304 Not Modified 不重传 body。
浏览器自动发现：站点 <head> 里有 link rel="alternate"，多数 reader 扩展会直接提示订阅。
推荐轮询频率：≥ 30 分钟（reader 默认）。频率过高会撞 nginx 限流（600 req/min/IP）。

完整 HTTP 响应头示例

GET /feed.xml — 200 响应头

HTTP/1.1 200 OK
Content-Type: application/rss+xml; charset=utf-8
ETag: W/"a3f8e2b1c4d5"
Last-Modified: Wed, 07 May 2026 15:30:00 GMT
Cache-Control: public, s-maxage=300, stale-while-revalidate=600

REST API · 任意语言

完整 OpenAPI 3.1，匿名只读

无需 token。响应只暴露用户在浏览器能看到的最终内容字段（评分 / AI 标签 / 内部分类编号一律不含）。

建议优先读 /api/public/openapi.yaml 拿严格 schema，可直接导入 Postman / Hoppscotch。

先决条件 · 必须带 User-Agent

默认 curl/x.y.z UA 会被挡 → 403。所有 curl 例子先 export UA 一次，后续引用 $UA。浏览器 fetch / RSS reader / 主流 SDK 默认带 UA，无需处理。

先 EXPORT UA 一次，后续 CURL 例子复用

UA="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"

端点速览

GET/api/public/itemsAI 动态列表，cursor 翻页，mode=selected 默认

GET/api/public/daily最新一期日报

GET/api/public/daily/{date}指定日期日报，YYYY-MM-DD

GET/api/public/dailies有日报的日期列表（discovery），支持 take=N

GET/api/public/openapi.yaml完整 OpenAPI 3.1 spec（YAML）

/items 参数

参数	说明
`mode`	`selected`（默认精选）或 `all`（全量）
`since`	时间下界：ISO-8601、日期（`2026-05-01`）、或 `24h` / `7d` 快捷写法。Agent 主路径，大多数情况只需要这个。
`take`	每页条数，1–200，默认 20。Agent 建议用 `take=100` 减少往返。
`cursor`	上一页响应里的 `nextCursor` 原样传入；首页不传。
`category`	`ai-models` · `ai-products` · `industry` · `paper` · `tip`
`channel`	`firstParty` · `news` · `x` · `community` · `blog` · `paper`
`q`	关键词搜索（服务端 ILIKE，pg_trgm GIN 索引，2-6ms），最长 100 字符
`tag`	按标签精确过滤

响应 schema

响应结构（/items）

{
  "hasMore": true,
  "nextCursor": "eyJhIjoxNzE0OTk1MjAwMDAwLCJpIjoiY205eHl6In0",
  "items": [
    {
      "id": "cm9xyz1234567890abcdefghi",
      "sourceName": "OpenAI",
      "url": "https://...",
      "title": "GPT-5 发布",
      "title_en": null,
      "summary": "OpenAI 今日发布...",
      "category": "ai-models",
      "channel": "firstParty",
      "isFeatured": true,
      "tags": ["gpt", "openai"],
      "publishedAt": "2026-05-13T08:00:00Z",
      "media": []
    }
  ]
}

字段	类型	说明
`hasMore`	`boolean`	是否还有更多数据
`nextCursor`	`string \| null`	`hasMore=false` 时为 `null`；否则原样传给下次请求的 `cursor`
`items[].id`	`string`	cuid2，25 字符，不是数字
`items[].publishedAt`	`string \| null`	ISO 8601 UTC（带 Z）；来源无明确发布时间时为 `null`
`items[].summary`	`string \| null`	AI 生成摘要；尚未处理时为 `null`
`items[].category`	`string \| null`	仅 5 个 enum 值 + `null`，不会出现其他值

curl 示例

先 export UA（见上），再复制例子

# Agent 主路径：拿过去 24h 精选，一次最多 100 条
curl -H "$UA" "https://aitop.news/api/public/items?mode=selected&since=24h&take=100"

# 关键词搜索
curl -H "$UA" "https://aitop.news/api/public/items?q=OpenAI&take=20"

# 翻下一页（把上一响应的 nextCursor 原样传入）
curl -H "$UA" "https://aitop.news/api/public/items?mode=selected&cursor=<nextCursor>

# 最新日报
curl -H "$UA" "https://aitop.news/api/public/daily"

限流

60 req/min（按 IP，Go 应用层）；超限返回 429 + Retry-After 头。nginx 层另有 600 req/min 上限。生产业务请走自托管或联系站长申请白名单。

使用须知

原文为准 / 合理使用 / 测试版

原文为准 — 摘要由 LLM 生成，引用前请用 url 字段回原文核对。
合理使用 — 默认限流足够正常会话和 RSS reader 默认轮询频率使用。
测试版 — 目前 RSS / API / Skill 三轨都处于测试阶段，如果服务器扛不住或出现滥用，可能会临时下线、调整接口、或加访问限制。生产业务请勿强依赖。