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 (tên cũ là Harvey) là nền tảng outreach mã nguồn mở viết bằng Python. Nó tìm công ty phù hợp, tìm người quyết định, kiểm tra email, viết và gửi cold email rồi soạn sẵn câu trả lời cho thư phản hồ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 không khó nếu bạn quen terminal, hoặc bạn có thể nhờ Claude Code cài giúp.
Sellbird là một nền tảng outreach mã nguồn mở, chạy ngay trên máy của bạn. Nó tìm những công ty có khả năng cần thứ bạn bán, tìm người ra quyết định, 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ý thư trả lời. Repo này trước đây tên là Harvey, nay đã đổi tên thành Sellbird.
Người nên xem là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, freelancer và lập trình viên muốn tìm khách B2B mà không muốn trả tiền cho Apollo, ZoomInfo hay Clay. Điểm đáng giá nhất: Sellbird "suy nghĩ" qua Claude Code CLI trên gói Claude Pro hoặc Max, 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.
Điểm đáng giá thứ hai là mặc định không có email nào được gửi nếu bạn chưa duyệt. Hiện repo có khoảng 5250 sao và 1127 fork, giấy phép AGPL-3.0, 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ở chạy trên máy bạn: tìm công ty và người quyết định, xác minh email, viết cold email cá nhân hoá, gửi đi và xử lý thư trả lời.
I.Sellbird làm được gì
Sellbird là một đường ống (pipeline) gồm nhiều bước. Bạn có thể chạy trọn bộ, hoặc dừng ở bất kỳ bước nào.
A.Tìm công ty phù hợp
Nó tìm các doanh nghiệp khớp với 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í. Mỗi lần tìm bằng nguồn trả phí đều hiện chi phí trước khi chạy, nên không lo bị trừ tiền bất ngờ.
B.Hiểu vì sao họ có thể mua
Sellbird đọc website của từng công ty để tìm các "tín hiệu mua" 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 và không tốn tiền, chỉ là ba yêu cầu HTTP cho mỗi công ty. Nhờ vậy email sau này có lý do cụ thể để viết, không phải thư gửi đại trà.
C.Tìm người quyết định và kiểm tra email
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. Sau đó nó học cách đặt 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ỉ có thể nhận thư mới được gửi tới.
D.Viết, gửi và xử lý thư trả lời
Với mỗi người, nó viết một chuỗi email ngắn dựa trên những gì đã tìm được. 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. Khi có thư trả lời, nó đọc, soạn câu trả lời, xếp riêng thư tự động, tôn trọng yêu cầu từ chối nhận thư ngay lập tức. Thư nào không nên trả lời một mình thì nó chuyển cho bạn.
E.Chỉ cần danh sách thì dừng sớm
Nếu bạn chỉ muốn danh sách khách hàng, hãy dừng sau bước xác minh và chạy sellbird export. Bạn sẽ có file CSV sẵn để đưa vào công cụ gửi mail khác.
II.Cần chuẩn bị gì
- Python 3.11 trở lên. File pyproject.toml của repo yêu cầu đúng mức này. README lưu ý macOS đóng gói sẵn Python 3.9, nên nếu
python3 --versionbáo 3.9 thì chạybrew install python@3.13trước. - Một trong hai gói AI: Claude Pro hoặc Max với CLI đã đăng nhập (
claude login), hoặc gói ChatGPT có Codex CLI. Cách cài với Codex có hướng dẫn riêng trong thư mục docs. - 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.
- Warmup (làm nóng) cho hộp thư đó. README giới thiệu TrulyInbox. Đây là link tiếp thị liên kết của tác giả, không bắt buộc, và README không nói là chỉ dùng được công cụ này.
- Git để tải mã nguồn.
- Khoản phí tham khảo trong README: Google Workspace khoảng 7 USD mỗi tháng. 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ả.
Về hệ điều hành, README nêu cách cài bằng dòng lệnh kiểu macOS/Linux và nói thêm rằng Linux có thể chạy bằng Docker. README cũng có nhắc thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng không có hướng dẫn cài riêng cho Windows. Nếu bạn dùng Windows, hãy đọc thêm docs trong repo trước khi bắt đầu.
III.Cài đặt từng bước
- Tải mã nguồngit clone repo về máy và vào thư mục
- Cài đặtTạo môi trường ảo Python và cài gói sellbird
- Điền thông tinSao chép .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áchXác nhận tín hiệu, chạy sellbird discover
- ChạyMở dashboard và bắt đầu vòng lặp sellbird run
Có hai cách. Cách dễ nhất là để Claude Code làm hộ. Cách thứ hai là tự gõ lệnh.
A.Cách 1: để Claude cài giúp
Mở terminal (PowerShell hoặc Terminal), rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeBa lệnh này tải mã nguồn, vào thư mục vừa tải và mở Claude Code ngay trong thư mục đó. Điều này quan trọng vì Claude Code sẽ đọc file CLAUDE.md của repo. Sau đó bạn gõ: "set up Sellbird for me". Theo README, CLAUDE.md 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 những gì cần hỏi và dạy Sellbird về sản phẩm của bạn.
B.Cách 2: tự cài từng lệnh
Vẫn cần git clone và cd sellbird như trên. Sau đó:
Tạo môi trường ảo và cài gói
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .Lệnh này tạo 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. README dặn dùng python3.13, không dùng python3 trần, vì trên macOS python3 có thể là bản 3.9. Dòng source .venv/bin/activate là cú pháp macOS/Linux. README không ghi dòng kích hoạt tương ứng cho Windows, bạn nên xem docs hoặc nhờ Claude Code ở Cách 1.
Điền thông tin đăng nhập
cp .env.example .env && $EDITOR .envLệnh này sao chép file mẫu thành .env, rồi mở để bạn sửa. Mỗi biến trong file đều có chú thích ngay bên cạnh. Bạn chỉ điền phần mình dùng. Ví dụ với Gmail thì có GMAIL_CLIENT_ID và GMAIL_CLIENT_SECRET. Với SMTP thì có SMTP_HOST, SMTP_USERNAME, SMTP_PASSWORD. Chỗ hay vấp: $EDITOR có thể trống trên máy bạn. Khi đó hãy mở file .env bằng trình soạn thảo quen thuộc.
Dạy Sellbird về sản phẩm của bạn
sellbird train https://your-company.comThay địa chỉ bằng website thật của bạn. Sellbird đọc trang web để hiểu bạn bán gì và ghi kết quả vào file sellbird.local.yaml.
Xác nhận thế nào là khách tốt
sellbird signals --confirm freeLệnh này để bạn xác nhận những tín hiệu mua mà Sellbird sẽ tìm trên website khách hàng tiềm năng.
Tìm doanh nghiệp
sellbird discoverNguồn mặc định miễn phí và không cần tài khoản.
Mở dashboard và chạy vòng lặp
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). Hãy mở link đó bằng trình duyệt. sellbird run bắt đầu vòng lặp: kiểm tra trạng thái, viết thư, xử lý thư trả lời, nghỉ 15 phút rồi lặp lại.
Cách thứ ba: Docker
README nói trên Linux bạn cũng có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, hướng dẫn chi tiết nằm trong docs của repo.
Sellbird có thể gửi email thật từ hộp thư của bạn. Hãy dùng một tên miền gửi riêng, không dùng hộp thư chính của công ty. Giữ file .env cho riêng mình, không đưa lên GitHub hay gửi cho ai. Đọc phần "Legal and deliverability" trong docs của repo để biết quy định gửi thư mà bạn phải tuân theo.
IV.Kiểm tra đã chạy được chưa
Có ba dấu hiệu theo tư liệu của repo.
Thứ nhất, lệnh sellbird dashboard in ra link riêng dẫn tới http://127.0.0.1:5555, và mở được trên trình duyệt. Đây là cách kiểm tra nhanh nhất.
Thứ hai, sellbird run hiện dòng "Sellbird is online." rồi báo trạng thái từng chu kỳ. README minh hoạ kết quả như sau: chọn hành động "write_campaign", có các dòng handler và writer, và dòng "outbox → 5 emails waiting for your approval", cuối cùng là "Cycle complete. Sleeping for 15 minutes." Đó là ví dụ của README, số liệu trên máy bạn sẽ khác.
Thứ ba, email xuất hiện trong Outbox của dashboard và đang chờ bạn duyệt. Nếu thấy vậy thì pipeline đã chạy đúng. Chưa có gì được gửi đi cho đến khi bạn bấm duyệt.
V.Dùng vào việc thật
A.Chủ cửa hàng dịch vụ tìm khách mới theo khu vực
Bạn là chủ một công ty cung cấp phần mềm đặt lịch cho tiệm nhỏ. 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", rồi chạy sellbird discover. Sellbird tìm các doanh nghiệp khớp, đọc website của họ và lọc ra những nơi thật sự thiếu đặt lịch. Kết quả là một danh sách có lý do liên hệ rõ ràng thay vì danh bạ chung chung. Demo của repo cũng đi theo kịch bản tương tự, với một công ty giả tên Bookwell bán đặt lịch cho thợ lợp mái, nha khoa và sửa điều hoà.
Cold email tốt không phải là gửi nhiều, mà là mỗi người nhận hiểu vì sao mình được chọn.
Ông T
B.Nhân viên sales duyệt thư trước khi gửi
Bạn không tin hoàn toàn vào AI, và đó là ý hay. Với cấu hình mặc định, mọi email nằm trong Outbox chờ bạn duyệt. Bạn mở dashboard, đọc từng thư, sửa nếu cần rồi mới cho đi. Trước khi gửi còn có bước kiểm tra không dùng mô hình, chặn các thư còn sót merge tag, có cụm từ bị cấm, quá dài, thừa link hoặc gửi tới địa chỉ không nhận được thư. Chỉ khi bạn tự bật autopilot thì thư mới đi mà không cần bạn duyệt. Nếu thấy có gì không ổn, sellbird sending pause dừng mọi thứ cùng lúc.
C.Marketer chỉ cần danh sách để dùng công cụ khác
Bạn đã có công cụ gửi mail riêng và chỉ muốn danh sách khách. Hãy chạy các bước tìm công ty, tìm người quyết định và xác minh, rồi dừng lại và chạy:
sellbird exportBạn nhận được file CSV sẵn để đưa vào công cụ gửi mail. Mỗi địa chỉ đã có nhãn verified, risky, guess hoặc invalid, nên bạn biết nên dùng địa chỉ nào.
D.Lập trình viên tuỳ chỉnh theo cách bán hàng riêng
Thư mục prompts/ và skills/ chứa các kịch bản bán hàng mà bạn có thể sửa, còn sellbird.local.yaml là nơi đặt cấu hình riêng mà git không động tới. README cũng nhắc tới phần Extensions để thêm route, bước trong vòng lặp hoặc lệnh từ một gói riêng. Nếu bạn muốn đổi giọng văn của thư hay thêm bước xử lý, đây là chỗ bắt đầu.
VI.Lỗi hay gặp và cách xử lý
A.Báo sai phiên bản Python, hoặc lệnh không chạy được trên macOS
nguyên nhân thường gặp nhất là python3 trần trên macOS là bản 3.9, trong khi repo cần 3.11 trở lên. Chạy python3 --version để kiểm tra. Nếu báo 3.9, cài bản mới bằng brew install python@3.13 rồi dùng đúng lệnh python3.13 khi tạo môi trường ảo.
B.Gõ sellbird báo không tìm thấy lệnh
Thường là môi trường ảo chưa được kích hoạt, hoặc bạn mở terminal mới. Hãy vào lại thư mục repo, kích hoạt lại .venv rồi chạy lại. Nếu bạn nâng cấp từ Harvey, README dặn chạy pip install -e . một lần để có lệnh sellbird mới.
C.Claude hoặc Codex chưa đăng nhập
Sellbird dựa vào CLI đã đăng nhập, nên nếu chưa đăng nhập thì nó không "suy nghĩ" được. Chạy claude login với Claude, hoặc xem hướng dẫn "Using a ChatGPT plan (Codex)" trong docs của repo nếu bạn dùng ChatGPT.
D.git pull báo "your local changes would be overwritten" khi nâng cấp từ Harvey
Chuyện này xảy ra nếu bạn từng sửa trực tiếp file harvey.yaml. README hướng dẫn chạy lần lượt git stash, git pull, git stash pop. Nếu có xung đột trong sellbird.yaml, giữ lại 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 cài đặt riêng vào sellbird.local.yaml để git không đụng tới.
E.Email vào thư rác hoặc không có thư nào được gửi
Tư liệu không liệt kê lỗi này, nhưng đây là rủi ro rất phổ biến với cold email. Hộp thư mới chưa được warmup rất dễ rơi vào spam. Hãy warmup trước khi gửi, dùng tên miền gửi riêng và đọc mục "Legal and deliverability" trong docs. Nếu không có thư nào đi, kiểm tra Outbox xem có thư đang chờ bạn duyệt không, và xem sellbird sending pause có đang bật không.
VII.Có nên dùng không
Điểm mạnh. Chi phí thấp: dùng gói AI bạn đã có, nguồn tìm kiếm mặc định miễn phí, không cần Apollo hay Clay. Chạy trên máy bạn nên bạn giữ quyền kiểm soát. Mặc định mọi thư đều chờ bạn duyệt, kèm bước kiểm tra trước khi gửi. Mã nguồn mở, có tài liệu khá đầy đủ, và có Claude Code hướng dẫn cài.
Giới hạn. Bạn vẫn phải tự lo hộp thư gửi, tên miền và warmup. Chất lượng danh sách phụ thuộc vào dữ liệu công khai trên website của công ty, tối đa hai người mỗi công ty. Hướng dẫn cài chủ yếu theo kiểu macOS/Linux. Phần lớn ví dụ của README hướng tới thị trường nói tiếng Anh, còn việc dùng cho khách hàng Việt Nam thì tư liệu chưa nói gì, nên bạn cần tự thử. Repo dùng giấy phép AGPL-3.0, nếu bạn định sửa đổi rồi cung cấp thành dịch vụ cho người khác thì nên đọc kỹ điều khoản. Ngoài ra, gửi email lạnh có ràng buộc pháp lý, bạn cần tự tìm hiểu quy định áp dụng cho mình.
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 hosted tại sellbird.ai (đang ở giai đoạn early access, theo README) với tên miền gửi, hộp thư và warmup đã làm sẵn. Nếu bạn chỉ cần gửi vài thư thủ công mỗi tuần thì một bảng tính và hộp thư thường là đủ, không cần cả pipeline này.
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í, giấy phép AGPL-3.0. Nguồn tìm doanh nghiệp mặc định là 0 đồng. 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 (Google Workspace khoảng 7 USD mỗi tháng theo README).
Có cần API key của Claude hay OpenAI không?
Không. Theo README, Sellbird dùng Claude Code CLI trên gói Pro hoặc Max, hoặc 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. File .env vẫn có biến cho các dịch vụ khác như xác minh email, bạn chỉ điền phần mình dùng.
Có cần GPU không?
Tư liệu không nhắc tới GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhiệm, còn Sellbird chạy trên máy bạn bằng Python 3.11 trở lên.
Chạy trên Windows được không?
README chỉ ghi lệnh cài theo kiểu macOS/Linux và nói Docker dùng được trên Linux. README có nhắc thư mục dữ liệu trên Windows là %APPDATA%\sellbird, nhưng chưa có hướng dẫn cài riêng cho Windows. Bạn nên xem thư mục docs hoặc nhờ Claude Code cài giúp.
Có tự gửi email mà tôi không biết không?
Mặc định thì không. Mọi email nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật autopilot. Lệnh `sellbird sending pause` dừng mọi việc gửi ngay lập tức.
Dữ liệu của tôi lưu ở đâu?
Sellbird chạy trên máy bạn. Cấu hình, kiến thức và dữ liệu nằm trong một thư mục home riêng, gồm database, log và token đăng nhập dashboard. Tư liệu không nói gì thêm về cách các dịch vụ bên thứ ba xử lý dữ liệu, bạn cần xem điều khoản của từng dịch vụ mình bật.
Sellbird khác gì Harvey?
Là cùng một dự án, cùng lịch sử, chỉ đổi tên. Harvey được đổi tên thành Sellbird ở bản 0.4.0, cấu hình và dữ liệu cũ được chuyển sang tên mới. Các bản Harvey đến 0.3.x dùng giấy phép MIT, còn Sellbird dùng AGPL-3.0.


