Sellbird: tìm khách, viết và gửi cold email chạy 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 tên Harvey) là công cụ mã nguồn mở viết bằng Python, chạy trên máy bạn để tìm khách hàng tiềm năng, xác minh 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 có Codex nên không cần API key của mô hình. Cài cần Python 3.11+, vài lệnh terminal và một hộp thư để gửi, nên hơi kỹ thuật nhưng có chế độ để Claude Code hướng dẫn cài giúp.
Sellbird là một nền tảng mã nguồn mở chạy trên máy của bạn, làm trọn chuỗi việc outreach (chủ động liên hệ khách): 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 cold email riêng cho từng người, gửi đi và xử lý thư trả lời. Repo này trước đây tên Harvey, nay đổi tên thành Sellbird nhưng vẫn là cùng một dự án, cùng lịch sử.
Điểm đáng giá nhất là chuyện chi phí và quyền kiểm soát. Sellbird không gọi API tính tiền theo token. Nó nhờ Claude Code CLI trên gói Claude Pro hoặc Max của bạn, hoặc Codex trên gói ChatGPT, để suy nghĩ và viết nội dung. Mặc định, không email nào được gửi đi nếu bạn chưa duyệt. Hiện repo có khoảng 5.250 sao và 1.127 fork.
Bạn nên đọc bài này nếu bạn làm kinh doanh B2B, làm sales, chạy agency hoặc là dev muốn tự dựng hệ thống tìm khách mà không trả phí cho các công cụ prospecting đắt tiền. Xem video ngắn bên dưới để thấy nó chạy thế nào, rồi quay lại đây làm theo từng bước.
ethanplusai/sellbird
Nền tảng mã nguồn mở 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ý thư trả lời, chạy bằng gói Claude hoặc ChatGPT.
I.Sellbird làm được gì
Sellbird là một dây chuyền. Bạn có thể chạy hết từ đầu đến cuối, hoặc dừng ở bất kỳ bước nào.
A.Tìm công ty phù hợp
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 bằng nguồn 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.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 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 đó. README nói bước này không gọi mô hình và không tốn tiền, mỗi công ty chỉ mất ba request HTTP. Tín hiệu này sau đó được dùng để viết email có nội dung thật, không chung chung.
C.Tìm người ra 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. Bạn không phải mua danh sách liên hệ.
D.Kiểm tra địa chỉ email
Sellbird học mẫu 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. Chỉ địa chỉ gửi được mới được dùng để gửi. Điều này giúp giảm thư trả về và bảo vệ uy tín tên miền gửi của bạn.
E.Viết và gử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. Email 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
Nó đọc mọi thư trả lời, soạn sẵn câu trả lời, tách riêng thư tự động trả lời, 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ư không nên để máy tự trả lời.
G.Chỉ cần danh sách thì dừng sớm
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 dùng được cho công cụ gửi email 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 đi kèm Python 3.9, nên nếu
python3 --versionbáo 3.9 thì chạybrew install python@3.13trước. - Claude Pro hoặc Max đã đăng nhập Claude Code CLI bằng
claude login, hoặc gói ChatGPT có Codex CLI. Phần Codex có hướng dẫn riêng trong thư mục docs 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 chạy được.
- Warmup (làm nóng) cho hộp thư đó. README giới thiệu TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Sellbird đọc được tỷ lệ inbox của công cụ này để báo bạn khi nào sẵn sàng. Đây là gợi ý của tác giả, và README nói rõ các link TrulyInbox là link affiliate.
Hệ điều hành: README viết lệnh theo kiểu macOS/Linux và nhắc Docker cho Linux. README có nói thư mục dữ liệu trên Windows là %APPDATA%\sellbird, nhưng chưa ghi lệnh cài riêng cho Windows. Nếu bạn dùng Windows, hãy xem thư mục docs/ và mục Troubleshooting trong repo.
Phần cứng: tư liệu không nói cần GPU. Vì phần suy nghĩ chạy qua Claude hoặc Codex, có vẻ máy bạn không phải gánh mô hình, nhưng README không nói rõ cấu hình tối thiểu.
Các biến cấu hình trong file .env.example gồm thông tin Gmail, SMTP/IMAP, Microsoft 365, Instantly, LinkedIn, Cloudflare, các dịch vụ xác minh email (Reoon, ZeroBounce, Hunter), TrulyInbox, DataForSEO… Bạn không cần điền hết. README ghi mỗi biến đều có chú thích ngay trong file, và nguồn tìm công ty mặc định không cần tài khoản.
III.Cài đặt từng bước
- Tải mã nguồnClone repo về máy và vào thư mục sellbird
- Cài đặtTạo môi trường ảo Python và cài Sellbird bằng pip
- Điền thông tinSao chép .env.example thành .env rồi điền
- Dạy sản phẩmCho 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
README đưa ra hai cách: nhờ Claude cài hộ, hoặc tự làm. Mình khuyên người mới thử cách thứ nhất.
A.Cách dễ nhất: để Claude hướng dẫn cài
Mở terminal (trên macOS là Terminal, trên Linux là cửa sổ terminal), rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeDòng đầu tải mã nguồn về máy. Dòng hai đi vào thư mục vừa tải. Dòng ba mở Claude Code ngay trong thư mục đó. Đây là chỗ người mới hay vấp: bạn phải đang đứng trong thư mục sellbird thì Claude mới đọc được file CLAUDE.md của repo.
Khi Claude Code mở, bạn gõ: set up Sellbird for me (README ghi đúng câu này bằng tiếng Anh). File CLAUDE.md biến Claude Code thành người hướng dẫn: nó kiểm tra máy bạn, cài những thứ 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.
B.Hoặc tự cài: tạo môi trường và cài gói
Nếu muốn tự làm, sau khi clone và vào thư mục, chạy:
# 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 môi trường ảo tên .venv, kích hoạt nó, rồi cài Sellbird vào đó. Sau khi cài xong, bạn có lệnh sellbird. Lưu ý quan trọng: dùng python3.13 chứ không dùng python3, vì trên macOS python3 trần có thể là bản 3.9 quá cũ. Mỗi lần mở terminal mới, bạn cần kích hoạt lại môi trường ảo bằng source .venv/bin/activate thì lệnh sellbird mới chạy được.
C.Điền thông tin đăng nhập
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .envDòng này sao chép file mẫu thành file .env thật rồi mở ra để bạn sửa. $EDITOR là trình soạn thảo mặc định của máy; nếu máy chưa đặt, bạn có thể mở file .env bằng bất kỳ trình soạn thảo văn bản nào. Điền hộp thư gửi (Gmail, Microsoft 365 hoặc SMTP/IMAP) và các khoá dịch vụ bạn định dùng. Chỉ điền cái bạn cần.
File .env chứa mật khẩu và khoá của bạn. Đừng đưa nó lên GitHub, đừng gửi qua chat. Hãy dùng hộp thư gửi trên tên miền riêng, không dùng hộp thư chính của công ty, vì cold email có thể làm hỏng uy tín tên miền.
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 https://your-company.com bằng website thật của bạn. Sellbird đọc trang web, hiểu bạn bán gì, bán cho ai, và ghi kết quả vào file sellbird.local.yaml. File này là của riêng bạn và git không đụng tới khi bạn cập nhật repo.
E.Xác nhận tín hiệu và tìm doanh nghiệp
# 4. Confirm what makes a good prospect.
sellbird signals --confirm free
# 5. Find businesses. The default source is free and needs no account.
sellbird discoverLệnh đầu xác nhận các tín hiệu cho biết một công ty là khách tốt. Lệnh thứ hai đi tìm doanh nghiệp; nguồn mặc định miễn phí và không cần tài khoản.
F.Mở dashboard và chạy vòng lặp
# 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 địa chỉ trên máy bạn (127.0.0.1:5555), là nơi bạn xem và duyệt mọi thứ. sellbird run khởi động vòng lặp chính. Hai lệnh này thường cần hai cửa sổ terminal riêng, vì mỗi lệnh giữ terminal bận khi chạy.
Nếu bạn dùng Linux, README nói bạn có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, và mục Docker trong thư mục docs/ có hướng dẫn chi tiết. README chính chưa ghi lệnh Docker cho lần cài đầu, nên hãy xem file đó.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra theo tư liệu là chạy sellbird run và xem kết quả. Khi chạy ổn, bạn sẽ thấy dòng chữ kiểu “Sellbird is online”, rồi nó kiểm tra trạng thái dây chuyền và đưa ra quyết định, ví dụ write_campaign khi có người liên hệ mới chưa có bản nháp. Cuối mỗi vòng, nó báo “Cycle complete” và nghỉ 15 phút trước vòng tiếp theo. README còn ví dụ các dòng như writer viết chuỗi 2 email và outbox báo có email đang chờ bạn duyệt.
Bạn cũng nên mở dashboard bằng đường link mà sellbird dashboard in ra. Nếu trang mở được và bạn thấy hộp Outbox, nghĩa là hệ thống đã chạy. Dữ liệu demo trong README là bịa ra (công ty Bookwell bán phần mềm đặt lịch), nên đừng nhầm với khách thật.
V.Dùng vào việc thật
Các tình huống dưới đây bám đúng khả năng được mô tả trong README.
A.Chủ agency tìm khách địa phương
Bạn làm dịch vụ cho phòng khám nha khoa hoặc tiệm sửa điều hoà. Sau khi chạy sellbird train với website của mình, bạn xác nhận các tín hiệu như chưa có đặt lịch online, rồi chạy sellbird discover. Sellbird tìm doanh nghiệp theo nguồn miễn phí, đọc website của họ, tìm chủ hoặc quản lý và kiểm tra email. Bạn nhận được danh sách đã gắn nhãn verified, risky, guess, invalid, và chỉ nhóm gửi được mới vào hàng chờ viết email.
Công cụ này không thay bạn quyết định, nó chuẩn bị sẵn mọi thứ để bạn chỉ việc bấm duyệt.
Ông T
B.Nhân viên sales duyệt email mỗi sáng
Bạn để sellbird run chạy. Email viết xong nằm trong Outbox chờ bạn duyệt, mỗi email mang chi tiết riêng của công ty (ví dụ họ đang tuyển nhân viên điều phối). Bạn mở dashboard, đọc nhanh, sửa chỗ cần sửa, rồi duyệt. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ chặn email còn sót thẻ chưa điền, có cụm từ bị cấm, quá dài, có thêm link hoặc gửi tới địa chỉ không gửi được. Kết quả là bạn kiểm soát được từng email ra khỏi máy.
C.Chỉ cần danh sách để dùng công cụ khác
Bạn đã có công cụ gửi email riêng và chỉ muốn danh sách khách. Bạn chạy train, signals, discover, để Sellbird tìm người và xác minh, rồi dừng lại và chạy:
sellbird exportLệnh này xuất file CSV sẵn để đưa vào công cụ gửi email của bạn, gồm mọi thứ nó đã tìm được. Phù hợp khi bạn muốn tận dụng phần tìm và xác minh miễn phí mà vẫn giữ quy trình gửi cũ.
D.Dev tuỳ chỉnh bài bán hàng
Bạn là lập trình viên muốn đổi cách viết. README nói thư mục prompts/ và skills/ là các kịch bản bán hàng có thể sửa tự do, và repo có tài liệu về cách thêm route, bước trong vòng lặp hay lệnh mới từ một gói riêng (mục Extensions). Bạn sửa prompt cho đúng giọng thương hiệu, rồi chạy lại. Bản cài từ pip sao chép sẵn các file mặc định vào thư mục dữ liệu của bạn và không ghi đè khi nâng cấp, nên chỉnh sửa của bạn được giữ.
Khi muốn dừng khẩn cấp ở bất kỳ tình huống nào, chạy:
sellbird sending pauseLệnh này dừng toàn bộ việc gửi ngay lập tức.
VI.Lỗi hay gặp và cách xử lý
A.Lệnh sellbird báo không tìm thấy
Thường là bạn chưa kích hoạt môi trường ảo trong cửa sổ terminal mới, hoặc chưa cài xong. Hãy vào thư mục sellbird, chạy lại source .venv/bin/activate, và nếu vẫn lỗi thì chạy lại pip install -e ..
B.Python quá cũ trên macOS
Nếu python3 --version báo 3.9, bản này không đủ vì dự án cần 3.11 trở lên. Làm theo README: brew install python@3.13, rồi tạo môi trường bằng python3.13, không dùng python3.
C.Claude hoặc Codex chưa đăng nhập
Sellbird dùng Claude Code CLI trên gói của bạn. Nếu chưa đăng nhập, hãy chạy claude login trước. Nếu bạn dùng ChatGPT, xem hướng dẫn Codex trong thư mục docs/ của repo.
D.Cập nhật từ Harvey bị báo xung đột
Nếu bạn từng chạy Harvey rồi git pull 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 trong sellbird.yaml, giữ các dòng của bạn, xoá dấu xung đột, rồi git stash drop. Cách gọn hơn là đặt thiết lập riêng trong sellbird.local.yaml, vì git không đụng tới file này. Nhớ dừng tiến trình Harvey cũ trước khi cập nhật.
E.Email vào spam hoặc bị trả về
Đây là lỗi rất dễ gặp với mọi công cụ cold email, không riêng Sellbird. Nguyên nhân thường là hộp thư mới chưa warmup hoặc gửi quá nhiều. Hãy warmup hộp thư trước, dùng tên miền gửi riêng, giữ giới hạn gửi mỗi ngày thấp, và đọc mục Legal and deliverability trong docs/ của repo. Nếu gặp lỗi khác, README trỏ tới mục Troubleshooting trong docs/.
VII.Có nên dùng không
Điểm mạnh. Không phải trả tiền API theo token, vì dùng gói Claude hoặc ChatGPT bạn đang có. Phần tìm công ty có nguồn miễn phí, phần đọc website không tốn tiền. Mặc định không gửi gì khi bạn chưa duyệt, có bước kiểm tra trước khi gửi, có lệnh dừng khẩn cấp. Dữ liệu và cấu hình nằm trên máy bạn. Giấy phép AGPL-3.0 (các bản Harvey đến 0.3.x dùng MIT), và repo vẫn được cập nhật trong vài tháng gần đây.
Giới hạn. Đây không phải công cụ bấm một nút là xong. Bạn phải tự lo hộp thư, tên miền gửi và warmup. Tín hiệu mua hàng dựa trên việc đọc website công khai nên hợp nhất với doanh nghiệp nhỏ địa phương như trong ví dụ của README, chưa chắc hợp với mọi ngành. Việc dùng gói đăng ký còn phụ thuộc hạn mức gói của bạn; README nói Sellbird tự giảm tốc để chừa chỗ cho việc của bạn. Lệnh cài trong README viết cho macOS/Linux, còn người dùng Windows nên đọc kỹ tài liệu trong repo.
Cold email có quy định pháp lý riêng tuỳ quốc gia. Hãy đọc mục Legal and deliverability trong repo và kiểm tra luật nơi bạn và người nhận sinh sống trước khi gửi hàng loạt.
Khi nào chọn cách khác. Nếu bạn không muốn đụng terminal, README nói có bản hosted tại sellbird.ai (đang trong 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 cần quy mô lớn với dữ liệu liên hệ có sẵn, hoặc đã có quy trình outreach ổn định, thì có thể chỉ dùng Sellbird để tìm khách và xuất CSV. Còn nếu bạn muốn thử cách làm tự động hoá bán hàng mà vẫn giữ quyền duyệt từng email, Sellbird đáng để chạy thử với một chiến dịch nhỏ.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Mã nguồn miễn phí theo giấy phép AGPL-3.0. Nguồn tìm doanh nghiệp mặc định (OpenStreetMap) và bước đọc website đều tốn $0 theo README. Bạn vẫn cần gói Claude Pro/Max hoặc gói ChatGPT có Codex, một hộp thư gửi (README nêu Google Workspace khoảng 7 USD một tháng) và có thể trả phí cho nguồn tìm hoặc xác minh trả phí nếu chọn.
Sellbird có cần API key của Claude hay OpenAI không?
Không. README nói Sellbird dùng Claude Code CLI trên gói Claude Pro hoặc Max, hoặc Codex trên gói ChatGPT, nên không có API key và không tính tiền theo token. Bạn chỉ cần đăng nhập bằng `claude login`.
Có cần GPU không?
Tư liệu không nhắc tới GPU hay yêu cầu phần cứng. Phần viết nội dung chạy qua Claude hoặc Codex trên gói của bạn. Cấu hình máy tối thiểu thì README chưa có thông tin.
Chạy trên Windows được không?
README viết lệnh cài theo kiểu macOS/Linux và nói Linux có thể dùng Docker. README có nhắc thư mục dữ liệu trên Windows là %APPDATA%\sellbird, nhưng chưa ghi lệnh cài riêng cho Windows. Bạn nên xem thư mục docs/ và mục Troubleshooting trong 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 đều nằm trong Outbox chờ bạn duyệt cho đến khi bạn tự bật autopilot. Trước khi gửi còn có bước kiểm tra không dùng mô hình, và lệnh `sellbird sending pause` dừng mọi thứ ngay.
Dữ liệu của tôi có an toàn không?
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 riêng, dashboard mở ở địa chỉ nội bộ 127.0.0.1:5555 với link đăng nhập riêng. Ngoài ra tư liệu không nói thêm về chính sách bảo mật. Bạn vẫn nên giữ file .env kín, và nếu phát hiện lỗ hổng thì làm theo SECURITY.md của repo.
Tôi đang dùng Harvey thì nâng cấp thế nào?
Harvey được đổi tên thành Sellbird ở bản 0.4.0 và cấu hình, dữ liệu, đăng nhập dashboard đều được giữ. Chạy `git pull`, `pip install -e .` một lần để có lệnh `sellbird`, rồi `sellbird dashboard`. Các biến HARVEY_* vẫn chạy khi chưa có biến SELLBIRD_* tương ứng.


