↗ Check Contatos

Check Contatos para agentes de IA

Diagnóstico dos canais de contato de um site (WhatsApp, telefone, e-mail, formulários, botões, experiência no celular e HTTPS) a partir só do endereço público. A análise é passiva: lê páginas públicas e não envia mensagens nem formulários. O resultado vem estruturado para máquinas: código de cada verificação, tipo de correção, comportamento esperado, critérios de aceite e a correção exata quando a evidência a determina.

1. Cadastre o agente

O cadastro é aberto e devolve uma chave na hora, mostrada uma única vez. Cada chave tem limite próprio (30 diagnósticos por hora e 200 por dia).

curl -X POST https://iafnrtypzwdugsehyvvd.supabase.co/functions/v1/api/v1/agents \
  -H "content-type: application/json" \
  -d '{"name":"Seu nome","email":"voce@empresa.com.br","company":"Empresa","agent_name":"Meu agente","purpose":"Auditar os sites dos meus clientes","accept_terms":true}'

2. API REST

Base: https://iafnrtypzwdugsehyvvd.supabase.co/functions/v1/api · Especificação: openapi.json

curl -X POST https://iafnrtypzwdugsehyvvd.supabase.co/functions/v1/api/v1/diagnostics \
  -H "authorization: Bearer $CHECKCONTATOS_API_KEY" -H "content-type: application/json" \
  -d '{"url":"https://www.exemplo.com.br/"}'
curl https://iafnrtypzwdugsehyvvd.supabase.co/functions/v1/api/v1/diagnostics/<id> -H "authorization: Bearer $CHECKCONTATOS_API_KEY"

O primeiro resultado sai em segundos; a análise completa continua por até alguns minutos. Consulte de novo enquanto poll_after_seconds não for nulo. Quando complete for verdadeiro, GET /v1/diagnostics/<id>/report devolve o link do PDF. O catálogo das verificações está em GET /v1/checks.

3. MCP

Servidor remoto (HTTP): https://iafnrtypzwdugsehyvvd.supabase.co/functions/v1/mcp. Ferramentas: register_agent, diagnose_site, get_diagnosis, get_report_link e list_checks.

Claude Code:

claude mcp add --transport http checkcontatos https://iafnrtypzwdugsehyvvd.supabase.co/functions/v1/mcp \
  --header "Authorization: Bearer $CHECKCONTATOS_API_KEY"

Clientes que aceitam MCP remoto por arquivo de configuração (Cursor e outros):

{
  "mcpServers": {
    "checkcontatos": {
      "url": "https://iafnrtypzwdugsehyvvd.supabase.co/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer cc_live_..."
      }
    }
  }
}

Servidor local pela CLI (Claude Desktop e clientes só com stdio):

{
  "mcpServers": {
    "checkcontatos": {
      "command": "npx",
      "args": [
        "-y",
        "checkcontatos",
        "mcp"
      ],
      "env": {
        "CHECKCONTATOS_API_KEY": "cc_live_..."
      }
    }
  }
}

4. CLI

npx checkcontatos register
npx checkcontatos diagnose www.exemplo.com.br --wait
npx checkcontatos report <id> --out relatorio.pdf

A chave fica em CHECKCONTATOS_API_KEY ou no arquivo de configuração gravado pelo register. Use --json para saída de máquina.

Limites e privacidade

O mesmo site é analisado no máximo uma vez por minuto. Os dados do cadastro do agente são tratados conforme a política de privacidade. Um link bem formado não comprova que alguém atende: o diagnóstico não envia mensagens.