📊 INE España Scraper: Estadísticas Oficiales, Series Temporales e Indicadores Económicos

Extrae, normaliza y automatiza datos del Instituto Nacional de Estadística (INE de España): IPC, Inflación, Empleo/EPA, Vivienda (IPV), Hipotecas, Población/Padrón, PIB, Salarios y más de 112 operaciones oficiales en formato JSON/CSV listo para producción.

---

🎯 1. ¿Por qué este Actor? (Value Proposition)

El Instituto Nacional de Estadística (INE) es la principal fuente de verdad socioeconómica y demográfica de España. Sin embargo, acceder a sus datos mediante métodos tradicionales presenta graves fricciones:

• La navegación web por INEbase es manual, lenta y compleja.
• La API cruda Tempus3 devuelve estructuras anidadas difíciles de interpretar, códigos numéricos crípticos y formatos de fechas variables.
• Falta de normalización automática de dimensiones territoriales, unidades y valores numéricos.

Este Actor resuelve estos problemas convirtiéndose en la interfaz definitiva y universal de datos del INE:

• ✅ 1-Click Presets: Indicadores clave listos para consumir (IPC, Inflación, Empleo EPA, Hipotecas, Precios Vivienda IPV, PIB, Población, Salarios).
• ✅ Búsqueda Inteligente: Descubre tablas y operaciones entre las más de 112 estadísticas oficiales por palabras clave (alquiler, hoteles, turismo, defunciones, vehículos).
• ✅ Datos B2B 100% Limpios: Importes como float puro, fechas en estándar ISO 8601, desgloses categóricos y ámbito territorial identificados.
• ✅ Listo para LLMs & RAG: Salida perfectamente formateada para alimentar asistentes de IA, agentes MCP y pipelines de análisis macroeconómico.

---

🚀 2. Características Diferenciales y Tabla Comparativa

Característica	🛠️ Extracción Manual / API Cruda INE	⚡ Otros Scrapers Genéricos	🏆 INE España Scraper (Este Actor)
Facilidad de Uso	Requiere programar clientes HTTP complejos y mapear IDs	Configuración rígida de pocas tablas	1-Click Presets + Búsqueda por texto + Códigos libres
Normalización Numérica	Cadenas con comas ("102,4") o secretos estadísticos	Texto plano sin tipar	Valores float puros procesados y saneados
Estandarización de Fechas	Timestamps en milisegundos o formatos aaaammdd	Inconsistente	ISO 8601 (YYYY-MM-DDTHH:MM:SSZ) universal
Desglose de Variables	Arrays numéricos MetaData anidados	Información perdida o truncada	Mapeo clave-valor completo de dimensiones
Identificación Territorial	Códigos numéricos de provincia/CCAA	No resuelto	Columna territorial directa (Nacional, CCAA, Provincias)
Inventario de Operaciones	PDF / Búsqueda manual en la web	No disponible	Modo Catálogo de 112+ operaciones en 1 clic
Integración con IA / MCP	Requiere transformaciones complejas	No optimizado	Esquema estructurado listo para GPT-4, Claude y n8n

---

💼 3. Casos de Uso Empresariales (B2B)

🏢 1. Real Estate & Proptech

• Monitoriza la evolución del Índice de Precios de Vivienda (IPV) y de Compraventas de Inmuebles (ETDP) por Comunidad Autónoma.
• Cruza datos de Hipotecas constituidas e importes medios prestados para análisis de riesgo crediticio y tasaciones.

📈 2. Análisis Financiero & Macroeconomía

• Automatiza la ingesta mensual del IPC (Índice de Precios de Consumo) general y subyacente para indexación de contratos, nóminas y cláusulas de revisión de precios.
• Modela previsiones de crecimiento con la Contabilidad Nacional Trimestral (PIB) y la Encuesta de Población Activa (EPA).

🤖 3. RAG, Agentes de IA y Contexto Empresarial (MCP)

• Conecta este Actor a agentes de IA mediante el Apify Model Context Protocol (MCP) para responder preguntas en tiempo real sobre estadísticas oficiales españolas.

🏨 4. Turismo & Sector Servicios

• Monitorea flujos turísticos con la Encuesta de Ocupación Hotelera (EOH) y el gasto medio por turista para optimizar precios y estacionalidad.

---

💰 4. Transparencia de Consumo y Costes

El Actor utiliza el modelo Pay Per Event (Pago por Resultado) en Apify Store:

Métrica	Coste Estimado
Tarifa por Registro (Default Dataset Item)	$2.40 / 1,000 registros ($0.0024 por dato extraído)
Tarifa de Inicio de Ejecución (Actor Start)	$0.00005
Consumo de Compute Units (CUs)	Optimizado con peticiones HTTP asíncronas de bajo consumo (~0.002 CUs por ejecución)

💡 Ejemplo Práctico: Extraer los últimos 12 meses de IPC general y subyacente para todas las Comunidades Autónomas (~200 registros) cuesta menos de $0.0005 USD.

---

⚙️ 5. Guía de Parámetros de Entrada (Input)

