eze-is/web-access

解決的問題

許多AI代理缺乏進階的網頁瀏覽能力，往往依賴基本的搜尋或取得工具，無法處理動態內容、使用者驗證或複雜互動。本專案提供一個全面的「技能」，為代理加入進階網頁存取、瀏覽器自動化與策略性瀏覽邏輯，使其能像人類一樣與網頁互動。

作用方式

本專案實作一個透過WebSocket連接使用者現有瀏覽器（Chrome或Edge）的CDP（Chrome DevTools Protocol）代理。這讓代理能利用使用者的活躍登入會話與Cookie。它提供一組HTTP API，讓代理執行建立新標籤頁、執行JavaScript、模擬真實滑鼠點擊、上傳檔案與截取螢幕畫面等動作。此外，還包含一個find-url.mjs腳本，用於搜尋本地瀏覽器書籤與歷史記錄，以找出內部或先前造訪過的頁面。

適用對象

支援SKILL.md標準的AI代理（如Claude Code、Cursor、Gemini CLI與Codex CLI）的開發者與使用者，希望其代理具備完整、已驗證的網頁瀏覽與自動化能力。

主要特色

• CDP代理整合：連接Chrome或Edge，利用現有登入狀態並處理動態頁面。
• 自動工具選擇：根據情境自動在WebSearch、WebFetch、curl、Jina與CDP之間選擇。
• 本地資源檢索：搜尋本地瀏覽器歷史記錄與書籤，找出無法公開搜尋的URL。
• 平行執行：可並行調度子代理研究多個目標，同時共享單一代理。
• 網站經驗累積：跨會話儲存並重用各網域的操作經驗（URL模式、平台特性）。
• 進階互動：支援JS點擊、真實滑鼠事件與檔案上傳。