radar-cnpj-mcp

radar-cnpj-mcp

让 AI 智能体按行业和地区搜索巴西公开的 CNPJ 企业登记库，使用由联邦数据文件建成的本地数据库。免费，数据留在你的机器上。适合销售和市场分析人员。

由 wendersoon 在 GitHub 上制作。这些说明是 Mindket 根据其 README 写的，项目自己的文件和许可证在它的仓库里。

简介

它是什么：radar-cnpj-mcp 是一个回答巴西企业问题的 MCP 服务器。Receita Federal 把企业登记库发布成几个 GB 的原始文件，这个工具把它们变成本地数据库，AI 智能体能在毫秒内搜索。你可以直接在智能体或终端里问：某个城市或行业有多少修车厂、健身房或牙科诊所。

适合谁：它适合需要了解巴西某个行业或地区有哪些企业的销售团队、市场分析人员和研究者。

行业 | 谁在用 | 怎么用 | 例子
销售和获客 | 销售团队 | 按行业和城市建立在营企业名单，可以包含或排除 MEI | 团队要某个城市自 2025 年起开业的健身房，并带上电话号码
市场研究 | 分析师 | 按行业统计企业数量，比较各地区，并追踪开业趋势 | 分析师比较三个城市的牙科诊所
零售和加盟规划 | 拓展团队 | 查看某一类企业在一个区域已经有多少家 | 规划人员把某个街区的餐厅导出成 CSV 文件
经济发展 | 研究者 | 概括一个市的经济状况 | 研究者要一份城市行业和近期开业情况的概况

如果你需要巴西以外的企业，可以跳过它，因为它只包含巴西的公开登记库。

用在哪里：

• Claude Code
• Claude Desktop、Cursor 和 VS Code
• 其他能连接 MCP 服务器的工具
• 终端，使用同样的命令

用例 | 谁用 | 能得到什么
统计企业数量 | 分析师 | 按州、市、街区、活动代码、规模、MEI 或年份分组的总数
查找企业 | 销售团队 | 带 CNPJ、法定名称、活动、地址和联系方式的企业名单
比较地区 | 研究者 | 最多 5 个市或州的并排对比
导出名单 | 所有人 | 能在 Excel 里正常打开的 CSV 表格

如何设置：你需要 Node.js，以及为第一次下载准备的大量磁盘空间。

• Node.js 20 或更新版本
• 约 7 GB 的下载量，即使只要一个州
• 建库期间约需要 20 GB 的空闲磁盘空间

1. 下载你想要的各州的登记数据。
2. 用下面的 Claude Code 命令或 JSON 配置，把服务器连接到你的智能体。
3. 向智能体提问。

npx -y radar-cnpj-mcp baixar --ufs SP,MG

要下载整个巴西，用 --todas 代替 --ufs。如果你更想用浏览器下载文件，就把企业、营业场所、Simples、CNAE 代码和市的登记 zip 文件保存到同一个文件夹里，再导入它。

npx -y radar-cnpj-mcp importar ~/Downloads/2026-10 --ufs SP,MG

要连接 Claude Code，运行下面这条。

claude mcp add radar-cnpj -- npx -y radar-cnpj-mcp

Claude Desktop、Cursor、VS Code 和其他客户端使用这份配置。

{
  "mcpServers": {
    "radar-cnpj": {
      "command": "npx",
      "args": ["-y", "radar-cnpj-mcp"]
    }
  }
}

如果你想安装它，而不是通过 npx 运行，用下面这几行。

npm install -g radar-cnpj-mcp
claude mcp add radar-cnpj -- radar-cnpj-mcp

如何使用：用日常的话向你的智能体提问。想每月刷新数据库，就再运行一次下载命令。你也可以让智能体去下载数据，它会先向你确认，然后在后台继续下载。每次下载都会替换当前的数据库，所以要列出你想保留的每一个州。

工具 | 作用
buscar_empresas | 列出企业，含 CNPJ、法定名称、活动、地址和联系方式
contar_empresas | 统计企业数量，按州、市、街区、活动代码、规模、MEI 或年份分组
buscar_cnae | 根据描述查找 CNAE 活动代码
buscar_municipio | 按名称查找市
detalhar_empresa | 显示某个 CNPJ 的全部数据字段
exportar_csv | 生成可直接用于 Excel 的 CSV 表格
status_base | 报告参考月份和已导入的州
perfil_municipio | 概括一个市的行业、企业规模、MEI 和近期开业情况
comparar_regioes | 比较最多 5 个市或州，限定一个行业或覆盖所有行业
tendencia_setor | 根据当前数据库显示每年或每月的开业和注销情况
baixar_dados | 在你提出要求时，于后台下载登记数据
andamento_download | 显示智能体启动的下载进行到哪一步

示例：你要求列出自 2025 年起在 Santo André 开业、不含 MEI 且带电话号码的在营健身房。智能体找出正确的活动代码，套用筛选条件，并返回名单。之后你可以让它把名单导出成适合 Excel 的 CSV 文件。

新手与专家：巴西把每一家注册企业都发布在巨大的原始文件里。这个工具把它们变成你自己电脑上的一个小型数据库，让 AI 助手去搜索。你用日常的话提问，比如坎皮纳斯有多少家修车厂在营业，助手会算出活动代码和筛选条件。第一件可以试的小事，是下载一个州，连接 Claude Code，然后问你所在城市的数量。

在底层，服务器读取每月的登记文件，只为你选择的州建立本地数据库。它提供用于搜索、分组统计、代码查询、企业详情、CSV 导出、市概况、地区比较和行业趋势的 MCP 工具。搜索会忽略重音，MEI 与微型企业分开处理。代价是体积和时效。下载量很大，每次新下载都会替换数据库，而且这个项目不托管也不再分发这些数据。

下载 Receita Federal 的文件
为选定的州建立本地数据库
把服务器连接到你的 AI 智能体
用日常的话提问
智能体搜索、统计或导出

注意事项：

• 许可证：MIT。
• 数据留在你的机器上，没有月费，结果数量也没有上限。
• 这个项目不托管也不再分发登记数据。
• 全局安装之后要更新这个工具，运行 npm update -g radar-cnpj-mcp。
• 两个州 SP 和 AC 的安装用了约 33 分钟，其中 18 分钟是下载时间。建好的数据库约 1.9 GB。

Title: 安装所需的存储空间
下载大小: 7 GB
安装期间的空闲空间: 20 GB

GitHub 上的数据（2026年11月7日）

• 星标：128
• 复刻：15
• 未关闭的议题和拉取请求：0
• 语言：TypeScript
• 许可证：MIT
• 话题：cnae, cnpj, duckdb, mcp, mcp-server, receita-federal, typescript

链接

• 代码：https://github.com/wendersoon/radar-cnpj-mcp
• 发布版本：https://github.com/wendersoon/radar-cnpj-mcp/releases
• 议题：https://github.com/wendersoon/radar-cnpj-mcp/issues
• 星标历史：https://www.star-history.com/#wendersoon/radar-cnpj-mcp&Date

获取代码

git clone https://github.com/wendersoon/radar-cnpj-mcp.git

然后按它的 README 完成设置。这个工具包里没有会自己运行的东西。