# e-Stat Skill e-Stat API v3.0 を通じて、日本の政府統計データにアクセスするための Claude Code スキルです。 ## Architecture ```mermaid graph LR subgraph User ["User / Claude Code"] Terminal["Terminal"] ENV["ESTAT_APP_ID"] OUT["Output: JSON / CSV / Summary"] end subgraph CLI ["estat.py CLI"] search["search"] meta["meta"] data["data"] catalog["catalog"] batch["batch"] ds_reg["dataset-register"] ds_ref["dataset-ref"] api_get["api_get()"] api_post["api_post()"] end subgraph API ["e-Stat API v3.0"] ep1["getStatsList"] ep2["getMetaInfo"] ep3["getStatsData"] ep4["postDataset"] ep5["refDataset"] ep6["getDataCatalog"] ep7["getStatsDatas"] end Terminal --> search Terminal --> meta Terminal --> data api_get -->|HTTPS GET| ep1 api_get --> ep2 api_get --> ep3 api_get --> ep5 api_get --> ep6 api_get --> ep7 api_post -->|HTTPS POST| ep4 style User fill:#dae8fc,stroke:#6c8ebf,stroke-width:2px style CLI fill:#d5e8d4,stroke:#82b366,stroke-width:2px style API fill:#f8cecc,stroke:#b85450,stroke-width:2px ``` ## Setup ### 1. アプリケーション ID の取得 [e-Stat API](https://www.e-stat.go.jp/api/) でユーザー登録し、アプリケーション ID を取得します。 ### 2. 環境変数の設定 ```bash export ESTAT_APP_ID="your_app_id_here" ``` または、スキルディレクトリに `.env` ファイルを作成: ```bash # ~/.claude/skills/e-stat/.env ESTAT_APP_ID=your_app_id_here ``` ### 3. 依存関係 `uv` が必要です。スクリプト実行時に自動で `requests` がインストールされます。 ```bash # uv がなければインストール curl -LsSf https://astral.sh/uv/install.sh | sh ``` ## Workflow ```mermaid graph LR S1["Step 1: search
統計表を検索

estat.py search '人口'
↓
statsDataId を取得"] S2["Step 2: meta
メタ情報を取得

estat.py meta 000341...
↓
次元・コードを確認"] S3["Step 3: data
データを取得

