Sellbird: tự tìm khách 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 là nền tảng outreach mã nguồn mở viết bằng Python. Nó tìm doanh nghiệp phù hợp, tìm người quyết định, 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ó nên không phải trả tiền API. Cài bằng vài lệnh, nhưng cần Python 3.11 trở lên và một hộp thư để gửi.
Sellbird là một nền tảng mã nguồn mở để làm outreach (gửi email chào hàng lạnh, hay cold email) gần như từ đầu đến cuối. Nó tìm những 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 cho mỗi người một email riêng, gửi đi và xử lý thư trả lời. Repo này trước đây tên Harvey, nay đổi tên thành Sellbird và hiện có khoảng 5.249 sao cùng 1.127 fork.
Bạn nên xem qua nếu đang bán dịch vụ cho doanh nghiệp nhỏ (tiệm nha khoa, thợ sửa mái, cửa hàng điều hoà, hay những ngành tương tự). Bạn cũng nên xem nếu là lập trình viên muốn có sẵn một dây chuyền tìm khách mà mình kiểm soát được. Mọi thứ chạy trên máy của bạn, và mặc định không có email nào được gửi đi nếu bạn chưa duyệt.
Điểm đáng giá nhất là chuyện chi phí. Sellbird không dùng API key của mô hình AI. Nó "suy 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 bị tính tiền theo token. Bạn có thể xem video ngắn bên dưới để thấy tổng quan trước khi cài.
ethanplusai/sellbird
Sellbird tìm công ty và người 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 — 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 nhiều bước. Bạn có thể chạy hết, hoặc dừng ở bất kỳ bước nào.
- Tìm công ty. 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í. 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ị tính tiền bất ngờ.
- Tìm lý do họ sẽ mua. Nó đọc website của từng công ty để tìm những tín 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 AI nên không tốn gì.
- 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 mỗi công ty.
- Kiểm tra email. Nó suy ra mẫu email của công ty và xác minh một địa chỉ. Mỗi địa chỉ được gắn nhãn verified, risky, guess hoặc invalid, và chỉ địa chỉ gửi được mới được dùng để gửi. Việc này giúp bạn bớt thư bị trả lại, vốn làm hỏng uy tín tên miền gửi.
- 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.
- Xử lý thư trả lời. Nó đọ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. Những gì không nên tự trả lời, nó chuyển cho bạn.
Nếu bạn chỉ cần danh sách khách, hãy dừng sau bước kiểm tra email và chạy sellbird export. Lệnh này cho ra file CSV sẵn sàng đưa vào công cụ gửi mail hàng loạt.
Về an toàn, mọi email gửi đi đều nằm trong mục Outbox chờ bạn duyệt, cho đến khi chính bạn bật chế độ autopilot. Trước khi gửi còn có một bước kiểm tra không dùng mô hình AI. Bước này chặn những email còn sót thẻ điền thông tin chưa thay, chứa 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.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Python 3.11 trở lên. File pyproject.toml yêu cầu Python >=3.11. README lưu ý macOS đi kèm Python 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 CLI đã đăng nhập (
claude login), hoặc gói ChatGPT có Codex CLI. Cách thiết lập Codex nằm 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 dùng được.
- Warmup (làm nóng) cho hộp thư đó. Tác giả gợi ý TrulyInbox. Sellbird đọc đượ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à liên kết affiliate của người bảo trì, và bạn không bắt buộc phải dùng.
Về chi phí, README nêu: tìm doanh nghiệp là 0 đồng ở nguồn mặc định, hoặc khoảng 0,37 USD cho 1.000 kết quả ở nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Hộp thư Google Workspace khoảng 7 USD một tháng. Repo này không dùng Apollo, ZoomInfo, Clearbit hay Clay.
File .env.example liệt kê nhiều biến tuỳ chọn như khoá cho dịch vụ xác minh email (Reoon, ZeroBounce, Hunter), Instantly, Cloudflare và DataForSEO. Bạn không cần điền hết. Chỉ điền những gì bạn thực sự dùng.
Về hệ điều hành, README ví dụ bằng lệnh macOS/Linux và nói Docker dùng được trên Linux. Thư mục dữ liệu trên Windows nằm ở %APPDATA%\sellbird. Phần cài đặt của README chưa có lệnh riêng cho Windows, bạn xem thêm mục Troubleshooting và Docker trong thư mục docs/.
III.Cài đặt từng bước
- Tải mã nguồnClone repo về máy và vào thư mục dự án
- Tạo môi trường và càiTạo môi trường ảo Python 3.13 rồi cài gói sellbird
- Điền thông tin đăng nhậpSao chép .env.example thành .env và điền
- Dạy Sellbird về sản phẩmChạy sellbird train với website của bạn
- Chọn tín hiệu và tìm kháchXác nhận signals rồi chạy sellbird discover
- Mở dashboard và chạy vòng lặpChạy sellbird dashboard và sellbird run
README có hai cách: nhờ Claude cài giúp, hoặc tự gõ lệnh. Người mới nên thử cách đầu.
A.Tải mã nguồn (và cách để Claude cài giúp)
Mở terminal (trên macOS là Terminal, trên Linux là cửa sổ dòng lệnh), rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudegit 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". 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 thứ nó cần và dạy Sellbird về sản phẩm của bạn. Nếu dùng cách này, bạn có thể bỏ qua các bước còn lại bên dưới.
Lưu ý: lệnh claude chỉ chạy được khi bạn đã cài Claude Code CLI và đăng nhập bằng claude login.
B.Tạo môi trường ảo và cài Sellbird
Nếu muốn tự làm, vẫn đứng trong thư mục sellbird, chạy:
# 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ôi trường ảo .venv (một "hộp" riêng để gói Python không lẫn với máy), kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Chỗ người mới hay vấp là dùng python3 thay vì python3.13, vì trên macOS python3 trần có thể chỉ là bản 3.9 quá cũ. Lệnh source là của macOS/Linux. README chưa ghi lệnh kích hoạt cho Windows.
C.Điền thông tin đăng nhập vào .env
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .envLệnh sao chép file mẫu thành .env rồi mở nó để bạn sửa. Mỗi biến đều có chú thích ngay trong file. Bạn điền thông tin hộp thư gửi (Gmail, Microsoft 365 hoặc SMTP) và các khoá dịch vụ bạn dùng. Đừng đăng file .env lên bất kỳ đâu công khai.
D.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 nằm ngoài phần git theo dõi nên cập nhật sau này sẽ không đè lên.
E.Chọn tín hiệu và tìm khách
# 4. Confirm what makes a good prospect.
sellbird signals --confirm free
# 5. Find businesses. The default source is free and needs no account.
sellbird discoverBước 4 xác nhận những dấu hiệu cho thấy một công ty là khách tốt. Bước 5 tìm doanh nghiệp, mặc định bằng nguồn miễn phí không cần tài khoản.
F.Mở dashboard và bật 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ỉ 127.0.0.1:5555, tức chỉ mở được trên máy bạn. sellbird run khởi động vòng lặp chính. Nó kiểm tra tình trạng, viết chiến dịch cho khách mới và đưa email vào Outbox chờ bạn duyệt.
IV.Kiểm tra đã chạy được chưa
Có ba dấu hiệu theo README:
python3.13 --version(hoặcpython3 --version) cho ra 3.11 trở lên.sellbird dashboardin ra đường link riêng, và mở được trang tại 127.0.0.1:5555.sellbird runin dòng "Sellbird is online.", rồi báo từng bước như viết chiến dịch, xử lý thư trả lời, và số email đang chờ bạn duyệt, kết thúc bằng "Cycle complete" rồi nghỉ 15 phút trước vòng sau.
README còn nói dữ liệu demo là bịa (công ty "Bookwell" bán đặt lịch online, dùng tên miền .test). Đừng bất ngờ nếu thấy tên lạ khi xem ví dụ.
V.Dùng vào việc thật
A.Chủ công ty phần mềm: chỉ lấy danh sách khách để gửi bằng công cụ khác
Bạn bán phần mềm đặt lịch cho phòng khám nha khoa và đã có công cụ gửi mail hàng loạt. Bạn chỉ cần danh sách sạch. Chạy sellbird train với website của bạn, sellbird signals --confirm free, rồi sellbird discover. Khi dữ liệu đã qua bước kiểm tra email, chạy:
sellbird exportKết quả là file CSV chứa những gì Sellbird tìm được, sẵn sàng nhập vào công cụ gửi mail. Bạn dùng Sellbird như máy tìm khách và kiểm tra email, không cần cho nó gửi gì.
Cold email tốt bắt đầu từ danh sách đúng người, không phải từ nút gửi.
Ông T
B.Người làm kinh doanh: chạy cả dây chuyền nhưng tự duyệt từng thư
Bạn quản lý kinh doanh cho một dịch vụ cho doanh nghiệp nhỏ. Bạn cài Sellbird, nối hộp thư Google Workspace đã warmup, rồi chạy sellbird run. Mỗi vòng, nó tìm khách mới, viết chuỗi 2 email dựa trên tín hiệu như "đang tuyển nhân viên điều phối". Các email nằm trong Outbox. Bạn mở dashboard, đọc từng thư, sửa nếu cần rồi duyệt. Khi thấy chất lượng ổn định, bạn mới cân nhắc bật autopilot. Ngay cả khi bật, Sellbird vẫn giữ lại thư có link tới tên miền không phải của bạn.
C.Nhân viên văn phòng: xử lý thư trả lời mà không bỏ sót
Sau vài ngày gửi, hộp thư có phản hồi lẫn lộn: người quan tâm, người phản đối, thư tự động báo vắng mặt, người xin ngừng nhận. Sellbird đọc tất cả, đặt thư tự động sang một bên, ghi nhận ngay những người từ chối, và soạn sẵn câu trả lời cho người quan tâm hoặc phản đối. Bạn vào dashboard xem những thư đã soạn. Với thứ nó không nên tự đáp, nó chuyển cho bạn quyết định.
D.Lập trình viên: nâng cấp từ Harvey và dừng khẩn cấp
Nếu bạn đang chạy Harvey, README nói cấu hình, dữ liệu và đăng nhập dashboard đượ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à đổi tên file dữ liệu. Nếu thấy có gì bất thường khi đang gửi, một lệnh dừng mọi thứ ngay:
sellbird sending pauseCold email có luật riêng và rủi ro về uy tín tên miền. README có hẳn tài liệu Legal and deliverability trong docs/. Hãy đọc trước khi gửi thật, dùng tên miền gửi riêng và để Outbox ở chế độ duyệt tay cho đến khi bạn tin chất lượng thư. Không chia sẻ file .env.
VI.Lỗi hay gặp và cách xử lý
- Báo Python quá cũ hoặc cài không được. Thường do dùng
python3trần trên macOS, vốn là bản 3.9. Hãy càibrew install python@3.13rồi chạy lại bằngpython3.13như README hướng dẫn. - Không có lệnh
sellbirdsau khi cài. Có thể bạn chưa kích hoạt môi trường ảo.venv, hoặc chưa chạypip install -e .trong thư mục repo. Kích hoạt lại môi trường rồi cài lại. Khi nâng cấp từ Harvey, README cũng dặn chạypip install -e .một lần để có lệnh mới. - Chạy được nhưng không thấy email nào đi. Đây là hành vi mặc định, không phải lỗi. Email chờ trong Outbox cho tới khi bạn duyệt, hoặc bạn tự bật autopilot. Trước hết hãy mở dashboard và kiểm tra Outbox.
git pullbáo "your local changes would be overwritten". Xảy ra khi bạn từng sửa trực tiếp fileharvey.yaml. README hướng dẫn chạygit stash,git pull, rồigit stash pop. Về lâu dài, hãy đặt cấu hình riêng vàosellbird.local.yamlđể git không đụng tới.- Sellbird chưa đổi tên file dữ liệu sau khi nâng cấp. README nói nó sẽ chờ nếu tiến trình Harvey cũ vẫn đang chạy trong thư mục. Hãy tắt tiến trình đó trước rồi chạy lại.
Nếu gặp lỗi khác, README trỏ tới tài liệu Troubleshooting trong thư mục docs/.
VII.Có nên dùng không
Điểm mạnh. Chạy trên máy bạn, dùng gói AI bạn đã trả tiền nên không có hoá đơn API theo token. Dây chuyền đầy đủ, từ tìm khách đến xử lý thư trả lời. Mặc định không gửi gì nếu bạn chưa duyệt, và có bước kiểm tra trước khi gửi không dùng AI. Bạn cũng có thể dùng từng phần, như chỉ xuất danh sách. Giấy phép AGPL-3.0, repo còn được cập nhật trong ba tháng gần đây.
Giới hạn. Bạn phải tự lo hộp thư gửi, tên miền riêng và warmup, vì cold email không chỉ là chuyện phần mềm. README nhắm tới người dùng macOS/Linux, phần Windows chưa rõ. Nguồn tìm doanh nghiệp miễn phí là OpenStreetMap nên độ phủ phụ thuộc vào dữ liệu ở đó, và tôi chưa thấy tư liệu nào nói rõ độ phủ ở Việt Nam. Giấy phép AGPL cũng đáng đọc kỹ nếu bạn định tích hợp vào sản phẩm thương mại.
Khi nào chọn cách khác. Nếu bạn không muốn tự cài và tự lo hộp thư, README có nhắc bản hosted tại sellbird.ai, hiện đang truy cập sớm, đã thiết lập sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ gửi vài thư thủ công mỗi tuần, cài cả dây chuyền này là hơi thừa.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Phần mềm mã nguồn mở, giấy phép AGPL-3.0. Nguồn tìm doanh nghiệp mặc định miễn phí, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả 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).
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 Claude Pro/Max, hoặc qua Codex trên gói ChatGPT, nên không có API key và không tính tiền theo token. Nó cũng tự giảm tốc để chừa chỗ cho việc của bạ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 phần cứng riêng. Phần xử lý AI đi qua Claude Code hoặc Codex, không chạy mô hình trên máy bạn. Yêu cầu được nêu là Python 3.11 trở lên.
Chạy trên Windows được không?
README ghi thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt trong phần Quick start viết cho macOS/Linux, và Docker được nói là dùng trên Linux. README chưa ghi lệnh kích hoạt môi trường ảo cho Windows, bạn xem thêm tài liệu Troubleshooting và Docker trong thư mục docs/.
Sellbird có tự gửi email mà tôi không biết không?
Không, mặc định mọi email chờ trong Outbox cho tới khi bạn duyệt, trừ khi chính bạn bật autopilot. Có thêm bước kiểm tra trước khi gửi, và lệnh sellbird sending pause dừng mọi việc ngay lập tức.
Dữ liệu của tôi nằm ở đâu, có an toàn không?
README nói 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ả cơ sở dữ liệu và log. Dashboard mở tại 127.0.0.1:5555 với link riêng. Tư liệu không nói thêm về các biện pháp bảo mật khác, vấn đề bảo mật xem SECURITY.md trong repo.
Khác gì Harvey? Tôi đang dùng Harvey thì sao?
Harvey chính là Sellbird sau khi đổi tên từ bản 0.4.0, cùng dự án và cùng lịch sử. Cấu hình, dữ liệu và đăng nhập dashboard được mang sang; làm theo mục Upgrading from Harvey: git pull, pip install -e ., rồi sellbird dashboard.


