Scansionare i portali di lavoro

Questa guida ti accompagna nella configurazione di portals.yml e nell'esecuzione dello scanner dei portali per trovare automaticamente nuove posizioni aperte.

Configurare portals.yml

portals.yml è il file che stabilisce che cosa cerca lo scanner e dove lo cerca. Lo crei una sola volta a partire dal modello incluso, poi lo modifichi in base ai ruoli a cui punti.

Esegui questo comando dalla cartella del progetto:

cp templates/portals.example.yml portals.yml

Apri portals.yml in un qualsiasi editor di testo. Il file ha tre sezioni. I passaggi qui sotto le spiegano una per una.

Impostare il filtro sui titoli

Il filtro sui titoli è il criterio con cui lo scanner decide se vale la pena mostrarti un annuncio. Confronta il titolo della posizione con due elenchi di parole chiave.

Trova la sezione title_filter nella parte alta del file:

title_filter:
  positive:
    - "AI"
    - "ML"
    - "Product Manager"
  negative:
    - "Junior"
    - "Intern"
  seniority_boost:
    - "Senior"
    - "Staff"
    - "Lead"

Sostituisci l'elenco positive con le parole chiave che corrispondono ai ruoli a cui punti. Per passare, un annuncio deve contenere almeno una parola chiave di questo elenco. Il controllo non distingue tra maiuscole e minuscole, quindi "AI" intercetta anche "ai engineer".

Sostituisci l'elenco negative con le parole chiave che escludono un annuncio. Se una di queste compare nel titolo, l'annuncio viene scartato, anche se conteneva una parola chiave positiva.

Lascia seniority_boost così com'è, a meno che tu non voglia aggiungere o togliere livelli di seniority. Queste parole chiave non escludono nulla: si limitano a far salire nei risultati gli annunci che le contengono.

Esempio: se cerchi ruoli da sviluppatore Rails, il tuo filtro potrebbe essere questo:

title_filter:
  positive:
    - "Rails"
    - "Ruby"
    - "Full Stack"
    - "Backend"
  negative:
    - "Junior"
    - "Intern"
    - "PHP"
    - "Java"
  seniority_boost:
    - "Senior"
    - "Staff"
    - "Lead"

Aggiungere le aziende da monitorare

La sezione tracked_companies è l'elenco delle aziende specifiche che vuoi far controllare allo scanner a ogni esecuzione. Lo scanner va direttamente sulla pagina delle posizioni aperte di ciascuna azienda e legge i ruoli disponibili.

Trova la sezione tracked_companies nella parte bassa del file. Ogni voce ha questo aspetto:

tracked_companies:
  - name: Anthropic
    careers_url: https://job-boards.greenhouse.io/anthropic
    api: https://boards-api.greenhouse.io/v1/boards/anthropic/jobs
    enabled: true

  - name: OpenAI
    careers_url: https://openai.com/careers
    enabled: true

Per aggiungere un'azienda, copia una voce esistente e cambia i valori:

Per trovare il careers_url di un'azienda, vai sul suo sito, clicca su Careers, Jobs o «Lavora con noi» e copia l'URL della pagina che elenca le posizioni aperte. È quello l'URL da usare.

Per disattivare un'azienda senza eliminarla, imposta enabled: false:

  - name: Stripe
    careers_url: https://stripe.com/jobs/search
    enabled: false

Controllare le query di ricerca

La sezione search_queries esegue ricerche web più ampie per trovare ruoli in aziende che non sono nel tuo elenco di quelle monitorate. Il modello include molte query già pronte.

Per iniziare non serve modificare questa sezione. Le query già pronte coprono i principali portali di lavoro, tra cui Greenhouse e Ashby.

Quando vorrai personalizzarle, ogni query ha questo aspetto:

search_queries:
  - name: Greenhouse — Rails Engineer
    query: 'site:job-boards.greenhouse.io "Rails Engineer" OR "Ruby on Rails" remote'
    enabled: true

Per disattivare una query che non ti serve, imposta enabled: false. Per aggiungerne una nuova, copia una voce esistente, dalle un nuovo name e aggiorna il testo di query.

Avviare una scansione

Ci sono due modi per avviare una scansione. Usa quello più adatto a ciò che ti serve.

Opzione A — Eseguire direttamente lo script

npm run scan

Esegui il comando dalla cartella del progetto. Lo script legge portals.yml, interroga direttamente l'API di ogni azienda e scrive i nuovi annunci in data/pipeline.md. Non consuma token AI e impiega circa 30 secondi.

Questa opzione funziona per tutte le aziende la cui pagina delle posizioni aperte gira su una piattaforma per cui lo scanner ha un provider integrato: Greenhouse, Ashby e Lever, più decine di altri sistemi ATS e portali di lavoro come Workable, Workday e SmartRecruiters. L'elenco completo è in SUPPORTED_JOB_BOARDS.md. Le aziende senza un provider corrispondente vengono saltate, e la scansione indica quante sono.

Vedere i risultati in anteprima prima di salvarli:

npm run scan -- --dry-run

Esegue la scansione completa ma non scrive nulla su disco. Usalo per verificare le impostazioni dei filtri prima di salvare i risultati.

Scansionare una sola azienda:

npm run scan -- --company Anthropic

Sostituisci Anthropic con il nome di una qualsiasi azienda del tuo elenco tracked_companies. La corrispondenza non distingue tra maiuscole e minuscole.

Opzione B — Eseguire la scansione con l'AI dentro Claude Code

Apri Claude Code nella cartella del progetto e scrivi:

/career-ops scan

Questa versione visita direttamente la pagina delle posizioni aperte di ogni azienda usando un browser, quindi funziona anche con le aziende che non hanno un'API pubblica. Esegue inoltre le search_queries del tuo portals.yml per trovare ruoli in aziende che non sono nel tuo elenco di quelle monitorate.

Usa questa opzione quando:

• Un'azienda del tuo elenco usa una piattaforma per cui lo script non ha un provider, e quindi la scansione con lo script la salta
• Vuoi scoprire nuove aziende, non solo controllare quelle che conosci già
• La scansione con lo script non ha trovato qualcosa che ti aspettavi di vedere

Leggere il risultato della scansione

Al termine della scansione vedrai un riepilogo come questo:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Portal Scan — 2026-04-13
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Companies scanned:     42
Total jobs found:      318
Filtered by title:     291 removed
Duplicates:            4 skipped
New offers added:      23

New offers:
  + Anthropic | AI Engineer | San Francisco, CA
  + ElevenLabs | Solutions Architect | Remote
  ...

→ Run /career-ops pipeline to evaluate new offers.

Ecco che cosa significa ogni riga:

Se New offers added è 0, cerca prima di tutto questo avviso nel risultato della scansione:

⚠️  1 target(s) returned zero jobs without a successful HTTP response: Acme

Significa che il portale di quell'azienda non ha mai risposto correttamente, quindi lo zero non dimostra che non abbia posizioni aperte. L'azienda viene registrata come unverified_zero in data/portal-health.tsv e l'episodio si aggiunge alla sua serie di errori consecutivi. Controlla quel portale prima di cambiare i filtri.

Se l'avviso non c'è, il tuo filtro sui titoli potrebbe essere troppo restrittivo. Prova ad aggiungere una parola chiave all'elenco positive e avvia di nuovo la scansione.

Dove finiscono i nuovi annunci: ogni nuovo annuncio viene aggiunto come riga in data/pipeline.md. È l'elenco degli annunci in attesa di valutazione.

A che cosa serve data/scan-history.tsv: ogni URL che lo scanner vede, che sia stato aggiunto, filtrato o saltato, viene registrato qui. È così che lo scanner evita di mostrarti due volte lo stesso annuncio nelle scansioni successive. Fa eccezione un annuncio rimosso dall'impostazione location_filter o max_posting_age_days di portals.yml: viene registrato come skipped_location o skipped_age e può ricomparire quando cambi quell'impostazione. Non devi modificare questo file.

Valutare i nuovi annunci trovati dalla scansione

Dopo che una scansione ha aggiunto nuovi annunci a data/pipeline.md, il tuo elenco di annunci in sospeso, esegui il comando pipeline per valutarli uno per uno rispetto al tuo profilo. Questo passaggio usa Claude per leggere la descrizione della posizione, confrontarla con il tuo cv.md e con modes/_profile.md e produrre per ogni ruolo un riepilogo con punteggio.

Apri Claude Code nella cartella del progetto e scrivi:

/career-ops pipeline

Claude legge tutti gli URL in sospeso in data/pipeline.md, visita ogni annuncio e lo valuta. I risultati arrivano a lotti. Ogni lotto mostra una tabella come questa:

Lotto 1 completato (Anthropic, ElevenLabs, Mistral):

Ecco che cosa significa ogni colonna:

Per leggere la valutazione completa di un ruolo hai due possibilità:

• Aprire direttamente il file del report: lo trovi nella cartella reports/ usando il numero della tabella.
• Usare la dashboard: esegui ./dashboard/career-dashboard dalla cartella del progetto per sfogliare tutti i tuoi report in un'interfaccia da terminale. Puoi filtrare per punteggio e per stato e aprire qualsiasi report senza uscire dal terminale.

Cosa fare dopo la valutazione

Quando /career-ops pipeline ha finito, ogni annuncio ha un punteggio da 1 a 5. Il report completo di ogni ruolo è nella cartella reports/. Il punteggio indica quanto il ruolo corrisponde al tuo profilo.

Usa il punteggio come punto di partenza:

Ecco che cosa fa ogni comando:

• /career-ops apply — Apre il modulo di candidatura e scrive risposte su misura per il tuo profilo. Si ferma prima dell'invio, così puoi rivedere tutto.
• /career-ops contacto — Trova su LinkedIn un hiring manager o un membro del team e prepara la bozza di un breve messaggio di contatto che invierai tu.
• /career-ops deep — Fa una ricerca approfondita sull'azienda e sul ruolo. Usalo quando sei indeciso e vuoi più informazioni prima di scegliere.
• /career-ops tracker — Mostra lo stato di ogni ruolo nella tua pipeline. Eseguilo ogni volta che vuoi vedere a che punto sei.