n8n-nodes-brasilapi
Version:
Community node n8n para acessar a BrasilAPI (CEP, CNPJ, Bancos, Taxas etc.)
61 lines (45 loc) • 2.57 kB
Markdown
# n8n-nodes-brasilapi
Node da comunidade **n8n** que expõe todos os principais endpoints públicos da **[BrasilAPI](https://brasilapi.com.br)** dentro do seu workflow – sem necessidade de credenciais.
---
## Visão geral
| Recurso | Operações disponíveis |
|---------|----------------------|
| **CEP** | `v1`, `v2` |
| **DDD** | `byDdd` |
| **Banks** | `list`, `byCode` |
| **Câmbio** | `moedas`, `cotacao` |
| **CNPJ** | `byCnpj` |
| **Corretoras (CVM)** | `corretoras`, `corretoraByCnpj` |
| **CPTEC / INPE** | cidades, buscaCidade, climaCapital, climaAeroporto, climaPrevisao (1 dia ou N dias), ondas (1 dia ou N dias) |
| **Feriados** | `byYear` |
| **FIPE** | `marcas`, `veiculos`, `preco`, `tabelas` |
| **IBGE** | `ufs`, `ufByCode`, `municipios` |
| **ISBN** | `byIsbn` |
| **NCM** | `list` (com filtro), `byCode` |
| **PIX** | `participants` |
| **Registro.br** | `domain` |
| **Taxas / Índices** | `list`, `bySigla` |
> *Todos os endpoints são públicos; não há autenticação nem limitação de credenciais.*
---
## Como funciona
1. **Resource** – escolha o serviço (CEP, FIPE, etc.).
2. **Operation** – o node carrega automaticamente as operações válidas para o recurso.
3. **Route Params (JSON)** – informe os parâmetros de rota exigidos, por exemplo:
```json
{ "cep": "01001000" }
```
4. **Extra Query (JSON)** – opcional, para filtros adicionais (ex.: `{ "search": "3305.10" }`).
O node monta o endpoint correto, faz a requisição à BrasilAPI e devolve o **JSON** pronto para uso nas etapas seguintes do seu workflow.
---
## Exemplos rápidos
| Objetivo | Configuração mínima |
| ------------------------------- | ----------------------------------------------------------------- |
| Dados do **Banco 237** | Resource `banks` → Operation `byCode` → Route `{ "code": 237 }` |
| Cotação **USD** em `2025-02-13` | `cambio` → `cotacao` → `{ "moeda": "USD", "data": "2025-02-13" }` |
| Preço FIPE código **001004-9** | `fipe` → `preco` → `{ "codigoFipe": "001004-9" }` |
| Status domínio **n8n.io** | `registrobr` → `domain` → `{ "domain": "n8n.io" }` |
---
## Contribuindo
Sinta-se à vontade para abrir *issues* ou enviar *pull requests* com novos endpoints, correções ou sugestões de melhoria.
Este projeto segue a licença **MIT**.