brdata

Name: brdata
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords法律与政务01 周前更新

代码仓库

关于 brdata

brdata 是汇集巴西公共数据的命令行工具和 stdio MCP 服务，适合查询地理信息、登记资料、经济指标、采购信息及公共记录；多数接口无需账户或密钥。

主要功能

01查询 IBGE 州和市镇信息
02搜索采购公告和市政公报
03查询 CNPJ、CEP 和 .br WHOIS 数据
04在本地验证 CPF 校验位
05获取利率、FIPE 品牌和医疗机构信息

适用场景

01查找巴西邮政编码对应地区
02核验公司登记信息或 CPF 有效性
03查看央行指标或 FIPE 品牌
04搜索采购公告或市政记录

MCP 相关

其 stdio MCP 服务提供 12 种巴西公共数据工具，涵盖地理信息、采购、登记、经济指标和医疗机构。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-brdata": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/brdata"
      ]
    }
  }
}

启动命令npx -y @reneturcios/brdata

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/brdata0.1.0stdio

ocighcr.io/cloudcorprecords/brdata:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
uf	string	否	用于筛选的两字母州代码（UF）。
scope	string	否	地区范围：estados（默认）或 municipios。

详细介绍

brdata

brdata 将巴西的开放公共数据整合到一个小型命令行工具和一个 stdio MCP 服务中。它能回答的大多数问题都不需要账号或密钥：CEP 对应的位置、企业注册信息、CPF 号码在算术上是否有效、中央银行的主要利率情况、FIPE 表收录了哪些汽车品牌、IBGE 地理信息中的州或市镇是什么样，以及公共采购门户、市政公报、律师登记名录、强迫劳动黑名单和国家卫生设施登记库中正在采购、发布或登记的内容。

此处包含 12 个工具。这是一个带标签的核心子集，较大目录中的企业深度档案、法院案件和逮捕令搜索、在逃人员和消费者投诉查询，以及其他若干工具均有意排除在外。

安装

npx @reneturcios/brdata ibge --uf SP

或者运行容器镜像：

docker run -i ghcr.io/cloudcorprecords/brdata

容器默认启动 MCP 服务。传入 CLI 参数即可将其用作 CLI。无需环境变量：此处使用的所有上游接口都是公开且无需密钥的端点。

CLI

brdata ibge --scope municipios --uf SP
brdata pncp merenda --uf BA
brdata diario edital
brdata oab "Maria Silva" --uf RJ
brdata lista-suja "Fazenda Exemplo"
brdata cnpj 12345678000195
brdata cep 01310-100
brdata cpf 529.982.247-25
brdata whois example.com.br
brdata bacen --indicator selic
brdata fipe Fiat
brdata cnes "Hospital Central" --municipio Campinas

brdata --version

每条命令都会输出上游 JSON 载荷，但 cpf 除外，它会输出本地验证结果。退出码：成功时为 0，调用失败或验证输入无效时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/brdata mcp

MCP 客户端配置：

{
  "mcpServers": {
    "brdata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/brdata", "mcp"]
    }
  }
}

工具

工具	输入	返回内容
`ibge_localidades`	`scope`（可选：estados/municipios）、`uf`（可选）	IBGE 州或市镇。
`pncp_licitacoes`	`query`、`uf`（均为可选）	PNCP 公共采购公告。
`querido_diario`	`query`（必填）	市政公报搜索结果。
`oab_advogado`	`name`（必填）、`uf`（可选）	OAB 律师登记匹配结果。
`lista_suja_lookup`	`query`（必填）	强迫劳动黑名单匹配结果。
`cnpj_lookup`	`cnpj`（必填，14 位数字）	通过 BrasilAPI 获取的企业注册数据。
`cep_lookup`	`cep`（必填，8 位数字）	通过 BrasilAPI 获取的邮政编码对应地点。
`cpf_validate`	`cpf`（必填）	本地校验位验证；不发起网络调用。
`domain_whois`	`domain`（必填）	通过 BrasilAPI 上的 registro.br 数据查询 .br 域名 WHOIS 信息。
`bacen_taxas`	`indicator`（可选：selic/ipca/usd/eur/cdi）	该指标在 Banco Central SGS 中的最新值。
`fipe_veiculos`	`query`（可选）	FIPE 汽车品牌；若提供查询词，则按其筛选。
`cnes_saude`	`query`、`municipio`（均为可选）	CNES 卫生设施。

数据来源说明：IBGE 地理信息来自 IBGE 地点服务，Banco Central 数据来自 BCB 开放数据 SGS 序列，FIPE 品牌来自公开的 Parallelum FIPE API，CNPJ/CEP/WHOIS 数据来自 BrasilAPI。PNCP、OAB、lista suja 和 CNES 请求根据这些服务的公开端点构造；由于构建此软件包时未进行实时调用，其参数结构是根据公开搜索界面推断的，并已在构建报告中注明。

CPF 验证是精确验证，并非抽样验证：它会移除标点符号、拒绝所有数字相同的号码和长度错误的号码，并在本地重新计算两个 modulo-11 校验位。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx