octoparse detect apre il browser con l’estensione Octoparse, esamina la pagina e genera un file di attività locale. Usalo quando vuoi creare un’attività da un URL senza l’app desktop Octoparse.
Nella v0.1.32, detect ha iniziato a rifiutare le pagine con CAPTCHA, accesso limitato, verifiche di sicurezza ed errori di servizio prima della generazione dell’attività. La classificazione dei candidati rifiuta inoltre in modo più rigoroso le regioni deboli e i contenitori di navigazione che occupano l’intera pagina. Le pagine complesse e i flussi di accesso possono comunque richiedere un controllo manuale.
Per gli agenti AI, usa
--agent o il flusso prepara / anteprima / applica invece di --auto. La modalità automatica è destinata alla selezione diretta tramite CLI.
detect richiede un account Octoparse valido e le relative credenziali. È inoltre necessario Chrome locale. detect non supporta Linux arm64. Consulta Installazione per i requisiti della piattaforma.Modalità automatica
La CLI sceglie la regione dati candidata migliore e genera un file di attività:--json per una risposta strutturata:
--output viene omesso, viene creato automaticamente un file detected_<host>.json.
Scegli una modalità browser
Usa Chrome for Testing indipendente oppure riutilizza un profilo del browser di sistema con accesso effettuato:octoparse browser --help: flag del comando, OCTOPARSE_BROWSER, impostazione octoparse browser use salvata e infine independent. La modalità utente è disponibile su Windows e macOS.
Modalità manuale
La modalità manuale apre un pannello sovrapposto nel browser in cui puoi completare l’accesso, chiudere i popup e selezionare personalmente la regione dati:--save-session per memorizzare i Cookie per i siti che richiedono l’accesso, in modo che le future esecuzioni locali possano riprodurre la sessione:
Le sessioni basate sui Cookie non coprono tutti i siti, in particolare le pagine che richiedono localStorage, associazione al dispositivo o una nuova verifica.
Convalida l’attività generata
Dopo aver generato un file di attività, convalidalo prima dell’esecuzione:Flusso di lavoro con agente AI
Per i flussi di lavoro guidati da LLM o automatizzati, usa il contratto dell’agente invece di--auto. Inizia leggendo le funzionalità:
machineContract.recipes.createTaskFromUrlWithAgent, il flusso di lavoro consigliato per gli agenti.
In un solo passaggio (più veloce)
Usa--agent con un runner locale attendibile in grado di leggere un file di contesto e scrivere un piano:
Passaggi verificabili singolarmente
Per scenari di verifica o correzione, usa la sequenza prepara / anteprima / applica invece di generare l’attività in un unico passaggio.1
Prepara il contesto dell'agente
Esporta il contesto della pagina web per la pianificazione dell’agente.Questo genera
context.json con le regioni dati candidate, campioni dei campi, screenshot visivi e un decisionSummary.2
Scrivi un piano
Crea un
plan.json basato su context.json.Usa lo schema octopus.detect.agent-plan.v1. Apri il percorso dello screenshot annotato in context.visualArtifacts.annotatedScreenshotPath prima di scegliere i campi e includi nel piano le prove visualReview.3
Visualizza il piano in anteprima
Convalida il piano prima di generare il file di attività finale.Se
data.pass è false, rivedi il piano prima di applicarlo.4
Applica il piano
Genera il file di attività locale finale.Il file
task.json generato può quindi essere esaminato, convalidato o usato in un’esecuzione CLI locale.Risoluzione dei problemi di detect
Passaggi successivi
Esegui la tua prima attività
Esegui un’attività generata in locale, controlla lo stato ed esporta i risultati.
Riferimento rapido dei comandi
Riferimento completo per i comandi detect, run, cloud, data e auth.