email-monitor

name	email-monitor
description	Day-start sourcing dalla casella email DEDICATA del team (l'utente vi inoltra i propri job alert). Sorgente a più alta accuratezza: l'alert è già pre-filtrato sull'intento dell'utente. Poll IMAP di QUALSIASI piattaforma (LinkedIn/Glassdoor/Indeed + board nazionali/di città/di nicchia), crea posizioni col tag source, idempotente per Message-ID. Il VOLUME lo bilancia il Capitano (C-16): a inizio giornata si legge l'email PRIMA dello scraping web; su flood si ingeriscono solo le salienti, così il funnel arriva allo SCORE.
allowed-tools	Bash(python3 /app/shared/skills/email_monitor.py *), Bash(python3 /app/shared/skills/scout_dedup.py *), Bash(python3 /app/shared/skills/db_insert.py *), Bash(python3 /app/shared/skills/db_query.py *)

email-monitor — leggere i job alert inoltrati, a inizio giornata

L'utente crea un'email dedicata (es. [e-mail]) e imposta sul proprio client delle regole di inoltro che ci mandano i job alert (LinkedIn, Glassdoor, Indeed e qualsiasi altra piattaforma che notifica via mail). Tu leggi quella casella e trasformi gli alert in posizioni. È la sorgente più accurata (l'alert è già filtrato sul target dall'utente) e la più economica in token (niente scraping alla cieca).

📍 Opzionale ma consigliata. Se non è configurata, il team lavora come prima (web sourcing). Niente blocco.

Quando

• A inizio finestra di lavoro (day-start): leggi l'email PRIMA dello scraping web. Gli alert notturni sono già lì.
• Poi al massimo ogni ~30 min (l'IMAP server-side rate-limita oltre, e nuovi alert non arrivano più spesso). Non pollare più frequente.
• Claim della sorgente in STEP 0 (scout-coord): scout_workspace.py claim <agent> email:<box> — un solo Scout per la casella, niente collisioni.

Procedura

1. È configurata?

python3 /app/shared/skills/email_monitor.py status

configured=false → la casella non c'è: salta, fai web sourcing normale. any_platform=true significa che processiamo l'intera inbox dedicata (nessun from_filters ristretto) → ogni mittente che l'utente inoltra viene letto.

2. Stima il VOLUME (economico, no body fetch)

python3 /app/shared/skills/email_monitor.py count

Ritorna new_total + by_sender. Serve a te e al Capitano per capire se è un volume gestibile o un flood. Su flood, il Capitano (C-16) ti dice quante / quali ingerire: l'obiettivo è che le posizioni arrivino a uno score, non accumularne 200 mai valutate.

3. Poll → leads

python3 /app/shared/skills/email_monitor.py poll --since-days 1

Ogni riga JSONL è un lead: {"url","source","subject","sender","received_at"}.

• source = linkedin-email / glassdoor-email / indeed-email per i provider noti, email:<domain> per qualsiasi altra piattaforma (estrazione generica).
• L'idempotency (Message-ID in state/email_monitor_seen.json) garantisce che un re-run non riprocessi gli stessi alert.

4. Per ogni lead → i 5 gate di position-insert

Tratta ogni url esattamente come un hit web: dedup (scout_dedup.py) → verifica link attivo → fetch JD → 4 filtri Scout → INSERT in positions (status=new). Mantieni il tag --source del lead (linkedin-email, email:<domain>): è ciò che rende misurabile l'accuratezza per sorgente sulla dashboard. JD obbligatoria (SC-02): se non riesci a recuperarla, non inventarla.

Bilanciamento (giudizio del Capitano, C-16)

Leggere è gratis (poll/count), elaborare fino allo score costa. Il decisore è il Capitano, non una formula:

• Volume ragionevole → elaborale tutte (più segnale è meglio).
• Flood → porta avanti solo le salienti, con due criteri dai soli metadati (gratis): (1) match col profilo/target dell'utente (ruolo/keyword nel subject/titolo) e (2) freschezza (received_at più recente). Le altre si riprendono nelle finestre successive.
• Obiettivo: le posizioni arrivano a uno score, non si accumulano non valutate. Niente soglie fisse — il Capitano decide quante in base al budget.

Anti-pattern

• ❌ Pollare più spesso di ~30 min (rate-limit IMAP, nessun nuovo alert).
• ❌ INSERT senza JD completa (SC-02) o senza il tag source.
• ❌ Creare a valanga su flood ignorando il giudizio del Capitano (C-16): si gonfia la coda di posizioni che non arriveranno mai a uno score.
• ❌ Bypassare il dedup (SC-05): gli stessi alert si ripetono ogni giorno.

See also

• position-insert — i 5 gate di INSERT (il tuo flusso standard).
• scout-coord — claim della sorgente email:* a boot (anti-collisione).
• circles-and-sources — il sourcing web, da fare DOPO l'email a inizio giornata.