Guía BD

Cómo funciona el motor de Funding Predicts + HyroTrader — y cómo se usa.

Un motor de Business Development que corre dos negocios con el mismo código (HyroTrader, ya operando · Funding Predicts, en construcción): encuentra KOLs y afiliados candidatos, los califica, y a los buenos los lleva a Notion (donde el equipo los trabaja) y a la cola de outreach. Nada se envía ni se paga solo: el humano aprueba.

1El flujo en 7 pasos

Leadgen

Scrapers por plataforma (YouTube, Telegram, X, Discord…) encuentran candidatos → tabla bd_leads.

a mano

Scoring

Da fit_score + tier (IA primero, heurística de respaldo). Detecta competidores.

a mano

Crear tarjeta en Notion

Prospecto priority → tarjeta en Notion (Status = Lead, con perfil + resumen).

a mano

Promover a la cola

fit ≥ 70 → entra a la cola de outreach bd_aff_leads.

a mano

Outreach

El cerebro redacta un borrador → tú apruebas con 1 clic → se envía (Telegram / Email / X / Discord).

botón

Write-back de Status

Cuando SÍ se contactó de verdad → avanza el Status en Notion (Lead → Outreach…).

automático · 15 min

Import (solo Hyro)

Trae los afiliados que ya existen en el CRM de Hyro a la cola.

automático · 30 min

2Qué corre solo vs a mano

Automático (VPS, timer)	A mano (tú lo disparas)
Write-back de Status (15 min) — solo avanza, no crea ni borra	Scoring (usa IA, cuesta)
Import de afiliados Hyro (30 min) — solo trae existentes	Crear tarjetas en Notion
	Promover a la cola de outreach

Lo automático es de bajo riesgo (avanzar / importar). Lo de a mano escribe cosas nuevas en el CRM y en la cola → por eso lleva un checkpoint humano.

3La secuencia de comandos

Cuando entra un lote nuevo de leads, se corren en este orden desde clients/funding-predicts/build/. Cada paso tiene una versión ver (no escribe) y una aplicar.

Paso 2 · Calificar (scoring)

ver primero

python run_intake.py --rescore --dry-run --business fp

aplicar (con IA)

python run_intake.py --rescore --llm --business fp

Paso 3 · Crear tarjetas en Notion

ver primero (este NO escribe por defecto)

python notion_create_forward.py --business fp

aplicar

python notion_create_forward.py --business fp --apply

Paso 4 · Promover a la cola

ver primero

python promote_to_queue.py --business fp --min-score 70 --dry-run

aplicar

python promote_to_queue.py --business fp --min-score 70

Hyro: los mismos comandos con --business hyro en vez de --business fp. Los pasos 6 y 7 (write-back e import) corren solos en el VPS — no los ejecutas tú.

Ojo con el "por defecto" de cada script (no son iguales): run_intake y promote_to_queue escriben por defecto (usa --dry-run para solo ver); notion_create_forward no escribe hasta que le pones --apply.

4Qué tiene botón y qué no

Acción	¿Botón?	Dónde
Aprobar borrador / enviar mensaje	Sí	Chats
Aprobar pago a KOL	Sí	Payments
Marcar "enviado" (X / Discord)	Sí	Chat
Crear perfil KOL / deal / payout en Notion	Sí	Botón "→ Notion"
Crear tarjeta (create-forward)	Sí	Pestaña Leads · "Pipeline (Fase B)"
Promover a la cola	Sí	Pestaña Leads · "Pipeline (Fase B)"
Scoring (calificar leads)	No	Terminal (paso 2) — usa IA

Los botones de la pestaña Leads encolan un job que ejecuta el worker del VPS (mismo mecanismo que "→ Notion"). ⚠️ Hoy el worker está en modo escritura: al confirmar, crea las tarjetas / promueve de verdad (no es un preview). Los guardias evitan tocar afiliados Hyro, competidores o lo excluido. El scoring sigue a mano porque usa IA.

5Glosario mínimo

`bd_leads`	Tabla donde caen todos los candidatos que encuentran los scrapers.
`fit_score`	Nota 0–100 de qué tan buen afiliado sería. La pone el scoring.
`tier`	Categoría según el score: priority (≥70), standard (50–69), pending (dudoso), discard (descartar).
cola de outreach	`bd_aff_leads`: la fila de prospectos listos para contactar.
create-forward	Crear la tarjeta en Notion desde nuestra base (paso 3).
write-back	Al revés: nuestra base avanza el Status de la tarjeta en Notion (paso 6, automático).
guardias	Filtros que evitan ensuciar: no meten afiliados Hyro ya existentes, ni competidores (firmas rivales), ni lo excluido a propósito.

Los pasos automáticos corren en el VPS con código commiteado — si cambia algo de ellos, hay que hacer git push y actualizar el VPS. Lo de a mano corre en tu PC y no necesita deploy. · Seguridad: las llaves viven en ~/.config/lynoia/*.env y nunca se commitean. · Dashboard: bd.lynoia.com