Harvey: busca clientes de SEO con IA, gratis y en tu ordenador

Harvey es un agente de ventas open source. Busca negocios, analiza su web y te redacta los correos usando tu suscripción de Claude, sin pagar API. Lo he probado buscando clínicas dentales en Valencia para vender SEO local. Aquí tienes cómo funciona, cómo instalarlo en Windows y cómo sacarle partido.

1Qué es y qué hace

Harvey hace el trabajo de un comercial que busca clientes, pero en tu ordenador y en bucle. Cada 15 minutos se despierta, mira qué hace falta y lo hace:

• Busca negocios de un sector en una ciudad (dentistas en Valencia, abogados en Madrid…).
• Lee su web y apunta lo que le falta: datos estructurados, reserva online, blog parado, si ya tienen agencia, si pagan Google Ads…
• Busca a quién escribir y comprueba que el correo existe.
• Redacta una secuencia de 3 correos cortos, personalizados con lo que ha visto.
• Envía, lee las respuestas y contesta, siempre con tu aprobación salvo que le digas lo contrario.

Lo curioso es que no usa una clave de API: tira de tu suscripción de Claude (Pro o Max) a través de Claude Code, o de ChatGPT a través de Codex. Es decir, no pagas por cada palabra que escribe.

Proyecto de Ethan (ethanplusai), licencia MIT, versión 0.3.0 probada el 14 de octubre de 2026.

2Cómo funciona por dentro

Funciona por fases, y cada una te dice lo que cuesta antes de gastar:

1. Descubrir: quién existe. Es la única fase que puede costar dinero, y siempre te da un presupuesto antes.
2. Perfilar: qué son. Lee la portada, el robots.txt y el sitemap.xml de cada web. Gratis y sin IA.
3. Enriquecer: quién decide. Busca nombres y cargos en la página del equipo.
4. Verificar: si se les puede escribir. Aprende el formato de los correos de la empresa y comprueba uno.

Por debajo son cinco agentes: uno busca y puntúa (Scout), otro redacta (Writer), otro envía (Sender), otro lee respuestas (Handler) y otro saca estadísticas (Analyst). La IA solo se usa donde hace falta criterio, que es lo que hace que quepa en una suscripción.

Todo lo que sabe de ventas está en la carpeta skills/ en ficheros de texto: cómo escribir correos en frío, cómo responder objeciones, cómo cualificar. Si no te gusta cómo escribe, editas el fichero y ya está.

3Qué necesitas

• Python 3.11 o superior y Git.
• Claude Code instalado y con la sesión iniciada con tu cuenta de Claude Pro o Max.
• Para enviar de verdad: un dominio secundario y un buzón en él. Para probar no hace falta.

4Instalarlo en Windows

La forma fácil: clonas el repositorio, abres Claude Code dentro de la carpeta y le dices «set up Harvey for me». Trae instrucciones para que Claude haga de asistente de instalación.

A mano son cuatro comandos en PowerShell:

git clone https://github.com/ethanplusai/harvey
cd harvey
py -3.12 -m venv .venv
.venv\Scripts\python -m pip install -e .
copy .env.example .env

$env:PYTHONUTF8=1

5Configurarlo para vender SEO

Crea un fichero harvey.local.yaml en la carpeta de Harvey. Este manda sobre el de ejemplo y no se sube a GitHub. Este es el que usé, para una agencia de SEO local que busca clínicas dentales en Valencia. Lo importante: el envío está desactivado para poder probar sin miedo.

persona:
  name: "David"
  company: "Tu agencia SEO"
  role: "Consultor SEO"
  email: "tu@tudominio.com"
  linkedin: ""
  tone: "cercano, directo, sin rodeos, en español de España"

product:
  name: "SEO local para clínicas"
  description: "Posicionamos clínicas y despachos en Google Maps y en las búsquedas de su ciudad: ficha de Google optimizada, web técnica bien hecha (schema, velocidad) y contenidos que traen pacientes."
  pricing: "Desde 300 €/mes"
  key_benefits:
    - "Más llamadas y citas desde Google Maps"
    - "Web técnicamente correcta: datos estructurados, velocidad, sin errores"
    - "Informe mensual claro con lo que se ha hecho y lo que ha subido"
  objection_responses:
    "too expensive": "¿Cuánto vale para vosotros un paciente nuevo al mes? Con uno o dos ya se paga."
    "already have a solution": "Perfecto. ¿Os pasan un informe con posiciones y llamadas cada mes?"
    "not interested": "Sin problema. ¿Te mando la auditoría gratis por si te sirve más adelante?"
  offer:
    primary: "SEO local mensual desde 300 €/mes"
    entry: "Auditoría SEO gratis de la web y la ficha de Google"
    goal: "get_reply"

icp:
  industries:
    - "dentist"
  company_size: "1-50 empleados"
  titles: ["Director", "Directora", "Gerente", "Fundador", "Odontólog", "Dr.", "Dra."]
  geography:
    - "Valencia, España"

