GET
/api/agents列表 / 搜索 Agents
支持 tab、q、sort、page、pageSize。用于其他系统做列表展示与搜索。
示例：/api/agents?tab=trending&q=sql&sort=popularity&page=1&pageSize=20
OpenAPI
AgentMarket API
面向其他系统的 HTTP API。GET 列表/详情/下载公开；上传需 Bearer API Token（登录后在 /account/tokens 颁发或吊销）。已开启 CORS（含 `Authorization`）。完整契约见 OpenAPI 3.1。Agent 包与 I/O 规范见仓库 docs/。
Package & I/O specs
- 开发规范（菜单 Spec）：/spec · 源文件
docs/agent-dev-spec.md - 包结构：
docs/agent-package-spec.md（AGENT.md+Soul.md+schemas/；agent.yaml可选） - 统一输入 / 输出信封：
docs/agent-io-spec.md - JSON Schema：
docs/schemas/
Endpoints
POST
/api/agents上传 / 发布 Agent（需 Bearer Token）
multipart/form-data：name、description、package(zip，需含 AGENT.md + Soul.md + schemas；agent.yaml 可选)；可选 version/category/license/changelog。请求头需 Authorization: Bearer <token>。开发规范见菜单 Spec（/spec）。
示例：/api/agents
GET
/api/agents/{slug}Agent 详情
返回元数据、AGENT.md 全文与版本列表。
GET
/api/agents/{slug}/download-url获取下载链接
返回绝对 downloadUrl / 相对 downloadPath，不增加下载计数。可选 version。
GET
/api/agents/{slug}/download下载 Agent 包
流式返回 zip，并 downloads++。默认最新；可选 `?version=1.0.0` 下载历史版本。
GET
/api/openapiOpenAPI 文档
默认 JSON；?format=yaml 返回 YAML。
GET
/api/agent-kitAgentMarket OpenAPI 接入包（zip）
下载 agentmarket-openapi 包，供 Claude Code / Cursor 等一键接入本市场 API。
GET
/api/agent-kit/install.shmacOS / Linux 一键安装脚本
curl | bash 安装到 ~/.claude/skills 与 ~/.cursor/skills。
GET
/api/agent-kit/install.ps1Windows 一键安装脚本
PowerShell irm | iex 安装到用户目录 skills 路径。
Integration notes
- 列表场景调用
/api/agents，用返回的items渲染表格。 - 上传用
POST /api/agents（multipart：name、description、packagezip），并带Authorization: Bearer <token>。Token 前缀为am_。 - 登录后到 /account/tokens 创建 Token；泄露后可吊销并重建，吊销后立即 401。
- 搜索传
q；分类视图传tab=featured|official|new|trending。 - 详情页调用
/api/agents/{slug}。 - 下载前先调
/download-url拿链接，再请求downloadUrl获取 zip。