Sellbird: 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 mã nguồn mở chạy trên máy bạn, tự động hoá cả quy trình cold email: tìm khách hàng tiềm năng, xác minh email, viết thư, gửi và soạn nháp trả lời. Nó dùng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có 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 khi 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 trọn quy trình gửi 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. Trước đây dự án tên là Harvey, nay đã đổi tên thành Sellbird, vẫn là cùng một dự án.
Bạn nên xem qua nếu bạn là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, hay lập trình viên muốn tự động hoá việc tìm khách. Điểm đáng giá nhất là Sellbird chạy bằng gói Claude Pro/Max hoặc gói ChatGPT (qua Codex) bạn đã có. Bạn không cần API key mô hình và không bị tính tiền theo token. Repo hiện có khoảng 5.250 sao và 1.127 fork. Sellbird chạy ngay trên máy bạn, và mặc định không có email nào được gửi đi khi bạn chưa bấm duyệt.
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 ra quyết định, kiểm tra email, viết cold email cá nhân hoá, gử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 đường ống (pipeline). Bạn có thể chạy hết từ đầu đến cuối, hoặc dừng ở bất kỳ bước nào.
- 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, nên khó bị "cháy túi" bất ngờ.
- 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 bạn đã xác nhận, ví dụ chưa có đặt lịch online, đang chạy quảng cáo, hay đ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. README nói 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. Nhờ vậy thư của bạn đến đúng người thay vì hộp thư chung.
- Kiểm tra địa chỉ email. Sellbird học kiểu địa chỉ 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 được gửi thư tới. Việc này giúp bạn hạn chế thư bị trả về, bảo vệ uy tín tên miền 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ý trả lời. Nó đọc mọi thư trả lời, soạn nháp câu đáp, để riêng các thư tự động, tôn trọng yêu cầu từ chối nhận thư ngay lập tức, và chuyển cho bạn những thư nó không nên tự trả lời.
Ngoài ra có hai điểm tiện:
- Nếu bạn chỉ cần danh sách, hãy dừng sau bước kiểm tra email rồi chạy
sellbird exportđể có file CSV dùng được với công cụ gửi thư khác. - Có bảng điều khiển (dashboard) chạy trên máy bạn để xem và duyệt mọi thứ.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Python 3.11 trở lên. Máy Mac thường có sẵn Python 3.9, không đủ. README gợi ý chạy
brew install python@3.13nếupython3 --versionbáo bản cũ. - Gói Claude Pro hoặc Max, và Claude Code CLI đã đăng nhập bằng lệnh
claude login. Hoặc gói ChatGPT kèm Codex CLI (có hướng dẫn riêng trong tài liệu của repo, mục dùng gói ChatGPT). - 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. README nhắc chi phí Google Workspace vào khoảng 7 đô la mỗi tháng.
- Warmup (làm nóng) cho hộp thư đó. Tác giả giới thiệu TrulyInbox, và Sellbird đọc tỷ lệ vào hộp thư đến của nó để báo bạn khi nào đã sẵn sàng. Đây là link affiliate của người duy trì dự án, nên bạn tự cân nhắc.
- Một số khoá tuỳ chọn trong file
.env.example, ví dụ cho dịch vụ xác minh email (REOON, ZEROBOUNCE, HUNTER) hoặc Instantly. Bạn chỉ cần điền thứ mình thực sự dùng.
Về hệ điều hành, README ghi đường dẫn thư mục dữ liệu cho macOS, Windows và Linux. Tuy nhiên các lệnh cài trong README viết theo kiểu macOS/Linux (ví dụ source .venv/bin/activate). README chưa ghi riêng cách làm trên Windows, và Docker được nói là dùng trên Linux.
Cold email dính đến luật và uy tín tên miền. Hãy gửi từ tên miền riêng, làm warmup trước, và đọc tài liệu "Legal and deliverability" trong thư mục docs/ của repo trước khi gửi thật. Không dùng dữ liệu liên hệ thật khi mới thử.
III.Cài đặt từng bước
Có hai cách: để Claude Code hướng dẫn bạn, hoặc tự gõ lệnh.
- Tải mã nguồnClone repo về máy và vào thư mục
- Chọn cách càiĐể Claude Code hướng dẫn, hoặc tự cài bằng venv
- Đ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ách và chạyChạy discover, mở dashboard, rồi chạy run
A.Tải mã nguồn về máy
Mở terminal (Terminal trên Mac, hoặc cửa sổ dòng lệnh bạn quen dùng), chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbirdLệnh đầu tải repo về, lệnh sau đưa bạn vào thư mục sellbird. Mọi lệnh phía dưới đều phải chạy trong thư mục này. Nhiều người mới vấp ở chỗ chạy lệnh ở thư mục khác nên báo không tìm thấy file.
B.Cách dễ nhất: để Claude Code cài giúp
Vẫn trong thư mục sellbird, gõ:
claudeKhi Claude Code mở, bạn nói: "set up Sellbird for me". 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 thiết và dạy Sellbird về sản phẩm của bạn. Cách này hợp với người mới vì bạn không phải tự nhớ từng bước.
C.Hoặc tự cài bằng tay
Chạy lần lượt các lệnh sau, đúng như 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ưu ý dùng python3.13 chứ không phải python3 trên Mac. Lệnh kích hoạt này theo kiểu macOS/Linux. README chưa ghi lệnh tương ứng cho Windows.
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .envLệnh này sao chép file mẫu thành .env rồi mở ra để bạn điền. Mỗi biến đều có chú thích ngay trong file. Bạn điền thông tin hộp thư (Gmail, Microsoft 365 hoặc SMTP) và các khoá dịch vụ bạn định dùng. Đừng chia sẻ file .env cho ai.
# 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 site để hiểu bạn bán gì, rồi ghi kết quả vào sellbird.local.yaml.
# 4. Confirm what makes a good prospect.
sellbird signals --confirm freeBước này xác nhận những tín hiệu cho biết một công ty là khách tiềm năng tốt.
# 5. Find businesses. The default source is free and needs no account.
sellbird discoverNguồn mặc định miễn phí và không cần tài khoản.
# 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 http://127.0.0.1:5555, chỉ mở được trên máy bạn. sellbird run khởi động vòng lặp chính. Nếu cần chạy bằng Docker trên Linux, README chỉ nói là có thể và dẫn tới tài liệu Docker trong thư mục docs/. README chính chưa ghi lệnh chạy Docker từ đầu.
IV.Kiểm tra đã chạy được chưa
Sau khi chạy sellbird run, bạn sẽ thấy dòng chữ kiểu "Sellbird is online", rồi chương trình kiểm tra trạng thái và đưa ra quyết định cho từng chu kỳ. README minh hoạ kết quả như sau:
Sellbird is online.
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
outbox → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.Con số và tên công ty của bạn sẽ khác, nhưng dấu hiệu tốt là có dòng "online", có quyết định cho chu kỳ và có email đang chờ trong Outbox. Rồi mở link từ sellbird dashboard để xem Outbox. Nếu thấy email nháp chờ duyệt mà không có email nào tự đi, nghĩa là mọi thứ đang hoạt động đúng thiết kế.
V.Dùng vào việc thật
A.Chủ cửa hàng dịch vụ muốn có danh sách khách địa phương
Bạn bán phần mềm đặt lịch cho tiệm nha khoa và thợ 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 phù hợp trên OpenStreetMap và đọc website của họ để xem ai chưa có đặt lịch online. Kết quả là một danh sách công ty có lý do cụ thể để bạn liên hệ, không tốn tiền ở bước này.
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 dữ liệu. Bạn chạy pipeline đến bước kiểm tra email, rồi chạy:
sellbird exportBạn nhận một file CSV tương thích với công cụ gửi thư, gồm những gì Sellbird tìm được. Mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid, nên bạn lọc được các địa chỉ rủi ro trước khi nạp vào công cụ khác.
Không email nào rời máy bạn nếu bạn chưa bấm duyệt.
Ông T
C.Người làm một mình muốn gửi thư nhưng vẫn kiểm soát
Bạn chạy sellbird run, để vòng lặp tự viết chuỗi thư (ví dụ hai email nhắc tới việc công ty đang tuyển người đ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. Trước khi gửi, bước kiểm tra không dùng mô hình sẽ loại thư còn sót thẻ chưa điền, cụm từ bị cấm, thư quá dài, thừa link hoặc địa chỉ không gửi được. Nếu thấy chưa ổn, sellbird sending pause dừng mọi thứ ngay.
D.Dev muốn trả lời khách nhanh hơn
Khi khách phản hồi, Sellbird đọc thư, soạn nháp câu trả lời cho các thư quan tâm hoặc phản đối, đặt riêng thư tự động và xử lý yêu cầu từ chối ngay. Bạn chỉ phải xem những thư nó không nên tự trả lời. Với người ít thời gian, đây là phần giúp giảm việc lặp lại nhiều nhất.
VI.Lỗi hay gặp và cách xử lý
- Lệnh
python3 --versionbáo 3.9 trên Mac. Python quá cũ so với yêu cầu 3.11 trở lên. Cài bản mới bằngbrew install python@3.13rồi dùngpython3.13khi tạo môi trường ảo, đúng như README. - Không có lệnh
sellbird. Thường do chưa kích hoạt môi trường.venvhoặc chưa chạypip install -e .. Mở terminal mới trong thư mụcsellbird, kích hoạt lại venv rồi cài lại. - Claude hoặc Codex chưa đăng nhập. Sellbird dựa vào CLI đã đăng nhập. Chạy
claude loginvới Claude, hoặc làm theo tài liệu Codex nếu dùng ChatGPT. - Gửi thư không được hoặc vào spam. Kiểm tra lại thông tin hộp thư trong
.env, và chắc rằng hộp thư đã warmup. README khuyên dùng tên miền gửi riêng và theo dõi tỷ lệ vào hộp thư đến. Xem thêm mục Troubleshooting và Legal and deliverability trongdocs/. git pullbị chặn khi nâng cấp từ Harvey. README nói nguyên nhân là bạn đã sửa trực tiếp fileharvey.yaml. Chạygit stash,git pull, rồigit stash pop. Về lâu dài hãy đặt cài đặt trongsellbird.local.yaml, file mà git không đụng tới.
VII.Có nên dùng không
Điểm mạnh: chạy trên máy bạn, dùng gói Claude hoặc ChatGPT sẵn có nên không phải trả phí API mô hình. Nguồn tìm công ty mặc định miễn phí, chi phí trả phí đều hiện trước khi chạy. Mặc định mọi thư phải được bạn duyệt, lại có bước kiểm tra tự động trước khi gửi. Mã nguồn mở, có tài liệu khá đầy đủ và repo còn được cập nhật trong vài tháng gần đây.
Giới hạn:
- Bạn vẫn cần hộp thư gửi, tên miền riêng và warmup, nên không hoàn toàn "miễn phí".
- README chưa có hướng dẫn riêng cho Windows.
- Chất lượng nguồn dữ liệu miễn phí phụ thuộc vào OpenStreetMap, vốn có thể thiếu doanh nghiệp ở một số nơi. README chưa nói gì về độ phủ ở Việt Nam, nên bạn nên thử nhỏ trước.
- Giấy phép là AGPL-3.0, bạn nên đọc kỹ nếu định tích hợp vào sản phẩm thương mại.
- Cold email có ràng buộc pháp lý. Hãy đọc tài liệu pháp lý trong repo và luật nơi bạn gửi.
Nếu bạn không muốn tự vận hành, README có nhắc bản host sellbird.ai (đang trong giai đoạn early access). Nếu chỉ cần gửi thư hàng loạt từ danh sách có sẵn, một công cụ gửi email thông thường sẽ đơn giản hơn. Còn nếu bạn muốn một quy trình từ tìm khách đến trả lời, do chính bạn kiểm soát, Sellbird đáng để thử.
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. Nguồn tìm công ty mặc định miễn phí, nguồn trả phí rẻ nhất khoảng 0,37 đô la cho 1.000 kết quả theo README. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT và một hộp thư gửi (README nhắc Google Workspace khoảng 7 đô la mỗi tháng).
Sellbird có cần API key của Claude hoặc OpenAI không?
Không. Sellbird dùng Claude Code CLI trên gói Claude Pro/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. Một số dịch vụ tuỳ chọn như xác minh email thì có khoá riêng trong file .env.
Có cần GPU hay máy mạnh không?
Tư liệu không nhắc tới yêu cầu GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhận qua gói đăng ký của bạn, còn Sellbird chạy bằng Python 3.11 trở lên.
Chạy được trên Windows không?
README có ghi thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt viết theo kiểu macOS/Linux và chưa có hướng dẫn riêng cho Windows. Docker được nói là dùng trên Linux. Bạn nên xem mục 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 tới khi bạn duyệt, trừ khi bạn tự bật chế độ autopilot. Bạn cũng có thể dùng 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ấ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ơ sở dữ liệu, nhật ký và token đăng nhập dashboard. Dashboard chạy ở địa chỉ 127.0.0.1 trên máy bạn. Tư liệu chưa nói chi tiết hơn về việc dữ liệu được gửi đi đâu khi bạn dùng các dịch vụ bên thứ ba.
Tôi đang dùng Harvey thì nâng cấp thế nào?
Harvey được đổi tên thành Sellbird từ bản 0.4.0, cấu hình và dữ liệu được giữ lại. Bạn chạy `git pull`, `pip install -e .` rồi `sellbird dashboard`. Lần chạy đầu Sellbird tự đổi tên các file cũ và không ghi đè file đã có tên mới.


