插件数据接口

机器可读的插件数据,按关注点分开——安全认证、安装认证、注册表索引与下载 / 星标榜单。全部为静态、缓存、可免费引用(需署名)的数据,专为 AI Agent 与工具而建。

8 个接口17 个端点CC BY 4.0免密钥CORS 全开1h CDN 缓存MCP + Skill
快速开始
# 单插件安全认证结果(@作者/插件名 寻址)
curl https://www.dsh.so/artifact/@dsh-so/dsh-code-security.json

# 安装认证状态(@作者/插件名 寻址)
curl https://www.dsh.so/data/install/@dsh-so/dsh-plugin-finder.json

# 注册表索引——检索 feed(简介 / 安装命令 / url / 星标 / npm 下载量 / 风险 / 等级)
# 规范地址:字节由 CDN 直出(www.dsh.so/plugins-index.json 已于 2026-11-10 关闭,现在回 404)
curl https://cdn.dsh.so/plugins-index.json

# 当日增量——已经缓存全量的调用方每天只拉这份
curl https://cdn.dsh.so/plugins-index.delta.json

# npm 周下载榜
curl https://cdn.dsh.so/data/npm-downloads.json

# 星标榜(插件 / 生态插件 / 生态应用三榜)
curl https://cdn.dsh.so/data/stars.json

# DSH 插件市场索引(format 1)——在 dsh「发现」页添加该 URL
curl https://cdn.dsh.so/market/index.json
微信二维码:数据接口技术交流与更新通知
数据接口 · 技术交流扫码加微信,接口更新同步通知添加请备注「dsh.so数据接口」
索引源 · format 1

自定义插件索引源

这两份文档就是 DSH 自己读取的插件市场。把下面的地址粘进 dsh →「插件」→「发现」→「添加索引源」即可—— 下面是完整地址,不用拼装、不需要密钥、没有参数。全量市场与精选榜单可以同时添加。

索引源 1 · 市场

DSH.SO安装验证与安全审计插件市场安装已验证

可信层:只收「当前 dsh 版本安装验证通过」且安全档确认为低风险的组合包;critical / medium / 未审计与装不上的条目一律排除。 分类取站内十个场景域,标签只带安装与风险状态,排序键覆盖 GitHub 星标与 npm 周下载量。

https://cdn.dsh.so/market/index.json
每次部署重建 · dsh 侧缓存 10 分钟 · 字段说明 →
索引源 2 · 榜单精选

DSH.SO精选榜单插件市场精选

榜单切片:把六张可安装插件榜(Star 总榜、Star 周榜、Npm 总榜、Npm 周榜、活跃榜、新上架榜)各取前 200 名, 合并去重。分类就是这六张榜,每条带 top-rank-* 榜标记;中 / 高风险条目同样被排除。

https://cdn.dsh.so/market/top-rank.json
每次部署重建 · 六张榜单 → · 字段说明 →

01 接口一览

接口 01

安全认证数据接口单插件

单插件的安全审查记录,分两层:静态扫描(结论徽标、按严重度的 finding 计数、逐条 findings、扫描时的 commit / release 版本绑定),以及模型驱动的动态安全审计结论——有结论时以它为准(可上调也可下调),无结论时取静态扫描档(vet 主判 + dsh 兜底);动态审计脚本永不写豁免表。

https://cdn.dsh.so/artifact/@作者/插件名.json每日 01:10(北京)
接口 02

安装认证数据接口单插件

单插件安装验证等级查询(L5 冒烟优先、退回 L4 沙盒安装):passed / failed / unknown / stale / untested 五态,含 verified 标记与运行环境元数据。

https://cdn.dsh.so/data/install/@作者/插件名.json随验证批次
接口 03

插件索引数据接口全量

检索 feed:全部收录插件的简介、安装命令、url、星标、npm 下载量(周 / 月 / 累计,官方 + 镜像)、话题、验证等级与风险等级——大多数调用方应该拉这份瘦身投影。

https://cdn.dsh.so/plugins-index.json随部署重建;同时发布当日增量 feed(/plugins-index.delta.json)
接口 04

插件记录数据接口单插件

