browser-search-and-handoff

ブラウザー検索と引き継ぎ

概要

ユーザーが対象の属性を指定し、Codex が条件に合う候補を集め、機密性の高い手順やボット対策の手順に進む前に、管理された形で引き継ぐ、繰り返し可能な検索ワークフローを複数のウェブサイトで実行します。このスキルを使うことで、AI が確実に実行できることと、人間が確認または手動で完了する必要があることを切り分けられます。

ワークフロー

1. 検索対象と受付条件を定義する

まず、次の項目を確認します。

• ドメイン：アパート、求人、パートナー探し、ベンダー、その他の対象種別
• 行動の目標：候補の絞り込み、連絡、応募、登録、最初の問い合わせの準備
• 検索範囲：最初に検索するポータルまたはマーケットプレイス
• 希望する出力：ローカルファイル、CSV、Markdown テーブル、Google Sheets

ユーザーから条件がまだ提示されていない場合は、サイトを開く前にいったん作業を止め、条件を尋ねてください。次の項目を抽出します。

• 必須条件：満たさない場合に対象から除外する要件
• 希望条件：対象から除外はしないものの、順位を上げる要素
• 除外条件：避けたい決定的な要因やカテゴリ
• 地理的条件と距離のルール
• 時間的制約：入居日、利用可能時期、開始日、回答期限
• フォームで安全に再利用できるユーザープロフィールの項目
• 停止条件：収集する候補数と、閲覧を終了するタイミング

ドメイン固有の受付パターンについては、criteria-patterns.md を使用してください。

2. 追跡形式を作成または選択する

ユーザーから別の保存先を明示的に指定されない限り、tracker-template.csv を基にしたローカル CSV をデフォルトとして使用します。ローカルファイルは確認、差分の比較、作業の再開が容易なため、まずはこちらを優先してください。

Google Sheets は、ユーザーから希望があった場合、または共同編集が重要な場合にのみ使用してください。

同じレコードで、候補の発見状況とその後のフォローアップ状況の両方を追跡します。各行には、候補となる対象と、その次のアクションを行うページを1つずつ記録します。

デフォルトのスキーマについては、tracker-fields.md を使用してください。

3. ポータルを検索して候補を収集する

ブラウザーを使った実作業では、場当たり的な閲覧手順よりも、agent-browser スキルとその CLI ワークフローを優先してください。

検索中は、次の点に注意してください。

• 掲載ページの URL、掲載元のポータル、対象が条件に合うことを示す主な根拠を記録します
• 文章によるメモに頼らず、重要な属性を追跡ファイルに標準化して記録します
• ページに値の記載がない場合は、不確実性を明示します
• 複数のポータルにまたがる重複や、掲載の重複を取り除きます
• 指定された件数に達した場合、または検索結果が明らかにユーザーの基準に合わなくなった場合は終了します

早い段階で絞り込みすぎないでください。ユーザーが後から確認したい可能性がある場合は、条件に微妙に合わない候補も残します。

4. 適合度を評価し、結果を含めた理由を説明する

有望な候補ごとに、次の内容を記録します。

• 満たしている必須条件
• 満たしている希望条件
• 不足している情報または不確かな情報
• その候補を確認する価値がある理由の簡潔な要約

不透明なスコアリングよりも、根拠が明確な説明を優先してください。根拠と合わせて使うのであれば、通常は high、medium、low のようなシンプルな適合度ラベルで十分です。

5. 有望な候補ごとに次のアクションを行うページを見つける

条件に合う掲載を見つけたら、実際にアクションを行うページを探します。

• 応募フォーム
• 問い合わせフォーム
• 掲載サイト外にある企業または家主のウェブサイト
• 登録手続き
• 問い合わせの前に入力が必要なプロフィールページ

発見時の URL と、アクションを行う URL の両方を保存します。これらは別々の場合が多く、後で作業を再開するうえでどちらも重要です。

また、妨げとなる条件も記録します。

• アカウントが必要
• メール認証が必要
• 電話番号の認証が必要
• 履歴書または添付ファイルが必要
• 学生限定または特定地域限定の制限
• ペイウォールまたはプレミアム機能

6. 自動化の境界を守る

このスキルは、デフォルトで人間が介在するものとして扱ってください。

通常、AI に任せても安全なタスクには次のものがあります。

• ユーザーがすでに提示した、リスクの低い既知の項目を入力する
• 承認を得るためのカバーレター、短いプロフィール、最初のメッセージ案を作成する
• ユーザーが提示したデータに直接対応するドロップダウンの値を選択する
• 人間による確認が必要な箇所が現れるまで進捗を保存する

通常、人間のみが行うべきタスクには次のものがあります。

• CAPTCHA やボット対策の確認
• OTP、2FA、メールコード、電話コードの入力
• 法的な同意、承諾、権利放棄、証明
• 支払い
• 本人確認
• 現実世界に影響を及ぼす操作の最終送信

認証情報は慎重に取り扱ってください。

• パスワードはユーザー自身が直接入力するようにしてください
• ユーザーから明示的に生成パスワードを求められた場合は提案できますが、確認なしに黙って再利用または送信しないでください
• フォームを通過するためにプロフィール情報を捏造しないでください

7. 引き継ぎを明確に準備する

自動化を一時停止する必要がある場合は、簡潔な引き継ぎパッケージを返してください。

• 適合度順に並べた候補リスト
• 各項目の現在のステータス
• 人間による対応が必要な操作 URL
• 正確なブロッカーまたは確認事項
• 人間が次に行うべき 1 つの操作

ユーザーが後で再開したい場合は、同じ掲載情報を探し直すのではなく、トラッカーから続行してください。

ドメインに関する注意事項

criteria-patterns.md を使用して、アパート、仕事、パートナー探し、その他のドメインに合わせて、要件の聞き取りとスコアリングのモデルを調整してください。

tracker-fields.md を使用して、候補リストを引き渡す前に入力すべき列を判断してください。

求人への応募では、このスキルが求人の発見、スコアリング、候補リストの追跡、操作 URL の収集を担当します。ユーザーが実行対象となる特定の求人／応募 URL を選んだら、スキーマに基づく項目の確認、非公開プロフィールの読み込み、書類のアップロード、記録、送信または停止の判断については、job-application-operator に切り替えてください。

失敗モード

次の問題を想定し、明示的に対処してください。

• ユーザーが目標は伝えているものの、測定可能な基準を示していない
• ポータルのフィルターが、ユーザーの実際の要件を十分に反映していない
• 掲載ページで重要な属性が展開パネルやギャラリーの中に隠れている
• 操作ページが別のドメインにある
• 操作先のページを表示する前にポータルへのログインが必要である
• ボット対策システムにより、完全自動の送信がブロックされる
• ユーザーが明示的に人間の管理下に置くべき操作を依頼している

ブロックされた場合は、トラッカーにその内容を記録し、勢いを失わないよう次の候補に進んでください。

出力規則

長い文章の羅列より、簡潔で構造化された出力を優先してください。

各結果には、最低限、次の情報を含めてください。

• 対象の名前またはタイトル
• 掲載 URL
• 操作 URL
• 適合度の概要
• ブロッカー
• 推奨する次のステップ

トラッカーを信頼できる情報源として使用してください。要約はトラッカーから作成し、要約を情報源にしないでください。