steel-browser

Steel Browser

Steel CLI のブラウザツールを使って、今すぐ実際のウェブ作業を完了します。

セットアップ

Steel がない場合、または認証されていない場合：

steel --version
steel login
steel doctor --preflight

CLI またはインストール済みのスキルに問題がある場合は、次を実行します：

steel skills doctor

次のスモークテストが成功すれば完了です：

steel scrape https://example.com

適切な方法を選ぶ

• 静的なページコンテンツ：steel scrape <url>
• スクリーンショット：steel screenshot <url>
• PDF：steel pdf <url>
• 複数ステップの操作、ログイン、フォーム、または JavaScript を多用するページ：steel browser ...
• ボット検出、CAPTCHA、プロキシ、またはログインの信頼性に関する問題：steel-session-debugging で証拠を収集してから、steel-reliability を使用します
• 再利用可能なアプリケーションコード：steel-developer を使用します

タスクを完了できる最小限のツールから始めます。操作や状態が必要な場合に限り、スクレイピング／スクリーンショット／PDF からインタラクティブなブラウザーセッションに切り替えます。

インタラクティブセッションのワークフロー

steel browser start --session my-task --session-timeout 3600000
steel browser navigate https://example.com --session my-task
steel browser snapshot -i --session my-task
steel browser click @e1 --session my-task
steel browser wait --load networkidle --session my-task
steel browser snapshot -i --session my-task
steel browser stop --session my-task

ルール：

• すべてのコマンドで、同じ --session <name> を必ず使用します。
• ページ遷移後や DOM の変更後は、要素参照が期限切れになるため、必ず新しい snapshot -i を取得します。
• 不安定な CSS セレクターより、スナップショットの @eN 参照を優先します。
• 一連の操作にアクションと直後の再スナップショットが必要な場合は、steel browser batch を使用します。
• ユーザーからセッションを開いたままにするよう明示的に求められない限り、セッションを解放／停止します。

トラブルシューティング

1. インストールまたは CLI とスキルの不一致に関する問題には、steel skills doctor を実行します。
2. 認証／API の問題には、steel doctor --preflight を実行します。
3. アクティブなセッションには、steel browser sessions と steel browser live --session <name> を使用します。
4. 完了したセッションで問題が発生した場合は、steel-session-debugging を読み込みます。
5. ボット／プロキシ／CAPTCHA／ID の修正には、steel-reliability を読み込みます。

参考資料

• references/steel-browser-commands.md：コマンドリファレンス。
• references/steel-browser-lifecycle.md：セッションライフサイクルの運用ルール。
• references/troubleshooting.md：復旧手順。
• references/migration-agent-browser.md：上流の agent-browser からの移行。