Code-driven Manifest: Auditing Japan's Public Data Stack

- Quick takeaways:
- Machine-readability is uneven: CSV/GeoJSON and CKAN coexist with PDFs and ad-hoc Excel files — so reproducible analysis still requires glue code.
- Practical fixes: API-first publishing, DCAT/CSVW metadata, schema validation and CI for data quality can close the policy → evidence gap.
結論
How to say it simply: Japan has the right building blocks (Digital Agency's Japan Dashboard, e-Stat, Tokyo's open-data catalog, CKAN instances) but the integration and machine-readability needed for rigorous, code-driven policy verification are not yet consistent. エンジニア的に言うと、API contracts and metadata matter more than pretty dashboards.
Report
Hey — Okamu here! Let’s walk through what’s live and what an engineer would fix first.
What exists
- Japan Dashboard (Digital Agency): centralized dashboards publishing public statistics (https://www.digital.go.jp/resources/japandashboard). Nice single entrypoint, intended to unite economic/finance/population dashboards.
- e-Stat (Statistics Bureau): core official statistics with graphing and API hints (https://dashboard.e-stat.go.jp/ and https://www.stat.go.jp). This is the canonical dataset pool.
- Municipal catalogs: Tokyo Open Data portal (https://portal.data.metro.tokyo.lg.jp/, https://catalog.data.metro.tokyo.lg.jp/) and many cities run CKAN (e.g., Daisen city CKAN). These provide CSV/GeoJSON but with varying schema quality.
Data quality & machine-readability — code sees the pain
これ見てくださいよ: often the most critical KPI or evaluation lives in a PDF (see some prefectural reports on digital grant outcomes). From an engineering view PDFs are black boxes. 要するに、PDF = manual extraction, non-reproducible.
Concrete issues observed
- Mixed formats: CSV/GeoJSON and PDFs/Excel coexist. No uniform content negotiation.
- Metadata gaps: license, update cadence, column semantics missing or inconsistent across municipalities.
- API inconsistencies: Some CKAN-powered catalogs provide full API; others only allow downloads. Japan Dashboard aggregates visuals but not always a documented API for bulk retrieval.
- KPI opacity: Grants like the Digital Garden City subsidies publish evaluation PDFs; machine-readable KPIs would let independent verification compare targets vs outcomes programmatically.
Quick code snippets (practical)
- Fetching a CKAN dataset (Python):
import requests
import pandas as pd
r = requests.get('https://catalog.data.metro.tokyo.lg.jp/api/3/action/package_show', params={'id':'dataset-id'})
meta = r.json()['result']
url = meta['resources'][0]['url']
df = pd.read_csv(url)
- Verifying KPI achievement (pseudo):
load published_kpis.csv and actuals.csv
compare with vectorized pandas math; flag discrepancies > tolerance
These are trivial automation wins but need consistent endpoints.
Recommendations (engineer-first)
1) API-first publishing: every dashboard must expose a RESTful bulk API (OpenAPI spec) plus dataset endpoints for CSV/JSON/GeoJSON.
2) Standard metadata: require DCAT + CSVW/JSON-LD describing schema, license, last_updated, source_id. Tokyo already signals municipal standard datasets — adopt and enforce that across prefectures.
3) Machine-readable KPIs: publish program KPIs as structured data (CSV/JSON) alongside narrative reports so outcomes can be objectively computed.
4) Data CI & validation: run pipelines with Great Expectations or Data Package Pipelines that validate schema, value ranges, and timeliness before publishing.
5) Reproducible analytics: host example Jupyter notebooks in a public repo that pull from the Dashboard/e-Stat and reproduce official charts — makes claims auditable.
Policy gap example
- The Digital Garden City grant evaluations (found in prefectural PDFs) sometimes rely on self-reported, mechanically-scored documents. If those KPI results were published as structured time-series, we could compute attainment rates across municipalities and detect over/under-performance programmatically.
Implementation roadmap (practical steps)
- Phase 1 (30–90 days): Inventory endpoints (crawl e-Stat, Japan Dashboard, municipal CKANs), publish an index.json with dataset metadata.
- Phase 2 (3–6 months): Add CSVW manifests and OpenAPI specs for major datasets; create sample notebooks reproducing 3 flagship indicators.
- Phase 3 (6–12 months): Automate data CI and a public metrics portal that surfaces KPI attainment with raw data and reproducible code links.
まとめ
Japan’s public data ecosystem is reaching maturity: central dashboards and municipal CKANs are in place, but without consistent machine-readable contracts and KPI publishing, independent verification is painful. エンジニア的に言うと、pretty charts are the last mile — the real work is in APIs, metadata, and pipelines.
おかむーから一言
I’ve built product teams that ship data pipelines — you don’t need magic, just standards and CI. Let’s push the government to publish KPIs as data, not PDFs. Tech can make democracy more auditable, and that’s why I’m fired up about this!
Sources
- https://www.digital.go.jp/resources/japandashboard
- https://dashboard.e-stat.go.jp/
- https://webtan.impress.co.jp/n/2025/07/14/49720
- https://www.kantei.go.jp/
- https://www.stat.go.jp/info/guide/public/kouhou/index.html
- https://catalog.data.metro.tokyo.lg.jp/dataset
- https://portal.data.metro.tokyo.lg.jp/
- https://catalog.data.metro.tokyo.lg.jp/dataset?_organization_limit=0&groups=c025&_groups_limit=0&res_format=CSV&q=&organization=t000029&tags=%E8%87%AA%E6%B2%BB%E4%BD%93%E6%A8%99%E6%BA%96%E3%82%AA%E3%83%BC%E3%83%97%E3%83%B3%E3%83%87%E3%83%BC%E3%82%BF%E3%82%BB%E3%83%83%E3%83%88
- https://www.city.daisen.lg.jp/open-data/dataset/
- https://opendata.pref.saitama.lg.jp/datasets
- https://www.chisou.go.jp/sousei/about/kouhukin/index.html
- https://www.chisou.go.jp/sousei/about/kouhukin/pdf/r6_houkokusho-suishin.pdf
- https://www.pref.tokushima.lg.jp/file/attachment/1034065.pdf
- https://www.pref.yamaguchi.lg.jp/uploaded/attachment/160746.pdf
- https://www.digital.go.jp/policies/digital_garden_city_nation
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.