Sellbird: tự tìm khách 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ự tìm công ty phù hợp, tìm người quyết định, xác minh email, viết và gửi cold email rồi xử lý thư trả lời, và chạy bằng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có. Cài không quá khó nếu bạn quen terminal, hoặc bạn có thể nhờ Claude Code cài giúp.
Sellbird là một nền tảng mã nguồn mở chạy ngay trên máy của bạn, làm trọn chuỗi việc của một chiến dịch 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. Dự án trước đây tên là Harvey, nay đổi tên thành Sellbird, vẫn là cùng một dự án và cùng lịch sử.
Bạn nên xem qua nếu bạn là chủ doanh nghiệp nhỏ, người làm sales, làm marketing, hoặc lập trình viên muốn có một danh sách khách tiềm năng mà không phải trả tiền cho hàng loạt công cụ prospecting. Hiện repo có khoảng 5250 sao và 1127 fork, và vẫn được cập nhật trong vài tháng gần đây.
Điểm đáng giá nhất có hai ý. Thứ nhất, Sellbird dùng gói Claude Pro/Max hoặc gói ChatGPT có Codex bạn đã trả tiền, nên không cần API key mô hình và không bị tính tiền theo token. Thứ hai, 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 là nền tảng mã nguồn mở chạy trên máy bạn: tìm công ty và người quyết định, kiểm tra email, viết thư cá nhân hoá, gửi và xử lý thư trả lời.
I.Sellbird làm được gì
Sellbird là một chuỗi bước. Bạn có thể chạy hết cả chuỗi, hoặc dừng ở bất kỳ bước nào.
A.Tìm công ty phù hợp
Nó tìm các doanh nghiệp khớp với 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 nguồn trả phí, và mỗi lần tìm bằng nguồn trả phí đều hiện chi phí trước khi chạy, nên khó bị tính tiền bất ngờ.
B.Đọc tín hiệu mua hàng
Sellbird đọ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 mô hình và không tốn tiền, vì mỗi công ty chỉ cần ba request HTTP. Lợi ích thực tế là email của bạn có lý do để viết, thay vì gửi đại trà.
C.Tìm người ra quyết định
Nó tìm chủ hoặc quản lý có 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. Bạn không phải mua thêm cơ sở dữ liệu liên hệ.
D.Kiểm tra địa chỉ email
Sellbird học mẫu 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, và chỉ địa chỉ gửi được mới bị gửi tới. Điều này giúp bảo vệ uy tín hộp thư 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. Sau đó 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.
F.Xử lý thư trả lờ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 xếp riêng, yêu cầu ngừng nhận được tôn trọng ngay, và những thư nó không nên tự trả lời sẽ chuyển cho bạn.
G.Chỉ lấy danh sách cũng được
Nếu bạn chỉ cần danh sách khách, hãy dừng sau bước xác minh rồi chạy sellbird export. Bạn sẽ có một file CSV sẵn để đưa vào công cụ gửi email khác.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Python 3.11 trở lên. README lưu ý macOS đi kèm Python 3.9, nên nếu
python3 --versionbáo bản cũ thì cài thêm bằngbrew install python@3.13. - Gói Claude Pro hoặc Max và đã đăng nhập Claude CLI bằng
claude login. Hoặc gói ChatGPT có Codex CLI (repo 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 dùng được.
- Warmup (làm nóng) cho hộp thư đó. README giới thiệu TrulyInbox, và Sellbird có thể đọc tỉ lệ vào inbox từ đó để báo bạn khi nào đã sẵn sàng. Đây là liên kết tiếp thị của tác giả, nên bạn tự cân nhắc.
File .env.example liệt kê các biến cấu hình tuỳ chọn như thông tin Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ xác minh email (Reoon, ZeroBounce, Hunter) và vài dịch vụ khác. README ghi mỗi biến đều có chú thích ngay trong file. Bạn chỉ cần điền những gì mình dùng.
Về hệ điều hành, README ghi cách cài bằng lệnh kiểu macOS/Linux và nói Docker chạy trên Linux. Thư mục dữ liệu có đường dẫn cho cả Windows (%APPDATA%\sellbird), nhưng README không có hướng dẫn cài riêng cho Windows. Bạn dùng Windows thì nên xem mục Troubleshooting và Docker trong thư mục docs/ của repo.
Sellbird gửi email thật từ hộp thư thật của bạn. Hãy dùng một tên miền gửi riêng, warmup đủ lâu, và đọc tài liệu Legal and deliverability trong repo để biết quy định về cold email ở nơi bạn gửi. Đừng điền mật khẩu hay key vào chỗ nào ngoài file .env của chính bạn.
III.Cài đặt từng bước
- Kiểm tra Python và ClaudePython 3.11+, Claude CLI đã đăng nhập
- Tải mã nguồngit clone rồi cd vào thư mục
- Cài góitạo môi trường ảo và pip install -e .
- Điền thông tintạo .env, rồi dạy Sellbird về sản phẩm của bạn
- Tìm kháchxác nhận tín hiệu rồi chạy discover
- Mở dashboard và chạysellbird dashboard, sellbird run
README có hai cách: nhờ Claude Code cài giúp, hoặc tự gõ lệnh. Cách đầu dễ hơn cho người mới.
A.Cách dễ: để Claude cài giúp
Mở terminal (macOS/Linux dùng Terminal, Windows dùng PowerShell hoặc Git Bash), rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudegit clone tải mã nguồn về, cd sellbird đi vào thư mục vừa tải, claude mở Claude Code ngay trong thư mục đó. Sau đó bạn gõ câu: 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 những gì cần hỏi và dạy Sellbird về sản phẩm của bạn. Lưu ý là bạn phải đã cài Claude Code và đăng nhập trước.
B.Hoặc tự cài: tạo môi trường và cài gói
Đứng trong thư mục sellbird đã clone, chạy:
# 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 Python riêng tên .venv, bật nó lên, rồi cài Sellbird vào đó. Sau khi xong, bạn có lệnh sellbird. Chỗ hay vấp: trên macOS hãy gõ python3.13 chứ đừng gõ python3. Phần source .venv/bin/activate là cách bật môi trường trên macOS/Linux. Trên Windows, README không ghi cách này, và cách bật môi trường ảo của Python ở đó khác, nên bạn nên tra hướng dẫn Python hoặc dùng Docker/WSL.
C.Điền thông tin vào .env
# 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ở ra để bạn sửa. Mọi biến đều có chú thích ngay trong file. Hãy điền thông tin hộp thư gửi (Gmail, Microsoft 365 hoặc SMTP) và các key dịch vụ mà bạn thật sự dùng. Nếu máy không có biến $EDITOR, bạn cứ mở file .env bằng trình soạn thảo quen thuộ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.comThay địa chỉ bằng website công ty bạn. Sellbird đọc trang đó để hiểu bạn bán gì và ghi kết quả vào sellbird.local.yaml. Đây là file cấu hình của riêng bạn, git không đụng tới, nên cập nhật phiên bản sau này không làm mất.
E.Xác nhậ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 discoverLệnh signals chốt các tín hiệu cho thấy một công ty là khách tốt. discover tìm doanh nghiệp từ nguồn mặc định, miễn phí và không cần tài khoản.
F.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 địa chỉ trên máy bạn (cổng 5555). Bạn mở link đó trong trình duyệt để xem Outbox và duyệt email. sellbird run bật vòng lặp làm việc. Hai lệnh này nên chạy ở hai cửa sổ terminal riêng nếu một lệnh giữ terminal bận.
Trên Linux, README nói bạn cũng có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, và hướng dẫn chi tiết nằm trong tài liệu Docker ở docs/.
IV.Kiểm tra đã chạy được chưa
Sau khi pip install -e . xong, gõ sellbird trong cùng terminal (đã bật môi trường ảo). Nếu máy nhận ra lệnh thì gói đã cài. Sau đó chạy sellbird dashboard: nếu nó in ra link dạng http://127.0.0.1:5555 và bạn mở được trang dashboard, phần giao diện đã ổn.
Với sellbird run, README cho thấy kết quả mẫu như sau: dòng "Sellbird is online", rồi "Checking pipeline state...", một dòng Decision cho biết bước tiếp theo, vài dòng cho biết agent nào đang làm gì, và cuối cùng "Cycle complete. Sleeping for 15 minutes.". Dòng cuối cùng nói rằng nó chạy theo chu kỳ và nghỉ 15 phút giữa các vòng. Nếu bạn thấy chu kỳ hoàn tất và có email nằm chờ ở Outbox, mọi thứ đang hoạt động.
Còn một cách an toàn để thử: README nói dữ liệu demo là dữ liệu bịa (công ty Bookwell bán đặt lịch online, dùng tên miền .test), nên bạn có thể làm quen giao diện mà không sợ gửi nhầm cho ai.
V.Dùng vào việc thật
A.Chủ doanh nghiệp nhỏ muốn có danh sách khách địa phương
Bạn bán phần mềm đặt lịch cho phòng khám nha khoa và tiệm sửa điều hoà. Bạn chưa muốn gửi email, chỉ cần danh sách. Hãy chạy các bước train, signals, discover, rồi dừng sau bước xác minh và xuất file:
sellbird exportKết quả là một file CSV sẵn cho công cụ gửi email, gồm các doanh nghiệp tìm được kèm người liên hệ và nhãn xác minh email. Nguồn tìm mặc định là miễn phí nên chi phí gần như bằng không.
Không có email nào rời máy bạn nếu bạn chưa bấm duyệt.
Ông T
B.Người làm sales cần viết thư cá nhân hoá mà vẫn kiểm soát được
Bạn đã cài xong và chạy sellbird run. Mỗi vòng, Sellbird viết chuỗi email dựa trên tín hiệu tìm được, ví dụ "công ty đang tuyển nhân viên điều phối". Các email chờ ở Outbox. Bạn mở dashboard, đọc từng thư, sửa nếu cần rồi duyệt. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ 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. Kết quả: thư của bạn ngắn, có lý do riêng cho từng người, và bạn vẫn là người quyết định cuối cùng.
C.Chủ shop muốn có người đỡ trả lời thư phản hồi
Khi khách trả lời, Sellbird phân loại và soạn sẵn câu trả lời. Ví dụ README cho thấy thư "quan tâm" và thư "phản đối" đều được soạn sẵn nội dung. Thư tự động trả lời được xếp riêng, ai xin ngừng nhận thì được tôn trọng ngay. Bạn chỉ cần đọc phần nó chuyển cho bạn thay vì lục cả hộp thư. Nếu muốn dừng khẩn cấp, bạn chạy:
sellbird sending pauseLệnh này dừng toàn bộ việc gửi ngay lập tức.
D.Lập trình viên đang dùng Harvey cũ
Nếu bạn đã chạy Harvey, cấu hình và dữ liệu của bạn được giữ lại. Bạn chạy:
git pull
pip install -e . # once, to get the new `sellbird` command
sellbird dashboardLần chạy đầu, Sellbird tự đổi tên harvey.local.yaml thành sellbird.local.yaml và đổi tên file dữ liệu, không ghi đè file nào đã có tên mới. Nếu bạn từng sửa trực tiếp file harvey.yaml được git theo dõi, git pull sẽ báo lỗi. Cách xử lý README mô tả là git stash, git pull, git stash pop. Tốt hơn, bạn nên đặt cài đặt riêng vào sellbird.local.yaml để git không đụng tới.
VI.Lỗi hay gặp và cách xử lý
A.Gõ python3 nhưng báo phiên bản cũ
Trên macOS, python3 có thể là bản 3.9, trong khi Sellbird cần Python 3.11 trở lên. Cài bản mới bằng brew install python@3.13 rồi dùng python3.13 để tạo môi trường ảo, đúng như README dặn.
B.Không tìm thấy lệnh sellbird
Thường là do bạn chưa bật môi trường ảo trong cửa sổ terminal hiện tại, hoặc pip install -e . chưa chạy xong. Quay lại thư mục sellbird, bật môi trường ảo rồi cài lại. Hãy chắc là bạn đang đứng đúng thư mục có file pyproject.toml.
C.Claude không phản hồi hoặc báo chưa đăng nhập
Sellbird suy nghĩ qua Claude Code CLI, nên CLI phải được đăng nhập bằng claude login trên gói Pro hoặc Max. Nếu bạn dùng ChatGPT, cần cài Codex CLI theo tài liệu riêng của repo. README cũng nói Sellbird tự giới hạn để chừa chỗ cho việc của bạn, nên nếu thấy nó chạy chậm thì có thể đó là chủ ý.
D.Git pull báo local changes would be overwritten
Đây là lỗi dành cho người nâng cấp từ Harvey đã sửa trực tiếp harvey.yaml. Chạy git stash, git pull, git stash pop. Nếu có xung đột trong sellbird.yaml, giữ lại các dòng của bạn, xoá các dấu xung đột, rồi git stash drop.
E.Email vào thư rác hoặc không gửi được
README nhấn mạnh phải warmup hộp thư trước khi gửi cold email, và nên dùng tên miền gửi riêng. Sellbird chỉ gửi tới địa chỉ được đánh dấu deliverable. Nếu tỉ lệ vào inbox thấp, hãy giảm lượng gửi và đọc tài liệu Legal and deliverability trong repo. Chi tiết xử lý sự cố nằm ở mục Troubleshooting trong docs/.
VII.Có nên dùng không
Điểm mạnh. Bạn không phải trả tiền API mô hình, vì nó dùng gói bạn có sẵn. Nguồn tìm doanh nghiệp mặc định miễn phí, bước đọc website không tốn tiền, và mọi chi phí trả phí đều hiện trước khi chạy. Mặc định không email nào gửi khi bạn chưa duyệt, lại có lớp kiểm tra trước khi gửi và lệnh dừng khẩn cấp. Dữ liệu nằm trên máy bạn, và mã nguồn mở để bạn sửa các prompt, kỹ năng bán hàng theo ý mình.
Giới hạn. Bạn phải tự lo hộp thư gửi, tên miền riêng và warmup, đây là phần tốn công nhất. README không có hướng dẫn cài riêng cho Windows, nên người dùng Windows có thể phải thử Docker hoặc WSL. Nguồn tìm miễn phí là OpenStreetMap, nên phạm vi phủ phụ thuộc vào dữ liệu ở khu vực bạn nhắm tới. Repo viết bằng tiếng Anh, và README không nói gì về chất lượng email tiếng Việt, nên bạn nên đọc kỹ thư nháp trước khi duyệt. 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.
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 ở sellbird.ai đang ở giai đoạn early access, với tên miền gửi, hộp thư và warmup được lo sẵn. Nếu bạn không quen terminal và không có hộp thư gửi riêng, hãy thử bước tìm khách và xuất CSV trước, rồi mới tính chuyện gửi tự động. Và dù chọn cách nào, hãy tuân thủ luật và quy định về email quảng cáo ở nơi bạn kinh doanh.
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 và không có phí dùng phần mềm. Bạn cần gói Claude Pro/Max hoặc ChatGPT có Codex đang có, và một hộp thư để gửi (README nhắc khoảng 7 USD một tháng cho Google Workspace). Nguồn tìm doanh nghiệp mặc định là miễn phí, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả.
Có cần API key của Claude hay OpenAI không?
Không. Theo README, Sellbird chạy qua Claude Code CLI trên gói 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 khác như xác minh email có biến key riêng trong file .env.example.
Cần GPU hay máy cấu hình mạnh không?
README không nói về yêu cầu phần cứng. Phần suy nghĩ chạy qua Claude hoặc Codex nên không có dấu hiệu cần GPU, nhưng chưa có thông tin chính thức.
Chạy trên Windows được không?
README hướng dẫn lệnh kiểu macOS/Linux và nói Docker chạy trên Linux. Thư mục dữ liệu có đường dẫn cho Windows, nhưng README không có hướng dẫn cài riêng cho Windows. Bạn nên xem tài liệu Troubleshooting và Docker trong thư mục docs của repo.
Nó có tự gửi email mà tôi không biết không?
Mặc định thì không. Mọi email chờ ở Outbox cho tới khi bạn duyệt, trừ khi bạn tự bật chế độ autopilot. Ngay cả khi bật autopilot, nó vẫn giữ lại thư chứa link tới tên miền không phải của bạn. 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?
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, kèm file database và log. Dashboard mặc định mở ở địa chỉ 127.0.0.1 trên máy bạn với link riêng. README không nói thêm về các biện pháp bảo mật khác, nên hãy giữ file .env cẩn thận.
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 bạn được giữ lại khi nâng cấp. Lệnh harvey cũ vẫn chạy tạm thời nhưng sẽ bị bỏ ở bản sau. Các bản Harvey tới 0.3.x dùng giấy phép MIT, còn từ bản đổi tên là AGPL-3.0.