单插件规范事实表:按 dsh 版本的验证(L5 优先)、安全概要、安装、健康与证据指针——Agent 决策取一份即可。

https://cdn.dsh.so/plugin/@作者/插件名.json随部署重建
接口 05

星标榜数据接口全量

GitHub 星标总榜,按工件三分类分榜:dsh 插件 / 生态插件 / 生态应用,各取星数前 100 名。上游本体不上榜;生态插件榜只收 L4 实测装得上的条目。

https://cdn.dsh.so/data/stars.json随部署重建
接口 06

npm 下载榜数据接口全量

DSH 插件的 npm 周下载排名(npm last-week 窗口):首页「本周 npm 下载」榜单同一口径的前 100 名——名次、npm 包名、周下载量、累计下载与星数。

https://cdn.dsh.so/data/npm-downloads.json每日快照
接口 07

星标飙升榜数据接口全量

DSH 插件的 GitHub 星标 1 周飙升榜:星标增量前 100 名,含基线与当前星数。

https://cdn.dsh.so/data/star-trend.json每日快照
接口 08

npm热榜数据接口全量

npm热榜:DSH 插件的 npm 累计下载前 100 名,附本周下载量对照。

https://cdn.dsh.so/data/npm-popular.json每日快照

02 端点探索器

{
  "id": "dsh-code-security-3",
  "badge": { "state": "passed", "level": "passed", "detailUrl": "https://www.dsh.so/artifact/dsh-code-security-3/" },
  "commitSha": "ec266465d104202e8fc07f7d8faeeb15760aef07",
  "latestCommitSha": "ec266465d104202e8fc07f7d8faeeb15760aef07",
  "pkgVersion": "0.2.2",
  "pkgDsh": true,
  "latestReleaseTag": null,
  "counts": { "critical": 0, "warning": 0, "info": 0 },
  "criticalByCategory": {},
  "filesScanned": 15,
  "scannedAt": "2026-09-21T20:04:36.213Z",
  "scannerVersion": "dsh-static:73b7d4a8",
  "rulesChecked": 31,
  "dynamicAudit": null,
  "findings": [],
  "plugin": { "name": "dsh-code-security", "repository": "https://github.com/dsh-so/dsh-code-security" },
  "license": { "spdx": "CC-BY-4.0", "attribution": "dsh.so" }
}

03 Agent 接入

MCP

MCP 服务器 · @dsh-so/mcp

给 Claude Code / ZCode / Cursor 的结构化工具:注册表搜索、插件记录、安全扫描、安装状态与两大榜单。npx 免安装、免密钥——服务器只是读取这些静态端点。

search_pluginsget_plugin_recordget_security_scanget_install_statusget_npm_downloadsget_star_trenddata_freshness
mcp 配置
{
  "mcpServers": {
    "dsh-so": {
      "command": "npx",
      "args": [
        "-y",
        "@dsh-so/mcp"
      ]
    }
  }
}
SKILL

Agent Skill · dsh-plugin-data

一份教 Agent 何时、如何取数的 SKILL.md——推荐插件前先核验安全结论与安装实测状态。不配 MCP 也能用:skill 会指引 Agent 直接请求这些静态端点。

端点速查表字段语义决策规则CC BY 4.0
安装 skill
# 安装到跨 Agent 通用的 skills 目录(~/.agents/skills)
mkdir -p ~/.agents/skills/dsh-plugin-data
curl https://www.dsh.so/skills/dsh-plugin-data/SKILL.md \
  -o ~/.agents/skills/dsh-plugin-data/SKILL.md

04 全部端点

