@br-validators/cli
Advanced tools
CLI for @br-validators/core — CPF, CNPJ, NF-e, IE, PIX, boleto + detect/sanitize/generate
Terminal CLI for all Brazilian document validators in @br-validators/core v1.8.3.
Repo: github.com/open-data-brazil/br-validators
npm install -g @br-validators/cli
Or run without install:
npx @br-validators/cli --help
br-validators list
br-validators --version
br-validators --help
br-validators cnpj validate 12ABC34501DE35 --json --source
br-validators cpf validate 12345678909
br-validators cep format 01310100
br-validators telefone validate 11999999999
br-validators cnh validate 62472927637
br-validators renavam validate 63977791104
br-validators titulo-eleitor validate 004356870906
br-validators nfe-chave validate 52060433009911002506550120000007800267301615 --json
br-validators nfe-chave parse 52060433009911002506550120000007800267301615 --json
br-validators brcode validate '<emv-payload>' --json
br-validators placa validate ABC1D23
br-validators pis-pasep validate 10027230888
br-validators pix validate pix@bcb.gov.br
br-validators boleto validate '03399.02579 08991.834006 71742.301014 6 14500000099668'
br-validators cartao validate 4111111111111111
br-validators cartao-credito validate 4111111111111111
br-validators ie validate 110042490114 --uf SP --json
br-validators ie validate P-01100424.3/002 --uf SP # SP produtor rural (auto-detect)
| Action | Description |
|---|---|
validate | Check format + check digits |
format | Apply official mask |
strip | Normalize to canonical digits/chars |
parse | NF-e chave, BR Code |
convert | Boleto linha ↔ barcode; placa legacy → Mercosul |
detect | PIX key type; boleto input kind; cartão brand |
| Command | Description |
|---|---|
detect [value] | Classify raw input; --uf for IE |
sanitize <type> [value] | ETL fixes + validate; --uf for inscricao-estadual |
generate <type> | Synthetic test document; --seed, --masked, --format |
Library-only platform APIs:
mask,compare,batch, anddiffare available via@br-validators/coresubpaths — no dedicated CLI commands yet.
br-validators detect '123.456.789-09' --json
br-validators detect '110042490114' --uf SP --json
br-validators sanitize cpf ' 123.456.789-09 ' --json
br-validators sanitize inscricao-estadual '110.042.490.114' --uf SP --json
br-validators generate cpf --seed 42 --masked --json
br-validators generate cnpj --format alphanumeric --seed 7 --json
br-validators generate placa --format mercosul --seed 3
Offline embedded datasets — delegates to @br-validators/core/*.
br-validators bancos lookup 001 --json
br-validators bancos lookup 18236120 --verbose
br-validators bancos list --limit 20 --json
br-validators natureza-juridica lookup 2062 --json
br-validators nbs lookup 1.1502.50.00 --verbose
br-validators cest lookup 0302100 --json
br-validators cnae lookup 6201501 --json
br-validators cnae search "web design" --limit 5
br-validators cfop lookup 1102 --json
br-validators cfop search compra --limit 5
br-validators ncm lookup 12011000 --json
br-validators ncm search soja --limit 5
br-validators cbo lookup 212405 --json
br-validators cbo search analista --limit 5
br-validators ibge lookup 3550308 --json
br-validators ibge list estados --limit 5
br-validators ibge list municipios --uf SP --limit 10 --json
br-validators tse-municipios lookup 71072 --verbose
br-validators feriados list --year 2026 --json
br-validators cep faixa 01310 --json
br-validators ddd lookup 11 --verbose
br-validators moedas lookup BRL --json
br-validators paises-bacen lookup 1058 --verbose
br-validators incoterms lookup FOB --json
br-validators portos lookup BRSSZ --json
br-validators aeroportos lookup GRU --verbose
br-validators aeroportos lookup SBGR --json
| Exit code | Meaning |
|---|---|
0 | Record found |
1 | Not found |
2 | Usage error |
| Flag | Description |
|---|---|
--json | JSON output |
--quiet / -q | Exit code only (CI) |
--file / -f | Read value from file |
--source | Print official source URL (per-type) |
--uf | Required for IE / detect / sanitize IE; optional filter for ibge list municipios |
br-validators cnpj validate "$CNPJ" --quiet || exit 1
br-validators detect "$RAW_INPUT" --json --quiet || exit 1
MIT
FAQs
CLI for @br-validators/core — CPF, CNPJ, NF-e, IE, PIX, boleto + detect/sanitize/generate
The npm package @br-validators/cli receives a total of 1,825 weekly downloads. As such, @br-validators/cli popularity was classified as popular.
We found that @br-validators/cli demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Malicious Chrome and Firefox extensions posed as free VPNs while stealing clipboard data through later extension updates.
Research
/Security News
Miasma Mini Shai-Hulud hits @immobiliarelabs Backstage plugins, targeting GitLab and LDAP auth packages on npm.
Security News
Rolldown paused Rust React Compiler integration after a 5MB binary size increase raised concerns about shipping React-specific code to all Vite users.