/indec

name: indec
description: "Datos macro y sociales de Argentina via la API oficial Series de Tiempo del Estado (apis.datos.gob.ar/series). ~4250 series del INDEC + BCRA + Min Economia + Sec Trabajo. Sin auth, sin API key. IPC nacional, EMAE, IPI, ISAC, EPH (desempleo), pobreza, comercio exterior, salarios (RIPTE, SMVM), tipo de cambio, reservas, REM expectativas. Transformaciones builtin (% YoY, % YTD, change) y agregacion temporal (daily→monthly→yearly) server-side. La API mas estable y mejor documentada del repo."
license: MIT

INDEC Argentina — API Oficial de Series de Tiempo

Skill **premium** para extraer datos macroeconomicos y sociales de Argentina via la **API oficial del Estado Argentino**: `apis.datos.gob.ar/series` — sin API key, sin autenticacion, con documentacion oficial y politicas de no-break ABI.

A diferencia de skills basados en APIs internas (TradingView, Google Finance), **esta es una API PUBLICA OFICIAL** mantenida por la Direccion Nacional de Datos e Informacion Publica. Es **la API mas estable y confiable de todo el repositorio.**

---

🎯 Que datos cubre

**~4,250 series totales** del catalogo oficial, agregando datos de multiples organismos publicos argentinos:

| Organismo | Tipo de datos | |-----------|---------------| | **INDEC** | IPC nacional, IPC GBA, EMAE, IPI, ISAC, EPH (empleo/desempleo), pobreza, censos, comercio exterior, PIB | | **BCRA** | Tipo de cambio, reservas, REM expectativas, balance cambiario, tasas | | **Min Economia** | PIB cuentas nacionales, deuda publica, fiscal | | **Sec Trabajo (MTEySS)** | RIPTE, SMVM, haber jubilatorio | | **DGEYC (CABA)** | IPC Ciudad de Buenos Aires |

---

🚀 Quick start

# 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

---

⚡ Lo unico que hace este skill

Tres killer features de esta API (no disponibles en otros skills del repo):

1. Transformaciones builtin server-side

Pedir **inflacion interanual** o **acumulada YTD** directamente desde el indice IPC, sin calcular cliente-side:

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

Modos disponibles: `value`, `change`, `percent_change`, `percent_change_a_year_ago` (**inflacion YoY**), `percent_change_since_beginning_of_year` (**inflacion YTD**), `change_a_year_ago`, `change_since_beginning_of_year`.

Ver [`references/REPRESENTATION_MODES.md`](./references/REPRESENTATION_MODES.md).

2. Agregacion temporal builtin

Convertir serie diaria a mensual/anual directamente en el server:

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

Collapses: `day`, `week`, `month`, `quarter`, `semester`, `year`. Aggregations: `avg`, `sum`, `end_of_period`, `min`, `max`.

Ver [`references/COLLAPSE_AGGREGATIONS.md`](./references/COLLAPSE_AGGREGATIONS.md).

3. Multi-serie en una sola request

Combinar IPC + RIPTE + dolar en 1 request:

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

---

Estructura del skill

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 modos CLI disponibles

Consulta directa (4 modos)

| Modo | Descripcion | |------|-------------| | `series IDS` | Fetch por ID(s) — el modo mas potente | | `search QUERY` | Busca series por keywords | | `validate IDS` | Valida que un ID sea correcto | | `dump` | Catalogo completo (pesado, ~MBs) |

Atajos por indicador (9 modos)

| Modo | Que devuelve | IDs combinados | |------|--------------|----------------| | `ipc` | IPC Nacional var mensual | 1 ID | | `ipc-completo` | IPC + nucleo + regulados + categorias | 5 IDs | | `emae` | EMAE original + desestacionalizado | 2 IDs | | `salarios` | RIPTE + SMVM + haber jubilatorio | 5 IDs | | `comercio` | Exportaciones totales (M/T/A) | 3 IDs | | `construccion` | ISAC nivel general | 2 IDs | | `dolar` | Tipo de cambio BNA diario | 1 ID (BCRA) | | `reservas` | Reservas internacionales BCRA | 4 IDs (BCRA) | | `snapshot` | Snapshot macro Argentina | 5 IDs combinadas |

Catalogos locales (5 modos)

| Modo | Que de