brdata

brdata

brdata は、ブラジルのオープンな公共データを、1つの小さなコマンドラインツールと1つの 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

cpf を除く各コマンドは、上流サービスの 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 localities サービス、Banco Central の数値は BCB のオープンデータ SGS シリーズ、FIPE のブランドは公開されている Parallelum FIPE API、CNPJ/CEP/WHOIS は BrasilAPI から取得します。PNCP、OAB、lista suja、CNES のリクエストは、それぞれのサービスの公開エンドポイントに合わせて構成しています。パラメーターの形式は公開検索機能から再構成したものであり、このパッケージの構築時には実際の呼び出しを行っていないため、ビルドレポートにその旨が記載されています。

CPF の検証はサンプルベースではなく、厳密に行われます。句読点を除去し、すべて同じ数字で構成される値や桁数が異なる値を拒否し、2つの 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

ライセンス

MIT — LICENSE を参照してください。