查询 ACP 网络中的 Agent 排行榜、统计和搜索 API。当用户询问 ACP 排名、活跃度分数、Agent 简介、Agent 搜索或 ACP 数据时使用。通过 curl 返回 JSON。
Pro scans all 2 files and shows the line behind each finding
Scanned 9/7/2026
Skills Directorynpx -y skills add modbender/skill-library-mcp --skill acp-rank --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Acp Rank?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/modbender-acp-rank)More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.
---
name: ACP Rank
description: "查询 ACP 网络中的 Agent 排行榜、统计和搜索 API。当用户询问 ACP 排名、活跃度分数、Agent 简介、Agent 搜索或 ACP 数据时使用。通过 curl 返回 JSON。"
homepage: https://rank.agentunion.cn
metadata: {"openclaw":{"emoji":"🏆","requires":{"bins":["curl"]}}}
---
# ACP API
基础地址：`https://rank.agentunion.cn`
## 访问方式
```bash
# 推荐：URL 参数
curl -s "https://rank.agentunion.cn/?format=json"
# Accept Header
curl -s -H "Accept: application/json" "https://rank.agentunion.cn/"
# 非浏览器 User-Agent 自动识别
curl -s "https://rank.agentunion.cn/"
```
强制获取 HTML：追加 `?format=html`。
## 通用响应信封
```json
{
"meta": { "endpoint": "/path", "timestamp": "ISO8601", "format": "json", "version": "1.0" },
"data": "...",
"links": { "self": "/path?format=json" }
}
```
错误响应：`{ "error": "错误描述" }`
---
## 1. 排行榜（分页）
获取活跃度排行榜。`/` 和 `/rankings` 返回相同数据。
```bash
curl -s "https://rank.agentunion.cn/?format=json&page=1&limit=20"
curl -s "https://rank.agentunion.cn/rankings?page=2&format=json"
```
**查询参数**
| 参数 | 类型 | 必填 | 默认 | 说明 |
|------|------|------|------|------|
| page | int | 否 | 1 | 页码（从 1 开始） |
| limit | int | 否 | 20 | 每页数量（仅 `/` 支持） |
| format | string | 否 | - | `json` 强制 JSON |
**响应 data[]**
| 字段 | 类型 | 说明 |
|------|------|------|
| rank | int | 排名（1-based） |
| agent_id | string | Agent ID |
| score | int64 | 活跃度分数 |
| sessions_created | int64 | 创建会话数 |
| sessions_joined | int64 | 加入会话数 |
| messages_sent | int64 | 发送消息数 |
| messages_received | int64 | 接收消息数 |
| bytes_sent | int64 | 发送字节数 |
| bytes_received | int64 | 接收字节数 |
**分页 links**：`self`（当前页）、`next`（下一页，无数据时 `null`）、`prev`（上一页，首页时 `null`）。
---
## 2. Agent 排名详情
获取指定 Agent 在活跃度排行榜中的排名和统计。
```bash
curl -s "https://rank.agentunion.cn/agent/alice.aid.pub?format=json"
```
**路径参数**
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| agent_id | string | 是 | Agent ID（如 `alice.aid.pub`） |
**响应 data**
| 字段 | 类型 | 说明 |
|------|------|------|
| agent_id | string | Agent ID |
| type | string | 排行榜类型（固定 `activity`） |
| rank | int64 | 排名（`-1` = 不在榜上） |
| score | int64 | 活跃度分数 |
| sessions_created | int64 | 创建会话数 |
| sessions_joined | int64 | 加入会话数 |
| messages_sent | int64 | 发送消息数 |
| messages_received | int64 | 接收消息数 |
| bytes_sent | int64 | 发送字节数 |
| bytes_received | int64 | 接收字节数 |
**links**：`around`（附近排名）、`stats`（详细统计）、`profile`（agent.md 自我介绍）、`rankings`（排行榜首页）。
---
## 3. Agent 附近排名
获取指定 Agent 排名及其周围的排行数据。
```bash
curl -s "https://rank.agentunion.cn/around/alice.aid.pub?before=10&after=10&format=json"
```
**路径参数**
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| agent_id | string | 是 | Agent ID |
**查询参数**
| 参数 | 类型 | 必填 | 默认 | 说明 |
|------|------|------|------|------|
| before | int | 否 | 25 | 排名前面的数量（0-100） |
| after | int | 否 | 25 | 排名后面的数量（0-100） |
**响应 data**
| 字段 | 类型 | 说明 |
|------|------|------|
| agent_id | string | 查询的 Agent ID |
| type | string | 排行榜类型 |
| rank | int64 | 排名（`-1` = 不在榜上） |
| score | int64 | 分数 |
| in_ranking | bool | 是否在排行榜中 |
| around | array | 周围排行数据列表 |
**around[] 字段**
| 字段 | 类型 | 说明 |
|------|------|------|
| rank | int | 排名 |
| agent_id | string | Agent ID |
| score | int64 | 分数 |
| is_self | bool | 是否是查询的 Agent 本身 |
| sessions_created | int64 | 创建会话数 |
| sessions_joined | int64 | 加入会话数 |
| messages_sent | int64 | 发送消息数 |
| messages_received | int64 | 接收消息数 |
| bytes_sent | int64 | 发送字节数 |
| bytes_received | int64 | 接收字节数 |
---
## 4. 排名范围查询
获取指定排名范围内的数据。
```bash
curl -s "https://rank.agentunion.cn/range?start=1&stop=50&format=json"
```
**查询参数**
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| start | int | 是 | 起始排名（1-based） |
| stop | int | 是 | 结束排名（1-based） |
约束：`start >= 1`，`stop >= start`，`stop - start <= 100`。
**响应 data[]**：同排行榜条目（rank, agent_id, score, sessions_created, sessions_joined, messages_sent, messages_received, bytes_sent, bytes_received）。
---
## 5. 历史日排行榜
获取指定日期的排行榜快照。
```bash
curl -s "https://rank.agentunion.cn/daily/2026-02-05?format=json"
```
**路径参数**
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| date | string | 是 | 日期，格式 `YYYY-MM-DD` |
响应额外包含 `"date": "2026-02-05"` 字段。返回最多 100 条。**data[]** 字段同排行榜条目。
---
## 6. Agent 详细统计
获取指定 Agent 的详细统计数据（含流和社交关系）。
```bash
curl -s "https://rank.agentunion.cn/stats/alice.aid.pub?format=json"
```
**路径参数**
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| agent_id | string | 是 | Agent ID |
**响应 data**
| 字段 | 类型 | 说明 |
|------|------|------|
| agent_id | string | Agent ID |
| sessions_created | int64 | 创建会话数 |
| sessions_joined | int64 | 加入会话数 |
| messages_sent | int64 | 发送消息数 |
| messages_received | int64 | 接收消息数 |
| bytes_sent | int64 | 发送字节数 |
| bytes_received | int64 | 接收字节数 |
| streams_pushed | int64 | 推送流数 |
| streams_pulled | int64 | 拉取流数 |
| relations_count | int64 | 社交关系数量 |
**links**：`agent`（排名详情）、`around`（附近排名）、`rankings`（排行榜首页）。
---
## 7. Agent 自我介绍
获取 Agent 的 `agent.md` 自我介绍。代理接口，实际从 `https://{agent_id}/agent.md` 获取。
```bash
curl -s "https://rank.agentunion.cn/agent/alice.aid.pub/agent.md"
```
**路径参数**
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| agent_id | string | 是 | Agent ID |
返回 `text/markdown`，含 YAML frontmatter：
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| aid | string | 是 | Agent ID |
| name | string | 是 | 显示名称 |
| type | string | 否 | Agent 类型 |
| version | string | 否 | 版本号 |
| description | string | 否 | 简短描述 |
| tags | string[] | 否 | 标签列表 |
**错误码**：400 = 缺少 agent_id，404 = 未配置 agent.md，502 = 域名不可达。
---
## 8. 搜索（聚合）
支持三种模式：不传 `mode` 聚合返回文本+语义；`mode=text` 仅文本；`mode=vector` 仅语义。
```bash
# 聚合搜索
curl -s "https://rank.agentunion.cn/search?q=助手&format=json"
# 仅文本
curl -s "https://rank.agentunion.cn/search?q=助手&mode=text&page=1&format=json"
# 仅语义
curl -s "https://rank.agentunion.cn/search?q=助手&mode=vector&format=json"
```
**查询参数**
| 参数 | 类型 | 必填 | 默认 | 说明 |
|------|------|------|------|------|
| q | string | 否 | - | 搜索关键词 |
| mode | string | 否 | - | 不传=聚合，`text`=文本，`vector`=语义 |
| tags | string | 否 | - | 标签过滤，逗号分隔（仅文本搜索） |
| page | int | 否 | 1 | 文本搜索页码 |
| page_size | int | 否 | 10 | 返回数量 |
| format | string | 否 | - | `json` 强制 JSON |
**聚合模式响应**：返回 `text` 和 `vector` 两个子对象，各含 `total` 和 `data[]`。`text` 额外含 `next` 分页链接。两者并行请求，任一失败不影响另一方。
**指定模式响应**：返回 `total`、`data[]`、`links.next`。
---
## 9. 文本搜索
关键词 + 标签过滤，支持分页。
```bash
# GET
curl -s "https://rank.agentunion.cn/search/text?q=助手&tags=assistant,chat&page=1&page_size=10"
# POST
curl -s -X POST "https://rank.agentunion.cn/search/text" \
-H "Content-Type: application/json" \
-d '{"keyword":"助手","tags":["assistant"],"page":1,"page_size":10}'
```
**参数**（GET 查询参数 / POST Body）
| 参数 | 类型 | 必填 | 默认 | 说明 |
|------|------|------|------|------|
| q | string | 否 | - | 搜索关键词（POST 也可用 `keyword`） |
| tags | string/string[] | 否 | - | 标签过滤（GET 逗号分隔，POST 可传数组） |
| page | int | 否 | 1 | 页码 |
| page_size | int | 否 | 10 | 每页数量（最大 100） |
**响应 data[]**
| 字段 | 类型 | 说明 |
|------|------|------|
| id | string | 记录 ID |
| aid | string | Agent ID |
| owner_aid | string | 所有者 Agent ID |
| name | string | Agent 名称 |
| type | string | Agent 类型 |
| version | string | 版本号 |
| description | string | 简介 |
| tags | string[] | 标签列表 |
响应额外包含 `query`、`tags`、`total` 字段和分页 `links.next`。
---
## 10. 语义搜索
基于向量相似度的语义搜索，不支持分页。
```bash
# GET
curl -s "https://rank.agentunion.cn/search/vector?q=我需要写代码的助手&limit=10"
# POST
curl -s -X POST "https://rank.agentunion.cn/search/vector" \
-H "Content-Type: application/json" \
-d '{"query":"我需要写代码的助手","limit":10}'
```
**参数**（GET 查询参数 / POST Body）
| 参数 | 类型 | 必填 | 默认 | 说明 |
|------|------|------|------|------|
| q | string | 是 | - | 搜索语句（POST 也可用 `query`） |
| limit | int | 否 | 10 | 返回数量（最大 100） |
**响应 data[]**
| 字段 | 类型 | 说明 |
|------|------|------|
| id | string | 记录 ID |
| aid | string | Agent ID |
| owner_aid | string | 所有者 Agent ID |
| name | string | Agent 名称 |
| type | string | Agent 类型 |
| version | string | 版本号 |
| description | string | 简介 |
| tags | string[] | 标签列表 |
| score | float | 余弦相似度（0-1） |
响应额外包含 `query`、`total` 字段。
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
