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 (trước đây là Harvey) là nền tảng mã nguồn mở viết bằng Python, giúp tìm doanh nghiệp phù hợp, tìm 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. Nó chạy trên máy bạn, dùng gói Claude Pro/Max hoặc ChatGPT (Codex) nên không cần API key mô hình. Cài đặt khá gọn, nhưng cần biết dùng terminal và có sẵn một hộp thư để gửi.
Sellbird là một nền tảng mã nguồn mở chạy trên máy bạn, làm trọn chuỗi việc "outreach" (chủ động tiếp cận khách hàng qua email): tìm doanh nghiệp cần thứ bạn bán, tìm người ra quyết định, kiểm tra địa chỉ email, viết thư cá nhân hoá, gửi đi rồi xử lý thư trả lời. Dự án trước đây tên Harvey, hiện có khoảng 5.250 sao và 1.127 fork trên GitHub, viết bằng Python, giấy phép AGPL-3.0.
Người nên xem là chủ doanh nghiệp nhỏ, người làm sales, agency hoặc freelancer đang tự gửi cold email bằng tay, và lập trình viên muốn một hệ thống tự host thay vì thuê nhiều công cụ rời. Điểm đáng giá nhất theo tác giả: Sellbird "suy nghĩ" thông qua Claude Code CLI trên gói Claude Pro/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.
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 tổng quan, rồi quay lại đây làm theo từng bước.
ethanplusai/sellbird
Nền tảng mã nguồn mở tự tìm doanh nghiệp, kiểm tra email, viết và gửi cold email, xử lý trả lời, chạy trên gói Claude hoặc ChatGPT của bạn.
I.Sellbird làm được gì
Sellbird là một chuỗi bước. Bạn có thể chạy hết, hoặc dừng ở bất kỳ bước nào.
- Tìm doanh nghiệp. Tìm các công ty 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. Lợi ích: không bị "cháy ví" bất ngờ.
- Tìm lý do họ sẽ mua. Đọc chính website của từng công ty để tìm tín hiệu 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 nên không tốn gì. Lợi ích: email của bạn có lý do cụ thể để viết, không phải thư gửi đại trà.
- Tìm người quyết định. Tìm chủ hoặc quản lý được nêu tên trên trang của công ty, tối đa hai người mỗi công ty.
- Kiểm tra địa chỉ email. Học quy luật email của công ty rồi 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 nhận thư. Lợi ích: giảm thư bị trả về, bảo vệ uy tín hộp thư gửi.
- 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ì đã tìm thấy, rồi gửi từ Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn mỗi ngày và theo giờ làm việc của người nhận.
- Xử lý trả lời. Đọc mọi thư trả lời, soạn nháp câu đáp, tách thư tự động ra riêng, tôn trọng yêu cầu từ chối ngay lập tức, và chuyển cho bạn những thư mà nó không nên tự trả lời.
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 để lấy file CSV sẵn sàng đưa vào công cụ gửi thư khác.
Ngoài ra có bảng điều khiển (dashboard) chạy trên máy, hộp "Outbox" để duyệt thư trước khi gửi, và lệnh sellbird sending pause để dừng mọi thứ ngay.
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). 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 CLI (
claude login), hoặc gói ChatGPT có Codex CLI. - Một hộp thư để gửi, tốt nhất là 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; Sellbird đọc tỷ lệ vào hộp thư đến của dịch vụ này để báo bạn khi nào sẵn sàng. Đây là link affiliate của tác giả, bạn không bắt buộc dùng.
- Các khoá khác như
GMAIL_CLIENT_ID,SMTP_HOST,REOON_API_KEY,HUNTER_API_KEY… nằm trong file.env.example. Bạn chỉ điền những gì mình dùng; README nói mỗi biến đều có chú thích ngay trong file.
Riêng chi phí: README ghi 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ả, và Google Workspace khoảng 7 USD một tháng. README không nói gì về yêu cầu GPU.
Cold email có quy định pháp lý và rủi ro 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 gửi thật, và 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.
III.Cài đặt từng bước
- Kiểm tra PythonĐảm bảo có Python 3.11 trở lên và Claude CLI đã đăng nhập
- Tải mã nguồnClone repo về máy rồi vào thư mục
- Cài đặtTạo môi trường ảo và cài gói sellbird
- Điền thông tinSao chép .env.example thành .env và điền khoá
- Dạy sản phẩmCho Sellbird học website của bạn
- ChạyTìm doanh nghiệp, mở dashboard, bật vòng lặp
A.Kiểm tra Python và Claude CLI
Mở terminal (trên macOS là Terminal, trên Windows là PowerShell hoặc Git Bash) và kiểm tra phiên bản Python:
python3 --versionNếu ra 3.9 (hay gặp trên macOS), cài bản mới theo README:
brew install python@3.13Sau đó đăng nhập Claude CLI (nếu bạn dùng gói Claude):
claude loginNếu bạn dùng ChatGPT, README trỏ sang tài liệu "Using a ChatGPT plan (Codex)" trong repo. Mình không chép lệnh ở đây vì tư liệu chưa nêu chi tiết.
B.Cách nhanh: để Claude cài giúp
Tác giả làm sẵn file CLAUDE.md để Claude Code tự hướng dẫn cài đặt. Bạn chỉ cần:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeLệnh đầu tải mã nguồn, lệnh thứ hai vào thư mục vừa tải, lệnh thứ ba mở Claude Code ngay trong thư mục đó. Rồi bạn gõ: "set up Sellbird for me". Claude sẽ kiểm tra máy, cài phần 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. Chỗ người mới hay vấp: phải chạy claude đúng trong thư mục sellbird, nếu không nó không đọc được CLAUDE.md.
C.Cách tự làm: cài gói
Nếu muốn tự làm, sau khi đã git clone và cd sellbird như trên, chạy lệnh sau (chép đúng 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 môi trường ảo .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa để có lệnh sellbird. Lưu ý: dòng source .venv/bin/activate là cú pháp macOS/Linux. README chưa ghi cách kích hoạt riêng cho Windows, nên nếu bạn dùng Windows hãy xem thêm mục Troubleshooting trong thư mục docs/ hoặc nhờ Claude Code cài giúp theo cách nhanh ở trên.
D.Điền thông tin xác thực
# 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ở bằng trình soạn thảo mặc định. Hãy điền thông tin hộp thư (Gmail, Microsoft 365 hoặc SMTP/IMAP) và các dịch vụ kiểm tra email nếu bạn dùng. Đừng chia sẻ file .env cho ai và đừng đưa nó lên GitHub.
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.com
# 4. Confirm what makes a good prospect.
sellbird signals --confirm freeThay https://your-company.com bằng website thật của bạn. Lệnh đầu đọc website và ghi kết quả vào sellbird.local.yaml. Lệnh thứ hai để bạn xác nhận những tín hiệu cho thấy một công ty là khách tiềm năng tốt.
F.Tìm khách, mở dashboard và chạy
# 5. Find businesses. The default source is free and needs no account.
sellbird discover
# 6. Open the dashboard and start the loop.
sellbird dashboard # prints a private link to http://127.0.0.1:5555
sellbird runsellbird discover tìm doanh nghiệp từ nguồn miễn phí mặc đị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). sellbird run bật vòng lặp chính; nó chạy theo chu kỳ, nghỉ 15 phút giữa các vòng. README cho biết trên Linux bạn cũng có thể chạy bằng Docker (repo có Dockerfile và docker-compose.yml).
IV.Kiểm tra đã chạy được chưa
Cách đơn giản nhất là chạy sellbird run. README minh hoạ kết quả mong đợi như sau: màn hình báo "Sellbird is online", kiểm tra trạng thái pipeline, đưa ra quyết định tiếp theo (ví dụ viết chiến dịch cho các prospect mới), rồi báo có bao nhiêu email đang chờ bạn duyệt và "Cycle complete".
Bạn cũng kiểm tra bằng cách chạy sellbird dashboard và mở link riêng nó in ra. Nếu thấy giao diện hiện lên, phần cài đặt đã ổn. Nếu lệnh sellbird báo không tìm thấy, thường là bạn quên kích hoạt môi trường ảo .venv trong cửa sổ terminal hiện tại.
Về nơi lưu dữ liệu: nếu chạy từ thư mục đã clone, mọi thứ nằm ngay trong thư mục đó. Nếu cài như gói thông thường, thư mục gốc là %APPDATA%\sellbird trên Windows, ~/Library/Application Support/sellbird trên macOS, ~/.local/share/sellbird trên Linux. Cơ sở dữ liệu, log và mã đăng nhập dashboard nằm trong thư mục con data/.
V.Dùng vào việc thật
A.Chủ phần mềm nhỏ muốn tìm khách đầu tiên
Bạn bán phần mềm đặt lịch cho tiệm nha khoa, thợ sửa mái nhà hay cửa hàng điều hoà (đây cũng chính là ví dụ demo "Bookwell" trong README). Bạn chạy sellbird train với website của mình, xác nhận tín hiệu bằng sellbird signals --confirm free, rồi sellbird discover. Sellbird tìm các doanh nghiệp phù hợp, đọc website để thấy ai chưa có đặt lịch online, tìm người chủ và viết chuỗi email riêng cho từng người. Kết quả: một danh sách thư nháp nằm sẵn trong Outbox, mỗi thư nhắc đúng điều đã thấy ở công ty đó.
B.Người làm sales chỉ cần danh sách sạch
Bạn đã có công cụ gửi thư riêng và chỉ cần danh sách. Chạy các bước tìm và kiểm tra, sau đó dừng lại và gõ:
sellbird exportBạn nhận được file CSV chứa mọi thứ Sellbird tìm được, kèm nhãn verified, risky, guess hoặc invalid cho từng địa chỉ. Bạn có thể chỉ giữ dòng verified để giảm thư bị trả lại.
Sellbird không gửi gì đi nếu bạn chưa gật đầu, nên bạn thử được ngay mà không sợ phát tán nhầm.
Ông T
C.Duyệt thư mỗi sáng trong Outbox
Bạn đang là chủ cửa hàng, không có nhiều thời gian. Mỗi sáng bạn mở dashboard (sellbird dashboard), vào Outbox và đọc các email đang chờ. Trước khi thư rời đi, hệ thống còn tự kiểm tra bằng quy tắc, không dùng mô hình: loại thư còn sót merge tag chưa điền, cụm từ bị cấm, thư quá dài, quá nhiều link hoặc địa chỉ không gửi được. Bạn sửa, duyệt hoặc loại bỏ. Chỉ khi bạn tự bật chế độ autopilot thì Sellbird mới gửi mà không chờ duyệt, và ngay cả khi đó nó vẫn giữ lại thư chứa link tới tên miền không phải của bạn.
D.Xử lý thư trả lời và dừng khẩn cấp
Khi có người trả lời, Sellbird đọc thư, soạn nháp câu đáp (ví dụ khách quan tâm hay phản đối giá), tách thư trả lời tự động ra riêng và ghi nhận ngay những ai từ chối nhận thư. Những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Nếu thấy có gì không ổn, chạy một lệnh để dừng tất cả:
sellbird sending pauseVI.Lỗi hay gặp và cách xử lý
A.Python quá cũ, cài gói báo lỗi
Triệu chứng: pip install -e . báo lỗi về phiên bản Python. Nguyên nhân hay gặp là macOS dùng Python 3.9 mặc định. Cách xử lý: cài python@3.13 bằng Homebrew như README, rồi dùng python3.13 thay cho python3 khi tạo môi trường ảo.
B.Gõ sellbird báo không tìm thấy lệnh
Bạn chưa kích hoạt môi trường ảo trong cửa sổ terminal này, hoặc chưa cài gói. Hãy vào lại thư mục sellbird, kích hoạt .venv, và chạy lại pip install -e ..
C.Claude hoặc Codex CLI chưa đăng nhập
Sellbird dùng gói của bạn thông qua CLI nên nếu chưa đăng nhập thì nó không "suy nghĩ" được. Chạy claude login (với gói Claude) và thử lại. Sellbird còn tự giới hạn tốc độ để chừa chỗ cho việc của bạn, nhưng nếu gói của bạn hết hạn mức thì cần đợi hoặc nâng gói.
D.Email vào thư rác hoặc bị trả lại
Cold email phụ thuộc rất nhiều vào hộp thư gửi. Hãy dùng tên miền gửi riêng, warmup hộp thư trước khi gửi, và chỉ gửi tới địa chỉ có nhãn verified. Đừng bật autopilot khi hộp thư còn mới.
E.Dùng bản Harvey cũ gặp lỗi khi git pull
Nếu bạn từng chạy Harvey và sửa trực tiếp harvey.yaml, git pull sẽ báo "your local changes would be overwritten". README hướng dẫn: chạy git stash, git pull, rồi git stash pop. Tốt hơn, đặt cấu hình riêng vào sellbird.local.yaml vì git không đụng tới file này.
VII.Có nên dùng không
Điểm mạnh. Chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Không cần API key mô hình, tận dụng gói Claude hoặc ChatGPT sẵn có. Mặc định phải duyệt thư trước khi gửi, có bước kiểm tra an toàn không dùng mô hình, có lệnh dừng khẩn cấp. Bạn có thể chỉnh sửa các playbook bán hàng và prompt vì chúng là file nằm ngay trong repo (prompts/, skills/). Có tài liệu khá đầy đủ trong thư mục docs/.
Giới hạn. Bạn vẫn cần biết dùng terminal, tự chuẩn bị hộp thư gửi và warmup, và tự chịu trách nhiệm về quy định gửi email. Nguồn tìm miễn phí (OpenStreetMap) phù hợp nhất với doanh nghiệp địa phương; README không hứa nó phủ được mọi ngành hay mọi quốc gia. Tác giả ghi sẵn ví dụ bằng tiếng Anh, còn việc viết email tiếng Việt chưa được nêu trong tư liệu nên bạn nên thử và đọc kỹ trước khi duyệt. Giấy phép AGPL-3.0 cũng cần để ý nếu bạn định dùng thương mại hay đóng gói lại.
Khi nên 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 trong giai đoạn early access), lo sẵn tên miền gửi, hộp thư và warmup. Còn nếu bạn chỉ cần gửi vài thư thủ công mỗi tuần, một công cụ đơn giản hơn có lẽ đủ dùng.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Mã nguồn mở theo giấy phép AGPL-3.0, tải về dùng được. Bạn cần gói Claude Pro/Max hoặc ChatGPT có Codex sẵn có, và một hộp thư để gửi (README ước tính Google Workspace khoảng 7 USD một tháng). 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ả.
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, không có API key và không tính theo token. Bạn vẫn cần đăng nhập CLI tương ứng, ví dụ bằng `claude login`.
Có cần GPU không?
README không nhắc yêu cầu GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhiệm thông qua CLI, còn Sellbird chạy bằng Python 3.11 trở lên.
Chạy được trên Windows không?
README có nêu thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt trong README viết theo kiểu macOS/Linux, và Docker được ghi là dùng trên Linux. Chưa có hướng dẫn riêng cho Windows trong phần Quick start, bạn nên xem thư mục docs/ hoặc nhờ Claude Code cài giúp.
Email có tự gửi đi mà tôi không biết không?
Mặc định thì không. Mỗi email chờ trong Outbox cho tới khi bạn duyệt, trừ khi bạn tự bật autopilot. Trước khi gửi còn có bước kiểm tra bằng quy tắc, và lệnh `sellbird sending pause` dừng mọi thứ ngay lập tức.
Dữ liệu của tôi lưu ở đâu, có an toàn không?
Cấu hình, kiến thức và dữ liệu nằm trong một thư mục trên máy bạn, gồm cơ sở dữ liệu, log và mã đăng nhập dashboard. Dashboard chạy ở địa chỉ 127.0.0.1 trên máy. Tư liệu không nêu chi tiết thêm về bảo mật, nên hãy tự giữ file `.env` kín.
Khác gì Apollo, ZoomInfo hay Clay?
README ghi rõ Sellbird không dùng các công cụ prospecting như Apollo, ZoomInfo, Clearbit hay Clay. Nó tự tìm công ty, tìm người quyết định và kiểm tra email, rồi viết, gửi và xử lý trả lời trong cùng một hệ thống tự host. Tư liệu không so sánh chi tiết về chất lượng dữ liệu.


