Claude Code

Email checker with Claude Code. MCP Server setup for email verification in Claude.

Claude Code es el asistente de programación CLI de Anthropic que puede llamar directamente a EmailVerify para verificar correos durante tu flujo de trabajo de desarrollo.

¿Qué es Claude Code?

Claude Code es un asistente de IA basado en terminal que ayuda a los desarrolladores con:

Escribir y depurar código
Ejecutar comandos de shell
Operaciones con archivos
Interacciones con API

Configuración

Opción 1: Servidor MCP (Recomendado)

Agrega el servidor MCP de EmailVerify a Claude Code:

claude mcp add emailverify -- npx -y @emailverify/mcp-server

O agrégalo a tu ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "emailverify": {
      "command": "npx",
      "args": ["-y", "@emailverify/mcp-server"],
      "env": {
        "EMAILVERIFY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Opción 2: CLI de EmailVerify

Instala el CLI de EmailVerify:

npm install -g @emailverify/cli
bv config set api-key YOUR_API_KEY

Claude Code puede usar el comando bv directamente.

Ejemplos de Uso

Verificar un Solo Correo

Tú: Verifica si john@example.com es un correo válido

Claude Code:

Verificaré esa dirección de correo para ti.

Usando la herramienta verify_email...

✅ john@example.com es VÁLIDO
- Entregable: Sí
- Desechable: No
- Puntuación: 0.95

Este correo parece ser válido y seguro de usar.

Verificar Múltiples Correos

Tú: Revisa estos correos de mi archivo .env

Claude Code:

Déjame leer tu archivo .env y verificar cualquier dirección de correo encontrada.

Leyendo .env...
Encontradas 3 direcciones de correo:
- TEST_EMAIL=user@example.com
- ADMIN_EMAIL=admin@company.com
- SUPPORT_EMAIL=help@temp-mail.org

Verificando cada uno...

| Correo | Estado | Notas |
|--------|--------|-------|
| user@example.com | Desconocido | Dominio de ejemplo |
| admin@company.com | Válido | Correo corporativo |
| help@temp-mail.org | Inválido | Correo desechable |

Recomendación: Reemplaza la dirección de temp-mail con un correo real para pruebas.

Limpiar Lista de Correos

Tú: Limpia la lista de correos en contacts.csv y elimina las direcciones inválidas

Claude Code:

Procesaré tu archivo contacts.csv y verificaré cada correo.

Leyendo contacts.csv... Encontradas 150 direcciones de correo.

Verificando correos (esto puede tomar un momento)...

Resultados:
- Válidos: 142 correos
- Inválidos: 5 correos
- Desconocidos: 3 correos

Creando cleaned_contacts.csv solo con correos válidos...
¡Hecho! Eliminados 8 correos problemáticos.

Correos inválidos eliminados:
- fake@asdfgh.xyz (el dominio no existe)
- test@mailinator.com (desechable)
- bounce@invalid.net (buzón no encontrado)
...

Verificar Antes de Commit

Tú: Antes de hacer commit, verifica los correos de prueba en mis test fixtures

Claude Code:

Déjame revisar tus test fixtures en busca de direcciones de correo.

Escaneando el directorio test/...
Encontrados correos en test/fixtures/users.json

Verificando 5 correos de prueba...

⚠️ Advertencia: Problemas potenciales encontrados:

1. test@mailinator.com - Este es un correo desechable
   Considera usar @example.com para test fixtures (RFC 2606 reservado)

2. admin@real-company.com - Este parece ser un correo de empresa real
   Probablemente no quieras correos reales en tus test fixtures

Sugerencias:
- Usa @example.com, @example.org para correos de prueba
- Usa el patrón user{n}@example.com
- Nunca uses correos de empresas reales en pruebas

Patrones de Flujo de Trabajo

Hook de Pre-commit

Pídele a Claude Code que configure la validación de correos en tu flujo de trabajo:

Tú: Agrega un hook de pre-commit que verifique cualquier dirección de correo nueva en archivos de configuración

Claude Code:

Crearé un hook de pre-commit para verificación de correos.

Creando .husky/pre-commit...

#!/bin/sh
# Verificar nuevas direcciones de correo en archivos de configuración
emails=$(git diff --cached --diff-filter=ACMR -- "*.json" "*.yaml" "*.env*" | \
  grep -oE '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}')

if [ -n "$emails" ]; then
  echo "Verifying new email addresses..."
  for email in $emails; do
    result=$(bv verify "$email" --quiet)
    if [ $? -eq 1 ]; then
      echo "❌ Invalid email found: $email"
      exit 1
    fi
  done
  echo "✅ All emails verified"
fi

¡Hecho! El hook verificará correos antes de cada commit.

Integración CI/CD

Tú: Agrega verificación de correos a mi flujo de trabajo de GitHub Actions

Claude Code:

Agregaré un paso de verificación de correos a tu flujo de trabajo.

Actualizando .github/workflows/ci.yml...

- name: Verify Test Emails
  env:
    EMAILVERIFY_API_KEY: ${{ secrets.EMAILVERIFY_API_KEY }}
  run: |
    npm install -g @emailverify/cli
    # Extraer y verificar correos de test fixtures
    grep -rhoE '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}' test/ | \
      sort -u | while read email; do
        if ! bv verify "$email" --quiet; then
          echo "Invalid email in tests: $email"
          exit 1
        fi
      done

No olvides agregar EMAILVERIFY_API_KEY a los secretos de tu repositorio.