Agent 接入

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

让 Claude Code、RSS reader 和任意 Agent 读取 AITOP 的动态、早读，以及公司库、融资、政策、周榜、模型库这几张结构化的表。标题默认进入站内详情，来源原文随时可核对；匿名免费，订阅 key 可选。

匿名可读 · 无需 KeydetailUrl 阅读 · sourceUrl 核对OpenAPI 3.1SKILL.md 标准

Skill · 任意 Agent · SKILL.md 标准

一个全能入口，加一组专用入口

SKILL.md 标准格式，Claude Code · Codex CLI · Cursor · Gemini CLI · GitHub Copilot · OpenCode · Cline · Windsurf 等任意 Agent 都能装。把「帮我安装这个 skill：地址」发给 Agent，它会自己装到对应目录。专用入口按母版分四类：资讯流读动态，话题雷达看热度和来龙去脉，数据台查模型、融资、政策、周榜这几张表，简报一次拼好几张表。Agent 靠描述决定用不用某个 skill，专门的入口在对应问题上更容易被选中。

aitop-skill全能入口

AITOP 资讯助手

全功能入口：动态、日报、搜索、详情、来源核对，一个装完。下面「资讯流」这组能做的它都能做，只是在具体意图上没那么准；话题、数据表和简报要装对应的专用入口。

只想装一个？把这句发给你的 Agent

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

说明页 SKILL.md

资讯流9按时间窗读 AI 动态，每个入口收窄到一类内容。

ai-news
AI 新闻速览
「今天 AI 圈有什么」——只做这一件事，5 秒给结论。
- “今天 AI 圈有什么”
- “最近 AI 有什么新闻”
适合：所有人 · 最高频SKILL.md
ai-daily
AI 日报
每天一份人工编排的精编日报，有主题、有结构。
- “今天的 AI 日报”
- “看下昨天的日报”
适合：习惯固定时间读一份的人SKILL.md
ai-models
大模型发布追踪
只看模型：谁发布了、什么参数、跑分如何。
- “最近有什么新模型”
- “Claude 有更新吗”
适合：开发者 · 技术决策者SKILL.md
ai-papers
AI 论文速递
只看论文：这周有什么值得读的研究。
- “最近有什么好论文”
- “这周的 AI 论文”
适合：研究者 · 学生SKILL.md
ai-tools
AI 工具发现
只看产品：又有什么新东西可以拿来用了。
- “最近有什么好用的 AI 工具”
- “有什么新 AI 产品”
适合：产品经理 · 工具党SKILL.md
ai-funding
AI 投融资与政策
只看钱和规则：谁融了多少，政策往哪走。
- “最近有什么 AI 融资”
- “AI 监管有什么新规定”
适合：投研 · 创业者SKILL.md
ai-weekly
AI 一周回顾
一周错过的都在这，按主题归好类。
- “这周 AI 发生了什么”
- “我一周没看了帮我补一下”
适合：周末补课的人SKILL.md
ai-labs
大厂一手动态
只看官方发布，不看二手转述。
- “OpenAI 官方最近发了什么”
- “各家大厂有什么动作”
适合：要准确信源的人SKILL.md
ai-topics
AI 内容选题雷达
不只是给你新闻，是告诉你这条能怎么写。
- “有什么可以写的 AI 选题”
- “帮我找个热点写文章”
适合：自媒体作者 · 运营SKILL.md

话题雷达2不按时间按话题：什么在涨，一条线的来龙去脉。

ai-rising
AI 上升热榜
不按时间按增速：哪些词正在往上冲。
- “现在 AI 圈什么最火”
- “有什么正在发酵的事”
适合：追热点的人 · 运营SKILL.md
ai-topic
AI 话题深挖
给一个词，还你它的来龙去脉、共现话题和信源。
- “帮我梳理一下 XX 这条线”
- “XX 这事儿到底怎么回事”
适合：研究者 · 分析师 · 写深度稿的人SKILL.md

数据台4查结构化的表：模型参数价格、融资记录、政策状态、周榜。

ai-model-db
大模型参数与价格库
查规格不查新闻：参数、上下文、API 价格、开源协议。
- “Claude Opus 5.5 的 API 多少钱”
- “哪些开源模型可以商用”
适合：开发者 · 做选型的人SKILL.md
ai-funding-db
AI 融资数据表
一笔一行：谁、哪一轮、多少钱、谁投的。
- “最近有哪些 AI 公司拿了 B 轮”
- “新加坡 AI 公司融资情况”
适合：投研 · 创业者 · BDSKILL.md
ai-policy-desk
AI 政策台
每条政策一张卡：状态、生效日、影响谁、该做什么。
- “欧盟 AI 法案什么时候生效”
- “哪些 AI 政策还在征询期”
适合：合规 · 出海 · 政策研究SKILL.md
ai-rank
AI 周榜
按周排好的四张榜：东盟、中国、全球、论文。
- “这周的 AI 周榜”
- “上周东盟 AI 最受关注的是什么”
适合：每周复盘的人SKILL.md

简报1一次读几张表，拼成一份分节简报。

