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
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 mã nguồn mở viết bằng Python, giúp bạn tìm công ty phù hợp, tìm người quyết định, xác minh email, viết và gửi cold email rồi xử lý phản hồi. Nó chạy trên máy của bạn và dùng gói Claude Pro/Max hoặc ChatGPT (Codex) có sẵn, không cần API key của mô hình. Cài bằng vài lệnh, hoặc nhờ Claude Code cài giúp.
Sellbird là một nền tảng mã nguồn mở chạy trên máy của bạn, tự động hoá cả quy trình bán hàng qua email lạnh (cold email): tìm công ty cần thứ bạn bán, tìm người quyết định, kiểm tra địa chỉ email, viết email riêng cho từng người, gửi đi rồi xử lý các phản hồi. Repo trước đây tên Harvey, nay đã đổi thành Sellbird nhưng vẫn là cùng một dự án, cùng lịch sử.
Bạn nên xem qua nếu bạn là chủ doanh nghiệp nhỏ, người làm sale, làm marketing hoặc lập trình viên cần một danh sách khách tiềm năng và muốn tiếp cận họ mà không phải trả tiền cho một loạt công cụ prospecting. Điểm đáng giá nhất là 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. Vì vậy không có API key mô hình và không bị tính tiền theo token.
Điểm an toàn thứ hai cũng quan trọng: mặc định không có email nào được gửi đi nếu bạn chưa duyệt. Hiện repo có khoảng 5.249 sao và 1.127 fork, và vẫn được cập nhật trong vài tháng gần đây. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi cài.
ethanplusai/sellbird
Nền tảng mã nguồn mở tìm công ty, tìm người ra quyết định, xác minh email, viết và gửi cold email cá nhân hoá, 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 (pipeline). Bạn chạy trọn từ đầu đến cuối, hoặc dừng ở bước nào tuỳ ý.
A.Tìm công ty phù hợp
Nó tìm 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. Nhờ vậy bạn không bị "cháy túi" ngoài ý muốn.
B.Đọc tín hiệu mua hàng
Sellbird đọc website của từng công ty để tìm những dấu hiệu 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ì mỗi công ty chỉ cần ba request HTTP. Kết quả là email của bạn có chi tiết thật để nhắc tới, thay vì câu chào chung chung.
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 trang web của công ty, tối đa hai người mỗi công ty. Bạn gửi đúng người có quyền gật đầu.
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ỉ có thể nhận được thư mới được gửi tới. Việc này giúp bảo vệ uy tín hộp thư gửi của bạn.
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 đó 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à theo giờ làm việc của người nhận.
F.Xử lý phản hồi
Nó đọc từng phản hồi, soạn sẵn câu trả lời, tách riêng thư trả lời tự động, tôn trọng yêu cầu từ chối nhận thư ngay lập tức. Những thứ không nên tự trả lời, nó 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 và chạy sellbird export để lấy file CSV có thể đư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.toml cũng yêu cầu Python từ 3.11. README lưu ý macOS có sẵn Python 3.9, nên nếu
python3 --versionbáo 3.9, hãy chạybrew install python@3.13trước. - 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, cách thiết lập nằm trong tài liệu Codex 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 dùng được.
- Warmup (làm nóng) hộp thư đó. Tác giả giới thiệu TrulyInbox, và Sellbird đọc được tỷ lệ vào hộp thư chính của dịch vụ này để báo bạn khi nào đã sẵn sàng. Đây là liên kết affiliate của người duy trì dự án, README có nói rõ.
Giấy phép là AGPL-3.0. Các bản Harvey đến 0.3.x trước đó dùng giấy phép MIT.
Trong tệp .env.example có nhiều biến tuỳ chọn, như thông tin Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ xác minh email (Reoon, ZeroBounce, Hunter)… Bạn không cần điền hết. Chỉ điền phần dịch vụ bạn thật sự dùng.
III.Cài đặt từng bước
- Lấy mã nguồngit clone repo rồi cd vào thư mục sellbird
- Cách nhanh: nhờ Claude càimở claude trong thư mục và nói "set up Sellbird for me"
- Hoặc cài thủ côngtạo môi trường ảo và pip install -e .
- Điền thông tinsao chép .env.example thành .env rồi sửa
- Huấn luyện và tìm kháchchạy sellbird train, signals, discover
- Mở bảng điều khiểnchạy sellbird dashboard và sellbird run
A.Lấy mã nguồn
Mở terminal (trên Windows là PowerShell hoặc Git Bash, trên macOS là Terminal) rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbirdLệnh đầu tải repo về máy. Lệnh thứ hai đi vào thư mục vừa tải. Mọi lệnh sau đều chạy trong thư mục này. Chỗ người mới hay vấp là chạy lệnh ở sai thư mục.
B.Cách nhanh: để Claude cài giúp
Nếu bạn đã có Claude Code, chỉ cần mở nó ngay trong thư mục vừa tải:
claudeSau đó gõ câu: set up Sellbird for me. 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 thông tin cần và huấn luyện Sellbird về sản phẩm của bạn. Với người mới, đây là đường dễ nhất.
C.Hoặc tự cài thủ công
README đưa ra các lệnh sau (chú thích bằng dấu # là của tác giả):
# 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 .
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .env
# 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 free
# 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 runGiải thích từng bước:
- Bước 1 tạo một môi trường Python riêng tên
.venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được (pip install -e .). Lệnh này tạo ra lệnhsellbird. README dùng cú pháp của macOS/Linux. README chưa ghi lệnh kích hoạt riêng cho Windows, nên người dùng Windows hãy xem thêm mục Troubleshooting trong thư mụcdocs/của repo. - Bước 2 sao chép file mẫu thành
.envrồi mở ra để sửa. Đây là nơi bạn điền thông tin hộp thư và các dịch vụ bạn dùng. Mỗi biến có chú thích ngay trong file. Trên Windows,$EDITORcó thể không có sẵn, bạn cứ mở file.envbằng Notepad cũng được. - Bước 3 cho Sellbird đọc website của bạn để hiểu bạn bán gì. Kết quả ghi vào
sellbird.local.yaml. Hãy thay địa chỉ mẫu bằng website thật của bạn. - Bước 4 xác nhận những tín hiệu cho thấy một công ty là khách tốt.
- Bước 5 tìm doanh nghiệp. Nguồn mặc định miễn phí, không cần tài khoản.
- Bước 6 mở bảng điều khiển (lệnh in ra một đường link riêng tư tới địa chỉ 127.0.0.1:5555, chỉ truy cập được từ máy bạn), rồi bật vòng lặp chính bằng
sellbird run.
Trên Linux bạn cũng có thể chạy bằng Docker. Repo có Dockerfile và docker-compose.yml. Hướng dẫn chi tiết nằm trong tài liệu Docker của repo.
Mặc định Sellbird không gửi gì khi bạn chưa duyệt. Hãy giữ nguyên chế độ này cho đến khi bạn đã đọc kỹ email nháp, đã warmup hộp thư xong và hiểu quy định gửi email thương mại ở nước bạn. Mật khẩu hộp thư nằm trong file .env, đừng chia sẻ file này hay đưa nó lên GitHub.
IV.Kiểm tra đã chạy được chưa
Theo README, bạn biết mình đã chạy được khi:
- Lệnh
sellbird dashboardin ra một đường link riêng tư dạnghttp://127.0.0.1:5555. Mở link đó trong trình duyệt trên cùng máy sẽ thấy bảng điều khiển. - Lệnh
sellbird runhiện dòng "Sellbird is online.", kiểm tra trạng thái dây chuyền, đưa ra quyết định (ví dụ viết chiến dịch cho các khách mới chưa có email nháp), rồi báo có bao nhiêu email đang chờ bạn duyệt trong Outbox. Sau đó nó nghỉ 15 phút rồi lặp lại. - Sau
sellbird discover, bạn thấy danh sách doanh nghiệp xuất hiện trong bảng điều khiển.
Nếu lệnh sellbird báo không tìm thấy, thường là môi trường ảo chưa được kích hoạt hoặc bước pip install -e . chưa chạy xong. Xem thêm phần lỗi hay gặp bên dưới.
V.Dùng vào việc thật
README dùng dữ liệu mẫu hoàn toàn bịa là 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 điện lạnh, trên các tên miền .test. Bạn có thể hình dung theo đó.
A.Chủ phần mềm quản lý lịch hẹn muốn có danh sách khách
Bạn bán phần mềm đặt lịch cho các cơ sở dịch vụ nhỏ và chỉ cần danh sách khách tiềm năng, chưa muốn gửi mail tự động. Bạn huấn luyện Sellbird bằng website của mình, xác nhận tín hiệu, tìm doanh nghiệp, rồi xuất file:
sellbird train https://your-company.com
sellbird signals --confirm free
sellbird discover
sellbird exportKết quả là một file CSV các công ty, người quyết định và địa chỉ email đã được gắn nhãn verified, risky, guess hoặc invalid. Bạn đưa file này vào công cụ gửi mail bạn đang dùng. Chi phí của bước tìm kiếm là 0 đồng với nguồn mặc định.
Sellbird không bắt bạn tin vào máy: mọi email đều nằm chờ bạn duyệt trước khi rời đi.
Ông T
B.Nhân viên sale B2B chạy cả quy trình
Bạn làm sale cho một công ty phần mềm, đã có hộp thư Google Workspace trên tên miền gửi riêng và đã warmup. Bạn chạy đủ các bước, rồi mở bảng điều khiển bằng sellbird dashboard và bật vòng lặp bằng sellbird run. Mỗi chu kỳ, Sellbird viết chuỗi email ngắn, ví dụ hai email nhắc tới việc một công ty đang tuyển nhân viên điều phối. Các email này nằm trong Outbox. Bạn đọc, sửa nếu cần, rồi duyệt. Khi có phản hồi, nó soạn sẵn câu trả lời, bạn chỉ cần xem và quyết định.
C.Lập trình viên muốn kiểm soát và tuỳ biến
Bạn là dev và muốn chỉnh cách Sellbird viết email. Repo có thư mục prompts/ và skills/, README mô tả đó là các kịch bản bán hàng có thể chỉnh sửa. Bạn sửa các file này theo giọng văn của mình. Nếu cần thêm tính năng, tài liệu Extensions cho biết cách thêm route, bước trong vòng lặp hoặc lệnh từ một gói riêng. Khi muốn dừng khẩn cấp, bạn chạy:
sellbird sending pauseLệnh này dừng toàn bộ việc gửi ngay lập tức.
D.Người đang dùng Harvey muốn nâng cấp
Nếu bạn từng chạy Harvey, cấu hình, dữ liệu và đăng nhập bảng điều khiển vẫn dùng tiếp được. README hướng dẫn:
git pull
pip install -e . # once, to get the new `sellbird` command
sellbird dashboardLần chạy đầu, Sellbird tự đổi tên harvey.local.yaml thành sellbird.local.yaml và đổi tên file dữ liệu. Nó không ghi đè file đã có tên mới. Nó cũng đợi nếu vẫn còn tiến trình Harvey đang chạy trong thư mục, nên hãy tắt tiến trình đó trước.
VI.Lỗi hay gặp và cách xử lý
A.Python quá cũ, cài đặt báo lỗi
Trên macOS, lệnh python3 có thể là bản 3.9, trong khi Sellbird cần 3.11 trở lên. Hãy chạy python3 --version để kiểm tra. Nếu thấy 3.9, cài bản mới bằng brew install python@3.13 rồi dùng python3.13 để tạo môi trường ảo như README ghi.
B.Gõ sellbird báo không tìm thấy lệnh
Thường do môi trường ảo chưa được kích hoạt, hoặc bước cài đặt chưa hoàn tất. Mở terminal mới, cd vào thư mục repo, kích hoạt lại môi trường ảo rồi chạy lại pip install -e .. Nhớ rằng lệnh sellbird chỉ có sau khi cài xong.
C.Claude chưa đăng nhập nên không chạy được
Sellbird dùng Claude Code CLI trên gói của bạn. Nếu CLI chưa đăng nhập, nó sẽ không làm việc được. Hãy chạy claude login và đăng nhập đúng tài khoản có gói Pro hoặc Max. Nếu bạn dùng ChatGPT, hãy làm theo tài liệu Codex trong repo.
D.git pull báo "your local changes would be overwritten"
Lỗi này xảy ra với người nâng cấp từ Harvey đã sửa trực tiếp file harvey.yaml. Cách xử lý theo README: chạy git stash, rồi git pull, rồi git stash pop. Nếu báo xung đột trong sellbird.yaml, hãy giữ các dòng của bạn, xoá các dấu xung đột, rồi chạy git stash drop. Về lâu dài, nên để thiết lập riêng trong sellbird.local.yaml vì git không đụng tới file này.
E.Email gửi đi bị vào thư rác hoặc bị chặn
Đây là rủi ro chung của cold email, không riêng Sellbird. Hãy đảm bảo hộp thư đã được warmup, gửi từ tên miền riêng, và giữ giới hạn gửi mỗi ngày thấp. Đọc thêm tài liệu Legal and deliverability của repo. Nếu nghi ngờ, chạy sellbird sending pause để dừng rồi kiểm tra lại.
VII.Có nên dùng không
Điểm mạnh. Bạn không phải trả tiền API mô hình, vì nó dùng gói Claude hoặc ChatGPT sẵn có. Bước tìm doanh nghiệp và đọc website có thể tốn 0 đồng. Dữ liệu nằm trên máy bạn. README cũng nói rõ không cần các công cụ prospecting như Apollo, ZoomInfo, Clearbit hay Clay. Cơ chế an toàn khá chặt: mặc định phải duyệt từng email, có bước kiểm tra trước khi gửi không dùng mô hình (chặn thẻ chưa điền, cụm từ bị cấm, email quá dài, link thừa, địa chỉ không gửi được), và có lệnh dừng khẩn cấp.
Giới hạn. Bạn vẫn cần tự lo hộp thư gửi, tên miền riêng và warmup. Tôi không thấy tài liệu nói về dữ liệu doanh nghiệp tại Việt Nam. Nguồn mặc định là OpenStreetMap nên độ phủ phụ thuộc vào dữ liệu có trên bản đồ ở khu vực bạn nhắm tới. README viết bằng tiếng Anh và ví dụ hướng tới thị trường nói tiếng Anh. Việc viết email tiếng Việt chất lượng ra sao thì README chưa nói, bạn nên thử với vài liên hệ trước. Giấy phép AGPL-3.0 cũng có điều khoản riêng nếu bạn định biến nó thành dịch vụ cho người khác. Hãy đọc kỹ trước khi làm vậy. Ngoài ra, gửi email thương mại có quy định pháp lý ở từng quốc gia, bạn tự chịu trách nhiệm tuân thủ.
Khi nào chọn cách khác. Nếu bạn không muốn tự vận hành, tác giả có bản chạy sẵn trên sellbird.ai (đang ở giai đoạn truy cập sớm), lo sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ cần gửi vài chục email thủ công, một công cụ quen thuộc như bảng tính cộng hộp thư thường là đủ. Còn nếu bạn thoải mái với dòng lệnh và muốn kiểm soát toàn bộ quy trình, Sellbird là lựa chọn đáng thử.
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. Nguồn tìm doanh nghiệp mặc định miễn phí và việ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 nêu 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 chạy 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ụ tuỳ chọn như xác minh email thì có biến API key riêng trong .env.example.
Sellbird có tự gửi email mà tôi không biết không?
Mặc định thì không. Mọi email đều chờ trong Outbox cho đến khi bạn duyệt, trừ khi bạn tự bật chế độ autopilot. Trước khi gửi còn có bước kiểm tra không dùng mô hình, và lệnh `sellbird sending pause` dừng mọi việc gửi ngay lập tức.
Có cần GPU không? Chạy trên Windows được không?
README không nhắc yêu cầu GPU, vì phần suy nghĩ do Claude hoặc Codex đảm nhiệm. README có nêu thư mục dữ liệu trên Windows (trong APPDATA) nên Windows được hỗ trợ ở mức nào đó. Tuy nhiên README chỉ ghi lệnh kích hoạt môi trường ảo cho macOS/Linux, và Docker được nói là dành cho Linux.
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, nhật ký nằm trong một thư mục riêng. Bảng điều khiển mở ở địa chỉ 127.0.0.1 với đường link riêng tư. Với việc gửi email, bạn vẫn phải tự giữ an toàn cho file .env chứa mật khẩu hộp thư.
Sellbird khác gì Harvey?
Là cùng một dự án, cùng lịch sử, được đổi tên từ Harvey sang 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ữ lại khi nâng cấp. Lệnh `harvey` cũ vẫn chạy tạm thời nhưng sẽ bị gỡ ở bản sau.
Có dùng được cho thị trường Việt Nam không?
Chưa có thông tin rõ trong README. Ví dụ và dữ liệu mẫu hướng tới thị trường nói tiếng Anh, và nguồn tìm mặc định là OpenStreetMap nên độ phủ phụ thuộc vào dữ liệu bản đồ. Bạn nên thử nhỏ trước khi dùng thật.


