Skip to main content
The official Agent Skill from cnpj-api.com for AI coding agents (Claude Code, Cursor, Codex, Windsurf, OpenCode, and 40+ others). Installs a knowledge pack your agent already knows how to use: authentication, endpoints, error handling, and CNPJ formatting are all pre-configured.
One-command install and the agent using the skill

​
Quick install

For most agents (Claude Code, Cursor, Codex, Windsurf, etc.), run in your project directory: 
npx skills add cnpj-api/skills
The CLI places the files in the right folder for your agent (.claude/skills/, .cursor/skills/, etc.) automatically.
Using Claude.ai on the web or desktop? The web app can’t run npx. Follow the Install on Claude manually guide to upload the ZIP directly.

​
Setup

  1. Create a free account at cnpj-api.com and generate a token.
  2. Export the token as an environment variable:
export CNPJ_API_TOKEN="your-token-here"
The agent reads this variable whenever the skill runs. It never stores or logs the value.

​
What’s included

Full cnpj-api coverage via 8 endpoints:
EndpointPlanDescription
GET /v1/cnpj/{cnpj}free+Full company profile
POST /v1/bulk-cnpjproBatch lookup (up to 20)
GET /v1/simples/{cnpj}free+Simples Nacional and SIMEI status
GET /v1/socios/{pessoaId}free+Partner profile and companies
GET /v1/cidades/{id}free+IBGE city aggregates
GET /v1/cnae/{cnae}free+Industry classification aggregates
GET /v1/usagefree+Current plan and rate limit
Plus helper scripts (validate-cnpj.ts and bulk-lookup.ts).

​
How to use it

After install, ask your agent in natural language:

Single lookup

“Look up CNPJ 82.845.322/0001-04”

Simples Nacional

“Is this company in Simples Nacional?”

Partners

“Show me the partners of this company”

Bulk enrichment

“Enrich this list of 50 CNPJs”
The agent picks the right endpoint, handles errors, respects rate limits, and adds the api-token header automatically.

​
Compatibility

Works with any agent that supports the Agent Skills format:

Claude Code

Cursor

Codex

Windsurf

OpenCode

Amp

Antigravity

+35 more

​
Limits and plans

See plans and pricing at cnpj-api.com/precos. Batch lookup (/v1/bulk-cnpj) requires the Pro plan.

​
Open source

The skill is MIT-licensed and public: Issues and PRs welcome.

​
Next steps

Install on Claude manually

Step-by-step guide for Claude.ai (web and desktop) with ZIP upload.

GitHub repository

View the skill source, SKILL.md, references, and scripts.