Metadata-Version: 2.4
Name: bccr
Version: 2026.8.22
Summary: Herramientas para descargar datos del Banco Central de Costa Rica
Home-page: http://randall-romero.com/code/bccr
Author: Randall Romero-Aguilar
Author-email: randall.romero@outlook.com
License: MIT
Keywords: BCCR datos
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: pandas>=3.0.0
Requires-Dist: numpy
Requires-Dist: anytree
Requires-Dist: requests
Provides-Extra: gui
Requires-Dist: dash>=2.2.0; extra == "gui"
Requires-Dist: plotly; extra == "gui"
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# bccr

## Una API de Python para descargar datos del Banco Central de Costa Rica

El propósito de este paquete es proveer herramientas para buscar y descargar indicadores publicados por el [Banco Central de Costa Rica](https://www.bccr.fi.cr/).


**AVISO**: En 2026 el BCCR discontinuó el servicio web y las páginas web, en favor de un nuevo sitio de indicadores económicos.  Esta nueva versión (agosto 2026) facilita la descarga de datos y de cuadros del nuevo servicio (SDDE).  

Para hacer esta actualización lo menos disruptiva posible, `SW` ha sido redefinido para tomar los mismos códigos que el anterior servicio web. No obstante, de momento no hay soporte para los parámetros `func`, `freq` y `fillna`.  Además, aún no es posible crear árboles de jerarquía de indicadores. Además, aún no está disponible la interfase gráfica (módulo GUI).



El paquete ofrece una clases para buscar datos y descargarlos:

* **ServicioWeb:** descarga indicadores individuales y cuadros del [nuevo sitio de indicadores económicos](https://sdd.bccr.fi.cr/es/IndicadoresEconomicos/Inicio/) del Banco Central.


Los datos se descargan y se presentan en una tabla de `pandas`, en la cual cada fila corresponde a un período (día, mes, trimestre, año) y cada columna a un indicador. 

### Usando ServicioWeb 

Primero importamos una instancia de `ServicioWeb` llamada `SW` 

    from bccr import SW      


Conociendo los códigos de los indicadores, se descargan los datos con

    SW(nombre1=codigo1, nombre2=codigo2, ..., nombreN=codigoN)    

En la línea anterior, `nombre1`, `nombre2`, y `nombreN` son los nombres que se desea dar a los indicadores, y `codigo1`, `codigo2`, y `codigoN` son números enteros que identifican a esos indicadores en el Servicio Web.



El resultado se presenta como una tabla de datos de [`pandas`](https://pandas.pydata.org/), en la que cada fila es un período (día,mes, trimestre, año) y cada columna un indicador, con nombres `[nombre1, nombre2, ..., nombreN]`. 

Para buscar los códigos de los indicadores se usa el método `buscar`:

    SW.buscar("descripción tiene todas estas palabras") 
    SW.buscar(frase="descripción contiene esta frase exacta")
    SW.buscar(algunos="descripción tiene alguna de estas palabras")


Próximamente se proveerá una documentación completa y funcionalidad adicional.



## Aviso importante

Este paquete no es un producto oficial de BCCR. El autor lo provee para facilitar el manejo de datos, pero no ofrece ninguna garantía acerca de su correcto funcionamiento. 


