一位使用者在沒開代理的網路上跑 agent-reach doctor，輸出裡「任意网页」那一行打了勾；同一台機器上，curl https://r.jina.ai/ 回的狀態碼是 000，連線根本沒通。這是 issue #685 的內容，2026 年 9 月 11 日開的，到 10 月 11 日還是 open。

這是我讀 Agent-Reach 時碰到的第二個對不上的地方。第一個更早，連安裝都還沒開始：PyPI 上有一個同名的 agent-reach，作者不是這個專案的人。

先交代依據。我沒有安裝 Agent-Reach，也沒跑過它的任何指令。這篇用的是 README、install.md、SKILL.md、pyproject.toml、幾則 GitHub issue，加上 GitHub 與 PyPI 的元資料。原始碼層面的細節主要來自我 10 月 8 日讀完寫下的筆記，大部分沒有逐檔重新核對，所以下面不引行號。

它賣的是選型知識

專案描述是 “Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.”。2026 年 10 月 11 日查 GitHub API：MIT 授權、95,697 顆星、8,383 個 fork、36 位 contributor、206 個 open issue，2026 年 2 月 24 日建立，沒有封存。

README 對自己的定位比描述保守：它說自己在任何具體實作上面一層，負責「选型、安装、体检、路由」，不負責底層讀取本身，讀取由 agent 直接呼叫上游工具，沒有包裝層。上游指的是 twitter-cli、OpenCLI、yt-dlp 這些。這句話不是處處成立，web channel 的原始碼裡就有自己的 read()。Agent-Reach 主要交出的是一份 SKILL.md，加上 doctor、install 這幾個指令，告訴 agent 每個平台該用哪個後端、壞了換哪個。每個平台有一串候選，例如 B 站是 bili-cli、OpenCLI、搜尋 API 依序往下找。

SKILL.md 的 description 寫了 “MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything”，內文要求 agent 先跑 agent-reach doctor --json。換句話說，它想當 agent 上網前的第一站。

我的立場：把它當選型清單讀，不要當自動安裝器用。 它的價值在「哪個平台現在該用哪個工具」這份知識，而這份知識會過期。下面是我讀的時候，文件和 issue 對不上的幾個地方。

同名套件

PyPI 上的 agent-reach 長這樣。下面是 2026 年 10 月 11 日依 PyPI JSON API 的欄位整理的結果，不是我貼的指令輸出：

1
2
3
4
PyPI agent-reach（依 PyPI JSON 欄位整理，2026-10-11）
version: 0.1.0
author:  Jean Galea
homepage: https://github.com/jgalea/agent-reach

Agent-Reach 在 Panniantong/Agent-Reach，作者不同。README 安裝步驟的第一條，括號裡專門寫了一句：不要從 PyPI 安裝同名包，它不是本專案。專案自己在 2026 年 10 月 7 日（UTC）還提交過一個 commit，標題是 “fix(llms): stop recommending the unrelated agent-reach package on PyPI”，改動的檔案是 llms.txt。

照專案名打 pip install agent-reach，PyPI 上對應的是 Jean Galea 的 0.1.0。我沒有真的執行這行，這是從 PyPI 的名稱對應推出來的。README 那句警告什麼時候加的，我沒有逐版查；混淆確實發生過，有那個 commit 佐證。

doctor 的 ok 與 null

agent-reach doctor 是體檢指令，輸出裡每個 channel 有一個 active_backend 欄位。我讀到三則 issue，都是 open 狀態，講的是 doctor 給的訊號和實際能不能用對不上。

  • #685（2026 年 9 月 11 日）：開頭那則。WebChannel.check() 無條件回 ok、不做網路探測，回報者在中國大陸沒有代理，r.jina.ai 連線逾時，doctor 照報 ok。
  • #623（2026 年 8 月 14 日）：v1.5.0、Windows 加 Git Bash，exa_search 報 ok，但 mcporter 沒註冊 exa server，實際呼叫得到 “Unknown MCP server ‘exa’”。
  • #566（2026 年 8 月 4 日）：這則性質不同，不是報錯的 ok，是給不出答案。使用者在 Windows 10 加 Git Bash 上實測 15 個 channel，8 個 active_backend 是 null，包括 github、twitter、reddit、facebook、instagram、xiaohongshu、linkedin、exa_search。同一則 issue 還指出 check-update 只比版本號，v1.5.0 就算是最新版，references 裡 YouTube 字幕的路由已經失效，skill 自己察覺不到。

