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

> Agent Reach là bộ công cụ dòng lệnh (CLI) viết bằng Python, giúp AI Agent như Claude Code hay Codex đọc và tìm kiếm những nền tảng mà nó thường không với tới: YouTube, GitHub, Reddit, X, Bilibili, V2EX, Xiaohongshu. Bạn không tự cài từng công cụ, chỉ cần gửi cho Agent một câu kèm đường dẫn hướng dẫn, nó sẽ tự làm phần còn lại. Cài không khó, nhưng bạn nên đọc kỹ phần an toàn khi cho dùng tài khoản đăng nhập.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-08-19 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/agent-reach-cho-ai-agent-doc-va-tim-kiem-internet-2

Agent Reach là một công cụ dòng lệnh (CLI) mã nguồn mở viết bằng Python, giúp AI Agent của bạn đọc và tìm kiếm trên những nền tảng mà nó thường không với tới. Đó là YouTube, GitHub, Reddit, X (Twitter), Bilibili, V2EX, Xiaohongshu và vài nơi nữa. Tác giả mô tả ngắn gọn: một CLI, không phí API.

Các Agent như Claude Code, Codex, Hermes Agent hay OpenClaw vốn đã có sẵn tìm kiếm và đọc web. Nhưng khi gặp trang cần đăng nhập, video cần lấy phụ đề, hay các nền tảng tiếng Trung mà tìm kiếm chung làm rất kém, chúng bó tay. Agent Reach cài sẵn và kiểm tra giúp bạn các công cụ đứng sau từng nền tảng. Agent chỉ cần gọi một lệnh `agent-reach` là xong.

Repo này hợp với ai? Người làm nghiên cứu thị trường, làm nội dung, dev mới đang dùng AI Agent hằng ngày và muốn nó "nhìn" được nhiều nguồn hơn. Điểm đáng giá nhất: bạn không phải tự cài từng công cụ, chỉ cần nhờ Agent cài. Repo là MIT, hiện có khoảng 111.000 sao và gần 10.000 fork, vẫn được cập nhật trong vài tháng gần đây. Bạn có thể xem video ngắn bên dưới để thấy nó chạy thực tế.

