Sellbird: tự tìm khách, viết và gửi cold email bằng gói Claude/ChatGPT — 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 làm outreach: tìm khách tiềm năng, kiểm tra email, viết thư lạnh, gửi và xử lý phản hồi. Nó chạy trên máy bạn, dùng Claude Code CLI hoặc Codex nên không cần API key mô hình. Cài đặt cần quen dùng terminal; có thể nhờ Claude Code hướng dẫn từng bước.
Sellbird là một nền tảng mã nguồn mở để làm outreach (tiếp cận khách hàng bằng email lạnh) gần như từ đầu đến cuối. Nó tìm các công ty có thể 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. Tên cũ của dự án là Harvey.
Bạn nên xem qua nếu bạn bán dịch vụ cho doanh nghiệp nhỏ (đặt lịch, quảng cáo, phần mềm, tư vấn…), làm sale một mình hoặc nhóm nhỏ, và không muốn trả tiền cho cả một bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Tác giả nói rõ Sellbird không dùng các công cụ đó.
Điểm đáng giá nhất có hai ý. Một: nó chạy bằng gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex), nên không có API key và không tính tiền theo token. Hai: mặc định không có email nào được gửi đi nếu bạn chưa duyệt. Repo hiện có khoảng 5250 sao và 1127 fork. 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 hợp, tìm người quyết định, kiểm tra email, viết cold email cá nhân hoá và xử lý phản hồi, chạy bằng gói Claude hoặc ChatGPT bạn có sẵn.
I.Sellbird làm được gì
Sellbird là một dây chuyền nhiều bước. Bạn có thể chạy hết, hoặc dừng ở bước nào tuỳ ý.
- Tìm công ty. 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. Nhờ vậy bạn không bị trừ tiền ngoài ý muốn.
- Tìm lý do họ sẽ mua. Đọc chính 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, hay đ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 (tư liệu ghi là ba yêu cầu HTTP cho mỗi công ty). Lợi ích: thư của bạn có lý do cụ thể để gửi, không phải thư gửi bừa.
- Tìm người quyết định. Lấy chủ hoặc quản lý được nêu trên các trang của công ty, tối đa hai người mỗi công ty.
- Kiểm tra địa chỉ. Sellbird học kiể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 bị gửi tới. Cái này giúp bảo vệ uy tín hộp thư của bạn.
- Viết và gửi. 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, trong giới hạn gửi mỗi ngày và trong giờ làm việc của người nhận.
- Xử lý phản hồi. Đọc từng thư trả lời, soạn câu trả lời nháp, đặt riêng thư tự độ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 để có file CSV đưa vào công cụ gửi thư khác.
Về an toàn, mọi email gửi đi đều nằm chờ trong mục Outbox cho bạn duyệt, cho đến khi bạn tự bật chế độ autopilot. Trước khi gửi còn có một bước kiểm tra không dùng mô hình, loại 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 hoặc địa chỉ không gửi được. Lệnh sellbird sending pause dừng mọi thứ ngay.
II.Cần chuẩn bị gì
Theo tư liệu, bạn cần:
- Python 3.11 trở lên. Tệp cấu hình của gói yêu cầu đúng mức này. 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 (lệnh
claude login), hoặc một gói ChatGPT có Codex CLI. Không cần API key của mô hình. - 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. README nói chi phí khoảng 7 đô la mỗi tháng cho Google Workspace.
- Warmup (làm nóng) hộp thư. README khuyên dùng TrulyInbox, và lưu ý các liên kết TrulyInbox trong dự án là liên kết affiliate. Sellbird đọc tỉ lệ vào inbox của dịch vụ này để báo bạn khi nào sẵn sàng.
- Tệp
.env.examplecòn liệt kê nhiều khoá tuỳ chọn cho các nhà cung cấp khác (xác minh email như Reoon, ZeroBounce, Hunter; Instantly; Cloudflare; DataForSEO…). Bạn chỉ điền cái nào mình dùng.
Tư liệu không nói rõ yêu cầu về phần cứng. Phần ví dụ về thư mục dữ liệu có nhắc cả Windows, macOS và Linux. Riêng Docker, README chỉ ghi là dùng được trên Linux.
Sellbird gửi email thật từ hộp thư của bạn. Hãy dùng tên miền gửi riêng, giữ chế độ duyệt tay lúc đầu và đọc tài liệu Legal and deliverability trong thư mục docs/ trước khi gửi hàng loạt. Quy định về email quảng cáo khác nhau theo từng nước, nên bạn tự kiểm tra luật nơi người nhận sống.
III.Cài đặt từng bước
- Kiểm tra Python và ClaudePython 3.11+, đã chạy claude login
- Tải mã nguồngit clone repo về máy rồi vào thư mục
- Cài góiTạo môi trường ảo và pip install -e .
- Điền thông tinSao chép .env.example thành .env rồi điền
- Dạy Sellbirdtrain, signals, discover
- Mở bảng điều khiểnsellbird dashboard rồi sellbird run
Có hai cách: để Claude Code cài giúp (dễ nhất cho người mới), hoặc tự gõ lệnh.
A.Cách dễ: để Claude cài giúp
Mở terminal (trên Windows là PowerShell hoặc Terminal, trên macOS là ứng dụng Terminal), rồi chạy ba lệnh:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeLệnh đầu tải mã nguồn về máy, lệnh thứ hai đi vào thư mục vừa tải, lệnh thứ ba mở Claude Code ngay trong thư mục đó. Khi Claude mở, bạn gõ set up Sellbird for me. Theo README, tệp 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 những gì cần hỏi và dạy Sellbird về sản phẩm của bạn.
Chỗ hay vấp: bạn phải đứng trong thư mục sellbird trước khi gõ claude, nếu không Claude sẽ không đọc được CLAUDE.md.
B.Cách tự làm: tạo môi trường và cài gói
Sau khi đã git clone và cd sellbird như trên, chạy lệnh của README:
# 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 (để thư viện của Sellbird không lẫn với phần còn lại của máy), bật nó lên, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau bước này bạn có lệnh sellbird. Lưu ý: dòng này viết cho macOS/Linux. Trên Windows, README chưa ghi lệnh riêng; bước bật môi trường ảo thường khác (.venv\Scripts\activate trong PowerShell), nên nếu vướng, bạn hãy dùng cách nhờ Claude cài ở trên.
C.Điền thông tin đăng nhập
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .envLệnh cp sao chép tệp mẫu thành .env, rồi mở bằng trình soạn thảo. Mỗi biến trong tệp đều có chú thích ngay bên cạnh. Bạn điền thông tin hộp thư gửi (Gmail, Microsoft 365 hoặc SMTP) và khoá của dịch vụ nào bạn dùng. Trên Windows, bạn có thể tự sao chép tệp bằng File Explorer và mở bằng Notepad. Tuyệt đối không đưa tệp .env lên GitHub hay gửi cho người khác.
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.com
# 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ạn thay https://your-company.com bằng website thật của mình. Lệnh train đọc website và ghi hiểu biết về sản phẩm vào sellbird.local.yaml. Lệnh signals giúp bạn xác nhận dấu hiệu nào cho thấy một công ty là khách tốt. Lệnh discover tìm doanh nghiệp từ nguồn miễn phí mặc định, không cần tài khoản.
E.Mở bảng điều khiển và chạy
# 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), mở trong trình duyệt để xem danh sách khách, Outbox và các thư trả lời. sellbird run khởi động vòng lặp: cứ mỗi chu kỳ nó kiểm tra tình trạng, viết thư, xử lý phản hồi rồi nghỉ. Hai lệnh này thường cần hai cửa sổ terminal riêng, vì run chiếm cửa sổ khi đang chạy.
Nếu bạn dùng Linux và thích Docker, repo có sẵn Dockerfile và docker-compose.yml, và README có tài liệu Docker trong thư mục docs/. README chưa ghi lệnh chạy Docker lần đầu ở phần Quick start, nên hãy xem hướng dẫn Docker trong docs/.
IV.Kiểm tra đã chạy được chưa
Sau khi chạy sellbird run, màn hình mẫu trong README trông như sau:
Sellbird is online.
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
handler → ...
writer → 2-email sequence: ...
outbox → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.Bạn thấy dòng "Sellbird is online", rồi một quyết định của chu kỳ, và cuối cùng là "Cycle complete" kèm thời gian nghỉ thì nghĩa là vòng lặp đang chạy. Với người mới, dấu hiệu rõ nhất là: mở link in ra từ sellbird dashboard, thấy bảng điều khiển và thấy các email nháp nằm trong Outbox chờ bạn duyệt. Nếu Outbox có thư nhưng chưa có gì bị gửi đi, đó là hành vi đúng theo thiết kế.
Muốn dừng khẩn cấp, chạy sellbird sending pause.
V.Dùng vào việc thật
A.Chủ công ty dịch vụ muốn có danh sách khách để gọi điện
Bạn bán phần mềm đặt lịch cho phòng khám nha khoa và chưa muốn gửi email. 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. Sau khi các bước tìm người quyết định và kiểm tra email xong, bạn chạy:
sellbird exportKết quả là một file CSV sẵn để đưa vào công cụ gửi thư khác, hoặc để nhân viên gọi điện. Mỗi địa chỉ có nhãn verified, risky, guess hoặc invalid để bạn biết cái nào đáng tin.
B.Sale làm một mình, muốn thư có lý do cụ thể
Bạn bán dịch vụ cho tiệm điều hoà. Thay vì viết một mẫu chung cho tất cả, bạn để Sellbird đọc website từng công ty, tìm dấu hiệu như đang tuyển nhân viên điều phối, rồi viết một chuỗi hai email xoay quanh đúng chi tiết đó. Ví dụ trong README là thư gửi một tiệm HVAC ở Phoenix đang tuyển người điều phối.
Hiệu quả nhất không phải là gửi nhiều hơn, mà là mỗi thư có một lý do thật để được gửi.
Ông T
Bạn mở Outbox, đọc từng thư, sửa nếu cần rồi duyệt. Nhờ đó bạn giữ được giọng của mình mà vẫn không phải viết từng thư.
C.Người vận hành muốn giữ hộp thư không bị khoá
Bạn đã có Google Workspace trên tên miền gửi riêng và đã warmup. Bạn giữ chế độ duyệt tay, đặt giới hạn gửi mỗi ngày trong cấu hình và để Sellbird gửi trong giờ làm việc của người nhận. Trước khi thư ra khỏi máy, bước kiểm tra không dùng mô hình chặn các thư còn merge tag chưa điền hoặc có quá nhiều link. Cách làm này phù hợp khi uy tín tên miền quan trọng hơn tốc độ.
D.Dev muốn tuỳ biến theo cách bán hàng riêng
Bạn muốn đổi giọng văn hoặc cách xử lý phản hồi. Repo có thư mục prompts/ và skills/ (các kịch bản bán hàng chỉnh sửa được) và sellbird.local.yaml để đặt cấu hình riêng mà git không động tới. Có thêm tài liệu Extensions nếu bạn muốn thêm lệnh hoặc bước mới từ một gói riêng. Bạn sửa các tệp này theo nhu cầu, rồi chạy lại sellbird run.
VI.Lỗi hay gặp và cách xử lý
1. python3 --version báo 3.9 hoặc thấp hơn 3.11. Sellbird yêu cầu Python 3.11 trở lên. Trên macOS, cài bằng brew install python@3.13 và dùng python3.13 khi tạo môi trường ảo, đúng như README ghi.
2. Không thấy lệnh sellbird. Thường là bạn chưa bật môi trường ảo hoặc chưa chạy pip install -e . trong thư mục repo. Mở terminal mới, vào thư mục sellbird, bật lại môi trường ảo rồi chạy lại lệnh cài.
3. Claude hoặc Codex không phản hồi, báo chưa đăng nhập. Sellbird dùng gói thuê bao của bạn qua CLI, nên CLI phải đăng nhập sẵn. Chạy claude login với gói Claude Pro/Max. Với ChatGPT, xem tài liệu Using a ChatGPT plan (Codex) trong docs/.
4. Không có gì được gửi đi. Đây thường không phải lỗi. Mặc định mọi thư nằm trong Outbox chờ bạn duyệt. Vào bảng điều khiển để duyệt. Chỉ bật autopilot khi bạn đã tin tưởng chất lượng thư. Ngay cả khi bật, Sellbird vẫn giữ lại thư có link tới tên miền không phải của bạn.
5. Sau khi nâng cấp từ Harvey, git pull báo "your local changes would be overwritten". Bạn đã sửa trực tiếp harvey.yaml. README hướng dẫn chạy git stash, git pull, rồi git stash pop. Về sau, hãy đặt cài đặt của bạn vào sellbird.local.yaml để git không đụng tới.
Muốn xem thêm các tình huống khác, repo có tài liệu Troubleshooting trong docs/.
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ỉ dùng gói bạn đang có. Tìm khách và đọc website có thể hoàn toàn miễn phí. Mặc định có bước duyệt tay và bước kiểm tra trước khi gửi, nên hợp với người muốn kiểm soát. Dự án vẫn được cập nhật trong vài tháng gần đây và có cộng đồng khá lớn.
Giới hạn. Bạn vẫn cần một hộp thư gửi, nên có chi phí cho hộp thư, tên miền và dịch vụ warmup. Cài đặt qua dòng lệnh, nên người chưa quen terminal sẽ cần thời gian, dù có cách nhờ Claude Code cài giúp. README viết ví dụ cho macOS/Linux, phần Windows ít được hướng dẫn hơn. Giấy phép là AGPL-3.0 (các bản Harvey đến 0.3.x dùng MIT), điều này đáng cân nhắc nếu bạn định tích hợp vào sản phẩm thương mại của mình. Tư liệu cũng không đảm bảo kết quả bán hàng: chất lượng thư phụ thuộc vào sản phẩm và danh sách của bạn.
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 hosted tại sellbird.ai (đang trong 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 thư gửi tay cho khách quen, một công cụ đơn giản sẽ nhẹ hơn. Và nếu bạn chưa rõ khách hàng lý tưởng của mình là ai, hãy làm rõ điều đó trước, vì Sellbird chỉ tìm tốt khi bạn nói đúng mình cần ai.
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. Tìm công ty trên nguồn mặc định (OpenStreetMap) và đọc website là $0. Nguồn trả phí rẻ nhất khoảng $0,37 cho 1.000 kết quả theo README, và mỗi lần tìm trả phí đều hiện chi phí trước. Bạn vẫn cần gói Claude/ChatGPT và một hộp thư gửi (README nêu khoảng 7 đô la mỗi tháng cho Google Workspace).
Có cần API key của Claude hay OpenAI không?
Không. 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 tính tiền theo token. Nó cũng tự giới hạn để chừa chỗ cho việc bạn đang làm. Một số dịch vụ tuỳ chọn như xác minh email có thể cần khoá riêng, xem .env.example.
Có cần GPU không?
Tư liệu không nhắc yêu cầu GPU. Việc suy luận do Claude hoặc Codex đảm nhiệm qua gói thuê bao của bạn, không chạy mô hình cục bộ. Yêu cầu được nêu rõ là Python 3.11 trở lên.
Chạy được trên Windows không?
README có nêu thư mục dữ liệu cho Windows, nhưng các lệnh cài đặt trong phần Quick start viết theo kiểu macOS/Linux, và README chưa có lệnh riêng cho Windows. Docker được nói là dùng được trên Linux. Bạn có thể nhờ Claude Code hướng dẫn cài theo cách đầu tiên.
Nó có tự gửi email 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. 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 nằm ở đâu?
Nó chạy trên máy bạn. Cấu hình, tri thức và dữ liệu nằm trong một thư mục home (cơ sở dữ liệu, log và token bảng điều khiển nằm trong data/). Tư liệu không nói thêm về chính sách dữ liệu của các dịch vụ bên thứ ba mà bạn có thể kết nối.
Tôi đang dùng Harvey thì có phải cài lại không?
Không. Harvey đã đổi tên thành Sellbird từ bản 0.4.0, cấu hình, dữ liệu và đăng nhập bảng điều khiển được giữ nguyên. Bạn chạy git pull rồi pip install -e . để có lệnh sellbird mới. Các biến HARVEY_* vẫn hoạt động nếu chưa đặt biến SELLBIRD_* tương ứng.


