ai-goofish-monitor: Theo dõi Xianyu bằng AI, tự báo món hời — hướng dẫn cài đặt và dùng

Tóm tắt nhanh
ai-goofish-monitor là ứng dụng mã nguồn mở viết bằng Python, dùng Playwright và mô hình AI để theo dõi sản phẩm trên chợ đồ cũ Xianyu (Goofish) và báo cho bạn khi có món phù hợp. Có giao diện web để tạo tác vụ, quản lý tài khoản, xem kết quả và log. Cách cài bằng Docker khá gọn, nhưng bạn cần một API key của mô hình AI hỗ trợ ảnh và tài khoản Xianyu.
ai-goofish-monitor là một hệ thống theo dõi chợ đồ cũ Xianyu (còn gọi là Goofish) chạy trên máy của bạn. Nó dùng Playwright để mở trang, tìm sản phẩm theo từ khoá, rồi nhờ mô hình AI đọc cả mô tả lẫn hình ảnh để chấm xem món nào đáng mua. Tất cả được điều khiển qua một giao diện web có sẵn.
Nếu bạn hay phải ngồi lướt Xianyu để săn đồ cũ giá tốt, repo này làm thay phần việc lặp lại đó. Bạn mô tả món mình cần bằng ngôn ngữ tự nhiên, đặt khoảng giá, chọn lịch chạy. Khi AI thấy món đáng xem, hệ thống gửi thông báo qua kênh bạn chọn. Người dùng phù hợp là người săn đồ cũ, người bán lại cần canh giá, và lập trình viên muốn một ví dụ hoàn chỉnh về crawler kết hợp AI.
Điểm đáng giá nhất là bạn không phải tự viết tiêu chí lọc. Ở chế độ AI, bạn chỉ điền yêu cầu chi tiết, hệ thống tự sinh tiêu chí phân tích. Repo hiện có khoảng 19.789 sao và 3.208 fork, dùng giấy phép MIT, và vẫn được cập nhật trong 3 tháng gần đây.
Usagi-org/ai-goofish-monitor
Hệ thống theo dõi chợ đồ cũ Xianyu (Goofish) bằng Playwright và AI, có giao diện web quản lý nhiều tác vụ, lịch chạy và thông báo khi có món phù hợp.
I.ai-goofish-monitor làm được gì
Quản lý bằng giao diện web. Bạn tạo tác vụ, quản lý tài khoản, sửa tiêu chí AI, xem log chạy và duyệt kết quả ngay trong trình duyệt. Người không quen dòng lệnh vẫn dùng được sau khi cài xong.
Tạo tác vụ bằng ngôn ngữ tự nhiên. Bạn viết “tôi cần gì” bằng câu bình thường, mô hình đa phương thức (đọc được ảnh) sẽ phân tích từng sản phẩm. Lợi ích thực tế: món có ảnh xấu hay mô tả mập mờ có thể bị loại mà bạn không phải mở từng tin.
Chạy nhiều tác vụ cùng lúc. Mỗi tác vụ có từ khoá, khoảng giá, bộ lọc và prompt AI riêng. Bạn có thể canh một món đồ công nghệ và một món đồ gia dụng song song, mỗi món một tiêu chí.
Lọc nâng cao. Có lọc miễn phí vận chuyển, lọc theo thời gian đăng mới, và lọc khu vực ba cấp tỉnh / thành / quận. README khuyên để trống khu vực khi mới thử, vì lọc khu vực làm kết quả ít đi rất nhiều.
Hai chế độ quyết định. “AI判断” (AI quyết định) dùng yêu cầu chi tiết để sinh tiêu chí. “关键词判断” (theo từ khoá) chỉ áp quy tắc từ khoá, tạo tác vụ ngay và không qua AI.
Thông báo đa kênh. Hỗ trợ ntfy.sh, WeCom (企业微信), Bark, Telegram, Gotify và Webhook. Bạn không cần ngồi canh trang web, điện thoại sẽ báo khi có món phù hợp.
Lên lịch bằng Cron. Tác vụ có thể chạy định kỳ thay vì bấm tay.
Xoay tài khoản và proxy. Có thể quản lý nhiều tài khoản Xianyu, gán tài khoản cho từng tác vụ, dùng proxy pool với cơ chế thử lại khi lỗi. Khi gặp kiểm soát rủi ro hoặc lỗi, hệ thống đổi tài khoản / proxy rồi chạy lại.
Lưu kết quả vào SQLite. Tác vụ, kết quả và lịch sử giá nằm trong một file cơ sở dữ liệu, mặc định là data/app.sqlite3. Dữ liệu ở máy bạn, dễ sao lưu.
II.Cần chuẩn bị gì
Theo README, bạn cần những thứ sau.
- Một tài khoản Xianyu. Hệ thống dùng “登录态” (trạng thái đăng nhập) của tài khoản này để truy cập. README hướng dẫn xuất trạng thái đó bằng một Chrome extension tên “Xianyu login state extractor” trên Chrome Web Store.
- API key của mô hình AI. Ba biến bắt buộc là
OPENAI_API_KEY,OPENAI_BASE_URL(địa chỉ API tương thích OpenAI) vàOPENAI_MODEL_NAME. README nhấn mạnh mô hình phải hỗ trợ đầu vào là ảnh. - Docker nếu chọn cách cài khuyến nghị. Ảnh Docker đã có sẵn Chromium nên không cần cài thêm trình duyệt.
- Nếu chạy trực tiếp bằng mã nguồn: Python 3.10 trở lên, Node.js kèm npm (README ghi đã thử với Node v20.18.3), Playwright CLI cùng Chromium, và trình duyệt Chrome hoặc Edge (Linux có thể dùng Chromium).
README chưa ghi yêu cầu RAM hay GPU. Phần AI chạy qua API bạn khai báo, nên về lý thuyết máy bạn không phải chạy mô hình. Đây là suy luận của mình, README không nói rõ.
API key và file đăng nhập Xianyu là thông tin nhạy cảm. Không đăng file .env hay file trong thư mục state/ lên mạng. Gọi API AI có thể tính phí theo lượng dùng, nên hãy theo dõi chi phí khi tạo nhiều tác vụ chạy dày.
III.Cài đặt từng bước
README khuyến nghị Docker. Mình đi theo hướng đó, còn cách chạy từ mã nguồn để ở cuối.
- Tải mã nguồnClone repo và vào thư mục dự án
- Tạo file .envSao chép .env.example rồi điền API key
- Khởi động DockerChạy docker compose up -d
- Đăng nhập giao diện webMở http://127.0.0.1:8000
- Nhập trạng thái đăng nhập XianyuDán JSON xuất từ Chrome extension
A.Tải mã nguồn
Mở terminal (PowerShell trên Windows, Terminal trên macOS / Linux) ở thư mục bạn muốn lưu dự án. Lệnh này tải repo về và vào thư mục của nó.
git clone https://github.com/Usagi-org/ai-goofish-monitor && cd ai-goofish-monitorNgười mới hay vấp ở chỗ chạy các lệnh sau khi chưa cd vào đúng thư mục. Nếu terminal báo không thấy file, hãy kiểm tra bạn đang đứng trong ai-goofish-monitor.
B.Tạo file .env và điền cấu hình
File .env.example là bản mẫu. Bạn sao chép nó thành .env rồi sửa.
cp .env.example .env
vim .envREADME dùng vim để sửa. Nếu bạn không quen vim, mở file .env bằng bất kỳ trình soạn thảo nào (ví dụ notepad .env trên Windows). Điền tối thiểu ba biến sau:
OPENAI_API_KEY: API key của mô hình AI.OPENAI_BASE_URL: địa chỉ API tương thích OpenAI.OPENAI_MODEL_NAME: tên mô hình hỗ trợ ảnh.
Hai biến WEB_USERNAME và WEB_PASSWORD là tuỳ chọn. Nếu bỏ trống, tài khoản mặc định là admin/admin123. README dặn môi trường thật phải đổi mật khẩu này.
C.Khởi động bằng Docker
Lệnh dưới đây chạy ứng dụng nền. Ngay sau đó là lệnh xem log trực tiếp và lệnh dừng, đúng như README.
docker compose up -d
docker compose logs -f app
docker compose downBạn không cần chạy cả ba cùng lúc. up -d để bật, logs -f app để xem log (thoát bằng Ctrl+C), down để tắt hẳn khi không dùng nữa.
Nếu tải ảnh Docker chậm hoặc không truy cập được, README đề xuất tải qua một địa chỉ mirror rồi gắn lại tên:
docker pull ghcr.nju.edu.cn/usagi-org/ai-goofish:latest
docker tag ghcr.nju.edu.cn/usagi-org/ai-goofish:latest ghcr.io/usagi-org/ai-goofish:latest
docker compose up -dĐể cập nhật lên bản mới sau này:
docker compose pull && docker compose up -dNếu bạn đổi SERVER_PORT trong .env, nhớ sửa luôn phần ánh xạ cổng trong docker-compose.yaml, nếu không bạn sẽ không vào được giao diện.
D.Đăng nhập giao diện web và nhập trạng thái Xianyu
Mở trình duyệt vào http://127.0.0.1:8000 rồi đăng nhập bằng tài khoản web. Sau đó theo README:
- Vào mục “闲鱼账号管理” (quản lý tài khoản Xianyu).
- Dùng Chrome extension để xuất trạng thái đăng nhập dạng JSON, rồi dán vào đây.
- File đăng nhập được lưu trong thư mục
state/, ví dụstate/acc_1.json. - Quay lại “任务管理” (quản lý tác vụ), tạo tác vụ và gán tài khoản là chạy được.
Giao diện hiển thị tên mục bằng tiếng Trung theo README. Nếu chưa quen, bạn có thể dùng trình duyệt có tính năng dịch trang.
Trong repo còn có file xianyu-login-state-privacy.html nói về quyền riêng tư của trạng thái đăng nhập. Mình chưa có nội dung chi tiết của file này, bạn nên đọc trước khi dán JSON.
E.Cách khác: chạy từ mã nguồn
Cách này dành cho người muốn sửa code. Sau khi cài đủ Python, Node.js và trình duyệt, chạy:
git clone https://github.com/Usagi-org/ai-goofish-monitor
cd ai-goofish-monitor
cp .env.example .envREADME khuyên cài Playwright và Chromium trước lần chạy đầu:
python3 -m pip install playwright && python3 -m playwright install chromiumSau đó dùng script khởi động một lệnh. Script sẽ kiểm tra Playwright và trình duyệt, cài phụ thuộc, build giao diện rồi bật backend.
chmod +x start.sh
./start.shScript này là file shell, nên trên Windows bạn cần môi trường chạy được .sh (ví dụ Git Bash). README không nói rõ về Windows nên mình khuyên dùng Docker cho đơn giản.
Muốn chạy tay từng phần, README ghi:
# 后端
python -m src.app
# 或
uvicorn src.app:app --host 0.0.0.0 --port 8000 --reload
# 前端
cd web-ui
npm install
npm run devIV.Kiểm tra đã chạy được chưa
Cách kiểm tra nhanh nhất là xem ba dấu hiệu sau.
- Lệnh
docker compose logs -f appin log chạy bình thường, không dừng với lỗi. - Mở
http://127.0.0.1:8000thấy trang đăng nhập, đăng nhập được bằng tài khoản bạn đặt (hoặcadmin/admin123). - Khi chạy bằng
./start.sh, script in địa chỉ truy cậphttp://localhost:8000và trang tài liệu APIhttp://localhost:8000/docs.
Bước kiểm tra thật sự là tạo một tác vụ thử. Sau khi nhập trạng thái đăng nhập, tạo tác vụ với từ khoá đơn giản, gán tài khoản và chạy. Vào trang log của tác vụ, nếu thấy tiến trình tìm kiếm và phân tích chạy, bạn đã cài thành công. Trang kết quả sẽ hiện các sản phẩm đã lưu.
V.Dùng vào việc thật
Các tình huống dưới đây bám đúng khả năng README mô tả. Ví dụ prompt là mình tự soạn để minh hoạ.
A.Người săn đồ công nghệ cũ canh món giá tốt
Bạn muốn mua một chiếc máy ảnh cũ trên Xianyu nhưng không có thời gian lướt hằng ngày. Vào “任务管理”, tạo tác vụ ở chế độ “AI判断”, điền từ khoá, khoảng giá và phần “详细需求” (yêu cầu chi tiết). Ví dụ:
Tôi cần máy ảnh cũ còn hoạt động tốt, ảnh chụp rõ nét, không trầy xước nặng, người bán có đánh giá tốt. Loại bỏ tin chỉ bán linh kiện hoặc mô tả quá mơ hồ.Sau khi bạn gửi, hệ thống mở cửa sổ tiến trình và sinh tiêu chí phân tích ở nền. Tạo tác vụ AI không xong ngay lập tức, đó là chuyện bình thường. Kết quả: mỗi lần chạy, AI đọc ảnh và mô tả rồi chỉ đẩy ra những món đáng xem.
Việc lướt chợ đồ cũ tốn thời gian nhất là loại bỏ món dở, và đó đúng là việc AI làm thay bạn.
Ông T
B.Chủ shop theo dõi giá để nhập hàng
Bạn bán lại đồ cũ và muốn biết món nào xuất hiện với giá thấp hơn mặt bằng. Tạo nhiều tác vụ, mỗi tác vụ một nhóm hàng, mỗi tác vụ khoảng giá riêng. Bật bộ lọc “包邮” (miễn phí vận chuyển) và lọc đăng mới để chỉ thấy tin vừa lên. Đặt lịch Cron để tác vụ tự chạy định kỳ. Kết quả và lịch sử giá được lưu trong SQLite, bạn mở trang kết quả hoặc dùng chức năng xuất để đối chiếu.
C.Nhân viên văn phòng nhận thông báo trên điện thoại
Bạn không muốn mở máy tính mỗi giờ. Trong .env, điền cấu hình một kênh thông báo, ví dụ Telegram:
TELEGRAM_BOT_TOKEN=...
TELEGRAM_CHAT_ID=...Đây là tên biến có trong .env.example, bạn tự thay giá trị bằng token và chat ID của mình. Khi AI đánh giá một món là đáng mua, tin nhắn được gửi tới điện thoại. Nếu thích đơn giản hơn, README liệt kê thêm ntfy.sh, Bark, Gotify, WeCom và Webhook.
D.Lập trình viên tích hợp qua API
Nếu bạn muốn tự động hoá việc tạo tác vụ, repo có API. Endpoint POST /api/tasks/generate nhận chế độ ai (trả về mã 202 và một job để bạn tiếp tục hỏi tiến độ) hoặc chế độ keyword (tạo tác vụ ngay). Tiến độ AI xem ở GET /api/tasks/generate-jobs/{job_id}. Tài liệu API tự sinh ở /docs khi chạy local. Đây là cách ghép việc theo dõi Xianyu vào hệ thống của bạn.
VI.Lỗi hay gặp và cách xử lý
Trang báo thiếu bản build giao diện (thư mục dist/ không có). Xảy ra khi chạy local mà chưa build front-end. Chạy ./start.sh, hoặc vào web-ui/ chạy npm run build rồi đảm bảo kết quả được copy ra thư mục dist/ ở gốc repo.
./start.sh báo thiếu Playwright hoặc trình duyệt. Đây là bước kiểm tra điều kiện của script. Cài Playwright CLI và Chromium theo lệnh ở phần cài đặt, bảo đảm máy có Chrome hoặc Edge, rồi chạy lại.
Không vào được giao diện sau khi đổi cổng. Nếu bạn sửa SERVER_PORT trong .env, phải sửa cổng tương ứng trong docker-compose.yaml. Sau đó chạy lại docker compose up -d.
Tác vụ chạy lỗi hoặc không ra kết quả. README cho biết trang log dùng để điều tra các vấn đề như trạng thái đăng nhập hết hạn, bị kiểm soát rủi ro và lỗi gọi AI. Hãy mở log của tác vụ, nếu nghi đăng nhập hết hạn thì xuất lại JSON bằng extension và cập nhật tài khoản. Nếu bị kiểm soát rủi ro, giảm tần suất chạy, và README có nói đến tài khoản / proxy xoay vòng để xử lý.
Phần AI không hoạt động. Kiểm tra lại ba biến OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL_NAME, và chắc chắn mô hình bạn chọn hỗ trợ ảnh. Nếu cần đi qua proxy riêng cho AI, README có biến PROXY_URL.
Tải ảnh Docker quá chậm. Dùng cách mirror trong README (lệnh docker pull ghcr.nju.edu.cn/... rồi docker tag) như phần cài đặt đã ghi.
VII.Có nên dùng không
Điểm mạnh. Giao diện web đầy đủ, cài bằng Docker khá nhanh, hỗ trợ nhiều tác vụ, lịch chạy, nhiều kênh thông báo và nhiều tài khoản. Dữ liệu lưu cục bộ trong SQLite. Giấy phép MIT, mã nguồn mở, cộng đồng lớn.
Giới hạn. Công cụ chỉ phục vụ Xianyu, và giao diện lẫn tài liệu chủ yếu bằng tiếng Trung. Bạn cần tài khoản Xianyu, và cần dán trạng thái đăng nhập của chính mình vào hệ thống. Phần AI cần API có hỗ trợ ảnh, có thể phát sinh chi phí. README cũng nhắc việc truy cập quá dày có thể khiến tài khoản bị hạn chế.
Lưu ý pháp lý. Tác giả ghi rõ dự án chỉ dùng để học tập và nghiên cứu kỹ thuật, nên tuân thủ điều khoản người dùng và robots.txt của Xianyu, không gửi yêu cầu quá thường xuyên. Phần miễn trừ trách nhiệm nằm trong file DISCLAIMER.md của repo.
Khi nào nên chọn cách khác. Nếu bạn chỉ mua đồ thỉnh thoảng, việc tự tìm trên ứng dụng sẽ đỡ rắc rối hơn. Nếu bạn cần theo dõi chợ khác ngoài Xianyu, repo này không phù hợp. Nếu bạn không muốn gọi API AI bên ngoài, README chưa nói rõ cách chạy hoàn toàn offline.
Câu hỏi thường gặp
ai-goofish-monitor có miễn phí không?
Repo là mã nguồn mở, giấy phép MIT, dùng miễn phí. Tuy nhiên phần AI cần API key và địa chỉ API do bạn tự khai báo, README không nói chi phí, nên mức phí phụ thuộc nhà cung cấp mô hình bạn chọn.
Cài trên Windows được không?
Cách cài khuyến nghị trong README là Docker, và ảnh Docker đã có sẵn Chromium. README không có phần riêng cho Windows, nên mình khuyên bạn dùng Docker. Script ./start.sh là file shell nên cần môi trường chạy được .sh.
Có cần GPU không?
README không yêu cầu GPU. Việc phân tích do mô hình AI qua API đảm nhận, nên máy bạn chủ yếu chạy trình duyệt tự động và giao diện web. Yêu cầu cấu hình phần cứng cụ thể thì README chưa có thông tin.
Cần chuẩn bị những gì trước khi dùng?
Bạn cần tài khoản Xianyu (để xuất trạng thái đăng nhập bằng Chrome extension), cùng API key, địa chỉ API và tên mô hình hỗ trợ đầu vào là ảnh. Nếu dùng Docker thì cần cài Docker.
Dữ liệu của tôi lưu ở đâu, có an toàn không?
Theo README, tác vụ, kết quả và lịch sử giá nằm trong SQLite (mặc định data/app.sqlite3), file đăng nhập nằm trong thư mục state/, đều trên máy bạn. Dữ liệu gửi cho AI đi theo API bạn khai báo. Repo có file xianyu-login-state-privacy.html nói về quyền riêng tư đăng nhập, bạn nên đọc kỹ.
Mật khẩu web mặc định là gì và có cần đổi không?
Mặc định là admin/admin123 nếu bạn không đặt WEB_USERNAME và WEB_PASSWORD. README dặn môi trường thực tế phải đổi mật khẩu này.
Dùng công cụ này có bị khoá tài khoản Xianyu không?
README cảnh báo rằng gửi yêu cầu quá thường xuyên có thể khiến tài khoản bị hạn chế, và dặn tuân thủ điều khoản của Xianyu. Repo có cơ chế xoay tài khoản và proxy khi gặp kiểm soát rủi ro, nhưng không cam kết tránh được việc bị hạn chế.


