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

- Quick three-line summary
- PDFs and bespoke local systems block scale — engineers need stable JSON/CSV, OpenAPI, and common schemas to automate policy monitoring.
- Practical fixes: publish machine-readable KPIs, adopt CSVW/JSON Schema, provide sample APIs and migration tooling for local governments.
どうも〜おかむーです! Hey—okamu here! Today I’ll do a tech-first read of Japan’s public data posture — "code-as-manifesto" style. Engineers, policy nerds, and civic hackers, this one’s for you.
結論
Japan has made smart institutional choices (Digital Agency, Japan Dashboard, e-Stat), but real-world interoperability is slowed by PDFs, fragmented local systems, and inconsistent API practices. 要するに、政策はあるけどデータ工場が汚れてるんですよね。機械可読性を確保して、標準仕様とオープンAPIを義務化すれば、PDCAが回り出します!
Report: what's working and what's not
Current landscape (sources)
- National: Digital Agency (https://www.digital.go.jp/) and Japan Dashboard (https://www.digital.go.jp/resources/japandashboard) centralize visualization and policy promotion.
- Statistics: e-Stat dashboard (https://dashboard.e-stat.go.jp/) exposes many stats and an API — good!
- Local: ministry push on standardizing municipal core systems (https://www.digital.go.jp/policies/local_governments and https://www.soumu.go.jp/...) and concrete municipality evaluations like Sukagawa's report show grant usage and KPI reviews.
These are solid building blocks, but trust me — engineers look at file formats first.
Machine-readability: PDFs vs CSV/JSON
This is the heart of friction. KPI reports, grant results, and sometimes even dashboards publish final PDFs. This means:
- No easy automation to track time series across municipalities.
- Extra ETL burden: OCR, table extraction (tabula/camelot) and error-prone transformations.
Practical pattern: insist on both human-friendly PDF and machine-first CSV/JSON with a published JSON Schema or CSVW metadata file.
API and schema hygiene
- e-Stat has APIs — great example. But many other inventories are ad-hoc or behind legacy local systems.
- Standardization effort exists (soumu PMO tool listing progress), but we need: OpenAPI specs, consistent auth (OpenID Connect), rate limits, and versioning.
KPI vs Reality
Look at Digital Garden City grant guidance (https://www.chisou.go.jp/...) and municipal evaluations (e.g., Sukagawa). The KPI documents list targets, but automated validation is rare. That creates gaps between policy intent and measurable outcomes.
Concrete tech fixes (engineering playbook)
- Publish machine-readable KPIs: time-series JSON or CSV with metadata (columns, units, update cadence).
- OpenAPI for every public API; example minimal OpenAPI: provide /kpi/{municipality}/{metric} returning JSON timeseries.
- Use CSVW or JSON Schema; provide a Data Package (Frictionless Data) for each dataset.
- Offer sample ETL and validation tooling in GitHub for municipal use.
Code snippet: fetch e-Stat-like JSON and load into pandas
import requests
import pandas as pd
r = requests.get('https://api.e-stat.go.jp/rest/3.0/app/json/getStatsData', params={'appId':'YOUR_KEY','...': '...'})
data = r.json()
normalize to table
df = pd.json_normalize(data['GET_STATS_DATA']['STATISTICAL_DATA']['DATA_INF'])
print(df.head())
For PDF table extraction, recommend Camelot or tabula-py as temporary bridge, but push upstream publishers to CSV/JSON.
Implementation roadmap (high level)
- Mandate machine-readable KPIs for grant-funded projects.
- Create reference OpenAPI + JSON Schema templates and a validation CI for datasets.
- Fund a "data migration kit" for municipalities (containerized ETL, docs, training).
- Integrate KPI endpoints into Japan Dashboard and e-Stat so progress is automatically tracked.
まとめ
- Japan has strong institutions and some APIs, but inconsistent formats (PDFs) and fragmented municipal systems limit automation.
- Fix: require CSV/JSON + schema, publish OpenAPI, provide tooling and training.
- Outcome: faster, auditable policy monitoring, more civic-tech innovation, and less manual scraping — win-win.
おかむーから一言
I’ve built startups and shipped gov-tech — this is doable. Give devs clean data and clear contracts (APIs + schemas), and they'll build the accountability layer policymakers actually need!
Sources
- https://ja.wikipedia.org/wiki/%E3%83%87%E3%82%B8%E3%82%BF%E3%83%AB
- https://www.chisou.go.jp/sousei/pdf/r5_guideline-checkaction.pdf
- https://www.digital.go.jp/
- https://www.city.sukagawa.fukushima.jp/shisei/gyoseiunei/keikaku/chiho_sosei/1015604/4045.html
- https://biz.kddi.com/content/column/smartwork/what-is-digital/
- 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://www.kantei.go.jp/
- https://dashboard.e-stat.go.jp/
- https://www.kantei.go.jp/jp/kakugikettei/index.html
- https://www.digital.go.jp/resources/japandashboard
- 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.