indec

INDEC Argentina — 時系列データ公式 API

アルゼンチンのマクロ経済・社会データを、アルゼンチン政府公式 API apis.datos.gob.ar/series 経由で取得するための プレミアムスキルです。API キーや認証は不要で、公式ドキュメントと no-break ABI ポリシーを備えています。

TradingView や Google Finance などの内部 API に基づくスキルとは異なり、これは公開されている政府公式 APIで、公共データ・情報局が運用しています。リポジトリ全体で最も安定性と信頼性の高い API です。

---

🎯 対象データ

公式カタログに掲載されている約4,250件の時系列データを対象とし、アルゼンチンの複数の公的機関のデータを集約しています。

機関	データの種類
INDEC	全国 CPI、GBA CPI、EMAE、IPI、ISAC、EPH（雇用／失業）、貧困、国勢調査、貿易、GDP
BCRA	為替レート、外貨準備高、REM 期待、為替収支、金利
Min Economia	国民経済計算 GDP、公的債務、財政
Sec Trabajo (MTEySS)	RIPTE、SMVM、年金受給額
DGEYC (CABA)	ブエノスアイレス市 CPI

---

🚀 クイックスタート

# Snapshot rapido de la economia argentina
py scripts/fetch_indec.py snapshot --last 3

# IPC ultimos 12 meses
py scripts/fetch_indec.py ipc --last 12

# EMAE original + desestacionalizado
py scripts/fetch_indec.py emae --last 12

# Tipo de cambio diario → cierre mensual
py scripts/fetch_indec.py dolar --collapse month --aggregation end_of_period --last 12

# Buscar serie por keyword
py scripts/fetch_indec.py search "pobreza" --limit 10

# Serie por ID con transformacion (var YoY)
py scripts/fetch_indec.py series "145.3_INGNACUAL_DICI_M_38" --mode percent_change_a_year_ago --last 12

---

⚡ このスキルだけの機能

この API に備わる、リポジトリ内の他のスキルでは利用できない3つの主要機能です。

1. サーバー側の組み込み変換

IPC 指数から、前年比インフレ率や年初来累積値を、クライアント側で計算せずに直接取得できます。

# Inflacion interanual ya calculada
py scripts/fetch_indec.py series "<ID_IPC_INDICE>" --mode percent_change_a_year_ago

利用可能なモード：value、change、percent_change、 percent_change_a_year_ago（前年比インフレ率）、 percent_change_since_beginning_of_year（年初来インフレ率）、 change_a_year_ago、change_since_beginning_of_year。

references/REPRESENTATION_MODES.md を参照してください。

2. 組み込みの時間集計

日次系列をサーバー上で直接、月次または年次に変換できます。

# Dolar diario → cierre mensual
py scripts/fetch_indec.py dolar --collapse month --aggregation end_of_period

集約単位：day、week、month、quarter、semester、year。 集計方法：avg、sum、end_of_period、min、max。

references/COLLAPSE_AGGREGATIONS.md を参照してください。

3. 1回のリクエストで複数の系列を取得

IPC + RIPTE + ドルを1回のリクエストでまとめて取得できます。

py scripts/fetch_indec.py series "145.3_INGNACUAL_DICI_M_38,158.1_REPTE_0_0_5,168.1_T_CAMBIOR_D_0_0_26" --last 12

---

スキルの構成

