接口文档 | 灵泽能力市场

OVERVIEW

快速开始

当前 API 为公开只读接口。调用方不需要提供 Token、Cookie 或用户身份，服务端不会返回内部代码托管地址和访问凭据。

Base URLhttps://market.lzwc.cn

GET/api/v1/search搜索、筛选与分页 GET/api/v1/resources/{id}/download下载能力包

GET/api/v1/search

搜索能力

搜索中文标题、仓库名、描述、领域和 Topics，并支持类型筛选、排序与分页。

查询参数

参数	类型	默认值	说明
`q`	string	空	搜索关键词，最大 200 字符
`type`	string	`all`	`all`、`mcp`、`skill`
`domain`	string	`all`	映射后的领域名称，例如“地图能力”
`sort`	string	`newest`	`newest`、`stars`、`name`
`page`	integer	`1`	页码，范围 1-100000
`pageSize`	integer	`20`	每页数量，范围 1-100

请求示例

cURL

curl -G 'https://market.lzwc.cn/api/v1/search' \
  --data-urlencode 'q=地图' \
  --data-urlencode 'type=skill' \
  --data-urlencode 'domain=地图能力' \
  --data-urlencode 'sort=name' \
  --data-urlencode 'page=1' \
  --data-urlencode 'pageSize=20'

响应示例

200 · application/json

{
  "apiVersion": "v1",
  "query": {
    "q": "地图",
    "type": "skill",
    "domain": "地图能力",
    "sort": "name"
  },
  "items": [
    {
      "id": 102,
      "name": "map-skill",
      "title": "地图查询服务",
      "type": "Skill",
      "domain": "地图能力",
      "description": "提供地图查询与地理编码能力。",
      "topics": ["skill", "domain-map"],
      "downloadUrl": "/api/v1/resources/102/download"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "total": 1,
    "totalPages": 1
  }
}

主要响应字段

字段	类型	说明
`id`	integer	能力 ID，用于下载接口
`name`	string	英文仓库名
`title`	string / null	通过 `market-title` 配置的中文标题
`type`	string	`MCP` 或 `Skill`
`domain`	string	领域显示名称
`downloadUrl`	string	v1 下载接口相对地址
`pagination`	object	页码、每页数量、总数量和总页数

GET/api/v1/resources/{id}/download

下载能力包

根据搜索结果中的能力 ID 下载默认分支的 .tar.gz 软件包。响应体是 gzip 二进制数据，不是 JSON。

路径参数

参数	类型	必填	说明
`id`	integer	是	搜索结果中的能力 ID

请求示例

cURL

curl -fLOJ 'https://market.lzwc.cn/api/v1/resources/102/download'

成功响应

200 · application/gzip

HTTP/1.1 200 OK
Content-Type: application/gzip
Content-Disposition: attachment; filename="map-skill-main.tar.gz"
Cache-Control: private, no-store
Access-Control-Allow-Origin: *

ERRORS

状态码

状态码	说明	处理建议
`200`	搜索或下载成功	解析 JSON 或保存文件
`204`	跨域预检成功	无需解析响应体
`400`	搜索参数错误	检查枚举值和分页范围
`404`	下载资源不存在	重新搜索并获取最新 ID
`502`	目录或软件包源暂不可用	稍后重试
`503`	市场服务尚未完成配置	联系运维人员

JSON 错误格式

{
  "error": "错误原因"
}

BROWSER

跨域调用

公开 API 支持浏览器跨域只读调用，并支持 OPTIONS 预检。

CORS 响应头

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, OPTIONS
Access-Control-Allow-Headers: Accept, Content-Type

数据边界公开接口不会返回内部代码托管地址、组织、默认分支或服务端访问 Token。