Sellbird: tự tìm khách, viết và gửi cold email bằng gói Claude/ChatGPT — 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 là Harvey) là nền tảng mã nguồn mở viết bằng Python, giúp bạn làm outreach: tìm khách tiềm năng, xác minh email, viết thư lạnh và xử lý phản hồi. Nó dùng Claude Code CLI hoặc Codex trên gói thuê bao bạn đang có nên không cần API key của mô hình. Cài bằng vài lệnh, hoặc nhờ Claude Code tự cài giúp, cần Python 3.11 trở lên và một hộp thư để gửi.
Sellbird là một nền tảng mã nguồn mở chạy trên máy của bạn, giúp làm cả chuỗi việc "tìm khách rồi gửi cold email": tìm công ty phù hợp, 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, giờ đã đổi thành Sellbird.
Điểm khiến mình thấy đáng chú ý nhất là chuyện chi phí và quyền kiểm soát. Sellbird không đòi API key của mô hình AI. Nó "suy nghĩ" qua Claude Code CLI trên gói Claude Pro hoặc Max, hoặc qua Codex trên gói ChatGPT. Nghĩa là bạn dùng luôn gói thuê bao đang trả, không bị tính tiền theo từng token. Mặc định, không có email nào được gửi đi khi bạn chưa duyệt.
Repo hiện có khoảng 5250 sao và 1127 fork. Ai nên dùng? Chủ doanh nghiệp nhỏ, nhân viên sales, người làm agency muốn tự động hoá việc tìm khách mà không muốn trả thêm cho Apollo, ZoomInfo hay Clay. Bạn xem video ngắn bên dưới để thấy nó chạy thế nào, rồi quay lại đây làm theo từng bước.
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á, gửi và xử lý 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 chuỗi công đoạn. Bạn có thể chạy hết, hoặc dừng ở bước nào cũng được.
- 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í 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 trả phí đều hiện chi phí trước khi chạy.
- Tìm lý do họ sẽ mua. Sellbird đọc website của từng công ty để tìm các "tín hiệu mua hàng" 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, 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ó tên 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 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 được gửi thư tới.
- Viết và gửi. Nó viết một chuỗi thư ngắn cho từng người dựa trên những gì tìm được. Thư được gửi từ Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn số thư mỗi ngày và theo giờ làm việc của người nhận.
- Xử lý trả lời. Nó đọc từng thư trả lời, soạn sẵn câu đáp, tách riêng thư tự động trả lời, 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ự đáp.
Nếu bạn chỉ cần danh sách khách, hãy dừng sau bước xác minh và chạy sellbird export để có file CSV sẵn sàng đư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 hộp Outbox cho bạn duyệt, cho tới khi bạn tự bật chế độ autopilot. Trước khi gửi còn có bước kiểm tra không dùng mô hình, loại thư còn sót thẻ merge 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 toàn bộ việc gửi ngay.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Python 3.11 trở lên. File
pyproject.tomlcũng yêu cầu>=3.11. README lưu ý macOS có sẵn Python 3.9, nên nếupython3 --versionbáo 3.9 thì phải cài thêm bằngbrew install python@3.13. - Claude Pro hoặc Max, đã đăng nhập Claude Code CLI bằng
claude login. Hoặc gói ChatGPT có Codex CLI (repo có tài liệu riêng cho cách này). - 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 cho việc này. Tác giả ghi rõ link TrulyInbox là link affiliate. Đây chỉ là gợi ý, bạn không bắt buộc dùng.
Về chi phí: 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. Phần còn lại là gói thuê bao của bạn và hộp thư (README nêu khoảng 7 USD một tháng cho Google Workspace).
Về hệ điều hành, README viết phần cài đặt theo kiểu macOS/Linux và nói Docker chạy được trên Linux. Bảng thư mục dữ liệu có ghi cả Windows. README không nói rõ cách cài trọn gói trên Windows, nên bạn xem thêm tài liệu Docker và Troubleshooting trong thư mục docs/ của repo.
Các biến cấu hình nằm trong file .env.example, ví dụ GMAIL_CLIENT_ID, SMTP_HOST, REOON_API_KEY, HUNTER_API_KEY. Bạn chỉ điền những dịch vụ mình thật sự dùng.
III.Cài đặt từng bước
Có hai đường: nhờ Claude Code cài giúp (dễ nhất), hoặc tự gõ lệnh. Phần dưới là tóm tắt cho cách tự làm.
- 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 và chạy pip install -e .
- Điền thông tinSao chép .env.example thành .env rồi điền khoá cần dùng
- 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 sellbird discover
- ChạyMở dashboard và chạy sellbird run
A.Cách dễ nhất: để Claude Code cài giúp
Mở terminal (Terminal trên macOS, hoặc cửa sổ dòng lệnh bạn quen dùng) và chạy ba lệnh sau. Lệnh đầu tải mã nguồn, lệnh hai vào thư mục vừa tải, lệnh ba mở Claude Code ngay trong thư mục đó.
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claudeKhi Claude Code mở ra, bạn gõ "set up Sellbird for me". File CLAUDE.md trong repo biến Claude Code thành người hướng dẫn: nó kiểm tra máy của bạn, cài thứ 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ỗ người mới hay vấp: phải đứng trong thư mục sellbird rồi mới gõ claude, nếu không Claude Code sẽ không thấy CLAUDE.md.
B.Hoặc tự làm: cài đặt
Lệnh dưới tạo môi trường ảo, kích hoạt và cài Sellbird. 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. Dòng kích hoạt source .venv/bin/activate là của macOS/Linux. README không ghi dòng tương đương cho Windows.
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .C.Hoặc tự làm: điền thông tin
Lệnh này sao chép file mẫu thành .env rồi mở bằng trình soạn thảo mặc định của bạn. Mỗi biến trong file đều có chú thích ngay bên cạnh.
cp .env.example .env && $EDITOR .envNếu $EDITOR chưa được đặt trên máy bạn, cứ tự mở file .env bằng trình soạn thảo quen dùng. Đừng chia sẻ file này cho ai vì nó chứa mật khẩu và khoá.
D.Hoặc tự làm: dạy Sellbird về sản phẩm
Lệnh này đọc website công ty bạn để hiểu bạn bán gì. Kết quả được ghi vào file sellbird.local.yaml.
sellbird train https://your-company.comThay địa chỉ bằng website thật của bạn.
E.Hoặc tự làm: xác nhận tín hiệu và tìm khách
Lệnh đầu xác nhận thế nào là một khách tiềm năng tốt. Lệnh sau tìm doanh nghiệp, nguồn mặc định miễn phí và không cần tài khoản.
sellbird signals --confirm free
sellbird discoverF.Hoặc tự làm: mở dashboard và chạy
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ỉ http://127.0.0.1:5555, chỉ truy cập được trên máy bạn. sellbird run khởi động vòng lặp chính. Hai lệnh này cần chạy song song, nên bạn mở hai cửa sổ terminal.
Trên Linux bạn cũng có thể chạy bằng Docker, repo có sẵn Dockerfile và docker-compose.yml. README trỏ tới tài liệu Docker riêng trong docs/.
Cold email có quy định pháp lý và rủi ro bị đánh dấu spam. Hãy đọc tài liệu "Legal and deliverability" trong repo trước khi gửi thật, dùng tên miền gửi riêng và warmup hộp thư. Giữ nguyên chế độ duyệt tay ở Outbox cho tới khi bạn thật sự tin vào chất lượng thư.
IV.Kiểm tra đã chạy được chưa
Sau khi chạy sellbird run, README cho thấy màn hình mẫu như sau: dòng "Sellbird is online.", rồi "Checking pipeline state...", rồi một dòng "Decision" cho biết nó sẽ làm gì tiếp theo, ví dụ viết chiến dịch cho các prospect mới. Tiếp theo là các dòng của handler (xử lý thư trả lời), writer (viết chuỗi thư) và outbox (số email đang chờ bạn duyệt). Cuối cùng là "Cycle complete. Sleeping for 15 minutes." Nghĩa là mỗi vòng xong, nó nghỉ 15 phút rồi lặp lại.
Bạn không cần thấy đúng từng chữ, nhưng nếu có dòng "online" và không báo lỗi thì cài đặt ổn. Mở link riêng do sellbird dashboard in ra để xem danh sách công ty, người liên hệ và Outbox. Repo cũng có dữ liệu demo giả (công ty "Bookwell" bán phần mềm đặt lịch cho thợ lợp mái, nha khoa, điện lạnh, dùng tên miền .test) để bạn xem thử mà không đụng tới khách thật.
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 repo mô tả. Câu lệnh là lệnh có trong README.
A.Chủ doanh nghiệp nhỏ muốn tìm khách địa phương
Bạn bán phần mềm đặt lịch hoặc dịch vụ cho các cửa hàng địa phương. Bạn chạy sellbird train với website của mình để Sellbird hiểu sản phẩm, rồi sellbird signals --confirm free để chốt các tín hiệu như "chưa có đặt lịch online". Sau đó sellbird discover tìm doanh nghiệp từ OpenStreetMap, miễn phí. Kết quả là một danh sách công ty có lý do cụ thể để bạn liên hệ, thay vì gửi đại trà.
Không có email nào ra khỏi máy bạn khi bạn chưa bấm duyệt.
Ông T
B.Nhân viên sales chỉ cần danh sách sạch
Bạn đã có công cụ gửi thư riêng và chỉ cần danh sách. Bạn cho Sellbird chạy tới bước tìm người quyết định và xác minh email, rồi chạy:
sellbird exportBạn nhận file CSV gồm những gì Sellbird tìm được, sẵn sàng đưa vào công cụ gửi. Mỗi địa chỉ có nhãn verified, risky, guess hoặc invalid, nên bạn biết địa chỉ nào đáng tin.
C.Người làm agency chạy chiến dịch cho khách
Bạn muốn có chuỗi thư riêng cho từng người nhận. Sellbird viết một chuỗi ngắn dựa trên những gì tìm được ở website, ví dụ "công ty đang tuyển một nhân viên điều phối", như trong ví dụ HVAC ở README. Các thư nằm ở Outbox. Bạn đọc, sửa, duyệt từng thư. Nếu có gì bất thường, sellbird sending pause dừng mọi thứ ngay.
D.Người bận rộn muốn có người lo thư trả lời
Khi khách trả lời, Sellbird đọc, phân loại (quan tâm, phản đối, thư tự động), soạn sẵn câu đáp, và xử lý yêu cầu từ chối nhận thư ngay. Những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Bạn chỉ mở dashboard, xem bản nháp, chỉnh và gửi.
VI.Lỗi hay gặp và cách xử lý
A.python3 --version báo 3.9 hoặc thấp hơn 3.11
Sellbird cần Python 3.11 trở lên. Trên macOS, chạy brew install python@3.13 rồi dùng python3.13 để tạo môi trường ảo, đúng như README dặn. Dùng python3 trần sẽ cài sai phiên bản.
B.Lệnh sellbird không được nhận ra
Thường là do bạn chưa kích hoạt môi trường ảo, hoặc chưa chạy pip install -e .. Quay lại thư mục sellbird, kích hoạt .venv rồi cài 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 không phản hồi hoặc báo chưa đăng nhập
Sellbird dùng Claude Code CLI trên gói thuê bao của bạn, nên cần đăng nhập trước bằng claude login. Nếu dùng ChatGPT, hãy xem tài liệu "Using a ChatGPT plan (Codex)" trong repo.
D.git pull báo "your local changes would be overwritten" khi nâng cấp từ Harvey
Chuyện này xảy ra nếu bạn từng sửa trực tiếp file 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 rồi chạy git stash drop. Cách tốt hơn: đặt cài đặt của bạn trong sellbird.local.yaml, file này git không đụng tới.
E.Thư vào spam hoặc tỉ lệ gửi thấp
Đây là rủi ro chung của cold email, không riêng Sellbird. Hãy dùng tên miền gửi riêng, warmup hộp thư trước khi gửi, giữ số thư mỗi ngày thấp và đọc tài liệu "Legal and deliverability" trong repo. Không có công cụ nào đảm bảo thư tới hộp thư chính.
VII.Có nên dùng không
Điểm mạnh. Chạy trên máy của bạn, dùng gói Claude hoặc ChatGPT bạn đã có nên không phải trả tiền API theo token. Có bước duyệt tay mặc định, kiểm tra trước khi gửi không dùng mô hình, và lệnh dừng khẩn cấp. Nguồn tìm khách mặc định miễn phí. Giấy phép là AGPL-3.0, repo vẫn được cập nhật trong vài tháng gần đây, và có file CLAUDE.md để Claude Code cài đặt giúp bạn.
Giới hạn. Bạn vẫn cần hộp thư gửi, nên chuẩn bị tên miền riêng và warmup, nghĩa là có thêm chi phí và thời gian chuẩn bị. README viết cho macOS/Linux, nên người dùng Windows nên đọc kỹ tài liệu hoặc thử Docker. Dữ liệu từ OpenStreetMap phù hợp nhất với doanh nghiệp địa phương, không chắc đủ cho mọi ngành. Giấy phép AGPL-3.0 có ràng buộc nếu bạn muốn sửa và cung cấp lại như một dịch vụ. Và quan trọng nhất, chất lượng cold email vẫn phụ thuộc vào sản phẩm và cách bạn chọn tệp khách.
Khi nào nên 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 ở 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 hơn là đủ. Còn nếu bạn muốn thử cách làm outreach tự động mà vẫn nắm quyền duyệt từng thư, Sellbird là một lựa chọn đáng cài thử.
Câu hỏi thường gặp
Sellbird có miễn phí không?
Bản mã nguồn mở là miễn phí, giấy phép AGPL-3.0. 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 nêu khoảng 7 USD một tháng cho Google Workspace). Nguồn tìm doanh nghiệp mặc định là 0 đồng, 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. 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 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ư xác minh email có biến API key riêng trong file .env.example.
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 Code hoặc Codex trên gói thuê bao của bạn, không chạy mô hình trên máy bạn.
Chạy được trên Windows không?
README viết hướng dẫn cài theo kiểu macOS/Linux và nói Docker chạy được trên Linux. Bảng thư mục dữ liệu có ghi đường dẫn cho Windows, nhưng README không nêu rõ các bước cài trọn gói trên Windows. Bạn xem tài liệu Docker và Troubleshooting trong thư mục docs/ của 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 nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật autopilot. Lệnh sellbird sending pause dừng toàn bộ 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 riêng. Dashboard mở ở địa chỉ 127.0.0.1 với link riêng. Tư liệu không nói chi tiết hơn về bảo mật, và bạn vẫn nên giữ kín file .env. Repo có tệp SECURITY.md cho việc báo lỗi bảo mật.
Sellbird khác gì Harvey?
Đó là cùng một dự án. Harvey được đổi tên thành Sellbird từ bản 0.4.0, giữ nguyên lịch sử. Cấu hình, dữ liệu và đăng nhập dashboard của bạn được chuyển sang tự động, README có hướng dẫn nâng cấp riêng.