skills/indec/
├── SKILL.md                                # Este archivo
├── references/                             # 10 documentos exhaustivos
│   ├── REFERENCE.md                        # Overview general
│   ├── ENDPOINTS.md                        # Deep dive de los 4 endpoints
│   ├── PARAMS.md                           # Cada parametro explicado
│   ├── REPRESENTATION_MODES.md             # Las 7 transformaciones
│   ├── COLLAPSE_AGGREGATIONS.md            # Agregacion temporal
│   ├── SERIES_CATALOG.md                   # IDs canonicos por topico
│   ├── RESPONSE_FORMAT.md                  # Schema JSON / CSV completo
│   ├── DATA_SOURCES.md                     # Organismos publicadores
│   ├── COOKBOOK.md                         # 30+ recetas
│   └── LIMITATIONS_TROUBLESHOOTING.md      # Limites + errores comunes
├── assets/                                 # 5 archivos JSON
│   ├── known_series_ids.json               # Catalogo curado de IDs
│   ├── series_groups.json                  # Bundles pre-armados
│   ├── representation_modes.json           # Modes con ejemplos
│   ├── collapse_aggregations.json          # Aggregations con ejemplos
│   └── data_sources.json                   # Publicadores estructurados
└── scripts/
    └── fetch_indec.py                      # Script con 19 modos CLI

---

利用可能な19の CLI モード

直接クエリ（4モード）

モード	説明
series IDS	ID を指定して取得 — 最も強力なモード
search QUERY	キーワードで系列を検索
validate IDS	ID が有効かどうかを検証
dump	カタログ全体（サイズ大、約数 MB）

指標別ショートカット（9モード）

モード	返されるデータ	組み合わせる ID
ipc	全国 CPI の月次変動	1 ID
ipc-completo	CPI + コア + 規制価格 + カテゴリ	5 ID
emae	EMAE 原系列 + 季節調整済み系列	2 ID
salarios	RIPTE + SMVM + 年金受給額	5 ID
comercio	輸出総額（月次／四半期／年次）	3 ID
construccion	ISAC 総合水準	2 ID
dolar	BNA 日次為替レート	1 ID（BCRA）
reservas	BCRA 外貨準備高	4 ID（BCRA）
snapshot	アルゼンチンのマクロ経済スナップショット	組み合わせた5 ID

ローカルカタログ（5モード）

モード	返されるデータ
catalog	主要な系列 ID をまとめたカタログ
groups	事前構成済みバンドル
sources	公表機関
modes	利用可能な表現モード
aggregations	利用可能な集約単位と集計方法

統合（1モード）

モード	返されるデータ
all	マクロ経済の完全なスナップショット：IPC + EMAE + 賃金 + ドル + 外貨準備高 + 建設 + 貿易

---

主なフラグ

Flag	説明
--start YYYY-MM-DD	開始日
--end YYYY-MM-DD	終了日
--last N	直近の N 個の値（⚠️ sort/start/limit と併用不可）
--mode X	表現モード（value / percent_change / percent_change_a_year_ago / etc.）
--collapse X	時間集計（day/week/month/quarter/semester/year）
--aggregation X	集計モード（avg/sum/end_of_period/min/max）
--limit N	系列ごとのデータポイント数（最大 1000）
--offset N	ページネーション用オフセット
--sort asc/desc	並べ替え順
--metadata X	詳細度（none/only/simple/full）
--format X	json または csv
--raw	正規化されていないレスポンス
-o file	ファイルに保存
-q	サイレントモード

---

bcra-macro およびその他のスキルとの違い

機能	indec	bcra-macro	FRED
認証不要	✅	✅	❌ key が必要
INDEC を完全にカバー	✅	❌	❌
BCRA をカバー	⚠️ 一部	✅ 638 系列	❌
複数機関に対応	✅ INDEC + BCRA + Min Econ	❌ BCRA のみ	✅ グローバル
組み込みの変換（% YoY、YTD）	✅ 唯一	❌	⚠️ FRED transform が必要
組み込みの時間集計	✅ 唯一	❌	⚠️
1 回のリクエストで複数系列に対応	✅ 唯一	❌	❌
公開されている公式ドキュメント	✅	✅	✅

indec と bcra-macro の使い分け：

• INDEC（IPC、EMAE、EPH、PIB）→ indec
• BCRA のみで完全なカバレッジが必要な場合 → bcra-macro
• 1 つのデータセットで INDEC と BCRA を組み合わせる場合 → indec

---

よくあるユースケース

