gaokao-assistant

gaokao-cli

コマンドラインから中国の大学入学試験（高考）のデータを検索します。データソースは、教育部管轄の中国教育オンライン（中国教育在线）が運営する掌上高考（gaokao.cn）です。

前提条件

gaokao-cli が ~/.local/bin/gaokao-cli にインストールされている必要があります。WebBridge やブラウザーは不要です。すべてのデータは公開 CDN の JSON API から取得されます。

コマンド

1. 省を一覧表示

gaokao-cli provinces

ID とともに全31省を返します。他のコマンドでは、省名（例：北京）または ID（例：11）を使用します。

2. 合格ライン（省控线/批次线）

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

フラグ	短縮形	必須	説明
--province	-p	はい	省名または ID
--year	-y	いいえ	年（デフォルト：最新）
--type	-t	いいえ	综合/理科/文科/物理类/历史类

3. 得点分布表（一分一段表）

# 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

フラグ	短縮形	必須	説明
--province	-p	はい	省名または ID
--year	-y	いいえ	年（デフォルト：最新）
--type	-t	いいえ	综合/理科/文科/物理类/历史类
--level	-l	いいえ	本科/专科
--score	-s	いいえ	照会する特定の得点

主な機能： 各項目には appositive_fraction が含まれます。これは、同じ順位における過去の同等得点（同位分）で、年度をまたいだ比較に非常に役立ちます。

4. 学校検索（院校查询）

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

フラグ	短縮形	必須	説明
--name	-n	いいえ	あいまい検索による学校名検索
--province	-p	いいえ	省で絞り込み
--985		いいえ	985 大学のみ
--211		いいえ	211 大学のみ
--dual-class		いいえ	双一流大学のみ
--level	-l	いいえ	本科または专科

5. 入試区分改革の履歴（批次改革历史）

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

省ごとの入試区分の統合や、文理分科から新しい高考方式への移行時期を確認できます。過去の合格ラインを解釈するうえで欠かせない情報です。

出力形式

すべてのコマンドは JSON を標準出力に出力します。

• 成功：{"ok": true, "data": ...}
• エラー：{"ok": false, "error": {"code": "...", "message": "..."}}

データの対象範囲

• 中国本土の31省
• 合格ライン： 2014～2025年（省によって異なります）
• 一分一段表： 2016～2025年（省によって異なります）
• 学校： 985/211/双一流のタグを含む約2,957校

省ごとの科目区分

省によって科目の分類方法が異なります。

種類	説明	対象
综合	総合（3+3方式）	北京、天津、上海、浙江、山东、海南
物理类/历史类	物理・歴史コース（3+1+2方式）	广东、湖北、湖南、河北、福建、重庆、辽宁、江苏 + 2025年の新規追加省
理科/文科	従来の理系・文系	その他の省（改革の拡大に伴い減少中）

各省がいつ方式を切り替えたかは、batch-history で確認してください。