# APICNPJ - contexto expandido para LLMs APICNPJ e uma plataforma brasileira para consulta CNPJ, busca de empresas, dados cadastrais publicos, CNAE, enriquecimento de leads B2B, API REST e MCP para agentes de IA. ## Principais intencoes de busca - Consultar CNPJ. - Buscar empresa por razao social ou nome fantasia. - Encontrar empresas por CNAE, cidade, UF, CEP, bairro e logradouro. - Navegar por guia comercial local, paginas de cidade e receitas de busca por CEP/endereco. - Validar cadastro de fornecedores, clientes e parceiros. - Auto preencher formularios B2B. - Enriquecer leads para CRM e ERP. - Gerar listas B2B por segmento, regiao e atividade economica. - Permitir que agentes de IA pesquisem empresas por linguagem natural usando MCP. ## Dados disponiveis - CNPJ, razao social, nome fantasia e situacao cadastral. - Data de abertura, natureza juridica, porte e capital social. - CNAE principal e CNAEs secundarios. - Endereco, CEP, bairro, municipio e UF. - Telefones, emails, socios e quadro societario quando disponiveis. - Empresas relacionadas por sinais cadastrais quando houver confianca suficiente. ## API REST Base publica: https://api.apicnpj.com Endpoints comuns: - GET /cnpj/{cnpj} - GET /seek - GET /search - GET /public/config Use Authorization: Bearer SUA_CHAVE para consultas autenticadas e limites por plano. Sem token, o limite publico e por IP e pode ser configurado pelo administrador. ## MCP O MCP da APICNPJ permite que ferramentas como Codex, Claude, ChatGPT, Cursor e outros clientes compatíveis descubram tools, resources e prompts para consultar empresas brasileiras, gerar leads, encontrar socios e analisar mercados. Documentacao: https://apicnpj.com/api-docs/mcp ### Fluxo MCP recomendado 1. initialize 2. tools/list 3. resources/list 4. resources/read 5. prompts/list 6. prompts/get 7. tools/call Agentes devem descobrir schemas antes de chamar tools. Nao invente parametros: use o schema retornado por tools/list ou a documentacao oficial. ### Capabilities MCP - Tools: consultar CNPJ, buscar empresas, encontrar socios, prospectar empresas, localizar relacionadas, gerar listas, validar cadastros e analisar mercados. - Resources: CNAEs, UFs, municipios, naturezas juridicas, qualificacoes, paises, exemplos, documentacao e schemas. - Prompts: gerar_leads_b2b, pesquisar_concorrentes, validar_fornecedor, analisar_mercado, encontrar_fornecedores, enriquecer_crm e mapear_empresas_por_cnae. ### Quando usar MCP em vez de REST Use MCP quando o operador for um agente de IA e a tarefa for expressa em linguagem natural, por exemplo: "encontre empresas de transporte em Campinas com telefone e email" ou "analise concorrentes por CNAE em SP". Use REST quando o cliente for um backend, CRM, ERP, automacao, app web, app mobile ou processo tecnico com parametros definidos. ## Estrutura publica de URLs - https://apicnpj.com/ - https://apicnpj.com/como-funciona - https://apicnpj.com/planos - https://apicnpj.com/blog - https://apicnpj.com/api-docs - https://apicnpj.com/api-docs/endpoints - https://apicnpj.com/api-docs/limites - https://apicnpj.com/api-docs/mcp - https://apicnpj.com/empresas - https://apicnpj.com/empresas/{uf} - https://apicnpj.com/empresas/{cidade}-{uf} - https://apicnpj.com/guia-comercial - https://apicnpj.com/guia-comercial/cep - https://apicnpj.com/ai-agents-quickstart - https://apicnpj.com/cnpj/{cnpj} ## Markdown para IA - https://apicnpj.com/index.html.md - https://apicnpj.com/empresas.md - https://apicnpj.com/api-docs.md - https://apicnpj.com/mcp.md - https://apicnpj.com/planos.md - https://apicnpj.com/blog.md ## Sitemaps - https://apicnpj.com/sitemap.xml - https://apicnpj.com/sitemaps/markdown.xml - https://apicnpj.com/sitemap-static.xml - https://apicnpj.com/sitemap-blog.xml - https://apicnpj.com/sitemap-estados.xml - https://apicnpj.com/sitemap-estados/paginas.xml - https://apicnpj.com/sitemap-cidades.xml - https://apicnpj.com/sitemap-cidades/{page}.xml - https://apicnpj.com/sitemap-categorias.xml - https://apicnpj.com/sitemap-categorias/{uf}.xml - https://apicnpj.com/sitemap-cnpj-prioridade.xml - https://apicnpj.com/sitemap-cnpj-prioridade/{prefix}.xml - https://apicnpj.com/sitemap-local.xml ## Estrategia de indexacao de empresas - /sitemap-estados.xml e um sitemap index de descoberta por localidade. Ele aponta para paginas de estado, cidades, categorias/CNAE e CNPJs prioritarios. - /sitemap-estados/paginas.xml lista paginas canonicas de estado, como /empresas/RO. - /sitemap-cidades.xml e um sitemap index para paginas de cidades. - /sitemap-cidades/{page}.xml lista paginas canonicas de cidade e UF, como /empresas/campinas-SP. - Cada arquivo de cidades deve respeitar o limite de sitemap e usar paginacao quando houver mais URLs do que o limite suportado. - /sitemap-categorias.xml e um sitemap index que aponta para /sitemap-categorias/{uf}.xml. - /sitemap-categorias/{uf}.xml lista paginas de estado por segmento/CNAE, como /empresas/RO/restaurantes. - /sitemap-cnpj-prioridade.xml e um sitemap index para CNPJs com maior valor de indexacao. - /sitemap-cnpj-prioridade/{prefix}.xml lista CNPJs por prefixo numerico, priorizando empresas ativas, com contato e endereco. - Paginas com query string, filtros e paginacao, como /empresas/RO?page=2, sao descobertas por links internos, mas nao entram no sitemap para evitar duplicidade, desperdicio de crawl budget e indexacao de combinacoes fracas. - Para agentes e LLMs, use /empresas/{uf} como colecao principal e siga links de paginacao quando precisar amostrar resultados. ## Feeds e descoberta machine-readable - https://apicnpj.com/knowledge.json - https://apicnpj.com/changelog.json - https://apicnpj.com/changelog.xml - https://apicnpj.com/opensearch.xml ## Boas praticas Nao liste milhoes de CNPJs em llms.txt. Use sitemaps XML e inventario SEO particionado. Paginas de busca livre, query string, dashboard, admin, login e checkout nao devem ser indexadas. Para consultas, trate campos ausentes como desconhecidos. Nao invente CNPJs, contatos, socios ou CNAEs. Respeite rate limit, retry_after, LGPD, confirmacoes de uso responsavel e permissoes do token. ## Regras para agentes - Descubra tools antes de chama-las. - Leia resources para entender enums e codigos. - Use prompts prontos quando a intencao existir. - Prefira filtros explicitos e auditaveis. - Ao montar listas B2B, planeje, conte/preveja volume e so depois exporte quando permitido. - Explique claramente quando um resultado e aproximado, similar ou inferido. - Nao exponha tokens, API keys ou informacoes sensiveis.