DomScan

Inteligência de domínio para DNS, WHOIS/RDAP, TLS, reputação, avaliação e proteção de marca.

Documentação

Servidor MCP DomScan

Inteligência de domínio para agentes de IA. Conecte o DomScan ao Claude, Cursor, VS Code e a qualquer cliente Model Context Protocol para executar consultas de DNS, WHOIS/RDAP, SSL/TLS, subdomínios, disponibilidade, avaliação, segurança de e-mail e proteção de marca diretamente pelo seu assistente.

O DomScan é uma plataforma de inteligência de domínio que expõe seus dados por meio de uma API REST e de um servidor MCP hospedado. Este repositório documenta o servidor MCP: como conectá-lo, quais ferramentas ele expõe e como usá-lo em pipelines de agentes.

Site: https://domscan.net
Endpoint MCP: https://domscan.net/mcp (Streamable HTTP)
Transporte: Streamable HTTP (remoto)
Autenticação: descoberta OAuth (recomendada) ou uma chave de API do DomScan

Início rápido

Clientes com suporte a OAuth

Adicione https://domscan.net/mcp como um servidor MCP remoto. O DomScan publica metadados de recurso protegido OAuth e de servidor de autorização, para que clientes compatíveis possam descobrir e concluir a autenticação sem uma chave de API configurada manualmente.

{
  "mcpServers": {
    "domscan": {
      "url": "https://domscan.net/mcp"
    }
  }
}

Claude Desktop / Claude Code com chave de API

Adicione à sua configuração MCP (claude_desktop_config.json ou .mcp.json):

{
  "mcpServers": {
    "domscan": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://domscan.net/mcp",
        "--header",
        "Authorization: Bearer ${DOMSCAN_API_KEY}"
      ],
      "env": { "DOMSCAN_API_KEY": "your-api-key" }
    }
  }
}

URL remota nativa com chave de API

{
  "mcpServers": {
    "domscan": {
      "url": "https://domscan.net/mcp",
      "headers": { "Authorization": "Bearer your-api-key" }
    }
  }
}

Obtenha uma chave de API no painel do DomScan. O OAuth é preferido quando o cliente oferece suporte a ele. As chaves de API continuam disponíveis para clientes que precisam de autenticação explícita por cabeçalho.

Wrapper MCP local

Este repositório inclui um wrapper stdio executável para clientes que não conseguem se conectar diretamente ao endpoint Streamable HTTP hospedado. Ele encaminha solicitações para https://domscan.net/mcp usando DOMSCAN_API_KEY.

npm install
DOMSCAN_API_KEY=your-api-key npm start

Se nenhuma chave de API for configurada, o wrapper ainda será iniciado e exporá apenas a ferramenta somente leitura domscan_mcp_status. Isso permite que registros MCP inspecionem e validem o servidor sem conceder acesso às operações de inteligência de domínio.

Docker

docker build -t domscan-mcp .
docker run --rm -i -e DOMSCAN_API_KEY=your-api-key domscan-mcp

O wrapper local usa autenticação por chave de API. Clientes que oferecem suporte a Streamable HTTP remoto e OAuth devem continuar se conectando diretamente a https://domscan.net/mcp; o OAuth continua sendo a opção recomendada para esses clientes.

O que ele pode fazer

O servidor expõe ferramentas de inteligência de domínio nas seguintes áreas:

DNS: consultas de registros (A, AAAA, MX, TXT, NS, CNAME, CAA), dumps completos de registros, verificações de propagação, segurança de DNS.
WHOIS / RDAP: dados de registro, histórico WHOIS, WHOIS reverso, RDAP.
SSL/TLS: auditoria de certificados, inspeção de cadeia, nota, verificações de expiração, varredura profunda, busca de certificados.
Subdomínios: enumeração e descoberta de subdomínios.
Disponibilidade e avaliação: disponibilidade de domínio (individual e em lote), avaliação, sugestões de nomes.
Segurança de e-mail: validação de SPF, DKIM, DMARC e postura DNSSEC.
Proteção de marca: detecção de typosquatting, monitores e varreduras de marca.
Infraestrutura: consulta de IP, detecção de hospedagem, ASN, detecção de tecnologia/stack, consulta de fornecedor MAC.

Consulte a documentação da API do DomScan e o guia de configuração MCP.

Por que MCP

O MCP permite que um assistente de IA chame o DomScan diretamente: pergunte "o acme.io está disponível e quem é o dono dos domínios semelhantes?" e o agente executa ferramentas de disponibilidade, WHOIS e typosquatting e responde em uma única interação. O mesmo servidor alimenta fluxos de trabalho automatizados (monitoramento, due diligence, proteção de marca) sem código de integração personalizado.

Licença

MIT. Consulte LICENSE.