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, tự tìm công ty phù hợp, tìm người ra quyết định, kiểm tra email, viết cold email và xử lý thư trả lời. Nó chạy trên gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có, 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 email nào được gửi nếu 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 bằng 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 từng email cá nhân hoá, gửi đi và xử lý thư trả lời. Trước đây dự án tên là Harvey, nay đổi tên thành Sellbird nhưng vẫn là cùng một dự án, cùng lịch sử.
Repo này hợp với chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, và lập trình viên muốn có sẵn một "nhân viên prospecting" mà không phải thuê Apollo, ZoomInfo, Clearbit hay Clay. Mình thấy điểm đáng giá nhất là nó suy nghĩ qua Claude Code CLI trên gói Claude Pro/Max của bạn (hoặc Codex trên gói ChatGPT), nên không có API key mô hình và không bị tính tiền theo token.
Một điểm nữa đáng nói: theo mặc định, không có email nào rời máy nếu bạn chưa bấm duyệt. Bạn có thể xem video ngắn bên dưới để thấy tổng quan, rồi quay lại đây làm theo từng bước.
ethanplusai/sellbird
Nền tảng mã nguồn mở tìm công ty và người quyết định, xác minh email, viết cold email cá nhân hoá, gửi và xử lý trả lời — chạy trên gói Claude/ChatGPT.
I.Sellbird làm được gì
Sellbird là một đường ống (pipeline). Bạn có thể chạy từ đầu đến cuối, hoặc dừng ở bước nào tuỳ ý.
- Tìm công ty. 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í. 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, nên không lo bị tính tiền bất ngờ.
- Hiểu vì sao 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, không tốn tiền: mỗi công ty chỉ cần ba request HTTP.
- Tìm người quyết định. Nó tìm chủ hoặc quản lý được nêu tên ngay trên trang của công ty, tối đa hai người mỗi công ty. Nhờ vậy bạn gửi đúng người thay vì gửi vào hộp thư chung.
- Kiểm tra địa chỉ email. Nó học kiểu đặt 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 được dùng để gửi. Việc này giúp bạn tránh thư bị trả lại, bảo vệ uy tín tên miền 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, 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 sẵn câu đáp, tách riêng các 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 tiềm năng, hãy dừng sau bước kiểm tra email và chạy sellbird export để lấy file CSV dùng được ngay cho công cụ gửi email hàng loạt.
Về an toàn, mỗi email gửi đi đều nằm chờ trong hộp Outbox cho đến khi bạn duyệt, trừ khi bạn tự bật chế độ autopilot. Trước khi gửi còn có một lớp kiểm tra không dùng mô hình, loại bỏ email còn sót thẻ merge chưa điền, cụm từ bị cấm, email quá dài, thừa link và địa chỉ không gửi được. Lệnh sellbird sending pause dừng mọi thứ ngay lập tức.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Python 3.11 trở lên. README lưu ý macOS có sẵn 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 với Claude Code CLI đã đăng nhập (
claude login), hoặc gói ChatGPT có Codex CLI. Phần Codex có hướng dẫn riêng trong thư mục docs của repo. - Một hộp thư để gửi đ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 khuyên dùng TrulyInbox, và Sellbird đọc được tỉ lệ vào inbox của nó để báo khi nào bạn sẵn sàng gửi. Liên kết TrulyInbox trong dự án là link affiliate của người duy trì repo.
- Chi phí tham khảo theo README: tìm doanh nghiệp là 0 đô trên nguồn mặc định, hoặc khoảng 0,37 đô cho 1.000 kết quả trên nguồn trả phí rẻ nhất; Google Workspace khoảng 7 đô mỗi tháng.
Tệp .env.example còn liệt kê nhiều biến cho các dịch vụ tuỳ chọn (Gmail, SMTP/IMAP, Microsoft 365, Instantly, các dịch vụ xác minh email như Reoon, ZeroBounce, Hunter, và vài dịch vụ khác). README nói mỗi biến đều có chú thích ngay trong file. Bạn chỉ điền những gì đúng với cách bạn định dùng.
Về hệ điều hành: README viết lệnh theo kiểu macOS/Linux và nói Docker dùng được trên Linux. README cũng ghi thư mục dữ liệu cho cả macOS, Windows và Linux, nhưng chưa ghi lệnh kích hoạt môi trường ảo riêng cho Windows. Người dùng Windows nên đọc kỹ thư mục docs của repo trước khi cài.
III.Cài đặt từng bước
- Tải mã nguồnDùng git clone rồi vào thư mục sellbird
- Cài đặtTạo môi trường ảo và chạy pip install -e .
- Đ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 địa chỉ 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.Cách nhanh: để Claude cài giúp
Nếu bạn đã có Claude Code, đây là đường dễ nhất. Mở terminal (ứng dụng dòng lệnh) ở nơi bạn muốn lưu dự án, rồi chạy:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeSau khi Claude Code mở, bạn 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: nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi những thông tin cần, và huấn luyện Sellbird về sản phẩm của bạn. Người mới nên chọn cách này.
B.Hoặc tự cài từng lệnh
Trước hết tải mã nguồn về (nếu chưa làm ở trên) rồi vào thư mục dự án:
git clone https://github.com/ethanplusai/sellbird.git
cd sellbirdTiếp theo tạo môi trường ảo và cài gói. README dặn dùng python3.13 chứ không dùng python3, vì trên macOS python3 trần là bản 3.9 quá cũ:
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .Lệnh này làm ba việc nối nhau: tạo một môi trường Python riêng tên .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được (-e). Sau khi xong, lệnh sellbird sẽ dùng được trong terminal đó. Nếu bạn mở terminal mới, nhớ kích hoạt lại môi trường ảo.
C.Điền thông tin đăng nhập
Sao chép file mẫu thành file cấu hình thật rồi mở ra sửa:
cp .env.example .env && $EDITOR .env.env là nơi bạn điền thông tin hộp thư gửi và các khoá dịch vụ (nếu dùng). Chỗ người mới hay vấp: file này chứa mật khẩu, nên không đưa nó lên GitHub hay gửi cho ai. $EDITOR là trình soạn thảo mặc định trong terminal; nếu không quen, bạn cứ mở file .env bằng trình soạn thảo văn bản thường.
.env chứa mật khẩu và khoá truy cập hộp thư. Giữ nó chỉ trên máy bạn, đừng chia sẻ hay đưa vào kho mã công khai. Nên dùng một tên miền và hộp thư gửi riêng, đã warmup, để không ảnh hưởng hộp thư chính của công ty.
D.Dạy Sellbird về sản phẩm của bạn
sellbird train https://your-company.comThay địa chỉ bằng website thật của bạn. Lệnh này đọc website, hiểu bạn bán gì và cho ai, rồi ghi kết quả vào file sellbird.local.yaml. File này là của bạn, git không đụng vào khi bạn cập nhật.
E.Xác nhận tín hiệu và tìm khách
sellbird signals --confirm free
sellbird discoverLệnh đầu giúp bạn xác nhận điều gì làm nên một khách tiềm năng tốt. Lệnh thứ hai tìm doanh nghiệp. README nói nguồn mặc định miễn phí và không cần tài khoản.
F.Mở bảng điều khiển và chạy vòng lặp
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ư tới trang quản lý chạy ngay trên máy bạn (địa chỉ 127.0.0.1:5555). sellbird run khởi động vòng lặp làm việc. Hãy mở dashboard ở một cửa sổ terminal và chạy sellbird run ở cửa sổ khác.
Ngoài ra README nói trên Linux bạn có thể chạy bằng Docker; repo có sẵn Dockerfile và docker-compose.yml, chi tiết xem trong thư mục docs.
IV.Kiểm tra đã chạy được chưa
Sau khi chạy sellbird run, bạn sẽ thấy thông báo kiểu "Sellbird is online", rồi nó kiểm tra trạng thái pipeline và đưa ra quyết định. README cho ví dụ đầu ra như sau:
$ sellbird run
============================================================
Sellbird is online.
============================================================
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
handler → Elena Park, Harbor Dental Studio interested, answer drafted
handler → Priya Nair, Highline Roofing objection, answer drafted
writer → 2-email sequence: Phoenix HVAC hiring a dispatcher
outbox → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.Đây là dữ liệu mẫu bịa ra trong README (công ty Bookwell bán phần mềm đặt lịch). Dấu hiệu thành công với bạn là: lệnh sellbird chạy được, dashboard mở được bằng link riêng, và email nằm chờ trong Outbox chứ không bị gửi đi ngay. Nếu thấy dòng "emails waiting for your approval", nghĩa là cơ chế duyệt đang hoạt động đúng.
V.Dùng vào việc thật
A.Chủ doanh nghiệp nhỏ muốn có danh sách khách để gọi
Bạn bán phần mềm đặt lịch cho tiệm làm đẹp hay phòng khám nha khoa và chỉ cần một danh sách khách tiềm năng, chưa muốn gửi email. Chạy sellbird train với website của bạn, sellbird signals --confirm free, rồi sellbird discover. Khi đã qua bước xác minh email, chạy sellbird export. Kết quả là file CSV gồm công ty, người quyết định và email đã gắn nhãn, đưa thẳng vào công cụ gửi mail hoặc bảng tính để đội sales gọi.
B.Người làm sales gửi chuỗi email cá nhân hoá
Bạn muốn mỗi email nhắc đúng một chi tiết của công ty nhận, như "đang tuyển điều phối viên". Sau khi chạy sellbird run, Sellbird viết một chuỗi ngắn cho mỗi người dựa trên tín hiệu tìm được. Bạn mở dashboard, vào Outbox, đọc từng email và chỉ duyệt cái nào ưng ý.
Mặc định không email nào đi ra nếu bạn chưa bấm duyệt, nên bạn thử được mà không sợ gửi nhầm.
Ông T
Kết quả là bạn kiểm soát được giọng văn và nội dung, còn phần việc nặng (tìm, kiểm tra, viết nháp) máy làm thay.
C.Xử lý thư trả lời mà không bỏ sót
Khi khách trả lời, Sellbird đọc thư, phân loại (quan tâm, phản đối, thư tự động, từ chối nhận) và soạn sẵn câu đáp. Thư tự động được xếp riêng, yêu cầu từ chối được tôn trọng ngay, còn thư nó không nên tự trả lời thì được chuyển cho bạn. Bạn mở dashboard để xem các thư đã soạn đáp và duyệt, thay vì lục từng hộp thư.
D.Lập trình viên muốn tuỳ biến theo cách bán của mình
Repo có thư mục prompts/ và skills/, README gọi là các "sales playbook" có thể chỉnh sửa, và có tài liệu về phần mở rộng (thêm route, bước heartbeat, lệnh từ gói riêng). Bạn sửa prompt cho đúng giọng thương hiệu, rồi chạy thử trên dữ liệu thật ở chế độ cần duyệt. Sửa trong thư mục dự án của bạn, không sửa file gốc được theo dõi bởi git nếu tránh được; cấu hình riêng nên đặt trong sellbird.local.yaml.
VI.Lỗi hay gặp và cách xử lý
Lệnh sellbird báo không tìm thấy. Thường là bạn chưa kích hoạt môi trường ảo hoặc đã mở terminal mới. Vào thư mục dự án, kích hoạt lại .venv rồi thử lại. Nếu vẫn lỗi, chạy lại bước pip install -e ..
Python quá cũ. Nếu python3 --version ra 3.9 (hay gặp trên macOS), cài bản mới bằng brew install python@3.13 và dùng python3.13 để tạo môi trường ảo, đúng như README dặn. Dự án yêu cầu Python 3.11 trở lên.
Claude CLI chưa đăng nhập. Sellbird suy nghĩ qua Claude Code CLI, nên bạn cần chạy claude login trước. Nếu dùng ChatGPT, xem hướng dẫn Codex trong thư mục docs.
Email không gửi được hoặc rơi vào spam. Kiểm tra bạn đã điền đúng thông tin hộp thư trong .env, và hộp thư đã warmup chưa. README nhấn mạnh warmup và tên miền gửi riêng. Xem thêm tài liệu về deliverability và mục Troubleshooting trong docs.
git pull báo "your local changes would be overwritten" (khi nâng cấp từ Harvey). 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 rồi chạy git stash drop. Cách tốt hơn là đặt cài đặt riêng vào sellbird.local.yaml.
VII.Có nên dùng không
Điểm mạnh. Chạy trên máy bạn, dùng gói Claude hoặc ChatGPT sẵn có nên không phát sinh hoá đơn API mô hình. Có bước duyệt thủ công, kiểm tra trước khi gửi, và nút dừng khẩn cấp. Nguồn tìm khách mặc định miễn phí, giấy phép AGPL-3.0, repo hiện có khoảng 5.250 sao, 1.127 fork và vẫn được cập nhật gần đây.
Giới hạn. Bạn vẫn phải lo hạ tầng gửi mail: tên miền riêng, hộp thư, warmup. README ví dụ dữ liệu bằng tiếng Anh, và nguồn miễn phí OpenStreetMap có thể không phủ hết thị trường của bạn; tư liệu chưa nói rõ chất lượng với doanh nghiệp Việt Nam. Hướng dẫn cài trong README thiên về macOS/Linux. Bạn cũng cần tự tìm hiểu quy định pháp lý về gửi email thương mại ở nơi bạn gửi (repo có tài liệu Legal and deliverability).
Khi nào chọn cách khác. Nếu bạn không muốn tự vận hành, dự án có bản hosted tại sellbird.ai (README ghi là đang early access, có sẵn tên miền gửi, hộp thư và warmup). Nếu bạn chỉ gửi vài email thủ công mỗi tuần thì công cụ này là hơi thừa. Còn nếu bạn muốn thử, hãy bắt đầu bằng cách để Claude cài giúp và giữ chế độ duyệt từng email.
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ải về dùng được. Theo README, bạn không cần API key mô hình mà dùng gói Claude Pro/Max hoặc ChatGPT sẵn có. Nguồn tìm doanh nghiệp mặc định miễn phí, nguồn trả phí rẻ nhất khoảng 0,37 đô cho 1.000 kết quả, còn hộp thư Google Workspace khoảng 7 đô mỗi tháng.
Có cần GPU hay máy cấu hình mạnh không?
Tư liệu không nhắc yêu cầu GPU hay cấu hình phần cứng. Phần suy nghĩ chạy qua Claude Code CLI hoặc Codex trên gói đăng ký của bạn, và bước đọc website chỉ cần vài request HTTP, không gọi mô hình.
Chạy trên Windows được không?
README ghi thư mục dữ liệu cho cả Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt được viết theo kiểu macOS/Linux và Docker được nói là dùng trên Linux. Chưa có lệnh kích hoạt môi trường ảo riêng cho Windows trong README, bạn nên xem thư mục docs của repo.
Sellbird có tự gửi email lung tung không?
Không, theo mặc định. Mọi email chờ trong Outbox cho đến khi bạn duyệt, trừ 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, và lệnh sellbird sending pause dừng mọi thứ 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 riêng, dashboard mở bằng link riêng tại 127.0.0.1. Tư liệu không nói gì thêm về mã hoá hay chính sách dữ liệu, nên bạn nên đọc SECURITY.md và tài liệu trong repo.
Khác gì Apollo, ZoomInfo hay Clay?
README nói rõ Sellbird không dùng các công cụ prospecting đó. Nó tự tìm công ty, người quyết định và kiểm tra email, rồi viết và gửi email, tất cả chạy trên máy bạn bằng gói Claude hoặc ChatGPT. Tư liệu không so sánh chi tiết về chất lượng dữ liệu với các công cụ trên.
Tôi đang dùng Harvey thì nâng cấp thế nào?
Chạy git pull, rồi pip install -e . một lần để có lệnh sellbird mới, sau đó chạy sellbird dashboard. README cho biết cấu hình, dữ liệu và đăng nhập dashboard được giữ nguyên, các biến HARVEY_* vẫn dùng được khi chưa đặt biến SELLBIRD_* tương ứng.


