Agent Reach: cho coding agent đọc được những trang nó không tự mở nổi

Claude Code, Codex và các CLI agent tương tự đều có sẵn tìm kiếm web và tải trang. Với bài viết công khai thì đủ dùng. Nhưng gặp trang sau màn hình đăng nhập, nội dung nằm trong video, hay các nền tảng Trung Quốc mà tìm kiếm thông thường gần như không phủ tới, agent thường chỉ trả về trang bị chặn hoặc đoán mò. Bạn nhờ nó đọc một thread Reddit, lấy transcript YouTube hay xem thảo luận trên V2EX là gặp ngay.

Agent Reach lấp khoảng trống đó. Đây là CLI Python giấy phép MIT của Panniantong (hơn 108k sao GitHub, bản 1.6.1 khi tôi thử). Nó cài và nối sẵn công cụ upstream cho từng nền tảng, rồi gom tất cả thành một lệnh agent-reach <kênh> <hành động>. Mọi lệnh đều in JSON, nên agent không phải scrape hay parse HTML.

Kit này nói về nền tảng nào dùng được ngay, một yêu cầu được định tuyến ra sao, và một lần chạy thật trên máy Windows trông như thế nào.

1. Các kênh và điều kiện sử dụng

Agent Reach chia nền tảng thành các kênh với ba mức: default dùng được ngay sau khi cài, optional bật khi bạn yêu cầu, experimental có thể hỏng bất cứ lúc nào khi nền tảng siết chống bot.

Kênh	Mức	Hành động	Cần gì
`github`	default	tìm repo, đọc repo và README, đọc issue và PR kèm bình luận	không cần gì
`youtube`	default	thông tin video, tìm kiếm, phụ đề, chuyển giọng nói thành văn bản	không cần gì; chuyển giọng nói cần key Groq hoặc OpenAI
`web`	default	tìm web, đọc trang	không cần gì
`v2ex`	default	chủ đề nổi bật, node, chủ đề kèm phản hồi, người dùng	không cần gì
`bilibili`	default	tìm kiếm, thông tin video, xu hướng, phụ đề	không cần gì; phụ đề cần đăng nhập bằng mã QR
`reddit`, `linkedin`, `xiaohongshu`, `boss`, `xueqiu`	optional	tìm và đọc bài viết, việc làm hoặc giá cổ phiếu	phần lớn hành động cần đăng nhập
`xiaoyuzhou`	optional	chuyển podcast thành văn bản	key Groq
`twitter`, `facebook`, `instagram`	experimental	tìm kiếm, hồ sơ, bài đăng	đăng nhập

Chạy agent-reach channels để xem toàn bộ kênh cùng hành động và tham số. Agent đọc kết quả này là biết gọi lệnh nào, không cần hướng dẫn thêm.

2. Một yêu cầu được định tuyến thế nào

Mỗi hành động trên mỗi nền tảng có một danh sách công cụ xếp theo thứ tự. Agent Reach thử công cụ đầu tiên, lỗi thì chuyển sang công cụ kế tiếp. Đọc video Bilibili thì thử bili-cli trước, rồi tới API công khai của Bilibili. Đọc một trang web thì thử Jina Reader, rồi tới Exa.

Luồng Agent Reach từ agent qua CLI và bộ điều phối tới công cụ ưu tiên hoặc dự phòng, nền tảng và kết quả JSON

Agent tới CLI. Agent chạy một lệnh shell, ví dụ agent-reach github read owner/repo.
Điều phối. Agent Reach chọn kênh từ lệnh, hoặc từ URL khi bạn dùng agent-reach read <url>.
Ưu tiên rồi dự phòng. Một công cụ upstream bị hỏng chỉ làm đổi thứ tự trong danh sách. Cách agent gọi Agent Reach vẫn giữ nguyên.
JSON trả về. Mỗi kết quả có ok, channel, action, backend và danh sách items, nên bạn biết công cụ nào đã trả lời.

Một lần chạy thật

Tôi chạy các lệnh dưới đây trong PowerShell trên Windows với các kênh mặc định. Ảnh là toàn bộ output gốc, không chỉnh sửa. doctor chỉ đọc trạng thái trong máy và không gọi mạng, nên phần lớn kênh hiện unverified. Riêng github hiện ready vì tôi đã chạy agent-reach check github trước đó. Muốn thử trực tiếp một kênh thì chạy agent-reach check <kênh>.

Terminal chạy agent-reach doctor, github search và youtube search với toàn bộ kết quả JSON

Các lệnh khác cũng chạy được trên cùng máy: github search, github read, web read, youtube subtitle và bilibili hot. Lệnh youtube subtitle trả về toàn bộ phụ đề của một video hướng dẫn Claude Code (khoảng 8.300 từ) trong một lần gọi. Công cụ fetch thông thường không làm được việc này.

3. Bảo mật và quyền truy cập

Agent Reach chỉ đọc. Nó tìm kiếm và đọc, không đăng bài, không bình luận, không like, không nhắn tin.

Đăng nhập. Nó không đăng nhập thay bạn và không hỏi mật khẩu. Với kênh cần đăng nhập, nó dùng trình duyệt riêng chạy nền và sao chép phiên đăng nhập của đúng một trang từ Chrome của bạn. Hồ sơ Chrome không bị đổi, kho mật khẩu không bị đọc.
Dùng tài khoản phụ. Phiên được sao chép thường là tài khoản chính, và nền tảng có thể hạn chế tài khoản bị truy cập tự động. README khuyên dùng một tài khoản phụ.
Một thư mục duy nhất. Công cụ, phiên đăng nhập và cấu hình nằm trong ~/.agent-reach/, nên gỡ bỏ chỉ cần một lệnh: agent-reach uninstall --dry-run liệt kê những gì sẽ bị xóa.
Trình duyệt chỉ mở cho máy bạn. Trình duyệt riêng chỉ nhận kết nối từ chính máy đó.

[!IMPORTANT] Gói agent-reach trên PyPI không phải dự án này. Chỉ cài từ địa chỉ GitHub trong install.md.

4. Cài đặt và các lệnh đầu tiên

Nhờ agent tự cài

Cách README hỗ trợ là đưa hướng dẫn cài đặt cho agent. Dán dòng này vào Claude Code hoặc agent nào chạy được lệnh:

Install Agent Reach: https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md

Agent sẽ cài uv nếu máy chưa có, thiết lập các kênh mặc định rồi báo cho bạn kênh nào dùng được. Hãy đọc install.md một lượt trước khi duyệt các lệnh.

Kiểm tra sau khi cài

agent-reach doctor --text
agent-reach check github

Các lệnh đầu tiên

agent-reach channels
agent-reach github search "agent reach" --limit 2
agent-reach youtube subtitle "https://www.youtube.com/watch?v=<id>" --lang en
agent-reach read https://www.v2ex.com/t/1253999

Thêm và gỡ kênh

Nói với agent "thêm Reddit" hoặc chạy agent-reach add reddit. Sau đó chạy agent-reach login reddit và tự đăng nhập trong cửa sổ vừa mở. agent-reach remove reddit xóa kênh cùng phiên đăng nhập và công cụ riêng của nó.

Cập nhật

agent-reach update --check
agent-reach update

Agent Reach