null 那一個是設計出來的。SKILL.md 的常駐規則自己寫了，active_backend: null 表示 doctor 為避免觸發瀏覽器 Cookie 讀取或遠端寫入而沒有做實時驗證，不代表後端不存在；install.md 也寫明 Twitter 只接受使用者用 Cookie-Editor 明確匯出的內容。代價是 #566 指出的：登入型平台正是最需要路由的一批，第一條規則在那裡給不出路由。

三則放一起：ok 比較接近「工具在」，null 是「沒驗」，兩種都不等於「抓得到」。所以我的做法會是：doctor 當第一關，過了之後，每個你真的要用的渠道各抓一次真實內容。如果你只打算用不需登入的渠道，而且網路本來就連得到 r.jina.ai，我判斷這一節的風險小很多。

零配置是 6 還是 7

README 說預設只啟用 6 個零配置渠道，SKILL.md 寫 “Zero config for 6 channels”。install.md 列出的零配置清單是 7 個：Web (Jina Reader)、YouTube、GitHub、RSS、Exa Search、V2EX、Bilibili (basic)。

差一個。差的是誰、是文件沒同步還是別的原因，文件沒講，我也查不出來。要是你的 agent 照 SKILL.md 判斷「這平台不用設定」，後果大不大要看是哪一個。對我來說，這說明這份知識有人在維護，也有漏同步的地方，照著讀可以，當成逐字準確不行。

issue 本身也要驗

#601（2026 年 8 月 11 日，open）回報 pyproject 裡的 yt-dlp 版本 pin 在 PyPI 找不到，回報者說最新是 2025.10.14，環境是 macOS arm64、Python 3.14。pyproject 那行是這樣：

1
"yt-dlp[default]>=2026.07.04"

2026 年 10 月 11 日查 PyPI，yt-dlp 有 2026.7.4（2026 年 7 月 4 日 UTC 上傳），最新是 2026.8.19。後面兩位留言者說 pin 解析正常，其中一位推測原報告是 pip 快取過期。那是推測，我沒有重現，issue 到今天也還開著。

時間線

Agent-Reach 的版本與幾個日期（2026-10-11 查 GitHub releases 與 commit，日期為 UTC）

2026-02-24

repo 建立。

2026-02-25 ～ 03-31

v1.1.0（02-25）、v1.2.0（02-26）、v1.3.0（03-04）、v1.4.0（03-31）。CHANGELOG 把 1.0.0、1.1.0 寫成 2025 年，把 v1.3.0 寫成 03-12，還有一個 releases 頁沒有的 v1.3.1（03-27），三處都跟 releases 頁對不上，原因我沒查，看版本以 releases 頁為準。

2026-06-10 ～ 06-11

v1.4.1、v1.4.2（06-10）、v1.5.0（06-11）。到 10 月 11 日為止，這是最後一個 release。

2026-09-15

Boss 直聘 channel 的提交進來（PR #627），CHANGELOG 還擺在 Unreleased。1.1.0 的 CHANGELOG 另有一條舊的 Boss 直聘（經 mcp-bosszp 掃碼登入），所以不能說它是第一次出現。

2026-10-07

main 的最新提交落在這天，同一天有那個 llms 檔的 PyPI 修正。

最後一個 release 是 6 月 11 日，main 到 10 月 7 日還在動。install.md 的安裝指令抓的是 archive/main.zip，也就是 main 當下的內容，你拿到的就不等於 v1.5.0。

帳號風險

README 的「安全性」一節寫了：用 Cookie 登入的平台有被偵測、封號的風險，請用專用小號，不要用主帳號。install.md 到 Step 3（設定需要登入的平台）才出現同樣的提醒。#498（2026 年 7 月 13 日，open）有使用者回報小紅書用了 2 天就收到封號警告，內文是一張截圖和幾行字，沒有更多細節。Reddit 在 README 裡的說法是沒有零配置路徑，一定要登入態。

如果是我要用：先確認安裝來源是 GitHub 上的 repo，不是 PyPI 的同名套件；doctor 只當成「工具有沒有裝好」的檢查，每個要用的渠道自己抓一次真資料；登入型平台先準備小號。

參考資料