channels:
  email:
    enabled: false          # nada se envía mientras pruebas
    provider: "smtp"
    max_daily_sends: 10
    require_approval: true
  linkedin:
    enabled: false

usage:
  max_daily_claude_percent: 50
  heartbeat_interval_minutes: 15
  quiet_hours: { start: "21:00", end: "08:00", timezone: "Europe/Madrid" }

El sector va en inglés porque el buscador gratis solo entiende estas palabras: dentist, lawyer, plumber, electrician, roofer, hvac, contractor y landscaping.

6Elegir qué busca: las señales

Harvey sabe detectar 23 señales de un negocio, pero no recoge ninguna hasta que tú lo confirmas. Para SEO hay varias que son oro: le faltan datos estructurados, el blog lleva meses parado, no tiene reserva online, bloquea a las IA o paga Google Ads (tiene presupuesto).

Confirma todas las gratis de una vez:

.venv\Scripts\harvey signals --confirm free

7Buscar negocios

Mira las fuentes que tienes y lo que costaría antes de lanzar nada:

.venv\Scripts\harvey discover --providers
.venv\Scripts\harvey discover --estimate
.venv\Scripts\harvey discover --limit 60

Un consejo: OpenStreetMap es perfecto para probar, pero en España no siempre tiene la web de cada negocio apuntada (aquí, 10 de 53). Cuando vayas en serio, usa Serper (2.500 búsquedas gratis, sin tarjeta) o DataForSEO (1 $ de prueba). Este último saca el teléfono, la web, la nota de Google y si la ficha está reclamada.

8Lo que encontró en Valencia

De las webs que pudo leer sacó cosas que puedes usar en el primer mensaje:

Con el creador de segmentos eliges lo que tiene que cumplir un buen cliente (por ejemplo, «paga Google Ads» y «sin reserva online») y te cuenta al momento cuántos encajan.

9Ponerlo a trabajar

Abre el panel en una terminal y el bucle en otra:

.venv\Scripts\harvey dashboard     # http://localhost:5555
.venv\Scripts\harvey run

Una cosa que me gustó: mira cuánto llevas gastado de tu suscripción y se para si pasa del tope que le pongas. Yo tenía el 83 % gastado y el tope en 50 %, así que se fue a dormir una hora sin tocar nada.

10Encontrar a quién escribir

Para sacar el nombre y el correo de quien decide, Harvey lee la página del equipo de cada web y aprende el formato de sus correos. Viene preparado para webs en inglés (/team, /about-us…), así que para España conviene darle un empujón:

• Pídele a Claude Code que añada las rutas en español (/equipo, /quienes-somos, /equipo-medico…) y que acepte nombres con tilde. Es un cambio de dos líneas en harvey/agents/scout.py.
• Conecta Hunter (25 búsquedas gratis al mes) para saber el formato de los correos de cada empresa.
• Conecta Reoon (600 comprobaciones gratis al mes) o ZeroBounce para verificar que el correo existe.

Las claves van en el fichero .env. Harvey solo escribe a correos verificados: si no puede comprobar uno, lo marca como «suposición» y no lo usa.

11Los correos que escribe

Para ver cómo redacta, añadí a mano un contacto de prueba con un correo falso en una de las clínicas reales. Le pasó la clínica a Claude y en 30 segundos tenía la campaña.

Escribe bien: frases normales, una pregunta al final y nada de «espero que estés bien». Si quieres que meta en el correo los fallos que ha visto en su web (el blog parado, la falta de datos estructurados), ejecuta harvey train https://tuweb.com para que aprenda de tu negocio y retoca skills/signal_playbook.md.

12Antes de enviar nada

Si aun así vas a enviar correos (por ejemplo, fuera de España o con permiso):

1. Compra un dominio aparte para enviar. Nunca uses el principal.
2. Configura SPF, DKIM y DMARC. Sin los tres, Gmail te manda a spam.
3. Calienta el buzón de 2 a 4 semanas antes de enviar en serio.
4. Empieza con 10 a 20 correos al día y sube poco a poco.
5. Deja la aprobación manual activada hasta que te fíes de lo que escribe.

13Resumen y consejos

• Sin coste de API: trabaja con tu suscripción de Claude y se para solo antes de gastártela.
• Analiza webs gratis y te da fallos de SEO reales para empezar la conversación.
• Escribe correos cortos y naturales en español.
• Nada se envía sin ti, con tope diario y botón de parar.
• Todo se cambia editando ficheros de texto: cómo escribe, a quién busca, qué ofrece.

Para qué lo uso yo: le doy un sector y una ciudad y me devuelve la lista de negocios con lo que le falta a cada web, más un borrador de mensaje. Con eso llamo o escribo por su formulario y ya sé de qué hablarles. Para buscar a lo grande, añádele Serper o DataForSEO, y para los contactos, Hunter y Reoon.