# Agent-Reach: cho AI đọc X, Reddit, YouTube, Bilibili bằng một CLI — cài và dùng

> Agent Reach là một công cụ CLI bằng Python, giúp các AI agent như Claude Code hay Codex đọc và tìm kiếm trên những nền tảng mà agent thường không với tới: YouTube, GitHub, Reddit, X, Bilibili, Xiaohongshu... Bạn không cài tay mà gửi một câu cho agent, agent tự cài. Việc cài khá nhẹ, nhưng vài nền tảng cần đăng nhập hoặc key.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-03 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/agent-reach-cho-ai-agent-doc-twitter-reddit-youtube-bilibili

Agent Reach là một công cụ dòng lệnh (CLI) viết bằng Python, giúp AI agent của bạn tìm kiếm và đọc nội dung trên các nền tảng mà nó thường không vào được: YouTube, GitHub, Reddit, X (Twitter), Bilibili, Xiaohongshu, V2EX, Xueqiu... Tác giả mô tả ngắn gọn là "cho agent đôi mắt để nhìn toàn bộ internet". Mọi thứ gói trong một lệnh duy nhất là `agent-reach`, và theo mô tả của tác giả thì không tốn phí API.

Các agent kiểu Claude Code, Codex, Hermes Agent hay OpenClaw vốn đã biết tìm web và đọc trang. Nhưng chúng hay chịu thua ở ba chỗ: nội dung phải đăng nhập mới xem được, nội dung nằm trong video (phụ đề, giọng nói), và các nền tảng tiếng Trung mà tìm kiếm thông thường phủ rất kém. Agent Reach cài sẵn và thử sẵn công cụ phía sau từng nền tảng, để agent chỉ cần gọi một lệnh.

Nếu bạn làm nghiên cứu thị trường, theo dõi đối thủ, đọc tài liệu kỹ thuật hoặc muốn agent tóm tắt video giúp, repo này đáng thử. Điểm đáng giá nhất là cách cài: bạn chỉ gửi một câu cho agent, phần còn lại agent tự làm. Hiện repo có khoảng 111.397 sao và 9.986 fork, dùng giấy phép MIT. Bạn có thể xem video ngắn bên dưới để thấy nó chạy ra sao.

```repo
- repo | Panniantong/Agent-Reach
- kind | CLI
- desc | Agent Reach là bộ công cụ dòng lệnh giúp AI agent tìm và đọc YouTube, GitHub, Reddit, Bilibili, Xiaohongshu... chỉ bằng vài lệnh, không tốn phí API.
- stars | 111k
- lang | Python
- license | MIT
```

```video
- youtube | https://youtube.com/shorts/PPdK75UQTi0
- facebook | https://www.facebook.com/reel/1485033074683188
- title | Video giới thiệu Agent-Reach
```

## Agent Reach làm được gì

Mỗi nền tảng được gọi là một "kênh" (channel). Cú pháp chung là `agent-reach <kênh> <hành động> [tham số]`. Các tính năng chính:

- **Đọc nền tảng cần đăng nhập.** Ví dụ tìm ghi chú và đọc bình luận trên Xiaohongshu, xem hoạt động một tài khoản trên X, đọc chi tiết tin tuyển dụng. Bạn khỏi phải tự copy từng trang dán cho agent.
- **Lấy nội dung trong video.** Lấy phụ đề của Bilibili và YouTube. Với video YouTube và podcast Xiaoyuzhou còn có thể chuyển giọng nói thành chữ, nhưng việc này cần key của Groq hoặc OpenAI.
- **Phủ các nền tảng tiếng Trung.** Bilibili, Xiaohongshu, V2EX, Xueqiu được hỗ trợ riêng, nơi tìm kiếm chung của agent thường cho kết quả nghèo nàn.
- **Dữ liệu có cấu trúc, sạch.** Giá cổ phiếu Xueqiu, bài và phản hồi trên V2EX, repo và issue trên GitHub đều trả về dạng đã sắp xếp. Agent đọc dễ hơn và đỡ tốn chữ.
- **Tự đổi công cụ khi một cái hỏng.** Mỗi hành động có danh sách công cụ thử lần lượt: cái đầu lỗi thì thử cái sau. Ví dụ đọc web thì dùng Jina Reader trước, rồi mới đến Exa. Khi nền tảng đổi giao diện, cách dùng của bạn vẫn giữ nguyên.
- **Chỉ đọc, không đăng.** Tool chỉ tìm và đọc, không đăng bài, không bình luận, không like, không nhắn tin riêng.

