讓你的 AI Agent 不再上網抓瞎，這兩個 GitHub 萬星工具補齊

呢篇文2440字，睇完大約要5分鐘

用過AI Agent嘅人，實會遇過同一件事——叫佢寫code、改文件、行command都冇問題。

但係你叫佢「幫手拎呢個網站嘅內容」，佢即刻束手無策。

唔係拎唔到，而係效率低同成日出錯。

以Claude Code（Codex、Gemini CLI呢類都差唔多）為例，預設讀網頁係用WebFetch，拎返嚟嘅內容唔純淨，可能會撈埋導航欄、彈窗HTML、廣告位。

而且一遇到有啲反爬機制嘅網站，例如微信公眾號，就要轉用其他方案。

效率低，仲嘥Token。

我以前嘅解法係裝一個叫x-reader嘅MCP，專門處理網頁抓取。用咗一排，的確搞得掂問題，但用用嚇發現唔少問題：

• • 間中會失敗
• • 重度JS渲染嘅頁面佢抓唔齊
• • 要登入先睇到嘅頁面，佢抓唔到

最近揾到兩個替代方案，啱啱好互補，一個負責一般公開網站，覆蓋率好廣；另一個負責前者搞唔掂嘅棘手情況，做兜底。

兩個夾埋用，AI Agent「上網」呢件事終於算係補齊咗。

它們是 Agent Reach 和 Browser Harness，兩個都係GitHub 萬星嘅項目。

Agent Reach：預設入口

Agent Reach解決嘅係「一般公開網站」嘅內容提取，大概搞得掂90%嘅需求。

GitHub地址：https://github.com/Panniantong/Agent-Reach

佢本質上唔係一個抓取工具，而係一個安裝器。

佢將市面上比較好用嘅開源CLI工具（Twitter、Reddit、小紅書、B站、YouTube、微信公眾號、微博、V2EX、雪球、小宇宙、抖音、LinkedIn、RSS 等）統一包裝，一條command裝齊、配齊、檢查一次睇下得唔得。

支援嘅平台總共17個，覆蓋範圍大致滿足日常內容創作者嘅所有調研需求。中國主流社交同內容平台都喺入面。

安裝好簡單，將呢句說話 send 畀你個 Agent，佢會自己搞掂：

幫我安裝 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

底層執行嘅係呢兩條 command：

pipx install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto

完成之後會話畀你知邊啲渠道用得、邊啲要手動配Cookie（例如Twitter、小紅書要登入態）。

需要邊個先裝邊個，唔使一次過裝曬。

因為底層係用各種CLI工具，難免有啲會失效，需要更新。

更新都好簡單，都係一句說話：

幫我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

點解更新都要畀Agent做、唔係一行 pip upgrade，因為佢本身係裝一堆由其他人維護嘅CLI，剩係升級自己唔夠，要叫Agent幫你檢查嚇上游有冇改名、搬遷、轉工具。呢個機制設計得幾周到。

佢搞得掂啲咩？

公開睇到嘅內容，即係你瀏覽器唔登入就見得到嘅。例如某篇公眾號文章、某條Twitter、某個YouTube片嘅字幕、某個GitHub倉庫嘅README。

佢搞唔掂啲咩？

主要係以下幾類：

• • 需要登入先睇到嘅私域內容（飛書嘅工作區、知識星球、公眾號後台數據）
• • 重度JS渲染嘅頁面（例如Cursor、Linear呢啲設計主導嘅官網，內容係非同步注入，抓返嚟會係一片空白）
• • 需要互動先展開嘅內容（例如Twitter某條爆文嘅完整嵌套回覆樹、Reddit嘅深度評論）

而呢類內容正正係Browser Harness嘅強項。

Browser Harness：兜底方案

Browser Harness嚟自browser-use團隊。

佢哋另一個項目browser-use喺GitHub上Star 接近10萬，係瀏覽器自動化領域最有名嘅開源項目之一。

Browser Harness係佢哋做嘅輕量版，諗法完全唔同。

佢唔係「集成一堆工具」，而係「叫Agent直接接管你嘅真實Chrome」。

GitHub地址：https://github.com/browser-use/browser-harness

運作方式：透過一個叫CDP（Chrome DevTools Protocol）嘅協定，開一個WebSocket，將Claude嘅指令直接送入你用到嘅Chrome度執行。

Agent想㩒邊個掣、想讀邊段內容、想cap邊張圖，都直接行你嘅真實瀏覽器。

用嘅係你真實嘅IP、你真實嘅Cookie、你真實嘅登入態。佢睇到嘅頁面，就係你睇到嘅頁面。

安裝好簡單，可以自己手動裝，直接逐條執行以下command：

git clone https://github.com/browser-use/browser-harness
cd browser-harness
uv tool install -e .

