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 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, xác minh email, viết và gửi cold email rồi xử lý phản hồi. Mặc định không email nào được gửi khi bạn chưa duyệt. Cài đặt cần biết dùng terminal, nhưng README có cách nhờ Claude Code cài giúp.
Sellbird là một nền tảng outreach (tiếp cận khách hàng) mã nguồn mở, chạy ngay trên máy của bạn. Nó tìm những công ty có thể cần thứ bạn bán, tìm người quyết định ở công ty đó, kiểm tra địa chỉ email, viết cho mỗi người một email lạnh (cold email) mang tính cá nhân, gửi đi và xử lý phản hồi. Repo trước đây tên Harvey, nay đổi tên thành Sellbird, giữ nguyên lịch sử dự án.
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 muốn bán dịch vụ cho doanh nghiệp khác (B2B) mà không muốn trả tiền cho cả bộ công cụ như Apollo, ZoomInfo hay Clay. Hiện repo có khoảng 5.250 sao và 1.127 fork, giấy phép AGPL-3.0, và vẫn được cập nhật trong vài tháng gần đây.
Điểm đáng giá nhất: 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. Bạn không cần API key của mô hình và không bị tính tiền theo token. Thêm một điểm nữa: mặc định mọi email phải chờ bạn duyệt rồi mới gửi. Bạn có thể xem video ngắn bên dưới để thấy nó chạy ra sao, rồi quay lại đọc phần cài đặt.
ethanplusai/sellbird
Sellbird tự 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ý phản hồ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 (pipeline) gồm nhiều bước. Bạn có thể chạy hết, hoặc dừng ở bước nào tùy ý.
- 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ị trừ tiền bất ngờ.
- Tìm lý do họ có thể mua. Nó đọ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 AI nên không tốn thêm chi phí. Mỗi công ty chỉ cần ba request HTTP.
- 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 địa chỉ email. Nó học kiểu đặt 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 (đã xác minh), risky (rủi ro), guess (đoán) hoặc invalid (không hợp lệ). Chỉ địa chỉ gửi được mới được dùng để gửi.
- Viết và gửi. Nó soạn một chuỗi email ngắn cho từng người dựa trên những gì tìm được, rồi gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn. Nó tuân theo giới hạn gửi mỗi ngày và giờ làm việc của người nhận.
- Xử lý phản hồi. Nó đọ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 sẽ được 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 xuất ra file CSV để đưa vào công cụ gửi mail khác.
Về lớp an toàn: trước khi gửi, một bước kiểm tra không dùng mô hình sẽ loại các email còn sót thẻ chưa điền, cụm từ bị cấm, email quá dài, thừa link hoặc địa chỉ không gửi được. Lệnh sellbird sending pause dừng mọi việc gửi ngay lập tứ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. Máy Mac thường đi kèm Python 3.9, nên README khuyên chạybrew install python@3.13nếupython3 --versionbáo bản cũ. - Gói Claude Pro hoặc Max với Claude Code CLI đã đăng nhập (
claude login), hoặc gói ChatGPT có Codex CLI. Cách dùng Codex có hướng dẫn riêng trong thư mụcdocs/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ư. README gợi ý TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Sellbird đọc tỉ lệ vào hộp thư đến từ công cụ này để báo khi nào bạn sẵn sàng. TrulyInbox là link affiliate của tác giả. Đây chỉ là gợi ý, không bắt buộc theo nghĩa kỹ thuật.
Về chi phí, README nêu: tìm doanh nghiệp là 0 đồng với nguồn mặc định, hoặc khoảng 0,37 USD cho 1.000 kết quả với nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Phần còn lại là gói thuê bao bạn đang có và hộp thư (README ví dụ khoảng 7 USD mỗi tháng cho Google Workspace).
Về hệ điều hành: README mô tả thư mục dữ liệu cho macOS, Windows và Linux. Riêng Docker, README chỉ nói “trên Linux bạn cũng có thể chạy bằng Docker”. Về GPU hay cấu hình máy, tư liệu không nói gì.
III.Cài đặt từng bước
- Chuẩn bịKiểm tra Python 3.11+, đăng nhập Claude Code (hoặc Codex)
- Tải mã nguồnDùng git clone rồi vào thư mục sellbird
- Cài đặtTạo môi trường ảo và chạy pip install -e .
- Điền thông tinSao chép .env.example thành .env và điền các giá trị cần
- Dạy SellbirdChạy sellbird train với website của bạn
- Tìm khách và chạydiscover, mở dashboard, rồi chạy sellbird run
README cho hai đường: nhờ Claude cài giúp, hoặc tự làm. Mình trình bày cả hai.
A.Chuẩn bị Python và đăng nhập Claude
Mở terminal (Terminal trên Mac/Linux, PowerShell hoặc Git Bash trên Windows). Kiểm tra phiên bản Python:
python3 --versionNếu ra 3.9 (hay gặp trên Mac), cài bản mới theo README:
brew install python@3.13Sau đó đăng nhập Claude Code CLI bằng tài khoản Pro hoặc Max:
claude loginB.Tải mã nguồn và để Claude cài giúp (cách dễ nhất)
Lệnh dưới tải repo về máy, vào thư mục vừa tải, rồi mở Claude Code ngay trong thư mục đó:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeKhi Claude mở lên, 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 các thông tin cần và dạy Sellbird về sản phẩm của bạn. Chỗ người mới hay vấp: phải chạy claude đúng bên trong thư mục sellbird, không phải ở thư mục khác.
C.Hoặc tự cài bằng tay
Bước đầu là tạo môi trường ảo (virtual environment) và cài Sellbird. README dặn dùng python3.13, đừng dùng python3 trần, vì trên Mac python3 có thể là bản 3.9:
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .Lệnh này tạo thư mục .venv, bật môi trường đó lên, rồi cài Sellbird ở chế độ chỉnh sửa được. Lệnh source .venv/bin/activate dành cho Mac/Linux. README chưa ghi lệnh kích hoạt cho Windows. Nếu dùng Windows, bạn xem phần “Troubleshooting” trong thư mục docs/ hoặc nhờ Claude Code cài giúp theo cách ở trên.
Tiếp theo, sao chép file mẫu cấu hình và điền thông tin:
cp .env.example .env && $EDITOR .envFile .env là nơi bạn điền các thông tin kết nối. README nói mỗi biến đều có giải thích ngay trong file. Các nhóm biến có trong file mẫu gồm: Gmail (GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET), SMTP/IMAP, Microsoft 365, các dịch vụ kiểm tra email như Reoon, ZeroBounce, Hunter, và TrulyInbox. Bạn không cần điền hết. Chỉ điền phần liên quan đến hộp thư và dịch vụ bạn thật sự dùng.
Bước kế tiếp là cho Sellbird học về sản phẩm của bạn từ website của bạn. Lệnh này tạo file sellbird.local.yaml:
sellbird train https://your-company.comThay địa chỉ bằng website thật của bạn. Sau đó xác nhận “tín hiệu” nào cho thấy một khách tiềm năng tốt:
sellbird signals --confirm freeRồi tìm doanh nghiệp. Nguồn mặc định miễn phí và không cần tài khoản:
sellbird discoverCuối cùng mở bảng điều khiển và bắt đầu vòng lặp:
sellbird dashboard # prints a private link to http://127.0.0.1:5555
sellbird runLệnh sellbird dashboard in ra một đường link riêng tới địa chỉ trên máy bạn (127.0.0.1:5555). Hãy mở link đó trong trình duyệt. Lệnh sellbird run thì cứ để cửa sổ terminal mở.
D.Chạy bằng Docker (Linux)
Repo có Dockerfile và docker-compose.yml. README chỉ nói ngắn gọn rằng trên Linux bạn có thể chạy bằng Docker và chưa kèm lệnh khởi động ở phần cài nhanh. Hãy xem hướng dẫn Docker trong thư mục docs/.
File .env chứa mật khẩu hộp thư và key các dịch vụ. Đừng gửi file này cho ai, đừng đưa lên GitHub hay dán vào cuộc chat công khai. Nên dùng một tên miền gửi riêng thay vì tên miền chính của công ty.
IV.Kiểm tra đã chạy được chưa
Có ba dấu hiệu theo README:
sellbird dashboardin ra đường link riêng, mở được trang bảng điều khiển trong trình duyệt tại địa chỉ 127.0.0.1:5555.sellbird runhiện dòng “Sellbird is online”, rồi báo trạng thái pipeline. README minh hoạ kiểu như: có “Decision: write_campaign” (quyết định viết chiến dịch), các dòng handler/writer/outbox, và “Cycle complete. Sleeping for 15 minutes.” (xong một vòng, nghỉ 15 phút).- Mục Outbox trong dashboard xuất hiện các email đang chờ bạn duyệt. Việc nó chờ duyệt, chứ không tự gửi, là đúng thiết kế mặc định.
Dữ liệu trong README là dữ liệu mẫu bịa ra (công ty Bookwell bán dịch vụ đặt lịch cho thợ lợp mái, nha khoa, điều hoà, trên tên miền .test). Dữ liệu thật của bạn sẽ khác.
V.Dùng vào việc thật
Sellbird nên được dùng như một trợ lý đã có kỷ luật: nó làm phần việc lặp đi lặp lại, còn quyết định cuối cùng vẫn thuộc về bạn.
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
A.Chủ doanh nghiệp nhỏ tìm khách B2B đầu tiên
Bối cảnh: bạn bán phần mềm hoặc dịch vụ cho các cửa hàng, phòng khám, xưởng nhỏ và muốn có vài chục khách tiềm năng mà không thuê nhân viên sales. Bạn chạy sellbird train với website của mình để Sellbird hiểu bạn bán gì, xác nhận tín hiệu bằng sellbird signals --confirm free, rồi chạy sellbird discover. Kết quả là danh sách doanh nghiệp phù hợp cùng lý do họ có thể cần bạn. Khi chạy sellbird run, các email nháp xuất hiện trong Outbox. Bạn đọc, sửa, duyệt từng cái.
B.Nhân viên kinh doanh chỉ cần danh sách sạch
Bối cảnh: công ty bạn đã có công cụ gửi mail riêng, bạn chỉ cần danh sách liên hệ đã kiểm tra. Bạn chạy pipeline đến bước kiểm tra email rồi dừng, sau đó chạy:
sellbird exportKết quả là file CSV các công ty và người quyết định, kèm nhãn verified, risky, guess hoặc invalid. Bạn có thể lọc lấy các địa chỉ đã xác minh để đưa vào công cụ của mình.
C.Người làm việc với hòm thư đầy phản hồi
Bối cảnh: sau vài ngày gửi, thư trả lời về nhiều. Sellbird đọc từng thư, soạn sẵn câu đáp, tách riêng thư tự động trả lời và xử lý ngay các yêu cầu ngừng nhận thư. Những thư nó cho là không nên tự trả lời sẽ được đẩy sang cho bạn. Bạn mở dashboard, xem các thư đã được phân loại, như “interested” (quan tâm) hay “objection” (phản đối) trong ví dụ của README. Nếu cần dừng gấp, bạn gõ:
sellbird sending pauseD.Lập trình viên muốn chỉnh “bộ não” theo ý mình
Bối cảnh: bạn muốn email theo giọng của công ty mình. README cho biết thư mục prompts/ và skills/ là các file bạn tự sửa được, gồm cả “sales playbook” mà các sub-agent sử dụng. Với bản cài qua pip hoặc pipx, các file mặc định được chép sang thư mục dữ liệu của bạn ở lần chạy đầu và không bị ghi đè khi nâng cấp. Bạn sửa các file này, rồi kiểm tra kết quả ở Outbox trước khi bật bất kỳ chế độ tự động nào. Repo còn có tài liệu về Extensions nếu bạn muốn thêm lệnh hoặc bước mới từ một gói riêng.
VI.Lỗi hay gặp và cách xử lý
A.Python quá cũ, cài pip install -e . báo lỗi
Trên Mac, python3 thường là bản 3.9 trong khi repo cần 3.11 trở lên. Hãy kiểm tra bằng python3 --version, cài bản mới bằng brew install python@3.13, rồi tạo môi trường ảo bằng python3.13 -m venv .venv như README dặn.
B.Lệnh sellbird không tìm thấy
Thường là do chưa bật môi trường ảo trong cửa sổ terminal hiện tại, hoặc chưa chạy pip install -e .. Hãy bật lại môi trường (source .venv/bin/activate trên Mac/Linux) rồi thử lại. Mỗi lần mở terminal mới, bạn cần bật lại.
C.Claude chưa đăng nhập
Sellbird dùng Claude Code CLI qua gói thuê bao của bạn. Nếu CLI chưa đăng nhập, nó không suy nghĩ được. Chạy claude login và đăng nhập bằng tài khoản Pro hoặc Max. Nếu dùng ChatGPT, xem hướng dẫn Codex trong docs/.
D.Email vào thư rác hoặc bị trả lại
Đây là rủi ro chung của cold email, không riêng gì Sellbird. README nhấn mạnh việc dùng tên miền gửi riêng và làm nóng hộp thư trước khi gửi. Đừng bật tự động gửi khi chưa quen. Hãy đọc kỹ phần “Legal and deliverability” trong docs/ để biết các quy định bạn đang gửi dưới, vì quy định về gửi thư thương mại khác nhau theo từng nước.
E.Nâng cấp từ bản Harvey cũ bị báo lỗi khi git pull
Nếu bạn từng sửa trực tiếp file harvey.yaml, git pull sẽ báo “your local changes would be overwritten”. README hướng dẫn chạy git stash, rồi git pull, rồi git stash pop. Nếu có xung đột thì giữ các dòng của bạn, xoá các dấu xung đột và chạy git stash drop. Cách gọn hơn là đặt cài đặt của bạn vào sellbird.local.yaml, file mà git không đụng tới.
VII.Có nên dùng không
Điểm mạnh. Sellbird gom cả quy trình tìm khách, xác minh, viết, gửi và trả lời vào một công cụ chạy trên máy bạn. Bạn dùng gói thuê bao sẵn có nên không phải trả tiền theo token. Dữ liệu nằm trong thư mục của bạn. Nguồn tìm kiếm mặc định miễn phí. Cơ chế duyệt trước khi gửi, kiểm tra trước khi gửi và lệnh dừng khẩn cấp giúp giảm rủi ro gửi nhầm.
Giới hạn. Cài đặt cần thoải mái với terminal, file .env và việc cấu hình hộp thư. Bạn vẫn phải tự lo hộp thư, tên miền gửi và làm nóng hộp thư. README đã tính mức dùng Claude/ChatGPT vào thiết kế và cho biết Sellbird tự giãn nhịp để chừa chỗ cho việc của bạn, nhưng thực tế bạn vẫn nên để ý hạn mức gói. Giấy phép AGPL-3.0 cũng cần được đọc kỹ nếu bạn định chỉnh sửa rồi cung cấp như một dịch vụ cho người khác. Tư liệu cũng chưa nói về hiệu quả thực tế, như tỉ lệ phản hồi, nên mình không thể cam kết kết quả.
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 đám mây sellbird.ai (đang truy cập sớm), có sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ gửi vài email tay mỗi tuần, một công cụ đơn giản hơn là đủ. Và dù chọn công cụ nào, hãy chỉ gửi cho đúng đối tượng, có nội dung trung thực và có cách để người nhận từ chối.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Bản mã nguồn mở là miễn phí, theo giấy phép AGPL-3.0. Tìm doanh nghiệp bằng nguồn mặc định và đọc website của họ đều là 0 đồng. 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 ví dụ khoảng 7 USD mỗi tháng cho Google Workspace).
Có cần API key của mô hình AI không?
Không. Theo README, 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ụ phụ như kiểm tra email có biến key riêng trong file .env.example, nhưng bạn chỉ điền khi dùng.
Cần GPU hoặc máy cấu hình mạnh không?
Tư liệu không nói gì về GPU hay cấu hình tối thiểu. Phần suy nghĩ do Claude hoặc Codex xử lý qua gói thuê bao của bạn, không chạy mô hình trên máy. Yêu cầu được nêu rõ là Python 3.11 trở lên.
Chạy được trên Windows không?
README có nêu thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nên Windows được tính đến. Tuy nhiên lệnh kích hoạt môi trường ảo trong README là kiểu Mac/Linux, và README chỉ nói Docker dùng được trên Linux. Nếu gặp vướng mắc, hãy xem phần Troubleshooting trong thư mục docs của 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 chế độ autopilot. Ngay cả khi bật, nó vẫn giữ lại email có link tới tên miền không phải của bạn. Lệnh sellbird sending pause dừng mọi việc gửi ngay.
Dữ liệu của tôi có an toàn không?
Sellbird chạy trên máy bạn, còn cấu hình, kiến thức và dữ liệu nằm trong một thư mục riêng của bạn. Bảng điều khiển chạy ở địa chỉ nội bộ 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 đọc SECURITY.md trong repo nếu cần.
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ủa bạn được mang sang. Lệnh harvey cũ vẫn chạy tạm thời nhưng sẽ bị gỡ ở bản sau. Các bản Harvey đến 0.3.x dùng giấy phép MIT, còn từ bản đổi tên dùng AGPL-3.0.