```repo
- repo | Panniantong/Agent-Reach
- kind | CLI
- desc | Agent Reach cài sẵn công cụ để AI Agent tìm và đọc YouTube, GitHub, Reddit, X, Bilibili, V2EX, Xiaohongshu… chỉ bằng một lệnh agent-reach, 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ì

Ý tưởng cốt lõi: mỗi nền tảng có một danh sách công cụ xếp theo thứ tự ưu tiên. Công cụ đầu tiên hỏng thì tự chuyển sang công cụ dự phòng. Ví dụ, đọc video Bilibili thì thử bili-cli trước, lỗi thì chuyển sang giao diện công khai của Bilibili. Đọc trang web thì dùng Jina Reader trước, rồi mới đến Exa. Nhờ vậy, khi nền tảng đổi giao diện, cách bạn dùng vẫn giữ nguyên.

Các nhóm việc chính:

- **Đọc nền tảng cần đăng nhập.** Tìm ghi chú trên Xiaohongshu, xem bài đăng trên X, đọc chi tiết tin tuyển dụng. Bạn khỏi phải mở từng trang bằng tay.
- **Lấy nội dung trong video.** Phụ đề Bilibili và YouTube, cộng với chuyển giọng nói thành văn bản cho YouTube và podcast Xiaoyuzhou (cần key Groq hoặc OpenAI). Bạn có thể nhờ AI tóm tắt một video dài mà không phải xem hết.
- **Nền tảng tiếng Trung.** Bilibili, Xiaohongshu, V2EX, Xueqiu (cổ phiếu Trung Quốc). Tìm kiếm chung của Agent thường rất yếu ở những nơi này.
- **Dữ liệu gọn gàng.** Bài và bình luận V2EX, repo và issue GitHub, giá cổ phiếu Xueqiu. Agent nhận được nội dung đã chỉnh tề thay vì cả trang HTML lộn xộn.

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

| Mức | Ý nghĩa | Kênh |
|---|---|---|
| Mặc định | Cài xong là dùng được | Bilibili, V2EX, GitHub, YouTube, web |
| Tùy chọn | Bạn nói "thêm kênh X" thì mới bật | Xiaohongshu, Xueqiu, Boss, Xiaoyuzhou, LinkedIn, Reddit |
| Thử nghiệm | Dùng được nhưng dễ hỏng vì nền tảng chặn gắt | Twitter/X, Facebook, Instagram |

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

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

Tư liệu của repo nói không nhiều về cấu hình máy, nên mình chỉ nêu những gì có:

- **Python từ 3.10 trở lên** (theo file `pyproject.toml`).
- **Một AI Agent chạy được lệnh trên máy bạn**, ví dụ Claude Code, Codex, Hermes Agent hay 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 cài đặt của nó bật quyền "cho phép thực thi lệnh".
- **uv** là 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ị. Máy chưa có thì Agent sẽ cài trước và báo bạn.
- **Trình duyệt Chrome** nếu bạn muốn dùng các kênh cần đăng nhập. Lần đầu dùng một website, Agent Reach sao chép phiên đăng nhập của website đó từ Chrome sang trình duyệt riêng của nó.
- **Key Groq hoặc OpenAI** chỉ khi bạn muốn chuyển giọng nói thành chữ (YouTube, podcast Xiaoyuzhou). README ghi Xiaoyuzhou cần key Groq.
- **Tài khoản đăng nhập** cho các kênh như Xiaohongshu, Reddit, Boss, Twitter, Facebook, Instagram.

Tư liệu không nói gì về yêu cầu GPU hay dung lượng ổ cứng. Mình cũng không thấy README nêu rõ hệ điều hành nào được hỗ trợ.

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

Điểm khác biệt: bạn không tự gõ lệnh cài. Bạn nhờ chính Agent cài, dựa trên một file hướng dẫn `docs/install.md` trong repo.

```steps
- Mở Agent | Mở Claude Code, Codex hoặc Agent bạn đang dùng, ở chế độ cho phép chạy lệnh
- Gửi câu lệnh cài | Dán một câu kèm đường dẫn install.md cho Agent
- Trả lời câu hỏi | Cho phép chạy lệnh, đồng ý để nó cài uv nếu máy chưa có
- Chọn kênh thêm | Nói tên kênh tùy chọn bạn muốn bật
- Kiểm tra | Chạy agent-reach channels hoặc nhờ Agent xem trạng thái
```

### Bật quyền chạy lệnh cho Agent

Mở Agent của bạn ở một cửa sổ làm việc bình thường. Nếu Agent nói nó không thể chạy lệnh, vào phần cài đặt và bật tùy chọn kiểu "cho phép thực thi lệnh". Chỗ này người mới hay vấp nhất: không bật thì Agent chỉ trả lời bằng chữ chứ không cài gì được.

### Gửi câu lệnh cài cho Agent

Dán nguyên câu sau cho Agent (đây là câu có trong README, dùng cho cả cài mới lẫn nâng cấp):

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

Câu này tiếng Trung có nghĩa là "giúp tôi cài Agent Reach" kèm đường dẫn. Bạn có thể diễn đạt bằng tiếng Việt, ví dụ "Giúp mình cài Agent Reach theo hướng dẫn ở đường dẫn này", rồi dán cùng đường dẫn trên. Điều quan trọng là Agent đọc đúng file `install.md` từ địa chỉ GitHub.

```note
Trên PyPI có một gói tên agent-reach nhưng KHÔNG phải dự án này, README cảnh báo đừng cài từ đó. Chỉ dùng địa chỉ GitHub trong install.md. Ngoài ra repo khẳng định không có token, coin hay ví tiền ảo nào mang tên Agent Reach. Gặp ai mời kết nối ví thì đó là giả mạo.
```

### Trả lời các câu hỏi của Agent

Trong lúc cài, Agent có thể hỏi bạn ba việc:

- Cho phép chạy lệnh trên máy.
- Cài uv nếu máy chưa có. Agent sẽ báo trước.
- Có muốn thêm kênh tùy chọn nào không. Cài xong Agent sẽ cho biết kênh nào dùng được ngay (Bilibili, V2EX, GitHub, YouTube, web) và kênh nào còn thêm được. Bạn chưa cần chọn ngay, sau này nói "thêm Xiaohongshu" là được.

Repo cũng ghi rõ Agent không bao giờ đăng nhập thay bạn và không hỏi mật khẩu của bạn.

### Điền key (nếu cần)

Chỉ khi bạn muốn chuyển giọng nói thành chữ. README dặn đừng dán key vào khung chat. Hãy mở terminal của chính bạn (PowerShell hay Terminal) và chạy:

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

Lệnh này sẽ hỏi bạn key Groq rồi lưu vào máy. Mọi thứ Agent Reach cài (công cụ, đăng nhập, cấu hình) nằm trong một thư mục duy nhất là `~/.agent-reach/`, nên sau này nâng cấp hay xóa khá gọn.

README không nói cách cài thủ công bằng pip hay git clone. Nếu bạn muốn đọc chi tiết hơn, xem file `docs/install.md` trong repo, và `troubleshooting.md` khi gặp sự cố.

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

Cách nhanh nhất là nhờ Agent: "Xem trạng thái Agent Reach". README cho biết Agent sẽ báo từng kênh đang dùng được hay không, và kênh nào trước đó ổn mà giờ hỏng.

Bạn cũng có thể tự chạy lệnh liệt kê kênh trong terminal:

```bash
agent-reach channels
```

Kết quả mong đợi là danh sách các kênh và việc mỗi kênh làm được. Nếu thấy danh sách thì chương trình đã vào máy. Bạn có thể thử thêm một lệnh đọc trang công khai không cần đăng nhập, ví dụ bài V2EX theo mẫu trong README:

```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 đưa. Nếu in ra nội dung bài viết là ổn.

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

