usebcch

Acceso reproducible a las series estadísticas del Banco Central de Chile desde Stata.

Descripción

Este repositorio contiene la implementación nativa para Stata del acceso a la Base de Datos Estadísticos (BDE) del Banco Central de Chile (BCCh). usebcch descarga una o varias series, busca códigos en el catálogo y ofrece transformaciones, caché y metadatos sin depender de la integración de Python.

La implementación Stata es independiente y no constituye un producto oficial del Banco Central de Chile.

Implementación en Python

El Banco Central de Chile también publica el comando Python bcchapi para utilizar su API BDE. Este repositorio no duplica ese código: usebcch es la implementación nativa equivalente para usuarios de Stata.

Para instalar la implementación Python:

pip install bcchapi

Ayuda: bcchapi en PyPI · ejemplos oficiales de la API BDE

La API Python y usebcch requieren una cuenta propia del portal BDE/SI3.

Implementación en Stata

Requiere Stata 16 o superior y acceso HTTPS.

Instalación desde el repositorio:

net install usebcch, ///
    from("https://raw.githubusercontent.com/MaykolMedrano/usebcch/main/stata") replace

Para probar una copia local durante el desarrollo, sustituya la URL por la ruta de su carpeta stata/. En ambos casos, from() debe apuntar al directorio que contenga stata.toc y usebcch.pkg, no a una página HTML ni a un archivo ZIP.

Ayuda: guía de usuario · ayuda de Stata · especificación técnica · guía de distribución

Replicación: suite de pruebas Stata

Credenciales BDE/SI3

La documentacion publica del BCCh describe crear una cuenta en BDE y activar las credenciales de la API. usebcch admite ese formato heredado mediante BCCH_USER y BCCH_PASSWORD. Algunas cuentas tambien muestran un API Key Token en Mi Cuenta > Apikey Token; en ese caso puede usar BCCH_TOKEN (o el alias APIKEY), token() o un archivo de una sola linea con el token.

Para el formato entregado por su cuenta, guarde las credenciales en un archivo .env privado:

BCCH_TOKEN=mi_api_key_token

O, si el portal entrega usuario y contrasena:

BCCH_USER=mi_usuario
BCCH_PASSWORD=mi_contrasena

Registre la ruta una sola vez en Stata:

usebcch auth set, envfile("C:/private/bcch.env")
usebcch auth status

usebcch guarda unicamente la ruta; nunca copia ni distribuye secretos. La API limita a cinco series por segundo por cuenta, independientemente de la IP.

Ejemplos

* Una serie diaria
usebcch get F073.TCO.PRE.Z.D, from(2024-01-01) to(2024-12-31) clear

* Varias series con nombres legibles
usebcch get F073.TCO.PRE.Z.D F022.TPM.TIN.D001.NO.Z.D, ///
    names(dolar tpm) from(2024-01-01) clear

* Conversión mensual y variación interanual
usebcch get F073.TCO.PRE.Z.D, names(dolar) from(2020-01-01) ///
    frequency(monthly) aggregate(mean) variation(12) clear

* Búsqueda del catálogo
usebcch search "IPC", frequency(monthly) language(es) clear

Pruebas y distribución

Desde la raíz del repositorio, con StataNow 19 configurado en C:\Program Files\StataNow19\StataSE-64.exe:

powershell -ExecutionPolicy Bypass -File stata/scripts/run-tests.ps1

Para preparar una distribución Stata:

powershell -ExecutionPolicy Bypass -File stata/scripts/build-release.ps1

Estructura del repositorio

usebcch/
├── stata/
│   ├── README.md                   guía del runtime Stata
│   ├── *.ado, *.mata, *.sthlp      runtime nativo instalable
│   ├── stata.toc, usebcch.pkg  sitio net install
│   ├── tests/                   pruebas y fixtures
│   ├── docs/                    documentación Stata
│   └── scripts/                 pruebas y distribución
├── CHANGELOG.md
├── LICENSE
└── README.md

La fuente y el comportamiento de referencia se basan en el código público MIT de bcchapi, mientras que el transporte HTTP, el parser JSON y la materialización de datasets son nativos de Stata/Mata.

Fuente oficial

• Banco Central de Chile
• Documentación técnica de la API BDE
• Términos y condiciones
• Portal BDE/SI3

Autor

Maykol Medrano
Pontificia Universidad Católica de Chile
Email: [email protected]
GitHub: MaykolMedrano

Licencia

MIT. Consulte LICENSE.