ai-goofish-monitor: AI canh giá và lọc hàng trên Xianyu — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về Usagi-org/ai-goofish-monitor — 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: 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 đồ cũ Xianyu (Goofish) theo từ khoá, giá, khu vực rồi báo cho bạn món đáng mua. Có giao diện web để quản lý tác vụ, tài khoản và log. Cài bằng Docker khá gọn, nhưng bạn cần API key của một mô hình AI hỗ trợ ảnh và phải nạp trạng thái đăng nhập Xianyu.
ai-goofish-monitor là một hệ thống giám sát sàn đồ cũ Xianyu (闲鱼, còn gọi là Goofish) chạy tự động, dùng Playwright để lấy dữ liệu và mô hình AI để đánh giá từng món hàng. Nó đi kèm một giao diện web đầy đủ: bạn tạo tác vụ, chọn tài khoản, xem kết quả và xem log ngay trên trình duyệt.
Vấn đề nó giải quyết rất đời thường: Xianyu có hàng triệu tin đăng, bạn không thể ngồi lướt cả ngày để tìm đúng món giá tốt. Repo này canh giúp bạn. Cứ vài phút (hoặc theo lịch Cron) nó tìm lại từ khoá, phát hiện tin mới, tải chi tiết và ảnh, nhờ AI chấm xem món đó có hợp yêu cầu của bạn không, rồi gửi thông báo nếu có.
Ai nên dùng? Người săn đồ cũ cho bản thân, người mua hàng về bán lại, hoặc lập trình viên mới muốn xem một dự án Python thực tế có AI, trình duyệt tự động, giao diện web và Docker. Hiện repo có khoảng 19.800 sao và 3.200 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây. Điểm đáng giá nhất là bạn mô tả nhu cầu bằng ngôn ngữ tự nhiên, hệ thống tự sinh tiêu chí phân tích cho AI.
Usagi-org/ai-goofish-monitor
Hệ thống giám sát Xianyu (Goofish) bằng Playwright và AI: chạy nhiều tác vụ, lọc giá/khu vực, AI chấm hàng, báo qua Telegram, Bark... có giao diện web.
I.ai-goofish-monitor làm được gì
Dưới đây là các tính năng chính, kèm lợi ích thực tế.
A.Quản lý bằng giao diện web
Bạn không phải sửa file cấu hình bằng tay. Giao diện có các mục: quản lý tác vụ, quản lý tài khoản, chỉnh tiêu chuẩn AI, log chạy và duyệt kết quả. Người không rành code vẫn dùng được sau khi cài xong.
B.Tạo tác vụ bằng ngôn ngữ tự nhiên
Tác vụ có hai kiểu. Kiểu "AI判断" (AI phán đoán): bạn điền phần "详细需求" (yêu cầu chi tiết), hệ thống chạy nền để sinh tiêu chí phân tích và hiện một cửa sổ tiến độ riêng. Kiểu "关键词判断" (phán đoán theo từ khoá): bạn điền luật từ khoá, tác vụ tạo ngay và không qua AI. Cần tiết kiệm chi phí thì chọn kiểu từ khoá.
C.Nhiều tác vụ chạy song song
Mỗi tác vụ có từ khoá, mức giá, bộ lọc và prompt AI riêng. Bạn có thể canh máy ảnh cũ ở tác vụ này, laptop ở tác vụ khác, không lẫn vào nhau.
D.Lọc nâng cao
Có lọc miễn phí vận chuyển, khoảng thời gian đăng mới, và chọn khu vực ba cấp tỉnh / thành / quận. README lưu ý lọc khu vực làm kết quả giảm mạnh, nên mặc định để trống; nếu bạn chỉ muốn tìm hiểu mặt bằng giá chung thì đừng điền vội.
E.Thông báo nhiều kênh
Hỗ trợ ntfy.sh, WeCom (bot doanh nghiệp), Bark, Telegram, Gotify và Webhook. Trong file .env.example còn có cả PushPlus. Món nào AI cho là đáng mua sẽ được đẩy về điện thoại của bạn.
F.Định lịch và xoay vòng tài khoản, proxy
Bạn có thể đặt lịch Cron cho tác vụ định kỳ. Hệ thống cũng quản lý nhiều tài khoản, gán tài khoản cho từng tác vụ, có nhóm proxy xoay vòng và thử lại khi lỗi. Khi gặp kiểm soát rủi ro (risk control), nó đổi tài khoản hoặc proxy rồi chạy lại.
G.Lưu dữ liệu bằng SQLite
Tác vụ, kết quả và lịch sử giá nằm trong SQLite (mặc định data/app.sqlite3). Lần chạy đầu, hệ thống tự tạo bảng và thử nhập dữ liệu cũ từ config.json, jsonl/, price_history/ nếu có.
II.Cần chuẩn bị gì
Theo tư liệu, bạn cần:
- Docker (cách README khuyên dùng): cần Docker và Docker Compose. Ảnh Docker đã có sẵn Chromium nên không phải cài thêm trình duyệt trên máy.
- Nếu chạy trực tiếp không Docker: Python 3.10 trở lên; Node.js và npm (tác giả đã thử với Node v20.18.3 để build giao diện); Playwright CLI cùng Chromium; trình duyệt Chrome hoặc Edge (trên Linux dùng Chromium cũng được). Script
start.shlà script shell nên hợp với Linux/macOS hoặc Git Bash; README không nói rõ về Windows thuần. - API key của mô hình AI: bắt buộc có ba thứ là
OPENAI_API_KEY,OPENAI_BASE_URL(địa chỉ API tương thích OpenAI) vàOPENAI_MODEL_NAME. README nhấn mạnh tên mô hình phải hỗ trợ nhập ảnh. - Tài khoản Xianyu: bạn cần đăng nhập Xianyu và xuất trạng thái đăng nhập bằng một tiện ích Chrome (xem phần cài đặt).
- Tài khoản đăng nhập giao diện web: mặc định là
admin/admin123, có thể đổi bằngWEB_USERNAMEvàWEB_PASSWORD.
Phần cứng: tư liệu không nói gì về GPU hay cấu hình tối thiểu. Mô hình AI được gọi qua API nên bạn không cần tự chạy mô hình trên máy.
API key AI và trạng thái đăng nhập Xianyu đều là thông tin nhạy cảm. Đừng đăng file .env hay thư mục state/ lên mạng, đừng gửi cho người khác. Mỗi lần AI phân tích ảnh và mô tả đều có thể tốn phí theo bảng giá của nhà cung cấp mô hình, hãy kiểm tra trước khi đặt nhiều tác vụ chạy dày.
III.Cài đặt từng bước
Cách đơn giản nhất là Docker. Tóm tắt:
- Tải mã nguồnClone repo về máy và vào thư mục dự án
- Tạo file cấu hìnhSao chép .env.example thành .env rồi điền API key AI
- Khởi độngChạy docker compose up -d
- Mở giao diện webVào http://127.0.0.1:8000 và đăng nhập
- Nạp đăng nhập XianyuDán JSON đăng nhập vào mục quản lý tài khoản
A.Tải mã nguồn và tạo file .env
Mở terminal (PowerShell, Terminal macOS hoặc terminal Linux) ở thư mục bạn muốn đặt dự án, rồi chạy lệnh trong README:
git clone https://github.com/Usagi-org/ai-goofish-monitor && cd ai-goofish-monitor
cp .env.example .envLệnh đầu tải repo và đi vào thư mục. Lệnh thứ hai tạo file .env từ mẫu. Nếu dùng PowerShell trên Windows, cp cũng chạy được vì là bí danh của lệnh copy.
B.Điền cấu hình
README dùng vim .env để sửa. Nếu bạn không quen vim, cứ mở file .env bằng bất kỳ trình soạn thảo văn bản nào (Notepad, VS Code...). Phần tối thiểu cần điền:
vim .env # 填写相关配置项Ba biến bắt buộc: OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL_NAME. Hai biến WEB_USERNAME và WEB_PASSWORD không bắt buộc nhưng bạn nên đổi, vì mật khẩu mặc định admin123 ai cũng biết. Chỗ người mới hay vấp: giá trị phải điền sau dấu = trong từng dòng, không thêm khoảng trắng thừa.
C.Chạy bằng Docker Compose
docker compose up -d
docker compose logs -f app
docker compose downup -d khởi động ứng dụng ở nền. logs -f app xem log trực tiếp (nhấn Ctrl+C để thoát xem log, ứng dụng vẫn chạy). down dùng khi bạn muốn dừng hẳn. Nếu tải ảnh chậm hoặc không tải được, README gợi ý dùng bản mirror:
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 bản mới sau này: docker compose pull && docker compose up -d. Nếu bạn đổi SERVER_PORT trong .env, nhớ sửa luôn phần ánh xạ cổng trong docker-compose.yaml.
D.Nạp đăng nhập Xianyu
Mở http://127.0.0.1:8000, đăng nhập giao diện. Vào mục "闲鱼账号管理" (quản lý tài khoản Xianyu), dùng tiện ích Chrome tên "Xianyu Login State Extractor" (README có đường dẫn tới Chrome Web Store, bạn xem ngay trong README của repo) để xuất JSON đăng nhập, rồi dán vào. File sẽ được lưu trong thư mục state/, ví dụ state/acc_1.json. Cuối cùng quay lại "任务管理" (quản lý tác vụ), tạo tác vụ, gán tài khoản và chạy.
E.Cách khác: chạy trực tiếp trên máy
Nếu bạn không dùng Docker, README có hai cách. Trước hết, cài Playwright và Chromium:
python3 -m pip install playwright && python3 -m playwright install chromiumRồi tải mã và tạo .env như trên, sau đó chạy script một lần:
chmod +x start.sh
./start.shScript này kiểm tra Playwright và trình duyệt, cài thư viện, build giao diện, chép bản build và khởi động backend. Cách thủ công dành cho dev:
# 后端
python -m src.app
# 或
uvicorn src.app:app --host 0.0.0.0 --port 8000 --reload
# 前端
cd web-ui
npm install
npm run devKhi chạy bằng ./start.sh, địa chỉ web là http://localhost:8000, tài liệu API ở http://localhost:8000/docs.
IV.Kiểm tra đã chạy được chưa
Dấu hiệu thành công theo tư liệu:
- 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/admin123nếu chưa đổi). - Với Docker, lệnh
docker compose logs -f appkhông báo lỗi khởi động, ứng dụng tự tạo cơ sở dữ liệudata/app.sqlite3. - Sau khi dán JSON đăng nhập, trong thư mục
state/có file nhưacc_1.json. - Tạo một tác vụ thử với từ khoá rõ ràng, chạy rồi mở trang log: bạn thấy tiến trình tìm kiếm. Nếu có món được AI đề xuất, kết quả xuất hiện ở trang kết quả và (nếu đã cấu hình) thông báo được gửi đi.
Bạn cũng nên mở /docs khi chạy bằng start.sh để chắc chắn backend đang sống.
V.Dùng vào việc thật
Giao diện hiện chủ yếu bằng tiếng Trung, nên bạn có thể bật dịch trang của trình duyệt cho dễ thao tác.
A.Săn máy ảnh cũ giá hời
Bạn là nhân viên văn phòng muốn mua một chiếc máy ảnh cũ. Tạo tác vụ kiểu "AI判断", điền từ khoá, khoảng giá và ở phần yêu cầu chi tiết, bạn viết gần như nói chuyện. Ví dụ prompt mẫu:
Tôi muốn mua máy ảnh mirrorless cũ, còn hoạt động tốt, không móp méo nặng, có đủ pin và sạc. Ưu tiên người bán có lịch sử tốt. Loại bỏ tin ghi "bán xác" hoặc "hỏng".Hệ thống sinh tiêu chí phân tích ở chế độ nền. Từ đó mỗi tin mới được AI xem cả ảnh lẫn mô tả để chấm. Kết quả: bạn chỉ nhận những tin AI thấy hợp, thay vì phải đọc hết.
Đừng tự lướt cả ngàn tin, hãy để máy đọc và chỉ gọi bạn khi có món đáng xem.
Ông T
B.Chủ shop canh hàng để bán lại
Bạn bán đồ công nghệ và muốn biết khi nào có món giá thấp. Tạo mỗi sản phẩm một tác vụ riêng, mỗi cái có khoảng giá và prompt riêng, bật lọc "包邮" (miễn phí vận chuyển) nếu cần. Cấu hình TELEGRAM_BOT_TOKEN và TELEGRAM_CHAT_ID trong .env để nhận thông báo về điện thoại. Đặt lịch Cron cho tác vụ chạy định kỳ. Kết quả: có tin hời là bạn nhận ngay thông báo, còn lịch sử giá được lưu trong SQLite để so sánh.
C.Tiết kiệm chi phí với luật từ khoá
Bạn chỉ cần lọc đơn giản, ví dụ chỉ lấy tin có đúng mẫu mã và nằm trong tầm giá. Chọn kiểu "关键词判断", điền luật từ khoá. README nói tác vụ kiểu này tạo ngay, không qua bước AI sinh tiêu chí. Kết quả: nhanh và bớt phụ thuộc vào API, hợp khi bạn chưa muốn trả phí nhiều.
D.Dev tích hợp qua API
Nếu bạn là lập trình viên muốn tạo tác vụ bằng mã, README liệt kê các điểm vào: POST /api/tasks/generate. Với decision_mode=ai nó trả mã 202 kèm job và bạn phải hỏi tiến độ tại GET /api/tasks/generate-jobs/{job_id}. Với decision_mode=keyword nó trả về tác vụ đã tạo luôn. Chi tiết các trường dữ liệu gửi lên, bạn xem tài liệu /docs khi ứng dụng đang chạy.
VI.Lỗi hay gặp và cách xử lý
A.Trang web báo thiếu bản build giao diện
Khi chạy local, nếu trang báo không có sản phẩm build của front-end, nghĩa là thư mục dist/ ở gốc repo bị thiếu. Chạy ./start.sh, hoặc vào web-ui/ chạy npm run build rồi chắc chắn bản build đã được chép vào dist/ ở gốc repo.
B.start.sh báo thiếu Playwright hoặc trình duyệt
Đó là bước kiểm tra tiền đề của script. Cài Playwright CLI và Chromium bằng lệnh python3 -m pip install playwright && python3 -m playwright install chromium, đảm bảo máy có Chrome hoặc Edge (Linux có thể dùng Chromium), rồi chạy lại ./start.sh. Dùng Docker sẽ tránh được lỗi này vì ảnh đã có Chromium.
C.Đăng nhập hết hạn hoặc bị kiểm soát rủi ro
Tác vụ không ra kết quả hoặc dừng giữa chừng? Mở trang log của tác vụ, README nói trang này giúp bạn tìm nguyên nhân như trạng thái đăng nhập hết hạn, bị kiểm soát rủi ro hoặc lỗi gọi AI. Thử xuất lại JSON đăng nhập bằng tiện ích Chrome và cập nhật trong mục quản lý tài khoản. Đừng tăng tần suất chạy, vì README khuyên không gửi yêu cầu quá dày để tránh bị hạn chế tài khoản.
D.AI không phân tích được hoặc báo lỗi API
Kiểm tra ba biến OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL_NAME đã đúng chưa, và tên mô hình có hỗ trợ ảnh đầu vào không. Nếu cần đi qua proxy chỉ cho AI, dùng PROXY_URL. Sửa .env xong, chạy lại docker compose up -d để áp dụng.
E.Không vào được trang sau khi đổi cổng
Bạn đổi SERVER_PORT trong .env nhưng quên sửa cổng ánh xạ trong docker-compose.yaml. README yêu cầu hai nơi phải khớp nhau. Sửa lại cho khớp rồi chạy lại Compose.
VII.Có nên dùng không
Điểm mạnh: giao diện web đủ chức năng, tạo tác vụ bằng ngôn ngữ tự nhiên, chạy nhiều tác vụ, nhiều kênh thông báo, có lịch Cron, xoay vòng tài khoản và proxy, cài bằng Docker khá gọn, giấy phép MIT và cộng đồng đông.
Giới hạn: công cụ này làm việc với Xianyu, một sàn của Trung Quốc, nên bạn cần tài khoản Xianyu và giao diện chủ yếu bằng tiếng Trung. Bạn phải tự có API key của mô hình AI hỗ trợ ảnh, nên có thể phát sinh chi phí. Công cụ lấy dữ liệu bằng trình duyệt tự động nên có rủi ro bị kiểm soát hoặc hạn chế tài khoản; README cũng nói rõ dự án chỉ dành cho học tập và nghiên cứu kỹ thuật, bạn nên đọc file DISCLAIMER.md và tuân thủ điều khoản của Xianyu. Hãy dùng tài khoản phụ nếu bạn lo ngại.
Khi nào chọn cách khác: nếu bạn chỉ cần tìm một món rồi mua một lần, cứ dùng chức năng lưu tìm kiếm của chính sàn. Nếu bạn không muốn dính tới việc đăng nhập tự động hay trích xuất dữ liệu, repo này không hợp. Còn nếu bạn canh nhiều mặt hàng thường xuyên và muốn AI lọc hộ, nó là lựa chọn đáng thử.
Câu hỏi thường gặp
ai-goofish-monitor có miễn phí không?
Mã nguồn dùng giấy phép MIT nên bạn dùng miễn phí. Tuy nhiên bạn cần API key của một mô hình AI tương thích OpenAI và hỗ trợ ảnh, phần này có thể tốn phí theo nhà cung cấp. Tư liệu không nêu mức giá cụ thể.
Có cần GPU hoặc máy cấu hình mạnh không?
Tư liệu không nêu yêu cầu phần cứng. AI được gọi qua API (OPENAI_BASE_URL) nên bạn không cần tự chạy mô hình trên máy. Bản Docker đã có sẵn Chromium.
Chạy được trên Windows không?
Cách Docker Compose không phụ thuộc hệ điều hành miễn là máy có Docker. README không có hướng dẫn riêng cho Windows khi chạy trực tiếp; script start.sh là script shell nên bạn cần môi trường như Git Bash hoặc WSL. Phần này README chưa nói rõ.
Làm sao để công cụ truy cập được Xianyu?
Bạn đăng nhập Xianyu, dùng tiện ích Chrome để xuất JSON đăng nhập, rồi dán vào mục quản lý tài khoản trong giao diện web. File được lưu trong thư mục state/ trên máy bạn. Mỗi tác vụ có thể gán một tài khoản, hoặc để hệ thống tự chọn.
Dữ liệu của tôi lưu ở đâu, có an toàn không?
Tác vụ, kết quả và lịch sử giá lưu trong SQLite (mặc định data/app.sqlite3) trên máy bạn; log, trạng thái đăng nhập, prompt và ảnh nằm trong các thư mục riêng. Nội dung gửi tới AI đi qua dịch vụ mô hình mà bạn tự chọn. Tư liệu không có đánh giá bảo mật chi tiết, nên bạn hãy đổi mật khẩu web mặc định và giữ kín .env, state/.
Dùng công cụ này có bị khoá tài khoản Xianyu không?
README cảnh báo không nên gửi yêu cầu quá dày để tránh gây tải và để tránh tài khoản bị hạn chế, đồng thời yêu cầu tuân thủ điều khoản của Xianyu. Hệ thống có cơ chế xoay vòng tài khoản và proxy khi gặp kiểm soát rủi ro, nhưng không có gì bảo đảm tuyệt đối. Dự án nêu rõ chỉ phục vụ học tập và nghiên cứu.
Khác gì việc tự lướt Xianyu hoặc lưu tìm kiếm?
Công cụ này chạy nhiều tác vụ tự động, có lịch, để AI xem ảnh và mô tả rồi chỉ báo những món phù hợp qua Telegram, Bark và các kênh khác. Tư liệu không so sánh trực tiếp với tính năng gốc của sàn nên mình không đánh giá thêm.


