🦞 ClawBrowser Core

無頭瀏覽器自動化 CLI，專為 AI Agent 設計

---

🎯 核心特性

• ✅ ARIA ref 定位 - 不用脆弱的 CSS 選擇器
• ✅ 自然語言指令 - 直接說「點擊提交按鈕」
• ✅ 無頭模式 - 只保留 DOM 渲染 + 無障礙樹快照
• ✅ 雙引擎切換 - agent-browser / traditional
• ✅ 100% 接口兼容 - 舊代碼零修改
• ✅ 網頁抓取 - extract_content/images/links

---

🚀 快速開始

安裝依賴

# 安裝 agent-browser CLI
npm install -g agent-browser
agent-browser install  # 下載 Chrome

使用示例

from browser_tool import BrowserTool

# 初始化
browser = BrowserTool(session_name="my_task")

# 打開網頁
browser.open("https://example.com")

# 獲取快照（包含 refs）
snapshot = browser.snapshot(interactive=True)

# 使用 ref 點擊
browser.click("@e1")

# 填寫表單
browser.fill("@e2", "test@example.com")

---

📚 文檔

• ClawHub 技能頁面: https://clawhub.ai/skills/clawbrowser-core
• SKILL.md: 查看
• agent-browser 文檔: https://agent-browser.dev

---

🛠️ 安裝

方法 A：從 ClawHub 安裝

clawhub install clawbrowser-core

方法 B：手動安裝

# 克隆倉庫
git clone https://github.com/YOUR_USERNAME/clawbrowser-core.git
cd clawbrowser-core

# 複製文件到工作目錄
cp browser_tool_py36.py /path/to/your/project/
cp web_scraper.py /path/to/your/project/

---

📦 文件結構

clawbrowser-core/
├── README.md              # 本文件
├── LICENSE                # MIT 許可證
├── SKILL.md               # ClawHub 技能文檔
├── browser_tool_py36.py   # 核心工具（Python 3.6 兼容）
└── web_scraper.py         # 網頁抓取工具

---

🔌 API 參考

基礎操作

方法	說明
open(url)	打開網頁
snapshot()	獲取無障礙樹快照
click(selector)	點擊元素
fill(selector, text)	填寫輸入框
type(selector, text)	輸入文本
press(key)	按鍵
wait(selector)	等待
close()	關閉

獲取信息

方法	說明
get_text(selector)	獲取元素文本
get_url()	獲取當前 URL
get_title()	獲取頁面標題
get_attr(selector, attr)	獲取屬性

網頁抓取

方法	說明
extract_content()	提取頁面內容
extract_images()	提取圖片
extract_links()	提取鏈接

自然語言

browser.natural_language_command("打開 github.com")
browser.natural_language_command("點擊 Sign In 按鈕")
browser.natural_language_command("填寫用戶名為 admin")
browser.natural_language_command("抓取頁面內容")

---

💡 使用場景

• ✅ AI Agent 瀏覽器自動化
• ✅ 網頁抓取（微信文章、新聞、博客）
• ✅ 測試自動化
• ✅ 數據采集
• ✅ RPA 流程

---

⚠️ 限制條件

• ❌ 需要 Chrome/Chromium
• ❌ 動態內容需要重新快照
• ❌ Canvas/WebGL 不支持

---

🤝 貢獻

歡迎提交 Issue 和 Pull Request！

---

📄 許可證

MIT License - 詳見 LICENSE 文件

---

👤 開發者

作者: RedOpenClaw
完成日期: 2026.04.02
簽名: 🦞 RedOpenClaw - 生活太快⚡️...老逼快跑💨...

---

🔗 相關資源

• ClawHub - OpenClaw 技能市場
• OpenClaw - AI Agent 框架
• agent-browser - 瀏覽器自動化 CLI