企业信息查询工具

Name: 企业信息查询工具
Author: buscadordecnpj

作者：buscadordecnpj8 星标更新：2025-08-03

安装使用来源：spider==github.com

项目介绍

CNPJ Finder - MCP Server

一个用于巴西公司数据搜索的MCP（模型上下文协议）服务器，使用search.com。

CNPJ查找器在代理上的运行演示（GIF）

📋 功能

🆓 免费查询

cnpj_public_lookup 公共查询基础公司数据（无需API密钥）

💎 高级查询（需要API密钥）

cnpj_detailed_lookup 详细查询完整的公司数据
term_search 按文本词（自然语言）在多个字段中搜索；例如："圣保罗塔图阿佩的面包店"
cnpj_advanced_search 使用结构化过滤器进行高级搜索（精确、区间）；适合精细化调整

🚀 安装

🎯 自动安装（推荐）

curl -sSL https://raw.githubusercontent.com/victortavernari/buscador-de-cnpj/main/install.sh | bash

此脚本将：

✅ 检测您的操作系统
✅ 安装UV（如有必要）
✅ 安装cnpj-finder
✅ 自动配置Claude Desktop
✅ 创建兼容性包装脚本

🔧 手动安装

方案A：使用UV

# 如果没有，请安装uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# 或在Windows上：
# powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

方案B：使用pip

pip install buscador-de-cnpj

🔑 配置您的API密钥

对于高级功能，请在以下网址获取API密钥：https://buscadordecnpj.com

🔧 在Claude Desktop中的配置

1. 编辑Claude的配置文件

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 添加MCP服务器配置

方案A：使用带有脚本包装器的uvx（推荐）

1. 创建脚本包装器：

# 如果不存在，请创建目录
sudo mkdir -p /usr/local/bin

# 创建脚本包装器
sudo tee /usr/local/bin/uvx-wrapper << 'EOF'
#!/bin/bash
# 自动找到uvx并执行
UVX_PATH=""

# uvx可能的位置
POSSIBLE_PATHS=(
    "$HOME/.local/bin/uvx"
    "$HOME/Library/Python/3.*/bin/uvx"
    "/opt/homebrew/bin/uvx"
    "/usr/local/bin/
    "$(which uvx 2>/dev/null)"
)

for path in "${POSSIBLE_PATHS[@]}"; do
    if [[ -x "$path" ]]; then
        UVX_PATH="$path"
        break
    fi
    # 对于通配符路径
    for expanded in $path; do
        if [[ -x "$expanded" ]]; then
            UVX_PATH="$expanded"
            break 2
        fi
    done
done

if [[ -z "$UVX_PATH" ]]; then
    echo "错误：未找到uvx。请先安装uv。" >&2
    exit 1
fi

exec "$UVX_PATH" "$@"
EOF

# 设置可执行权限
sudo chmod +x /usr/local/bin/uvx-wrapper

2. 在Claude Desktop中配置：

{
  "mcpServers": {
    "cnpj-search": {
      "command": "/usr/local/bin/uvx-wrapper",
      "args": ["buscador-de-cnpj"],
      "env": {
        "CNPJ_API_KEY": "您的API密钥"
      }
    }
  }
}

方案B：全局安装pip（更简单）

pip install buscador-de-cnpj

{
  "mcpServers": {
    "cnpj-search": {
      "command": "buscador-de-cnpj",
      "env": {
        "CNPJ_API_KEY": "您的API密钥"
      }
    }
  }
}

方案C：手动路径（如果其他方法不适用）

1. 查找您的uvx路径：

which uvx

2. 使用完整路径：

{
  "mcpServers": {
    "cnpj-search": {
      "command": "/您的路径到/uvx",
      "args": ["buscador-de-cnpj"],
      "env": {
        "CNPJ_API_KEY": "您的API密钥"
      }
    }
  }
}

3. 重启Claude Desktop

关闭并重新打开Claude Desktop以加载新的MCP服务器。

📖 如何使用

关于部署、验证和最佳实践的详情，请参阅QWEN.md。