然後話畀Claude Code呢個工具存在——喺 ~/.claude/CLAUDE.md 度加一行import：

@<你 clone 的路徑>/browser-harness/SKILL.md

當然，都可以一句說話掉畀你嘅Agent：

幫我配置 https://github.com/browser-use/browser-harness

閲讀 `install.md` 文件，並按照步驟安裝 browser-harness 並將其連接到我的瀏覽器。

最後喺Chrome度開 chrome://inspect/#remote-debugging，剔選「Allow remote debugging for this browser instance」就得。

我裝嘅時候有個小陷阱：Chrome 144之後，第一次連接時瀏覽器會再彈一個「Allow remote debugging?」，你返去Chrome㩒Allow就得。我自己裝嘅時候就卡咗一下，以為連唔通。

更新都好簡單：

browser-harness --update -y

呢個機制同Agent Reach完全唔同——佢自帶self-update。

每次執行時佢會自己檢查有冇新版，見到提示直接行呢條command就得，唔需要Agent幫你做搬遷檢查。

雖然 Browser Harness主要負責操作瀏覽器，但唔太建議用佢做一啲不可逆或者冇明確成功條件嘅任務。

例如讚好係可逆（再㩒一次取消）、加書籤可逆、加標籤可逆。落單、俾錢、刪數據、提交表單呢啲就不可逆。設計任務時盡量留喺可逆嗰邊。

清空購物車可以驗證（購物車數量=0），幫我整理嚇收件箱係模糊任務，agent可能會整理出你唔想要嘅結果。

所以在我睇嚟，Browser Harness嘅最佳實踐特別適合呢類應用場景：

• • 抓登入先睇到嘅內容（公眾號後台數據、飛書文檔、知識星球帖子、自己小紅書嘅草稿箱）
• • 抓重度JS渲染嘅網站（Cursor、Linear、v0呢類官網）
• • 需要互動先展開嘅內容（Twitter嵌套回覆、Reddit深度評論、知乎/小紅書完整評論區）
• • 跨多個網站嘅批量調研（N個AI產品嘅官網各自打開 → 提取重點 → 彙總到Obsidian）

（飛書嘅非公開文檔，所以私隱打咗碼，但可以見到完整頁面資訊係拎到嘅）

以及但凡已經有API搞得掂嘅事，GitHub數據提取用 gh，公眾號文章提取用Agent Reach，就優先行API，請求API遠比模擬點擊穩定。

值得一提嘅係，Browser Harness仲有「自我進化」機制，Agent摸索過某個網站嘅操作之後，會將code寫入自己嘅helpers檔案，下次遇到同樣嘅網站就唔會再犯同樣嘅錯，可以大大節省Token成本。

令兩個工具自動協作

裝好之後，下一個問題係，幾時用邊個？

如果每次都要你自己判斷「呢個內容用Agent Reach定係Browser Harness」，咁同手動調用冇分別，都冇解放到幾多生產力。

正確做法係將規則寫入項目根目錄嘅 CLAUDE.md（如果你係用Codex，就係AGENT.md）度。

Agent每次開會話會自動讀呢個檔案，規則寫一次就永久有效。

我自己嘅配置思路係咁：

• • 預設入口行Agent Reach。任何外部內容、任何URL，先用佢
• • 遇到登入態、JS重渲染、需要互動、禁止複製呢四類場景，自動轉去Browser Harness
• • GitHub例外，永遠優先行 gh CLI，結構化最穩定

具體寫法唔複雜，將上面呢三條用自然語言寫喺 CLAUDE.md 任何位置就得。

配置好之後，我話「幫我睇嚇X平台嘅Y內容」，Claude Code會自己揀工具，唔使我每次指定。

寫在最後

有咗呢兩個工具，AI Agent「上網」嘅能力，先算係真正補齊。

Agent Reach喺前，覆蓋大部分常規場景，幾乎滿足內容創作者所有嘅日常調研需求。

Browser Harness喺後，專門解決前者搞唔掂嘅10%。

如果你都有相關需求，或者你已經裝咗x-reader之類嘅MCP但用得唔順，都可以考慮嚇需唔需要更新迭代相關工具。

項目地址：

• • Agent Reach：https://github.com/Panniantong/Agent-Reach
• • Browser Harness：https://github.com/browser-use/browser-harness
• • x-reader（開頭提到嘅MCP，依然用得，只係唔係我而家首選）：https://github.com/runesleo/x-reader

• AI時代，你嘅上下文先係最值錢嘅資產

• 2026年點樣用好AI，我發現呢啲能力更加重要

• Openclaw咁hit，但你真係需要佢嗎？

• 萬物皆可command line：AI時代，軟件正在長出第二套界面

• 成個網絡都喺度抄Karpathy嘅知識庫，但大多數人只學到皮毛

