e-Stat人口データの公開APIをClaude Codeで作った — DuckDB→SQLite二層の設計判断

• URL: https://zenn.dev/saneyuki_rokaru/articles/estat-population-api-design
• 日付: 2026-06-20
• Tier: Tier 3
• 要旨: 政府統計API(e-Stat)から人口データをDuckDB→SQLiteの二層で集計し、REST API公開。YAML駆動分析テーブル、基準年違いのシリーズ統合、国勢調査欠落を補間補正人口で埋める。FastAPI(開発)とPHP(本番)二重実装。

詳細

データ素性が悪い(年飛ぶ・同ID毎年変化・自治体二重計上)の対策。config/analyses/*.yamlで宣言的にDuckDB集計SQL+テーブル定義。analyze.py→publisher.pyで一方向パイプ化。YAML同一シリーズのTITLEマッチ統合、cat04次元取りこぼしによる黙ったデータロス検出。政令市行政区二重計上を市区町村分類で分離、SUM=全国人口テストで担保。