公共查询（免费）

查询CNPJ为11.222.333/0001-81的公司的信息

详细查询（高级）

对CNPJ为11.222.333/0001-81的公司进行详细查询

批量查询

查询CNPJ为：11.222.333/0001-81, 22.333.444/0001-92的公司的信息

高级查询

查询在里约热内卢州且处于活跃状态的名为“Petrobras”的公司

🛠️ 直接使用的示例

1. 公共查询

{
  "tool": "cnpj_public_lookup",
  "arguments": {
    "cnpj": "11.222.333/0001-81"
  }
}

2. 详细查询

{
  "tool": "cnpj_detailed_lookup",
  "arguments": {
    "cnpj": "11222333000181"
  }
}

3. 批量查询

{
  "tool": "cnpj_bulk_lookup",
  "arguments": {
    "cnpjs": ["11222333000181", "22333444000192"],
    "state": "SP",
    "active": true
  }
}

4. 文本查询（自由文本）

{
  "tool": "term_search",
  "arguments": {
    "term": "圣保罗塔图阿佩的面包店",
    "uf": "SP",
    "pagina": 1,
    "limite": 100
  }
}

标签：使用term进行自然语言搜索；结合uf、municipio、bairro来加速和细化搜索。

5. 高级查询（结构化过滤器）

{
  "tool": "cnpj_advanced_search",
  "arguments": {
    "razao_social": "*padaria*",
    "uf": "SP",
    "municipio": "São Paulo",
    "bairro": "Tatuapé",
    "situacao_cadastral": "2",
    "pagina": 1,
    "limite": 100
  }
}

🔍 可用参数

cnpj_public_lookup

cnpj（必需）：公司CNPJ（带或不带格式）

cnpj_detailed_lookup

cnpj（必需）：公司CNPJ（带或不带格式）

cnpj_bulk_lookup

cnpjs（必需）：CNPJ列表
state（可选）：按州筛选（UF）
active（可选）：仅筛选活跃公司（真/假）

cnpj_advanced_search

name（可选）：公司名称或部分名称
activity（可选）：公司的主营业务
state（可选）：州（UF）
city（可选）：城市
registration_status（可选）：注册状态（ACTIVE，LOW等）
page（可选）：结果页码（默认：1）
per_page（可选）：每页结果数（最大：50）

💰 API费用

公共查询 免费且不限次数
详细查询 每次成功查询消耗1个信用
批量查询 每20个CNPJ消耗1个信用
高级查询 每次查询消耗2个信用

🚨 问题解决

错误：“spawn uvx ENOENT”

Claude Desktop无法找到uvx解决方案：

1. 查找uvx的路径：

which uvx

2. 在配置中使用完整路径：

{
  "command": "/完整路径到/uvx",
  "args": ["buscador-de-cnpj"]
}

3. 如果未安装uvx：

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

4. 或使用方案B通过pip安装

错误：“spawn buscador-de-cnpj ENOENT”

该包未全局安装。运行：

pip install buscador-de-cnpj

错误：“需要API密钥”

对于高级功能：

定义环境变量：export CNPJ_API_KEY="您的密钥"
或在Claude Desktop配置文件中配置
获取API密钥：https://buscadordecnpj.com

错误：“未知工具”

检查是否：

在配置后重启了Claude Desktop
JSON配置正确（无语法错误）
服务器名称正确：“cnpj-search”

服务器无法连接

确认：

已安装Python 3.11+
包已正确安装
没有依赖冲突

🔍 调试

要本地测试MCP服务器，可以使用MCP Inspector：

使用UV

npx @modelcontextprotocol/inspector uvx buscador-de-cnpj

使用pip安装

npx @modelcontextprotocol/inspector buscador-de-cnpj

这将打开一个Web界面，在其中可以直接测试MCP服务器工具。

📞 支持

API： https://buscadordecnpj.com
API文档： https://api.buscadordecnpj.com/docs
MCP协议： https://modelcontextprotocol.io

📄 许可证

本项目根据MIT许可证授权。