Sellbird: tự tìm khách, viết 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, 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ý thư trả lời. Nó dùng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có, không cần API key của mô hình. Cài bằng vài lệnh, nhưng cần thêm hộp thư gửi riêng và bước khởi động (warmup) cho hộp thư đó.
Sellbird là một nền tảng mã nguồn mở chạy ngay trên máy của bạn, làm trọn chuỗi việc bán hàng chủ động qua 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 từng email riêng cho từng người, gửi đi và xử lý thư trả lời. Dự án trước đây tên là Harvey, nay đổi tên thành Sellbird. Hiện có khoảng 5.249 sao và 1.127 fork trên GitHub.
Bạn nên xem qua nếu đang làm kinh doanh nhỏ, làm sale, làm agency hoặc tự bán dịch vụ, và muốn tiếp cận khách mới mà không phải trả tiền cho cả bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. README nói rõ Sellbird không dùng các công cụ đó.
Điểm đáng giá nhất là chuyện chi phí mô hình AI. Sellbird "suy nghĩ" thông 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. Không có API key mô hình, không tính tiền theo token. Điểm thứ hai là mặc định không có email nào được gửi đi nếu bạn chưa duyệt. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi bắt tay cài.
ethanplusai/sellbird
Sellbird tìm công ty và người ra quyết định, kiểm tra email, viết cold email cá nhân hoá rồi gửi và xử lý thư trả lời, chạy bằng gói Claude hoặc ChatGPT.
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.
- Tìm công ty. Tìm doanh nghiệp giống khách hà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 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ờ.
- Hiểu 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 và không tốn tiền, chỉ gửi ba yêu cầu HTTP cho mỗi công ty. README nói có 29 tín hiệu.
- Tìm người quyết định. 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. Email của bạn nhờ vậy gửi đúng người thay vì một hộp thư chung.
- Kiểm tra địa chỉ email. Sellbird học kiểu địa chỉ email của công ty và 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 dùng để gửi. Việc này giúp hạn chế thư trả về và bảo vệ uy tín hộp thư của bạn.
- Viết và gửi. 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 đó 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.
- Xử lý thư trả lời. Đọc mọi thư trả lời, soạn sẵn câu đáp, tách riêng 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, và chuyển cho bạn những thư nó không nên tự trả lời.
- Xuất danh sách. Nếu bạn chỉ cần danh sách khách, hãy dừng sau bước kiểm tra email rồi chạy
sellbird exportđể có file CSV dùng được ngay với công cụ gửi mail khác.
Ngoài ra có một bảng điều khiển (dashboard) chạy trên máy bạn, và có hộp Outbox để duyệt từng email trước khi gửi.
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 Python từ 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. - Claude Pro hoặc Max, đã đăng nhập Claude Code 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 chạy được.
- Khởi động (warmup) 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à liên kết tiếp thị liên kết, tác giả có thể nhận hoa hồng. Sellbird đọc tỷ lệ vào hộp thư đến từ TrulyInbox để báo bạn khi nào đã sẵn sàng.
- Git, để tải mã nguồn về.
Về phần cứng, tư liệu không nêu yêu cầu cụ thể, và không thấy nhắc đến GPU vì phần suy nghĩ chạy qua gói Claude hoặc ChatGPT của bạn. Về hệ điều hành, README có bảng thư mục dữ liệu cho macOS, Windows và Linux. Docker thì README chỉ nói dùng được trên Linux.
Sellbird gửi email thật từ hộp thư thật của bạn. Hãy dùng tên miền gửi riêng, không dùng hộp thư chính của công ty. Đừng dán mật khẩu hay key vào chỗ nào ngoài file .env trên máy bạn.
III.Cài đặt từng bước
Có hai đường: nhờ Claude Code hướng dẫn cài, hoặc tự gõ lệnh. Bạn chọn một.
- 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 Python và chạy pip install -e .
- Điền thông tinSao chép .env.example thành .env rồi điền thông tin hộp thư
- Dạy Sellbird về sản phẩmChạy sellbird train với địa chỉ website của bạn
- Tìm kháchXác nhận tín hiệu rồi chạy sellbird discover
- Mở bảng điều khiểnChạy sellbird dashboard và sellbird run
A.Tải mã nguồn về máy
Mở terminal (trên Windows là PowerShell hoặc Git Bash) ở thư mục bạn muốn lưu dự án, rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbirdLệnh đầu tải mã về, lệnh thứ hai đi vào thư mục vừa tải. Mọi lệnh sau đều phải chạy trong thư mục sellbird này. Đây là chỗ người mới hay vấp nhất: mở terminal mới là về lại thư mục khác.
B.Cách 1: để Claude Code cài giúp
Nếu bạn đã có Claude Code, chỉ cần chạy tiếp:
claudeRồi gõ câu: "set up Sellbird for me". File CLAUDE.md trong 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 thông tin cần thiết và dạy Sellbird về sản phẩm của bạn. Với người mới, đây là cách dễ nhất.
C.Cách 2: tự cài, bước 1 và 2 — cài đặt và điền thông tin
Đây là các lệnh nguyên văn trong 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 .
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .envLệnh đầu tạo một môi trường ảo tên .venv (một "hộp" riêng cho gói Python), bật nó lên, rồi cài Sellbird vào đó. Lệnh source .venv/bin/activate là cú pháp của macOS và Linux. README chưa ghi lệnh bật môi trường ảo riêng cho Windows, nên nếu dùng Windows bạn có thể tham khảo mục Troubleshooting trong thư mục docs/ hoặc cách 1 ở trên.
Lệnh thứ hai chép file mẫu .env.example thành .env rồi mở ra để bạn sửa. File này chứa các biến như GMAIL_CLIENT_ID, SMTP_HOST, REOON_API_KEY, HUNTER_API_KEY, TRULYINBOX_API_KEY. README nói mỗi biến đều có giải thích ngay trong file. Bạn chỉ cần điền phần mình dùng, ví dụ thông tin hộp thư gửi. Các key của dịch vụ trả phí là tuỳ chọn, bạn có thể bỏ trống nếu không dùng.
D.Bước 3 và 4 — 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 sellbird 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 địa chỉ trang web thật của bạn. Lệnh sellbird signals --confirm free để bạn xác nhận thế nào là một khách tiềm năng tốt. Hãy làm kỹ bước này vì các tín hiệu mua hàng quyết định danh sách khách sau đó.
E.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. Lệnh này tìm các doanh nghiệp hợp với khách hàng bạn đã mô tả.
F.Bước 6 — mở bảng điều khiển và chạy
# 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 http://127.0.0.1:5555. Địa chỉ này chỉ mở được trên máy bạn. sellbird run bật vòng lặp làm việc. Mỗi chu kỳ nó kiểm tra trạng thái, viết email, soạn câu trả lời, rồi nghỉ 15 phút theo ví dụ trong README. Bạn nên mở hai cửa sổ terminal, một cho dashboard và một cho run.
Nếu dùng Linux, README nói bạn cũng có thể chạy bằng Docker. Repo có Dockerfile và docker-compose.yml, còn hướng dẫn chi tiết nằm trong tài liệu Docker của repo.
IV.Kiểm tra đã chạy được chưa
Có ba dấu hiệu để biết cài thành công:
python3 --version(hoặcpython3.13 --version) báo từ 3.11 trở lên.- Sau
pip install -e ., lệnhsellbirdcó thể gọi được trong terminal. sellbird dashboardin ra link riêng và bạn mở được trang ởhttp://127.0.0.1:5555.
Khi chạy sellbird run, README mô tả màn hình sẽ hiện dòng "Sellbird is online", rồi "Checking pipeline state...", sau đó là một quyết định như write_campaign, và cuối cùng là "Cycle complete. Sleeping for 15 minutes." Dòng outbox → 5 emails waiting for your approval nghĩa là email đã được viết và đang chờ bạn duyệt. Chưa có gì bị gửi đi.
Với dữ liệu thật, bạn sẽ thấy các công ty và người liên hệ xuất hiện trong dashboard sau khi chạy sellbird discover.
V.Dùng vào việc thật
Bạn có thể dùng Sellbird theo nhiều cách. Dưới đây là bốn tình huống bám đúng khả năng của repo.
A.Chủ một dịch vụ địa phương muốn tìm khách mới
Chị Hà có một xưởng làm phần mềm đặt lịch cho tiệm làm đẹp và phòng khám nhỏ. Chị chạy sellbird train với địa chỉ website của mình để Sellbird hiểu sản phẩm. Sau đó chị xác nhận các tín hiệu như "chưa có đặt lịch online" bằng sellbird signals --confirm free, rồi chạy sellbird discover. Kết quả là một danh sách doanh nghiệp phù hợp, kèm lý do vì sao họ có thể cần sản phẩm. README lấy ví dụ tương tự: bản demo bán phần mềm đặt lịch cho thợ lợp mái, phòng nha và tiệm điều hoà.
Lưu ý README mô tả nguồn mặc định là OpenStreetMap. Độ phủ dữ liệu ở Việt Nam thế nào thì tư liệu chưa nói, nên bạn hãy thử với một nhóm nhỏ trước.
B.Nhân viên sale chỉ cần một danh sách sạch
Anh Nam làm sale cho một công ty B2B và đã có sẵn công cụ gửi mail. Anh không muốn Sellbird gửi gì cả. Anh chạy các bước tìm công ty, tìm người quyết định và kiểm tra email, rồi dùng:
sellbird exportLệnh này xuất file CSV có đủ những gì Sellbird tìm được, sẵn sàng đưa vào công cụ gửi mail của anh. Mỗi địa chỉ đã có nhãn verified, risky, guess hoặc invalid, nên anh có thể lọc bỏ địa chỉ không đáng tin trước khi gửi.
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
C.Chủ shop muốn duyệt từng email trước khi gửi
Chị Lan bán sỉ vật tư và chưa tin hẳn vào email do AI viết. Chị mở sellbird dashboard, vào hộp Outbox và đọc từng email đang chờ. Mỗi email đều đã qua bước kiểm tra trước khi gửi, không dùng mô hình, loại bỏ các trường chưa điền, cụm từ bị cấm, email quá dài, link thừa và địa chỉ không gửi được. Chị đọc, sửa nếu cần rồi mới duyệt. Chỉ khi chị tự bật chế độ autopilot thì Sellbird mới gửi mà không cần duyệt. Ngay cả khi đó, nó vẫn giữ lại email có link tới tên miền không phải của chị.
Nếu có chuyện bất ngờ, một lệnh sau đây dừng toàn bộ việc gửi:
sellbird sending pauseD.Lập trình viên đang dùng Harvey cũ
Một lập trình viên đã chạy Harvey từ trước chỉ cần cập nhật. Cấu hình, dữ liệu và đăng nhập dashboard đều được giữ nguyê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à data/harvey.db thành data/sellbird.*. Các biến HARVEY_* vẫn dùng được khi chưa có biến SELLBIRD_* tương ứng. Nếu bạn từng sửa trực tiếp file harvey.yaml thì git pull sẽ báo lỗi, xem phần lỗi bên dưới.
VI.Lỗi hay gặp và cách xử lý
A.Báo Python 3.9 hoặc không cài được
Trên macOS, python3 trần thường là bản 3.9, thấp hơn mức 3.11 mà dự án yêu cầu. Hãy chạy brew install python@3.13, rồi dùng đúng python3.13 khi tạo môi trường ảo, như README dặn. Kiểm tra lại bằng python3.13 --version.
B.Claude Code hoặc Codex chưa đăng nhập
Sellbird không có API key mô hình, nó dựa vào CLI đã đăng nhập. Nếu Claude Code chưa đăng nhập, bạn chạy claude login rồi thử lại. Nếu dùng ChatGPT, hãy làm theo hướng dẫn "Using a ChatGPT plan (Codex)" trong thư mục docs/ của repo.
C.git pull báo "your local changes would be overwritten"
Lỗi này xảy ra khi bạn từng sửa trực tiếp harvey.yaml rồi nâng cấp. README hướng dẫn chạy git stash, git pull, rồi git stash pop. Git sẽ chuyển chỉnh sửa của bạn sang sellbird.yaml. Nếu báo 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. Cách tốt hơn là đặt thiết lập riêng vào sellbird.local.yaml, file mà git không đụng tới.
D.Email không được gửi dù đã viết xong
Có thể do email chưa được duyệt trong Outbox, hoặc địa chỉ người nhận bị đánh dấu risky, guess hoặc invalid. Sellbird chỉ gửi đến địa chỉ gửi được. Hãy mở dashboard, xem Outbox và nhãn của từng địa chỉ. Đừng ép gửi tới địa chỉ không đáng tin vì sẽ làm hỏng uy tín hộp thư.
E.Đổi tên từ Harvey nhưng tiến trình cũ vẫn chạy
README cho biết Sellbird sẽ chờ nếu vẫn còn một tiến trình Harvey đang chạy từ thư mục đó. Hãy dừng tiến trình cũ trước, rồi chạy lại. Nếu dùng Docker, tên dịch vụ nay là sellbird: chạy docker compose down, git pull, docker compose build, rồi docker compose up -d.
Với các lỗi khác, README trỏ tới tài liệu Troubleshooting trong thư mục docs/ của repo.
VII.Có nên dùng không
Điểm mạnh. Không tốn tiền API mô hình vì dùng gói bạn đang có. Bước tìm công ty mặc định miễn phí, bước đọc website cũng miễn phí. Mọi thứ chạy trên máy bạn, dữ liệu nằm trong một thư mục của bạn. Cơ chế an toàn khá rõ: mặc định phải duyệt, có kiểm tra trước khi gửi, có lệnh dừng khẩn cấp. Repo vẫn được cập nhật trong 3 tháng gần đây.
Giới hạn. Bạn vẫn phải có hộp thư gửi, nên có tên miền riêng, và phải warmup trước khi gửi. README nói rõ điều này, còn chi phí hộp thư theo README khoảng 7 đô la mỗi tháng cho Google Workspace. Việc tìm doanh nghiệp, tìm người quyết định và tín hiệu mua hàng đều dựa vào dữ liệu công khai, nên chất lượng sẽ khác nhau theo ngành và theo nước. Tư liệu không nói gì cụ thể về độ phủ ở thị trường Việt Nam. Giấy phép là AGPL-3.0, bạn nên đọc kỹ nếu định tích hợp vào sản phẩm thương mại.
Pháp lý. Gửi cold email chịu ràng buộc theo luật ở nơi bạn và người nhận. README có tài liệu "Legal and deliverability" nói về quy tắc gửi mail, bạn nên đọc trước khi bật chế độ tự động.
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, hiện đang trong giai đoạn truy cập sớm. Nếu bạn chỉ gửi vài email mỗi tuần thì cài cả hệ thống này có thể là quá nhiều. Nếu bạn không dùng Python hay terminal, hãy bắt đầu bằng cách 1, để Claude Code dẫn từng bước.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Mã nguồn miễn phí, theo giấy phép AGPL-3.0. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex, và một hộp thư để gửi, ví dụ Google Workspace khoảng 7 đô la mỗi tháng theo README. Nguồn tìm doanh nghiệp mặc định là miễn phí, nguồn trả phí sẽ hiện chi phí trước khi chạy.
Có cần API key của Claude hay OpenAI không?
Không. README nói Sellbird dùng Claude Code CLI trên gói Claude Pro hoặc Max, hoặc Codex trên gói ChatGPT, không có API key và không tính tiền theo token. Bạn chỉ cần đăng nhập CLI (`claude login`).
Có cần GPU không?
Tư liệu không nhắc đến yêu cầu GPU. Phần suy nghĩ chạy qua gói Claude hoặc ChatGPT của bạn, nên không có mô hình nào chạy trên máy bạn.
Chạy được trên Windows không?
README có ghi thư mục dữ liệu cho Windows (`%APPDATA%\sellbird`), nhưng lệnh bật môi trường ảo trong README viết cho macOS và Linux. Docker chỉ được nhắc cho Linux. Bạn có thể cho Claude Code hướng dẫn cài (cách 1) hoặc xem tài liệu Troubleshooting trong 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 cho đến khi bạn duyệt, trừ khi bạn tự bật autopilot. Lệnh `sellbird sending pause` dừng toàn bộ việc gửi ngay lập tức.
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 riêng, và dashboard chỉ mở ở địa chỉ 127.0.0.1. Tư liệu không nói thêm về các chi tiết bảo mật khác, nên bạn nên xem tệp SECURITY.md trong repo.
Khác gì Apollo hay Clay?
README nói Sellbird không dùng các công cụ prospecting như Apollo, ZoomInfo, Clearbit hay Clay, và tự tìm công ty, người liên hệ và kiểm tra email trong cùng một dây chuyền. Tư liệu không có so sánh chi tiết về chất lượng dữ liệu giữa các công cụ.


