🎯 MCP Hunter

OSINT、アクティブプロスペクティング、ウェブ検索、ディープスクレイピング、企業・人物データのエンリッチメントのためのMCP（Model Context Protocol）サーバー。

MCP Hunter は、人工知能アシスタント（Gemini Antigravity、Claude Desktop、Cursor、Windsurf など）をインターネットおよびオープンデータソースに直接接続します。Google/Web での検索、インテリジェントなページのスクレイピングとクレンジング、連絡先（電子メール、WhatsApp、電話番号、ソーシャルメディア）の抽出、そして Receita Federal の公式データ（CNPJ、株主/QSA、資本金、住所）による企業プロファイルのエンリッチメントを実行できます。

✨ 主な機能

• 🔍 有料キー不要のウェブ検索: 高度な演算子（site:、inurl:、filetype:）に対応した高速検索と、ブラジル地域へのフォーカス（br-pt）。

• 🌐 インテリジェントなコンテンツのスクレイピングとクレンジング: trafilatura と BeautifulSoup を使用して、広告、メニュー、コードを除外し、メインテキストのみを抽出します。

• 📞 精密な連絡先抽出ツール: 以下を識別するための正規表現アルゴリズムとヒューリスティック:

  • 有効な電子メール（スパム対策フィルターと画像除外フィルター付き）;

  • ブラジル形式の固定電話・携帯電話番号;

  • WhatsApp のダイレクトリンク（wa.me/ と api.whatsapp.com）;

  • ソーシャルメディア上の公式プロフィール（Instagram、LinkedIn、Facebook、X/Twitter、YouTube、TikTok、GitHub）;

  • チェックディジットの数学的検証に対応した CNPJ 番号。

• 🏛️ Receita Federal 公式照会（BrasilAPI）: 法人名、商号、登録状況、設立日、資本金、主な事業活動（CNAE）、住所、株主・役員名簿（QSA）を取得します。

• 🏢 マスターモード（hunt_company）: 企業名を受け取り、数秒でエンドツーエンドの360度調査を実行します。

• 👤 人物調査（hunt_person）: ある人物に関する公開の言及、LinkedIn プロフィール、記事をスキャンします。

Related MCP server: LeadSpark MCP

🛠️ 公開されているツール

🚀 インストールと実行

このプロジェクトは、超高速パッケージマネージャー uv を使用します。

1. リポジトリのクローン

git clone <URL_DO_REPOSITORIO>
cd "MCP Hunter"

2. 依存関係の自動インストール

uv sync

3. 自動テストの実行

uv run python tests/test_tools.py

4. MCP サーバーの起動（stdio モード）

uv run mcp-hunter

🔌 MCP クライアントでの設定

Antigravity / Claude Desktop / Cursor / Windsurf

以下の設定を MCP 設定ファイル（claude_desktop_config.json または類似のファイル）に追加してください:

{
  "mcpServers": {
    "mcp-hunter": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\caminho\\para\\MCP Hunter",
        "run",
        "mcp-hunter"
      ]
    }
  }
}

📂 プロジェクト構造

MCP Hunter/
├── src/
│   └── mcp_hunter/
│       ├── __init__.py        # Definição do pacote
│       ├── server.py          # Servidor FastMCP e registro das Tools
│       ├── search.py          # Motor de buscas na Web (DuckDuckGo/DDGS)
│       ├── scraper.py         # Motor de requisições HTTP e scraping (Trafilatura/BS4)
│       ├── extractor.py       # Extração de contatos, regex e validação de CNPJ
│       ├── cnpj.py            # Integração com BrasilAPI e Receita Federal
│       └── py.typed           # Marcador de tipagem PEP 561
├── tests/
│   ├── test_hunter.py         # Testes unitários dos módulos internos
│   └── test_tools.py          # Testes de integração das ferramentas MCP
├── mcp_config_example.json    # Exemplo de configuração de cliente MCP
├── pyproject.toml             # Configuração do projeto e dependências
├── uv.lock                    # Lockfile de dependências
└── README.md                  # Documentação oficial

📄 ライセンス

MIT ライセンスの下で配布されています。詳細については LICENSE を参照してください。