Skip to contents

databcrd

databcrd es un paquete de R para descargar, limpiar e importar los datos que publican el Banco Central de la República Dominicana (BCRD) y otras de fuentes internacionales que se usan a menudo junto a ellos (FMI, EIA, BCE, China NBS y World Gold Council).

En lugar de enlaces a Excel, adivinar hojas y nombres de columnas, o mantener scripts de scraping frágiles cada vez que el BCRD cambia el formato de un archivo, databcrd expone una función por serie con una interfaz consistente y datos ya limpios en formato tidy.

Instalación

El paquete todavía no está en CRAN. Instala la versión de desarrollo desde GitHub:

# install.packages("remotes")
remotes::install_github("Johan-rosa/databcrd")

Uso rápido 

library(databcrd)
 
# Indicador Mensual de Actividad Económica (IMAE)
get_imae()
 
# Tipo de cambio spot
get_tc_spot()
 
# Tasa de Política Monetaria
get_tpm()
 
# Inflación (IPC), a nivel general o por desagregaciones
get_ipc_data("general")
get_ipc_data("subyacente")

Cada función retorna un tibble, listo para encadenar con dplyr, graficar con ggplot2 o convertir a serie de tiempo con tsibble.

Fuentes de datos

Fuente Cobertura en el paquete
BCRD Cuentas nacionales, precios, tipo de cambio, tasas de interés, sector externo, sector fiscal, sector monetario y financiero
FMI (imf.data) Inflación (IPC) comparada entre países, vía SDMX-CSV
EIA (EE. UU.) Precio spot del petróleo WTI
BCE Inflación (HICP), crecimiento del PIB real y desempleo de la eurozona
China NBS (data.stats.gov.cn) Índice de Precios al Consumidor de China
World Gold Council Precio mensual del oro desde 1833, y precio spot actual

Referencia de funciones

Cuentas nacionales y actividad real

Función Descripción
get_imae() IMAE, base 2018
get_imae_2007() IMAE, base 2007
get_pib_gasto() PIB por el enfoque del gasto (real y nominal)
get_pib_gasto_2007() PIB por el enfoque del gasto, base 2007
get_pib_sectores() PIB por sector de origen (real y nominal)
get_pib_sectores_2007() PIB por sector de origen, base 2007
get_fbkf() Formación bruta de capital fijo por sector y tipo de bien
costo_canasta_familiar() Costo de la canasta familiar

Precios e inflación

Función Descripción
get_ipc_data() IPC por desagregación: general, grupos, regiones, subyacente, TNT
get_ipc_articulos() IPC a nivel de artículo
get_ipc_long() IPC en formato largo
imf_inflation() Inflación (IPC) del FMI para uno o varios países
china_cpi() IPC de China (portal de la NBS)
ze_inflation() Inflación (HICP) de la eurozona
get_expectativas() Encuesta de expectativas macroeconómicas

Tipo de cambio

Función Descripción
get_tc() / get_tc_eif() Tipo de cambio promedio de las operaciones en entidades de intermediación financiera
get_tc_spot() Tipo de cambio en el mercado spot

Tasas de interés y política monetaria

Función Descripción
get_tpm() Tasa de Política Monetaria y tasas de corto plazo asociadas
get_tasas_activas() Tasas de interés activas (préstamos)
get_tasas_pasivas() Tasas de interés pasivas (ahorros)
get_tasas_diarias() Tasas de interés diarias del BCRD
get_tasas_semanales() Tasas de interés semanales del BCRD
get_tasas_reales() Tasas de interés reales de los intermediarios financieros
get_tasa_interbancaria() Tasas promedio de operaciones interbancarias por plazo
tasas_to_long() Convierte tablas de tasas de formato ancho a largo
get_encaje() Serie de encaje legal

Sector externo

Función Descripción
get_exportaciones() Exportaciones totales por sector
get_exportaciones_zf() Exportaciones de zonas francas
get_importaciones() Importaciones totales por sector
get_importaciones_petroleo() Importaciones de petróleo
get_remesas() Remesas recibidas
get_ied() Inversión extranjera directa
get_reservas_internacionales() Reservas y activos del banco central
get_embi() EMBI (riesgo país) a distintas periodicidades

Sector fiscal y monetario

Función Descripción
fiscal_operations() Operaciones fiscales
fiscal_operations_gdp() Operaciones fiscales como % del PIB
get_indicadores_monetarios_bcrd() Indicadores monetarios del BCRD
operaciones_monetarias() Operaciones monetarias
indicadores_osd() Indicadores de Otras Sociedades de Depósito (OSD)
get_prestamos_osd() Préstamos por sector de las OSD

Series internacionales de referencia

Función Descripción
gold_price() Precio mensual del oro desde 1833
today_gold_price() Precio spot del oro (requiere GOLDAPI_KEY)
wti_price() Precio spot del petróleo WTI (requiere EIA_KEY)
ze_gdpg() Crecimiento del PIB real de la eurozona
ze_unemployment() Tasa de desempleo de la eurozona

Utilidades

Función Descripción
crear_mes() Recodifica meses
date_label() Construye etiquetas de fecha legibles
rescale() Reescala un vector

Variables de entorno

Algunas fuentes requieren una API KEY propia del usuario. Configúralas en tu .Renviron:

EIA_KEY=tu_llave_de_eia
GOLDAPI_KEY=tu_llave_de_goldapi

Artículos y documentación

El sitio del paquete, generado con pkgdown, incluye la referencia completa de funciones y artículos de uso (por ejemplo, vignette("ipc_data") para trabajar con las distintas desagregaciones del IPC):

https://johan-rosa.github.io/databcrd/

Diseño del paquete

  • Cada función de descarga sigue el mismo patrón: construir la solicitud con httr2, ejecutarla a través de un wrapper centralizado con manejo de errores (tryCatch() + condiciones de rlang::abort()), y devolver un tibble ya limpio con dplyr/janitor/lubridate.
  • Las funciones están documentadas con roxygen2, incluyendo ejemplos ejecutables.
  • Cuando una fuente expone una API interna o no oficial (como el portal de datos de la NBS de China), la lógica de bajo nivel (encabezados, sesión, parsing del árbol de nodos) vive en funciones internas separadas de la función exportada, para que el punto de entrada público se mantenga simple.

Contribuir

Los issues y pull requests son bienvenidos. Antes de abrir un PR, corre:

devtools::document()
devtools::test()
lintr::lint_package()

Licencia

MIT © Johan Rosa, Juan Quiñones