Agent 接入
把 AITOP 接进你的工作流（测试版）
让 Claude Code、RSS reader 和任意 Agent 读取 AITOP 动态与日报。标题默认进入站内详情，来源原文随时可核对；匿名免费，无需 token。
Skill自然语言触发，自动选择列表、日报或详情
REST APIOpenAPI 3.1，列表与安全详情契约完整
RSS标题进入站内详情，正文保留来源入口
双链接detailUrl 负责阅读，sourceUrl 负责核对
Skill · 任意 Agent · SKILL.md 标准
一份 Skill，任何 Agent 都能用
SKILL.md 标准格式，跨 Claude Code · Codex CLI · Cursor · Gemini CLI · GitHub Copilot · OpenCode · Cline · Windsurf 等任意 Agent 平台都能装。结果默认进入 AITOP 站内详情，引用和核实时仍可回到来源原文。
安装
在你的 Agent 里直接发这句话，Agent 会自己装到对应目录，不用你操心路径：
帮我安装这个 skill：https://aitop.news/aitop-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（使用服务端搜索，不拉取全量后在本地过滤） |
| "展开第 3 条" / "详细说说这条" | GET /api/public/items/{id} |
| "哪些日期有日报"（discovery） | GET /api/public/dailies?take=N |
SKILL.md 完整的工作流、JSON 响应 shape、输出模板见 /aitop-skill/SKILL.md（也是 Skill 装到本地的真身）。
RSS · 任意 reader 订阅
三个 feed，按需订阅
所有主流 RSS reader（Feedly / Inoreader / NetNewsWire / Reeder / Reader.app / Tiny Tiny RSS …）都能直接订阅。标题进入 AITOP 详情页，每条正文保留“查看来源原文”入口。
三个 feed
AITOP — 精选
每日精编候选池，最新 50 条
推荐订阅 — 大多数人想要的就是这个
https://aitop.news/feed.xmlAITOP — 全部 AI 动态
抓取的全部 AI 行业内容流，最新 50 条
信息密度高 / 想自己筛选的人
https://aitop.news/feed/all.xmlAITOP 日报
每天 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=600REST 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/items/{id}站内资讯详情，包含推荐理由、正文与多信源
GET/api/public/daily最新一期日报
GET/api/public/daily/{date}指定日期日报，
YYYY-MM-DDGET/api/public/dailies有日报的日期列表（discovery），支持
take=NGET/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 | 关键词服务端搜索，最长 100 字符 |
tag | 按标签精确过滤 |
响应 schema
响应结构（/items）
{
"hasMore": true,
"nextCursor": "eyJhIjoxNzE0OTk1MjAwMDAwLCJpIjoiY205eHl6In0",
"items": [
{
"id": "2436",
"sourceName": "OpenAI",
"detailUrl": "https://aitop.news/item/2436",
"sourceUrl": "https://openai.com/example",
"url": "https://openai.com/example",
"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 | 数字字符串，不要假设固定长度 |
items[].detailUrl | string | 默认面向用户展示的 AITOP 站内详情链接 |
items[].sourceUrl | string | 来源原文链接，用于引用和事实核对 |
items[].url | string | sourceUrl 的兼容别名，已弃用 |
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/items/2436"
# 最新日报
curl -H "$UA" "https://aitop.news/api/public/daily"限流
60 req/min（按 IP，Go 应用层）；超限返回 429 + Retry-After 头。nginx 层另有 600 req/min 上限。生产业务请走自托管或联系站长申请白名单。
使用须知
详情优先 / 原文可核 / 合理使用
- 原文为准 — 摘要由 LLM 生成，引用或核对事实请用
sourceUrl（原文链接）回源确认；detailUrl是 AITOP 站内详情页（/item/{id}），作为默认展示链接。 - 合理使用 — 默认限流足够正常会话和 RSS reader 默认轮询频率使用。
- 测试版 — 目前 RSS / API / Skill 三轨都处于测试阶段，如果服务器扛不住或出现滥用，可能会临时下线、调整接口、或加访问限制。生产业务请勿强依赖。