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.

8 APIs17 EndpointsCC BY 4.0No API KeyCORS enabled1h CDN cacheMCP + Skill
Quick start
# 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
WeChat QR: data API discussions and update notices
Data APIs · WeChatScan to connect — Q&A and update noticesPlease note "dsh.so" in your request
INDEX SOURCES · format 1

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.

SOURCE 1 · MARKET

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.json
Rebuilt on every deploy · dsh caches it for 10 minutes · field reference →
SOURCE 2 · LEADERBOARD CUT

DSH.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.json
Rebuilt on every deploy · the six boards → · field reference →

01 APIs at a glance

API 01

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 Beijing
API 02

Install 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 run
API 03

Plugin 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 04

Plugin 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 deploy
API 05

Star 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 deploy
API 06

npm 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 snapshot
API 07

Star 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 snapshot
API 08

npm 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 snapshot

02 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" }
}

03 Agent integrations

MCP

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.

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

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.

endpoint tablefield semanticsdecision rulesCC BY 4.0
install skill
# 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

URLAPIDescription
https://cdn.dsh.so/data/security-scan.schema.jsonSecurityJSON Schema for the per-plugin scan-record format
https://cdn.dsh.so/artifact/@author/plugin.jsonSecurityPer-plugin JSON — scan badge + counts + findings + version binding
https://cdn.dsh.so/data/install/@author/plugin.jsonInstallSingle-plugin install-verification result (L5-preferring, L4 fallback)
https://cdn.dsh.so/plugins-index.jsonIndexRetrieval feed — description, install, url, stars, npm downloads (weekly, monthly, cumulative — official + mirror), topics, risk level, verification level (projection of the full feed). Canonical URL: https://cdn.dsh.so/plugins-index.json (bytes straight from the CDN; the www.dsh.so path was closed on 2026-11-10 and now 404s)
/plugins-index.delta.jsonIndexSame-day delta feed — entries added or updated since the previously published full index, the removed ids, and the "since" identity (generatedAt + count). Published in the same batch as the full feed; apply only when your cached copy matches "since", otherwise re-download the full index. Canonical URL: https://cdn.dsh.so/plugins-index.delta.json
https://cdn.dsh.so/plugin/@author/plugin.jsonRecordCanonical per-plugin fact sheet — verification, security, health, evidence. Served from the CDN since 2026-11-11; the www.dsh.so path is a 307 compatibility layer
https://cdn.dsh.so/data/plugin-record.schema.jsonRecordJSON Schema for the plugin record endpoint
https://cdn.dsh.so/data/install.schema.jsonInstallJSON Schema for the install endpoint
https://cdn.dsh.so/data/stars.jsonStar LeaderboardGitHub star leaderboard — plugin / eco plugin / eco app boards, top 100 each
https://cdn.dsh.so/data/stars.schema.jsonStar LeaderboardJSON Schema for the star leaderboard feed
https://cdn.dsh.so/data/npm-downloads.jsonnpm DownloadsTop-100 weekly npm download ranking — the homepage board as a feed
https://cdn.dsh.so/data/npm-downloads.schema.jsonnpm DownloadsJSON Schema for the npm downloads feed
https://cdn.dsh.so/data/star-trend.jsonStar Trend BoardTop-100 GitHub star gainers over a 1-week window
https://cdn.dsh.so/data/star-trend.schema.jsonStar Trend BoardJSON Schema for the star trend feed
https://cdn.dsh.so/data/npm-popular.jsonnpm DownloadsTop-100 all-time npm downloads popularity ranking
https://cdn.dsh.so/data/npm-popular.schema.jsonnpm DownloadsJSON Schema for the npm popularity feed
/market/index.jsonPlugin MarketDSH.SO install-verified & security-audited plugin market (format 1) — add the URL in dsh Discover
/market/top-rank.jsonPlugin MarketDSH.SO curated leaderboard plugin market — usually 1,200 entries (200 per board), repeats not dropped

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

One way to address. Single-plugin endpoints are addressed only as /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.
Static & cached. Prerendered JSON with Cache-Control: public, max-age=3600 and cross-origin headers.
Append-only fields. Existing fields are never removed or renamed; new fields ship with a schema update.
Provenance-bearing. Records quote their source verbatim — no invented defaults (honesty principle).
Attribution. Free to reuse with attribution to dsh.so — the link embeds a utm_source marker, please keep it so we can track reuse traffic; each API page documents its update cadence.
License. All feeds are CC BY 4.0 — redistribution must preserve freshness markers (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).
Disputes. Plugin authors can contest a scan result — see Dispute a scan result.

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.

Was this page helpful?