Buscador De Cnpj

Name: Buscador De Cnpj
Author: buscadordecnpj

@buscadordecnpj

Repository

About Buscador De Cnpj

Buscador de CNPJs atualizados com dados reais da receita federal

#cnpj #leads #brasil #empresas #busca-por-empresas #buscas-por-cnpj

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "cnpj-search": {
      "command": "uvx",
      "args": [
        "buscador-de-cnpj"
      ],
      "env": {
        "CNPJ_API_KEY": "sua_api_key_aqui"
      }
    }
  }
}

Tools

Consulta pública de CNPJ (dados básicos sem necessidade de API key).

Consulta detalhada de CNPJ (requer API key).

Consulta múltiplos CNPJs em uma única requisição (requer API key).

Busca avançada com filtros estruturados (requer API key).

Estima a quantidade de resultados para uma busca avançada (requer API key).

Exporta resultados de busca avançada para CSV (requer API key).

Estima créditos necessários para exportação CSV (requer API key).

Overview

What is Buscador De Cnpj?

Buscador De Cnpj is an MCP server that queries Brazilian company data using the API from buscadordecnpj.com. It offers free public CNPJ lookups and premium features requiring an API key. It is intended for users who need to retrieve and search Brazilian business registry information.

How to use Buscador De Cnpj?

Install automatically via a curl script or manually via pip/uv. Configure the Claude Desktop JSON file with the path to uvx (or the installed package) and set the CNPJ_API_KEY environment variable for premium features. Then restart Claude Desktop. Use natural language commands or direct tool calls like cnpj_public_lookup with a CNPJ number.

Key features of Buscador De Cnpj

Free public CNPJ lookup with no API key required
Premium detailed lookup with full company data
Textual term search using natural language
Advanced search with structured filters and pagination
Bulk lookup of multiple CNPJs with optional state/active filters

Use cases of Buscador De Cnpj

Quickly retrieve basic company data from a CNPJ for free
Perform detailed due diligence on Brazilian businesses
Search for companies by name, location, or activity status
Bulk-check multiple CNPJs for account validation or auditing

FAQ from Buscador De Cnpj

What tools does Buscador De Cnpj provide?

It provides cnpj_public_lookup (free), cnpj_detailed_lookup (premium), term_search, cnpj_advanced_search, and cnpj_bulk_lookup.

Is an API key required for all features?

No. Only premium features (cnpj_detailed_lookup, term_search, cnpj_advanced_search, cnpj_bulk_lookup) require an API key from buscadordecnpj.com. Public lookups are free and unlimited.

How do I install Buscador De Cnpj?

Use the automatic installer: curl -sSL https://raw.githubusercontent.com/victortavernari/buscador-de-cnpj/main/install.sh | bash. Alternatively, install via pip install buscador-de-cnpj or with uv.

What configuration is needed for Claude Desktop?

Add an mcpServers entry in claude_desktop_config.json with the command (e.g., uvx or the installed package) and the CNPJ_API_KEY environment variable if using premium features.

How do I debug the server?

Use the MCP Inspector: run npx @modelcontextprotocol/inspector uvx buscador-de-cnpj (or buscador-de-cnpj if installed globally) to test tools locally.