Các kênh chia ba mức:

| Mức | Ý nghĩa | Kênh |
|---|---|---|
| Mặc định | Cài xong dùng được ngay | bilibili, v2ex, github, youtube, web |
| Tuỳ chọn | Bạn nói "thêm XX" thì bật | xiaohongshu, xueqiu, boss, xiaoyuzhou, linkedin, reddit |
| Thử nghiệm | Dùng được nhưng dễ hỏng do nền tảng chặn | twitter, facebook, instagram |

## Cần chuẩn bị gì

Theo tư liệu, bạn cần những thứ sau:

- **Một AI agent chạy được lệnh.** Ví dụ Claude Code, Codex, Hermes Agent hoặc OpenClaw. README nói "mọi agent đều dùng được". Nếu agent báo không chạy được lệnh, hãy vào cài đặt của nó và bật quyền "cho phép thực thi lệnh".
- **Python 3.10 trở lên.** Đây là yêu cầu trong file `pyproject.toml` của repo.
- **uv.** Đây là một công cụ nhỏ để cài chương trình dòng lệnh, không cần quyền quản trị. Máy chưa có thì agent sẽ tự cài trước và báo cho bạn.
- **Tài khoản đăng nhập** cho các kênh cần login (Xiaohongshu, Reddit, X, Boss...). README khuyên dùng tài khoản phụ, lý do nằm ở phần lưu ý bên dưới.
- **Key Groq hoặc OpenAI** nếu muốn chuyển giọng nói thành chữ (YouTube, podcast Xiaoyuzhou).

README chưa nói rõ hệ điều hành nào được hỗ trợ và có yêu cầu phần cứng nào không. Bạn nên xem thêm file `docs/install.md` trong repo.

```note
Repo này chỉ cần key khi bạn muốn chuyển giọng nói thành chữ. Key Groq hay OpenAI có thể phát sinh chi phí tuỳ gói của bạn bên nhà cung cấp, và mình chưa có thông tin về mức giá. Không dán key vào khung chat với agent. README dặn rõ là chạy lệnh cấu hình ngay trong terminal của bạn.
```

## Cài đặt từng bước

Cách cài chính thức của repo khá khác thường: bạn không tự gõ lệnh cài mà nhờ agent làm.

```steps
- Mở agent | Mở Claude Code, Codex hoặc agent bạn đang dùng, bật quyền chạy lệnh
- Gửi câu cài đặt | Dán một câu kèm đường dẫn tới file install.md
- Trả lời các câu hỏi | Cho phép chạy lệnh, đồng ý cài uv nếu máy chưa có
- Chọn kênh | Xem kênh nào dùng được ngay, chọn thêm kênh tuỳ chọn nếu cần
- Điền key nếu cần | Chạy lệnh cấu hình key trong terminal của bạn
```

### Mở agent và kiểm tra quyền chạy lệnh

Mở agent bạn quen dùng. Nếu nó nói không thể chạy lệnh, vào phần cài đặt của agent và bật mục cho phép thực thi lệnh. Không có quyền này thì agent không cài được gì.

### Gửi câu cài đặt cho agent

Chép nguyên câu sau, dán vào khung chat của agent:

```
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md
```

