チャレンジ対応WebBridge
概要
このスキルを使用すると、ブラウザタスク中に認証ページが自動操作を妨害した場合でも、スムーズに作業を継続できます。チャレンジページを検出し、ユーザーに制御をクリーンに委ね、チャレンジが解除されるのを待ってから、同じKimi WebBridgeセッションで元のタスクを再開します。
ワークフロー
- ユーザータスク全体を通して、安定した1つの
session名を再利用します。単一のブラウジングタスクを複数のセッション名に分割しないでください。 - ナビゲーション後、ページタイトル、URL、表示テキストが不審な場合は、
scripts/detect_verification_page.pyを実行します。 - チャレンジが検出されなければ、通常のブラウジングを続行します。
- チャレンジが検出された場合:
- サイトが手動認証を待機していることをユーザーに明確に伝えます。
- 現在のタブとセッションを維持します。
- ユーザーが操作できるよう、必要に応じてページを表示状態にします。
- ユーザーが明示的に準備を要求した場合にのみ、ページを開く、レイアウトを待つ、チャレンジ外のニュートラルな領域にフォーカスするなど、送信を伴わないアクションを実行します。
- このスキルがチャレンジを自動的に回避、解決、または無効化できると主張しないでください。
scripts/wait_for_clearance.pyを実行して、中間ページが消えるかタイムアウトが経過するまでポーリングします。- ページがクリアされたら、新しい
snapshotを取得し、元のタスクを再開します。
セーフデフォルト
- 広範なページダンプよりも、コンパクトな
snapshotとevaluateプローブを優先します。 checkLoading、turnstile、captcha、verify、checking your browserなどのタイトルやURLの手がかりを強いシグナルとして扱います。- ユーザー向けの言葉はすべて落ち着いて具体的に保ちます。タスクを妨げているものと、ユーザーが次に何をすべきかを説明します。
- シークレット、クッキー、個人データをヘルパースクリプトやリポジトリファイルに保存しないでください。
- このスキルをアンチボット回避ツールとして提示しないでください。
ツール
- デーモン呼び出しには
scripts/webbridge_request.pyを使用します。特にWindowsでは、リクエストボディをUTF-8の一時ファイルからポストする必要があります。 - 現在のページがクリアかチャレンジ中かを分類するには、
scripts/detect_verification_page.pyを使用します。 - ユーザー委譲後にサイトが再び準備完了になったことを検出するには、
scripts/wait_for_clearance.pyを使用します。
参考資料
- 検出の手がかりと復旧パターンについては
references/challenge-patterns.mdを参照してください。 - ユーザー向けの短い委譲文言については
references/user-messaging.mdを参照してください。