Open Economics

Servidor MCP gratuito y sin autenticación para datos económicos oficiales de Brasil, descubrimiento semántico y consultas que preservan la fuente.

GitHubPrueba este MCPPatrocinado

Documentación

API de Open Economics

Una capa de enrutamiento semántico gratuita y de solo lectura para datos económicos brasileños autoritativos.

API semántica: https://open-economics-data.knbf982hkn.chatgpt.site/api/v2
API de series estables: https://open-economics-data.knbf982hkn.chatgpt.site/api/v1
MCP: https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp
Pregunta a los datos: https://open-economics-data.knbf982hkn.chatgpt.site/en/ask
Configuración de MCP: https://open-economics-data.knbf982hkn.chatgpt.site/en/mcp
Instalador de agentes: llms-install.md
Documentación: https://open-economics-data.knbf982hkn.chatgpt.site/en/docs
Ejemplos ejecutables: https://open-economics-data.knbf982hkn.chatgpt.site/en/guides
Código fuente y seguimiento de problemas: https://github.com/felipegambettadesouza6-jpg/open-economics
Política de confiabilidad: RELIABILITY.md
Evidencia de la versión 2.0: benchmarks/RELEASE-READINESS.md
Contribuciones: CONTRIBUTING.md
Seguridad: SECURITY.md

Ejecuta una pregunta económica real → · Conecta el servidor MCP →

Open Economics 2.0 comienza con una necesidad real de información económica, resuelve su significado de manera independiente de la cobertura actual y luego la enruta a datos oficiales. Su catálogo sincronizado expone actualmente 12,875 series del BCB SGS y agregados del IBGE, además de acceso directo a informes fiscales SICONFI, Comex Stat del MDIC y precios de combustibles de la ANP, y datos versionados de consumo eléctrico de EPE, Novo Caged del MTE, fondos de inversión de CVM, fiscales RTN de Tesouro y deuda pública federal RMD (12,886 conjuntos de datos oficiales en total). Los 32 IDs de series v1 convenientes siguen siendo compatibles.

El descubrimiento, REST, el producto existente y MCP comparten un núcleo semántico. Un concepto resuelto se mantiene separado de la disponibilidad, por lo que una necesidad no soportada se informa explícitamente en lugar de mapearse silenciosamente a una serie cercana. Unidades, dimensiones, períodos de referencia, identificadores de fuente, valores brutos, enlaces de metodología y procedencia de recuperación viajan con los datos.

Comienza con la necesidad económica

curl --fail --silent \
  "https://open-economics-data.knbf982hkn.chatgpt.site/api/v2/search?q=desemprego%20desde%202015"

curl --fail --silent \
  "https://open-economics-data.knbf982hkn.chatgpt.site/api/v2/datasets/ibge-aggregates%3A6381/schema"

Para BCB, /api/v2/datasets/bcb-sgs:{code}/observations proporciona acceso directo a series con metadatos autoritativos de frecuencia, unidad, fuente, cobertura, fórmula y advertencias. Para IBGE, inspecciona /schema, luego envía selecciones explícitas de variable, periods, locality y classification a /observations. SICONFI DCA, RREO y RGF usan las mismas rutas de conjuntos de datos mientras conservan la entidad, el período de informe, el anexo, la cuenta, la columna y el valor bruto. La estructura multidimensional oficial se preserva en lugar de aplanarse. Comex Stat conserva las dimensiones y métricas del flujo comercial. Las consultas de precios de combustibles de ANP devuelven agregados de período/geografía/producto calculados a partir de observaciones oficiales de estaciones, con recuentos de fuentes y la transformación divulgada, mientras que la identidad de la estación y los campos de dirección se excluyen. EPE y MTE sirven instantáneas compactas y versionadas de libros de trabajo oficiales: la electricidad conserva geografía/clase/mercado, mientras que las existencias y flujos ajustados de Novo Caged conservan sus desgloses separados por total nacional, región/estado o actividad económica. Los informes diarios de fondos de CVM conservan la identidad de fondo/clase y los valores de cuota; los agregados de clasificación suman solo medidas aditivas e identifican fechas de presentación incompletas. RTN conserva su jerarquía de cuentas mensual y las convenciones de pago en efectivo/ efectivo por encima de la línea. Las estadísticas de deuda de RMD mantienen tablas separadas de composición, tenedores, vencimiento y costo, con sus unidades, definiciones y versión de publicación oficiales.

Cuándo usar Open Economics

Si ya conoces el identificador oficial exacto y el contrato de fuente, llamar directamente al editor sigue siendo el camino más corto. Open Economics es útil cuando la necesidad comienza en lenguaje humano, abarca convenciones de editores, requiere dimensiones explícitas o debe conservar un modelo consistente de procedencia y errores.

