Sellbird: tự tìm khách, viết và gửi cold email bằng gói Claude/ChatGPT — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về ethanplusai/sellbird — 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: Sellbird: tự tìm khách, viết và gửi cold email bằng gói Claude — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Sellbird là nền tảng mã nguồn mở (Python) tự động hoá cả quy trình gửi cold email: tìm doanh nghiệp, tìm người quyết định, xác minh email, viết thư, gửi và xử lý thư trả lời. Nó chạy trên máy bạn và dùng gói Claude Pro/Max hoặc ChatGPT (Codex) sẵn có, không cần API key của mô hình. Cài không quá khó nếu bạn quen dòng lệnh, và mặc định không có email nào được gửi khi bạn chưa duyệt.
Sellbird là một nền tảng mã nguồn mở viết bằng Python, làm trọn quy trình gửi cold email cho bạn. Nó tìm các công ty đang cần thứ bạn bán, tìm người ra quyết định, kiểm tra địa chỉ email, viết thư riêng cho từng người, gửi đi và xử lý thư trả lời. Repo này trước đây tên Harvey, nay đã đổi tên thành Sellbird.
Người nên xem là chủ doanh nghiệp nhỏ, người làm bán hàng hoặc tiếp thị, và lập trình viên muốn có danh sách khách tiềm năng mà không phải trả tiền cho các công cụ prospecting đắt đỏ. Repo hiện có khoảng 5.250 sao và 1.127 fork, và vẫn được cập nhật trong vài tháng gần đây. Giấy phép là AGPL-3.0.
Điểm đáng giá nhất là hai thứ. Một là nó không cần API key của mô hình AI: Sellbird "suy nghĩ" qua Claude Code CLI trên gói Claude Pro hoặc Max của bạn, hoặc qua Codex trên gói ChatGPT. Hai là mặc định không có email nào được gửi đi nếu bạn chưa bấm duyệt. Bạn có thể xem video ngắn bên dưới để thấy nó chạy ra sao, rồi quay lại đây làm theo từng bước.
ethanplusai/sellbird
Sellbird tìm công ty và người quyết định, kiểm tra email, viết cold email cá nhân hoá, gửi đi và xử lý thư trả lời, chạy bằng gói Claude hoặc ChatGPT của bạn.
I.Sellbird làm được gì
Sellbird là một dây chuyền nhiều công đoạn. Bạn có thể chạy hết từ đầu đến cuối, hoặc dừng ở bất kỳ công đoạn nào.
- Tìm công ty. Nó tìm các doanh nghiệp giống khách hàng lý tưởng của bạn. Nguồn mặc định là OpenStreetMap, miễn phí. Bạn cũng có thể chọn nguồn trả phí, và mỗi lần tìm bằng nguồn trả phí đều hiện chi phí trước khi chạy. Nhờ vậy bạn không bị trừ tiền bất ngờ.
- Tìm lý do họ sẽ mua. Nó đọc website của từng công ty để tìm các tín hiệu mua hàng mà bạn đã xác nhận, ví dụ chưa có đặt lịch online, đang chạy quảng cáo hoặc đang tuyển một vị trí nào đó. Bước này không gọi mô hình, không tốn phí. Mỗi công ty chỉ cần ba yêu cầu HTTP.
- Tìm người quyết định. Nó tìm chủ hoặc quản lý được nêu tên trên chính các trang của công ty đó, tối đa hai người mỗi công ty.
- Kiểm tra địa chỉ email. Nó học quy luật đặt email của công ty rồi xác minh một địa chỉ. Mỗi địa chỉ được gắn nhãn: verified, risky, guess hoặc invalid. Chỉ địa chỉ gửi được mới có thư gửi tới, nên bạn đỡ bị trả thư lỗi hàng loạt.
- Viết và gửi. Nó viết một chuỗi email ngắn cho từng người dựa trên những gì tìm được. Sau đó gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn số thư mỗi ngày và theo giờ làm việc của người nhận.
- Xử lý thư trả lời. Nó đọc từng thư trả lời và soạn sẵn câu trả lời. Thư tự động trả lời được xếp riêng. Yêu cầu ngừng nhận thư được tôn trọng ngay. Những thư nó không nên tự trả lời thì chuyển cho bạn.
Nếu bạn chỉ cần danh sách, hãy dừng sau bước xác minh rồi chạy sellbird export. Lệnh này cho ra một file CSV sẵn sàng đưa vào công cụ gửi thư khác.
Về chi phí, README nêu như sau. Tìm doanh nghiệp là 0 đồng với nguồn mặc định, hoặc khoảng 0,37 USD cho 1.000 kết quả với nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Phần viết và gửi dùng gói đăng ký sẵn có của bạn và một hộp thư (khoảng 7 USD một tháng cho Google Workspace). Bạn không cần Apollo, ZoomInfo, Clearbit hay Clay.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Python 3.11 trở lên. File pyproject.toml cũng yêu cầu bản này. README lưu ý máy Mac đi kèm Python 3.9, nên nếu
python3 --versionbáo 3.9 thì chạy trướcbrew install python@3.13. - Claude Pro hoặc Max với CLI đã đăng nhập (lệnh
claude login), hoặc gói ChatGPT có Codex CLI. Phần Codex có hướng dẫn riêng trong thư mục docs của repo. - Một hộp thư để gửi đi. Nên là Google Workspace trên một tên miền gửi thư riêng. Microsoft 365 và SMTP cũng dùng được.
- Warmup (làm nóng) cho hộp thư đó. README khuyên dùng TrulyInbox. Sellbird đọc tỷ lệ vào hộp thư chính của công cụ này để báo khi nào bạn sẵn sàng gửi. README cũng ghi rõ các liên kết TrulyInbox là liên kết affiliate của người duy trì dự án.
Ghi chú về hệ điều hành: README đưa sẵn đường dẫn thư mục dữ liệu cho macOS, Windows và Linux. Các lệnh cài đặt trong README viết theo kiểu macOS/Linux (ví dụ source .venv/bin/activate). README chưa ghi lệnh kích hoạt môi trường ảo riêng cho Windows. Docker được nhắc là chạy được trên Linux.
File .env.example liệt kê các khoá tuỳ chọn: Gmail, SMTP/IMAP, Microsoft 365, Instantly, công cụ xác minh email như Reoon, ZeroBounce, Hunter, và vài dịch vụ khác. Bạn chỉ điền những gì mình thực sự dùng.
III.Cài đặt từng bước
- Kiểm tra Python và ClaudeCó Python 3.11+ và đã chạy claude login
- Tải mã nguồnDùng git clone rồi cd vào thư mục sellbird
- Cài đặtTạo môi trường ảo và cài gói sellbird
- Điền thông tinSao chép .env.example thành .env và điền khoá cần dùng
- Dạy Sellbird về sản phẩmChạy sellbird train với website của bạn
- Tìm khách và chạyChạy discover, mở dashboard rồi chạy run
A.Kiểm tra Python và Claude
Mở terminal (Terminal trên Mac, hoặc cửa sổ dòng lệnh bạn quen dùng) và kiểm tra phiên bản Python. Nếu báo 3.9 trên Mac, hãy cài bản mới như phần trên.
python3 --version
claude loginLệnh thứ hai đăng nhập Claude Code CLI bằng gói Pro hoặc Max của bạn. Nếu bạn dùng ChatGPT thì làm theo hướng dẫn Codex trong docs của repo.
B.Tải mã nguồn
Cách dễ nhất README gợi ý là để Claude hướng dẫn bạn cài. Tải repo về, vào thư mục và mở Claude Code:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeRồi gõ: “set up Sellbird for me”. File CLAUDE.md của repo biến Claude Code thành người hướng dẫn: nó kiểm tra máy bạn, cài những gì còn thiếu, hỏi những gì cần hỏi và dạy Sellbird về sản phẩm của bạn. Nếu muốn tự làm, tiếp tục các bước dưới đây.
C.Cài đặt gói
Trong thư mục sellbird, tạo môi trường ảo và cài gói. Bạn cần dùng python3.13, không dùng python3 trần, vì trên Mac python3 trần là bản 3.9.
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .Lệnh này tạo thư mục .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Cài xong bạn sẽ có lệnh sellbird. Mỗi lần mở terminal mới, bạn cần kích hoạt lại môi trường ảo trước khi dùng lệnh này.
D.Điền thông tin đăng nhập
cp .env.example .env && $EDITOR .envLệnh này sao chép file mẫu thành .env, rồi mở ra để bạn sửa. README nói mỗi biến đều có chú thích ngay trong file. Chỗ người mới hay vấp là bạn phải sửa .env, không phải sửa .env.example. Nếu $EDITOR chưa được đặt, hãy mở file .env bằng trình soạn thảo bạn quen.
E.Dạy Sellbird về sản phẩm của bạn
sellbird train https://your-company.com
sellbird signals --confirm freeLệnh đầu đọc website của bạn để hiểu sản phẩm, rồi ghi vào sellbird.local.yaml. Hãy thay địa chỉ mẫu bằng website thật của bạn. Lệnh thứ hai xác nhận thế nào là một khách hàng tiềm năng tốt, tức là các tín hiệu mua hàng ở phần trên.
F.Tìm khách và bật vòng lặp
sellbird discover
sellbird dashboard # prints a private link to http://127.0.0.1:5555
sellbird runsellbird discover tìm doanh nghiệp bằng nguồn miễn phí mặc định, không cần tài khoản. sellbird dashboard in ra một liên kết riêng tới địa chỉ http://127.0.0.1:5555 trên máy bạn, và đó là nơi bạn duyệt thư. sellbird run bật vòng lặp làm việc.
Sellbird gửi thư từ hộp thư thật của bạn. Đừng dùng hộp thư chính của công ty. README khuyên dùng một tên miền gửi thư riêng, có warmup. Hãy đọc kỹ phần Legal and deliverability trong docs của repo để biết quy định về gửi cold email trước khi gửi thật.
IV.Kiểm tra đã chạy được chưa
Sau khi chạy sellbird run, bạn sẽ thấy màn hình khởi động kiểu như sau (README minh hoạ):
Sellbird is online.
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
handler → ... interested, answer drafted
writer → 2-email sequence: ...
outbox → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.Dấu hiệu thành công là dòng "Sellbird is online", rồi vòng lặp báo các thư đang chờ bạn duyệt trong Outbox, rồi nghỉ 15 phút trước vòng sau. Mở liên kết do sellbird dashboard in ra để xem các thư đang chờ.
Nếu bạn đã chạy discover mà chưa thấy gì, hãy mở dashboard kiểm tra danh sách công ty trước. README cũng có sẵn dữ liệu mẫu (công ty giả tên Bookwell, tên miền .test) để bạn xem thử giao diện mà không đụng tới khách thật.
V.Dùng vào việc thật
A.Chủ một công ty dịch vụ địa phương tìm khách mới
Bạn bán phần mềm đặt lịch cho phòng khám nha khoa. Bạn chạy sellbird train với website của mình, xác nhận tín hiệu "chưa có đặt lịch online", rồi chạy sellbird discover. Sellbird tìm các phòng khám phù hợp, đọc website của họ và tìm tên chủ phòng khám. Kết quả là một danh sách công ty có lý do cụ thể để bạn liên hệ, không phải danh sách mua sẵn.
Mặc định, không có email nào rời máy bạn nếu bạn chưa bấm duyệt.
Ông T
B.Nhân viên kinh doanh duyệt thư mỗi sáng
Bạn để sellbird run chạy. Mỗi sáng mở dashboard, vào Outbox, đọc từng thư đã viết sẵn và duyệt hoặc sửa. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ chặn thư còn sót merge tag, cụm từ bị cấm, thư quá dài, quá nhiều liên kết hoặc địa chỉ không gửi được. Bạn chỉ phải đọc và quyết định, còn việc viết và gửi theo đúng giới hạn mỗi ngày là của công cụ.
C.Người chỉ cần một danh sách khách để dùng công cụ khác
Bạn đã có công cụ gửi thư riêng (README nhắc tới Instantly trong cấu hình). Bạn chạy các bước tìm và xác minh rồi dùng:
sellbird exportBạn nhận về một file CSV gồm các công ty, người quyết định và địa chỉ đã xác minh, sẵn sàng nhập vào công cụ gửi thư của bạn.
D.Xử lý thư trả lời và tạm dừng khi cần
Khi có người trả lời, Sellbird phân loại (quan tâm, phản đối, tự động trả lời…) và soạn sẵn câu trả lời để bạn xem. Nếu có điều gì bất thường, bạn chạy:
sellbird sending pauseLệnh này dừng toàn bộ việc gửi ngay lập tức. Người xin ngừng nhận thư sẽ được tôn trọng ngay.
VI.Lỗi hay gặp và cách xử lý
Lệnh sellbird báo không tìm thấy. Thường là do bạn chưa kích hoạt môi trường ảo hoặc chưa cài xong. Chạy lại source .venv/bin/activate trong thư mục repo, rồi pip install -e . nếu cần.
Python báo phiên bản cũ hoặc cài lỗi. README cảnh báo Mac có Python 3.9 mặc định. Hãy cài Python 3.13 và dùng python3.13 khi tạo môi trường ảo như hướng dẫn, không dùng python3 trần.
Sau khi nâng cấp từ Harvey, git pull báo "your local changes would be overwritten". Điều này xảy ra khi bạn từng sửa trực tiếp harvey.yaml. README hướng dẫn chạy git stash, git pull, rồi git stash pop. Nếu báo xung đột, giữ dòng của bạn, xoá các dấu xung đột và chạy git stash drop. Tốt hơn, hãy để cài đặt riêng trong sellbird.local.yaml, file mà git không đụng tới.
Không gửi được thư hoặc thư vào spam. Kiểm tra bạn đã điền đúng thông tin hộp thư trong .env và hộp thư đã warmup chưa. README nhấn mạnh warmup và tên miền gửi thư riêng. Phần Troubleshooting và Legal and deliverability trong docs của repo có hướng dẫn chi tiết.
Không thấy dữ liệu sau khi cài bằng pip. Nếu bạn cài như một gói (không chạy từ thư mục repo), file cấu hình và dữ liệu nằm trong thư mục người dùng (ví dụ %APPDATA%\sellbird trên Windows, ~/Library/Application Support/sellbird trên macOS). Hãy tìm ở đó thay vì trong thư mục bạn đang đứng.
VII.Có nên dùng không
Điểm mạnh. Không cần API key mô hình và không tính tiền theo token, vì dùng gói bạn đang có. Nguồn tìm doanh nghiệp mặc định miễn phí. Mã mở và chạy trên máy bạn, nên bạn giữ quyền kiểm soát dữ liệu. Cơ chế duyệt thủ công mặc định cùng bước kiểm tra trước khi gửi giúp giảm rủi ro gửi nhầm.
Giới hạn. Bạn vẫn phải chuẩn bị hộp thư gửi, tên miền riêng và warmup, và các thứ này có chi phí riêng. Đây là công cụ dòng lệnh, nên người chưa quen terminal sẽ thấy hơi nặng lúc đầu, dù có thể nhờ Claude Code hướng dẫn cài. Các lệnh trong README viết cho macOS/Linux, và README chưa nói rõ cách làm trên Windows. Giấy phép AGPL-3.0 có ràng buộc riêng nếu bạn định biến nó thành dịch vụ cho người khác, nên hãy đọc kỹ trước khi làm vậy.
Khi nào nên chọn cách khác. Nếu bạn không muốn tự chạy, tác giả có bản đám mây tại sellbird.ai (đang truy cập sớm), đã thiết lập sẵn tên miền gửi thư, hộp thư và warmup. Còn nếu bạn chưa sẵn sàng về mặt pháp lý và kỹ thuật cho cold email, hãy bắt đầu bằng sellbird export để lấy danh sách và tự quyết định bước tiếp theo.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Mã nguồn mở theo giấy phép AGPL-3.0, tải về dùng được. Nguồn tìm doanh nghiệp mặc định (OpenStreetMap) và bước đọc website đều miễn phí. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT sẵn có, một hộp thư gửi (README nêu khoảng 7 USD một tháng cho Google Workspace) và có thể trả phí cho nguồn tìm kiếm hoặc warmup nếu muốn.
Có cần API key của OpenAI hay Anthropic không?
Không. Theo README, Sellbird dùng Claude Code CLI trên gói Claude Pro hoặc Max, hoặc Codex trên gói ChatGPT, nên không có API key mô hình và không tính tiền theo token. Một số dịch vụ tuỳ chọn khác (xác minh email, tìm kiếm trả phí) có khoá riêng trong file .env.
Có cần GPU không?
Tư liệu không nhắc tới GPU. Phần suy luận chạy qua Claude hoặc Codex trên gói đăng ký của bạn, không chạy mô hình trên máy. Yêu cầu nêu rõ là Python 3.11 trở lên.
Chạy được trên Windows không?
README có nêu thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt viết theo kiểu macOS/Linux và Docker được nhắc là dành cho Linux. README chưa ghi rõ các bước cài trên Windows, nên bạn nên xem mục Troubleshooting trong docs của repo.
Sellbird có tự gửi email mà tôi không biết không?
Mặc định thì không. Mọi email chờ trong Outbox để bạn duyệt cho tới khi bạn tự bật chế độ autopilot. Ngay cả khi bật, các thư có liên kết tới tên miền không phải của bạn sẽ bị giữ lại. Lệnh `sellbird sending pause` dừng mọi thứ tức thì.
Khác gì Apollo, ZoomInfo hay Clay?
README nói Sellbird không dùng các công cụ prospecting đó. Nó tự tìm doanh nghiệp, đọc website và xác minh email, rồi viết và gửi thư trong cùng một công cụ chạy trên máy bạn. Tư liệu không có so sánh chi tiết về tính năng hay độ chính xác dữ liệu với các công cụ này.
Tôi đang dùng Harvey thì nâng cấp thế nào?
Harvey chỉ là tên cũ của Sellbird. Cấu hình, dữ liệu và đăng nhập dashboard được giữ nguyên. Bạn chạy `git pull`, `pip install -e .` rồi `sellbird dashboard`, lần chạy đầu Sellbird sẽ tự đổi tên các file cấu hình và cơ sở dữ liệu. Với Docker, README có thêm các bước riêng.