Câu này có nghĩa là "giúp tôi cài Agent Reach" kèm đường dẫn tới file hướng dẫn cài. README cho biết dù là cài mới hay nâng cấp, bạn chỉ cần đúng một câu này. Bạn hoàn toàn có thể viết câu tiếng Việt tương tự, miễn là giữ nguyên đường dẫn.

```note
Trên PyPI có một gói tên agent-reach nhưng README cảnh báo đó KHÔNG phải dự án này. Đừng tự cài bằng tên gói. Chỉ dùng địa chỉ GitHub trong file install.md.
```

### Trả lời các câu agent hỏi trong lúc cài

Theo README, bạn có thể gặp ba việc:

- Agent xin quyền chạy lệnh: đồng ý nếu bạn tin tưởng agent của mình.
- Agent thông báo sẽ cài uv nếu máy chưa có: uv không cần quyền quản trị, bạn cứ đồng ý.
- Agent hỏi có thêm kênh tuỳ chọn không: sau khi cài xong, nó sẽ báo kênh nào dùng được ngay (Bilibili, V2EX, GitHub, YouTube, web) và kênh nào có thể thêm. Bạn chọn cái cần, hoặc bỏ qua và thêm sau bằng câu "thêm Xiaohongshu cho tôi".

Về đăng nhập: Agent Reach không đăng nhập thay bạn và không hỏi mật khẩu. Với kênh cần login, lần đầu dùng nó sao chép phiên đăng nhập của đúng trang web đó từ Chrome của bạn sang một trình duyệt riêng chạy nền. Chrome gốc không bị thay đổi.

### Điền key (chỉ khi cần chuyển giọng nói thành chữ)

Nếu bạn muốn chuyển giọng nói thành chữ, hãy mở terminal của chính bạn (không phải khung chat của agent) và chạy:

```bash
agent-reach configure groq-key
```

Lệnh này sẽ nhập key Groq. Đây là lệnh duy nhất README đưa ra cho việc cấu hình key. Với key OpenAI, README chưa ghi lệnh riêng, bạn xem thêm trong `docs/` của repo.

Mọi thứ Agent Reach cài (công cụ từng kênh, đăng nhập, cấu hình) nằm gọn trong một thư mục `~/.agent-reach/`, nên sau này nâng cấp hay gỡ đều dễ.

## Kiểm tra đã chạy được chưa

Cách đơn giản nhất là hỏi thẳng agent: "Xem trạng thái Agent Reach". Theo README, agent sẽ báo từng kênh đang dùng được hay không, và kênh nào từng ổn nhưng giờ hỏng.

Bạn cũng có thể tự kiểm tra trong terminal:

```bash
agent-reach channels
```

Lệnh này liệt kê các kênh và việc mỗi kênh làm được. Nếu thấy danh sách hiện ra là lệnh đã được cài. Sau đó thử một lệnh không cần đăng nhập:

```bash
agent-reach bilibili search "大模型"
```

"大模型" nghĩa là "mô hình lớn" (LLM). Lệnh này tìm video Bilibili theo từ khoá. Kênh Bilibili thuộc nhóm mặc định, tìm kiếm không cần đăng nhập. README không mô tả chi tiết định dạng kết quả, nên mình chỉ có thể nói: nếu trả về danh sách video thay vì báo lỗi là ổn.

## Dùng vào việc thật

Phần lớn thời gian bạn không gõ lệnh mà nói với agent bằng tiếng thường. Agent sẽ tự gọi `agent-reach` phía sau.

### Dev đọc nhanh issue và README của repo lạ

Bạn đang cân nhắc dùng một thư viện mà chưa chắc nó còn được bảo trì. Kênh GitHub cho phép tìm repo, đọc README, đọc issue và PR kèm bình luận. Bạn có thể nhờ agent:

```
Dùng Agent Reach đọc README và các issue gần đây của repo này, rồi cho mình biết có lỗi nào nghiêm trọng đang bị bỏ ngỏ không.
```