Một lưu ý trước: phần lớn thời gian bạn không gõ lệnh, mà nói chuyện với Agent. Các câu mẫu dưới đây là gợi ý theo khả năng README nêu, bạn đổi giọng cho hợp.

### Chủ shop theo dõi xu hướng trên Bilibili

Bạn bán đồ công nghệ và muốn biết người dùng Trung Quốc đang bàn gì về một chủ đề. Dùng lệnh theo mẫu README, cú pháp là `agent-reach <kênh> <hành động> [tham số]`:

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

Hoặc nói với Agent: "Tìm các video Bilibili nổi bật về chủ đề này, lấy phụ đề rồi tóm tắt ý chính cho mình bằng tiếng Việt". Kết quả là danh sách video kèm thông tin, và nếu lấy được phụ đề thì có bản tóm tắt. README ghi phụ đề Bilibili cần đăng nhập bằng quét mã.

### Nhân viên văn phòng tóm tắt video YouTube dài

Sếp gửi một video họp hoặc hội thảo dài một tiếng. Bạn nhờ Agent: "Đọc phụ đề video YouTube này và tóm tắt thành 10 gạch đầu dòng". Kênh YouTube là mặc định, hỗ trợ lấy thông tin, tìm kiếm và phụ đề mà không cần tài khoản. Nếu video không có phụ đề, bạn có thể bật chuyển giọng nói thành chữ, nhưng khi đó phải có key Groq hoặc OpenAI.

> Cài một lần, từ đó Agent của bạn đọc được những nơi trước đây nó chỉ biết đứng ngoài nhìn.
>
> — Ông T

### Dev mới đọc repo và issue GitHub

Bạn đang cân nhắc dùng một thư viện lạ. Nhờ Agent: "Tìm repo GitHub về chủ đề này, đọc README và các issue đang mở, cho mình biết lỗi nào hay gặp". Kênh GitHub là mặc định, hỗ trợ tìm repo, đọc repo/README, đọc issue và PR kèm bình luận, không cần cài thêm. Kết quả là dữ liệu có cấu trúc, rất tiện để AI phân tích.

### Người làm nội dung nghiên cứu mạng xã hội

Bạn làm tiếp thị và muốn xem người ta nói gì về một sản phẩm trên Reddit hoặc Xiaohongshu. Đầu tiên nói: "Thêm Reddit cho mình" (hoặc "Thêm Xiaohongshu"). Agent sẽ cài thứ cần thiết và mở cửa sổ để bạn tự đăng nhập. Sau đó bạn nhờ: "Tìm các bài nói về sản phẩm này, đọc bình luận và tổng hợp ý kiến khen chê". Kết quả là bản tổng hợp từ bài viết và bình luận. Hai kênh này cần đăng nhập, và README khuyến nghị dùng tài khoản phụ.

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

README không liệt kê chi tiết từng lỗi mà chỉ trỏ đến `troubleshooting.md`. Dưới đây là những chỗ rất dễ vấp với loại công cụ này, kèm hướng xử lý an toàn.

### Agent nói không chạy được lệnh

Đây là lỗi hay gặp nhất ở bước cài. Vào cài đặt của Agent và bật quyền "cho phép thực thi lệnh", rồi dán lại câu lệnh cài. Đừng bấm cho phép những thứ bạn không hiểu, hãy đọc câu Agent xin quyền chạy.

### Lệnh agent-reach không nhận

Thường do cài chưa xong hoặc terminal chưa nạp lại đường dẫn. Hãy đóng terminal, mở cái mới rồi thử lại. Nếu vẫn không được, nhờ Agent: "Xem trạng thái Agent Reach và cho mình biết thiếu gì". Đừng cài gói `agent-reach` từ PyPI để chữa cháy, vì đó không phải dự án này.

### Một kênh đang dùng được bỗng hỏng

Điều này bình thường: README viết thẳng "nền tảng đổi giao diện, công cụ hỏng là chuyện thường", nhất là các kênh thử nghiệm (Twitter, Facebook, Instagram). Hãy nhờ Agent xem trạng thái và nâng cấp bằng câu "Nâng cấp Agent Reach". Nó sẽ cập nhật chương trình lẫn công cụ từng kênh và nói bạn cần làm gì thêm.

