web-browsing

Web 閲覧スキル

Web リサーチのための自動フォールバック機構です。

重要: ツールの可用性

ツールの存在を確認するために mcps フォルダーを決してチェックしないでください。 ツールは常に利用可能です - 直接呼び出してください:

• WebFetch - Cursor 内蔵のフェッチツール (最速)
• cursor-browser-extension - Cursor 内蔵ブラウザー
• user-chrome-devtools - Chrome DevTools (代替)

フォールバックチェーン

1. WebFetch (fast, preferred)
   ↓ fails/error
2. Browser MCP (cursor-browser-extension)
   ↓ captcha/block
3. ai_interaction (request user help)

ステップ 1: WebFetch (デフォルト)

WebFetch url="https://example.com"

次の場合はステップ 2 に進みます:

• HTTP エラー (4xx、5xx)
• コンテンツが空または切り詰められている
• 認証が必要
• レート制限

ステップ 2: ブラウザー MCP

cursor-browser-extension MCP ツールを直接使用します:

1. browser_navigate → target URL
2. browser_snapshot → get page content
3. browser_take_screenshot → visual reference (if needed)

代替: cursor-browser-extension が失敗した場合は user-chrome-devtools。

次の場合はステップ 3 に進みます:

• Captcha が検出された
• ボットチェック / 「あなたが人間であることを確認してください」
• ログインが必要
• Cloudflare/DDoS 保護
• ページコンテンツが読み込まれない

ステップ 3: ユーザーの支援

重要なルール:

• 自律的な判断を決して行わないでください (例: Google がブロックされたときに DuckDuckGo に切り替える)
• 確認せずに代替の検索エンジン/サイトを試してユーザーを迂回しないでください
• 常にユーザーに通知し、ai_interaction を介して指示を待ってください

ai_interaction ツールを次のメッセージで呼び出します:

"Browser bị chặn bởi [captcha/bot check/login].
URL: [url]
Cần bạn:
1. Mở browser manual
2. Bypass protection
3. Báo lại khi xong để tôi tiếp tục

Hoặc bạn muốn thử [alternative option]?"

その後、再試行する前に ai_interaction を介してユーザーの確認を待ちます。

検出パターン

Captcha/ブロックの指標

• 「あなたが人間であることを確認してください」
• 「captcha」
• 「cloudflare」
• 「access denied」
• 「検証中です。しばらくお待ちください」
• スクリプトのみの空白ページ
• HTTP 403、429、503

成功の指標

• 意味のあるコンテンツが返された
• 期待される HTML 構造
• エラーメッセージがない

ベストプラクティス

1. 常に最初に WebFetch を試す - 最速のオプション
2. 応答の品質を確認する - HTTP ステータスだけでなく
3. 再試行を連打しない - 試行の間に待機する
4. 透明性を保つ - 何が起きているかをユーザーに伝える
5. 有用なコンテンツを保存する - 不必要に再フェッチしない

ai_interaction との統合

ユーザーが保護の回避を支援する場合:

1. ユーザーが手動操作を完了する
2. ユーザーが ai_interaction を介して応答する
3. エージェントがブラウザー MCP で再試行する (Cookie は保持される)
4. リサーチを続行する