Kết quả: agent đọc cả phần bình luận trong issue, rồi tóm tắt cho bạn. Bạn khỏi phải mở từng trang.

### Nhân viên văn phòng đọc bài trên diễn đàn và trang nước ngoài

Bạn cần đọc một bài trên V2EX (diễn đàn công nghệ tiếng Trung) nhưng không đọc được tiếng Trung. Kênh V2EX trả về bài viết và phản hồi dưới dạng gọn gàng. Lệnh theo README là:

```bash
agent-reach read https://www.v2ex.com/t/123
```

Lệnh `read` tự chọn kênh dựa trên đường dẫn. Bạn chỉ cần nói với agent: "Đọc bài này, dịch và tóm tắt các ý chính cho mình, kể cả những phản hồi đáng chú ý."

> Agent giỏi đến mấy cũng chỉ trả lời tốt khi nó đọc được thứ bạn đang hỏi.
>
> — Ông T

### Chủ shop nghiên cứu xu hướng trên Xiaohongshu

Bạn bán hàng và muốn biết người dùng bên đó đang bàn gì về một sản phẩm. Kênh Xiaohongshu là kênh tuỳ chọn, cần đăng nhập. Bạn nói với agent "thêm Xiaohongshu cho mình", agent cài công cụ cần thiết và mở cửa sổ để bạn đăng nhập. Sau đó:

```
Tìm ghi chú Xiaohongshu về chủ đề này, đọc phần bình luận và liệt kê những phàn nàn hay gặp nhất.
```

Kết quả là một bản tổng hợp ý kiến từ ghi chú và bình luận. Nên đăng nhập bằng tài khoản phụ vì nền tảng có thể hạn chế tài khoản bị truy cập tự động.

### Người làm nội dung lấy chữ từ video

Bạn muốn tóm tắt một video YouTube hoặc Bilibili dài. Kênh YouTube lấy được thông tin video, tìm kiếm và phụ đề. Khi video không có phụ đề, tính năng chuyển giọng nói thành chữ cần key Groq hoặc OpenAI (xem phần chuẩn bị). Bạn nhờ agent: "Lấy phụ đề video này rồi tóm tắt thành năm ý chính." Phụ đề Bilibili cần bạn đăng nhập bằng cách quét mã.

## Lỗi hay gặp và cách xử lý

README không liệt kê chi tiết các lỗi (nó trỏ sang file troubleshooting.md trong repo). Dưới đây là những tình huống dễ gặp với loại công cụ này.

- **Agent nói không chạy được lệnh.** Vào cài đặt của agent và bật quyền thực thi lệnh. Đây là việc README có nhắc đến.
- **Lỡ cài nhầm gói trên PyPI.** Trên PyPI có gói trùng tên `agent-reach` nhưng không phải dự án này. Gỡ nó đi và cài lại theo câu trong file install.md. Nếu không chắc, hãy hỏi agent "xem Agent Reach trên máy này đã cài đúng chưa".
- **Một kênh báo hỏng.** Hỏi agent "xem trạng thái Agent Reach" để biết kênh nào lỗi và vì sao. Kênh thử nghiệm (X, Facebook, Instagram) hay hỏng vì nền tảng chặn khá chặt. README nói thẳng là chúng có thể mất tác dụng bất cứ lúc nào.
- **Đăng nhập hết hạn.** Nói với agent "đăng nhập Xiaohongshu hết hạn" hoặc "đổi tài khoản". Nó sẽ mở cửa sổ để bạn tự đăng nhập. Không gửi mật khẩu cho agent.
- **Lộ key trong cuộc trò chuyện.** Nếu lỡ dán key vào khung chat, hãy vào trang của nhà cung cấp để tạo key mới và thu hồi key cũ, rồi nhập lại bằng `agent-reach configure groq-key` trong terminal. Đây là cách xử lý an toàn chung, README chỉ dặn là đừng dán key vào chat.

## Có nên dùng không

**Điểm mạnh:**

