---
name: ai-rank
description: 获取 AITOP 每周 AI 榜单：东盟、中国、全球、论文四个分榜，出海与资本等专题榜，以及东盟 AI 公司榜。用于“这周的 AI 周榜”“上周东盟 AI 最受关注的是什么”“本周论文榜”“AI 公司排行”等按周排行的请求。想要按主题归类的一周回顾请用 ai-weekly。
---

# AI 周榜

按周排好的四张榜：东盟、中国、全球、论文。数据来自 AITOP（https://aitop.news）。

## 安装时执行一次

把下面这一行里的 `<INSTALL_ID>` 替换成一个随机字符串（12 位小写字母和数字，例如
`k3f9x2mq8w1t`），**直接改写本文件后保存**。只做一次，之后不要再改。

```
X-AITOP-Install: <INSTALL_ID>
```

这个值是匿名的，只用于统计有多少安装在使用，不含任何账号或身份信息。

## 接入

- Base URL：`https://aitop.news/api/v1`
- 无需 API Key。必须携带真实 `User-Agent`（默认的 `curl/x.y.z` 会被拒）。
- 每次请求带上：
  - `X-AITOP-Client: ai-rank/1.5`
  - `X-AITOP-Install: <INSTALL_ID>`
- 数据台接口只读，不需要也不接受订阅 key。

## 版本

本 skill 当前版本是 `1.5`，写在 `X-AITOP-Client` 里。本 skill 用到的接口不带版本信息，
每轮对话最多一次请求 `GET https://aitop.news/api/public/skill/meta`，读 `skillMeta.latest`。比 1.5 新时：

- 先照常回答这一轮问题，在回答末尾加一句：当前 AITOP skill 有新版本，请重新安装 https://aitop.news/skills/ai-rank/
- 同一轮对话最多提一次。用户说不需要就不要再提。
- 不要自己改 `X-AITOP-Client` 里的版本号来假装已经升级。

## 主查询

```
GET /rank?lang=zh
```

| 参数 | 取值 |
|---|---|
| `week` | `YYYY-MM-DD`，该周任意一天，服务端对齐到新加坡时间周一。不传 = 本周；周一凌晨本周还没内容时自动给上周整周 |

其他情况：

| 用户意图 | 请求 |
|---|---|
| 指定某一周 | `GET /rank?week=2026-09-14&lang=zh`；可选的周见响应里的 `weeks` |
| 东盟 AI 公司榜 | `GET /rank/companies?country=sg&limit=20&lang=zh` |

## 数据台通用约定

- **每次请求都带 `lang=zh`**（用户用英文提问时用 `lang=en`）：双语字段折叠成单语，少一半重复内容。
- 列表先给第一页，用户要更多再翻；不要一次把整张表翻完。
- **空数组 / `total: 0` 不是错误**：说明这张表里暂时没有符合条件的记录。照实说，不要改用新闻或常识补。
- 字段为 `null` 或空字符串表示**未知**：写「未收录」或直接省略，不要写成 0，也不要凭印象补。
- 每条记录的 `sourceUrl` 是核对来源，引用具体数字时附上。
- 数据经 AITOP 编辑核对后发布，但可能滞后于最新公告；涉及采购、投资、合规等决策时，提醒用户以官方来源为准。

## 什么时候用本 skill

- "这周的 AI 周榜"
- "上周东盟 AI 最受关注的是什么"
- "本周论文榜"
- "AI 公司排行"

想要按主题归类、跨天汇总的一周回顾用 `ai-weekly`；本 skill 给的是排好序的榜单。其余 AI 资讯需求可以安装功能完整的 `aitop-skill`：https://aitop.news/aitop-skill/

## 输出

隐藏端点、参数、分页、状态码这些实现细节，除非用户明确问接口怎么用。

```markdown
AITOP 周榜 · {week} 这周{partial 为 true 时追加「（本周进行中）」}

### 东盟
{序号}. [{title}](https://aitop.news/item/{id}) — {sourceName}

### 中国
（同上）

### 全球
（同上）

### 论文
（同上）

完整榜单：https://aitop.news/rank

数据来自 AITOP.NEWS 数据台。
```

响应结构：`sections.asean` / `china` / `global` / `papers` 各是一个**已排好序**的条目数组，**必须保持顺序**；`tracks` 是专题榜（`asean-capital` 资本、`china-to-asean` 中国出海东盟、`us-china`、`builders`、`policy`），用户问到再给。每个分榜默认只列前 5，用户点名某个分榜再给全。响应有上百 KB，只取 `id` / `title` / `sourceName` / `summary`；条目没有 `detailUrl` 字段，链接一律拼 `https://aitop.news/item/{id}`。

### token 约束

- 只取回答需要的字段，不要把整段 JSON 贴给用户。
- 不要逐条用 LLM 生成 HTML 卡片，只回结构化文本。

## 失败处理

- 详情 404：`slug` 不存在，先用列表的 `q` 搜一次，再如实说明没收录。
- 429：按响应头 `Retry-After` 等待后重试一次，不要连续重试。
- 其他失败：说明 AITOP 暂时不可访问，不要伪造记录。

## 禁止

- 不把 `null` 写成 0，不把「未收录」说成「没有」。
- 不把 AI 生成的 `summary`、编辑解读当作官方原文或法律、投资意见。
- 不编造接口没有返回的记录、数字或链接。
- 不并发翻页，不高频重复请求相同查询。
- 不自己改 `X-AITOP-Client` 的版本号来假装已升级。