# Agent-Reach: cho AI agent đọc Reddit, YouTube, B站 bằng một CLI — hướng dẫn cài đặt và dùng

> Agent-Reach là một công cụ dòng lệnh viết bằng Python, giúp AI agent như Claude Code hay Codex tìm kiếm và đọc nội dung ở những nền tảng mà agent thường không với tới: YouTube, Reddit, Bilibili, V2EX, Xiaohongshu… Cài không khó vì bạn chỉ cần gửi cho agent một câu có kèm đường dẫn hướng dẫn, agent tự làm phần còn lại.

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

Agent-Reach là một công cụ dòng lệnh (CLI) giúp AI agent đọc và tìm kiếm nội dung trên nhiều nền tảng mà agent thường không vào được: YouTube, Reddit, GitHub, Bilibili, V2EX, Xiaohongshu, X (Twitter)… Tác giả mô tả ngắn gọn là "cho AI agent đôi mắt để nhìn toàn bộ internet", một CLI, không tốn phí API.

Các agent dạng dòng lệnh như Claude Code, Codex, Hermes Agent hay OpenClaw vốn đã biết tìm kiếm và đọc web. Nhưng với những thứ cần đăng nhập, nội dung nằm trong video, hay các trang tiếng Trung, kết quả thường rất yếu. Agent-Reach cài sẵn và thử sẵn các công cụ đứng sau từng nền tảng, để agent chỉ cần gọi một lệnh duy nhất.

Bạn nên xem qua nếu bạn hay nhờ AI tổng hợp thông tin từ nhiều nguồn: người làm nghiên cứu thị trường, người làm nội dung, dev muốn agent đọc issue GitHub hay bài V2EX. Điểm đáng giá nhất là cách cài: bạn không phải gõ lệnh, chỉ cần gửi một câu cho agent. Repo hiện có khoảng 111309 sao và 9980 fork, giấy phép MIT. Xem video ngắn bên dưới để thấy nó chạy thế nào.

