Code-Driven Manifesto: Auditing Japan's Public Data & Local Government Systems

どうも〜おかむーです! Hi, I'm Okamu — today we're going to nerd out about how Japanese government and municipal data actually ship, and what we can do as engineers to make them way more useful!
- Japan has pockets of machine-readable data (CSV/APIs) but many important gov pages still embed stats in PDFs or heterogeneous CSVs.
- The central push for local-government system standardization exists (Digital Agency / Soumu), but practical interoperability gaps remain.
- With modest engineering fixes (APIs, OpenAPI, unified schemas, CI for datasets) municipalities can unlock huge civic value.
結論
Digital policy intentions are good — Digital Agency's Japan Dashboard and Soumu's standardization effort are steps forward (see https://www.digital.go.jp/resources/japandashboard and https://www.soumu.go.jp/...) — but the current state mixes high-quality APIs (e-Stat) and ad-hoc CSV/PDF practices (various ministries and municipal sites). 要するに、政策はあるけどデータパイプラインがバラバラで、実装(code)が足りないということです。
Report
What I checked (sources)
- National dashboards & stats: e-Stat dashboard (https://dashboard.e-stat.go.jp/), Japan Dashboard (https://www.digital.go.jp/resources/japandashboard)
- Policy pages on standardization: Digital Agency local_governments (https://www.digital.go.jp/policies/local_governments) and Soumu system standardization (https://www.soumu.go.jp/...)
- Example datasets / CSV endpoints spotted in search results: NICTER notice CSV (https://notice.go.jp/docs/status_nicter.csv), ministry CSVs (e.g. https://www.mhlw.go.jp/content/001429362.csv), env CSVs.
- Service examples: keiba.go.jp (https://www.keiba.go.jp/) — public-facing but mostly HTML content and media.
これ見てくださいよ: some endpoints are perfectly machine-readable CSVs you can curl; others provide only dashboards or PDFs. That inconsistency kills automation.
Technical gaps
- Inconsistent formats: CSVs with different encodings, date formats, column names, and missing metadata (no schema). 要するに、normalizationが必要です。
- No uniform API gateway for municipalities: Digital Agency has policy and PMO tooling, but municipalities often report via different PMO tools or static uploads, making aggregation brittle.
- Metadata & discoverability: datasets aren’t always cataloged with machine-readable provenance (RDF/JSON-LD) or OpenAPI specs.
Concrete engineering examples
- Quick fetch + normalize (Python/pandas):
import pandas as pd
url = 'https://notice.go.jp/docs/status_nicter.csv'
df = pd.read_csv(url, encoding='utf-8')
normalize datetime
df['ts'] = pd.to_datetime(df['timestamp'], errors='coerce')
standardize column names
df.columns = [c.strip().lower().replace(' ', '_') for c in df.columns]
- API layer: deploy a small gateway that exposes municipal datasets under a unified schema (OpenAPI, JSON/CSV). Use an automated ETL (GitHub Actions) to validate CSVs with jsonschema and publish to a CKAN/Datastore.
- Example schema snippet (JSON Schema concept):
{
"type":"object",
"properties":{
"date":{"type":"string","format":"date"},
"value":{"type":"number"},
"source":{"type":"string"}
},
"required":["date","value","source"]
}
Policy vs Implementation: measurable gaps
- Soumu/Digital Agency set goals for standardizing core municipal systems. But without machine-readable progress metrics (e.g., percent of municipalities on standard system, with API endpoints), it's hard to audit impact.
- Proposal: publish a small machine-readable progress API per municipality: {municipality_code, standard_system_version, migration_status, last_updated} so dashboards and researchers can measure real adoption rates.
Improvement roadmap (practical)
まとめ
- Japan has great building blocks: e-Stat, Japan Dashboard, and policy frameworks from Digital Agency and Soumu.
- The missing piece is consistent engineering: unified schemas, APIs, metadata and CI for data quality.
- Fixing those multiplies civic value: easier research, better transparency, and faster innovation by civic tech teams.
おかむーから一言
Tech solves a lot: publish schemas, ship APIs, run simple CI — and you turn bureaucracy into platform. Let's build the plumbing so policy actually becomes measurable and reusable!
Sources
- https://www.keiba.go.jp/
- https://www.digital.go.jp/policies/local_governments
- https://www.keiba.go.jp/KeibaWeb/TodayRaceInfo/TodayRaceInfoTop
- https://www.soumu.go.jp/menu_seisaku/chiho/jichitaijoho_system/index.html
- https://www.keiba.go.jp/live/
- https://notice.go.jp/docs/status_nicter.csv
- https://www.jinji.go.jp/content/900024615.csv
- https://www.env.go.jp/content/900398071.csv
- https://www.inpit.go.jp/content/100869372.csv
- https://www.mhlw.go.jp/content/001429362.csv
- https://www.kantei.go.jp/
- https://www.digital.go.jp/resources/japandashboard
- https://www.kantei.go.jp/jp/kakugikettei/index.html
- https://dashboard.e-stat.go.jp/
- https://www.kantei.go.jp/jp/naikaku/index.html
Share
Related Reports

Code-driven Manifesto: Auditing Local Gov Data and Systems (Kagawa case study)
Local gov systems run but hide data behind UIs; expose CSV/JSON, APIs, and common schemas to unlock value.

Code-driven Check: Japan’s Open Data and the Machine-Readable Gap
Digital Japan has dashboards and rules, but PDFs and messy formats still block automated policy verification; mandate CSV/JSON, APIs, and dataset linting.

Code Speaks: Testing Japan's Gov Data and Dashboards
Japan has great dashboards but inconsistent machine-readability. This report inspects e-Stat, Japan Dashboard, Kantei PDFs, and proposes API-first fixes and practical code examples.