estat.py data 000341...
--cd-cat01 000
↓
統計データ出力"] S1 -->|"statsDataId"| S2 S2 -->|"filter codes"| S3 style S1 fill:#dae8fc,stroke:#6c8ebf,stroke-width:2px style S2 fill:#d5e8d4,stroke:#82b366,stroke-width:2px style S3 fill:#f8cecc,stroke:#b85450,stroke-width:2px ``` 基本的な利用の流れは **search → meta → data** の 3 ステップです。 ### Step 1: search -- 統計表を検索キーワードで統計表を検索し、`statsDataId` を取得します。 ```bash uv run scripts/estat.py search "人口" --limit 5 --summary ``` ### Step 2: meta -- メタ情報を取得テーブルの次元 (tab, cat01-15, area, time) とコード値を確認します。 ```bash uv run scripts/estat.py meta 0003411595 --summary ``` ### Step 3: data -- データを取得フィルタを指定して統計データを取得します。 ```bash uv run scripts/estat.py data 0003411595 \ --cd-cat01 000 --cd-area 00000 \ --cd-time 2024001001 --summary ``` ## Subcommands ```mermaid graph TB subgraph "estat.py subcommands" search["search
getStatsList
統計表検索"] meta["meta
getMetaInfo
メタ情報取得"] data["data
getStatsData
データ取得"] catalog["catalog
getDataCatalog
カタログ閲覧"] ds_reg["dataset-register
postDataset
データセット登録"] ds_ref["dataset-ref
refDataset
データセット参照"] batch["batch
getStatsDatas
一括取得"] end search -->|statsDataId| meta meta -->|codes| data meta -->|codes| ds_reg ds_reg -->|dataSetId| ds_ref search -.->|statsDataId| batch style search fill:#dae8fc,stroke:#6c8ebf style meta fill:#d5e8d4,stroke:#82b366 style data fill:#fff2cc,stroke:#d6b656 style catalog fill:#e1d5e7,stroke:#9673a6 style ds_reg fill:#f8cecc,stroke:#b85450 style ds_ref fill:#f8cecc,stroke:#b85450 style batch fill:#fff2cc,stroke:#d6b656 ``` | Command | API Endpoint | Purpose | |---------|-------------|---------| | `search` | getStatsList | キーワードで統計表を検索 | | `meta` | getMetaInfo | テーブルのメタ情報 (次元・コード) を取得 | | `data` | getStatsData | 統計データを取得 | | `catalog` | getDataCatalog | データカタログを閲覧 | | `dataset-register` | postDataset | データセットの登録・削除 | | `dataset-ref` | refDataset | 登録済みデータセットを参照 | | `batch` | getStatsDatas | 複数テーブルの一括データ取得 | ## Options ### 共通オプション | Option | Description | |--------|-------------| | `--app-id` | アプリケーション ID (環境変数の代わりに指定) | | `--format json\|csv` | 出力形式 (default: json) | | `--lang J\|E` | 言語 (default: J) | | `--limit N` | 最大件数 (default: 100000) | | `--summary` | 人間が読みやすい整形出力 | | `--all` | 自動ページネーションで全件取得 | ### フィルタオプション (`data`, `dataset-register` で使用) ```bash # カテゴリコードで絞り込み --cd-cat01 01000 --cd-cat02 A # カテゴリ範囲で絞り込み --cd-cat01-from 01000 --cd-cat01-to 05000 # 地域・時間・表章項目の範囲 --cd-area-from 01000 --cd-area-to 13000 --cd-time-from 2023000101 --cd-time-to 2024001212 --cd-tab-from 001 --cd-tab-to 003 # 階層レベル --lv-cat01 1-2 ``` ## Examples ### 人口データの取得 ```bash # 人口推計テーブルを検索 uv run scripts/estat.py search "人口推計" --limit 5 --summary # メタ情報を確認 (どんな次元があるか) uv run scripts/estat.py meta 0003411595 --summary # 2024年10月の全国人口 (男女別) uv run scripts/estat.py data 0003411595 \ --cd-area 00000 --cd-time 2024001001 --summary ``` ### 家計調査データの取得 ```bash # 家計調査を検索 uv run scripts/estat.py search "家計調査二人以上" --limit 10 --summary # 食料支出データを取得 uv run scripts/estat.py data 0003343671 \ --cd-cat01 060 --summary ``` ### CSV 形式で出力 ```bash uv run scripts/estat.py data 0003411595 \ --cd-area 00000 --format csv > population.csv ``` ### データセット ID で取得 ```bash uv run scripts/estat.py data --dataset-id MY_DATASET --summary ``` ### 一括データ取得 ```bash uv run scripts/estat.py batch 0003411595 0003343671 --summary ``` ## Directory Structure ``` ~/.claude/skills/e-stat/ ├── README.md # This file ├── SKILL.md # Skill definition for Claude Code ├── .env # Application ID (gitignored) ├── scripts/ │ └── estat.py # CLI tool (single file, ~920 lines) ├── tests/ │ └── test_estat.py # Unit tests (60 tests) └── references/ ├── overview.md # API overview ├── getStatsList.md # Search endpoint ├── getMetaInfo.md # Metadata endpoint ├── getStatsData.md # Data endpoint ├── postDataset.md # Dataset registration ├── refDataset.md # Dataset reference ├── getDataCatalog.md # Catalog endpoint └── getStatsDatas.md # Batch endpoint ``` ## Testing ```bash cd ~/.claude/skills/e-stat uv run --script scripts/estat.py -- --help # CLI help uv run pytest tests/test_estat.py -v # Run 60 unit tests ``` ## API Reference 各エンドポイントの詳細なパラメータは [references/](references/) ディレクトリを参照してください。 | File | Content | |------|---------| | [overview.md](references/overview.md) | Base URL, 認証, ページネーション, エラーコード | | [getStatsList.md](references/getStatsList.md) | 統計表検索パラメータ | | [getMetaInfo.md](references/getMetaInfo.md) | メタ情報の構造 (CLASS_INF) | | [getStatsData.md](references/getStatsData.md) | データ取得とフィルタリング | | [postDataset.md](references/postDataset.md) | データセット登録 (XML POST) | | [refDataset.md](references/refDataset.md) | データセット参照 | | [getDataCatalog.md](references/getDataCatalog.md) | カタログ閲覧 | | [getStatsDatas.md](references/getStatsDatas.md) | 一括取得 |

e-stat

Installation

SKILL.md