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 tên 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 xử lý phản hồi. Nó chạy trên máy bạn bằng gói Claude Pro/Max hoặc ChatGPT có Codex nên không cần API key của model. Cài bằng vài lệnh, hoặc nhờ Claude Code 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, giúp 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 email riêng cho từng người, gửi đi và xử lý phản hồi. Repo này trước đây tên Harvey, nay đổi thành Sellbird nhưng vẫn là cùng một dự án.
Người nên dùng là chủ doanh nghiệp nhỏ, nhân viên kinh doanh, người làm agency, hoặc lập trình viên muốn tự có một "nhân viên prospecting" mà không phải trả thêm phí cho Apollo, ZoomInfo, Clearbit hay Clay. Điểm đáng giá nhất là Sellbird suy nghĩ bằng Claude Code CLI trên gói Claude Pro hoặc Max của bạn (hoặc Codex trên gói ChatGPT), nên không có API key và không tính tiền theo token. 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, giấy phép AGPL-3.0, và vẫn được cập nhật trong 3 tháng gần đây. Bạn có thể xem video ngắn bên dưới để thấy nó chạy, rồi quay lại đọc phần cài đặt.
ethanplusai/sellbird
Sellbird là nền tảng mã nguồn mở tìm công ty, kiểm tra email, viết và gửi cold email, xử lý phản hồi, chạy bằng gói Claude hoặc ChatGPT bạn đang có.
I.Sellbird làm được gì
Sellbird là một đường ống nhiều bước. Bạn có thể chạy hết hoặc dừng ở bất kỳ bước nào.
- Tìm công ty. Nó tìm doanh nghiệp giống khách hà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í. Mỗi lần tìm trả phí đều hiện chi phí trước khi chạy, nên bạn không bị trừ tiền bất ngờ.
- Tìm lý do họ sẽ mua. Nó đọc website của từng công ty để tìm các tín hiệu 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 model và không tốn chi phí. 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.
- Kiểm tra địa chỉ email. Nó học kiểu địa chỉ email của công ty rồi 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ỉ deliverable mới được gửi tới, nên bạn ít bị trả thư lỗi.
- 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. 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.
- Xử lý phản hồi. Nó đọc mọi thư trả lời và soạn sẵn câu trả lời. Thư tự động trả lời được để riêng, yêu cầu từ chối nhận thư được tôn trọng ngay. Những thư nó không nên tự trả lời thì chuyển cho bạn.
Nếu bạn chỉ cần danh sách khách hàng tiềm năng, 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 mail khác.
Có thêm lớp an toàn: mọi email đi ra đề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 model. Bước này chặn merge tag chưa điền, cụm từ bị cấm, email quá dài, link thừa và địa chỉ không deliverable. Lệnh sellbird sending pause dừng toàn bộ việc gửi ngay lập tứ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
>=3.11. README lưu ý macOS có sẵn Python 3.9, nên nếupython3 --versionbáo 3.9 thì chạybrew install python@3.13trước. - Gói Claude Pro hoặc Max, đã đăng nhập Claude Code CLI bằng
claude login. Hoặc gói ChatGPT có Codex CLI (README có hướng dẫn riêng cho Codex). - 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 cho hộp thư đó. README gợi ý TrulyInbox để "làm nóng" hộp thư mới trước khi gửi cold email. Sellbird đọc tỷ lệ vào inbox từ đây để báo khi nào bạn sẵn sàng. Lưu ý: link TrulyInbox trong dự án là link affiliate, tác giả có thể nhận hoa hồng.
- Hệ điều hành: README viết các lệnh cho macOS và Linux, và nói Linux có thể chạy thêm bằng Docker. Phần mô tả thư mục dữ liệu có nhắc cả Windows (
%APPDATA%\sellbird), nhưng README không có hướng dẫn cài riêng cho Windows.
Chi phí theo README: tìm doanh nghiệp là 0 đồng với nguồn mặc định, hoặc khoảng 0,37 USD cho 1.000 kết quả với nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Hộp thư Google Workspace khoảng 7 USD mỗi tháng.
File .env.example còn liệt kê nhiều biến tùy chọn, ví dụ khóa cho các dịch vụ xác minh email như Reoon, ZeroBounce, Hunter, hoặc thông tin SMTP/IMAP, Gmail, Microsoft 365. Bạn không cần điền hết, chỉ điền phần ứng với dịch vụ bạn thật sự dùng.
III.Cài đặt từng bước
- Chuẩn bịCó Python 3.11+, Claude Code đã đăng nhập, một hộp thư để gửi
- Tải mã nguồngit clone repo rồi cd vào thư mục sellbird
- Cài đặtTạo môi trường ảo và chạy pip install -e .
- Điền thông tinSao chép .env.example thành .env rồi điền
- Dạy SellbirdChạy sellbird train, sellbird signals, sellbird discover
- ChạyMở dashboard bằng sellbird dashboard, rồi sellbird run
Có hai cách. Cách dễ nhất cho người mới là để Claude cài giúp. Cách thứ hai là tự gõ lệnh.
A.Cách dễ: để Claude Code cài giúp
Mở terminal (Terminal trên macOS/Linux), chạy ba lệnh sau. Lệnh đầu tải mã nguồn về, 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 đó.
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeKhi Claude mở ra, bạn gõ: set up Sellbird for me (README viết đúng câu này bằng tiếng Anh). Theo README, file CLAUDE.md trong repo biến Claude Code thành người hướng dẫn cài: nó kiểm tra máy bạn, 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: bạn phải đứng đúng trong thư mục sellbird trước khi gõ claude.
B.Cách tự làm: tải mã nguồn và cài
Sau khi đã git clone và cd sellbird như trên, chạy lệnh dưới đây. Lệnh tạo môi trường ảo .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. README nhấn mạnh phải dùng python3.13, không dùng python3, vì trên macOS python3 trần là bản 3.9.
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .Nếu máy bạn không có python3.13 nhưng đã có Python 3.11 trở lên, bạn cần dùng lệnh tương ứng với bản đó. README chỉ ghi python3.13. Về Windows: dòng source .venv/bin/activate là cú pháp của macOS/Linux. README chưa ghi lệnh kích hoạt môi trường ảo cho Windows, nên người dùng Windows hãy đọc thêm mục Docker và Troubleshooting trong thư mục docs/ của repo, hoặc nhờ Claude Code cài giúp.
C.Điền thông tin vào file .env
Lệnh này tạo file .env từ bản mẫu rồi mở nó ra để sửa. $EDITOR là trình soạn thảo mặc định trên máy bạn. Nếu nó không mở, hãy mở file .env bằng bất kỳ trình soạn thảo văn bản nào.
cp .env.example .env && $EDITOR .envREADME nói mọi biến đều có chú thích ngay trong file. Hãy đọc chú thích rồi điền thông tin hộp thư (Gmail, Microsoft 365 hoặc SMTP) và các dịch vụ bạn dùng. Biến nào bạn không dùng thì cứ để trống.
D.Dạy Sellbird về sản phẩm của bạn
Lệnh train cho Sellbird đọc website công ty bạn để hiểu bạn bán gì, rồi ghi kết quả vào file sellbird.local.yaml. Thay địa chỉ mẫu bằng website thật của bạn.
sellbird train https://your-company.comTiếp theo, xác nhận thế nào là một khách hàng tiềm năng tốt:
sellbird signals --confirm freeSau đó tìm doanh nghiệp. Nguồn mặc định miễn phí và không cần tài khoản:
sellbird discoverE.Mở dashboard và chạy vòng lặp
Lệnh đầu in ra một đường link riêng tư dạng http://127.0.0.1:5555 để bạn mở bằng trình duyệt. Lệnh thứ hai khởi động vòng lặp làm việc của Sellbird.
sellbird dashboard
sellbird runBạn nên mở một cửa sổ terminal cho dashboard và một cửa sổ khác cho sellbird run, vì mỗi lệnh sẽ giữ terminal của nó.
F.Chạy bằng Docker (tùy chọn)
README nói trên Linux bạn có thể chạy bằng Docker, repo có sẵn Dockerfile và docker-compose.yml. README chính chưa ghi lệnh Docker đầy đủ cho cài mới, bạn xem hướng dẫn Docker trong thư mục docs/. Với người nâng cấp từ Harvey, README ghi dịch vụ nay tên là sellbird và dùng chuỗi lệnh docker compose down, git pull, docker compose build, docker compose up -d.
IV.Kiểm tra đã chạy được chưa
Có ba dấu hiệu theo README:
- Lệnh
sellbird dashboardin ra một link riêng tớihttp://127.0.0.1:5555và trang dashboard mở được trong trình duyệt. - Lệnh
sellbird runhiện dòng "Sellbird is online", rồi kiểm tra trạng thái đường ống và đưa ra quyết định cho chu kỳ đó. README minh họa chu kỳ gồm các dòng nhưDecision: write_campaign, các dòng của handler và writer, rồioutbox → 5 emails waiting for your approval. Cuối chu kỳ nó báo hoàn tất và nghỉ 15 phút trước chu kỳ tiếp theo. - Email vừa soạn nằm ở Outbox chờ bạn duyệt, chưa gửi đi.
Nếu bạn muốn thử mà chưa gửi gì, cứ để mặc định: không duyệt trong Outbox thì không có email nào rời máy bạn. Nếu thấy lệnh sellbird báo không tìm thấy, hãy kiểm tra bạn đã kích hoạt môi trường ảo .venv và đã chạy pip install -e . chưa.
Đừng bật autopilot ngay. Hãy duyệt tay trong Outbox vài ngày đầu để xem chất lượng email. File .env chứa mật khẩu hộp thư, đừng đưa lên GitHub hay gửi cho người khác. Cold email có quy định pháp lý và rủi ro bị đánh dấu spam, README có mục Legal and deliverability trong docs, hãy đọc trước khi gửi thật.
V.Dùng vào việc thật
A.Chủ công ty dịch vụ tìm khách địa phương
Bạn bán phần mềm đặt lịch cho các tiệm nha khoa. Bạn chạy sellbird train với website của bạn, rồi sellbird signals --confirm free để chọn các tín hiệu như "chưa có đặt lịch online". Sau đó sellbird discover tìm các phòng khám trên OpenStreetMap. Kết quả là danh sách công ty cùng lý do chúng có thể cần sản phẩm của bạn, và chưa tốn đồng nào cho model.
Công cụ này không thay bạn quyết định gửi gì, nó chỉ làm sẵn phần việc nặng để bạn bấm duyệt.
Ông T
B.Nhân viên kinh doanh duyệt email mỗi sáng
Bạn để sellbird run chạy, mỗi sáng mở dashboard và vào Outbox. Mỗi email đã được viết riêng dựa trên website của người nhận, ví dụ nhắc đến việc công ty đang tuyển một vị trí. Bạn đọc, sửa nếu cần, rồi duyệt. Bạn tiết kiệm được việc tự tra từng công ty và viết từng email, còn quyền quyết định vẫn ở bạn.
C.Người làm agency chỉ cần danh sách
Bạn đã có công cụ gửi mail riêng và chỉ cần lead sạch. Bạn chạy các bước tìm, đọc tín hiệu, tìm người quyết định, kiểm tra email, rồi dừng và chạy:
sellbird exportBạn nhận file CSV các lead đã được gắn nhãn verified, risky, guess hoặc invalid để nhập vào công cụ gửi thư của bạn.
D.Dev cần dừng gửi khẩn cấp
Bạn thấy một mẫu email chưa ổn sau khi đã bật autopilot. Bạn chạy lệnh dưới đây để dừng toàn bộ việc gửi ngay, rồi chỉnh prompt hoặc skill trong thư mục prompts/ và skills/ (README nói các file này đều do bạn chỉnh sửa được) trước khi tiếp tục.
sellbird sending pauseVI.Lỗi hay gặp và cách xử lý
1. Lệnh sellbird báo không tìm thấy. Thường do bạn chưa kích hoạt môi trường ảo hoặc chưa chạy pip install -e .. Mở terminal mới trong thư mục repo, kích hoạt lại .venv rồi chạy lại.
2. Cài lỗi vì Python quá cũ. Repo yêu cầu Python 3.11 trở lên. Trên macOS, python3 trần có thể là 3.9. Hãy cài bản mới như README gợi ý (brew install python@3.13) rồi dùng python3.13 để tạo môi trường ảo.
3. Sellbird không gọi được Claude. README nói bạn cần Claude Code CLI đã đăng nhập bằng claude login. Hãy chạy lệnh đó và đăng nhập lại. README cũng nói Sellbird tự giảm tốc để chừa chỗ cho việc của bạn, nên đôi khi nó chạy chậm là có chủ ý.
4. Email vào spam hoặc bị trả lại. Nguyên nhân hay gặp là hộp thư mới chưa warmup hoặc dùng thẳng tên miền chính. README khuyên dùng tên miền gửi riêng và có warmup. Chi tiết nằm ở tài liệu Legal and deliverability trong repo.
5. git pull báo "your local changes would be overwritten" (khi nâng cấp từ Harvey). Nguyên nhân là bạn đã sửa trực tiếp file harvey.yaml. README hướng dẫn chạy git stash, git pull, rồi git stash pop. Nếu có xung đột, giữ các dòng của bạn, xóa dấu xung đột, rồi chạy git stash drop. Cách tốt hơn là đặt cài đặt trong sellbird.local.yaml, file mà git không đụng tới.
Với các lỗi khác, xem thư mục docs/ của repo, có mục Troubleshooting.
VII.Có nên dùng không
Điểm mạnh. Bạn không phải trả thêm phí API model hay công cụ prospecting đắt tiền, vì nó dùng gói Claude hoặc ChatGPT sẵn có. Dữ liệu và cấu hình nằm trên máy bạn. Nó có nhiều lớp an toàn: duyệt tay mặc định, kiểm tra trước khi gửi, nhãn chất lượng cho từng địa chỉ email, và lệnh dừng khẩn cấp. Mã nguồn mở, prompt và skill chỉnh sửa được.
Giới hạn. Cách cài chính trong README thiên về macOS/Linux dòng lệnh, người dùng Windows sẽ phải tự mò nhiều hơn. Bạn vẫn phải có hộp thư, tên miền gửi và warmup, đây là phần tốn công và tốn tiền nhất của cold email. Giấy phép là AGPL-3.0, nếu bạn định tích hợp vào sản phẩm thương mại thì nên đọc kỹ điều khoản. Mức độ chạy tốt với thị trường và ngôn ngữ Việt Nam, README chưa nói gì, nên bạn nên thử nhỏ trước. Và cold email luôn đi kèm trách nhiệm pháp lý và uy tín tên miền, không phải cứ gửi được là nên gửi.
Khi nào chọn cách khác. Nếu bạn không muốn tự vận hành máy và hộp thư, README nhắc tới bản hosted tại sellbird.ai (đang ở giai đoạn early access) lo sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ cần vài chục lead một lần, tự làm tay hoặc dùng công cụ có sẵn có thể nhanh hơn việc cài cả đường ống này.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Phần mềm là mã nguồn mở, giấy phép AGPL-3.0. Theo README, tìm doanh nghiệp bằng nguồn mặc định là 0 đồng, đọc website cũng 0 đồng. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex, và một hộp thư để gửi (README nêu Google Workspace khoảng 7 USD mỗi tháng).
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 hoặc Max, hoặc qua 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 CLI bằng `claude login`.
Có cần GPU hay máy mạnh không?
Tư liệu không nhắc yêu cầu GPU hay cấu hình phần cứng. Phần suy nghĩ do Claude hoặc Codex xử lý qua gói của bạn, 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 viết lệnh cho macOS và Linux, Docker được nói là dùng 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 trong repo 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 nằm trong Outbox chờ bạn duyệt cho đến khi bạn tự bật autopilot. Ngoài ra có bước kiểm tra trước khi gửi và lệnh `sellbird sending pause` để dừng ngay tất cả.
Dữ liệu của tôi 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 riêng, dashboard là link riêng tư ở địa chỉ 127.0.0.1. Tuy vậy file .env chứa mật khẩu, bạn phải tự giữ kín. Tư liệu không có thêm cam kết nào khác về bảo mật.
Sellbird khác gì Harvey?
Không khác về dự án. Harvey được đổi tên thành Sellbird từ bản 0.4.0, giữ nguyên lịch sử. Cấu hình, dữ liệu và đăng nhập dashboard của người dùng Harvey được chuyển sang tự động, lệnh `harvey` cũ vẫn chạy tạm thời nhưng sẽ bị gỡ ở bản sau.


