DeepSeek Harness 插件 API — 免费 JSON 接口与 RSS 订阅
公开的只读 DeepSeek Harness(dsh)插件 API:用 JSON 查询完整插件目录、按 owner/repo 获取单个插件详情,或用 RSS 订阅最新插件。无需注册,无需 API Key。
最近更新: 2026-09-15
DeepSeek Harness 插件目录提供公开的只读 JSON API 和 RSS 订阅源——不需要账号,不需要 API Key。你可以用它来做插件选择器、徽章服务、趋势看板,或者干脆基于这些数据搭一个自己的目录站。
基础地址: https://deepseekharnessplugins.com(和本站同一个域名)
所有响应都使用本站统一的包裹格式:
{ "code": 0, "message": "ok", "data": {} }
code: 0 表示成功;其他值表示出错,message 里有可读的错误说明。
查询插件列表
GET /api/v1/plugins
查询参数(全部可选):
| 参数 | 取值 | 默认值 | 说明 |
|---|---|---|---|
q | 任意字符串 | — | 按名称、描述和 topics 全文搜索 |
category | 分类 id(如 mcp、cli、agents-workflows) | — | 只看某个分类 |
curated | 1 | — | 只看编辑精选 |
sort | default、name、stars、forks、updated、heat | default | heat 是热度排序,兼顾 star 数和最近活跃度 |
page | 整数 ≥ 1 | 1 | |
pageSize | 整数 1–50 | 20 | 最大 50 |
示例:
curl "https://deepseekharnessplugins.com/api/v1/plugins?category=mcp&sort=stars&pageSize=5"
精简后的响应示例:
{
"code": 0,
"message": "ok",
"data": {
"items": [
{
"id": "owner/repo",
"name": "repo",
"full_name": "owner/repo",
"url": "https://github.com/owner/repo",
"homepage": null,
"description": "An MCP server for DeepSeek Harness",
"description_zh": null,
"category": "mcp",
"categories": ["mcp"],
"stars": 1234,
"forks": 56,
"language": "TypeScript",
"license": "MIT",
"archived": false,
"created_at": "2025-11-02T08:15:00Z",
"pushed_at": "2026-08-10T14:22:00Z",
"topics": ["dsh-plugin", "mcp"]
}
],
"total": 42,
"page": 1,
"pageSize": 5,
"generatedAt": "2026-08-18T06:00:00.000Z"
}
}
generatedAt 是本次响应所用目录快照的生成时间——判断本地缓存是否过期,看它就够了。
获取单个插件
GET /api/v1/plugins/:owner/:repo
返回字段与列表接口一致;仓库不在目录中时返回 404 错误包裹。
curl "https://deepseekharnessplugins.com/api/v1/plugins/cccakeee/awesome-dsh-plugins"
{
"code": 0,
"message": "ok",
"data": {
"plugin": {
"id": "cccakeee/awesome-dsh-plugins",
"name": "awesome-dsh-plugins"
},
"generatedAt": "2026-08-18T06:00:00.000Z"
}
}
RSS 订阅
目录中最新的 50 个插件,以 RSS 2.0 格式输出:
GET /plugins/feed.xml
把 https://deepseekharnessplugins.com/plugins/feed.xml 丢进任意 RSS 阅读器,就能跟踪新收录的插件。订阅源缓存一小时,目录快照每次更新后重建。
作为 DSH 客户端的插件源
同一个目录还以机器可读的插件源形式开放,DSH Desktop 和 CLI 工具可以直接指向本站。两个裸 JSON 接口位于 /market 下——没有包裹格式,不需要鉴权,是给客户端读的,不是给本站页面用的。
源清单
GET /market/manifest.json
源元信息:name 和 id、apiVersion、baseUrl、目录 stats、snapshotAt 快照时间,以及每个接口的绝对 URL。客户端先请求一次,就能发现 API 地址和可用接口。
{
"name": "DeepSeek Harness Plugins",
"id": "deepseekharness-plugins",
"apiVersion": "v1",
"description": "A directory of DeepSeek Harness (dsh) plugins",
"baseUrl": "https://deepseekharnessplugins.com",
"stats": {
"total": 15360,
"curated": 4372,
"categories": 22,
"totalStars": 831216
},
"snapshotAt": "2026-09-15T20:03:43.797Z",
"endpoints": [
{
"id": "manifest",
"method": "GET",
"url": "https://deepseekharnessplugins.com/market/manifest.json",
"description": "Catalog-source manifest — this document."
},
{
"id": "plugins",
"method": "GET",
"url": "https://deepseekharnessplugins.com/market/v1/plugins",
"description": "Paginated plugin list for client sync."
}
]
}
同步插件列表
GET /market/v1/plugins?page=1&pageSize=100
供客户端同步的完整目录——字段与 /api/v1/plugins 一致,固定按 star 数降序排列,不支持搜索和筛选。翻页直到凑齐 total 条即可。和目录的其他部分一样,数据来自静态快照,与 GitHub 之间存在自然延迟。
| 参数 | 取值 | 默认值 | 说明 |
|---|---|---|---|
page | 整数 ≥ 1 | 1 | |
pageSize | 整数 1–100 | 50 | 最大 100 |
精简后的响应示例:
{
"items": [
{
"id": "owner/repo",
"name": "repo",
"full_name": "owner/repo",
"url": "https://github.com/owner/repo",
"description": "An MCP server for DeepSeek Harness",
"category": "mcp",
"stars": 1234,
"pushed_at": "2026-08-10T14:22:00Z"
}
],
"total": 15360,
"page": 1,
"pageSize": 100,
"generatedAt": "2026-09-15T20:03:43.797Z"
}
两个接口的限流和缓存策略与 /api/v1/* 完全一致,见下文。
频率限制与使用约定
- 每个接口按 IP 限制每 2 秒一次请求;超限返回
429,并带上Retry-After响应头。 - 响应均可缓存(
Cache-Control: public, max-age=300)——请缓存结果,不要轮询。 - 目录是定期刷新的静态快照,数据与 GitHub 之间存在自然的延迟,属正常现象。
