# n8n-nodes-brasilapi

![npm](https://img.shields.io/npm/v/n8n-nodes-brasilapi?color=blue)  
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**.