1. Qué hace esta app

Lead Hunter hace tres cosas, en este orden:

1. Busca personas reales en LinkedIn según el rubro, el cargo y la ciudad que le pidas. Por ejemplo: dueños de clínicas dentales en Lima.
2. Lee el perfil de cada una y sus últimas publicaciones, y te dice quién es, qué le duele y qué tan buen cliente sería para vos (puntaje del 1 al 10).
3. Escribe un mensaje de contacto distinto para cada persona, mencionando algo real de su perfil. Vos lo revisás, lo copiás y lo pegás en LinkedIn.

Lo que la app no hace: enviar los mensajes sola. Eso lo hacés vos a mano, y está bien que así sea — un mensaje enviado a mano no te hace perder la cuenta de LinkedIn.

2. Probarla sin claves — empezá por acá

Antes de crear ninguna cuenta, mirá cómo funciona:

1. Andá a la pestaña Buscar.
2. Abajo del todo, tocá Cargar demo.
3. Te lleva solo a la pestaña Leads con 6 perfiles de ejemplo.
4. Tocá cualquier tarjeta: vas a ver el análisis, la publicación que usó como gancho y el mensaje ya escrito.

Esos 6 perfiles son inventados, no son personas reales, y no se buscó nada en LinkedIn. Es solo para que veas la pantalla. Cuando quieras sacarlos, tocá Borrar demo.

Y si preferís que te lo muestren en vez de leerlo: el botón Ver tour, arriba a la derecha, te lleva de la mano por cada parte de la app con globos explicativos. Son 2 minutos y se puede saltar en cualquier momento.

3. Las dos claves gratis

Para buscar de verdad hacen falta dos llaves. Las dos son gratis y ninguna pide tarjeta de crédito.

Llave 1 — Google Gemini (escribe los mensajes)

1. Entrá a aistudio.google.com/apikey con tu Gmail de siempre.
2. Tocá Create API key.
3. Copiá el texto largo que aparece. Empieza con AIza…

Llave 2 — Apify (entra a LinkedIn)

1. Registrate en console.apify.com. Te dan US$ 5 de crédito por mes, sin tarjeta.
2. Andá a Settings → Integrations.
3. Tocá el ojito para revelar el Personal API token y copialo. Empieza con apify_api_…

Dónde se pegan

En la carpeta lead-hunter hay un archivo llamado .env.example. Hacé una copia y ponele de nombre .env (solo eso, con el punto adelante). Abrilo con el Bloc de notas y pegá cada clave después del signo igual:

GEMINI_API_KEY=AIza...tu-clave-aca
APIFY_TOKEN=apify_api_...tu-token-aca

Guardá y cerrá. Ese archivo nunca se sube a internet ni a GitHub — queda solo en tu computadora.

4. Encender la app

Abrí PowerShell en la carpeta de ORASIC LAB y escribí:

node lead-hunter/server.js

Después abrí el navegador en http://localhost:5070

Arriba a la derecha vas a ver dos indicadores. Si dicen Apify conectado y IA gemini en verde, está todo listo. Si alguno está naranja, la clave no se leyó bien: revisá el archivo .env y volvé a encender la app.

Para apagarla, volvé a PowerShell y apretá Ctrl + C. Los leads quedan guardados.

5. Configurar tus Ajustes (una sola vez)

Andá a la pestaña Ajustes. Ya viene cargado con los datos de ORASIC Lab, pero leelo y ajustalo, porque de acá sale el tono de todos los mensajes.

• Tu nombre y cargo — con esto se firman los mensajes.
• Qué hace tu empresa — en qué rubros trabajás y qué construís.
• Oferta concreta — el campo más importante. Es lo que le proponés al lead en el primer contacto. Cuanto más específico, mejor sale el mensaje. «Un diagnóstico gratuito de 20 minutos» funciona mucho mejor que «servicios de software».
• Idioma — español si buscás en Perú o Colombia; inglés si algún día buscás afuera.

Tocá Guardar ajustes. Si algún día le vendés este sistema a un cliente, esta pantalla es lo único que cambia.

6. Tu primera búsqueda real

Andá a Buscar y completá:

• Rubro o palabra clave — qué hace el negocio del lead. Una sola idea: clinica dental, gimnasio, agencia de marketing. No pongas tres cosas juntas.
• Cargos — escribí uno y apretá Enter; se convierte en etiqueta. Podés poner varios: Fundador, Gerente General, CEO, Dueño. Apuntá siempre a quien decide y firma.
• País / Región / Ciudad — arrancá solo con el país. Si te trae poco, después probá ciudad.
• Cuántos leads — empezá con 10. Antes de buscar mirá el costo estimado que aparece al lado del botón.
• Traer últimas publicaciones — dejalo activado. Es lo que hace que el mensaje mencione algo real y no suene a robot.

Tocá Buscar leads. La barra te va mostrando en vivo qué está haciendo: buscando perfiles → trayendo publicaciones → redactando mensajes uno por uno. Con 20 leads tarda unos 3 minutos. No cierres la pestaña.

Cuando termina, te lleva sola a Leads.

7. Trabajar el tablero

Cada persona es una tarjeta. Las columnas son el recorrido del lead:

Nuevos → Contactados → Respondieron / Sin respuesta → Reunión agendada

Arrastrá las tarjetas de una columna a otra con el mouse. Ese arrastre es todo tu seguimiento: si no lo movés, en dos semanas no vas a saber a quién le escribiste.

El número al lado del nombre (9/10) es el puntaje de encaje que puso la IA. Empezá siempre por los de 8 y 9 — son los que ya publicaron el problema que vos resolvés.

Al tocar una tarjeta se abre el detalle con:

