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 terminal, nhưng cần thêm hộp thư gửi riêng và bước làm nóng (warmup) hộp thư.
Sellbird là một nền tảng mã nguồn mở giúp bạn làm cả chuỗi việc "outreach" (chủ động tiếp cận khách) bằng 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, vẫn là cùng một dự án và cùng lịch sử.
Người nên xem là chủ doanh nghiệp nhỏ, người làm sales, người làm marketing hoặc lập trình viên muốn tự động hoá việc tìm khách mà không trả phí cho các công cụ prospecting đắt tiền. Hiện repo có khoảng 5250 sao và 1127 fork, giấy phép AGPL-3.0, và vẫn được cập nhật trong vài tháng gần đây.
Điểm đáng giá nhất: Sellbird "suy nghĩ" qua Claude Code CLI trên gói Claude Pro/Max của bạn, hoặc qua Codex trên gói ChatGPT. Không cần API key của mô hình, không tính tiền theo token. Ngoài ra, mặc định không có email nào được gửi đi nếu bạn chưa duyệt. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi cài.
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 của bạn.
I.Sellbird làm được gì
Sellbird là một đường ống (pipeline) gồm 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 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. Lợi ích: không bị bất ngờ về tiền.
- 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 đó. Bước này không gọi mô hình nên không tốn tiền. Nhờ vậy email của bạn có chi tiết thật để nói, không phải thư chung chung.
- Tìm người quyết định. Nó tìm chủ hoặc quản lý được nêu trên chính trang web 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 mẫu email của công ty và kiểm tra 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 dùng để gửi. Việc này giúp giảm thư trả về, bảo vệ uy tín hộp thư.
- 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 thấy, rồi 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 nháp câu trả lời, gạt thư tự động sang một bên, 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 và chạy sellbird export để lấy file CSV đưa vào công cụ gửi thư khác.
Về an toàn: mọi email gửi đi nằm trong hộp "Outbox" chờ bạn duyệt, cho tới khi bạn tự bật autopilot. Trước khi gửi còn có một lượt kiểm tra không dùng mô hình, loại các thư còn sót merge tag chưa điền, cụm từ bị cấm, thư quá dài, quá nhiều link và địa chỉ không gửi được. Lệnh sellbird sending pause dừng toàn bộ 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 Python >=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. - Một gói Claude Pro hoặc Max với CLI đã đăng nhập (
claude login), hoặc một gói ChatGPT có Codex CLI. - Một hộp thư để gửi, tốt nhất là 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 ý dùng TrulyInbox, và Sellbird đọc được tỷ lệ vào inbox từ đó để báo bạn khi nào đã sẵn sàng. Đây là gợi ý của tác giả, link giới thiệu của họ có hoa hồng; bạn có thể dùng cách warmup khác.
Về 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ả ở nguồn trả phí rẻ nhất; đọc website là 0 đồng; hộp thư Google Workspace khoảng 7 USD một tháng.
Về hệ điều hành: README viết lệnh theo kiểu macOS/Linux và nói Linux có thể chạy thêm bằng Docker. README có nêu thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng chưa có hướng dẫn cài riêng cho Windows ở phần Quick start. Người dùng Windows nên xem thêm thư mục docs/ trong repo.
III.Cài đặt từng bước
- Tải mã nguồnClone repo về máy và vào thư mục dự án
- Cài đặtTạo môi trường ảo Python 3.13 và cài gói
- Đ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áchXác nhận tín hiệu rồi chạy discover
- Mở bảng điều khiểnChạy dashboard và run
Có hai cách: để Claude cài giúp, hoặc tự làm từng lệnh.
A.Tải mã nguồn về máy
Mở terminal (trên macOS là ứng dụng Terminal) ở 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 mã nguồn về, lệnh sau đi vào thư mục vừa tải. Mọi lệnh sau đó đều phải chạy trong thư mục sellbird này.
B.Cách dễ nhất: nhờ Claude cài giúp
Nếu bạn đã cài Claude Code, chạy tiếp:
claudeSau đó gõ: “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 máy bạn, cài phần 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. Đây là cách phù hợp cho người mới.
C.Hoặc tự cài: tạo môi trường 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 môi trường ảo .venv (một "hộp" riêng để không lẫn với Python khác trên máy), kích hoạt nó, rồi cài Sellbird. Chỗ hay vấp: phải dùng python3.13 chứ không phải python3, vì trên macOS python3 trần có thể là bản 3.9 quá cũ. Cài xong, lệnh sellbird sẽ dùng được trong terminal đó.
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 đều có chú thích ngay trong file. File mẫu liệt kê các nhóm như Gmail (GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET), SMTP/IMAP, Microsoft 365, và một số dịch vụ kiểm tra email. Bạn chỉ điền phần mình dùng, ví dụ hộp thư gửi của mình. Nếu $EDITOR chưa được đặt trên máy, bạn có thể mở file .env bằng bất kỳ trình soạn văn bản nào.
.env chứa mật khẩu và khoá truy cập hộp thư. Không đưa file này lên GitHub, không gửi cho người khác. Hãy dùng hộp thư trên tên miền gửi riêng, không dùng hộp thư chính của công ty.
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 thật của bạn. Sellbird đọc trang web để hiểu bạn bán gì, rồi ghi kết quả vào sellbird.local.yaml. File này là nơi để bạn chỉnh cấu hình riêng, và git không đụng tới nó khi bạn cập nhật.
F.Xác nhận khách tiềm năng và tìm kiếm
# 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 chốt các "tín hiệu" cho biết một công ty là khách tốt. Lệnh sau tìm doanh nghiệp bằng nguồn mặc định, miễn phí và không cần tài khoản.
G.Mở bảng điều khiển 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 (http://127.0.0.1:5555), chỉ bạn mở được. sellbird run khởi động vòng lặp làm việc. Hãy để dashboard chạy ở một cửa sổ terminal và sellbird run ở cửa sổ khác, hoặc xem tài liệu để biết cách chạy chung.
Trên Linux bạn cũng có thể chạy bằng Docker; repo có sẵn Dockerfile và docker-compose.yml. README chưa ghi lệnh Docker chi tiết trong phần Quick start, hãy xem tài liệu Docker trong thư mục 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 như sau:
$ sellbird run
============================================================
Sellbird is online.
============================================================
Checkpoint...Tóm lại, bạn sẽ thấy dòng "Sellbird is online.", rồi nó kiểm tra trạng thái đường ống, đưa ra quyết định (ví dụ viết chiến dịch cho các prospect mới), và báo số email đang chờ bạn duyệt. Cuối mỗi chu kỳ, nó báo "Cycle complete" và nghỉ 15 phút rồi lặp lại. Đó là dấu hiệu Sellbird đã chạy.
Bạn cũng nên mở link do sellbird dashboard in ra để xem thư trong Outbox. Nếu thấy các email nháp đang chờ duyệt, nghĩa là mọi thứ đã hoạt động. README nói dữ liệu demo là hư cấu (công ty "Bookwell" bán phần mềm đặt lịch cho thợ lợp mái, nha khoa, điều hoà), dùng tên miền .test.
V.Dùng vào việc thật
Dưới đây là các tình huống bám đúng khả năng Sellbird có trong tư liệu.
A.Chủ một dịch vụ địa phương tìm khách mới
Bạn bán phần mềm đặt lịch cho phòng khám nha khoa. Chạy sellbird train với website của bạn, rồi sellbird signals --confirm free để chốt tín hiệu như "chưa có đặt lịch online". Sau đó chạy sellbird discover. Sellbird tìm các phòng khám phù hợp từ OpenStreetMap, đọc website của họ và đưa ra danh sách có lý do cụ thể vì sao họ cần bạn.
Không có email nào ra khỏi máy nếu bạn chưa bấm duyệt.
Ông T
B.Nhân viên sales chỉ cần danh sách để gửi bằng công cụ khác
Bạn đã có công cụ gửi thư riêng và chỉ cần danh sách sạch. Chạy các bước tìm và kiểm tra email, rồi xuất:
sellbird exportBạn nhận được file CSV các công ty và người quyết định, mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid. Bạn có thể lọc lấy địa chỉ deliverable trước khi đưa vào hệ thống của mình.
C.Chạy thử chiến dịch nhỏ, duyệt từng thư
Bạn muốn thử mà chưa tin hoàn toàn vào tự động hoá. Chạy sellbird run và để autopilot tắt (mặc định). Mỗi chu kỳ, Sellbird viết chuỗi 2 email cho từng người và đặt vào Outbox. Bạn mở dashboard, đọc từng thư, sửa nếu cần rồi duyệt. Nếu thấy có gì không ổn, chạy sellbird sending pause để dừng ngay.
D.Xử lý thư trả lời mà không bị ngợp
Khi khách trả lời, Sellbird phân loại thư (quan tâm, phản đối, tự động trả lời, từ chối nhận thư), soạn nháp câu trả lời và đưa vào hàng chờ của bạn. Thư từ chối nhận được tôn trọng ngay. Bạn chỉ cần đọc, sửa các nháp quan trọng và tự trả lời những thư nhạy cảm mà Sellbird chuyển lại cho bạn.
VI.Lỗi hay gặp và cách xử lý
A.python3 --version báo 3.9 hoặc lệnh cài báo lỗi phiên bản
Đây là lỗi README đã cảnh báo trên macOS. Cài Python mới (brew install python@3.13) rồi tạo lại môi trường ảo bằng python3.13, không dùng python3 trần.
B.Gõ sellbird báo "command not found"
Thường do bạn chưa kích hoạt môi trường ảo trong cửa sổ terminal hiện tại, hoặc mở terminal mới. Vào lại thư mục dự án và chạy source .venv/bin/activate, rồi thử lại. Nếu bạn nâng cấp từ Harvey, README nói cần chạy pip install -e . một lần để có lệnh sellbird mới.
C.Claude hoặc Codex chưa đăng nhập
Sellbird dùng Claude Code CLI qua gói của bạn nên CLI phải đăng nhập. Chạy claude login và thử lại. Nếu dùng ChatGPT, xem hướng dẫn Codex trong thư mục docs/.
D.git pull báo "your local changes would be overwritten"
Lỗi này xảy ra khi bạn từng sửa trực tiếp 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, xoá dấu xung đột và chạy git stash drop. Lần sau hãy đặt cấu hình trong sellbird.local.yaml.
E.Email vào thư rác hoặc bị trả về
Đây là vấn đề rất phổ biến với cold email, nhất là khi hộp thư mới chưa warmup. Hãy dùng tên miền gửi riêng, warmup hộp thư trước khi gửi, giữ giới hạn gửi mỗi ngày thấp và chỉ gửi tới địa chỉ đã verified. Xem thêm tài liệu "Legal and deliverability" trong repo.
VII.Có nên dùng không
Điểm mạnh. Chạy trên máy của bạn, mã nguồn mở, không cần API key mô hình, chi phí thấp. Mặc định phải duyệt từng thư, có lượt kiểm tra trước khi gửi và lệnh dừng khẩn cấp. Bạn có thể dừng ở bước xuất danh sách nếu chỉ cần lead.
Giới hạn. Cần quen terminal và biết cấu hình hộp thư gửi. Bạn cần có gói Claude Pro/Max hoặc ChatGPT có Codex, và cần hộp thư riêng đã warmup. README 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ù hợp nhất với doanh nghiệp địa phương; muốn nguồn khác phải trả phí. Giấy phép AGPL-3.0 có điều kiện nếu bạn định chỉnh sửa và cung cấp như một dịch vụ.
Lưu ý pháp lý. Gửi cold email chịu các quy định về thư thương mại và dữ liệu cá nhân ở nơi bạn và người nhận sống. Hãy đọc kỹ tài liệu pháp lý của repo và tự kiểm tra quy định áp dụng cho mình.
Khi nào chọn cách khác. Nếu không muốn tự vận hành, tác giả có bản hosted ở sellbird.ai (đang trong giai đoạn early access). Nếu bạn gửi tới thị trường cần các nguồn dữ liệu mà OpenStreetMap yếu, hãy xem các nguồn trả phí hoặc công cụ khác.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Phần mềm là mã nguồn mở theo giấy phép AGPL-3.0, tải và chạy không mất phí. Theo README, tìm doanh nghiệp bằng nguồn mặc định là 0 đồng, đọc website cũng là 0 đồng. Bạn vẫn cần gói Claude hoặc ChatGPT đang có và một hộp thư để gửi (Google Workspace khoảng 7 USD một tháng).
Có 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 hoặc Max, hoặc qua Codex trên gói ChatGPT. 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 API key riêng trong .env.example.
Cần GPU 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 của bạn, nên máy chỉ cần chạy Python 3.11 trở lên.
Sellbird có tự gửi email mà tôi không kiểm soá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. Ngay cả khi bật autopilot, thư có link tới tên miền không phải của bạn vẫn bị giữ lại. Lệnh `sellbird sending pause` dừng mọi thứ ngay.
Chạy được trên Windows không?
README chưa ghi hướng dẫn cài riêng cho Windows; các lệnh viết theo macOS/Linux, và Docker được nói là chạy trên Linux. README có nêu thư mục dữ liệu trên Windows là %APPDATA%\sellbird, nhưng bạn nên xem thư mục docs/ và phần Troubleshooting trong repo để biết thêm.
Dữ liệu của tôi có an toàn không?
README cho biết Sellbird chạy trên máy của bạn, và cấu hình, dữ liệu, cơ sở dữ liệu nằm trong một thư mục riêng của bạn. Dashboard mở ở địa chỉ trên máy bạn (127.0.0.1). Tuy vậy, thư vẫn gửi qua hộp thư và dịch vụ bạn chọn, nên hãy tự cân nhắc quyền riêng tư ở các dịch vụ đó.
Tôi đang dùng Harvey, có phải cài lại không?
Không cần. README nói Harvey đã đổi tên thành Sellbird từ bản 0.4.0, cấu hình, dữ liệu và đăng nhập dashboard được giữ lại. Bạn chạy `git pull`, rồi `pip install -e .` một lần để có lệnh `sellbird` mới.


