Recurso gratis · Agente de IA

Monta tu Prospectador de Instagram

Un agente que cada mañana te busca clientes en frío en Instagram, los filtra con IA, te redacta el primer mensaje y te los deja listos en un Google Sheet. Corre solo en la nube, 24/7.

⏱️~1 hora de montaje
📊Dificultad media
💸Casi todo gratis
Cómo funciona · cada día 8:00am
🔎

1. Busca

Rastrea publicaciones recientes de tus hashtags y saca candidatos.

🤖

2. Filtra

La IA descarta a quien no es tu cliente ideal y redacta el primer DM.

📋

3. Te entrega

Una fila por prospecto en tu Google Sheet + aviso por WhatsApp.

Ojo: el agente NO manda los DM por ti. Mandar mensajes en frío desde la API quema tu cuenta de Instagram. Te deja la lista lista-para-enviar; tú copias, pegas y mandas desde tu IG. Es lo seguro.
Antes de empezar — marca lo que ya tienes
Los 6 pasos
1

Descargar e instalar

Bajas el proyecto y preparas sus piezas.

Copia esto, pégalo en tu Terminal y dale Enter. La primera línea baja el proyecto; la última instala lo que necesita para funcionar.

git clone <el-repo>   # o descarga el ZIP y descomprímelo
cd prospectador-ig
npm install
2

Conseguir tus llaves de acceso

Son las "contraseñas" que conectan el agente con cada servicio.

Saca cada una de aquí (todas tienen plan gratis o cobran centavos por uso):

LlaveDónde sacarla
APIFY_TOKENapify.com → Settings → Integrations
Es quien lee Instagram por ti.
ANTHROPIC_API_KEYconsole.anthropic.com → API Keys
La IA (Claude) que filtra y escribe. Carga un poco de saldo.
SHEET_WEBHOOK_URLLa generas en el paso 3 👇
CALLMEBOT_*callmebot.com
Para que te avise por WhatsApp. Gratis.
RUN_TOKENLo inventas tú con este comando 👇
openssl rand -hex 16   # genera un código aleatorio, cópialo

Ahora crea tu archivo de llaves a partir del ejemplo y pega cada valor dentro:

cp .dev.vars.example .dev.vars   # luego ábrelo y rellénalo
3

Conectar tu Google Sheet

Aquí caen los prospectos, uno por fila.
  1. Crea un Google Sheet nuevo y vacío.
  2. Arriba: Extensiones → Apps Script. Pega el código que viene en apps-script/Code.gs.
  3. Dale Implementar → Nueva implementación → Aplicación web.
  4. En "Quién tiene acceso" elige Cualquier usuario. (NO "con cuenta de Google", esa pide login y rompe la conexión.)
  5. Copia la URL que termina en /exec → esa es tu SHEET_WEBHOOK_URL.
4

Probar que todo conecta

Antes de publicar, una prueba en tu compu.

Corre la primera línea para prenderlo local. En otra ventana de Terminal, corre la segunda para dispararlo (cambia TU_RUN_TOKEN por el que generaste):

npm run dev
curl -X POST "http://localhost:8787/run?key=TU_RUN_TOKEN"

Si todo va bien responde {"ok":true,...}, escribe en tu Sheet y te llega un WhatsApp. Ya funciona.

5

Publicar en la nube

Para que corra solo, sin tu compu prendida.

Conéctate a Cloudflare y súbelo. El bloque for sube tus llaves de forma segura, una por una.

npx wrangler login
npm run deploy

# sube cada llave como secreto:
for k in APIFY_TOKEN ANTHROPIC_API_KEY SHEET_WEBHOOK_URL \
         CALLMEBOT_PHONE CALLMEBOT_APIKEY RUN_TOKEN; do
  npx wrangler secret put $k
done
6

Que se dispare solo cada mañana

El último toque: el horario automático.

Lo más fácil es un disparador externo gratis en cron-job.org. Crea un job así:

  • URL: https://<tu-worker>.workers.dev/run?key=<RUN_TOKEN>
  • Método: POST
  • Horario: diario 13:00 UTC (= 8:00am hora Colombia)

Listo. Cada mañana te llega la lista de prospectos lista para enviar. 🎯

Hazlo tuyo

Todo lo editable está en un solo archivo: src/config.ts. Ahí pones tus hashtags, las cuentas de tu competencia, cómo es tu cliente ideal, el mínimo de seguidores, cuántos prospectos quieres por día y el tono de los mensajes. Cambias lo que quieras y vuelves a correr npm run deploy.

¿Te trabaste?
No sé nada de código, ¿igual lo puedo montar?

Sí. No tienes que escribir código: solo copias y pegas los comandos (cada bloque tiene botón de Copiar) y rellenas tus llaves. La parte de "tocar archivos" es mínima. Tómate la hora con calma.

¿Cuánto cuesta tenerlo prendido?

Cloudflare, CallMeBot y cron-job.org son gratis. Apify tiene crédito mensual gratis y la IA de Claude cobra centavos por uso (unos pocos dólares al mes según cuántos prospectos saques).

¿Es seguro para mi cuenta de Instagram?

Sí, porque el agente nunca manda DMs ni inicia sesión en tu IG. Solo lee publicaciones públicas y te arma la lista. Tú envías los mensajes a mano desde tu cuenta.

El comando me dio error, ¿qué hago?

Lo más común: te faltó una llave en .dev.vars, o el Google Sheet quedó en "con cuenta de Google" en vez de "Cualquier usuario" (paso 3). Revisa esos dos primero.