Use o DomScan com agentes de IA

Use o DomScan com agentes de IA

Conecte o DomScan ao Claude, ChatGPT, Cursor, VS Code, Codex e Windsurf via MCP, dê aos agentes de programação as regras da API de que eles precisam e comece com prompts prontos para usar.

MCP ou API REST?

Muitas equipes usam os dois: MCP para explorar e prototipar em um chat ou editor, e a API REST no código que o agente escreve. Ambos usam a mesma chave de API e o mesmo saldo de créditos.

Conecte sua ferramenta de IA

Configuração por ferramenta

Todas as ferramentas se conectam ao mesmo servidor MCP em https://domscan.net/mcp. As que oferecem suporte a login abrem uma tela de login do DomScan na primeira vez que executam uma verificação. As demais enviam sua chave de API no cabeçalho X-API-Key.

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

{
  "servers": {
    "domscan": {
      "type": "http",
      "url": "https://domscan.net/mcp"
    }
  }
}

[mcp_servers.domscan]
url = "https://domscan.net/mcp"
env_http_headers = { "X-API-Key" = "DOMSCAN_API_KEY" }

{
  "mcpServers": {
    "domscan": {
      "serverUrl": "https://domscan.net/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Estes links e comandos nunca contêm sua chave de API. As ferramentas que oferecem suporte a login se conectam diretamente à sua conta do DomScan. Para usar uma chave, substitua YOUR_API_KEY por uma chave de suas chaves de API.

Instruções para agentes de programação

Cole isto em AGENTS.md, CLAUDE.md ou no arquivo de regras do seu editor para que os agentes de programação chamem o DomScan corretamente.

## DomScan API

Use o DomScan (https://domscan.net) para verificar disponibilidade de domínios, DNS, WHOIS e RDAP, SSL, segurança de e-mail e avaliação.

- URL base: `https://domscan.net`. Os endpoints ficam em `/v1`.
- Autenticação: envie `X-API-Key: $DOMSCAN_API_KEY` (ou `Authorization: Bearer $DOMSCAN_API_KEY`). Leia a chave do ambiente. Nunca a deixe fixa no código, nem a registre em logs ou a coloque em uma URL.
- Contrato: leia a descrição OpenAPI em https://domscan.net/v1/openapi.json antes de escolher um endpoint ou parâmetro, e não adivinhe nomes de parâmetros. Há um resumo do site para LLMs em https://domscan.net/llms.txt.
- MCP: o servidor remoto é https://domscan.net/mcp (HTTP streamable, login ou os mesmos cabeçalhos de chave de API).
- Créditos: a maioria dos endpoints consome créditos. Antes de trabalhos em lote ou repetidos, chame `POST /v1/estimate` com o `method`, o `path`, o `query` e o `body` da requisição, ou adicione `dry_run=true` aos endpoints de bulk, compare, recipe e preços. Os dois são gratuitos. Acompanhe os cabeçalhos de resposta `X-Credits-Charged` e `X-Credits-Remaining`.
- Bulk: verifique até 50 nomes de domínio completos com uma única requisição `POST /v1/status/bulk` em vez de repetir verificações individuais em um loop.
- Novas tentativas: envie um cabeçalho `Idempotency-Key` (por exemplo, um UUID) nas requisições POST que cobram créditos. Repetir a mesma requisição com a mesma chave em até 24 horas retorna a resposta armazenada sem cobrar novamente. Tente de novo apenas quando `error.retryable` for true e aguarde o `Retry-After` em um 429.
- Erros: todo corpo de erro tem o formato `{"error": {"type", "code", "message", "status", "retryable", "request_id", ...}}`. Ramifique a lógica por `error.code`, como `INVALID_PARAMETER`, `INSUFFICIENT_CREDITS` ou `RATE_LIMITED`, e não pela mensagem.
- Desconhecido não é ausente: os resultados incluem `classification.status` com o valor `present`, `absent` ou `unknown`. Trate `unknown` como "tente novamente mais tarde", nunca como disponível nem como inexistente, e nunca trate a ausência como prova de que um nome pode ser registrado ou reivindicado.
- Atualidade: os endpoints que podem responder com dados recentes aceitam `max_age` em segundos (`max_age=0` pede uma verificação nova) e retornam `cache_age_s`. Isso não altera o custo.
- Respostas menores: adicione `fields=a,b.c` ou `compact=true` à query string. Nenhum dos dois altera o custo.
- Mais informações: https://domscan.net/AGENTS.md e https://domscan.net/docs.

Prompts para testar

Copie um prompt ou abra-o no seu assistente. Conecte o DomScan primeiro para que o assistente possa executar as verificações.

1. Usando o DomScan, verifique se estes 50 nomes estão disponíveis como domínios .com: [cole os nomes]. Primeiro estime o custo em créditos e mostre para mim antes de executar qualquer coisa. Depois liste separadamente os resultados disponíveis, ocupados e desconhecidos, e não trate os resultados desconhecidos como disponíveis.

   Abrir no ClaudeAbrir no ChatGPTAbrir no Cursor

2. Use o DomScan para auditar a segurança de e-mail de example.com: SPF, DKIM, DMARC e status em listas de bloqueio. Explique cada problema em linguagem simples e sugira o registro DNS que o corrige.

   Abrir no ClaudeAbrir no ChatGPTAbrir no Cursor

3. Estou pensando em comprar example.com. Use o DomScan para verificar o WHOIS e as datas de registro, o DNS, o certificado SSL, a reputação e o valor estimado, e depois resuma os riscos e o que devo verificar antes de pagar.

   Abrir no ClaudeAbrir no ChatGPTAbrir no Cursor

4. Use o DomScan para encontrar domínios parecidos e de typosquatting de example.com que já estejam registrados. Classifique-os por risco e aponte os que têm site ou servidor de e-mail.

   Abrir no ClaudeAbrir no ChatGPTAbrir no Cursor

5. Adicione o DomScan a este projeto. Leia https://domscan.net/AGENTS.md e https://domscan.net/v1/openapi.json, e depois escreva um pequeno cliente tipado para POST /v1/status/bulk que leia DOMSCAN_API_KEY do ambiente, envie um cabeçalho Idempotency-Key e mantenha os resultados desconhecidos separados dos disponíveis. Adicione testes.

   Abrir no ClaudeAbrir no ChatGPTAbrir no Cursor

Recursos legíveis por máquina

Aponte os agentes para estes arquivos públicos em vez de copiar a documentação para os prompts.

• /AGENTS.md Guia público para agentes
• /llms.txt Resumo do site para LLMs
• /v1/openapi.json OpenAPI 3.0
• /mcp/tool-mapping.json Nomes antigos e novos das ferramentas MCP