• 閃屏、貼上改唔到、睇唔到額度？令Claude Code用得順手嘅4個小技巧

本文字數 2440，閲讀大約需 5 分鐘

用過 AI Agent 的人，多多少少都遇到過同一件事——讓它寫代碼、改文檔、跑命令都沒問題。

但你讓它「幫忙獲取這個網站的內容」，它立刻就抓瞎。

不是獲取不到，是效率低且經常容易出錯。

以 Claude Code（Codex、Gemini CLI 這類同理）為例，默認讀取網頁用的是 WebFetch，抓回來的內容不純淨，可能混着導航欄、彈窗 HTML、廣告位。

而且遇上稍微有些反爬機制的網站，例如微信公眾號，只有再換成其他方案。

效率低，還浪費 Token。

我之前的解法是裝一個叫 x-reader 的 MCP，專門處理網頁抓取。用過一陣子，確實能解決問題，但用着用着發現問題不少：

• • 有一定偶發失敗的概率
• • 重度 JS 渲染的頁面它抓不全
• • 需要登錄態才能看的頁面，抓取不到

最近找到兩個替代方案，剛好是互補的，一個負責常規公開網站，覆蓋率非常廣；一個負責前者搞不定的疑難雜症，作為兜底。

兩個配起來用，AI Agent「上網」這件事算是真正補齊了。

它們是 Agent Reach 和 Browser Harness，兩個都是 Github 萬星的項目。

Agent Reach：默認入口

Agent Reach 解決的是「常規公開網站」的內容獲取，差不多能解決 90% 的需求。

Github 地址：https://github.com/Panniantong/Agent-Reach

它本質上不是一個抓取工具，而是一個安裝器。

它把市面上比較好用的開源 CLI 工具（推特、Reddit、小紅書、B站、YouTube、微信公眾號、微博、V2EX、雪球、小宇宙、抖音、LinkedIn、RSS 等）打了個統一的包，讓你一條命令裝齊、配齊、檢查一遍能不能跑。

支持的平台總共 17 個，覆蓋範圍基本上能滿足日常內容創作者的所有調研需求。中國主流社交和內容平台都在裏面。

安裝非常簡單，把這一行話發給你的 Agent，剩下它會自己跑：

幫我安裝 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

底層執行的是這兩條命令：

pipx install https://github.com/Panniantong/agent-reach/archive/main.zip
agent-reach install --env=auto

跑完會告訴你哪些渠道已經能用、哪些需要手動配 Cookie（比如推特、小紅書需要登錄態）。

需要哪個再配哪個，不必一上來就全部裝。

因為底層調用的是各種 CLI 的工具，難免會有些失效，需要更新。

更新也非常簡單，同樣是一句話：

幫我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

為什麼更新也要讓 Agent 跑、而不是一行 pip upgrade，因為它本質是裝一堆別人維護的 CLI，光升級自己不夠，要讓 Agent 幫你檢查上游有沒有改名、遷移、換工具。這個機制設計得挺周到。

它能搞定什麼？

公開能看的內容，也就是你瀏覽器不登錄就能看到的那些。某條公眾號文章、某條推文、某個 YouTube 視頻字幕、某個 GitHub 倉庫的 README。

它搞不定什麼？

主要是這幾類：

• • 需要登錄態才能看的私域內容（飛書自己的工作區、知識星球、公眾號後台數據）
• • 重度 JS 渲染的頁面（Cursor、Linear 這種設計驅動的官網，內容是異步注入的，抓回來一堆空白）
• • 需要交互才能展開的內容（推特某條爆款的完整嵌套回覆樹、Reddit 的深度評論）

而這部分內容恰恰是 Browser Harness 擅長的。

Browser Harness：兜底方案

Browser Harness 來自 browser-use 團隊。

他們另一個項目 browser-use 在 GitHub 上 Star 接近 10 萬，是瀏覽器自動化領域最有名的開源項目之一。

Browser Harness 是他們做的輕量版，思路完全不一樣。

它不是「集成一堆工具」，是「讓 Agent 直接接管你的真實 Chrome」。

Github 地址：https://github.com/browser-use/browser-harness

工作方式：通過一個叫 CDP（Chrome DevTools Protocol）的協議，開一個 WebSocket，把 Claude 的指令直接送到你正在用的 Chrome 裏執行。

Agent 想點哪個按鈕、想讀哪段內容、想截哪個圖，都直接走你的真實瀏覽器。

用的是你的真實 IP、你的真實 Cookie、你的真實登錄態。它能看到的頁面，就是你能看到的頁面。

安裝非常簡單，可以自己手動安裝，直接逐一執行以下命令：

git clone https://github.com/browser-use/browser-harness
cd browser-harness
uv tool install -e .

