Bỏ qua tới nội dung
Ông T.vn

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

11 phút đọcCập nhật

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 →

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

Tóm tắt nhanh

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.

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.

CLI

Panniantong/Agent-Reach

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.

★ 111kPythonMIT
Xem repo trên GitHub
Video giới thiệu Agent-ReachXem trên YouTubeXem trên Facebook

I.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

II.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.

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.

III.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.

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

A.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ì.

B.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:

Code
帮我安装 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.

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.

C.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.

D.Đ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:

Terminal
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ễ.

IV.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:

Terminal
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:

Terminal
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.

V.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.

A.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:

Code
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.

B.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à:

Terminal
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

C.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 đó:

Code
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.

D.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ã.

VI.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.

VII.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ử.

4.4/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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.

Chuyển nhanh tới mục

  1. I.Agent Reach làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Mở agent và kiểm tra quyền chạy lệnh
    2. B.Gửi câu cài đặt cho agent
    3. C.Trả lời các câu agent hỏi trong lúc cài
    4. D.Điền key (chỉ khi cần chuyển giọng nói thành chữ)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev đọc nhanh issue và README của repo lạ
    2. B.Nhân viên văn phòng đọc bài trên diễn đàn và trang nước ngoài
    3. C.Chủ shop nghiên cứu xu hướng trên Xiaohongshu
    4. D.Người làm nội dung lấy chữ từ video
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.