Skip to main content
Glama
deenesjakoptruzh
rrcodeia

mcp-hunter

by rrcodeia
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

🎯 MCP Hunter

MCP 服务器（Model Context Protocol），用于 OSINT、主动探测、网络搜索、深度抓取以及企业和个人数据增强。

MCP Hunter 将人工智能助手（如 Gemini Antigravity、Claude Desktop、Cursor 和 Windsurf）直接连接到互联网和开放数据源。它可以在 Google/Web 上搜索、智能抓取并清理页面、提取联系方式（电子邮件、WhatsApp、电话、社交媒体），并使用 Receita Federal 的官方数据（CNPJ、股东/QSA、注册资本和地址）丰富企业档案。

✨ 主要功能

  • 🔍 无需付费密钥的 Web 搜索： 快速搜索，支持高级运算符（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

🛠️ 公开的工具（Tools）

工具

描述

主要参数

hunter_search

在 Web/Google 上搜索，返回链接、标题和摘要片段。

query (str), max_results (int, 默认: 5), region (str, 默认: 'br-pt')

scrape_website

进入网站，提取可读文本并扫描联系子页面（/contato、/sobre、/termos）。

url (str), deep_contacts (bool, 默认: true)

extract_contacts

分析 URL 或原始文本，并提取电子邮件、电话、WhatsApp、社交媒体和 CNPJ。

url (str, 可选), text (str, 可选)

consult_cnpj

通过 BrasilAPI / MinhaReceita 查询 Receita Federal 的数据库。

cnpj (str)

hunt_company

企业 360º 档案：搜索网站，提取联系方式、社交媒体、CNPJ 和股权结构。

company_name (str), domain_or_url (str, 可选)

hunt_person

调查某人的公开存在、LinkedIn 主页和网络提及。

name (str), context (str, 可选)

🚀 安装与运行

本项目使用超快速包管理器 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。

Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
F
license - not found
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • MCP DadosBR

    cristianoaredes
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables Brazilian business data lookup through CNPJ (company registry) and CEP (postal code) queries, with intelligent web search capabilities powered by Tavily for due diligence, compliance, and customer verification.
    51
    6
    MIT

  • LeadSpark MCP

    CodeSerg21
    F
    license
    A
    quality
    D
    maintenance
    Enables AI agents to research companies and find contacts with structured data from multiple free sources, including company info, tech stack, and email addresses.
    3

  • cnpj-br

    pipeworx-io
    A
    license
    Not graded
    quality
    C
    maintenance
    Brazilian company-registry lookup via Receita Federal, allowing AI agents to query CNPJ data.
    6
    MIT

  • MCP Brazil Public Data

    devantage
    A
    license
    A
    quality
    B
    maintenance
    Enables lookup of Brazilian public data including companies (CNPJ), postal codes (CEP), banking, economy, geography, and more through 15 tools and 2 guided prompts, powered by BrasilAPI with no API key required.
    15
    MIT

View all related MCP servers

Related MCP Connectors

  • Fiber AI

    Search companies, enrich contacts, and reveal emails and phones from your AI agent.

  • quanticdata-mcp

    Live web access for agents: scrape, SERP search, crawl/map, 74 collectors, datasets, proxies.

  • fetcher

    The web capability layer for AI agents: render, extract, DNS, SSL, WHOIS & more via x402.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rrcodeia/mcp-hunter'

If you have feedback or need assistance with the MCP directory API, please join our Discord server