@crafter/bcrp-cli

CLI agent-first para consultar series macroeconomicas oficiales de BCRPData.

  ██████╗  ██████╗██████╗ ██████╗
  ██╔══██╗██╔════╝██╔══██╗██╔══██╗
  ██████╔╝██║     ██████╔╝██████╔╝
  ██╔══██╗██║     ██╔══██╗██╔═══╝
  ██████╔╝╚██████╗██║  ██║██║
  ╚═════╝  ╚═════╝╚═╝  ╚═╝╚═╝

  v0.1.0 · Official BCRPData macro series · agent-first

Instalacion

bun add -g @crafter/bcrp-cli

Desde el repositorio:

bun install
bun bcrp-cli --help

Inicio rapido

bcrp-cli status --json

{"ok":true,"status":"ok","auth":"public-no-auth"}

bcrp-cli fx usd --side sell --latest --json

{"ok":true,"pair":"USD/PEN","seriesCode":"PD04638PD","latest":{"date":"2026-04-21","value":3.43807142857143,"unit":"PEN_PER_USD"}}

bcrp-cli inflation latest --indicator headline --json

{"ok":true,"indicator":"headline","seriesCode":"PN01273PM","latest":{"date":"2026-03","value":3.80454581291585,"unit":"PERCENT_12M"}}

Comandos

bcrp-cli series get <codes...> [--from <period>] [--to <period>] [--latest]
bcrp-cli fx usd [--latest] [--from <period>] [--to <period>] [--kind interbank] [--side buy|sell|auto]
bcrp-cli inflation latest [--indicator headline|core|expectations|cpi]
bcrp-cli metadata search <query> [--frequency daily|monthly|quarterly|annual] [--limit <n>]
bcrp-cli schema <series|fx|inflation|metadata|error|doctor>
bcrp-cli status
bcrp-cli doctor

Todos los comandos aceptan --json, --output auto|json|table|ndjson, --params, --dry-run, --fields, --lang, --quiet y --verbose.

Salida para agentes

--json imprime un envelope JSON estable. --output ndjson imprime filas una por linea cuando el resultado puede tratarse como stream.

bcrp-cli series get PD04638PD --from 2026-04-01 --to 2026-04-08 --output ndjson

{"code":"PD04638PD","period":"01.Abr.26","date":"2026-04-01","value":3.459,"source":"BCRPData"}
{"code":"PD04638PD","period":"06.Abr.26","date":"2026-04-06","value":3.42964285714286,"source":"BCRPData"}

webctl

El IR de recon esta incluido en packages/cli/webctl.json.

webctl install ./packages/cli/webctl.json

Legal

@crafter/bcrp-cli is an unofficial command-line adapter for public BCRPData statistical series. It is not affiliated with or endorsed by the Banco Central de Reserva del Peru. Data is retrieved from official public BCRPData endpoints when available and should be cited as BCRPData. This tool provides data access only and does not provide financial, tax, legal, or investment advice.

Licencia

MIT