コードで語るマニフェスト：自治体データの機械可読化と実装ロードマップ

どうも〜おかむーです！今日はちょっとエンジニアっぽい話をしますよ〜

• 지방정부 데이터는 흩어져 있고 형식도 제각각이다 — 통합 표준화가 필요하다!
• API와 머신리더블 포맷이 핵심이다 — PDF에 갇힌 데이터는 재활용 불가능하다!
• 실무 관점의 개선안: 표준 데이터 모델, OpenAPI, CSV/JSON-LD 배포, CI로 품질 보증

結論

지방자치단체와 중앙정부가 선언한 표준화 정책(総務省・デジタル庁 등)은 방향성이 맞다. 하지만 현실은 PDF·HTML 테이블·폐쇄형 포털 혼재로, 엔지니어·시빅해커가 바로 활용하기엔 역부족이다. 기술적으로는 표준 데이터모델 + API 카탈로그 + 머신리더블 우선 배포로 빠르게 개선 가능하다.

レポート本文

現状観察 — これ見てくださいよ

• e-Gov의 行政APIカタログやe-Stat Dashboard는 좋은 출발점이다(参照: api-catalog.e-gov.go.jp, dashboard.e-stat.go.jp)。
• 一方で、地方のサイト（例: keiba.go.jp のような運営系サイト）はHTML中心、CSV/JSONでの一次提供が少ない。

要するに、データは「存在するけど活用できない」状況なんです。

技術的課題

フォーマットの断片化: PDFに埋められた表、HTML table、独自CSV、API未提供。

スキーマ不在: 列名やコード体系が自治体ごとに違う。結合が難しい。

発見可能性: 中央のカタログと地方の実データが同期していない。

APIの有無と品質評価

• e-Govの行政APIは存在するが、地方側のAPI普及は遅い。
• 標準準拠システムへ移行する動き（総務省のPMOツール）あるが、標準データモデルとAPI仕様の公開・普及が鍵。

実践的なコード例

エンジニア的に言うと、API一本で解決する話なんですよね。これ見てくださいよ、e-Statを叩いてDataFrameにする例（Python）:

import requests
import pandas as pd

url = 'https://api.e-stat.go.jp/rest/3.0/app/getSimpleStatsData'
params = {
'appId': 'YOUR_API_KEY',
'statsDataId': '0003412310',
'download': 'CSV'
}
resp = requests.get(url, params=params)
open('stats.csv','wb').write(resp.content)
df = pd.read_csv('stats.csv')
print(df.head())

PDFしかない場合はTabulaやCamelotで抽出→スキーマを当てるのが現実解。要するに自動化パイプラインを作れば再現性が上がるということです。

政策目標と実績のギャップ分析

• 総務省・デジタル庁は「標準化・共通化」を掲げているが、実務では自治体ごとのレガシーと予算制約で進行スピードにムラがある。
• 例えば、標準化PMOツールで進捗報告はできても、実際のデータ品質（メタデータ、スキーマ整備）は追いついていないケースが多い。

改善提案（具体的に）

中央での“OpenAPI-first”テンプレート提供

- OpenAPI specを地方向けテンプレ化し、認証やレート制限の推奨設定を標準化。

データモデルと共通ボキャブラリの公開

- 総務省の標準データ規格を具体例（住民基本情報・予算・施策実績）で提供。

データ変換CIパイプライン

- PDF→CSV/JSONの変換処理をGitHub Actionsで自動実行、スキーマ検証を実施。

メタデータカタログの集中管理

- e-GovのAPIカタログと連携する地方向けポータルを用意。

実装例の提供

- サンプルコード、Dockerイメージ、OpenAPIモックサーバを配布。

サンプルOpenAPI（超簡略）:

openapi: 3.0.1
info:
title: municipality-budget-api
version: '1.0'
paths:
/budgets:
get:
summary: list budgets
responses:
'200':
description: JSON array

オープンデータ利活用の提案

• 民間アプリやAIモデルと連携して政策評価を自動化できる。例えば、施策ごとの投入額とKPIを結びつけて可視化するダッシュボードを自治体向けにテンプレ化すれば地方創生に直結する。

まとめ

• 方向性はOK、課題は運用と形式統一。PDFやバラバラなHTMLが最大の足かせ。
• 技術的にはOpenAPI + JSON/CSV + CI + メタデータカタログで大半は解決できる。
• 最重要は“使える形で公開すること”です。エンジニア的に言うと、API一本で行政データの未来が変わります！

おかむーから一言

テクノロジーで社会をアップデートするのは本気で可能です。まずは小さくAPIを一本作ってみよう、そこから全部変わりますよ！