URL接口说明
https://cdn.dsh.so/data/security-scan.schema.json安全扫描记录格式对应的 JSON Schema
https://cdn.dsh.so/artifact/@作者/插件名.json安全单插件 JSON——扫描徽标 + 计数 + findings + 版本绑定
https://cdn.dsh.so/data/install/@作者/插件名.json安装单插件安装验证结果(L5 优先,含 L4 回退)
https://cdn.dsh.so/plugins-index.json索引检索 feed——简介、安装命令、url、星标、npm 下载量(周 / 月 / 累计,官方 + 镜像)、话题、风险等级、验证等级(全量 feed 的投影)。规范地址:https://cdn.dsh.so/plugins-index.json(字节由 CDN 直出;www 路径已于 2026-11-10 关闭,现在回 404)
/plugins-index.delta.json索引当日增量 feed——相对上一份已发布全量新增/更新的条目、被移除的 id,以及基线身份(generatedAt + count)。与全量同批发布;只有本地缓存与 since 对得上时才应用,否则重下全量。规范地址:https://cdn.dsh.so/plugins-index.delta.json
https://cdn.dsh.so/plugin/@作者/插件名.json记录单插件规范事实表——按版本验证、安全概要、健康、证据。2026-11-11 起由 CDN 直出;www.dsh.so 上那条是 307 兼容层
https://cdn.dsh.so/data/plugin-record.schema.json记录插件记录接口对应的 JSON Schema
https://cdn.dsh.so/data/install.schema.json安装安装接口对应的 JSON Schema
https://cdn.dsh.so/data/stars.json星标榜GitHub 星标总榜——插件 / 生态插件 / 生态应用三榜,各前 100 名
https://cdn.dsh.so/data/stars.schema.json星标榜星标榜接口对应的 JSON Schema
https://cdn.dsh.so/data/npm-downloads.jsonnpm 下载榜npm 周下载前 100 名——首页榜单的数据源
https://cdn.dsh.so/data/npm-downloads.schema.jsonnpm 下载榜npm 下载榜接口对应的 JSON Schema
https://cdn.dsh.so/data/star-trend.json星标飙升榜GitHub 星标 1 周飙升前 100 名
https://cdn.dsh.so/data/star-trend.schema.json星标飙升榜星标飙升接口对应的 JSON Schema
https://cdn.dsh.so/data/npm-popular.jsonnpm热榜npm 累计下载热门前 100 名
https://cdn.dsh.so/data/npm-popular.schema.jsonnpm热榜npm热榜接口对应的 JSON Schema
/market/index.json插件市场DSH.SO 安装验证与安全审计插件市场(format 1)——在 dsh「发现」页添加该 URL
/market/top-rank.json插件市场DSH.SO 精选榜单插件市场——通常 1,200 条(每榜 200 条),重复不折叠

全部数据接口自 2026-11-11 起由 CDN 直出(cdn.dsh.so,Cloudflare R2)——下面每一条 URL 都是规范地址。老的 www.dsh.so 路径仍以 307 指到同一批对象,存量客户端不会断;新代码请直接打 CDN。无需 API Key 或注册。跨域:www.dsh.so 会加 Access-Control-Allow-Origin: *,而 CDN 按桶的规则只放行 https://www.dsh.so / https://dsh.so 两个来源——curl、服务端代码与非浏览器客户端不受影响,其他来源的网页用 fetch() 直连需要代理。

05 公共约定

@ 寻址。单插件端点一律按 /artifact/@作者/插件名.json 寻址(/data/install/@作者/插件名.json、/plugin/@作者/插件名.json 同理)——作者位取插件作者的 npm scope 或 GitHub 用户名;JSON 内 id 恒为规范 slug,裸 slug 的 .json 地址不再产出。
静态 & 缓存。全部为预渲染 JSON,带 Cache-Control: public, max-age=3600 与跨域头。
字段只增不删。既有字段不会移除或改名;新增字段会同步更新 schema。
保留出处。每条记录只引用其来源记录 / 环境原值——绝不编造默认值(诚实原则)。
注明来源。可免费引用,需注明来源 dsh.so——链接已内嵌 utm_source 来源标记,引用时请保留,便于我们统计引用来路;各自的更新频率见各接口页。
许可协议。全部数据为 CC BY 4.0——再分发必须保留新鲜度标记(generatedAt / asOf / checkedAt)。目录站、导航站与带广告的页面可收录单条记录,需注明来源并链接回详情页;批量导出与全量镜像请先联系我们(见服务条款)。
申诉通道。插件作者可对扫描结果提出申诉——见申诉扫描结果。

安全扫描数据与安装实测状态由 dsh.so 流水线从公开 GitHub 仓库与只追加验证记录聚合。上方示例响应均为节选,字段结构与线上端点一致。新增字段见更新日志。

这页有帮助吗?