Sellbird: tự tìm khách, viết và gửi cold email bằng gói Claude — hướng dẫn cài 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 (trước đây tên Harvey) là nền tảng outreach mã nguồn mở viết bằng Python. Nó tìm công ty phù hợp, tìm người quyết định, xác minh email, viết cold email cá nhân hoá, gửi đi và soạn sẵn câu trả lời khi khách phản hồi. Cài không quá khó nếu bạn quen terminal, và mặc định không email nào được gửi khi bạn chưa duyệt.
Sellbird là một nền tảng outreach (tiếp cận khách hàng bằng email lạnh) mã nguồn mở, chạy ngay trên máy của bạn. Nó tự tìm những công ty có thể cần sản phẩm của bạn, tìm người ra quyết định, kiểm tra địa chỉ email, viết từng email riêng, gửi đi rồi xử lý các câu trả lời. Dự án trước đây tên là Harvey, nay đổi tên thành Sellbird, vẫn là cùng một dự án và cùng lịch sử.
Repo này hợp với chủ doanh nghiệp nhỏ, người làm sale, người làm marketing và lập trình viên mới 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 đỏ. Hiện có khoảng 5.250 sao và 1.127 fork trên GitHub, giấy phép AGPL-3.0, và repo vẫn được cập nhật trong vài tháng gần đây.
Điểm đáng giá nhất: Sellbird "suy nghĩ" qua Claude Code CLI trên gói Claude Pro hoặc Max, hoặc qua Codex trên gói ChatGPT. Bạn không cần API key của mô hình và không bị tính tiền theo token. Ngoài ra, mặc định mọi email đều nằm chờ bạn duyệt trước khi gửi. Bạn có thể xem video ngắn bên dưới để thấy nó chạy, rồi quay lại đây làm theo từng bước.
ethanplusai/sellbird
Nền tảng outreach mã nguồn mở chạy trên máy bạn: tìm công ty, xác minh email, viết và gửi cold email, xử lý trả lời bằng gói Claude hoặc ChatGPT.
I.Sellbird làm được gì
Sellbird là một chuỗi công đoạn. Bạn có thể chạy hết từ đầu đến cuối, hoặc dừng ở bất kỳ bước nào.
A.Tìm công ty phù hợp
Nó tìm các doanh nghiệp giống khách hàng của bạn. Nguồn mặc định là OpenStreetMap, miễn phí và không cần tài khoản. 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. README nói nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả.
B.Tìm lý do họ sẽ mua
Sellbird đọ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 nên không tốn tiền. Nó chỉ gửi ba yêu cầu HTTP cho mỗi website.
C.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 cho mỗi công ty. Nhờ vậy email gửi đến một người cụ thể, không gửi vào hộp thư chung.
D.Kiểm tra địa chỉ email
Sellbird học mẫu 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 dùng để gửi. Điều này giúp bạn tránh gửi vào địa chỉ chết, vốn làm hỏng uy tín tên miền gửi thư.
E.Viết và gửi
Sellbird viết một chuỗi email ngắn cho từng người dựa trên những gì nó tìm được. Sau đó nó gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn gửi mỗi ngày và giờ làm việc của người nhận.
F.Xử lý trả lời
Nó đọc mọi phản hồi, soạn nháp câu trả lời, để riêng các thư tự động trả lời, tôn trọng yêu cầu từ chối nhận thư ngay lập tức. Những việc nó không nên tự trả lời thì được chuyển cho bạn.
G.Chỉ cần danh sách
Nếu bạn chỉ muốn danh sách khách, hãy dừng sau bước xác minh rồi chạy sellbird export. Lệnh này xuất file CSV để nạp vào công cụ gửi email khác.
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 Python từ 3.11. README lưu ý macOS đi kèm Python 3.9, nên nếu
python3 --versionbáo 3.9 thì cài thêm bằngbrew install python@3.13. - Gói Claude Pro hoặc Max và đã đăng nhập Claude CLI bằng
claude login. Hoặc gói ChatGPT có Codex CLI. - Một hộp thư để gửi. README khuyên dùng Google Workspace trên một tên miền gửi riêng. Microsoft 365 và SMTP cũng dùng được.
- Warmup (khởi động) cho hộp thư đó. README giới thiệu TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Đây là link affiliate của người duy trì dự án, bạn không bắt buộc dùng.
- Git, để tải mã nguồn về.
Về phần cứng, tư liệu không nêu yêu cầu GPU hay cấu hình tối thiểu. Về hệ điều hành, README có ghi đường dẫn thư mục dữ liệu cho macOS, Windows và Linux. Các lệnh mẫu trong README viết cho macOS/Linux, và Docker chỉ được nhắc cho Linux.
Sellbird gửi email thật cho người thật. Hãy dùng tên miền gửi riêng, không dùng tên miền chính của công ty. Đọc kỹ tài liệu Legal and deliverability trong thư mục docs/ của repo để biết quy định bạn phải tuân theo ở nước người nhận.
III.Cài đặt từng bước
- Chuẩn bị Python và ClaudeCó Python 3.11+ và đã chạy claude login
- Tải mã nguồngit clone repo về máy rồi vào thư mục
- Tạo môi trường và càiTạo .venv rồi pip install -e .
- Điền thông tin vào .envSao chép .env.example thành .env và điền hộp thư
- Dạy Sellbird về sản phẩmChạy sellbird train rồi sellbird signals
- Tìm khách và chạysellbird discover, mở dashboard, rồi sellbird run
README đưa ra hai cách: nhờ Claude cài giúp, hoặc tự gõ lệnh. Mình mô tả cả hai.
A.Cách nhanh: để Claude hướng dẫn cài
Mở terminal (trên Windows là PowerShell hoặc Git Bash), rồi chạy ba lệnh sau. Lệnh đầu tải mã nguồn, lệnh thứ hai vào thư mục vừa tải, lệnh thứ ba mở Claude Code ngay trong thư mục đó:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeKhi Claude mở lên, bạn gõ: "set up Sellbird for me". Theo README, file CLAUDE.md của repo biến Claude Code thành người hướng dẫn cài đặt: nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi những gì cần hỏi và huấn luyện Sellbird về sản phẩm của bạn. Chỗ người mới hay vấp: bạn phải đứng trong thư mục sellbird trước khi gõ claude.
B.Cách tự làm: tải mã nguồn
Nếu bạn đã làm cách nhanh ở trên thì bỏ qua bước này. Nếu chưa, chạy hai lệnh đầu:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbirdC.Cách tự làm: tạo môi trường và cài đặt
Lệnh dưới đây tạo một môi trường Python riêng tên .venv, kích hoạt nó, rồi cài Sellbird vào. README dặn dùng python3.13 thay vì python3, vì trên macOS lệnh python3 trần có thể là bản 3.9.
# 1. Install. Use python3.13, not python3: on macOS bare python3 is 3.9.
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .Lệnh source .venv/bin/activate dùng cho macOS và Linux. README không ghi lệnh riêng cho Windows. Với Windows PowerShell, cách kích hoạt thông thường của Python là .venv\Scripts\Activate.ps1. Bạn cũng có thể tham khảo mục Troubleshooting trong thư mục docs/ của repo.
D.Cách tự làm: điền thông tin vào .env
Lệnh này sao chép file mẫu thành file thật, rồi mở ra để sửa:
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .envFile .env.example có chú thích cho từng biến. Bạn chỉ điền phần mình dùng. Ví dụ, nếu gửi qua SMTP thì điền nhóm SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD (và IMAP_* để đọc thư trả lời). Nếu dùng Gmail thì có GMAIL_CLIENT_ID và GMAIL_CLIENT_SECRET. Nếu dùng Microsoft 365 thì có M365_CLIENT_ID và M365_TENANT_ID. Các dịch vụ xác minh email như Reoon, ZeroBounce, Hunter cũng có biến riêng, nhưng bạn không bắt buộc dùng hết.
Trên Windows, $EDITOR thường chưa được đặt. Bạn chỉ cần mở file .env bằng Notepad rồi điền tay.
E.Cách tự làm: dạy Sellbird về sản phẩm của bạn
# 3. Learn your product from your website (writes sellbird.local.yaml).
sellbird train https://your-company.com
# 4. Confirm what makes a good prospect.
sellbird signals --confirm freeLệnh train đọc website của bạn để hiểu bạn bán gì, rồi ghi kết quả vào file sellbird.local.yaml. Hãy thay https://your-company.com bằng website thật của bạn. Lệnh signals --confirm free giúp bạn xác nhận thế nào là một khách tiềm năng tốt, tức các tín hiệu mua hàng.
F.Cách tự làm: tìm khách và chạy vòng lặp
# 5. Find businesses. The default source is free and needs no account.
sellbird discover
# 6. Open the dashboard and start the loop.
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 mặc định miễn phí. sellbird dashboard in ra một đường link riêng tới http://127.0.0.1:5555, đây là địa chỉ trên chính máy bạn. sellbird run khởi động vòng lặp chính của Sellbird. Hãy mở dashboard trong một cửa sổ terminal và chạy run ở cửa sổ khác.
README cũng nói trên Linux bạn có thể chạy bằng Docker, repo có sẵn Dockerfile và docker-compose.yml. Hướng dẫn chi tiết nằm trong tài liệu Docker ở thư mục docs/.
IV.Kiểm tra đã chạy được chưa
Sau khi cài xong, hãy thử gõ lệnh sellbird dashboard. Nếu máy in ra một link riêng tới http://127.0.0.1:5555 và mở được trang dashboard trên trình duyệt, tức là phần cài đặt đã ổn.
Với lệnh sellbird run, README cho thấy màn hình mẫu như sau: dòng "Sellbird is online", rồi "Checking pipeline state...", rồi một dòng "Decision" cho biết bước tiếp theo. Sau đó là các dòng của handler, writer và outbox, kết thúc bằng "Cycle complete. Sleeping for 15 minutes." Điều đáng nhìn nhất là dòng outbox kiểu "5 emails waiting for your approval", nghĩa là email đã được soạn và đang chờ bạn duyệt.
Dữ liệu demo trong README là dữ liệu bịa: công ty "Bookwell" bán phần mềm đặt lịch cho thợ lợp mái, phòng nha và tiệm sửa điều hoà, trên các tên miền .test. Bạn đừng nhầm đó là khách thật.
V.Dùng vào việc thật
Cả bốn tình huống dưới đây chỉ dùng những lệnh có trong README.
A.Chủ doanh nghiệp nhỏ muốn có danh sách khách mà không mua công cụ đắt
Bạn bán phần mềm đặt lịch hẹn cho phòng khám hoặc tiệm dịch vụ. 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 bằng nguồn miễn phí. README ghi rõ Sellbird không cần Apollo, ZoomInfo, Clearbit hay Clay. Kết quả là một danh sách công ty cùng người ra quyết định, mỗi địa chỉ email có nhãn verified, risky, guess hoặc invalid.
B.Người làm sale chỉ cần danh sách để nạp vào công cụ khác
Bạn đã có sẵn công cụ gửi email và chỉ cần dữ liệu. Hãy chạy các bước tìm và xác minh, rồi dừng lại và gõ:
sellbird exportLệnh này xuất ra một file CSV sẵn sàng đưa vào công cụ gửi email của bạ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, nên thử nghiệm ở mức an toàn.
Ông T
C.Nhân viên marketing duyệt email trước khi gửi
Bạn chạy sellbird run, mở dashboard rồi vào Outbox. Mỗi email chờ ở đó cho đến khi bạn đồng ý, trừ khi bạn tự bật chế độ autopilot. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ loại các email còn sót merge tag chưa điền, có cụm từ bị cấm, quá dài, có thêm link hoặc gửi tới địa chỉ không gửi được. Bạn đọc, sửa, duyệt hoặc bỏ. Nếu cần dừng hết, gõ sellbird sending pause.
D.Lập trình viên mới muốn tuỳ biến theo ngành mình
Repo có thư mục prompts/ và skills/, README mô tả chúng là các bản hướng dẫn bán hàng có thể sửa. Bạn thử đổi giọng văn trong prompt, rồi chạy lại để xem email thay đổi ra sao. Nếu cài bằng pip hoặc pipx, các file này nằm trong thư mục dữ liệu của người dùng. Trên Windows đó là %APPDATA%\sellbird. Bản chép mặc định không bị ghi đè khi nâng cấp, nên chỉnh sửa của bạn được giữ nguyên.
VI.Lỗi hay gặp và cách xử lý
A.Python quá cũ nên lệnh cài thất bại
Pyproject yêu cầu Python 3.11 trở lên. Trên macOS lệnh python3 có thể là bản 3.9. Hãy kiểm tra bằng python3 --version. Nếu thấp hơn 3.11, cài bản mới (README gợi ý brew install python@3.13) rồi tạo lại môi trường bằng python3.13.
B.Gõ sellbird mà báo không tìm thấy lệnh
Thường là bạn chưa kích hoạt môi trường .venv trong cửa sổ terminal hiện tại. Mỗi lần mở terminal mới, hãy vào thư mục repo và kích hoạt lại. Nếu vẫn lỗi, chạy lại pip install -e . trong môi trường đó.
C.Claude chưa đăng nhập
Sellbird dùng Claude Code CLI trên gói Pro hoặc Max của bạn. Nếu chưa đăng nhập, hãy chạy claude login trước. Nếu dùng ChatGPT thì xem hướng dẫn Codex trong thư mục docs/.
D.git pull báo "your local changes would be overwritten"
Lỗi này có trong README, dành cho người từng sửa trực tiếp file harvey.yaml của bản cũ. Hãy chạy git stash, rồi git pull, rồi git stash pop. Nếu có xung đột, giữ lại các dòng của bạn, xoá các dấu xung đột rồi chạy git stash drop. Cách tốt hơn là đặt cấu hình vào sellbird.local.yaml, file mà git không đụng tới.
E.Email vào thư rác hoặc tên miền bị đánh giá xấu
Đây là rủi ro rất dễ xảy ra với mọi công cụ cold email, không riêng Sellbird. Hãy gửi từ tên miền riêng, làm warmup cho hộp thư trước khi gửi, giữ giới hạn gửi mỗi ngày thấp và chỉ gửi tới địa chỉ có nhãn verified. Tài liệu Legal and deliverability trong repo nói chi tiết hơn.
VII.Có nên dùng không
Điểm mạnh. Sellbird chạy trên máy của bạn, mã nguồn mở, không cần API key mô hình và không tính tiền theo token. Nguồn tìm công ty mặc định miễn phí. Có nhiều lớp an toàn: email chờ duyệt mặc định, bước kiểm tra trước khi gửi không dùng mô hình, và lệnh dừng gửi toàn bộ. Dự án còn được cập nhật và có tài liệu khá đầy đủ.
Giới hạn. Bạn cần quen terminal và cần một hộp thư gửi cùng bước warmup. Gói Claude hay ChatGPT của bạn vẫn có hạn mức, dù README nói Sellbird tự giảm tốc để chừa chỗ cho việc của bạn. Giấy phép AGPL-3.0 nghiêm hơn MIT, nên nếu định đóng gói thành dịch vụ cho người khác, hãy đọc kỹ giấy phép. Các lệnh mẫu trong README viết cho macOS/Linux, người dùng Windows sẽ phải tự điều chỉnh đôi chỗ.
Khi nào nên chọn cách khác. Nếu bạn không muốn tự vận hành gì cả, README nói có bản hosted tại trang chủ dự án (đang trong giai đoạn early access), với tên miền gửi, hộp thư và warmup được thiết lập sẵn. Nếu bạn chỉ làm marketing chăm sóc khách đã đồng ý nhận thư, một công cụ email marketing thông thường sẽ hợp hơn. Cold email có ràng buộc pháp lý, nên hãy đọc kỹ quy định trước khi gửi hàng loạt.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Phần mềm là mã nguồn mở, giấy phép AGPL-3.0. Nguồn tìm công ty mặc định (OpenStreetMap) và bước đọc website đều có chi phí 0 theo README. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex, và một hộp thư để gửi (README nêu Google Workspace khoảng 7 USD một tháng). Nguồn tìm trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả.
Sellbird có cần API key của Claude hay OpenAI không?
Không. Theo README, Sellbird suy nghĩ qua Claude Code CLI trên gói Pro hoặc Max, hoặc qua 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ụ phụ như xác minh email có biến API key riêng trong .env.example, nhưng đó là tuỳ chọn.
Có cần GPU hay máy mạnh không?
Tư liệu không nêu yêu cầu GPU hay cấu hình tối thiểu. Phần suy nghĩ chạy qua Claude hoặc Codex chứ không chạy mô hình trên máy bạn. Bạn chỉ cần Python 3.11 trở lên và kết nối mạng.
Chạy được trên Windows không?
README có ghi thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh mẫu viết cho macOS/Linux và Docker chỉ được nhắc cho Linux. Tư liệu không có hướng dẫn cài riêng cho Windows, nên bạn có thể phải điều chỉnh vài lệnh, ví dụ lệnh kích hoạt môi trường ảo.
Sellbird có tự gửi email mà không hỏi tôi không?
Mặc định là không. Mọi email nằm trong Outbox chờ bạn duyệt cho đến khi bạn tự bật autopilot. Ngay cả khi autopilot bật, nó vẫn giữ lại email có link tới tên miền không phải của bạn. Lệnh `sellbird sending pause` dừng mọi thứ ngay lập tức.
Dữ liệu của tôi lưu ở đâu, có an toàn không?
Cấu hình, kiến thức và dữ liệu nằm trong một thư mục home trên máy bạn, gồm cơ sở dữ liệu, log và token đăng nhập dashboard. Dashboard chạy ở địa chỉ 127.0.0.1 trên máy bạn. README không đưa ra cam kết bảo mật nào ngoài điều đó. Nếu phát hiện lỗ hổng, bạn xem file SECURITY.md của repo.
Sellbird khác gì Harvey?
Đó là cùng một dự án. Harvey được đổi tên thành Sellbird từ bản 0.4.0, cấu hình, dữ liệu và đăng nhập dashboard được giữ nguyên khi nâng cấp. Các bản Harvey đến 0.3.x dùng giấy phép MIT, còn từ Sellbird trở đi là AGPL-3.0.


