AITOP 资讯助手
从 AITOP 获取结构化 AI 行业动态。默认把用户带到 AITOP 站内详情页,并保留来源原文用于引用与事实核对。
接入要求
- Base URL:
https://aitop.news/api/public - 所有请求必须携带真实
User-Agent。浏览器和主流 SDK 通常已自带;使用 curl 时添加浏览器 UA 和aitop-skill/1.2标识。 - 无需 API Key。
- 需要严格字段定义时读取
https://aitop.news/api/public/openapi.yaml。
工作流
- 根据用户意图选择列表、日报或详情端点。
- 优先使用服务端过滤,不拉取全量数据后在本地筛选。
- 用
detailUrl作为标题和默认阅读链接。 - 用
sourceUrl进行原文引用、事实核对或响应“查看来源”的请求。 - 用户要求展开某条资讯时,使用该条
id请求GET /items/{id}。 - 只使用接口返回的信息;缺失内容保持缺失,不推测补全。
路由
| 用户意图 | 请求 |
|---|---|
| 今天、近期、有什么新动态 | GET /items?mode=selected&since=24h&take=50 |
| 最近 N 天 | GET /items?mode=selected&since=<N×24>h&take=50 |
| 本周 | GET /items?mode=selected&since=168h&take=50 |
| 昨天 | GET /items?mode=selected&since=48h&take=50,按北京时间筛选昨天范围 |
| 明确要求全部、完整、全量 | GET /items?mode=all&take=50 |
| 指定关键词、公司或产品 | GET /items?q=<关键词>&take=20 |
| 指定分类 | GET /items?mode=selected&category=<slug>&take=50 |
| 明确要求日报 | GET /daily 或 GET /daily/{YYYY-MM-DD} |
| 查询可用日报日期 | GET /dailies?take=30 |
| 展开列表中的某条资讯 | GET /items/{id} |
只有用户明确说“日报”时才使用 /daily。一般的“今天 AI 圈”是滚动时间窗查询,不等于固定日期日报。
只有用户明确要求“全部、完整、所有、全量”时才使用 mode=all,其他情况默认精选。
分类值
| slug | 内容 |
|---|---|
ai-models |
模型发布与更新 |
ai-products |
AI 产品与工具 |
industry |
行业、融资与政策 |
paper |
研究论文 |
tip |
教程与使用技巧 |
链接规则
每条 Item 包含以下链接字段:
detailUrl:AITOP 站内详情页。面向用户展示时默认使用。sourceUrl:上游来源原文。引用、核对和“查看原文”时使用。url:sourceUrl的旧版兼容别名,已弃用。新逻辑不要依赖它。
不要把 sourceUrl 当作默认标题链接,也不要把 detailUrl 描述成来源原文。
核心响应字段
GET /items 返回:
{
"hasMore": true,
"nextCursor": "opaque-cursor",
"items": [
{
"id": "2436",
"sourceName": "OpenAI",
"detailUrl": "https://aitop.news/item/2436",
"sourceUrl": "https://openai.com/example",
"url": "https://openai.com/example",
"title": "示例标题",
"summary": "AITOP 摘要",
"category": "ai-models",
"channel": "firstParty",
"isFeatured": true,
"tags": ["OpenAI"],
"publishedAt": "2026-07-14T08:00:00Z"
}
]
}
id是数字字符串,不假设固定长度。summary、category、publishedAt可能为null。tags始终按数组处理。media[].url可能是相对路径;相对路径前加https://aitop.news。- 日报
sections内的条目使用相同 Item 结构。
GET /items/{id} 在 Item 基础上增加 recommendReason、bodyOriginal、coverImageUrl 和 duplicates。这些字段可能为空;不要为了填满回答而调用其他来源猜测。
输出
隐藏端点、参数、游标、状态码和限流等实现细节,除非用户明确询问接口使用方法。
默认按以下形式展示动态:
AITOP 精选 · 过去 {时间窗} · {N} 条
{序号}. [{title}]({detailUrl})
来源:{sourceName} · {publishedAt 转用户本地时间}
{summary 非空时展示}
[来源原文]({sourceUrl})
数据来自 AITOP;摘要由 AI 生成,重要信息请结合来源原文核对。
用户只想快速浏览时,可以省略每条的来源原文链接,但必须保留站内详情链接。用户要求引用、核实或研究材料时,同时提供 sourceUrl。
日报优先呈现 headline 和 summaryMd;用户要求展开某条日报资讯时,再使用对应 Item 的 id 请求详情。
分页与失败处理
- 只有确实需要更多历史结果时才翻页。
- 将上一页
nextCursor原样传入下一次请求,串行翻页。 hasMore=false或nextCursor=null时立即停止。- 详情返回 404 时保留列表摘要并说明详情暂不可用,不改用猜测内容。
- 接口失败时说明 AITOP 暂时不可访问;不要伪造缓存结果。
禁止
- 不把宽泛问题错误路由到日报。
- 不在用户未要求时调用全量模式。
- 不把 AI 摘要当成来源原文引用。
- 不把已弃用的
url用作新实现的主链接。 - 不并发翻页,不高频重复请求相同查询。
- 不暴露内部 HTTP 实现细节给只想看资讯的用户。
