kokkai

国会会議録検索システム(国立国会図書館)の公式APIで、国会の全会議録・全発言を検索するスキル。第1回国会(1947年)から最新までカバーし、APIキー・ログイン・ユーザー登録は一切不要。

実測日: 2026-10-01。以下のURL・構造・件数はすべて当日の実測で確認。

エンドポイント(3つ、使い分けが本質)

モード	URL	返るもの	最大件数
発言単位	https://kokkai.ndl.go.jp/api/speech	ヒットした発言の本文+会議情報	100
会議単位	https://kokkai.ndl.go.jp/api/meeting	会議録+全発言の本文	10
会議一覧	https://kokkai.ndl.go.jp/api/meeting_list	会議の情報のみ(軽量)	100

既定はXML。recordPacking=json を必ず付ける。件数未指定だとspeech/listは30件、meetingは3件。

使い方(ヘルパー)

python3 kokkai/lookup.py --any 憲法 --max 3                 # 発言検索
python3 kokkai/lookup.py --speaker 山田 --house 参議院       # 発言者+院
python3 kokkai/lookup.py --meeting 本会議 --mode list        # 会議一覧
python3 kokkai/lookup.py --any 科学技術 --mode meeting --max 1  # 会議+全発言
python3 kokkai/lookup.py --any 防災 --from-date 2026-01-01 --until-date 2026-03-31

実測で確認したこと (2026-10-01)

• any=国会: 608,479発言。any=憲法: 184,057。any=消費税: 62,548(うち参議院 26,928)。
• 最古は第1回国会(1947年)。最新の本会議は2026-07-24(第221回)、委員会を含む最新発言は2026-08-26。収録には約1か月のラグがある。
• 本会議だけで8,886会議。宮沢賢治が国会で言及された発言は69件。
• speaker=山田 は部分一致で50,286件(山田吉彦ほか)。姓名フルネームで渡すのが安全。

実測で確認した罠

1. 3エンドポイントの最大件数が違う。 speech/listは100、meetingは10。maximumRecords=101 を渡すと HTTP 400 で {"message":"(19011)検索条件の入力に誤りがあります。","details":["...maximumRecordsには1～100の値を指定してください。"]} が返る(2026-10-01実測)。エラーは日本語で具体的。
2. any はスペース区切りでAND、nameOfMeeting はスペース区切りでOR。 逆なので注意(実測: any=北海道 青森 → 両方を含む発言3,867件(2026-10-05再実測。「北海道」単独115,795件・「青森」単独18,908件より少ないのでAND)、nameOfMeeting=文部 文教 → どちらかを含む会議)。
3. any の検索対象は発言本文だけ。 会議名・発言者は別パラメータ(nameOfMeeting / speaker)。
4. 既定はXML。 recordPacking=json を忘れるとXMLが返る。
5. speechIDに日付と回次が埋まっている。 121704080X00920250411_169 = 第121回・2025-04-11。発言を一意に参照するIDとして使える。
6. 掲載ラグ約1か月。 「昨日の国会で何が言われたか」はまだ取れないことが多い。最新日を確認してから答える。

失敗時の対応

• 0件: キーワードの表記(漢字/かな)を変える。発言は話し言葉なので「熱中症」より「暑さ」に多い、ということがある。日付範囲を広げる。
• HTTP 400: detailsに理由が書いてある(maximumRecordsの範囲、日付形式など)。そのまま直す。
• 結果が古い: 収録ラグ(約1か月)。until を指定せず最新日を確認し、「2026-08-26時点の収録では」と時点つきで答える。

English summary

Searches Japan's National Diet proceedings via the official Kokkai (National Diet Library) API — no API key or login. Covers all sessions from the 1st Diet (1947) to the present, with three endpoints: speech-level search (full-text, max 100), meeting-level (returns every speech in the meeting, max 10), and meeting list (lightweight metadata, max 100). Filters: full-text keyword (space-separated AND), speaker (partial match), meeting name (space-separated OR), house, date range, session number. Always pass recordPacking=json — XML is the default. Traps: per-endpoint record caps (over-limit returns HTTP 400 with a Japanese error message), any vs nameOfMeeting use opposite space semantics, and new proceedings appear with roughly a one-month lag (latest record 2026-08-26 as of 2026-10-01). Measured live on 2026-10-01.