🎯 MCP Hunter

OSINT, 능동적 탐색, 웹 검색, 딥 스크래핑, 기업 및 개인 데이터 보강을 위한 MCP(Model Context Protocol) 서버.

MCP Hunter는 인공지능 어시스턴트(Gemini Antigravity, Claude Desktop, Cursor, Windsurf 등)를 인터넷 및 공개 데이터 소스에 직접 연결합니다. Google/웹 검색, 지능적인 페이지 스크래핑 및 정리, 연락처(이메일, WhatsApp, 전화번호, 소셜 미디어) 추출, 그리고 Receita Federal의 공식 데이터(CNPJ, 주주/QSA, 자본금, 주소)로 기업 프로필을 강화할 수 있습니다.

✨ 주요 기능

• 🔍 유료 키 없이 웹 검색: 고급 연산자(site:, inurl:, filetype:) 지원 및 브라질 지역 설정(br-pt)을 갖춘 빠른 검색.

• 🌐 지능형 콘텐츠 스크래핑 및 정리: trafilatura와 BeautifulSoup를 사용하여 광고, 메뉴, 코드를 제거하고 본문 텍스트만 추출합니다.

• 📞 정밀 연락처 추출기: 다음을 식별하기 위한 Regex 알고리즘 및 휴리스틱:

  • 유효한 이메일(스팸 및 이미지 필터 포함);

  • 브라질 형식의 유선전화 및 휴대전화;

  • 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

🛠️ 노출된 도구(Tools)

🚀 설치 및 실행

이 프로젝트는 초고속 패키지 관리자 **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를 참조하세요.