references/COOKBOOK.md に 30 以上のレシピを掲載しています。

# Inflacion mensual ultimos 12 meses
py scripts/fetch_indec.py ipc --last 12

# Inflacion interanual desde el indice
py scripts/fetch_indec.py series "<ID_IPC_INDICE>" --mode percent_change_a_year_ago

# Dolar diario → promedio mensual
py scripts/fetch_indec.py dolar --collapse month --aggregation avg

# Exportaciones totales por año
py scripts/fetch_indec.py series "75.3_IETG_0_M_31" --collapse year --aggregation sum --last 10

# Comparar IPC + RIPTE + Dolar (poder adquisitivo)
py scripts/fetch_indec.py series "145.3_INGNACUAL_DICI_M_38,158.1_REPTE_0_0_5,168.1_T_CAMBIOR_D_0_0_26" --last 12

# Snapshot macro
py scripts/fetch_indec.py snapshot --last 3

---

ドキュメント一覧

ドキュメント	内容
references/REFERENCE.md	全般的な概要とアーキテクチャ
references/ENDPOINTS.md	/series、/search、/dump、/validate の詳細
references/PARAMS.md	各パラメーターの有効な値、デフォルト値、例
references/REPRESENTATION_MODES.md	7 種類の変換と計算例
references/COLLAPSE_AGGREGATIONS.md	ユースケースを含む時間集計
references/SERIES_CATALOG.md	トピック別に整理された標準 ID
references/RESPONSE_FORMAT.md	JSON / CSV スキーマの全容
references/DATA_SOURCES.md	データセットを公開している機関
references/COOKBOOK.md	すぐにコピーして使える 30 以上のレシピ
references/LIMITATIONS_TROUBLESHOOTING.md	制限事項、よくあるエラー、デバッグ
assets/known_series_ids.json	厳選された ID カタログ
assets/series_groups.json	ユースケース別の事前構成済みバンドル
assets/representation_modes.json	説明付きのモード
assets/collapse_aggregations.json	ユースケース付きの集計
assets/data_sources.json	構造化されたデータ公開元

---

⚠️ 既知の制限事項

制限事項の詳細については、 references/LIMITATIONS_TROUBLESHOOTING.md をご覧ください。

最も重要な点

1. 1リクエストあたり、系列ごとに最大1,000 datapoints — 非常に長い系列では、--offset を使ってページ分割してください。
2. --last は --sort、--limit、--offset と併用できません — スクリプトが自動的に処理します。
3. 頻度が混在する複数系列 — 予期しない結果を避けるため、--collapse を明示的に指定してください。
4. 廃止された系列は dataset.title で SERIE DISCONTINUADA と表示されます — クライアント側でフィルタリングしてください。
5. 暗号資産の ID — 推測せず、search または厳選カタログを使用してください。
6. INDEC の遅延：月次 CPI は約15日後、四半期 GDP は約3か月後に表示されます。

他の API よりもはるかに信頼性が高い理由

TradingView／Google Finance／BYMA（いずれも内部 API）とは異なり、次の特徴があります。

• ✅ アルゼンチン政府の公式公開 API。
• ✅ 公式ドキュメント：datosgobar.github.io/series-tiempo-ar-api
• ✅ GitHub のオープンソースコード：datosgobar/series-tiempo-ar-api
• ✅ ABI を破壊しないポリシー — 2017年以降、安定しています。
• ✅ 公開されているイシュートラッカー。

内部 API よりもはるかに高い信頼性で、この API を基盤に製品を構築できます。

---

外部リファレンス

• 公式ドキュメント： https://datosgobar.github.io/series-tiempo-ar-api/
• オープンソースコード（GitHub）： https://github.com/datosgobar/series-tiempo-ar-api
• datos.gob.ar ポータル： https://datos.gob.ar
• INDEC 公式サイト： https://www.indec.gob.ar
• BCRA 公式サイト： https://www.bcra.gob.ar