ai-asean
东南亚 AI 简报
一次拿到东盟 AI 的榜单、融资和政策。
- “东南亚 AI 最近怎么样”
- “印尼 AI 有什么动静”
适合：出海东南亚 · 关注东盟市场的人SKILL.md

典型组合开发者ai-news + ai-model-db研究者ai-papers + ai-topic自媒体ai-topics + ai-rising投研ai-funding-db + ai-policy-desk出海东南亚ai-asean + ai-policy-desk

每个 skill 都会占 Agent 的上下文，装 2–3 个就够，拿不准就只装全能入口。怎么选见 Skill 全家桶；全部入口同步在 AITOP-NEWS/SKILLS。

全能入口怎么分流

aitop-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.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/items/{id}站内资讯详情，包含推荐理由、正文与多信源

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`	关键词服务端搜索，最长 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 上限。生产业务请走自托管或联系站长申请白名单。

订阅 key（可选）

匿名就能读，key 只是让它更顺手：登录后在 /skill-key 建一个只读 key，把常用查询（关键词、分类、频道、标签）存进去，之后请求不带这些参数时自动套用；详情不再截断，也不再插入站方提示。随时可回看和吊销。

两种传法，二选一

# 1) 查询参数
curl -H "$UA" "https://aitop.news/api/public/items?key=ak_xxx&since=24h"

# 2) 请求头（推荐，key 不进 URL、不进日志与浏览器历史）
curl -H "$UA" -H "X-AITOP-Key: ak_xxx" "https://aitop.news/api/public/items?since=24h"

请求里显式写的参数永远优先于 key 里存的——key 只补空缺，不会把你锁死在一个主题上。

数据台 · 结构化的表 · 匿名可读

不只是新闻流，还有几张表

公司库、融资、政策、周榜、话题、模型库这几张表都在 /api/v1 下匿名开放，限流与阅读接口一致。都支持 lang=zh|en 折叠成单语；列表类支持 page / size。

想要什么	端点
AI 公司库：东南亚、中国、美国（可按国家 / 方向 / 政府计划筛）	`GET /api/v1/companies`；`/companies/facets`；`/companies/{slug}`
公开披露的融资事件与 90 天统计	`GET /api/v1/funding`；`/funding/facets`
AI 政策、征询、生效日历、政府计划	`GET /api/v1/policy`；`/policy/calendar`；`/policy/programs`
周榜（东盟 / 中国 / 全球 / 论文）与公司榜	`GET /api/v1/rank`（`?week=YYYY-MM-DD`）；`/rank/companies`
模型库：机构、发布日期、开源与协议、上下文、API 价格（美元 / 百万 token）与调价记录、新闻时间线	`GET /api/v1/models`（`?org=&open=&cap=&size=&region=`；这里 `size` 是参数规模 s / m / l / xl，分页用 `pageSize`）；`/models/facets`；`/models/{slug}`
一个话题有多少内容、相邻话题、主要信源	`GET /api/v1/tags/hub?tag=...`
周刊、专题、企业指南	`GET /api/v1/weekly/latest`；`/weekly/archive`；`/stories`；`/guides`

curl 示例

先 export UA（见 REST API 一栏），再复制例子

# 新加坡的 AI 公司，按最近有动态排序
curl -H "$UA" "https://aitop.news/api/v1/companies?country=sg&sort=recent&size=50"

# 最近 90 天的融资统计（国家分布 + 总额）
curl -H "$UA" "https://aitop.news/api/v1/funding/facets"

# 东盟 AI 政策，只要还在征询期的
curl -H "$UA" "https://aitop.news/api/v1/policy?status=consultation"

# 上周周榜（不传 week = 本周）
curl -H "$UA" "https://aitop.news/api/v1/rank?week=2026-08-31"

# 一个话题的体量与相邻话题
curl -H "$UA" "https://aitop.news/api/v1/tags/hub?tag=OpenAI"

# 开源、可商用、参数 70B 以下的模型，按近 30 天新闻热度
curl -H "$UA" "https://aitop.news/api/v1/models?open=true&commercial=yes&size=m"

# 一个模型的参数、价格、调价记录与新闻时间线
curl -H "$UA" "https://aitop.news/api/v1/models/claude-opus-5-5"

两件要知道的事

空数组不是错误 — 专题、企业指南、政府计划这几张表还在补，编辑没录之前会正常返回空列表。
要整表就用导出 — 公司库与融资表支持会员 CSV 导出（/api/v1/user/export/companies.csv、funding.csv，需登录且是有效会员），比翻页省事，见会员中心。

使用须知

详情优先 / 原文可核 / 合理使用

原文为准 — 摘要由 LLM 生成，引用或核对事实请用 sourceUrl（原文链接）回源确认；detailUrl 是 AITOP 站内详情页（/item/{id}），作为默认展示链接。
合理使用 — 默认限流足够正常会话和 RSS reader 默认轮询频率使用。
测试版 — 目前 RSS / API / Skill 三轨都处于测试阶段，如果服务器扛不住或出现滥用，可能会临时下线、调整接口、或加访问限制。生产业务请勿强依赖。