- Cài đặt nhẹ: một câu nói với agent, không phải tự xử lý môi trường.
- Có sẵn nhiều kênh mà tìm kiếm thông thường của agent khó chạm tới, đặc biệt các nền tảng tiếng Trung.
- Chỉ đọc, không đăng bài hay bình luận. Mọi thứ gom vào một thư mục `~/.agent-reach/`, gỡ rất gọn: nói "gỡ Agent Reach" thì agent liệt kê những gì sẽ xoá và chờ bạn xác nhận.
- Giấy phép MIT, tác giả cho biết đang dùng hàng ngày và còn duy trì cập nhật.

**Giới hạn:**

- Các kênh cần đăng nhập sẽ dùng phiên đăng nhập sao chép từ Chrome của bạn, thường là tài khoản chính. Nên chuyển sang tài khoản phụ.
- Kênh thử nghiệm không ổn định. Đừng dựa vào chúng cho công việc quan trọng.
- Chuyển giọng nói thành chữ cần key bên thứ ba (Groq hoặc OpenAI).
- Tài liệu chính ở README đa phần là tiếng Trung. README chưa nói rõ hỗ trợ hệ điều hành nào.

**Khi nào nên chọn cách khác:** nếu bạn chỉ cần đọc web thông thường, công cụ tìm và đọc trang có sẵn của agent là đủ. Nếu bạn cần thu thập dữ liệu quy mô lớn, hãy cân nhắc dịch vụ chuyên về thu thập dữ liệu. Còn nếu việc của bạn là cho agent đọc YouTube, GitHub, Reddit hay các nền tảng tiếng Trung chỉ bằng một lệnh, Agent Reach là lựa chọn rất đáng thử.

## Câu hỏi thường gặp

### Agent Reach có miễn phí không?

Repo dùng giấy phép MIT và mô tả của tác giả nói là không tốn phí API. Tuy nhiên chuyển giọng nói thành chữ cần key Groq hoặc OpenAI, và mình chưa có thông tin về chi phí của các dịch vụ này.

### Cài Agent Reach có khó không?

Cách cài chính thức là gửi cho agent một câu kèm đường dẫn tới file install.md, rồi agent tự làm phần còn lại. Bạn chỉ cần cho phép agent chạy lệnh và đồng ý cài uv nếu máy chưa có.

### Cần Python phiên bản nào?

File pyproject.toml của repo yêu cầu Python 3.10 trở lên. README chưa nói rõ về hệ điều hành hay phần cứng, nên bạn xem thêm file docs/install.md trong repo.

### Agent Reach có đụng vào trình duyệt và tài khoản của tôi không?

README cho biết kênh cần đăng nhập dùng một trình duyệt riêng chạy nền, chỉ mở cho máy của bạn. Lần đầu dùng nó sao chép đăng nhập của đúng trang web đó từ Chrome, Chrome gốc không bị đổi và không đọc kho mật khẩu. Vì thường là tài khoản chính, README khuyên dùng tài khoản phụ.

### Agent Reach có đăng bài hay bình luận thay tôi không?

Không. README nói công cụ chỉ đọc và tìm kiếm, không đăng bài, bình luận, like hay nhắn tin riêng. Nó cũng không đăng nhập thay bạn và không hỏi mật khẩu.

### Có cài từ PyPI bằng tên agent-reach được không?

Không nên. README cảnh báo gói tên agent-reach trên PyPI không phải dự án này. Chỉ cài theo địa chỉ GitHub trong file install.md.

### Agent Reach hỗ trợ những nền tảng nào?

Mặc định gồm Bilibili, V2EX, GitHub, YouTube và web. Có thể thêm Xiaohongshu, Xueqiu, Boss, Xiaoyuzhou, LinkedIn, Reddit. Ba kênh thử nghiệm là X (Twitter), Facebook và Instagram, và có thể hỏng bất cứ lúc nào do nền tảng chặn.
