Sellbird: tự động tìm khách và gửi cold email — 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à nền tảng mã nguồn mở viết bằng Python. Nó tìm công ty hợp với khách hàng của bạn, tìm người quyết định, kiểm tra email, viết cold email riêng cho từng người, gửi đi và xử lý thư trả lời. Nó dùng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có nên không cần API key của mô hình. Cài không quá khó nếu bạn quen terminal, hoặc có thể 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, làm trọn quy trình gửi 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 thư riêng cho từng người, gửi đi rồi xử lý thư trả lời. Dự án trước đây tên là Harvey, nay đổi tên thành Sellbird và vẫn giữ nguyên lịch sử.
Người nên xem là chủ doanh nghiệp nhỏ, nhân viên kinh doanh, người làm marketing hoặc lập trình viên đang cần tìm khách mới mà không muốn trả tiền cho cả bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Theo README, Sellbird không cần những công cụ đó.
Điểm đáng giá nhất có hai ý. Thứ nhất, nó tư duy qua 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 và không tính tiền theo token. Thứ hai, 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.250 sao và 1.127 fork, giấy phép AGPL-3.0. 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 và người quyết định, kiểm tra email, viết và gửi cold email cá nhân hoá, chạy trên gói Claude hoặc ChatGPT của bạn.
I.Sellbird làm được gì
Sellbird là một dây chuyề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 đúng khách hàng của bạn
Nó tìm doanh nghiệp khớp với mô tả 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í. Mỗi lần tìm bằng nguồn trả phí đều hiện chi phí trước khi chạy, nên bạn không bị trừ tiền bất ngờ.
B.Đọc website để biết vì sao 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, hay đang tuyển một vị trí nào đó. Bước này không gọi mô hình, không tốn tiền, chỉ khoảng ba yêu cầu HTTP cho mỗi công ty. Lợi ích là email mở đầu bằng một lý do thật thay vì câu chào 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. Vì lấy từ trang công khai của họ, bạn có thông tin có nguồn rõ ràng.
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 đánh dấu là verified, risky, guess hoặc invalid, và chỉ địa chỉ gửi được mới bị gửi tới. Điều này giúp giảm thư bị trả về, một việc rất quan trọng với tên miền gửi thư 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 đó 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
Sellbird đọc mọi thư trả lời và soạn sẵn câu đáp. Thư tự động trả lời được xếp riêng. Yêu cầu từ chối 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.
G.Chỉ cần danh sách thì xuất CSV
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 nhận được một file CSV sẵn sàng đưa 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 có sẵn bản 3.9, nên nếu
python3 --versionbáo 3.9 thì chạybrew install python@3.13trước. - Claude Pro hoặc Max với Claude Code CLI đã đăng nhập (
claude login), hoặc gói ChatGPT có Codex CLI. - Một hộp thư để gửi đi, tốt nhất 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 gợi ý TrulyInbox. Sellbird đọc tỉ lệ vào hộp thư đến của công cụ này để báo khi nào bạn đã sẵn sàng gửi. Đây là link giới thiệu, người duy trì dự án có thể nhận hoa hồng.
Về chi phí, README nêu: tìm doanh nghiệp bằng nguồn mặc định là 0 đồng, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả. Đọc website là 0 đồng. Hộp thư Google Workspace khoảng 7 USD mỗi tháng. Ngoài ra bạn dùng gói thuê bao Claude hoặc ChatGPT sẵn có.
File .env.example liệt kê các khóa tùy chọn như thông tin Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ kiểm tra email (Reoon, ZeroBounce, Hunter) và TrulyInbox. Bạn chỉ điền cái nào thật sự dùng. Tư liệu không cho biết cần phần cứng đặc biệt nào.
III.Cài đặt từng bước
- Tải mã nguồnClone repo về máy rồi vào thư mục sellbird
- Cách nhanh: nhờ Claude càiMở claude trong thư mục và nói yêu cầu cài đặt
- Hoặc tự càiTạo môi trường ảo và cài gói bằng pip
- Điền thông tinCopy .env.example thành .env rồi điền
- 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
Có hai cách: để Claude Code hướng dẫn bạn, hoặc tự gõ lệnh. Người mới nên thử cách đầu.
A.Tải mã nguồn về máy
Mở terminal (trên Windows là PowerShell hoặc Git Bash, trên macOS là ứng dụng Terminal), đi tới thư mục bạn muốn đặt dự án, rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbirdLệnh đầu tải mã nguồn về. Lệnh thứ hai đi vào thư mục vừa tải. Các lệnh sau đều phải chạy trong thư mục này, đây là chỗ người mới hay quên.
B.Cách nhanh: để Claude cài giúp
Trong thư mục sellbird, gõ:
claudeKhi Claude Code mở, bạn nói: set up Sellbird for me (cài Sellbird giúp tôi). Theo README, file CLAUDE.md trong repo biến Claude Code thành người hướng dẫn: kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi thứ cần hỏi và dạy Sellbird về sản phẩm của bạn. Bạn cần đã đăng nhập Claude CLI trước (claude login).
C.Hoặc tự cài bằng tay
Bước 1 là tạo môi trường ảo và cài gói. Lệnh gốc của README:
# 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 thư mục .venv (môi trường Python riêng), bật nó lên, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau khi xong, bạn có lệnh sellbird. Lệnh source .venv/bin/activate dành cho macOS và Linux. README chưa ghi lệnh bật môi trường ảo riêng cho Windows. Nếu dùng Windows và gặp khó, hãy chọn cách để Claude Code cài giúp ở trên, hoặc xem thêm mục Troubleshooting trong thư mục docs/ của repo.
D.Điền thông tin đăng nhập
# 2. Add credentials. Every variable is documented inline.
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. Mỗi biến đều có chú thích ngay trong file. Điền thông tin hộp thư của bạn (ví dụ Gmail hoặc SMTP). Các khóa của dịch vụ kiểm tra email hay TrulyInbox là tùy chọn. Trên Windows, nếu $EDITOR không chạy, bạn có thể mở file .env bằng Notepad và sửa tay. Tuyệt đối không đăng file .env lên mạng.
E.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 địa chỉ bằng website công ty bạn. Sellbird đọc trang đó để hiểu bạn bán gì rồi ghi vào file sellbird.local.yaml. File này là nơi để đặt cài đặt riêng, git không đụng tới.
F.Xác nhận khách hàng tốt trông như thế nào
# 4. Confirm what makes a good prospect.
sellbird signals --confirm freeBước này để bạn chọn các tín hiệu mua hàng cần dò. Tham số free đúng như README ghi.
G.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.
H.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). sellbird run khởi động vòng lặp làm việc. Hãy để cửa sổ terminal này mở khi đang chạy. 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.
Cold email có luật riêng và hộp thư gửi sai cách có thể bị đánh dấu spam. Hãy đọc tài liệu Legal and deliverability trong thư mục docs của repo trước khi bật gửi thật. Nên dùng tên miền gửi thư riêng và làm warmup như README khuyên.
IV.Kiểm tra đã chạy được chưa
Có ba dấu hiệu theo README:
- Chạy
sellbird --helphoặc các lệnh nhưsellbird dashboardmà không báo lỗi "command not found". Điều đó cho thấy gói đã được cài vào môi trường ảo đang bật. sellbird dashboardin ra một link riêng tớihttp://127.0.0.1:5555. Mở link đó trên trình duyệt sẽ thấy bảng điều khiển.sellbird runin ra dòng "Sellbird is online", kiểm tra trạng thái dây chuyền, rồi báo từng việc như viết chuỗi email hoặc soạn câu trả lời, cuối cùng là "Cycle complete" và nghỉ khoảng 15 phút. README cho ví dụ có dòng kiểu "5 emails waiting for your approval". Thấy email nằm chờ duyệt trong Outbox nghĩa là hệ thống đang làm việc đúng.
Bạn cũng có thể thử với dữ liệu demo. README nói dữ liệu demo là bịa, một công ty tên Bookwell bán phần mềm đặt lịch cho thợ lợp mái, phòng khám nha và tiệm điều hoà, dùng tên miền .test.
V.Dùng vào việc thật
Phần này bám theo những gì README mô tả.
A.Chủ doanh nghiệp nhỏ muốn tìm khách mới
Bạn bán phần mềm đặt lịch hẹn cho cá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" bằng sellbird signals --confirm free, rồi chạy sellbird discover. Sellbird tìm các tiệm phù hợp trên OpenStreetMap, đọc website của họ và đánh dấu tiệm nào đang thiếu đặt lịch. Kết quả là một danh sách khách tiềm năng có lý do cụ thể để liên hệ, chưa tốn đồng nào.
Sellbird không gửi gì đi nếu bạn chưa bấm duyệt. Tự động hoá phần việc nặng, giữ quyền quyết định trong tay mình.
Ông T
B.Nhân viên kinh doanh cần duyệt thư trước khi gửi
Bạn mở dashboard và vào Outbox. Mỗi email chờ duyệt là một thư riêng cho từng người, ví dụ chuỗi hai email nói về việc công ty đang tuyển nhân viên điều phối. Trước khi cho gửi, hệ thống tự kiểm tra, không dùng mô hình, để loại thư còn sót mã điền tự động, cụm từ bị cấm, thư quá dài, thừa link hoặc địa chỉ không gửi được. Bạn đọc, sửa nếu cần rồi duyệt. Thư đi từ hộp thư thật của bạn, trong giới hạn mỗi ngày.
C.Người làm marketing chỉ cần danh sách
Bạn đã có công cụ gửi email riêng nên chỉ cần dữ liệu. Hãy chạy sellbird discover, để Sellbird tìm người quyết định và kiểm tra email, rồi dừng và chạy:
sellbird exportBạn nhận file CSV sẵn sàng nhập vào công cụ gửi khác. Mỗi địa chỉ đã có nhãn verified, risky, guess hoặc invalid để bạn lọc.
D.Người đang chạy Harvey muốn nâng cấp
Nếu trước đây bạn dùng Harvey, README nói cấu hình, dữ liệu và đăng nhập dashboard đều được giữ. Bạn chạy:
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 cơ sở dữ liệu cũ. Nó không ghi đè file đã có tên mới. Nếu bạn sửa trực tiếp file harvey.yaml thì git pull sẽ báo xung đột, README hướng dẫn dùng git stash, git pull, git stash pop.
VI.Lỗi hay gặp và cách xử lý
A.Lệnh sellbird không được nhận
Thường là bạn chưa bật môi trường ảo hoặc chưa chạy bước cài gói. Mở terminal mới, vào thư mục sellbird, bật lại môi trường ảo (trên macOS/Linux dùng source .venv/bin/activate) rồi chạy lại pip install -e .. Trên Windows, README chưa ghi lệnh bật môi trường ảo, hãy xem mục Troubleshooting trong docs/.
B.Python quá cũ
Sellbird cần Python từ 3.11. Trên macOS, lệnh python3 có thể là bản 3.9. Hãy cài bản mới như README gợi ý (brew install python@3.13) rồi dùng python3.13 để tạo môi trường ảo.
C.Claude chưa đăng nhập
Sellbird nghĩ qua Claude Code CLI, nên nếu chưa đăng nhập nó không làm việc được. Chạy claude login và dùng tài khoản Pro hoặc Max. Nếu bạn dùng ChatGPT thì xem hướng dẫn Codex trong thư mục docs/.
D.Git báo local changes would be overwritten khi nâng cấp
Đây là lỗi người dùng Harvey cũ hay gặp nếu đã sửa harvey.yaml. Làm theo README: git stash, git pull, rồi git stash pop. Nếu có xung đột, giữ các dòng của bạn, xoá các dấu xung đột rồi chạy git stash drop. Từ nay hãy đặt cài đặt riêng trong sellbird.local.yaml.
E.Email vào spam hoặc bị trả về nhiều
Tư liệu không liệt kê lỗi cụ thể, nhưng đây là rủi ro rất dễ gặp với cold email. Hãy dùng tên miền gửi thư riêng, làm warmup trước khi gửi, chỉ gửi tới địa chỉ verified và giữ chế độ duyệt tay. Nếu cần dừng gấp, README ghi lệnh sellbird sending pause sẽ dừng mọi thứ ngay.
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 nếu bạn đã có gói Claude hoặc ChatGPT. Dữ liệu chạy trên máy bạn. Mặc định phải duyệt tay trước khi gửi, lại có bước kiểm tra tự động không dùng mô hình để chặn thư lỗi. Có bảng điều khiển, xuất CSV, và mã nguồn mở nên bạn đọc và sửa được các prompt và kỹ năng bán hàng.
Giới hạn. Bạn phải tự lo hộp thư gửi, tên miền và warmup. Cài đặt cần quen dòng lệnh, và ví dụ trong README viết theo hướng macOS/Linux. Nguồn tìm miễn phí dựa trên OpenStreetMap nên phù hợp nhất với doanh nghiệp địa phương. Tư liệu không nói độ phủ dữ liệu ở Việt Nam. Giấy phép AGPL-3.0 có điều kiện riêng nếu bạn định tích hợp vào sản phẩm khác.
Khi nên chọn cách khác. Nếu bạn không muốn tự vận hành, README nói có bản hosted tại sellbird.ai, đang ở giai đoạn early access, có sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ gửi vài email thủ công mỗi tuần thì một công cụ đơn giản là đủ. Và nếu bạn không rõ quy định gửi thư thương mại ở thị trường của người nhận, hãy tìm hiểu trước khi bật chế độ tự động.
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. README nói không có hoá đơn API cho mô hình vì nó dùng gói Claude Pro/Max hoặc ChatGPT bạn đã có. Nguồn tìm doanh nghiệp mặc định là 0 đồng, còn hộp thư gửi (ví dụ Google Workspace khoảng 7 USD mỗi tháng) là chi phí của bạn.
Có cần API key của Claude hay OpenAI không?
Không. README ghi rõ Sellbird nghĩ qua Claude Code CLI hoặc Codex trên gói thuê bao, không dùng API key và không tính theo token. Một số dịch vụ tuỳ chọn như kiểm tra email có biến khoá riêng trong file .env.example.
Cần GPU hay máy mạnh không?
Tư liệu không nêu yêu cầu phần cứng đặc biệt, và phần suy nghĩ chạy qua Claude hoặc Codex chứ không chạy mô hình tại máy. Bạn chỉ cần Python 3.11 trở lên.
Chạy được trên Windows không?
README có nhắc thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt được viết theo hướng macOS/Linux và README chưa ghi lệnh bật môi trường ảo cho Windows. Bạn có thể thử để Claude Code cài giúp hoặc xem mục Troubleshooting trong thư mục docs của repo.
Email có bị gửi đi mà tôi không biết không?
Mặc định thì không. Mọi email đều nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật autopilot. Ngay cả khi bật, các thư có link tới tên miền không phải của bạn vẫn bị giữ lại, và lệnh sellbird sending pause dừng mọi thứ ngay.
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, cấu hình, kiến thức và dữ liệu nằm trong một thư mục home. Tư liệu không bàn thêm về bảo mật chi tiết. Nếu thấy lỗ hổng, repo yêu cầu làm theo SECURITY.md thay vì mở issue công khai.
Sellbird khác gì Harvey?
Là cùng một dự án, cùng lịch sử, chỉ đổi tên từ phiên bản 0.4.0. Cấu hình, dữ liệu và đăng nhập dashboard được giữ khi nâng cấp. Lệnh harvey cũ vẫn chạy tạm thời nhưng sẽ bị bỏ ở bản sau.


