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 mã nguồn mở viết bằng Python, giúp tìm khách hàng tiềm năng, kiểm tra email, viết và gửi cold email rồi xử lý thư trả lời. Nó chạy bằ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 không quá khó nếu bạn quen dùng terminal; README còn cho phép 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, dùng để 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 ra 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 có tên Harvey, nay đổi thành Sellbird và hiện có khoảng 5.250 sao cùng 1.127 fork trên GitHub.
Điểm đáng giá nhất là chi phí. Sellbird “suy nghĩ” qua Claude Code CLI trên gói Claude Pro hoặc Max, hoặc qua Codex trên gói ChatGPT. Bạn không cần API key của mô hình và không bị tính tiền theo token. Một điểm đáng giá nữa là mặc định không có email nào được gửi đi nếu bạn chưa duyệt.
Bạn nên đọc bài này nếu bạn làm kinh doanh, bán dịch vụ cho doanh nghiệp nhỏ, hoặc là lập trình viên muốn tự dựng hệ thống tìm khách mà không trả tiền cho Apollo, ZoomInfo, Clay. Xem video ngắn bên dưới để thấy nó chạy trước, rồi quay lại đây làm theo từng bước.
ethanplusai/sellbird
Sellbird tự 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 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 gồm nhiều công đoạn. Bạn có thể chạy hết, hoặc dừng ở bất kỳ công đoạn 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í, 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ị “cháy” 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 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 đó. Công đoạn này theo README không gọi mô hình và không tốn tiền, chỉ gửi ba yêu cầu HTTP cho mỗi công ty.
- 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. Thư gửi đúng người sẽ dễ được đọc hơn thư gửi vào hộp thư chung.
- Kiểm tra email. Nó 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. Chỉ địa chỉ gửi được mới nhận thư. Điều này giúp hạn chế thư bị trả về, vốn làm hỏng danh tiếng hộp thư gử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. Sau đó nó 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ý thư trả lời. Nó đọc mọi thư trả lời, soạn sẵn câu đáp, tách thư tự động ra riê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.
Nếu bạn chỉ cần danh sách khách, hãy dừng sau bước kiểm tra email rồi chạy sellbird export. Lệnh này xuất ra file CSV để đưa vào công cụ gửi mail khác.
Ngoài ra có một bảng điều khiển (dashboard) chạy trên máy bạn. Nơi đây có hộp Outbox chứa các email đang chờ duyệt. Có thêm một bước kiểm tra trước khi gửi, không dùng mô hình: nó chặn thư còn sót biến điền sẵn chưa thay, cụm từ bị cấm, thư quá dài, quá nhiều link và địa chỉ không gửi đượ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. macOS đi kèm Python 3.9, nên nếu
python3 --versionbáo 3.9 thì chạybrew install python@3.13trước. - Một trong hai gói AI: Claude Pro hoặc Max với CLI đã đăng nhập (
claude login), hoặc gói ChatGPT có Codex CLI. Cách dùng Codex nằm trong tài liệu riêng của repo (mục Using a ChatGPT plan). - 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 gợi ý TrulyInbox: nó làm nóng hộp thư mới trước khi gửi cold email và giữ thư khỏi vào spam sau đó. Sellbird đọc tỷ lệ vào inbox từ TrulyInbox để báo bạn khi nào đã sẵn sàng. Lưu ý các link TrulyInbox trong dự án là link giới thiệu có hoa hồng cho người duy trì dự án.
- Tuỳ chọn, trả phí: file .env.example liệt kê các khoá cho dịch vụ kiểm tra email (Reoon, ZeroBounce, Hunter), Cloudflare, Instantly, DataForSEO và vài dịch vụ khác. Bạn không cần điền hết. README nói nguồn tìm công ty mặc định miễn phí và không cần tài khoản.
Về hệ điều hành, các lệnh trong README viết cho macOS và Linux. README cũng nêu 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. Phần Docker được ghi là dùng được trên Linux.
III.Cài đặt từng bước
Có hai cách: nhờ Claude Code cài giúp, hoặc tự gõ lệnh. Bên dưới là cách tự làm.
- Tải mã nguồnDùng git clone rồi vào thư mục sellbird
- Tạo môi trường và càiTạo venv bằng python3.13 rồi pip install -e .
- Điền thông tinSao chép .env.example thành .env và điền các khoá cần dùng
- Dạy Sellbird về sản phẩmChạy sellbird train với địa chỉ website của bạn
- Chọn tín hiệu và tìm kháchChạy sellbird signals rồi sellbird discover
- Mở dashboard và chạyChạy sellbird dashboard rồi sellbird run
A.Tải mã nguồn về máy
Mở terminal (trên macOS là ứng dụng Terminal) và chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbirdLệnh đầu tải repo về một thư mục tên sellbird. Lệnh thứ hai đi vào thư mục đó. Mọi lệnh sau đều phải chạy trong thư mục này, đây là chỗ người mới hay quên.
B.Cách nhanh: để Claude cài giúp
Nếu bạn đã có Claude Code, chạy thêm lệnh sau trong thư mục sellbird:
claudeRồi 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 cài đặt: nó kiểm tra bạn đang ở đâu, cài phần còn thiếu, hỏi những gì cần hỏi và huấn luyện Sellbird về sản phẩm của bạn. Với người mới đây là cách dễ nhất, vì bạn chỉ cần trả lời câu hỏi.
C.Cách tự làm: cài gói Python
Tạo môi trường ảo và cài Sellbird:
# 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, bật nó lên, rồi cài Sellbird ở chế độ chỉnh sửa được. Xong bước này bạn có lệnh sellbird. Hãy dùng python3.13 chứ không dùng python3 trần, vì trên macOS python3 có thể là bản 3.9 quá cũ. Mỗi lần mở terminal mới, bạn cần bật lại môi trường bằng source .venv/bin/activate (lệnh này nằm trong README).
D.Điền thông tin đăng nhập
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .envLệnh sao chép file mẫu thành .env rồi mở ra để sửa. Mỗi biến trong file đều có chú thích ngay bên cạnh. Ví dụ, nếu gửi qua SMTP, bạn sẽ điền các biến như SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD. Chỉ điền những gì bạn thật sự dùng.
File .env chứa mật khẩu và khoá truy cập. Đừng đưa nó lên GitHub, đừng gửi cho người khác. Nên dùng tên miền và hộp thư gửi riêng thay vì hộp thư công việc chính.
E.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ủa bạn. Sellbird đọc trang web để hiểu bạn bán gì, rồi ghi kết quả vào file sellbird.local.yaml. File này bạn có thể mở ra sửa.
F.Chọ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 discoverBước 4 xác nhận những dấu hiệu cho thấy một công ty là khách tốt. Bước 5 đi tìm doanh nghiệp, mặc định dùng nguồn miễn phí và không cần tài khoản.
G.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 http://127.0.0.1:5555, tức là chỉ mở được trên máy bạn. sellbird run khởi động vòng lặp làm việc. Hai lệnh này nên chạy ở hai cửa sổ terminal khác nhau, vì mỗi lệnh giữ terminal của nó.
Trên Linux bạn cũng có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml; chi tiết nằm trong tài liệu Docker của repo.
IV.Kiểm tra đã chạy được chưa
Có ba dấu hiệu cho thấy mọi thứ ổn:
- Gõ
sellbirdkhông báo “command not found”. Nếu báo, thường là bạn chưa bật môi trường ảo. sellbird dashboardin ra link riêng và bạn mở được trang đó trong trình duyệt.sellbird runhiện dòng “Sellbird is online”, sau đó kiểm tra tình trạng và in ra các quyết định. README cho ví dụ kết quả như: có 3 khách mới chưa có thư nháp, nên Sellbird viết chuỗi email và báo “5 emails waiting for your approval”. Cuối cùng nó ghi “Cycle complete” và nghỉ 15 phút trước vòng sau.
Nếu bạn thấy email nằm trong Outbox chờ duyệt thì đúng như thiết kế: chưa gì được gửi đi khi bạn chưa đồng ý.
V.Dùng vào việc thật
Bối cảnh trong README là một sản phẩm đặt lịch online bán cho thợ lợp mái, phòng nha và tiệm điều hoà. Dữ liệu mẫu đều là bịa. Dưới đây là các tình huống tương tự mà bạn có thể áp dụng.
Sellbird không gửi gì đi khi bạn chưa gật đầu, nên bạn thử thoải mái mà không sợ lỡ tay.
Ông T
A.Chủ doanh nghiệp nhỏ muốn có danh sách khách mà không mua công cụ
Bạn bán phần mềm hoặc dịch vụ cho một ngành cụ thể, ví dụ phòng khám hay xưởng cơ khí. Bạn chạy sellbird train với website của mình, xác nhận tín hiệu bằng sellbird signals --confirm free, rồi chạy sellbird discover để tìm trên nguồn miễn phí. Sau đó đi tiếp qua công đoạn tìm người quyết định và kiểm tra email. Kết quả là một danh sách công ty kèm người phụ trách và địa chỉ email đã gắn nhãn, mà bạn chưa phải trả tiền cho công cụ prospecting nào.
B.Người làm sales chỉ cần file CSV
Bạn đã có công cụ gửi mail riêng và chỉ muốn Sellbird làm khâu tìm khách. Bạn chạy các bước tìm và kiểm tra, dừng lại, rồi chạy:
sellbird exportKết quả là file CSV sẵn để đưa vào công cụ gửi mail của bạn. Lưu ý chỉ nên gửi tới các địa chỉ được gắn nhãn gửi được, đúng như cách Sellbird tự làm.
C.Cả quy trình, có người duyệt từng thư
Bạn kết nối hộp thư Google Workspace (hoặc Microsoft 365, SMTP), đã warmup xong, rồi chạy sellbird run. Mỗi vòng, Sellbird viết chuỗi email dựa trên điều nó thấy trên website khách, ví dụ một công ty đang tuyển nhân viên điều phối, rồi đặt vào Outbox. Bạn mở dashboard, đọc từng thư, sửa nếu cần, rồi duyệt. Khi có người trả lời, Sellbird soạn sẵn câu đáp, còn các thư nó không nên tự xử lý thì chuyển cho bạn. Bạn dành thời gian cho những cuộc trò chuyện có giá trị thay vì ngồi viết từng thư.
D.Cần dừng khẩn cấp
Giả sử bạn thấy một thư viết sai thông tin. Bạn chạy lệnh dưới đây, và theo README nó dừng toàn bộ việc gửi ngay lập tức:
sellbird sending pauseSau đó bạn xem lại thư trong Outbox, sửa prompt hoặc file cấu hình, rồi mới tiếp tục.
VI.Lỗi hay gặp và cách xử lý
python3 --versionbáo 3.9 hoặc thấp hơn 3.11. Cài Python mới hơn (macOS:brew install python@3.13) và tạo môi trường ảo bằngpython3.13, đúng như README dặn.- Gõ
sellbirdbáo không tìm thấy lệnh. Thường do chưa bật môi trường ảo hoặc đang ở terminal mới. Vào thư mục sellbird và chạy lạisource .venv/bin/activate. Nếu vẫn lỗi, chạy lạipip install -e .trong môi trường đó. - Claude hoặc Codex chưa đăng nhập. Sellbird dựa vào CLI đã đăng nhập, nên hãy chạy
claude login(hoặc làm theo hướng dẫn Codex trong tài liệu của repo) rồi chạy lại. - Không gửi được thư hoặc email bị vào spam. Kiểm tra lại các biến SMTP/Gmail/M365 trong
.env, và xem hộp thư đã warmup chưa. Sellbird có đọc tỷ lệ vào inbox từ TrulyInbox để báo bạn khi sẵn sàng. Nếu chưa, đừng vội bật gửi tự động. Mục Troubleshooting và Legal and deliverability trong thư mục docs/ có hướng dẫn chi tiết hơn. - Dùng bản Harvey cũ,
git pullbáo “your local changes would be overwritten”. README hướng dẫn: chạygit stash,git pull, rồigit stash pop. Nếu có xung đột, giữ các dòng của bạn, xoá dấu xung đột và chạygit stash drop. Tốt hơn là đặt cài đặt riêng trongsellbird.local.yaml, vì git không đụng tới file này.
VII.Có nên dùng không
Điểm mạnh. Chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Không cần API key mô hình, chỉ cần gói Claude hoặc ChatGPT sẵn có. Công đoạn tìm khách mặc định miễn phí. Mọi thư mặc định phải qua bước duyệt của bạn, kèm bước kiểm tra trước khi gửi. Mã nguồn mở và repo vẫn được cập nhật trong 3 tháng gần đây.
Giới hạn. Bạn phải quen dùng terminal và tự lo hộp thư gửi, tên miền, warmup. Hướng dẫn trong README viết cho macOS và Linux, chưa có hướng dẫn cài riêng cho Windows. Nguồn tìm miễn phí là OpenStreetMap, nên độ phủ phụ thuộc vào dữ liệu ở khu vực bạn nhắm tới; tôi chưa có thông tin về độ phủ tại Việt Nam. Giấy phép là AGPL-3.0, bạn nên đọc kỹ nếu định đưa vào sản phẩm thương mại. Và cold email có quy định pháp lý riêng tuỳ nơi bạn gửi, hãy đọc phần Legal and deliverability trong docs của repo và tự kiểm tra luật áp dụng.
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 chạy sẵn tại sellbird.ai (đang ở giai đoạn early access, theo README). Nếu bạn chỉ gửi vài thư mỗi tuần cho người đã quen, một công cụ gửi mail thông thường là đủ. Còn nếu bạn muốn thử quy trình tìm khách và viết thư tự động mà không tốn tiền công cụ, Sellbird đáng để thử trong 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. Theo README, nguồn tìm doanh nghiệp mặc định là miễn phí, còn đọc website khách cũng không tốn tiền. 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 nhắc khoảng 7 đô la một tháng cho Google Workspace).
Cần API key của OpenAI hay Anthropic không?
Không. README nói Sellbird chạy qua Claude Code CLI trên gói Claude Pro/Max, hoặc Codex trên gói ChatGPT, không dùng API key và không tính tiền theo token. Một số dịch vụ tuỳ chọn như kiểm tra email thì có khoá riêng trong file .env.
Có cần GPU không?
Tư liệu không nhắc tới yêu cầu GPU. Phần suy luận chạy qua Claude hoặc Codex của bạn, còn yêu cầu được ghi rõ chỉ gồm Python 3.11 trở lên, gói AI, hộp thư gửi và warmup.
Chạy được trên Windows không?
README chỉ có các lệnh cài cho macOS và Linux, và nói Docker dùng được trên Linux. README có nêu 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.
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 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 có an toàn không?
README nói Sellbird chạy trên máy của bạn, và cấu hình, tri thức, dữ liệu nằm trong một thư mục riêng; dashboard mở ở địa chỉ 127.0.0.1. Repo có file SECURITY.md để báo lỗi bảo mật. Thông tin đánh giá bảo mật chi tiết hơn thì tư liệu chưa nêu.
Sellbird khác gì Harvey?
Là cùng một dự án, cùng lịch sử, chỉ đổi tên từ phiên bản 0.4.0. Cấu hình, dữ liệu và đăng nhập dashboard của Harvey được chuyển sang tự động. Các bản Harvey tới 0.3.x phát hành theo MIT, còn từ Sellbird là AGPL-3.0.


