Buscador De Cnpj

CNPJ 検索 - MCP サーバー

buscadordecnpj.com の API を使用してブラジル企業のデータを検索する MCP（Model Context Protocol）サーバーです。

📋 機能

🆓 無料検索

• cnpj_public_lookup：企業の基本情報を公開検索します（API key は不要です）

💎 プレミアム検索（API key が必要です）

• cnpj_detailed_lookup：企業の全データを含む詳細検索
• term_search：複数のフィールドを自然言語のテキストで検索します。例：「SP Tatuapé のパン屋」
• cnpj_advanced_search：構造化フィルター（完全一致、範囲）を使った高度な検索です。ファインチューニングに最適です

🚀 インストール

🎯 自動インストール（推奨）

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

このスクリプトは次の処理を行います：

• ✅ オペレーティングシステムを検出します
• ✅ uv をインストールします（必要な場合）
• ✅ buscador-de-cnpj をインストールします
• ✅ Claude Desktop を自動的に設定します
• ✅ 互換性確保のためのラッパースクリプトを作成します

🔧 手動インストール

オプション A：uv を使用

# Instale uv (se não tiver)
curl -LsSf https://astral.sh/uv/install.sh | sh
# ou no Windows:
# powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

オプション B：pip を使用

pip install buscador-de-cnpj

🔑 API key を設定する

プレミアム機能を利用するには、https://buscadordecnpj.com で API key を取得してください。

🔧 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. ラッパースクリプトを作成します：

# Crie o diretório se não existir
sudo mkdir -p /usr/local/bin

# Crie o script wrapper
sudo tee /usr/local/bin/uvx-wrapper << 'EOF'
#!/bin/bash
# Encontra uvx automaticamente e executa
UVX_PATH=""

# Possíveis localizações do uvx
POSSIBLE_PATHS=(
    "$HOME/.local/bin/uvx"
    "$HOME/Library/Python/3.*/bin/uvx"
    "/opt/homebrew/bin/uvx"
    "/usr/local/bin/uvx"
    "$(which uvx 2>/dev/null)"
)

for path in "${POSSIBLE_PATHS[@]}"; do
    if [[ -x "$path" ]]; then
        UVX_PATH="$path"
        break
    fi
    # Para paths com wildcard
    for expanded in $path; do
        if [[ -x "$expanded" ]]; then
            UVX_PATH="$expanded"
            break 2
        fi
    done
done

if [[ -z "$UVX_PATH" ]]; then
    echo "Error: uvx not found. Please install uv first." >&2
    exit 1
fi

exec "$UVX_PATH" "$@"
EOF

# Torne executável
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": "sua_api_key_aqui"
      }
    }
  }
}

オプション B：pip でグローバルにインストール（より簡単）

pip install buscador-de-cnpj

{
  "mcpServers": {
    "cnpj-search": {
      "command": "buscador-de-cnpj",
      "env": {
        "CNPJ_API_KEY": "sua_api_key_aqui"
      }
    }
  }
}

オプション C：手動でパスを指定（ほかの方法が機能しない場合）

1. uvx のパスを確認します：

which uvx

2. 完全なパスを使用します：

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

3. Claude Desktop を再起動する

新しい MCP サーバーを読み込むため、Claude Desktop を終了してから再度開いてください。

📖 使い方

デプロイ、検証、ベストプラクティスの詳細については、QWEN.md も参照してください。

公開検索（無料）

Busque informações da empresa com CNPJ 11.222.333/0001-81

詳細検索（プレミアム）

Faça uma busca detalhada da empresa com CNPJ 11.222.333/0001-81

一括検索

Busque informações das empresas com CNPJs: 11.222.333/0001-81, 22.333.444/0001-92

高度な検索

Busque empresas com nome "Petrobras" no estado do Rio de Janeiro que estejam ativas

🛠️ 直接使用する例

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": "padarias em SP Tatuapé",
    "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（任意）：営業中の企業のみで絞り込み（true/false）

cnpj_advanced_search

• name（任意）：企業名または企業名の一部
• activity（任意）：企業の主な事業内容
• state（任意）：州（UF）
• city（任意）：市区町村
• registration_status（任意）：登録ステータス（ATIVA、BAIXADA など）
• page（任意）：結果のページ（デフォルト：1）
• per_page（任意）：1 ページあたりの結果数（最大：50）

💰 API の料金

• 公開検索：無料、回数無制限
• 詳細検索：成功した検索 1 件につき 1 クレジット
• 一括検索：CNPJ 20 件につき 1 クレジット
• 高度な検索：検索 1 回につき 2 クレジット

🚨 トラブルシューティング

エラー：「spawn uvx ENOENT」

Claude Desktop が uvx を見つけられません。解決方法：

1. uvx のパスを確認します：

which uvx

2. 設定で完全なパスを使用します：

{
  "command": "/caminho/completo/para/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. または、pip install を使ったオプション B を使用します

エラー：「spawn buscador-de-cnpj ENOENT」

パッケージがグローバルにインストールされていません。次を実行してください：

pip install buscador-de-cnpj

エラー：「API key required」

プレミアム機能を利用するには：

1. 環境変数を設定します：export CNPJ_API_KEY="sua_key"
2. または、Claude Desktop の設定ファイルで設定します
3. API キーを取得します：https://buscadordecnpj.com

エラー：「Unknown tool」

次の点を確認してください：

1. 設定後に Claude Desktop を再起動した
2. JSON 設定に誤りがない（構文エラーがない）
3. サーバー名が正しい：「cnpj-search」

サーバーに接続できない

次の点を確認してください：

1. Python 3.11+ がインストールされている
2. パッケージが正しくインストールされている
3. 依存関係の競合がない

🔍 デバッグ

MCP サーバーをローカルでテストするには、MCP Inspector を使用します：

uvx を使用

npx @modelcontextprotocol/inspector uvx buscador-de-cnpj

pip install を使用

npx @modelcontextprotocol/inspector buscador-de-cnpj

MCP サーバーのツールを直接テストできるウェブインターフェースが開きます。

📞 サポート

• API：https://buscadordecnpj.com
• API ドキュメント：https://api.buscadordecnpj.com/docs
• MCP Protocol：https://modelcontextprotocol.io

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。