Plugin Data APIs
Machine-readable plugin data, split by concern — security certification, install certification, registry index and the trending boards. All static, cached and free to reuse with attribution. Built for AI agents and tooling.
# Fetch a plugin's security certification result curl https://www.dsh.so/artifact/@dsh-so/dsh-code-security.json # Install certification status (@author/plugin addressing) curl https://www.dsh.so/data/install/@dsh-so/dsh-plugin-finder.json # Registry index — retrieval feed (description / install / url / stars / npm downloads / risk / level) # canonical URL: served straight from the CDN (www.dsh.so/plugins-index.json now 404s — closed 2026-11-10) curl https://cdn.dsh.so/plugins-index.json # Same-day index delta — for clients that already cache the full index curl https://cdn.dsh.so/plugins-index.delta.json # Weekly npm download ranking curl https://cdn.dsh.so/data/npm-downloads.json # Star leaderboard (plugin / eco plugin / eco app boards) curl https://cdn.dsh.so/data/stars.json # DSH plugin market index (format 1) — add this URL in dsh Discover curl https://cdn.dsh.so/market/index.json

Custom plugin index sources
These two documents are what DSH itself reads. Paste either address into dsh → Plugins → Discover → Add index source — the URL below is the complete address, nothing to assemble, no key, no parameters. Add both if you want the full registry and the leaderboard cut side by side.
DSH.SO Install-Verified & Security-Audited Plugin MarketInstall-verified
The trust layer: only bundles whose install verification passed on the current dsh version and whose security verdict is confirmed low — critical, high, medium and unaudited entries, plus non-installable ones, are excluded. Categories are the site's ten use-case domains, labels carry install and risk state, and sort keys cover GitHub stars and weekly npm downloads.
https://cdn.dsh.so/market/index.jsonDSH.SO Curated Leaderboard Plugin MarketCurated
The leaderboard slice: the top 200 of each of the six installable-plugin boards (most starred, weekly star gain, npm total, npm weekly, most active, new arrivals), merged and de-duplicated. Categories are those six boards and every entry carries top-rank-* labels; medium and high-risk entries are still excluded.
https://cdn.dsh.so/market/top-rank.json01 APIs at a glance
Security Certification Data APIPer plugin
Security review record for a single plugin, in two layers: the static scan (verdict badge, finding counts by severity, findings, scanned commit / release binding) plus the model-driven dynamic security audit conclusion — when present it is authoritative (it can raise or lower the tier), otherwise the static scan tier (vet primary, dsh backstop) applies; the audit never writes an exemption.
https://cdn.dsh.so/artifact/@author/plugin.jsonDaily 01:10 BeijingAPI 02Install Certification Data APIPer plugin
Single-plugin install-verification query (L5 smoke preferred, L4 fallback): passed / failed / unknown / stale / untested with a verified flag and environment metadata.
https://cdn.dsh.so/data/install/@author/plugin.jsonPer verification runAPI 03Plugin Index Data APIRegistry-wide
Retrieval feed: every collected plugin with description, install command, url, stars, npm downloads (weekly, monthly and cumulative — official + npm mirror), topics, verification level and risk level — the lean projection most clients should pull.
https://cdn.dsh.so/plugins-index.jsonRebuilt on every deploy, together with a daily delta feed (/plugins-index.delta.json)API 04Plugin Record Data APIPer plugin
Canonical per-plugin fact sheet: verification per dsh version (L5-first), security summary, install, health and evidence pointers — one record for agent decision-making.
https://cdn.dsh.so/plugin/@author/plugin.jsonRebuilt on every deployAPI 05Star Leaderboard Data APIRegistry-wide
GitHub star leaderboard split by the three artifact classes — dsh plugins / eco plugins / eco apps — top 100 by stars each. The upstream harness itself is absent; the ecoPlugin board admits install-verified entries only.
https://cdn.dsh.so/data/stars.jsonRebuilt on deployAPI 06npm Downloads Data APIRegistry-wide
Weekly npm download ranking of DSH plugins (npm last-week window): the top-100 ranking behind the homepage board — rank, package, week downloads, cumulative total, stars.
https://cdn.dsh.so/data/npm-downloads.jsonDaily snapshotAPI 07Star Trend Board Data APIRegistry-wide
GitHub star riser ranking over a 1-week window: the top-100 plugins by star gain, with baseline and current star counts.
https://cdn.dsh.so/data/star-trend.jsonDaily snapshotAPI 08npm Popular Downloads Data APIRegistry-wide
All-time npm downloads popularity ranking: the top-100 plugins by cumulative downloads, with weekly downloads as context.
https://cdn.dsh.so/data/npm-popular.jsonDaily snapshot02 Endpoint explorer
{
"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" }
}{
"title": "SecurityScanRecord",
"type": "object",
"required": ["id", "badge", "counts", "scannedAt"],
"properties": {
"badge": { "badge.state": "passed | warn | fail | ..." },
"counts": { "critical": 0, "warning": 0, "info": 0 },
"findings": { "maxItems": 12, "items": "ruleId / severity / file / line" },
"dynamicAudit": { "null": "no audit record", "status": "completed | error", "combinedVerdict": "dynamic when conclusive, else static scan tier" },
"commitSha": "scanned revision binding",
"scannedAt": "date-time"
}
}03 Agent integrations
MCP server · @dsh-so/mcp
Structured tools for Claude Code / ZCode / Cursor: registry search, plugin records, security scans, install status and the boards. Zero-install via npx, no API key — the server just reads these static endpoints.
{
"mcpServers": {
"dsh-so": {
"command": "npx",
"args": [
"-y",
"@dsh-so/mcp"
]
}
}
}Agent skill · dsh-plugin-data
A SKILL.md that teaches any agent when and how to query the data — verify the security verdict and install-verified status before recommending a plugin. Works without MCP: it points the agent straight at these static endpoints.
# install into the cross-agent skills directory (~/.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 All endpoints
All data endpoints are served from the CDN (cdn.dsh.so, Cloudflare R2) since 2026-11-11 — every URL below is the canonical one. The old www.dsh.so paths still answer as 307 redirects to the same objects, so existing clients keep working; new code should call the CDN directly. No API key or registration is required. CORS: www.dsh.so adds Access-Control-Allow-Origin: *, while the CDN follows the bucket's rules and admits the https://www.dsh.so / https://dsh.so origins — curl, server-side code and any non-browser client are unaffected, but a browser fetch() from another origin needs a proxy.
05 Conventions
/artifact/@author/plugin.json (likewise /data/install/@author/plugin.json and /plugin/@author/plugin.json) — the @ author part is the plugin author's npm scope or GitHub username; the id inside every JSON stays the canonical slug. Bare-slug .json addresses are no longer issued.Cache-Control: public, max-age=3600 and cross-origin headers.utm_source marker, please keep it so we can track reuse traffic; each API page documents its update cadence.generatedAt / asOf / checkedAt). Directory, index and ad-supported sites may list individual records with attribution and a link back; for bulk exports and full mirrors, contact us first (see terms).Security scan data and install-test states are aggregated from public GitHub repositories and append-only verification records by the dsh.so pipelines. Sample responses above are excerpts; field shapes follow the live endpoints. Check changelog for additions.