```repo
- repo | Panniantong/Agent-Reach
- kind | CLI
- desc | CLI giúp AI agent tìm và đọc YouTube, Reddit, GitHub, Bilibili, V2EX, X, Xiaohongshu… bằng một 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". Mỗi kênh có vài thao tác như tìm kiếm, đọc, xem bình luận. Dưới đây là những gì README liệt kê.

### Các kênh mặc định

Nhóm này cài xong là dùng được ngay:

- **Bilibili**: tìm kiếm, xem thông tin video, video thịnh hành, phụ đề. Phụ đề cần đăng nhập bằng quét mã QR.
- **V2EX**: bài hot, các node, bài viết và trả lời, thông tin người dùng.
- **GitHub**: tìm repo, đọc repo và README, đọc issue và PR kèm bình luận.
- **YouTube**: thông tin video, tìm kiếm, phụ đề, và chuyển giọng nói thành chữ. Phần chuyển giọng nói cần key của Groq hoặc OpenAI.
- **Web**: tìm kiếm và đọc trang web, làm lớp dự phòng.

Lợi ích thực tế: bạn không cần mở từng trang, đọc phụ đề, rồi dán vào khung chat. Agent tự lấy nội dung về và tóm tắt cho bạn.

### Các kênh tuỳ chọn và thử nghiệm

Nhóm **tuỳ chọn** gồm Xiaohongshu (tìm ghi chú, đọc nội dung, xem bình luận), Xueqiu (giá cổ phiếu, tìm mã, bài hot), Boss (tìm việc và mô tả công việc), Xiaoyuzhou (chuyển podcast thành chữ, cần key Groq), LinkedIn và Reddit. Muốn dùng, bạn nói một câu kiểu "thêm Xiaohongshu" là agent bật lên và cài những phần cần thiết.

Nhóm **thử nghiệm** gồm Twitter, Facebook, Instagram. README nói rõ nhóm này dùng được nhưng các nền tảng chặn tự động gắt hơn, nên có thể hỏng bất cứ lúc nào.

### Mỗi thao tác có công cụ chính và công cụ dự phòng

Ví dụ đọc video Bilibili thì dùng bili-cli trước, lỗi thì tự chuyển sang giao diện công khai của Bilibili. Đọc web thì dùng Jina Reader trước, rồi mới đến Exa. Nền tảng đổi giao diện là chuyện thường, nên khi một công cụ hỏng thì chỉ thay trong danh sách, cách bạn dùng không đổi.

### Chỉ đọc, không đăng

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

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

Theo tư liệu, bạn cần:

- **Một AI agent chạy được lệnh**, ví dụ Claude Code, Codex, Hermes Agent, OpenClaw. README nói "mọi agent đều dùng được". Nếu agent báo không chạy được lệnh, bạn vào phần cài đặt của nó để bật quyền "cho phép thực thi lệnh".
- **Python 3.10 trở lên**, theo file pyproject.toml của repo.
- **uv**: một công cụ nhỏ để cài chương trình dòng lệnh, không cần mật khẩu quản trị. Nếu máy chưa có, agent sẽ tự cài và báo bạn.
- **Key Groq hoặc OpenAI** nếu bạn muốn chuyển giọng nói trong video YouTube thành chữ. Podcast Xiaoyuzhou thì cần key Groq.
- **Đăng nhập** ở những nền tảng cần đăng nhập (Xiaohongshu, Reddit, Boss, Twitter, Facebook, Instagram…). Bạn nên dùng tài khoản phụ, lý do nằm ở phần Lỗi hay gặp.

README không nói gì về hệ điều hành hay phần cứng (như GPU), nên mình không khẳng định gì về hai mục này.

```note
Key (Groq, OpenAI) tuyệt đối không dán vào khung chat với agent. README dặn rõ: hãy tự chạy lệnh agent-reach configure groq-key trong terminal của bạn rồi điền key ở đó.
```

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

```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 có đường dẫn install.md cho agent
- Trả lời vài câu hỏi | Cho phép chạy lệnh, đồng ý cài uv, chọn kênh muốn thêm
- Xem kênh nào dùng được | Chạy hoặc nhờ agent chạy agent-reach channels
```

### Mở agent và bật quyền chạy lệnh

Mở agent như bình thường. Nếu nó nói không thể chạy lệnh, vào phần cài đặt và bật "cho phép thực thi lệnh". Đây là chỗ người mới hay vấp nhất, vì không có quyền này agent không cài được gì.

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

Đây là cách cài chính thức trong README. Bạn dán nguyên câu sau 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 nói cả cài mới lẫn nâng cấp đều chỉ cần đúng câu này. Bạn có thể giữ nguyên tiếng Trung như trên, vì đây là câu gốc của tác giả.

Lưu ý quan trọng: 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 cài từ PyPI, chỉ dùng đường dẫn GitHub trong install.md.

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

Theo README, agent có thể hỏi bạn ba việc:

- Có cho phép nó chạy lệnh không.
- Có cài uv không (nếu máy chưa có).
- Có muốn thêm kênh tuỳ chọn nào không. Bạn có thể chọn ngay hoặc nói sau, ví dụ "thêm Xiaohongshu".

Xong, agent sẽ báo kênh nào dùng được ngay (Bilibili, V2EX, GitHub, YouTube, web) và kênh nào bạn còn thêm được.

### Xem các kênh có sẵn

Sau khi cài, bạn (hoặc agent) chạy lệnh này để xem có những kênh nào và mỗi kênh làm được gì:

```bash
agent-reach channels
```

Toàn bộ công cụ, thông tin đăng nhập và cấu hình của Agent-Reach nằm trong một thư mục duy nhất trên máy: `~/.agent-reach/`. Nhờ vậy nâng cấp hay gỡ cài đặt đều gọn.

Nếu bạn muốn cài thủ công: README không ghi cách cài thủ công bằng lệnh. Hãy xem file docs/install.md trong repo.

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

Cách đơn giản nhất là nói với agent: "Xem trạng thái Agent Reach". Theo README, agent sẽ cho biết từng kênh hiện dùng được hay không, và kênh nào lần trước còn tốt nhưng giờ hỏng.

Bạn cũng có thể tự thử bằng lệnh trong terminal:

```bash
agent-reach channels
```

Nếu cài đúng, bạn sẽ thấy danh sách các kênh và thao tác của từng kênh. Sau đó thử một lệnh đọc thật, ví dụ tìm kiếm trên Bilibili:

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

Cú pháp chung là `agent-reach <kênh> <thao tác> [tham số]`. Ở đây "大模型" nghĩa là "mô hình lớn", bạn có thể đổi thành từ khoá khác. Có kết quả video trả về nghĩa là kênh Bilibili đã chạy. README không mô tả định dạng đầu ra cụ thể, nên mình không nói trước màn hình sẽ trông thế nào.

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

Phần lớn thời gian bạn sẽ nói chuyện với agent bằng tiếng thường, agent tự gọi Agent-Reach. Các lệnh dưới đây chỉ để bạn hiểu nó chạy bên dưới ra sao.

### Đọc nhanh một bài thảo luận trên V2EX

Bối cảnh: bạn là dev, có một link bài V2EX về công cụ mới và không có thời gian đọc hết phần trả lời tiếng Trung. Bạn gửi link cho agent và nhờ tóm tắt. Bên dưới, agent dùng lệnh đọc theo link, tự chọn kênh phù hợp:

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

Prompt mẫu: "Đọc bài này và tóm tắt cho mình các ý kiến chính, cả phần trả lời." Kết quả: agent lấy nội dung bài và các trả lời dạng đã được sắp xếp gọn rồi viết lại bằng tiếng Việt.

### Tóm tắt video YouTube hoặc Bilibili

Bối cảnh: bạn làm nội dung, cần ý chính của một video dài về AI. Prompt mẫu: "Lấy phụ đề video này rồi cho mình dàn ý 10 gạch đầu dòng." Kênh YouTube lấy được phụ đề. Nếu video không có phụ đề, bạn có thể dùng chuyển giọng nói thành chữ, nhưng cần key Groq hoặc OpenAI cấu hình bằng `agent-reach configure groq-key` trong terminal của bạn. Với Bilibili, tìm kiếm và xem thông tin video không cần đăng nhập, riêng phụ đề cần quét mã QR.

> Agent không cần thêm trí thông minh, nó chỉ cần với tới được nơi có thông tin.
>
> — Ông T

### Tìm hiểu một repo GitHub trước khi dùng

Bối cảnh: bạn là người mới lập trình, thấy một repo hay nhưng ngại đọc issue tiếng Anh. Prompt mẫu: "Tìm repo về chủ đề này, đọc README và các issue đang mở, cho mình biết repo có hay bị lỗi gì." Kênh GitHub đọc được repo, README, issue và PR kèm bình luận mà không cần đăng nhập. Bạn nhận lại bản tổng hợp các lỗi thường gặp và cách người khác xử lý.

### Nghiên cứu ý kiến người dùng trên Xiaohongshu

Bối cảnh: chủ shop muốn biết người dùng bên Trung Quốc nói gì về một loại sản phẩm. Trước tiên bạn nói: "Thêm Xiaohongshu". Kênh này cần đăng nhập, nên agent sẽ mở cửa sổ để chính bạn đăng nhập (nên dùng tài khoản phụ). Sau đó, prompt mẫu: "Tìm ghi chú về sản phẩm này, đọc nội dung và bình luận rồi tóm tắt khen chê." Kết quả là một bản tóm tắt ý kiến, thay vì bạn phải lướt từng ghi chú.

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

### Agent báo không chạy được lệnh

Đây là lỗi dễ gặp nhất khi mới cài. Vào cài đặt của agent và bật "cho phép thực thi lệnh", rồi gửi lại câu cài đặt. Đừng tắt toàn bộ cảnh báo an toàn của máy chỉ vì chuyện này.

### Lỡ cài gói agent-reach từ PyPI

Tên gói trùng nhưng README khẳng định đó không phải dự án này. Nếu bạn lỡ cài, hãy gỡ đi và cài lại theo câu lệnh có đường dẫn install.md ở trên. Đây là điểm mình muốn bạn nhớ nhất.

### Đăng nhập hết hạn hoặc cần đổi tài khoản

Các kênh như Xiaohongshu, Reddit, Boss cần đăng nhập. Khi đăng nhập hết hạn, bạn nói với agent: "Xiaohongshu hết đăng nhập", "đổi tài khoản" hoặc "đăng xuất". Agent sẽ mở cửa sổ để bạn tự đăng nhập, hoặc xoá đăng nhập của trang đó. Agent không đăng nhập hộ và không hỏi mật khẩu của bạn.

### Chuyển giọng nói thành chữ không chạy

Chức năng này cần key Groq hoặc OpenAI (YouTube), key Groq (Xiaoyuzhou). Hãy tự cấu hình trong terminal của bạn bằng `agent-reach configure groq-key`, đừng gửi key qua khung chat.

### Kênh thử nghiệm đột nhiên hỏng

Twitter, Facebook, Instagram nằm trong nhóm thử nghiệm vì các nền tảng này chặn tự động khá chặt. Khi hỏng, nhờ agent "xem trạng thái Agent Reach" để biết kênh nào lỗi, rồi nói "nâng cấp Agent Reach" để cập nhật công cụ. README cũng có file troubleshooting.md cho các lỗi thường gặp.

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

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

- Cài bằng một câu cho agent, không cần nhớ lệnh.
- Gom nhiều nền tảng vào một cách gọi, có công cụ dự phòng khi công cụ chính hỏng.
- Mạnh ở các nền tảng tiếng Trung và ở nội dung trong video, đúng chỗ tìm kiếm thông thường hay yếu.
- Chỉ đọc, không đăng bài hay bình luận; mọi thứ nằm gọn trong `~/.agent-reach/`; giấy phép MIT.
- Repo vẫn được cập nhật trong vài tháng gần đây.

**Giới hạn:**

- Kênh thử nghiệm có thể hỏng bất cứ lúc nào.
- Nhiều kênh cần đăng nhập, mà tài khoản chính có thể bị nền tảng hạn chế khi truy cập tự động. Bạn nên dùng tài khoản phụ.
- Một số chức năng cần key riêng của Groq hoặc OpenAI, nên "không tốn phí API" chỉ đúng với phần lớn chức năng chứ không phải mọi thứ.
- Tài liệu chính viết bằng tiếng Trung, và README không nói rõ về hệ điều hành.

**Khi nào chọn cách khác:** nếu bạn chỉ cần tìm kiếm web thông thường, agent của bạn đã làm được. Nếu bạn cần đăng bài hay tự động hoá thao tác trên mạng xã hội, công cụ này không làm việc đó, vì nó chỉ đọc. Còn nếu bạn muốn agent đọc video, đọc các trang cần đăng nhập, hoặc tra cứu nền tảng tiếng Trung, 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à tác giả nhấn mạnh "không tốn phí API" cho các kênh. Tuy vậy, chuyển giọng nói thành chữ cần key Groq hoặc OpenAI của bạn, và chi phí của các key đó thì tư liệu không nói rõ.

### Agent-Reach cài như thế nào?

Bạn gửi cho agent một câu có kèm đường dẫn tới file install.md trong repo, và agent tự làm phần còn lại. Câu này dùng được cho cả cài mới lẫn nâng cấp. README cảnh báo không cài gói agent-reach trên PyPI vì đó không phải dự án này.

### Cần Python phiên bản nào, có cần GPU không?

File pyproject.toml yêu cầu Python 3.10 trở lên. README không nhắc gì đến GPU hay yêu cầu phần cứng, nên chưa có thông tin về mục này.

### Chạy được trên Windows không?

Tư liệu không nói rõ về hệ điều hành. README chỉ nói công cụ dùng được với mọi agent có quyền chạy lệnh, nên bạn nên xem docs/install.md trong repo để biết chi tiết.

### Dữ liệu và tài khoản của mình có an toàn không?

Theo README, công cụ chỉ đọc, không đăng bài, bình luận hay nhắn tin. Nó không đăng nhập hộ và không hỏi mật khẩu, nhưng có thể sao chép đăng nhập của một trang từ Chrome sang trình duyệt riêng của nó. Vì thế tác giả khuyên dùng tài khoản phụ.

### Nó khác gì chức năng tìm kiếm web có sẵn của Claude Code hay Codex?

Agent có sẵn tìm kiếm và đọc web, nhưng README cho rằng chúng yếu ở nội dung cần đăng nhập, nội dung trong video và các nền tảng tiếng Trung. Agent-Reach bổ sung phần đó bằng các công cụ cài sẵn cho từng nền tảng.

### Muốn gỡ Agent-Reach thì làm thế nào?

Bạn nói với agent "gỡ Agent Reach". Agent sẽ liệt kê những gì sẽ xoá, và chỉ xoá sau khi bạn xác nhận. README nói nó chỉ xoá những thứ do Agent-Reach cài, không đụng vào file khác hay trình duyệt của bạn.
