DeepSeek Harness 插件 API — 免费 JSON 接口与 RSS 订阅
公开的只读 DeepSeek Harness(dsh)插件 API:用 JSON 查询完整插件目录、按 owner/repo 获取单个插件详情,或用 RSS 订阅最新插件。无需注册,无需 API Key。
最近更新: 2026-08-18
DeepSeek Harness 插件目录提供公开的只读 JSON API 和 RSS 订阅源——不需要账号,不需要 API Key。你可以用它来做插件选择器、徽章服务、趋势看板,或者干脆基于这些数据搭一个自己的目录站。
基础地址: https://deepseekharness.dev(和本站同一个域名)
所有响应都使用本站统一的包裹格式:
{ "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://deepseekharness.dev/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://deepseekharness.dev/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://deepseekharness.dev/plugins/feed.xml 丢进任意 RSS 阅读器,就能跟踪新收录的插件。订阅源缓存一小时,目录快照每次更新后重建。
频率限制与使用约定
- 每个接口按 IP 限制每 2 秒一次请求;超限返回
429,并带上Retry-After响应头。 - 响应均可缓存(
Cache-Control: public, max-age=300)——请缓存结果,不要轮询。 - 目录是定期刷新的静态快照,数据与 GitHub 之间存在自然的延迟,属正常现象。