octoparse doctor --json を実行して、環境の状態を構造化された形で確認してください。
環境を診断する
"ok": false のチェック項目を見つけ、再試行前に問題の依存関係を解決してください。
認証エラー
AUTH_REQUIRED または AUTH_INVALID
CLIが有効な認証情報を見つけられませんでした。以下を実行してください。
OCTO_ENGINE_API_KEY または OCTO_ENGINE_ACCESS_TOKEN が設定されており、期限切れでないことを確認してください。
APIキーが保存されない
CLIはキーを保存前に検証します。キーが拒否される場合は、Octoparseコンソールでキーが有効かどうかを確認してください。--stdin を使用している場合は、キーに余分な空白や改行が含まれていないことを確認してください。
OAuthセッションの期限切れ
octoparse auth login --oauth を再実行してトークンを更新してください。
ChromeおよびブラウザError
Chromeのダウンロードが失敗する CLIはChrome for Testingを自動でダウンロードします。失敗した場合：- ネットワーク、プロキシ、VPN設定を確認します。
- ローカルにインストール済みのChromeを使用します：
octoparse doctor --chrome-path /path/to/chrome - Linuxサーバーの場合は、CDNへのアクセスを確認して再試行します。
LINUX_ARM64_UNSUPPORTED
ローカル抽出（run、detect）はLinux arm64をサポートしていません。Chrome for TestingにはLinux arm64パッケージが存在しないためです。
対処方法：
- Linux x64環境またはコンテナを使用する。
- クラウド抽出に切り替える：
octoparse cloud start <taskId>
detect が利用可能な場合にXvfbを自動的に使用します。必要に応じてインストールしてください。
--manual）はインタラクティブなディスプレイが必要です。Linux上での手動ワークフローにはデスクトップまたはVNCセッションを使用してください。
タスクと実行のエラー
TASK_INVALID または終了コード 3
タスクがCLI v1でサポートされていないkernel browserまたはlegacy workflowを使用しています。現在のOctoparseデスクトップアプリでタスクを再作成し、次のコマンドで検証してください。
--output ./runs を使用した場合は、履歴とエクスポートにも同じパスを渡してください。
エクスポートエラー
UNSUPPORTED_EXPORT_FORMAT
サポートされている形式は xlsx、csv、html、json、xml です。--format の値を確認してください。
エクスポートファイルが空
エクスポート前にタスクが行を収集しているか確認します。
savedRows > 0 があるかを確認してください。
detectエラー
DETECT_FAILED または候補が見つからない
ページが自動アクセスをブロックしているか、ログインゲートを表示しているか、コンテンツを動的に読み込んでいる可能性があります。試してください：
--manualで自分でログインやポップアップを処理する。--goalでより明確な抽出対象を指定する。- エージェントコンテキストで生成されたスクリーンショット（
context.screenshot.path）を確認する。
LOGIN_SESSION_REQUIRED
セッション保存付きの手動detectを使用してください。
ヘルプを取得する
octoparse --help または octoparse <command> --help で使用方法の詳細を確認できます。
環境の問題を報告する際は、octoparse doctor --json の出力をOctoparseサポートに共有してください。
Octoparseサポートに連絡する
CLIバージョン（
octoparse --version）と octoparse doctor --json の出力を含めてください。