Agent-Reach: cho AI đọc Twitter, Reddit, YouTube, Bilibili — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về Panniantong/Agent-Reach — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Agent-Reach: cho AI agent đọc Reddit, YouTube, B站 bằng một CLI — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Agent-Reach là bộ công cụ dòng lệnh bằng Python (giấy phép MIT), giúp AI agent như Claude Code hay Codex tìm và đọc các nền tảng mà agent thường không với tới: YouTube, Bilibili, V2EX, GitHub, Reddit, Xiaohongshu… Bạn không cần tự gõ lệnh cài, chỉ cần gửi một câu cho agent và nó tự làm phần còn lại. Cài đặt khá dễ, nhưng một số kênh cần đăng nhập hoặc có khoá API.
Agent-Reach là một công cụ dòng lệnh (CLI) viết bằng Python, giúp AI agent "nhìn thấy" những phần của internet mà nó thường không với tới. Agent như Claude Code, Codex hay OpenClaw vốn đã biết tìm kiếm và đọc web. Nhưng với nội dung phải đăng nhập, phụ đề video, hay các nền tảng tiếng Trung, kết quả thường rất kém. Agent-Reach cài sẵn và kiểm tra sẵn các công cụ phía sau, để agent chỉ cần gọi một lệnh.
Nếu bạn làm kinh doanh, văn phòng hoặc mới học lập trình mà hay nhờ AI tra cứu thông tin, repo này dành cho bạn. Ví dụ: xem người ta bàn gì về sản phẩm trên Reddit, lấy nội dung một video YouTube, đọc bài thảo luận trên V2EX, hay tìm repo và issue trên GitHub. Hiện repo có khoảng 111 nghìn sao và gần 10 nghìn fork trên GitHub, nên khá nhiều người đang dùng.
Điểm đáng giá nhất là cách cài: bạn không phải gõ lệnh cài thủ công, chỉ gửi cho agent một câu và nó tự cài. Ngoài ra repo chỉ đọc, không đăng bài hay bình luận thay bạn. Bạn có thể xem video ngắn bên dưới để thấy nó chạy thế nào, rồi quay lại đây làm theo từng bước.
Panniantong/Agent-Reach
Công cụ dòng lệnh giúp AI agent tìm và đọc YouTube, GitHub, Bilibili, V2EX, Reddit, Xiaohongshu… bằng một lệnh duy nhất, không tốn phí API.
I.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ó các hành động riêng, nhưng cách gọi giống nhau: agent-reach <kênh> <hành động> [tham số]. Bạn không cần nhớ lệnh, vì agent sẽ tự dùng. Dưới đây là những gì có sẵn theo README.
A.Các kênh mặc định, cài xong dùng ngay
- Bilibilitìm kiếm, xem thông tin video, video đang hot và phụ đề. Riêng phụ đề cần đăng nhập bằng quét mã QR.
- V2EXbài hot, các node, nội dung bài viết kèm phản hồi, và thông tin người dùng. Hữu ích nếu bạn theo dõi cộng đồng lập trình Trung Quốc.
- GitHubtìm repo, đọc repo và README, đọc issue và PR (kèm bình luận).
- YouTubethông tin video, tìm kiếm, phụ đề, và chuyển giọng nói thành chữ. Phần chuyển thành chữ cần khoá Groq hoặc OpenAI.
- Webtìm kiếm và đọc trang web thông thường, đóng vai trò dự phòng.
B.Các kênh tuỳ chọn và thử nghiệm
- Tuỳ chọn (bật khi cần): Xiaohongshu (tìm ghi chú, đọc nội dung, xem bình luận), Xueqiu (giá cổ phiếu, hot post), Boss (tìm việc), Xiaoyuzhou (podcast thành văn bản), LinkedIn, Reddit.
- Thử nghiệm: Twitter/X, Facebook, Instagram. Dùng được nhưng nền tảng chống robot gắt hơn nên có thể hỏng bất cứ lúc nào.
C.Cơ chế dự phòng
Mỗi hành động có một danh sách công cụ, thử lần lượt theo thứ tự. 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 web thì thử Jina Reader trước, rồi mới tới Exa. Khi nền tảng đổi giao diện, tác giả chỉ cần chỉnh danh sách này, còn cách bạn dùng giữ nguyên.
D.Gom mọi thứ vào một thư mục
Công cụ, thông tin đăng nhập và cài đặt của các kênh đều nằm trong một thư mục ~/.agent-reach/. Nhờ vậy việc nâng cấp, quản lý hay gỡ bỏ đều gọn.
II.Cần chuẩn bị gì
README không liệt kê hệ điều hành được hỗ trợ, nên mình không khẳng định. Những gì tư liệu có nói:
- Một AI agent chạy được lệnh trong terminal, ví dụ Claude Code hoặc Codex. 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ó và bật quyền "cho phép thực thi lệnh".
- Python từ 3.10 trở lên: đây là yêu cầu trong file
pyproject.tomlcủa repo. - uv: công cụ nhỏ để cài chương trình dòng lệnh, không cần quyền quản trị. Nếu máy chưa có, agent sẽ cài trước và báo bạn.
- Trình duyệt Chrome (nếu dùng kênh cần đăng nhập): Agent-Reach copy phiên đăng nhập của đúng một website từ Chrome sang trình duyệt riêng của nó.
- Khoá Groq hoặc OpenAI: chỉ cần khi muốn chuyển giọng nói thành chữ (YouTube) hoặc podcast Xiaoyuzhou (khoá Groq).
- Tài khoản từng nền tảng: các kênh Xiaohongshu, Boss, Reddit, Twitter, Facebook, Instagram cần đăng nhập. README khuyên dùng tài khoản phụ.
README không nói gì về yêu cầu GPU hay dung lượng ổ đĩa.
III.Cài đặt từng bước
- Mở agentMở Claude Code, Codex hoặc agent bạn đang dùng, ở một cửa sổ chat bình thường
- Cho phép chạy lệnhBật quyền thực thi lệnh nếu agent báo không chạy được
- Gửi câu lệnh càiDán một câu duy nhất kèm địa chỉ install.md
- Trả lời câu hỏiĐồng ý cài uv nếu được hỏi, chọn kênh tuỳ chọn muốn thêm
- Kiểm traHỏi agent trạng thái hoặc chạy agent-reach channels
README chọn cách cài "nhờ agent làm" thay vì bắt bạn gõ lệnh. Không có bước nào kiểu pip install được ghi trong README. Nếu muốn xem chi tiết các bước, hãy mở file docs/install.md trong repo.
A.Mở agent và bật quyền chạy lệnh
Mở agent bạn quen dùng. Nếu nó nói "tôi không thể chạy lệnh", vào phần cài đặt của agent và bật tuỳ chọn cho phép thực thi lệnh. Người mới hay vấp ở chỗ này nên mình đặt lên đầu.
B.Gửi câu lệnh cài đặt
Dán đúng câu sau vào khung chat của agent:
帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.mdCâu này có nghĩa là "giúp tôi cài Agent Reach" kèm địa chỉ file hướng dẫn. Bạn có thể giữ nguyên tiếng Trung hoặc dịch sang tiếng Việt, miễn là địa chỉ đúng. README nói cả cài mới lẫn nâng cấp đều chỉ cần đúng câu này.
Trên PyPI cũng có một gói tên agent-reach nhưng đó KHÔNG phải dự án này. README dặn rõ: đừng cài từ PyPI, chỉ dùng địa chỉ GitHub trong install.md. Ngoài ra, dự án không có token, tiền mã hoá hay hoạt động liên quan đến ví. Ai mượn tên Agent Reach để mời kết nối ví đều là giả mạo.
C.Trả lời các câu hỏi của agent
Trong lúc cài, agent có thể hỏi bạn vài việc:
- Cho phép chạy lệnh (đã nói ở trên).
- Cài uv nếu máy chưa có. Agent sẽ báo trước.
- Có thêm kênh tuỳ chọn không. Sau khi cài xong, agent liệt kê kênh nào đã dùng được (Bilibili, V2EX, GitHub, YouTube, web) và kênh nào có thể thêm. Bạn chưa muốn thì cứ bỏ qua, sau này nói "thêm Xiaohongshu" là được.
D.Về đăng nhập
Agent không bao giờ đăng nhập thay bạn và không hỏi mật khẩu. Với kênh cần đăng nhập, lần đầu dùng một website, nó sao chép phiên đăng nhập của website đó từ Chrome sang trình duyệt riêng của nó. Trình duyệt gốc của bạn không bị thay đổi và nó không đọc kho mật khẩu. Vì thường là tài khoản chính, README khuyên bạn đổi sang tài khoản phụ bằng cách nói với agent.
IV.Kiểm tra đã chạy được chưa
Cách dễ nhất là nói với agent: "Xem trạng thái Agent Reach" (README ghi mẫu bằng tiếng Trung là 看看 Agent Reach 状态). Agent sẽ cho biết từng kênh 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ự chạy trong terminal:
agent-reach channelsLệnh này liệt kê các kênh có sẵn và mỗi kênh làm được gì. Nếu thấy danh sách kênh hiện ra, cài đặt đã thành công. Nếu terminal báo không tìm thấy lệnh agent-reach, hãy nhờ agent kiểm tra lại quá trình cài, vì README không nói thêm về trường hợp này.
Thử thêm một lệnh đọc đơn giản:
agent-reach read https://www.v2ex.com/t/123Lệnh read tự chọn kênh theo đường link. Link V2EX sẽ được đọc bằng kênh V2EX, trả về nội dung bài và các phản hồi.
V.Dùng vào việc thật
Phần lớn thời gian bạn chỉ nói chuyện với agent bằng tiếng thường, agent sẽ tự gọi agent-reach. Mấy tình huống dưới đây bám đúng những gì README mô tả.
A.Chủ shop theo dõi ý kiến khách trên mạng
Bạn bán đồ gia dụng và muốn biết người dùng đang nói gì về một loại sản phẩm trên Reddit. Reddit là kênh tuỳ chọn, nên trước hết hãy nói với agent:
Thêm kênh Reddit cho Agent Reach(README ghi mẫu là "帮我加上 XX".) Agent cài công cụ 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 trên Reddit nói về nồi chiên không dầu, đọc bình luận và tóm tắt những lời phàn nàn lặp lại nhiều nhất". Kết quả là một bản tóm tắt ý kiến thật, không phải bạn tự lướt từng bài.
Agent giỏi đến mấy mà không đọc được nơi khách hàng đang nói chuyện thì cũng chỉ đoán mò.
Ông T
B.Nhân viên văn phòng tóm tắt video dài
Sếp gửi một video YouTube dài một tiếng và hỏi bạn có ý chính nào không. Bạn dán link cho agent kèm yêu cầu: "Lấy phụ đề video này và tóm tắt thành 10 gạch đầu dòng, kèm ghi chú những chỗ cần hành động". YouTube là kênh mặc định, và README nói đọc phụ đề không cần tài khoản. Nếu video không có phụ đề, bạn cần khoá Groq hoặc OpenAI để chuyển giọng nói thành chữ. Cấu hình khoá bằng lệnh sau, chạy ở terminal của bạn (không dán khoá vào chat):
agent-reach configure groq-keyLệnh này nhắc bạn điền khoá Groq. README nhấn mạnh phải chạy trong terminal riêng, không gửi khoá qua cuộc trò chuyện với agent.
C.Lập trình viên mới tìm hiểu repo và cộng đồng
Bạn đang chọn thư viện và muốn xem repo nào đáng dùng. Bạn bảo agent: "Tìm repo GitHub về chủ đề này, đọc README và các issue đang mở, cho mình biết điểm yếu mà người dùng hay phàn nàn". Kênh GitHub đọc được repo, README, issue và PR kèm bình luận. Nếu muốn tham khảo thêm góc nhìn cộng đồng, bạn đưa link bài V2EX để agent đọc cả bài lẫn phản hồi bằng lệnh agent-reach read ở trên.
D.Người làm nội dung tìm tin và xu hướng tiếng Trung
Bạn làm tư vấn nhập hàng hoặc viết nội dung và cần ý tưởng từ nền tảng Trung Quốc. Với Bilibili, bạn có thể nhờ agent tìm video về một chủ đề. Lệnh tương ứng trong README là:
agent-reach bilibili search "大模型"大模型 nghĩa là "mô hình lớn" (LLM). Bạn đổi từ khoá theo nhu cầu. Agent trả về danh sách video, bạn có thể nhờ dịch và tóm tắt tiếp. Kênh Xiaohongshu cho phép tìm ghi chú và xem bình luận nhưng cần đăng nhập và nên dùng tài khoản phụ.
VI.Lỗi hay gặp và cách xử lý
A.Agent nói không chạy được lệnh
Đây là vướng mắc phổ biến nhất khi cài. Vào cài đặt của agent và bật quyền cho phép thực thi lệnh, sau đó gửi lại câu cài đặt.
B.Cài nhầm gói trên PyPI
Nếu bạn tự gõ pip install agent-reach, bạn sẽ cài gói của người khác. README cảnh báo rõ gói này không phải dự án. Hãy gỡ nó và quay lại cách cài bằng câu lệnh gửi cho agent, chỉ dùng địa chỉ GitHub.
C.Kênh cần đăng nhập báo hỏng hoặc hết hạn
Phiên đăng nhập có thể hết hạn. Hãy nói với agent "Đăng nhập Xiaohongshu hết hạn" hoặc "đổi tài khoản" (README có các mẫu câu này). Agent mở cửa sổ đăng nhập để bạn tự làm. Nếu muốn dừng hẳn, nói "đăng xuất" để xoá phiên đăng nhập của website đó.
D.Chuyển giọng nói thành chữ không chạy
Chức năng này (YouTube, podcast Xiaoyuzhou) cần khoá Groq hoặc OpenAI. Hãy chạy agent-reach configure groq-key trong terminal của bạn và điền khoá. Đừng gửi khoá vào chat.
E.Kênh thử nghiệm đột ngột hỏng
Twitter/X, Facebook và Instagram được tác giả ghi là "thử nghiệm": nền tảng chống robot gắt hơn nên có thể hỏng bất cứ lúc nào. Hãy nhờ agent xem trạng thái, thử nâng cấp bằng câu "Nâng cấp Agent Reach", và đừng quá phụ thuộc vào các kênh này cho việc quan trọng. README cũng nhắc nền tảng có thể hạn chế tài khoản bị truy cập tự động, nên dùng tài khoản phụ cho an toàn.
Ngoài ra README có nhắc đến một file troubleshooting.md (xử lý sự cố) trong repo, bạn có thể tham khảo khi lỗi vẫn không hết.
VII.Có nên dùng không
Điểm mạnh
- Cài nhẹ nhàng: gửi một câu cho agent là xong, phù hợp người ít kinh nghiệm dòng lệnh.
- Một cách gọi chung cho nhiều nền tảng, kèm cơ chế dự phòng khi công cụ phía sau lỗi.
- Chỉ đọc, không đăng bài, bình luận, like hay nhắn tin thay bạn.
- Mọi thứ nằm trong một thư mục
~/.agent-reach/, nâng cấp và gỡ dễ. Muốn gỡ thì nói "Gỡ Agent Reach", agent liệt kê những gì sẽ xoá và chờ bạn xác nhận. - Giấy phép MIT, repo vẫn được cập nhật trong vài tháng gần đây.
- Mô tả của tác giả là "zero API fees" (không tốn phí API). Tuy vậy, chuyển giọng nói thành chữ cần khoá Groq hoặc OpenAI, có thể phát sinh chi phí theo nhà cung cấp, nên bạn tự kiểm tra bảng giá của họ.
Giới hạn
- README viết chủ yếu bằng tiếng Trung, nhiều kênh hướng đến nền tảng Trung Quốc. Nếu bạn chỉ cần tìm web thông thường, agent của bạn có thể đã đủ dùng.
- Các kênh cần đăng nhập đòi bạn đưa phiên đăng nhập vào trình duyệt riêng của công cụ. Dù không đọc mật khẩu, bạn vẫn nên dùng tài khoản phụ.
- Kênh thử nghiệm không ổn định. Cũng vì phụ thuộc nhiều công cụ bên thứ ba, đôi khi sẽ có kênh hỏng đến khi tác giả cập nhật.
- Tư liệu chưa nêu rõ hệ điều hành nào được hỗ trợ, và chưa nói cách cài thủ công không qua agent.
Khi nào nên chọn cách khác
Nếu bạn cần thu thập dữ liệu quy mô lớn, hoặc cần đăng bài và tương tác tự động, repo này không làm những việc đó. Hãy tìm công cụ khác phù hợp, ví dụ dịch vụ thu thập dữ liệu chuyên dụng. Còn nếu bạn muốn agent "đọc được" YouTube, GitHub, V2EX, Bilibili hoặc Reddit một cách đơn giản, Agent-Reach là lựa chọn đá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ả là không tốn phí API. Tuy nhiên chuyển giọng nói thành chữ cần khoá Groq hoặc OpenAI, chi phí (nếu có) do nhà cung cấp đó quy định. Tư liệu không nói thêm về giá.
Cài Agent-Reach như thế nào, có cần gõ lệnh không?
Bạn gửi cho agent một câu kèm địa chỉ file install.md trong repo, agent tự làm phần còn lại. Nếu máy chưa có uv, agent sẽ cài trước và báo bạn. README không ghi cách cài thủ công, muốn xem chi tiết hãy mở docs/install.md.
Agent-Reach có cần GPU hoặc máy cấu hình mạnh không?
Tư liệu không nói gì về GPU hay cấu hình tối thiểu. Công cụ chủ yếu là các lệnh tìm và đọc nội dung, còn pyproject.toml chỉ yêu cầu Python từ 3.10 trở lên.
Có an toàn cho tài khoản của tôi không?
README nói công cụ chỉ đọc, không đăng bài, bình luận, like hay nhắn tin. 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ó sao chép phiên đăng nhập của đúng một website từ Chrome sang trình duyệt riêng, nên tác giả khuyên dù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.
Dùng được với những agent nào, và chạy trên Windows được không?
README ghi "mọi agent đều dùng được", với ví dụ như Claude Code, Codex, Hermes Agent và OpenClaw. Về hệ điều hành, tư liệu chưa nêu rõ. Bạn nên xem docs/install.md hoặc hỏi agent trước khi cài.
Cài từ PyPI được không?
Không. 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 hướng dẫn trong install.md bằng địa chỉ GitHub.
Agent-Reach khác gì việc agent tự tìm kiếm web?
Agent thường chỉ tìm và đọc web thông thường. Agent-Reach bổ sung những phần agent khó với tới: nội dung cần đăng nhập, phụ đề và giọng nói trong video, và các nền tảng tiếng Trung như Bilibili, Xiaohongshu, V2EX. Nó cũng trả dữ liệu đã được chuẩn hoá cho GitHub và V2EX.


