n8n-nodes-kipflow

Este é um node customizado do n8n para enriquecimento de dados de empresas brasileiras usando CNPJ através da API do Kipflow.

Instalação

Para uso no n8n

Instalação via npm (Community Node)

1. No n8n, vá em Settings > Community Nodes
2. Clique em Install Community Node
3. Digite: n8n-nodes-kipflow
4. Clique em Install

Instalação manual

npm install n8n-nodes-kipflow

Para desenvolvimento

# Clone o repositório
git clone https://github.com/Kipflow/n8n-kipflow-node.git
cd n8n-kipflow-node

# Instale as dependências
npm install

# Compile o projeto
npm run build

# Para desenvolvimento com watch mode
npm run dev

Configuração

1. Obtenha sua API Key em Kipflow
2. No n8n, adicione uma nova credencial do tipo "Kipflow API"
3. Cole sua API Key

Uso

O node Kipflow CNPJ Enrichment enriquece dados de empresas brasileiras usando o CNPJ.

Parâmetros

• CNPJ: O CNPJ da empresa (com ou sem formatação)
• Datasets: Selecione os datasets que deseja obter:
  • Básico (R$ 0,02) - Dados básicos da empresa
  • Completo (R$ 0,24) - Dados completos
  • Endereço (R$ 0,07) - Informações de endereço
  • Presença Online (R$ 0,12) - Website, redes sociais, etc.
  • Sócios (R$ 0,08) - Informações sobre os sócios

Exemplo de Resposta

{
  "success": true,
  "data": {
    "cnpj": "12345678000190",
    "razao_social": "Empresa Exemplo LTDA",
    "nome_fantasia": "Exemplo",
    "situacao": "ATIVA",
    ...
  }
}

Scripts disponíveis

Desenvolvimento

• npm run build - Compila o projeto
• npm run dev - Compila em modo watch
• npm run lint - Verifica problemas no código
• npm run lint:fix - Corrige problemas automaticamente
• npm run format - Formata o código

Versionamento (após commit das alterações)

• npm run release:patch - Correções de bugs (1.0.1 → 1.0.2)
• npm run release:minor - Novas funcionalidades (1.0.1 → 1.1.0)
• npm run release:major - Breaking changes (1.0.1 → 2.0.0)

Desenvolvimento e Contribuição

Para contribuir com o projeto ou fazer releases, consulte o Guia de Contribuição.

O guia inclui:

• 🛠️ Como configurar o ambiente de desenvolvimento
• 🚀 Fluxo completo de versionamento e releases
• 📝 Padrões de código e commits
• ✅ Checklist antes de fazer um release

Estrutura do Projeto

n8n-nodes-kipflow/
├── credentials/
│   ├── KipflowApi.credentials.ts
│   └── DrivaSearchApi.credentials.ts
├── nodes/
│   └── KipflowCnpjEnrichment/
│       ├── KipflowCnpjEnrichment.node.ts
│       ├── KipflowCnpjEnrichment.node.json
│       └── kipflow-logo.svg
├── dist/                      # Arquivos compilados
├── package.json
├── tsconfig.json
├── gulpfile.js
├── .eslintrc.js
├── .prettierrc
└── README.md

Licença

MIT

Suporte

• Documentação: https://docs.kipflow.io
• Issues: https://github.com/Kipflow/n8n-kipflow-node/issues