Un contrato para todas las fuentes oficiales

El mismo envoltorio de observación puede recuperar el IBC-Br del BCB (SGS 24363) y el crecimiento real del PIB del IBGE (SIDRA 5932/6561), sin mantener dos analizadores de fechas y respuestas:

curl --fail --silent "https://open-economics-data.knbf982hkn.chatgpt.site/api/v1/indicators/br-ibc-br/observations?start=2024-01-01"
curl --fail --silent "https://open-economics-data.knbf982hkn.chatgpt.site/api/v1/indicators/br-gdp-real-yoy/observations?start=2024-01-01"

El ejemplo de Python de múltiples fuentes ejecutable usa ambas series e imprime su procedencia oficial y estado de actualización.

Comienza con el catálogo

curl --fail --silent "https://open-economics-data.knbf982hkn.chatgpt.site/api/v1"
curl --fail --silent "https://open-economics-data.knbf982hkn.chatgpt.site/api/v1/indicators?q=ipca&source=ibge"
curl --fail --silent "https://open-economics-data.knbf982hkn.chatgpt.site/api/v1/indicators/br-ipca-monthly"

GET /api/v1/indicators es el endpoint de descubrimiento. Su campo meta.available_filters enumera cada valor canónico de category, frequency y source. Acepta:

Parámetro	Significado
`q`	Búsqueda que no distingue mayúsculas y minúsculas en IDs, nombres, alias y códigos oficiales
`category`	Un ID de categoría canónico como `inflation` o `interest-rates`
`frequency`	`daily`, `monthly`, `quarterly` o `annual`
`source`	`bcb` o `ibge`
`limit`	1–500, predeterminado 100

Los filtros no válidos se rechazan con una respuesta de problema estructurada; nunca se convierten silenciosamente en un conjunto de resultados vacío.

Recuperar una serie

curl --fail --silent \
  "https://open-economics-data.knbf982hkn.chatgpt.site/api/v1/indicators/br-ipca-monthly/observations?start=2024-01-01&end=2024-12-31"

curl --fail --silent \
  "https://open-economics-data.knbf982hkn.chatgpt.site/api/v1/indicators/br-selic-target/observations?start=2025-01-01&order=desc&limit=12"

curl --fail --silent \
  "https://open-economics-data.knbf982hkn.chatgpt.site/api/v1/indicators/br-selic-target/latest"

Las solicitudes de observación aceptan start, end, order=asc|desc, limit=1..5000 y format=json|csv. Las fechas usan YYYY-MM-DD y end no puede estar en el futuro. Las solicitudes diarias de BCB están limitadas a diez años porque SGS aplica el mismo límite aguas arriba.

Todas las respuestas JSON de series usan el mismo envoltorio:

{
  "data": [
    {
      "date": "2024-01-01",
      "period": "2024-01",
      "source_date": "202401",
      "value": 0.42,
      "raw_value": "0.42",
      "status": "observed"
    }
  ],
  "meta": {
    "indicator": { "id": "br-ipca-monthly", "unit_symbol": "%" },
    "provenance": { "upstream_url": "…", "retrieved_at": "…" },
    "returned": 1,
    "available": 1,
    "truncated": false
  }
}

date es la fecha de inicio normalizada para el período de referencia; period es el identificador consciente de frecuencia (YYYY-MM-DD, YYYY-MM, YYYY-QN o YYYY). source_date y raw_value se conservan exactamente del editor oficial. Lee meta.indicator.date_semantics antes de interpretar series de existencias, flujos o trimestres móviles.

Usa format=csv para una descarga plana. Las filas CSV repiten indicator_id, source_id, source_url y upstream_url, por lo que los valores exportados conservan su procedencia fuera del envoltorio JSON.

Superficie de la API

Endpoint	Propósito
`GET /api/v1`	Descubrimiento de API legible por máquina
`GET /api/v1/indicators`	Buscar y filtrar el catálogo de indicadores
`GET /api/v1/indicators/:id`	Metadatos completos del indicador, unidades, semántica y enlaces
`GET /api/v1/indicators/:id/observations`	Valores históricos normalizados
`GET /api/v1/indicators/:id/latest`	Observación más reciente disponible
`GET /api/v1/sources`	Metadatos de editor, atribución y licencia
`GET /api/v1/openapi.json`	Descripción OpenAPI 3.1
`GET /api/v1/health`	Preparación del enrutador y catálogo (no llama a editores)

Todos los endpoints admiten CORS y GET, HEAD y OPTIONS. Las respuestas exitosas y de error incluyen X-Request-Id; los clientes de navegador también pueden leer encabezados de caché, tiempo y respuesta obsoleta.