Campo	Tipo	Requerido	Default	Descripción
mode	String (Select)	Sí	PRESET	Modo de extracción: PRESET, SEARCH, CUSTOM_OPERATION, CUSTOM_TABLE, DIRECT_URLS, OPERATIONS_CATALOG.
presetOperation	String (Select)	No	IPC	Indicador preconfigurado (IPC, EPA, IPV, HIPOTECAS, PADRON, PIB, TRANSMISIONES, TURISMO, SALARIOS, EMPRESAS).
searchQuery	String	No	"alquiler"	Texto de búsqueda en el catálogo de operaciones del INE.
operationCode	String	No	"IPC"	Código oficial Tempus3 (ej. IPC, IPV, EPA, ETDP).
tableId	String	No	"24077"	Identificador numérico de tabla estadística del INE.
directUrls	Array[String]	No	[]	Lista de enlaces directos de tablas de ine.es.
periodsCount	Integer	No	12	Últimos periodos cronológicos por serie (0 = todo el histórico).
dateFrom	String	No	null	Fecha inicial en formato YYYY-MM-DD.
dateTo	String	No	null	Fecha final en formato YYYY-MM-DD.
maxTables	Integer	No	5	Límite de tablas estadísticas a procesar por operación.
maxItems	Integer	No	1000	Límite máximo de observaciones a guardar en el dataset.
proxyConfiguration	Object	No	{"useApifyProxy": false}	Configuración opcional de Proxies Apify.

📋 Ejemplo de Input en JSON

{
  "mode": "PRESET",
  "presetOperation": "IPC",
  "periodsCount": 12,
  "maxTables": 3,
  "maxItems": 500,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

---

📊 6. Ejemplo de Salida Estructurada (Dataset Output)

Cada registro en el dataset representa una observación estadística normalizada con sus metadatos y dimensiones:

{
  "operation_code": "IPC",
  "operation_name": "Índice de Precios de Consumo (Inflación)",
  "table_id": "24077",
  "table_name": "Índice general nacional. Series desde enero de 1961",
  "series_code": "IPC290751",
  "series_name": "Nacional. Índice general. Índice.",
  "date": "2026-07-01T00:00:00+00:00",
  "year": 2026,
  "period": "Mes 07",
  "value": 103.899,
  "unit": "Índice",
  "scale": "Unidades",
  "territory": "Nacional",
  "variable_breakdown": {
    "Totales Territoriales": "Nacional",
    "Grupos ECOICOP": "Índice general",
    "Índices y Tasas": "Índice"
  },
  "source_url": "https://www.ine.es/jaxiT3/Tabla.htm?t=24077",
  "extracted_at": "2026-08-23T11:05:30.123456+00:00"
}

---

🔗 7. Automatización e Integraciones

🐍 Python (Apify Client SDK)

from apify_client import ApifyClient

client = ApifyClient("TU_API_TOKEN")

run_input = {
    "mode": "PRESET",
    "presetOperation": "IPV",
    "periodsCount": 8,
    "maxItems": 200,
}

run = client.actor("USUARIO/ine-spain-scraper").call(run_input=run_input)

# Iterar sobre los datos normalizados
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"[{item['date']}] {item['territory']} - {item['series_name']}: {item['value']} {item.get('unit')}")

🟩 Node.js / JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'TU_API_TOKEN' });

const input = {
    mode: 'PRESET',
    presetOperation: 'EPA',
    periodsCount: 4,
};

const run = await client.actor('USUARIO/ine-spain-scraper').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Extraídos ${items.length} registros oficiales del INE.`);

⚡ Make.com / Zapier / n8n

1. Añade el módulo de Apify: Run Actor.
2. Selecciona ine-spain-scraper y define el JSON de configuración.
3. Conecta el trigger de salida a Google Sheets, Notion, PostgreSQL o tu Data Warehouse.

---

❓ 8. Preguntas Frecuentes (FAQ) y Cumplimiento Legal

¿Se necesita API Key o registro en el INE?

No. El Instituto Nacional de Estadística (INE) ofrece sus datos bajo la política de datos abiertos del Gobierno de España (Open Data / Reutilización de Información del Sector Público). Este Actor interactúa de forma eficiente y respetuosa con los servicios públicos sin requerir credenciales adicionales.

¿Los datos están actualizados?

Sí. El Actor consulta en tiempo real los servidores oficiales del INE, por lo que cualquier nota de prensa o publicación estadística recién emitida estará disponible de inmediato.

¿Puedo extraer series históricas completas?

Sí. Puedes configurar periodsCount: 0 para extraer la totalidad de observaciones disponibles desde el inicio de la serie histórica (en algunas series, desde 1961).

---

🌐 9. English Summary (Global Apify Store Overview)

Overview

INE Spain Official Statistics Scraper is the premier data extractor for Spain's National Statistics Institute (Instituto Nacional de Estadística - INE). It provides automated, normalized access to official macroeconomic, demographic, and real estate data.

Key Features

• 1-Click Presets: Immediate extraction of CPI/Inflation (IPC), Unemployment & Employment (EPA), Housing Price Index (IPV), Mortgages (HPT), GDP (PIB), Population/Census, and Tourism.
• Smart Keyword Search: Explore and extract from more than 112 official statistical operations.
• B2B-Ready Clean Data: Clean float numbers, ISO 8601 timestamps, complete categorical breakdowns, and territorial segmentation.
• AI & RAG Optimized: Ready to integrate with LLMs, Claude/GPT assistants via Apify Model Context Protocol (MCP), and ETL workflows in Make, Zapier, or n8n.