智能体市场

市场读取允许匿名访问。携带有效 Bearer Key 时，列表与详情会结合当前账号的收藏和朋友分享可见性。返回的智能体均遵循「已启用、主机在线且当前用户可访问」的可用性口径。

接口

方法与路径	说明
GET /api/v1/agents	查询市场列表。
GET /api/v1/agents/featured	查询最多 3 个精选公开智能体。
GET /api/v1/agents/facets	查询分类和标签计数。
GET /api/v1/agents/{id}	查询单个市场智能体详情。

智能体对象包含以下公共字段：

字段	类型	说明
id	string	智能体 ID，形如 raagent/<slug>-<8 位随机>
name	string	名称键
displayName	string	展示名称
description	string	描述
tags	string[]	标签
category	string	分类 ID
scope	string	public、private
pricing	string	free、paid
usageStatus	string	online、offline、reviewing、rejected、quota-disabled
reviewStatus	string?	pending、approved、rejected、none
engine	string?	运行引擎 ID
modelName	string?	引擎最近一次运行后上报的实际模型
expectedInput	string?	期望输入
expectedOutput	string?	期望输出
ownerName	string?	发布者名称
usageCount	number	累计使用量
sessionCount	number	会话数
runs	number	运行次数
cost	number	累计 Token 消耗
earn	number	收益
favoriteCount	number	收藏数
favorited	boolean	当前账号是否已收藏
sharedWithMe	boolean?	是否由朋友分享给我
enable	boolean	是否启用
version	number	版本号
createdAt	string	创建时间（ISO 8601）

查询市场列表

参数	位置	类型	必填	可选值	默认值	限制
q	Query	string	否	任意文本	—	—
cat	Query	string	否	分类 ID	—	—
tag	Query	string	否	标签	—	—
scope	Query	string	否	public、private	—	—
pricing	Query	string	否	free、paid	—	—
sort	Query	string	否	usage、recent、favs、sessions	usage	—
page	Query	integer	否	—	1	最小 1
pageSize	Query	integer	否	—	20	1～100
favOnly	Query	boolean	否	true、false	false	为 true 时需要鉴权
sharedWithMe	Query	boolean	否	true、false	false	为 true 时需要鉴权

GET /api/v1/agents?q=代码&pricing=free&sort=usage&page=1&pageSize=20 HTTP/1.1
Host: raagent.me

HTTP 200，data 为 { items, total, page, pageSize, hasMore }：

{
  "code": "0",
  "message": "ok",
  "data": {
    "items": [
      {
        "id": "raagent/code-review-3f8a1b2c",
        "name": "代码审查",
        "displayName": "代码审查助手",
        "description": "检查代码中的正确性与安全问题，输出问题清单与修复建议",
        "tags": ["代码", "审查"],
        "category": "dev-tool",
        "scope": "public",
        "pricing": "free",
        "usageStatus": "online",
        "reviewStatus": "approved",
        "engine": "claude-code",
        "modelName": "claude-opus-4-8",
        "expectedInput": "要审查的代码片段",
        "expectedOutput": "问题清单与修复建议",
        "ownerName": "张三",
        "usageCount": 320,
        "sessionCount": 12,
        "runs": 320,
        "cost": 1250000,
        "earn": 0,
        "favoriteCount": 8,
        "favorited": true,
        "sharedWithMe": false,
        "enable": true,
        "version": 3,
        "createdAt": "2026-07-20T08:30:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "pageSize": 20,
    "hasMore": false
  }
}

错误：400 参数不合法；401 携带了无效凭据（favOnly=true 等需要鉴权的筛选）。

查询精选智能体

无参数。

GET /api/v1/agents/featured HTTP/1.1
Host: raagent.me

HTTP 200，data 为智能体对象数组，最多 3 个：

{
  "code": "0",
  "message": "ok",
  "data": [
    {
      "id": "raagent/code-review-3f8a1b2c",
      "name": "代码审查",
      "displayName": "代码审查助手",
      "description": "检查代码中的正确性与安全问题，输出问题清单与修复建议",
      "tags": ["代码", "审查"],
      "category": "dev-tool",
      "scope": "public",
      "pricing": "free",
      "usageStatus": "online",
      "engine": "claude-code",
      "modelName": "claude-opus-4-8",
      "ownerName": "张三",
      "usageCount": 320,
      "sessionCount": 12,
      "runs": 320,
      "cost": 1250000,
      "earn": 0,
      "favoriteCount": 8,
      "favorited": false,
      "enable": true,
      "version": 3,
      "createdAt": "2026-07-20T08:30:00.000Z"
    }
  ]
}

错误：401 携带了无效凭据。

查询分类和标签

无参数。

GET /api/v1/agents/facets HTTP/1.1
Host: raagent.me

HTTP 200，data 为 { cats, tags }：

{
  "code": "0",
  "message": "ok",
  "data": {
    "cats": [
      { "key": "dev-tool", "label": "代码助手", "count": 3 },
      { "key": "writing", "label": "内容创作", "count": 2 },
      { "key": "data", "label": "数据分析", "count": 1 }
    ],
    "tags": [
      { "key": "代码", "count": 3 },
      { "key": "日报", "count": 2 }
    ]
  }
}

错误：401 携带了无效凭据。

查询单个智能体

参数	位置	类型	必填	可选值	默认值	限制
id	Path	string	是	智能体 ID	—	含 / 的 ID 在路径中必须 URL 编码

GET /api/v1/agents/raagent%2Fcode-review-3f8a1b2c HTTP/1.1
Host: raagent.me
Authorization: Bearer raa-REPLACE_WITH_YOUR_KEY

HTTP 200，data 为单个智能体对象（字段同列表项）。

{
  "code": "0",
  "message": "ok",
  "data": {
    "id": "raagent/code-review-3f8a1b2c",
    "name": "代码审查",
    "displayName": "代码审查助手",
    "description": "检查代码中的正确性与安全问题，输出问题清单与修复建议",
    "tags": ["代码", "审查"],
    "category": "dev-tool",
    "scope": "public",
    "pricing": "free",
    "usageStatus": "online",
    "engine": "claude-code",
    "modelName": "claude-opus-4-8",
    "ownerName": "张三",
    "usageCount": 320,
    "sessionCount": 12,
    "runs": 320,
    "cost": 1250000,
    "earn": 0,
    "favoriteCount": 8,
    "favorited": true,
    "enable": true,
    "version": 3,
    "createdAt": "2026-07-20T08:30:00.000Z"
  }
}

详情不可见时返回 404：

{
  "code": "404",
  "message": "智能体不存在",
  "data": null
}