### Đăng nhập hết hạn hoặc bị nền tảng hạn chế

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. Vì phiên đăng nhập được sao chép từ Chrome và thường là tài khoản chính, nền tảng có thể hạn chế tài khoản bị truy cập tự động. Cách an toàn là dùng tài khoản phụ.

### Lộ key khi dán vào chat

Nếu lỡ dán key Groq hay OpenAI vào khung chat, hãy coi nó đã lộ: vào trang của nhà cung cấp, thu hồi và tạo key mới, rồi nhập lại bằng `agent-reach configure groq-key` trong terminal của bạn.

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

**Điểm mạnh.** Cài đặt gần như do Agent làm giúp, phù hợp với người không rành dòng lệnh. Một lệnh thống nhất cho nhiều nền tảng, có cơ chế công cụ dự phòng khi một công cụ hỏng. Chỉ đọc, không đăng bài hay nhắn tin. Mọi thứ nằm gọn trong một thư mục `~/.agent-reach/`, gỡ cũng dễ: nói "Gỡ Agent Reach" thì Agent liệt kê những gì sẽ xóa, bạn đồng ý rồi mới xóa. Giấy phép MIT, tác giả nói mình dùng hằng ngày và sẽ tiếp tục bảo trì.

**Giới hạn.** Các kênh cần đăng nhập đồng nghĩa với việc dùng phiên đăng nhập trên máy bạn, nên phải cẩn thận với tài khoản chính. Kênh thử nghiệm có thể hỏng bất cứ lúc nào. Chuyển giọng nói thành chữ cần key bên thứ ba, và chi phí tùy nhà cung cấp, README không nói rõ giá. README chủ yếu viết bằng tiếng Trung, và tư liệu mình có chưa nêu rõ hỗ trợ hệ điều hành nào, nên hãy đọc `docs/install.md` trước khi cài.

**Khi nào chọn cách khác.** Nếu bạn chỉ cần Agent đọc vài trang web công khai, tính năng tìm kiếm và đọc web có sẵn của Agent thường đã đủ. Nếu cần thu thập dữ liệu quy mô lớn, ổn định, có hợp đồng và hỗ trợ, hãy tìm dịch vụ chuyên dụng. Còn nếu bạn muốn Agent "nhìn" được YouTube, Reddit, GitHub và các nền tảng tiếng Trung chỉ với một lần cài, đây là một lựa chọn rất đáng thử.

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

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

Bản thân repo dùng giấy phép MIT và mô tả là không tốn phí API. Tuy nhiên một số tính năng như chuyển giọng nói thành chữ cần key Groq hoặc OpenAI. Tư liệu không nêu giá của các dịch vụ này, bạn nên xem trực tiếp bên nhà cung cấp.

### Agent Reach có cần GPU không?

Tư liệu không nhắc đến yêu cầu GPU hay cấu hình phần cứng. Việc chuyển giọng nói thành chữ được thực hiện qua key Groq hoặc OpenAI, nên có vẻ không cần chạy mô hình trên máy bạn, nhưng đây là suy luận, README chưa nói rõ.

### Cần Python phiên bản nào và có chạy trên Windows được không?

File pyproject.toml yêu cầu Python từ 3.10 trở lên. README mình có không ghi rõ danh sách hệ điều hành hỗ trợ, nên chưa thể khẳng định về Windows. Bạn hãy đọc docs/install.md trong repo trước khi cài.

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

Với các kênh cần đăng nhập, nó 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 một website, nó sao chép phiên đăng nhập của website đó từ Chrome, trình duyệt gốc không thay đổi và nó không đọc kho mật khẩu. Vì thường là tài khoản chính nên README khuyên dùng tài khoản phụ.

### Nó có đăng bài hay nhắn tin thay tôi không?

Không. README nói rõ Agent Reach 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 bao giờ đăng nhập thay bạn hay xin mật khẩu.

### Agent Reach khác gì tìm kiếm web sẵn có của Claude Code hay Codex?

Các Agent đó có tìm kiếm và đọc web cơ bản, nhưng khó với trang cần đăng nhập, phụ đề video và các nền tảng tiếng Trung. Agent Reach bổ sung phần này bằng bộ công cụ đã cài sẵn và thử sẵn cho từng nền tảng, gọi bằng một lệnh thống nhất.

### Gỡ cài đặt thế nào?

Bạn nói với Agent: "Gỡ Agent Reach". Nó sẽ liệt kê những thứ sắp xóa, bạn xác nhận rồi mới xóa. Nó chỉ xóa những gì Agent Reach đã cài, file khác và trình duyệt của bạn không bị đụng tới, và cuối cùng sẽ chỉ cách xóa chương trình chính.
