mirror of https://github.com/jackwener/OpenCLI.git synced 2026-09-14 18:25:42 +08:00

Files

T

jakevin 55088bbb28 feat: 13 read adapters across 5 new sites + 4 extensions (round 3) (#1346 )

New sites (8 commands):
- npm    : search / package / downloads (registry.npmjs.org + api.npmjs.org)
- pypi   : package / downloads (pypi.org + pypistats.org)
- crates : search / crate (crates.io)
- mdn    : search (developer.mozilla.org)
- nvd    : cve (services.nvd.nist.gov)

Extensions (5 commands; +1 dblp/author surfaced in index):
- hf            : spaces (Hugging Face Spaces by likes / created_at / last_modified)
- dblp          : venue (search dblp's venue registry by acronym/topic)
- coingecko     : derivatives (perpetual / futures markets, 24h volume)
- stackoverflow : related (related questions for a given question id)

All commands hit public unauthenticated endpoints (Strategy.PUBLIC, browser:false),
typed-fail-fast on bad inputs (no silent fallback / clamp), and round-trip listing
ids into their detail commands where applicable.

Audits (all green vs baseline):
- typed-error-lint        : 196 = 196 baseline, no new
- silent-column-drop      : 103 = 103 baseline, no new
- listing-id-pairing      : 13 advisory (was 12; +1 = dblp/venue with no
                            corresponding venue-detail command)

Doc coverage : 120/120 adapter dirs documented (+5 new doc pages, +4 updated)
Manifest     : 722 entries (was 709; +13 commands)

Live verified:
- npm search react / npm package react / npm downloads react --period last-week
- npm downloads react --period 2025-01-01:2025-01-05
- pypi package requests / pypi downloads requests --period recent / overall
- crates search tokio / crates crate serde
- mdn search fetch
- nvd cve CVE-2021-44228
- hf spaces --limit 3
- dblp venue ICLR
- coingecko derivatives --limit 3
- stackoverflow related 79935770 --limit 3
- typed-error sanity: invalid CVE id, bad npm name, bad --period

2026-05-06 13:14:41 +08:00

1.6 KiB

Raw Permalink Blame History

MDN Web Docs

Mode: 🌐 Public · Domain: developer.mozilla.org

Search the official Mozilla Developer Network web docs without auth or browser. One command.

Commands

Command	Description
`opencli mdn search <query>`	Search MDN Web Docs by keyword

Usage Examples

# Web platform feature search
opencli mdn search fetch --limit 10
opencli mdn search flexbox --limit 5

# JS reference lookups
opencli mdn search "Array.prototype.map"

# Localized search (default: en-US)
opencli mdn search fetch --locale ja --limit 5
opencli mdn search fetch --locale zh-CN --limit 5

# JSON output
opencli mdn search fetch -f json

Output Columns

Command	Columns
`search`	`rank, title, slug, locale, summary, url`

The slug column round-trips into MDN's URL space (https://developer.mozilla.org/<locale>/docs/<slug>).

Options

Option	Description
`query` (positional)	Free-text query
`--limit`	Max results (1–50, default: 10)
`--locale`	Doc locale (default: `en-US`). Allowed: `en-US`, `de`, `es`, `fr`, `ja`, `ko`, `pt-BR`, `ru`, `zh-CN`, `zh-TW`.

Caveats

Only the locales MDN actually publishes are accepted; passing anything else raises ArgumentError.
The summary field is MDN's pre-computed search excerpt with whitespace collapsed; it is not the full document body.
MDN throttles aggressive bursts; HTTP 429 surfaces as a typed CommandExecutionError with a retry hint.

Prerequisites

No browser required — uses developer.mozilla.org/api/v1/search.

1.6 KiB Raw Permalink Blame History Unescape Escape