然後告訴 Claude Code 這個工具的存在——在 ~/.claude/CLAUDE.md 里加一行 import：

@<你 clone 的路徑>/browser-harness/SKILL.md

當然，也可以一句話丟給你的 Agent：

幫我配置 https://github.com/browser-use/browser-harness

閲讀 `install.md` 文件，並按照步驟安裝 browser-harness 並將其連接到我的瀏覽器。

最後在 Chrome 裏打開 chrome://inspect/#remote-debugging，勾上「Allow remote debugging for this browser instance」即可。

我裝的時候有個小坑：Chrome 144 之後，第一次連接時瀏覽器還會再彈一個「Allow remote debugging?」，你切回 Chrome 點一下 Allow 就好。我自己裝的時候就卡了一下，以為是連不通。

更新也非常簡單：

browser-harness --update -y

這個機制和 Agent Reach 完全不同——它自帶 self-update。

每次運行時它會自檢測一次有沒有新版，看到提示直接跑這條命令就行，不需要 Agent 幫你做遷移檢查。

雖然 Browser Harness 主要負責操作瀏覽器，但不太建議用它去做一些不可逆或沒有明確成功條件的任務。

例如點贊可逆（再點一次取消）、加書籤可逆、添加標籤可逆。下單、付款、刪數據、提交表單，這些不可逆。設計任務時儘量留在可逆這一側。

把購物車清空可驗證（購物車計數 = 0），幫我整理一下收件箱是模糊任務，agent 可能整理出你不想要的結果。

所以在我看來，Browser Harness 的最佳實踐，特別適合這類應用場景：

• • 抓登錄態後才能看的內容（公眾號後台數據、飛書文檔、知識星球帖子、自己小紅書的草稿箱）
• • 抓重度 JS 渲染的網站（Cursor、Linear、v0 那種官網）
• • 需要交互才能展開的內容（推特嵌套回覆、Reddit 深度評論、知乎/小紅書完整評論區）
• • 跨多個網站的批量調研（N 個 AI 產品的官網各自打開 → 提取要點 → 彙總到 Obsidian）

（ 飛書的非公開文檔，所以隱私打碼了，但可以看到完整頁面信息是能獲取到的）

以及凡是已經有 API 可以完成的事情，GitHub 數據獲取用 gh，公眾號文章獲取用 Agent Reach，則優先用 API，請求 API 遠比模擬點擊更穩。

值得一提的是，Browser Harness 還有「自我進化」機制，Agent 摸索過某個網站的操作之後，會把代碼寫進自己的 helpers 文件，下次遇到同樣的網站就不會犯同樣的錯誤，可以大大節省 Token 成本。

讓兩個工具自動協作

裝好之後，下一個問題是，什麼時候用哪個？

如果每次都要你自己判斷「這個內容用 Agent Reach 還是 Browser Harness」，那就跟手動調用沒區別了，也沒解放多少生產力。

正確的做法是把規則寫進項目根目錄的 CLAUDE.md（如果你是用 Codex，則是 AGENT.md）裏。

Agent 每次開會話會自動讀這個文件，規則一次寫好永遠生效。

我自己的配置思路是這樣：

• • 默認入口走 Agent Reach。任何外部內容、任何 URL，先用它
• • 遇到登錄態、JS 重渲染、需要交互、禁止複製這四類場景，自動切到 Browser Harness
• • GitHub 例外，永遠優先用 gh CLI，結構化最穩

具體寫法不復雜，把上面這三條用自然語言寫在 CLAUDE.md 任意位置即可。

配好之後，我說「幫我看看 X 平台的 Y 內容」，Claude Code 會自己選工具，不用我每次指定。

寫在最後

有了這兩個工具，AI Agent「上網」的能力，才算真正補齊。

Agent Reach 在前，覆蓋大部分常規場景，幾乎能滿足內容創作者所有的日常調研需求。

Browser Harness 在後，專門解決前者搞不定的 10%。

如果你也有相關需求，或者你已經裝了 x-reader 之類的 MCP，但用得不順，都可以考慮是否需要更新迭代一下對應的工具。

項目地址：

• • Agent Reach：https://github.com/Panniantong/Agent-Reach
• • Browser Harness：https://github.com/browser-use/browser-harness
• • x-reader（開頭提到的 MCP，依然能用，只是不是我現在的首選）：https://github.com/runesleo/x-reader

• AI 時代，你的上下文才是最值錢的資產

• 2026 年如何用好 AI，我發現這些能力更重要

• Openclaw 這麼火，可你真的需要它嗎？

• 萬物皆可命令行：AI 時代，軟件正在長出第二套界面

• 全網都在抄 Karpathy 的知識庫，但大多數人只學到了皮毛

• 閃屏、粘貼改不了、看不到額度？讓 Claude Code 用的順手 4 個小技巧