Errores y actualización

Los errores usan application/problem+json con un code estable, HTTP status, title legible por humanos, detail explicativo y request_id. Los casos comunes incluyen INVALID_DATE, INVALID_CATEGORY, INDICATOR_NOT_FOUND, UPSTREAM_CONNECTION_ERROR y UPSTREAM_TIMEOUT.

La API almacena en caché las respuestas de fuente normalizadas exitosamente en D1 cuando está configurada. Si una actualización falla y existe una instantánea coincidente anterior, se devuelve con meta.stale: true, meta.cache: "stale" y HTTP Warning: 110. Una falla de lectura o escritura de caché se trata como una omisión de caché, nunca como una falla de datos.

El servicio es actualmente de mejor esfuerzo y no tiene SLA de disponibilidad. Consulta RELIABILITY.md para la política explícita de disponibilidad, actualización, gestión de cambios y notificación de incidentes.

Fuentes y corrección

Agregados IBGE/SIDRA: precios, PIB, industria, comercio minorista, servicios, trabajo. El adaptador solicita los IDs de período oficiales exactos requeridos para cada consulta; los símbolos de cero, supresión, disponibilidad y calidad de IBGE mantienen valores status distintos.
BCB SGS: tasas, FX, actividad, crédito, fiscal, sector externo y series de materias primas. Las filas se normalizan, ordenan y deduplican porque el orden aguas arriba no está garantizado.
Tesouro Nacional / SICONFI: cuentas anuales, ejecución presupuestaria, límites fiscales, gasto de personal, deuda y el registro de entidades gubernamentales.
Tesouro Nacional / RTN: ingresos centrales del Gobierno de valor mensual actual, transferencias, gastos y cuentas de resultado fiscal desde 1997, en la jerarquía oficial y en la unidad de R$ millones.
Tesouro Nacional / RMD: composición mensual de la deuda pública federal, tenedores de DPMFi, vencimiento promedio y costo. Cada tabla oficial mantiene su propia unidad, cobertura, definiciones, notas al pie y versión de publicación.
MDIC / Comex Stat: exportaciones e importaciones por producto, socio, estado, modo de transporte, oficina aduanera y clasificaciones internacionales.
ANP / Levantamento de Preços de Combustíveis: observaciones móviles de cuatro semanas o mensuales de estaciones de combustible y GLP, agregadas por período explícito, producto y geografía con procedencia de cálculo.
EPE / Consumo Mensal de Energia Elétrica: consumo mensual y recuentos de consumidores desde 2004 por UF, región, clase y mercado cautivo/libre, con la versión oficial del libro de trabajo adjunta.
MTE / Novo Caged: existencias de empleo mensuales ajustadas, admisiones, despidos, saldo y cambio relativo desde 2020 por total nacional, región/estado o actividad económica, con la versión oficial exacta del libro de trabajo adjunta y las dimensiones de tabla incompatibles mantenidas separadas.
CVM / Informe Diário de Fundos: valor de cartera diario, activos netos, suscripciones, reembolsos, valores de cuota y tenedores informados. Las consultas pueden comparar clasificaciones oficiales o resolver un informe de fondo/clase más reciente por CNPJ o nombre; los valores de cuota nunca se agregan y los totales de tenedores no se representan como personas únicas.

Hay 32 indicadores curados en inflación, tasas de interés, monedas, actividad, trabajo, crédito, fiscal, externo y mercados. Los valores nunca se fabrican, se completan hacia adelante ni se invierten de signo silenciosamente. Las series fiscales NFSP de BCB conservan la convención de signo de requisito de financiamiento de BCB.

Los datos del catálogo de BCB se publican bajo ODbL; conserva su atribución y obligaciones de compartir por igual al distribuir bases de datos adaptadas. Atribuye a IBGE como IBGE/SIDRA y conserva sus enlaces de fuente y términos. Cada respuesta de indicador tiene las URLs autoritativas y la licencia aplicable a esa serie.

Ejecutar localmente

Se requiere Node.js 22.13+.

npm install
npm run dev
npm run lint
npm test
npm run catalog:epe-sync
npm run catalog:mte-sync
npm run catalog:cvm-sync
npm run catalog:rtn-sync
npm run catalog:dpf-sync

Los ejemplos están disponibles en examples/python.py, examples/multi_source_python.py y examples/javascript.mjs. La migración D1 en drizzle/ es el registro de implementación para instantáneas de caché.

Licencia

La implementación de la API se publica bajo la Licencia MIT. Los datos aguas arriba permanecen regidos por los términos y licencias de cada editor.