octoparse detect はOctoparse拡張ブラウザを開き、ページを検査してローカルタスクファイルを生成します。Octoparseデスクトップアプリを使わずにURLからタスクを作成したい場合に使用します。
v0.1.32では、CAPTCHA、アクセス制限、セキュリティ検証、サービスエラーのページをタスク生成前に除外するようになりました。弱い候補領域やページ全体のナビゲーションシェルも、より厳密に除外します。複雑なページやログインフローでは引き続き手動確認が必要な場合があります。
AIエージェントでは
--auto ではなく、--agent または prepare / preview / apply ワークフローを使用してください。自動モードはCLIを直接操作する場合の自動選択用です。
detect には有効なOctoparseアカウントと認証情報、およびローカルChromeが必要です。Linux arm64はサポートされていません。プラットフォーム要件についてはインストールを参照してください。自動モード
CLIが最適な候補データ領域を選択してタスクファイルを生成します。--json を使用します。
--output を省略した場合は detected_<host>.json が自動的に作成されます。
ブラウザモードを選択する
OCTOPARSE_BROWSER、保存済みの octoparse browser use 設定、independent の順です。userモードはWindowsとmacOSで利用できます。詳細は octoparse browser --help を参照してください。
手動モード
ブラウザオーバーレイが開き、ログインの完了、ポップアップの処理、データ領域の選択を自分で行えます。--save-session でCookieを保存し、以降のローカル実行でセッションを再利用できます。
Cookieセッションはすべてのサイトをカバーするわけではありません。特にlocalStorage、デバイスバインディング、新規認証が必要なページでは機能しない場合があります。
生成されたタスクの検証と実行
タスクファイルを生成したら、実行前に検証します。AIエージェントワークフロー
LLM駆動または自動化ワークフローでは、--auto の代わりにエージェントコントラクトを使用します。まずcapabilitiesを確認します。
machineContract.recipes.createTaskFromUrlWithAgent が含まれており、エージェント向けの推奨ワークフローが記載されています。
ワンショット（最速）
コンテキストファイルを読み込みプランを書くことができる信頼済みローカルランナーと組み合わせて--agent を使用します。
監査可能なステップ実行
監査や修正が必要な場合は、prepare / preview / apply シーケンスを使用し、タスクを一度に生成するのではなく段階的に進めます。1
エージェントコンテキストを準備する
エージェントの計画用にWebページのコンテキストを書き出します。
context.json には候補データ領域、フィールドのサンプル、スクリーンショット、decisionSummary が含まれます。2
プランを作成する
context.json をもとに plan.json を作成します。octopus.detect.agent-plan.v1 スキーマを使用します。フィールドを選択する前に context.visualArtifacts.annotatedScreenshotPath のアノテーション付きスクリーンショットを確認し、プランに visualReview の証拠を含めてください。3
プランをプレビューする
最終的なタスクファイルを生成する前にプランを検証します。
data.pass が false の場合は、適用前にプランを修正してください。4
プランを適用する
最終的なローカルタスクファイルを生成します。生成された
task.json は、その後ローカルCLI実行で検査・検証したり、使用したりできます。detectのトラブルシューティング
次のステップ
最初のタスクを実行する
生成したタスクをローカルで実行し、ステータスを確認してデータをエクスポートします。
コマンドチートシート
detect、run、cloud、data、auth コマンドの完全リファレンスです。