// Use when the user asks about 高考 (Chinese college entrance exam) data — score lines, one-score-one-rank tables, university info, or admission guidance. Invoke when user mentions "高考", "分数线", "一分一段", "志愿填报", "大学排名", "985", "211", or asks about college admission in China.
Use when the user wants to search academic papers, find literature, download PDFs, or export citations. Invoke when user mentions "论文", "文献", "paper", "research", "学术搜索", "BibTeX", "DOI", or asks to find/search/download academic papers from any source.
Use when the user wants to search for rental apartments, compare listings across platforms, or asks for help finding housing. Invoke when user mentions "租房", "找房", "房源", "rent", "apartment search", or asks to find housing in any supported region.
Use when the user wants to plan a trip, compare hotels/flights/attractions across platforms, or asks for travel recommendations. Invoke when user mentions "旅游攻略", "旅行规划", "travel planning", or asks to plan a trip to any destination.
| name | gaokao-assistant |
| description | Use when the user asks about 高考 (Chinese college entrance exam) data — score lines, one-score-one-rank tables, university info, or admission guidance. Invoke when user mentions "高考", "分数线", "一分一段", "志愿填报", "大学排名", "985", "211", or asks about college admission in China. |
Query Chinese college entrance exam (高考) data from the command line. Data source: 掌上高考 (gaokao.cn), operated by China Education Online (中国教育在线), under the Ministry of Education.
gaokao-cli must be installed at ~/.local/bin/gaokao-cli. No WebBridge or browser required — all data comes from public CDN JSON APIs.
gaokao-cli provinces
Returns all 31 provinces with IDs. Use province names (e.g. 北京) or IDs (e.g. 11) in other commands.
gaokao-cli score-line --province 北京
gaokao-cli score-line --province 北京 --year 2025
gaokao-cli score-line --province 河南 --year 2025 --type 物理类
| Flag | Short | Required | Description |
|---|---|---|---|
--province | -p | Yes | Province name or ID |
--year | -y | No | Year (default: latest) |
--type | -t | No | 综合/理科/文科/物理类/历史类 |
# 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
| Flag | Short | Required | Description |
|---|---|---|---|
--province | -p | Yes | Province name or ID |
--year | -y | No | Year (default: latest) |
--type | -t | No | 综合/理科/文科/物理类/历史类 |
--level | -l | No | 本科/专科 |
--score | -s | No | Specific score to lookup |
Key feature: Each entry includes appositive_fraction — equivalent scores in previous years for the same rank (同位分), invaluable for cross-year comparison.
gaokao-cli school --name 清华
gaokao-cli school --985
gaokao-cli school --211 --province 北京
gaokao-cli school --dual-class --province 上海
| Flag | Short | Required | Description |
|---|---|---|---|
--name | -n | No | Fuzzy name search |
--province | -p | No | Filter by province |
--985 | No | 985 universities only | |
--211 | No | 211 universities only | |
--dual-class | No | 双一流 universities only | |
--level | -l | No | 本科 or 专科 |
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.
All commands output JSON to stdout:
{"ok": true, "data": ...}{"ok": false, "error": {"code": "...", "message": "..."}}Different provinces use different subject classification:
| Type | Description | Used by |
|---|---|---|
| 综合 | Comprehensive (3+3 model) | 北京, 天津, 上海, 浙江, 山东, 海南 |
| 物理类/历史类 | Physics/History track (3+1+2 model) | 广东, 湖北, 湖南, 河北, 福建, 重庆, 辽宁, 江苏 + 2025新增 |
| 理科/文科 | Traditional Science/Arts | Remaining provinces (shrinking as reform spreads) |
Use batch-history to check when a province switched models.