Instalação rápida
Para a maioria dos agentes (Claude Code, Cursor, Codex, Windsurf, etc.), rode no diretório do seu projeto:.claude/skills/, .cursor/skills/, etc.) automaticamente.
Usando Claude.ai na web ou no desktop? A interface web não roda
npx. Siga o guia
Instalar no Claude manualmente para fazer o upload do ZIP diretamente.Configuração
- Crie uma conta grátis em cnpj-api.com e gere um token.
- Exporte o token como variável de ambiente:
O que está incluído
Cobertura completa da cnpj-api via 8 endpoints:| Endpoint | Plano | Descrição |
|---|---|---|
GET /v1/cnpj/{cnpj} | free+ | Dados completos da empresa |
POST /v1/bulk-cnpj | pro | Consulta em lote (até 20) |
GET /v1/simples/{cnpj} | free+ | Status Simples Nacional e SIMEI |
GET /v1/socios/{pessoaId} | free+ | Perfil do sócio e participações |
GET /v1/cidades/{id} | free+ | Agregados por município (IBGE) |
GET /v1/cnae/{cnae} | free+ | Agregados por atividade econômica |
GET /v1/usage | free+ | Plano atual e rate limit |
validate-cnpj.ts e bulk-lookup.ts).
Como usar
Depois de instalada, peça ao agente em linguagem natural:Consulta simples
“Consulte o CNPJ 82.845.322/0001-04”
Simples Nacional
“Essa empresa é Simples Nacional?”
Sócios
“Me dá os sócios dessa empresa”
Consulta em lote
“Enriquece essa lista de 50 CNPJs”
api-token automaticamente.
Compatibilidade
Funciona com qualquer agente que suporte o formato Agent Skills:Claude Code
Cursor
Codex
Windsurf
OpenCode
Amp
Antigravity
+35 outros
Limites e planos
Veja planos e preços em cnpj-api.com/precos. Consulta em lote (/v1/bulk-cnpj) requer o plano Pro.
Código aberto
A skill é MIT e pública:- Repositório: github.com/cnpj-api/skills
- Especificação Agent Skills: agentskills.io
Próximos passos
Instalar no Claude manualmente
Guia passo a passo para Claude.ai (web e desktop) com upload de ZIP.
Repositório no GitHub
Ver o código da skill, SKILL.md, referências e scripts.