Sellbird: tìm khách, viết và gửi cold email chạy trên gói Claude/ChatGPT — 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 để làm outreach: tìm công ty hợp với khách hàng của bạn, tìm người quyết định, xác minh 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 có Codex nên không cần API key mô hình. Cài đặt cần Python 3.11 trở lên và vài lệnh, mặc định không email nào được gửi nếu bạn chưa duyệt.
Sellbird là một nền tảng mã nguồn mở viết bằng Python, giúp bạn làm cả vòng bán hàng bằng email lạnh (cold 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 thư 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 repo có khoảng 5250 sao và 1127 fork.
Bạn nên xem qua nếu bạn là chủ doanh nghiệp nhỏ, người làm sales, marketing hoặc lập trình viên muốn có danh sách khách tiềm năng mà không phải trả tiền cho các công cụ prospecting đắt đỏ. Repo nói rõ là không dùng Apollo, ZoomInfo, Clearbit hay Clay.
Đ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. Không có API key mô hình, không tính tiền theo token. Và 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. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi 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á, gửi đi và xử lý thư trả lời, chạy trên gói Claude hoặc ChatGPT.
I.Sellbird làm được gì
Sellbird là một đường ống (pipeline). Bạn có thể chạy cả đường, hoặc dừng ở bất kỳ bước nào.
A.Tìm công ty
Nó tìm các 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ờ.
B.Tìm lý do 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, hoặc đang tuyển một vị trí nào đó. Bước này không gọi mô hình, không tốn phí, mỗi công ty chỉ cần ba request HTTP. Kết quả là thư của bạn có lý do cụ thể để viết, thay vì gửi đại trà.
C.Tìm người quyết định
Nó tìm chủ hoặc quản lý được nêu tên ngay trên các trang của công ty, tối đa hai người mỗi công ty. Bạn không cần tự lục LinkedIn từng nơi.
D.Kiểm tra địa chỉ email
Sellbird học 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. Chỉ địa chỉ gửi được mới được dùng để gửi. Điều này bảo vệ uy tín tên miền gửi của bạn, vì gửi nhiều thư bị trả về rất dễ khiến hộp thư bị đánh dấu spam.
E.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, rồi 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.
F.Xử lý thư trả lời
Sellbird đọc mọi thư trả lời, soạn nháp câu đáp, tách riêng thư tự động trả lời, tôn trọng yêu cầu ngừng nhận ngay lập tức, và chuyển cho bạn những thư nó không nên tự trả lời.
G.Chỉ cần danh sách
Nếu bạn chỉ muốn danh sách khách, hãy dừng sau bước xác minh và chạy sellbird export để có file CSV sẵn sàng đưa vào công cụ gửi thư khác.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Python 3.11 trở lên. File pyproject.toml cũng yêu cầu Python từ 3.11. README lưu ý macOS có sẵn Python 3.9, nên nếu
python3 --versionbáo 3.9 thì cài bản mới bằngbrew install python@3.13. - Claude Pro hoặc Max đã đăng nhập 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 dùng được.
- Warmup (làm nóng) hộp thư đó. README giới thiệu TrulyInbox cho việc này. Đây là liên kết tiếp thị của tác giả, bạn không bắt buộc dùng.
Về 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 đô la cho 1.000 doanh nghiệp, đọc website không tốn phí, và hộp thư Google Workspace khoảng 7 đô la mỗi tháng. Tư liệu không nói gì về yêu cầu GPU hay RAM.
Bạn sẽ gửi email thật tới người thật từ tên miền của bạn. Hãy dùng tên miền gửi riêng, không dùng tên miền chính của công ty. Đọc kỹ phần Legal and deliverability trong thư mục docs của repo về các quy định bạn phải tuân thủ trước khi bật gửi.
III.Cài đặt từng bước
- Lấy mã nguồnTải repo về máy bằng git clone
- 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
- Huấn luyệnCho Sellbird đọc website của bạn
- Tìm kháchXác nhận tín hiệu và chạy discover
- ChạyMở dashboard và bắt đầu vòng lặp
Có hai đường: nhờ Claude cài giúp, hoặc tự gõ lệnh. Người mới nên thử đường đầu.
A.Cách 1: để Claude cài giúp
Mở terminal (trên Windows có thể dùng PowerShell hoặc Git Bash), rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeDòng đầu tải repo về. Dòng hai đi vào thư mục vừa tải. Dòng ba mở Claude Code ngay trong thư mục đó. Sau đó 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 thứ cần hỏi và huấn luyện Sellbird về sản phẩm của bạn.
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.Cách 2: tự cài
Bước đầu là tạo môi trường ảo và cài gói. README viết:
# 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ột thư mục môi trường ảo .venv, 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ệnh source .venv/bin/activate là của macOS/Linux. README chưa ghi lệnh kích hoạt cho Windows, nên nếu dùng Windows bạn nên xem mục Troubleshooting và Docker trong thư mục docs của repo, hoặc nhờ Claude Code cài theo Cách 1.
C.Điền thông tin đăng nhập
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .envLệnh này sao chép file mẫu .env.example thành .env, rồi mở ra để bạn sửa. File mẫu có chú thích cho từng biến. Bạn chỉ điền phần mình dùng, ví dụ SMTP_HOST, SMTP_USERNAME, SMTP_PASSWORD nếu gửi bằng SMTP, hoặc GMAIL_CLIENT_ID và GMAIL_CLIENT_SECRET nếu dùng Gmail. Các khoá của dịch vụ xác minh email (Reoon, ZeroBounce, Hunter) và cổng gửi thư khác cũng nằm trong file này. Đừng gửi file .env cho ai và đừng đưa nó lên GitHub.
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 web và ghi hiểu biết vào file sellbird.local.yaml. File này là của riêng bạn, git không đụng tới.
E.Xác nhậ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 chốt những tín hiệu cho biết một công ty là khách tốt. Bước 5 đi tìm doanh nghiệp bằng nguồn mặc định, miễn phí và không cần tài khoản.
F.Mở dashboard 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 dẫn riêng tư tới địa chỉ trên máy bạn (127.0.0.1:5555). sellbird run bắt đầu vòng lặp, mỗi chu kỳ nó kiểm tra trạng thái và làm việc cần làm. Nên mở dashboard ở một cửa sổ terminal, chạy run ở cửa sổ khác.
README cũng nói trên Linux bạn có thể chạy bằng Docker. Trong hướng dẫn nâng cấp có các lệnh docker compose build và docker compose up -d. Chi tiết cài Docker, xem tài liệu Docker trong thư mục docs.
IV.Kiểm tra đã chạy được chưa
Cách đơn giản nhất: chạy sellbird dashboard và mở đường dẫn riêng nó in ra. Nếu thấy giao diện dashboard, phần cài đặt đã ổn.
Sau đó chạy sellbird run. Theo README, màn hình sẽ hiện dòng “Sellbird is online”, rồi “Checking pipeline state...”, rồi một dòng “Decision” cho biết nó định làm gì tiếp, ví dụ viết chiến dịch cho các prospect mới chưa có thư nháp. Cuối chu kỳ nó báo “Cycle complete” và nghỉ 15 phút. Nếu bạn thấy các email đang “waiting for your approval” trong Outbox, nghĩa là mọi thứ chạy đúng và chưa có gì được gửi đi.
Muốn dừng khẩn cấp, chạy sellbird sending pause. Lệnh này dừng toàn bộ việc gửi ngay lập tức.
V.Dùng vào việc thật
Trước hết cần nhớ một điều: Sellbird gom mọi email vào hộp Outbox chờ bạn duyệt, chỉ bật autopilot khi chính bạn quyết định.
Mặc định không có email nào được gửi nếu bạn chưa bấm duyệt, nên thử nghiệm trước rất an toàn.
Ông T
A.Chủ doanh nghiệp dịch vụ cần tìm khách địa phương
Bạn bán phần mềm đặt lịch cho phòng khám nha khoa hoặc tiệm sửa điều hoà. Bạn chạy sellbird train với website của mình, rồi sellbird signals --confirm free và sellbird discover. Sellbird tìm các doanh nghiệp tương ứng bằng OpenStreetMap, đọc website của họ để tìm tín hiệu như “chưa có đặt lịch online”. Kết quả: bạn có danh sách công ty kèm lý do cụ thể để liên hệ, mà không tốn phí nguồn dữ liệu. Bản demo trong README cũng chính là kịch bản này: một công ty tưởng tượng tên Bookwell bán đặt lịch cho thợ lợp mái, nha khoa và tiệm điều hoà.
B.Nhân viên 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 đã kiểm tra. Bạn chạy các bước tìm và xác minh, rồi dừng lại và gõ:
sellbird exportBạn nhận một file CSV sẵn sàng đưa vào công cụ gửi thư, gồm những người và công ty nó tìm được, kèm nhãn trạng thái của từng địa chỉ email (verified, risky, guess, invalid). Bạn có thể chỉ lấy địa chỉ gửi được để giảm tỷ lệ thư trả về.
C.Người làm một mình muốn thư viết sẵn, mình chỉ duyệt
Bạn đã nối hộp thư Gmail hoặc SMTP. Chạy sellbird run, để nó chạy nền. Sau mỗi chu kỳ, bạn mở dashboard, vào Outbox, đọc từng email nháp, sửa nếu cần rồi duyệt. Sellbird viết chuỗi email ngắn dựa trên điều nó tìm được về công ty, ví dụ “công ty đang tuyển nhân viên điều phối”. Kết quả: bạn chỉ mất vài phút duyệt thay vì viết từng thư. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ loại các thư còn sót mã điền tự động, cụm từ bị cấm, thư quá dài, thừa liên kết hoặc địa chỉ không gửi được.
D.Lập trình viên muốn tuỳ biến cách bán hàng
Repo có các thư mục prompts/ và skills/, README mô tả là các “sales playbook” bạn có thể sửa. Bạn chỉnh các file này để thay đổi giọng văn hoặc cách xử lý phản hồi. Repo cũng có phần Extensions để thêm route, bước heartbeat và lệnh từ một gói riêng. Chi tiết nằm trong tài liệu Skills and sub-agents và Extensions trong thư mục docs.
VI.Lỗi hay gặp và cách xử lý
A.Python quá cũ khiến lệnh cài báo lỗi
Trên macOS, python3 thường là 3.9, trong khi Sellbird cần 3.11 trở lên. Hãy cài bản mới (brew install python@3.13) và dùng đúng python3.13 khi tạo môi trường ảo, như README dặn.
B.Gõ sellbird báo không tìm thấy lệnh
Thường là vì môi trường ảo chưa được kích hoạt, hoặc bạn mở terminal mới. Hãy kích hoạt lại môi trường ảo trong thư mục repo rồi thử lại. Nếu dùng Windows, README chưa ghi lệnh kích hoạt, nên hãy xem mục Troubleshooting trong docs.
C.Lệnh claude không chạy hoặc Sellbird không “suy nghĩ” được
Sellbird dựa vào Claude Code CLI đã đăng nhập (claude login) trên gói Pro hoặc Max, hoặc Codex trên gói ChatGPT. Hãy kiểm tra bạn đã cài CLI và đăng nhập đúng tài khoản có gói đó chưa. Nếu dùng ChatGPT, xem hướng dẫn Using a ChatGPT plan (Codex) trong docs.
D.Nâng cấp từ Harvey bị git chặn
Nếu bạn từng sửa trực tiếp file harvey.yaml, lệnh git pull sẽ dừng với thông báo “your local changes would be overwritten”. README hướng dẫn: chạy git stash, git pull, rồi git stash pop. Nếu có xung đột trong sellbird.yaml, giữ phần bạn sửa, xoá dấu xung đột, rồi chạy git stash drop. Tốt nhất là đặt cấu hình riêng trong sellbird.local.yaml.
E.Thư dễ rơi vào spam hoặc bị trả về
Đây là rủi ro chung của cold email, không riêng Sellbird. Hãy gửi từ tên miền riêng, làm warmup hộp thư trước khi gửi, giữ mức gửi mỗi ngày thấp và chỉ gửi tới địa chỉ đã xác minh. Sellbird tự giới hạn theo hạn mức mỗi ngày và giờ làm việc của người nhận, và theo README còn đọc tỷ lệ inbox của TrulyInbox để báo bạn khi nào sẵn sàng.
VII.Có nên dùng không
Điểm mạnh. Không phải trả tiền API cho mô hình nếu bạn đã có gói Claude hoặc ChatGPT. Nguồn tìm khách mặc định miễn phí. Mọi thứ chạy trên máy bạn, và dữ liệu nằm trong thư mục của bạn. Có nhiều lớp an toàn: duyệt thủ công mặc định, kiểm tra trước khi gửi, tôn trọng yêu cầu ngừng nhận, lệnh dừng khẩn. Repo vẫn được cập nhật trong vài tháng gần đây.
Giới hạn. Đây là công cụ dòng lệnh, người chưa quen terminal sẽ cần thời gian làm quen. README chưa ghi lệnh kích hoạt môi trường ảo cho Windows. Bạn vẫn phải tự lo hộp thư gửi, tên miền riêng và warmup. Giấy phép là AGPL-3.0 (các bản Harvey đến 0.3.x dùng MIT), nếu bạn định đóng gói thành dịch vụ cho người khác thì nên đọc kỹ giấy phép. Ngoài ra, cold email có quy định pháp lý khác nhau theo từng nước. Bạn tự chịu trách nhiệm tuân thủ.
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) với tên miền gửi, hộp thư và warmup được thiết lập sẵn. Nếu bạn chỉ cần vài lead thủ công, một bảng tính và email tay có thể đã đủ. Còn nếu bạn muốn thử cách tự động hoá tìm khách mà vẫn kiểm soát từng thư, Sellbird là lựa chọn đáng cân nhắc, miễn là bạn bắt đầu với chế độ duyệt tay.
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. Theo README, nguồn tìm doanh nghiệp mặc định là 0 đồng, nguồn trả phí rẻ nhất khoảng 0,37 đô la cho 1.000 doanh nghiệp. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT, và một hộp thư gửi (README nêu Google Workspace khoảng 7 đô la mỗi tháng).
Sellbird có cần API key của Claude hay OpenAI không?
Không. README ghi Sellbird chạy qua Claude Code CLI trên gói Claude Pro hoặc Max, hoặc qua 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 bằng `claude login`.
Có cần GPU hay máy cấu hình mạnh không?
Tư liệu không nêu yêu cầu GPU hay RAM. Phần suy nghĩ do Claude hoặc Codex đảm nhiệm, còn yêu cầu duy nhất được nêu rõ là Python 3.11 trở lên.
Sellbird có tự gửi email mà tôi không biết không?
Không, mặc định thì không. Mọi email chờ trong Outbox cho bạn duyệt cho đến khi chính bạn 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 nằm ở đâu, 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 chung (database, log, token dashboard nằm trong thư mục data). Dashboard mặc định mở ở địa chỉ nội bộ 127.0.0.1:5555. Tư liệu không nói thêm về các đảm bảo bảo mật khác, nên bạn nên đọc SECURITY.md trong repo.
Chạy được trên Windows không?
README có nêu thư mục dữ liệu trên Windows (trong APPDATA), nhưng các lệnh cài đặt mẫu theo kiểu macOS/Linux và README chưa ghi lệnh kích hoạt môi trường ảo cho Windows. README nói Docker dùng được trên Linux. Bạn nên xem mục Troubleshooting và Docker trong thư mục docs.
Tôi đang dùng Harvey thì có phải cài lại không?
Không. Harvey đã đổi tên thành Sellbird từ bản 0.4.0, cấu hình, dữ liệu và đăng nhập dashboard được giữ lại. Bạn chạy `git pull`, rồi `pip install -e .` một lần để có lệnh `sellbird` mới. Các biến HARVEY_* vẫn dùng được khi chưa đặt biến SELLBIRD_* tương ứng.


