Sellbird: 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
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 là Harvey) là công cụ mã nguồn mở viết bằng Python, giúp bạn tìm khách hàng tiềm năng, kiểm tra email, viết và gửi cold email rồi xử lý phản hồi. Nó chạy trên máy bạn, dùng gói Claude Pro/Max hoặc ChatGPT (Codex) sẵn có nên không cần API key mô hình. Cài đặt khá dễ nếu bạn quen terminal, 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ở để làm outreach (tiếp cận khách hàng bằng email lạnh). Nó tìm các công ty có thể cần thứ bạn bán, tìm người quyết định, kiểm tra địa chỉ email, viết từng email riêng rồi gửi đi và xử lý thư trả lời. Trước đây dự án tên là Harvey, nay đã đổi tên thành Sellbird.
Bạn nên xem qua nếu đang làm sale cho doanh nghiệp nhỏ, chạy agency, hoặc là lập trình viên muốn có một "nhân viên sale" chạy trên máy mình. Điểm đáng giá nhất là nó chạy nhờ gói Claude Pro/Max hoặc gói ChatGPT có Codex mà bạn đã trả tiền. Theo README, không cần API key mô hình và không tính tiền theo token. Hiện repo có khoảng 5.250 sao và 1.127 fork.
Một điều khiến mình yên tâm: 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. Bạn có thể xem video ngắn bên dưới để thấy tổng quan, rồi quay lại đọc phần cài đặt.
ethanplusai/sellbird
Sellbird là nền tảng mã nguồn mở tìm công ty và người ra 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.
I.Sellbird làm được gì
Sellbird là một dây chuyền nhiều bước. Bạn có thể chạy hết, 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 lý tưở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 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 và không tốn tiền, vì chỉ dùng ba yêu cầu HTTP cho mỗi công ty. Nhờ vậy email viết ra có chi tiết thật để nhắc tới, thay vì chung chung.
C.Tìm người ra 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. Cách này gọn và ít "rải thảm" hơn.
D.Kiểm tra địa chỉ email
Sellbird học mẫu email của công ty rồi kiểm tra 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 gửi tới. Điều này giúp bạn tránh bị trả thư lỗi hàng loạt, vốn rất hại cho uy tín tên miền gửi.
E.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 gửi mỗi ngày và theo giờ làm việc của người nhận.
F.Xử lý thư trả lời
Nó đọc mọi thư trả lời, soạn sẵn câu trả lời, tách thư tự động ra riêng, xử lý yêu cầu từ chối ngay lập tức, và chuyển cho bạn những thư nó không nên tự trả lời.
G.Chỉ cần danh sách cũng được
Nếu bạn chỉ muốn danh sách khách, hãy dừng sau bước kiểm tra email và chạy sellbird export. Bạn sẽ có file CSV sẵn để đưa vào công cụ gửi mail khác.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Python 3.11 trở lên. File
pyproject.tomlcũng yêu cầu>=3.11. README lưu ý macOS đi kèm Python 3.9, nên nếupython3 --versionbáo 3.9 thì chạybrew install python@3.13trước. - Gói Claude Pro hoặc Max đã đăng nhập Claude Code CLI bằng
claude login. Hoặc gói ChatGPT có Codex CLI (README có hướng dẫn riêng cho Codex trong tài liệu của repo). - 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 chạy được.
- Warmup (làm nóng) hộp thư đó. Tác giả gợi ý dùng TrulyInbox. Lưu ý: link TrulyInbox trong dự án là link affiliate, người duy trì dự án có thể nhận hoa hồng.
- Git để tải mã nguồn.
File .env.example liệt kê các biến cấu hình tuỳ chọn, như GMAIL_CLIENT_ID, SMTP_HOST, IMAP_HOST, M365_CLIENT_ID, REOON_API_KEY, ZEROBOUNCE_API_KEY, HUNTER_API_KEY, TRULYINBOX_API_KEY. Bạn không cần điền hết. Chỉ điền những gì dịch vụ bạn chọn dùng đòi hỏi, và README nói mỗi biến đều có chú thích ngay trong file.
Về hệ điều hành: README có đường dẫn thư mục dữ liệu cho macOS, Windows và Linux, và nói Docker chạy được trên Linux. Các lệnh cài đặt trong README viết cho kiểu macOS/Linux (source .venv/bin/activate). README chưa ghi lệnh riêng cho Windows, nên nếu dùng Windows bạn nên xem mục Troubleshooting và Docker trong thư mục docs/ của repo.
III.Cài đặt từng bước
- Tải mã nguồnDùng git clone về máy rồi cd vào thư mục sellbird
- Cài đặtTạo môi trường ảo bằng Python 3.13 và chạy pip install -e .
- Điền thông tinSao chép .env.example thành .env rồi điền những biến bạn cần
- Dạy sản phẩmChạy sellbird train với website công ty bạn, rồi xác nhận tín hiệu
- Tìm kháchChạy sellbird discover
- Mở bảng điều khiểnChạy sellbird dashboard rồi sellbird run
README có hai cách: để Claude cài giúp, hoặc tự làm từng lệnh. Mình viết cả hai bên dưới.
A.Cách nhanh: nhờ Claude cài giúp
Nếu bạn đã có Claude Code, đây là cách dễ nhất. Mở terminal (trên macOS là Terminal, trên Windows là PowerShell hoặc Git Bash), rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeLệnh git clone tải mã nguồn về, cd sellbird đi vào thư mục vừa tải, còn claude mở Claude Code ngay trong thư mục đó. Sau đó 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: 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 mở terminal đúng trong thư mục sellbird trước khi gõ claude, nếu không Claude sẽ không đọc được CLAUDE.md.
B.Cách tự làm, bước 1: cài đặt
# 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 này tạo một môi trường ảo tên .venv (một "hộp" riêng để cài gói, không ảnh hưởng phần còn lại của máy), kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau khi chạy xong, bạn có lệnh sellbird. Hãy dùng python3.13 thay vì python3 như README dặn.
C.Bước 2: điền thông tin đăng nhập
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .envLệnh cp sao chép file mẫu thành .env, còn $EDITOR mở file bằng trình soạn thảo mặc định. Bạn điền khoá và mật khẩu vào file .env này, đừng sửa trực tiếp .env.example. Đừng đưa .env lên GitHub hay gửi cho ai.
D.Bước 3: 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.comThay https://your-company.com bằng website của bạn. Sellbird đọc trang đó để hiểu bạn bán gì, rồi ghi kết quả vào file sellbird.local.yaml. README khuyên đặt cài đặt riêng vào file này vì git không đụng tới nó khi bạn cập nhật.
E.Bước 4: xác nhận khách tốt trông như thế nào
# 4. Confirm what makes a good prospect.
sellbird signals --confirm freeLệnh này giúp bạn xác nhận các tín hiệu cho biết một công ty là khách tiềm năng tốt. README nói có 29 tín hiệu trong tài liệu về signals.
F.Bước 5: tìm doanh nghiệp
# 5. Find businesses. The default source is free and needs no account.
sellbird discoverNguồn mặc định miễn phí và không cần tài khoản.
G.Bước 6: mở bảng điều khiển và chạy vòng lặp
# 6. Open the dashboard and start the loop.
sellbird dashboard # prints a private link to http://127.0.0.1:5555
sellbird runsellbird dashboard in ra một đường link riêng tới địa chỉ trên máy bạn (127.0.0.1:5555), chỉ bạn mở được. sellbird run chạy vòng lặp chính. Hai lệnh này nên chạy ở hai cửa sổ terminal khác nhau.
README còn nói trên Linux bạn có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, và hướng dẫn chi tiết nằm trong tài liệu Docker.
Mặc định Sellbird không gửi gì khi bạn chưa duyệt. Hãy giữ nguyên chế độ đó cho tới khi bạn tin vào chất lượng email. Cold email còn có luật riêng tuỳ quốc gia. Hãy đọc tài liệu "Legal and deliverability" trong repo trước khi gửi thật, và dùng tên miền gửi riêng, đã warmup.
IV.Kiểm tra đã chạy được chưa
Có vài dấu hiệu để bạn biết mọi thứ ổn:
python3.13 --versionhiện 3.11 trở lên (README dùng 3.13).- Sau
pip install -e ., lệnhsellbirdgọi được trong terminal đang kích hoạt.venv. sellbird dashboardin ra một link riêng dẫn tớihttp://127.0.0.1:5555, và bạn mở được trang đó trên trình duyệt.sellbird runin ra màn hình kiểu như dưới đây (đây là ví dụ từ README, dữ liệu là bịa):
Sellbird is online.
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
writer → 2-email sequence: Phoenix HVAC hiring a dispatcher
outbox → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.Nếu bạn thấy dòng "emails waiting for your approval", nghĩa là Sellbird đã viết xong và đang chờ bạn duyệt trong Outbox. Đó là kết quả đúng.
V.Dùng vào việc thật
Sellbird không gửi gì khi bạn chưa gật đầu, nên bạn vừa thử được vừa không sợ lỡ tay.
Ông T
A.Chủ agency cần danh sách khách tiềm năng
Bạn làm dịch vụ cho nha khoa hoặc thợ sửa mái nhà và chỉ cần danh sách để đưa vào công cụ gửi mail riêng. Bạn chạy sellbird train với website của mình, xác nhận tín hiệu, rồi chạy sellbird discover. Khi đã tới bước kiểm tra email, bạn chạy:
sellbird exportKết quả là file CSV gồm công ty, người ra quyết định và địa chỉ đã gắn nhãn verified, risky, guess hoặc invalid. Bạn lọc lấy những địa chỉ gửi được rồi dùng tiếp.
B.Chủ shop dịch vụ muốn thử gửi vài email có duyệt
Bạn có hộp thư Google Workspace trên tên miền riêng và đã warmup. Bạn điền thông tin hộp thư vào .env, rồi chạy sellbird run cùng sellbird dashboard. Sellbird viết một chuỗi email ngắn cho mỗi người, nhắc đúng chi tiết nó thấy trên website của họ, ví dụ họ đang tuyển nhân viên điều phối. Các email nằm trong Outbox. Bạn đọc từng cái, sửa nếu muốn, rồi duyệt. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ chặn email còn sót thẻ merge chưa điền, cụm từ bị cấm, email quá dài, nhiều link hoặc địa chỉ không gửi được.
C.Nhân viên sale xử lý thư trả lời
Sau vài ngày có người trả lời. Sellbird đọc thư, soạn sẵn câu trả lời, để riêng các thư tự động, và xử lý ngay những ai xin ngừng nhận. Bạn chỉ cần vào bảng điều khiển xem những thư nó chuyển cho mình, vì đó là các thư nó cho rằng không nên tự trả lời. Cần dừng khẩn cấp thì chạy:
sellbird sending pauseLệnh này dừng toàn bộ việc gửi ngay lập tức.
D.Lập trình viên chạy trên máy của mình
Bạn đã dùng Claude Code hằng ngày. Bạn clone repo, chạy claude và nói "set up Sellbird for me". Claude kiểm tra môi trường, cài phần còn thiếu và hỏi bạn các thông tin cần thiết. Bạn muốn chỉnh cách viết email thì sửa các file trong prompts/ và skills/, vì README nói đây là các bộ "sales playbook" có thể chỉnh sửa. Với gói cài bằng pip, các file này nằm trong thư mục dữ liệu người dùng và không bị ghi đè khi nâng cấp.
VI.Lỗi hay gặp và cách xử lý
A.python3 --version báo 3.9 trên macOS
Đây là lỗi README đã cảnh báo. Chạy brew install python@3.13, rồi tạo môi trường ảo bằng python3.13 chứ không dùng python3.
B.Claude chưa đăng nhập
Sellbird nghĩ qua Claude Code CLI, nên nếu CLI chưa đăng nhập thì sẽ không chạy được. README ghi lệnh đăng nhập là claude login. Nếu bạn dùng ChatGPT thì xem tài liệu "Using a ChatGPT plan (Codex)" trong thư mục docs/.
C.Chạy rồi mà không thấy email nào được gửi
Thường là bình thường. Theo mặc định, mọi email nằm chờ trong Outbox cho tới khi bạn duyệt hoặc tự bật chế độ autopilot. Hãy vào bảng điều khiển để duyệt. Nếu vẫn không gửi, kiểm tra xem bạn đã chạy sellbird sending pause trước đó chưa. Tôi không có thông tin về lệnh bỏ tạm dừng, nên hãy xem tài liệu "Configuration and commands" trong repo.
D.Nâng cấp từ Harvey bị báo "your local changes would be overwritten"
Chuyện này xảy ra nếu bạn từng sửa trực tiếp file harvey.yaml. README hướng dẫn chạy theo thứ tự git stash, git pull, rồi git stash pop. Nếu báo xung đột ở sellbird.yaml, giữ các dòng của bạn, xoá dấu xung đột, rồi chạy git stash drop. Từ giờ nên đặt cài đặt riêng vào sellbird.local.yaml. Ngoài ra, hãy dừng tiến trình Harvey cũ trước khi nâng cấp, vì Sellbird sẽ đợi nếu nó còn chạy trong thư mục.
E.Email vào thư mục spam hoặc bị trả lại
Đây là rủi ro chung của cold email, không riêng công cụ này. README nhấn mạnh dùng tên miền gửi riêng, hộp thư đã warmup, và chỉ gửi tới địa chỉ được xác minh. Hãy đọc tài liệu "Legal and deliverability" trong repo trước khi tăng số lượng.
VII.Có nên dùng không
Điểm mạnh. Nó chạy trên máy bạn và dùng gói Claude hoặc ChatGPT có sẵn, nên không phải trả tiền API theo token. Nguồn tìm khách mặc định miễn phí, bước đọc website không tốn tiền. Cơ chế duyệt thủ công, bước kiểm tra trước khi gửi và lệnh dừng khẩn cấp cho bạn nhiều lớp an toàn. Bạn cũng có thể dừng giữa chừng chỉ lấy danh sách. Repo còn được cập nhật trong 3 tháng gần đây.
Giới hạn. Bạn vẫn phải tự lo hộp thư gửi, tên miền riêng và warmup, và README ghi khoản chi cho hộp thư vào khoảng 7 USD mỗi tháng với Google Workspace. Hướng dẫn trong README nghiêng về macOS và Linux, chưa có lệnh riêng cho Windows. Giấy phép là AGPL-3.0, nếu bạn định tích hợp vào sản phẩm thương mại thì nên đọc kỹ điều khoản. Chất lượng email còn phụ thuộc vào cách bạn mô tả sản phẩm và chọn tín hiệu.
Khi nên chọn cách khác. Nếu bạn không muốn tự vận hành gì cả, tác giả có bản hosted tại sellbird.ai, thiết lập sẵn tên miền gửi, hộp thư và warmup, hiện ở dạng truy cập sớm. Nếu bạn chỉ gửi email thông báo cho khách đã có, một công cụ email marketing thông thường sẽ hợp hơn. Còn nếu bạn muốn thử cold email có kiểm soát, với thời gian bỏ ra tương đối ít, Sellbird là một lựa chọn đáng cân nhắc.
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 là miễn phí, bước đọc website cũng không tốn tiền. 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 nhắc khoảng 7 USD mỗi tháng cho Google Workspace).
Có cần API key của Claude hay OpenAI không?
Không. README nói Sellbird nghĩ qua Claude Code CLI trên gói Claude Pro hoặc Max, hoặc qua Codex trên gói ChatGPT, nên không có API key và không tính theo token. Một số biến khác trong file .env, như khoá dịch vụ kiểm tra email, chỉ cần khi bạn dùng các dịch vụ đó.
Có cần GPU không?
Tư liệu không nhắc tới GPU. Mô hình chạy qua gói Claude hoặc ChatGPT của bạn, chứ không chạy trên máy bạn.
Chạy được trên Windows không?
README có ghi đường dẫn thư mục dữ liệu trên Windows, nhưng các lệnh cài đặt viết cho macOS/Linux và Docker được nói là dùng trên Linux. Chưa có hướng dẫn riêng cho Windows trong README, bạn nên xem tài liệu Troubleshooting và Docker trong thư mục docs của repo.
Nó có tự gửi email mà tôi không biết không?
Không, theo mặc định. Mọi email chờ trong Outbox cho tới khi bạn duyệt hoặc tự bật autopilot. Có thêm bước kiểm tra trước khi gửi, và lệnh sellbird sending pause để dừng ngay mọi thứ.
Dữ liệu của tôi có an toàn không?
README nói Sellbird chạy trên máy của bạn, và cấu hình, dữ liệu nằm trong một thư mục riêng. Bảng điều khiển chạy ở địa chỉ nội bộ 127.0.0.1. Tư liệu không nói gì thêm về chuyện dữ liệu đi qua các dịch vụ bên thứ ba bạn chọn dùng, nên hãy tự xem chính sách của từng dịch vụ.
Sellbird khác gì Harvey?
Đây là cùng một dự án, cùng lịch sử, chỉ đổi tên từ Harvey thành Sellbird ở bản 0.4.0. Cấu hình, dữ liệu và đăng nhập bảng điều khiển đượ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ừ bản mới là AGPL-3.0.


