gaokao-cli

Query Chinese college entrance exam (高考) data from the command line. Data source: 掌上高考 (gaokao.cn), operated by China Education Online (中国教育在线), under the Ministry of Education.

Prerequisites

gaokao-cli must be installed at ~/.local/bin/gaokao-cli. No WebBridge or browser required — all data comes from public CDN JSON APIs.

Commands

1. List provinces

gaokao-cli provinces

Returns all 31 provinces with IDs. Use province names (e.g. 北京) or IDs (e.g. 11) in other commands.

2. Score lines (省控线/批次线)

gaokao-cli score-line --province 北京
gaokao-cli score-line --province 北京 --year 2025
gaokao-cli score-line --province 河南 --year 2025 --type 物理类

3. Score section (一分一段表)

# Full table
gaokao-cli score-section --province 北京 --year 2025

# Lookup specific score — returns rank, count, and 同位分 (equivalent scores in prior years)
gaokao-cli score-section --province 天津 --year 2025 --score 650

# Old gaokao provinces with 文理分科
gaokao-cli score-section --province 河南 --year 2024 --type 理科 --score 600

Key feature: Each entry includes appositive_fraction — equivalent scores in previous years for the same rank (同位分), invaluable for cross-year comparison.

4. School search (院校查询)

gaokao-cli school --name 清华
gaokao-cli school --985
gaokao-cli school --211 --province 北京
gaokao-cli school --dual-class --province 上海

5. Batch reform history (批次改革历史)

gaokao-cli batch-history --province 北京
gaokao-cli batch-history   # all provinces

Shows when provinces merged batches or switched from 文理分科 to new gaokao model. Essential context for interpreting historical score lines.

Output format

All commands output JSON to stdout:

• Success: {"ok": true, "data": ...}
• Error: {"ok": false, "error": {"code": "...", "message": "..."}}

Data coverage

• 31 provinces across mainland China
• Score lines: 2014–2025 (varies by province)
• 一分一段表: 2016–2025 (varies by province)
• Schools: ~2,957 institutions including 985/211/双一流 tags

Province subject types

Different provinces use different subject classification:

Use batch-history to check when a province switched models.