• Análisis — quién es y por qué te conviene.
• Gancho — el dato exacto del perfil que se usó para personalizar.
• Últimas publicaciones — leelas antes de escribir, siempre.
• Mensaje — editable. Lo que cambies se guarda solo.
• Regenerar — si el mensaje no te convence, pide otro.
• Nota interna — «me respondió que lo ve en marzo», «pedir que me presente al socio».

El buscador de arriba filtra por nombre, empresa o cargo. Exportar CSV te baja todo a Excel.

8. Enviar el mensaje en LinkedIn

1. Abrí la tarjeta y leé el mensaje completo. Nunca envíes sin leer: la IA a veces se equivoca de empresa o de contexto.
2. Editalo si hace falta. Es el primer contacto con un cliente potencial, vale el minuto.
3. Tocá Copiar mensaje — respeta los saltos de línea que hayas puesto.
4. Tocá Abrir LinkedIn; se abre el perfil en otra pestaña.
5. Botón Mensaje en LinkedIn, pegá con Ctrl+V, enviá.
6. Volvé a la app y arrastrá la tarjeta a Contactados.

Perfil bajo: de 5 a 10 mensajes por día como máximo, repartidos, no todos juntos. LinkedIn detecta el envío masivo y restringe cuentas. Diez mensajes buenos por día son 200 al mes — más que suficiente.

El atajo: Modo ráfaga

Hacer ese proceso tarjeta por tarjeta es lento. El botón ⚡ Modo ráfaga, arriba de la pestaña Leads, hace lo mismo pero en un solo toque de tecla:

1. Toma todos los leads en Nuevos, ordenados del puntaje más alto al más bajo.
2. Te muestra uno a la vez con su mensaje.
3. Apretás Enter: copia el mensaje, abre el perfil en LinkedIn y marca el lead como Contactado — los tres pasos juntos.
4. → salta ese lead sin marcarlo (si no te convence el mensaje). ← vuelve al anterior. Esc sale en cualquier momento.
5. Cuando llegás al mensaje 10 del día, un aviso te avisa que es el tope recomendado — la app no te bloquea, pero te lo recuerda.

Esto no reemplaza el paso de pegar el mensaje adentro de LinkedIn: seguís siendo vos quien aprieta "Enviar" ahí. Es justo esa parte manual la que mantiene la cuenta segura — nunca va a haber un botón en esta app que envíe por vos.

9. Cuánto cuesta y cómo no pagar nunca

• Gemini: gratis. El plan gratuito alcanza de sobra para el volumen que vas a manejar.
• Apify: US$ 5 de crédito gratis por mes, que se renuevan solos. Cada búsqueda cuesta US$ 0.10 por cada 25 perfiles, más medio centavo por perfil.

Con los US$ 5 mensuales entran unos 625 leads por mes. Como no cargaste tarjeta en ningún lado, no hay forma de que te cobren sin querer.

Pedí siempre múltiplos de 25

Ese US$ 0.10 es un peaje fijo por página, y una página trae hasta 25 perfiles: pagás lo mismo si sacás 1 que si sacás 25. Por eso buscar de a 10 desperdicia casi la mitad del crédito.

Mi recomendación: una búsqueda de 25 cada dos semanas. Son US$ 0.40 al mes — el 8 % del crédito — y te da leads frescos sin acumular una lista que no llegás a trabajar.

La alarma de crédito

Abajo del botón de buscar hay una barra que lleva la cuenta sola: cuánto llevás gastado del mes, cuánto te queda y para cuántos leads más alcanza. Se pone naranja al 70 % y rosa al 90 %.

Y si una búsqueda te dejaría sin saldo, el botón se deshabilita y no arranca, avisándote cuántos leads sí te alcanzan. El contador se reinicia solo el día 1 de cada mes, igual que el crédito de Apify.

Aclaración importante: aunque te pasaras, nadie te cobra. Sin tarjeta cargada, Apify simplemente deja de buscar hasta el mes siguiente. La alarma está para que no te quedes sin herramienta a mitad de mes, no para evitar un cobro.

10. Si algo falla

Los indicadores de arriba están en naranja

Falta la clave o está mal pegada. Revisá el archivo .env: sin espacios, sin comillas, y apagá y encendé la app.

La búsqueda no devuelve ningún perfil

Casi siempre es la ubicación. Borrá ciudad y región y dejá solo el país. Si sigue vacío, cambiá la palabra clave por una más común (dentista en vez de odontología estética avanzada).

Los mensajes salen genéricos

Dos causas: el campo Oferta en Ajustes está muy vago, o el perfil no tenía publicaciones. Mejorá la oferta y usá Regenerar.

Dice que se agotó el crédito de Apify

Ya usaste los US$ 5 del mes. Se renuevan solos el mes que viene. No pagues nada.

Cerré PowerShell y la página no abre

Se apagó la app. Volvé a correr node lead-hunter/server.js. Los leads siguen ahí.

¿Pierdo los leads si apago la computadora?

No. Están en lead-hunter/data/leads.json. De todos modos, exportá el CSV de vez en cuando.

11. Reglas de convivencia

• Leé antes de enviar, siempre. Un mensaje que se equivoca de empresa quema al lead para siempre.
• Volumen bajo y constante gana. 10 por día, todos los días, le gana a 200 en una tarde.
• Si alguien te dice que no, no insistas y movelo a Sin respuesta.
• Los datos de los perfiles son datos personales de terceros. Están en tu computadora y no se suben a ningún lado. Usalos para contactar, no los compartas ni los revendas.
• Scrapear LinkedIn va contra sus términos de servicio, aunque la herramienta no toque tu cuenta. A volumen bajo el riesgo es mínimo; a volumen alto, no. Otra razón para ir de a poco.