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

Files

T

jakevin 39943c05e9 feat: 12 read adapters across 6 new sites + contract tests (round 7) (#1350 )

* feat: 12 read adapters across 6 new sites + contract tests (round 7)

New sites: wikidata, lichess, rest-countries, nuget, flathub, oeis
- wikidata: search (wbsearchentities) + entity (Special:EntityData) — Q/P/L ids,
  localised label/description with English fallback
- lichess: user + top (perf rankings) — closed accounts → EmptyResultError, no
  silent disabled rows; 13 perf types validated
- rest-countries: country (substring) + region — population-sorted by default,
  flattened languages/currencies/capitals
- nuget: search + package (full version history) — registration page-walking
  for 100+ version histories; case-insensitive id with strict shape gate
- flathub: search + app — appId reverse-DNS, dual-shape timestamp coercion
  (search is unix-seconds int, /appstream is ISO string)
- oeis: search (paginated) + sequence — A-id zero-padded, 12-term preview with
  (+N) suffix, surfaces commentCount/formulaCount/etc instead of full graphs

Contract tests: 6 files × 7 assertions = 42 contract assertions, all green.
Live verified all 12 commands against real APIs.

Audits clean: typed-error 196=baseline, silent-column 103=baseline, 0 Round-7
listing-id-pairing violations (all 6 listings carry round-trip ids).

* fix(nuget): fail fast on malformed registration pages

2026-05-06 16:54:21 +08:00

3.2 KiB

Raw Permalink Blame History

Wikidata

Mode: 🌐 Public · Domain: www.wikidata.org

Search Wikidata items by keyword and fetch full entity detail by Q/P/L identifier. Wikidata is the canonical structured-data registry behind Wikipedia, with ~110M entities and a global property graph.

Commands

Command	Description
`opencli wikidata search <query>`	Search Wikidata items by label / alias (returns Q-IDs)
`opencli wikidata entity <id>`	Full entity detail: label, description, aliases, claim & sitelink counts

Usage Examples

# Find Q-IDs by keyword
opencli wikidata search einstein
opencli wikidata search "san francisco" --limit 10
opencli wikidata search 哈尔滨 --language zh

# Entity detail (Q-IDs round-trip from search)
opencli wikidata entity Q937           # Albert Einstein
opencli wikidata entity Q90            # Paris
opencli wikidata entity Q937 --language zh

Output Columns

Command	Columns
`search`	`rank, qid, label, description, matchType, matchText, url`
`entity`	`qid, type, label, description, aliases, claimPropertyCount, sitelinkCount, enwikiTitle, modified, url`

The qid column round-trips between commands.

Options

`search`

Option	Description
`query` (positional)	Search keyword (matches labels and aliases)
`--language`	Search & display language (ISO 639, default: `en`). Examples: `en`, `fr`, `zh`, `zh-hans`.
`--limit`	Max items (1–50, default: 20)

`entity`

Option	Description
`id` (positional)	Entity id: `Q<digits>` (item), `P<digits>` (property), `L<digits>` (lexeme). Full URLs (`https://www.wikidata.org/wiki/Q937`) are stripped.
`--language`	Display language (ISO 639, default: `en`). Falls back to English when missing.

Notes

Label / description / aliases fall back to English when the requested language is missing — Wikidata stores localisations independently per field, so a Chinese-only article may have an English label but no Chinese description, and we surface what's available rather than emitting null row-by-row.
claimPropertyCount ≠ claim count. It counts the number of distinct properties (P-IDs) on the entity. Some properties have many statements (e.g. P31 may have multiple "instance of" claims); we don't sum them. Useful as a rough indicator of how rich the entity is.
sitelinkCount is the number of language Wikipedias linking to this entity. High values (300+) indicate broadly-known concepts.
enwikiTitle is the corresponding English Wikipedia article title, if any. null for entities not linked to enwiki (Q-IDs that exist only as Wikidata structured data).
matchType (search only) is one of label, alias, description, indicating how the keyword matched. alias matches are common for famous entities (e.g. searching "Einstein" matches Q937 via alias, not label).
No API key required. Wikidata throttles anonymous traffic at ~5000 req/hour; bursts → CommandExecutionError.
Errors. Bad Q-ID shape / bad language code / bad limit → ArgumentError; unknown id → EmptyResultError; transport / 429 / non-200 → CommandExecutionError.

3.2 KiB Raw Permalink Blame History Unescape Escape