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 doanh nghiệp 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ý 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 của mô hình. Cài đặt cần Python 3.11 trở lên và vài lệnh, mặc định không gửi gì khi bạn chưa duyệt.
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 quy trình bán hàng chủ động qua 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. 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.
Ai nên dùng? Chủ doanh nghiệp nhỏ, người làm sales, agency hoặc lập trình viên muốn tự động hoá việc tìm khách mà không muốn trả tiền cho cả bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Sellbird không dùng những công cụ đó. Hiện repo có khoảng 5250 sao và 1127 fork.
Điểm đáng giá nhất có hai ý. Thứ nhất, phần “suy nghĩ” chạy 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, nên không có API key mô hình và không tính tiền theo token. Thứ hai, mặc định mọi email đều nằm chờ trong hộp Outbox cho bạn duyệt rồi mới đi. 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 đi và soạn sẵn câu 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ước nào tuỳ ý.
A.Tìm công ty phù hợp
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í và không cần tài khoản. Bạn cũng có thể chọn một 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.Hiểu vì sao 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, hoặc đ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, theo README chỉ cần ba request HTTP cho mỗi công ty. Tín hiệu này sau đó trở thành chất liệu để viết thư có nội dung thật, không phải thư 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 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 phải mua danh sách liên hệ ở đâu cả.
D.Kiểm tra địa chỉ email
Sellbird học quy luật đặt 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ỉ gửi được mới nhận thư. Việc này giúp giảm thư bị trả lại, thứ làm hại uy tín tên miền gửi của bạn.
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. Việc gửi tuân theo giới hạn mỗi ngày và 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 đáp, tách riêng thư tự động, tôn trọng yêu cầu từ chối 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.Xuất danh sách
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. Bạn sẽ có một 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 đúng mức này. Máy Mac thường có sẵn Python 3.9, nên nếu
python3 --versionbáo 3.9 thì chạybrew install python@3.13trước. - Gói Claude Pro hoặc Max với Claude CLI đã đăng nhập (lệnh
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) cho hộp thư đó. README gợi ý TrulyInbox, và Sellbird đọc tỉ lệ vào inbox của công cụ này để báo bạn khi nào đã sẵn sàng. Lưu ý: link TrulyInbox trong dự án là link affiliate, người bảo trì có thể nhận hoa hồng.
Về chi phí, README nêu: 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 website là 0 đồng. Hộp thư Google Workspace khoảng 7 USD mỗi tháng.
File .env.example liệt kê các biến cấu hình tuỳ chọn như Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ kiểm tra email (Reoon, ZeroBounce, Hunter) và TrulyInbox. Bạn chỉ điền những gì mình thật sự dùng. Chưa có thông tin trong tư liệu về yêu cầu phần cứng.
Cold email có luật riêng ở từng nước và ảnh hưởng đến uy tín tên miền của bạn. 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. Nên 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.
III.Cài đặt từng bước
README có hai cách: nhờ Claude Code hướng dẫn cài, hoặc tự gõ lệnh. Các lệnh trong README viết theo kiểu macOS/Linux. README chưa ghi lệnh kích hoạt môi trường ảo riêng cho Windows, bạn xem thêm trong thư mục docs/ của repo.
- Tải mã nguồnDùng git clone rồi cd vào thư mục sellbird
- Cài đặtTạo môi trường ảo Python 3.13 và cài gói bằng pip
- Đ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
- Chọn tín hiệu và tìm kháchChạy sellbird signals và sellbird discover
- Mở bảng điều khiển và chạyChạy sellbird dashboard rồi sellbird run
A.Tải mã nguồn về máy
Mở terminal (Terminal trên Mac/Linux, hoặc Git Bash/PowerShell trên Windows), đi tới thư mục bạn muốn đặt dự án rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbirdLệnh đầu tải repo về, lệnh sau đi vào thư mục vừa tải. Mọi lệnh phía sau đều phải chạy trong thư mục này.
B.Cách dễ nhất: để Claude cài giúp
Nếu bạn đã có Claude Code, chạy tiếp:
claudeRồi gõ: set up Sellbird for me (nhờ Sellbird cài giúp tôi). 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ông tin cần thiết và dạy Sellbird về sản phẩm của bạn. Với người mới, đây là cách ít vấp nhất.
C.Hoặc tự cài từng lệnh
Tạo môi trường ảo và cài gói:
# 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 thư mục .venv (môi trường Python riêng cho dự án), kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Chỗ hay vấp: trên Mac, đừng gõ python3 trần vì đó là bản 3.9, quá cũ.
Tiếp theo, tạo file cấu hình:
# 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ở bằng trình soạn thảo của bạn. Mỗi biến đều có chú thích ngay trong file. Bạn điền thông tin hộp thư gửi, và key của các dịch vụ tuỳ chọn nếu dùng. Không chia sẻ file .env cho ai.
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 thật của công ty bạn. Sellbird đọc trang web và ghi kết quả vào file sellbird.local.yaml, nên các thiết lập của bạn nằm riêng, không bị git ghi đè.
Xác nhận thế nào là khách tiềm năng tốt, rồi 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 discoverBước 4 chọn các tín hiệu mua hàng. Bước 5 tìm doanh nghiệp từ nguồn mặc định, miễn phí, không cần tài khoản.
Cuối cùng, mở bảng điều khiển và bắt đầu 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), chỉ bạn truy cập được. sellbird run khởi động vòng lặp làm việc.
Trên Linux, README nói bạn cũng có thể chạy bằng Docker (repo có Dockerfile và docker-compose.yml). Chi tiết xem tài liệu Docker trong docs/.
IV.Kiểm tra đã chạy được chưa
Sau khi chạy sellbird run, README cho thấy màn hình mong đợi gần như sau:
Sellbird is online.
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
writer → 2-email sequence: Phoenix HVAC hiring a dispatcher
outbox → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.Những dấu hiệu cho biết mọi thứ ổn:
- Dòng “Sellbird is online” xuất hiện, rồi nó báo quyết định của chu kỳ (ví dụ viết chiến dịch cho prospect mới).
- Có dòng “emails waiting for your approval”: nghĩa là thư đã soạn xong và đang chờ bạn duyệt ở Outbox, chưa gửi đi.
- Cuối chu kỳ nó báo đang nghỉ 15 phút rồi lặp lại.
- Mở link do
sellbird dashboardin ra thì thấy bảng điều khiển trên trình duyệt.
Nếu lệnh sellbird báo không tìm thấy, thường là môi trường ảo chưa được kích hoạt hoặc bước cài gói chưa chạy xong.
V.Dùng vào việc thật
Sellbird có dữ liệu demo bịa ra: công ty “Bookwell” bán phần mềm đặt lịch online cho thợ lợp mái, phòng khám nha và tiệm điều hoà, trên các tên miền .test. Bạn có thể bắt chước cách đó cho việc của mình. Dưới đây là bốn tình huống bám đúng khả năng trong README.
A.Chủ công ty phần mềm nhỏ tìm khách đầu tiên
Bạn bán phần mềm đặt lịch cho tiệm làm đẹp và chưa có đội sales. Bạn chạy sellbird train với website công ty để Sellbird hiểu sản phẩm, rồi sellbird signals --confirm free để xác nhận tín hiệu, ví dụ tiệm chưa có đặt lịch online. Sau sellbird discover, Sellbird liệt kê các tiệm phù hợp, tìm chủ tiệm và kiểm tra email. Kết quả là một danh sách khách có lý do cụ thể để liên hệ, chưa tốn đồng nào cho nguồn dữ liệu mặc định.
Chỉ cần dừng ở bước kiểm tra email là bạn đã có sẵn một danh sách khách đã được xác minh.
Ông T
B.Nhân viên sales chỉ cần danh sách sạch
Công ty bạn đã có phần mềm gửi email hàng loạt và chỉ thiếu danh sách. Bạn chạy các bước tìm và kiểm tra, rồi dùng lệnh:
sellbird exportBạn nhận về file CSV gồm mọi thứ Sellbird tìm được, sẵn sàng nhập vào công cụ gửi thư của mình. Mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid, nên bạn lọc được địa chỉ rủi ro trước khi gửi.
C.Chủ agency duyệt thư mỗi sáng
Bạn chạy sellbird run và để nó tự làm theo chu kỳ 15 phút. Mỗi sáng, bạn mở bảng điều khiển bằng sellbird dashboard, vào Outbox xem các email đang chờ duyệt, sửa vài câu rồi bấm duyệt. Với thư trả lời của khách, Sellbird đã soạn sẵn câu đáp và đánh dấu loại thư (quan tâm, phản đối…). Những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Bạn mất vài phút mỗi ngày thay vì cả buổi.
D.Dev muốn dừng gấp hoặc tự chỉnh playbook
Bạn thấy thư gửi có vấn đề và muốn dừng ngay. Chạy:
sellbird sending pauseLệnh này dừng mọi việc gửi đi cùng lúc. Với dev muốn tuỳ biến, README nói các file prompts/ và skills/ là playbook bán hàng có thể chỉnh sửa, và dự án hỗ trợ phần mở rộng bằng gói riêng (xem tài liệu Extensions và Skills and sub-agents trong docs/).
VI.Lỗi hay gặp và cách xử lý
A.Chạy sai phiên bản Python trên Mac
Nếu bạn gõ python3 trên Mac, có thể đang dùng bản 3.9, thấp hơn yêu cầu 3.11. Hãy cài bản mới bằng brew install python@3.13 rồi dùng python3.13 khi tạo môi trường ảo, đúng như README dặn.
B.Claude CLI chưa đăng nhập
Sellbird cần Claude Code CLI đã đăng nhập vào gói Pro hoặc Max. Nếu nó không “suy nghĩ” được, hãy chạy claude login trước. Nếu bạn dùng ChatGPT, xem hướng dẫn Codex trong docs/.
C.git pull báo thay đổi cục bộ sẽ bị ghi đè
Tình huống này dành cho người nâng cấp từ Harvey và đã 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 báo xung đột, giữ các dòng của bạn, xoá dấu xung đột rồi chạy git stash drop. Cách tốt hơn là đặt thiết lập vào sellbird.local.yaml, file mà git không đụng tới.
D.Nâng cấp từ Harvey nhưng tiến trình cũ vẫn đang chạy
Lần đầu chạy, Sellbird đổi tên file cấu hình và cơ sở dữ liệu cũ sang tên mới, và nó chờ nếu một tiến trình Harvey vẫn chạy từ thư mục đó. Hãy tắt tiến trình Harvey trước. Sau khi git pull, chạy pip install -e . một lần để có lệnh sellbird mới.
E.Không thấy email nào được gửi đi
Đây thường không phải lỗi. Mặc định mọi email nằm trong Outbox chờ bạn duyệt. Ngoài ra, bước kiểm tra trước khi gửi (không dùng mô hình) sẽ chặn thư còn sót thẻ merge chưa điền, có cụm từ bị cấm, quá dài, thừa link hoặc địa chỉ không gửi được. Hãy mở bảng điều khiển để xem thư bị giữ lại vì lý do gì. Nếu vẫn chưa rõ, xem tài liệu Troubleshooting trong docs/.
VII.Có nên dùng không
Điểm mạnh. Bạn dùng gói AI sẵn có nên không phải quản lý API key và hoá đơn theo token. Quy trình trọn gói từ tìm khách đến xử lý thư trả lời. Dữ liệu chạy trên máy bạn. Mặc định không gửi gì khi bạn chưa duyệt, và có lệnh dừng khẩn. Nguồn dữ liệu mặc định miễn phí. 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. Bạn cần tự chuẩn bị hộp thư gửi, tên miền riêng và warmup, đây là phần tốn công và có chi phí. Cần máy chạy liên tục để vòng lặp hoạt động. Mỗi công ty chỉ tối đa hai người liên hệ, lấy từ chính trang web của công ty, nên nếu công ty không công khai tên chủ thì sẽ ít kết quả. Cài đặt có dùng dòng lệnh, nên người chưa quen terminal nên để Claude Code hướng dẫn. Hãy đọc kỹ quy định gửi thư ở nước bạn và nước người nhận trước khi bật chế độ tự gửi (autopilot).
Khi nào chọn cách khác. Nếu bạn không muốn tự chạy, README nói có bản trả phí sellbird.ai (đang trong giai đoạn truy cập sớm) đã chuẩn bị sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ cần danh sách liên hệ rồi gửi bằng công cụ khác, dùng sellbird export là đủ. Nếu muốn gửi hàng loạt không cần cá nhân hoá, một công cụ gửi thư thông thường sẽ đơn giản hơn.
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 là 0 đồng, còn nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả theo README. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex, và một hộp thư gửi (Google Workspace khoảng 7 USD mỗi tháng).
Có cần API key của Claude hay OpenAI không?
Không. Sellbird chạy qua Claude Code CLI trên gói Claude Pro/Max, hoặc qua 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ư kiểm tra email có biến key riêng trong .env.example.
Có cần GPU hay máy mạnh không?
Tư liệu không nêu yêu cầu phần cứng. Phần suy nghĩ chạy qua Claude hoặc Codex chứ không chạy mô hình trên máy bạn, nên có vẻ không cần GPU, nhưng chưa có thông tin chính thức.
Chạy được trên Windows không?
README ghi thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt được viết theo kiểu macOS/Linux và Docker được nhắc cho Linux. README chưa ghi lệnh kích hoạt môi trường ảo riêng cho Windows, bạn nên xem thêm trong docs/.
Sellbird có tự gửi email mà tôi không biết không?
Không, mặc định mọi email 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 để chặn thư lỗi, và lệnh sellbird sending pause dừng mọi việc gửi 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 home riêng, và bảng điều khiển mở ở địa chỉ trên máy bạn qua link riêng. Tư liệu không nói gì thêm về các đảm bảo bảo mật khác. Hãy giữ file .env kín và xem SECURITY.md của repo.
Harvey và Sellbird có phải là một không?
Có. Harvey được đổi tên thành Sellbird từ bản 0.4.0, cùng dự án và cùng lịch sử. Cấu hình, dữ liệu và đăng nhập bảng điều khiển được giữ lại khi nâng cấp, và các biến HARVEY_* vẫn dùng được khi chưa đặt biến SELLBIRD_* tương ứng.


