Bỏ qua tới nội dung
Ông T.vn

Sellbird: tự tìm khách, viết và gửi cold email — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật

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 →

Sellbird: tự tìm khách, viết và gửi cold email — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Sellbird (trước đây tên Harvey) là ứng dụng Python mã nguồn mở giúp làm outreach: tìm công ty hợp với khách hàng của bạn, tìm người quyết định, kiểm tra email, viết thư cá nhân hoá rồi gửi và 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, và mặc định không có thư nào được gửi đi khi bạn chưa duyệt.

Sellbird là một nền tảng outreach mã nguồn mở chạy trên máy của bạn. 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 cho mỗi người một cold email riêng, gửi đi rồi xử lý thư trả lời. Dự án trước đây tên là Harvey, nay đổi thành Sellbird.

Bạn nên xem qua nếu bạn làm kinh doanh, bán dịch vụ cho doanh nghiệp nhỏ, hoặc là dev muốn tự dựng quy trình tìm khách thay vì trả tiền cho cả bộ công cụ prospecting. 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 dùng gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex) mà bạn đang trả, nên không có API key mô hình và không tính tiền theo token. Ngoài ra, mặc định không email nào rời máy bạn khi bạn chưa bấm duyệt. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi cài.

Ứng dụng

ethanplusai/sellbird

Sellbird là nền tảng mã nguồn mở chạy trên gói Claude hoặc ChatGPT của bạn: tìm công ty, kiểm tra email, viết cold email, gửi và xử lý phản hồi.

★ 5.3kPythonAGPL-3.0
Xem repo trên GitHub
Video giới thiệu sellbirdXem trên YouTubeXem trên Facebook

I.Sellbird làm được gì

Sellbird là một dây chuyền nhiều bước. Bạn chạy trọn vẹn hoặc dừng ở bước nào cũng được.

  • 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. Bạn không bị trừ tiền bất ngờ.
  • Hiểu vì sao họ sẽ mua. Sellbird đọ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 gì.
  • Tìm người quyết định. Tìm chủ hoặc quản lý được nêu trên chính trang của công ty, tối đa hai người mỗi công ty. Bạn không bị lan man gửi cho cả phòng ban.
  • Kiểm tra địa chỉ email. Nó học cách đặt 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 hạn chế thư bật lại.
  • Viết và gửi. Viết một chuỗi email ngắn cho từng người dựa trên điều đã tìm được. Thư 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. Đọc mọi 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 hủy nhận 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, hãy dừng sau bước kiểm tra email và chạy sellbird export để có file CSV dùng được ngay cho công cụ gửi thư khác.

Về an toàn, mỗi email gửi đi phả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 bước kiểm tra không dùng mô hình, chặn 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.

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 có sẵn bản 3.9, nên nếu python3 --version báo 3.9 thì chạy brew install python@3.13 trước.
  • Gói Claude Pro hoặc Max đã đăng nhập Claude CLI bằng claude login, hoặc gói ChatGPT có Codex CLI. Hướng dẫn Codex nằm trong thư mục docs của repo.
  • Một hộp thư để gửi đ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.
  • Warmup cho hộp thư đó. README gợi ý TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Lưu ý đây là link affiliate của tác giả. Bạn không bắt buộc phải dùng, nhưng hộp thư mới chưa warmup thường dễ bị vào spam.

Về chi phí, README nói 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. README không nói gì về yêu cầu GPU hay RAM.

File .env.example liệt kê nhiều biến cấu hình tuỳ chọn cho từng nhà cung cấp (Gmail, SMTP, IMAP, Microsoft 365, các dịch vụ kiểm tra email như Reoon, ZeroBounce, Hunter…). Bạn chỉ điền những gì mình thực sự dùng.

III.Cài đặt từng bước

  1. Lấy mã nguồnTải repo về máy bằng git clone
  2. Cài đặtTạo môi trường ảo Python và cài gói sellbird
  3. Điền thông tinSao chép .env.example thành .env rồi điền
  4. Dạy Sellbird về sản phẩmChạy sellbird train với website của bạn
  5. Tìm kháchXác nhận tín hiệu rồi chạy sellbird discover
  6. ChạyMở dashboard và khởi động vòng lặp

Có hai cách: nhờ Claude cài giúp (dễ nhất) hoặc tự gõ lệnh.

A.Cách dễ: để Claude cài cho bạn

Mở terminal (trên Windows là PowerShell hoặc Git Bash, trên macOS là Terminal) rồi chạy:

Terminal
git clone https://github.com/ethanplusai/sellbird.git
cd sellbird
claude

Lệnh đầu tải repo về, 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 đó. Sau đó 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à huấn luyện 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 sẽ không thấy file hướng dẫn.

B.Cách thủ công: tạo môi trường và cài gói

Sau khi đã git clone và cd sellbird như trên, chạy:

Terminal
# 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, kích hoạt nó rồi cài Sellbird ở chế độ chỉnh sửa được. Sau khi cài xong bạn có lệnh sellbird. Lưu ý: dòng source .venv/bin/activate là cú pháp macOS/Linux. README chưa ghi cách kích hoạt môi trường ảo trên Windows, nên nếu dùng Windows bạn có thể chạy trong WSL hoặc Git Bash, hoặc xem thêm tài liệu trong thư mục docs/ của repo.

C.Điền thông tin đăng nhập

Terminal
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .env

Lệnh sao chép file mẫu thành .env rồi mở bằng trình soạn thảo của bạn. Mỗi biến đều có chú thích ngay trong file. Bạn chỉ cần điền phần hộp thư gửi đi (ví dụ SMTP_* hoặc GMAIL_*) và các dịch vụ bạn thật sự dùng. Đừng chia sẻ file .env cho ai.

D.Dạy Sellbird về sản phẩm của bạn

Terminal
# 3. Learn your product from your website (writes sellbird.local.yaml).
sellbird train https://your-company.com

Thay https://your-company.com bằng website công ty bạn. Sellbird đọc trang web để hiểu bạn bán gì, rồi ghi kết quả vào sellbird.local.yaml. Đây là file riêng của bạn, git không đụng tới khi bạn cập nhật.

E.Xác nhận tín hiệu và tìm doanh nghiệp

Terminal
# 4. Confirm what makes a good prospect.
sellbird signals --confirm free

# 5. Find businesses. The default source is free and needs no account.
sellbird discover

Lệnh signals xác nhận những dấu hiệu cho thấy một công ty là khách tiềm năng tốt. Lệnh 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

Terminal
# 6. Open the dashboard and start the loop.
sellbird dashboard          # prints a private link to http://127.0.0.1:5555
sellbird run

sellbird dashboard in ra một đường link riêng tư tới địa chỉ trên máy bạn (http://127.0.0.1:5555). sellbird run khởi động vòng lặp chính. Mỗi chu kỳ nó kiểm tra trạng thái, viết thư, xử lý thư trả lời rồi nghỉ 15 phút. Nếu cần chạy cả hai, mở hai cửa sổ terminal.

Trên Linux bạn còn có thể chạy bằng Docker. Repo có Dockerfile và docker-compose.yml; chi tiết xem tài liệu Docker trong docs/.

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, warmup hộp thư trước, và giữ chế độ duyệt tay (mặc định) cho tới khi bạn tin vào chất lượng thư. Đọc phần Legal and deliverability trong docs/ để biết quy định gửi cold email ở nơi bạn gửi tới.

IV.Kiểm tra đã chạy được chưa

Cách đơn giản nhất là chạy sellbird run. Theo README, bạn sẽ thấy dòng thông báo Sellbird is online, sau đó là phần kiểm tra trạng thái và một quyết định như write_campaign. Tiếp theo nó liệt kê các việc đã làm (handler trả lời thư, writer viết chuỗi email) và cuối cùng là dòng cho biết có bao nhiêu email đang chờ bạn duyệt, rồi báo Cycle complete và nghỉ 15 phút.

Bạn cũng nên mở đường link mà sellbird dashboard in ra. Nếu trang dashboard hiện lên và có hộp Outbox, nghĩa là phần cài đặt đã ổn. README có kèm 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ều hoà) trên tên miền .test để bạn xem thử mà không gửi cho ai thật.

V.Dùng vào việc thật

A.Chủ công ty dịch vụ chỉ cần danh sách khách

Bạn bán phần mềm đặt lịch và chưa muốn gửi email tự động. Sau khi train và signals, bạn chạy sellbird discover, để Sellbird tìm công ty, đọc website, tìm người quyết định và kiểm tra email. Rồi dừng ở đó và chạy:

Terminal
sellbird export

Kết quả là file CSV sẵn sàng đưa vào công cụ gửi thư bạn đang dùng, trong đó mỗi địa chỉ có nhãn verified, risky, guess hoặc invalid để bạn lọc.

Chỉ cần danh sách thì dừng sau bước kiểm tra email: không tốn công cụ prospecting nào.

Ông T

B.Nhân viên sales duyệt từng thư trước khi gửi

Bạn muốn tự động hoá nhưng vẫn kiểm soát. Bạn chạy sellbird dashboard và sellbird run. Sellbird viết chuỗi email (ví dụ 2 email nhắc việc công ty đang tuyển điều phối viên), đưa vào Outbox. Bạn mở dashboard, đọc từng thư, sửa nếu cần rồi duyệt. Kết quả: thư vẫn được cá nhân hoá theo từng công ty nhưng bạn là người quyết định cuối cùng.

C.Dev hoặc người làm vận hành muốn dừng khẩn cấp

Bạn thấy một thư viết chưa ổn hoặc hộp thư có dấu hiệu bị đánh spam. Bạn chạy:

Terminal
sellbird sending pause

Lệnh này dừng mọi hoạt động gửi cùng lúc. Bạn sửa prompt hoặc kỹ năng viết thư trong thư mục prompts/ và skills/ (README nói các file này bạn được phép chỉnh), rồi mới cho chạy lại.

D.Người đang dùng Harvey cũ

Nếu bạn đã chạy Harvey, README nói cấu hình, dữ liệu và đăng nhập dashboard được giữ nguyên. Bạn chạy git pull, pip install -e . một lần để có lệnh sellbird mới, rồi sellbird dashboard. Ở lần chạy đầu, Sellbird tự đổi tên các file harvey.local.yaml và data/harvey.db sang tên mới. Nếu bạn từng sửa trực tiếp harvey.yaml, README hướng dẫn dùng git stash, git pull, git stash pop và nên chuyển các thiết lập sang sellbird.local.yaml.

VI.Lỗi hay gặp và cách xử lý

  • python3 --version báo 3.9 trên macOS. Đây là lỗi README đã cảnh báo. Cài bản mới bằng brew install python@3.13 và dùng python3.13 thay vì python3 khi tạo môi trường ảo.
  • Không thấy lệnh sellbird. Thường do môi trường ảo chưa được kích hoạt hoặc chưa chạy pip install -e .. Kích hoạt lại .venv rồi cài lại. Trên Windows, README chưa ghi cách kích hoạt môi trường ảo, nên xem thêm trong docs/.
  • Claude hoặc Codex chưa đăng nhập. Sellbird dựa vào CLI đã đăng nhập, nên chạy claude login trước (hoặc làm theo hướng dẫn Codex trong docs). Đừng tìm chỗ nhập API key mô hình vì README nói không cần.
  • git pull báo “your local changes would be overwritten” khi nâng cấp từ Harvey. Làm theo README: git stash, git pull, git stash pop. Nếu có xung đột trong sellbird.yaml, giữ phần của bạn, xoá dấu xung đột, rồi chạy git stash drop.
  • Email bị bật lại hoặc vào spam. Đây là rủi ro chung của cold email. Hãy warmup hộp thư, dùng tên miền gửi riêng, chỉ gửi tới địa chỉ verified và đọc phần Troubleshooting cùng Legal and deliverability trong docs/.

VII.Có nên dùng không

Điểm mạnh. Không cần API key mô hình, dùng luôn gói bạn đã có. Nguồn tìm khách mặc định miễn phí. Có bước duyệt tay mặc định và kiểm tra trước khi gửi. Dữ liệu chạy trên máy của bạn. Mã nguồn mở, có thể chỉnh prompt và kỹ năng bán hàng.

Giới hạn. Bạn phải quen terminal ở mức cơ bản. Cách cài trong README viết cho macOS/Linux, người dùng Windows nên chuẩn bị thêm. Bạn vẫn cần một hộp thư gửi, nên có thêm chi phí và công warmup. Giấy phép AGPL-3.0 có điều kiện riêng nếu bạn muốn sửa rồi cung cấp thành dịch vụ cho người khác. Ngoài ra, cold email có quy định pháp lý và rủi ro với danh tiếng tên miền, nên bạn cần tự chịu trách nhiệm.

Khi 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 trong giai đoạn early access, theo README). Nếu chỉ cần gửi thư hàng loạt đơn giản, một công cụ email marketing quen thuộc có thể đủ dùng hơn.

5.0/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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. Tuy nhiên bạn cần gói Claude Pro/Max hoặc ChatGPT có Codex, và một hộp thư gửi (README nhắc Google Workspace khoảng 7 USD một tháng). 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. Theo README, Sellbird dùng Claude Code CLI trên gói Claude Pro/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ụ phụ như kiểm tra email có thể dùng key riêng, được liệt kê trong file .env.example.

Có cần GPU không?

README không nói gì về yêu cầu GPU hay cấu hình phần cứng. Vì phần suy nghĩ chạy qua Claude hoặc Codex, có vẻ máy bạn không phải tự chạy mô hình, nhưng tư liệu chưa xác nhận điều này rõ ràng.

Chạy được trên Windows không?

README có nêu thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt được viết cho macOS/Linux và Docker được nhắc cho Linux. Chưa có hướng dẫn riêng cho Windows trong README, bạn nên xem thêm thư mục docs của repo.

Sellbird có tự gửi email mà tôi không biết không?

Không, mặc định mọi email nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật autopilot. Có thêm bước kiểm tra trước khi gửi, và lệnh sellbird sending pause dừng mọi hoạt động gửi ngay lập tức.

Dữ liệu của tôi có an toàn không?

README nói Sellbird chạy trên máy của bạn, cấu hình, dữ liệu và cơ sở dữ liệu nằm trong thư mục home của bạn. Dashboard mở tại địa chỉ trên máy và dùng link riêng tư. Tuy vậy việc suy nghĩ vẫn đi qua Claude hoặc Codex, và README không nói chi tiết về chính sách dữ liệu của các nhà cung cấp này.

Sellbird khác Harvey thế nào?

Đây là cùng một dự án, chỉ đổi tên từ Harvey thành Sellbird từ bản 0.4.0, giữ nguyên lịch sử. Cấu hình và dữ liệu cũ được chuyển sang tên mới ở lần chạy đầu. Lệnh harvey cũ vẫn chạy tạm thời nhưng sẽ bị gỡ ở bản sau.

Chuyển nhanh tới mục

  1. I.Sellbird làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cách dễ: để Claude cài cho bạn
    2. B.Cách thủ công: tạo môi trường và cài gói
    3. C.Điền thông tin đăng nhập
    4. D.Dạy Sellbird về sản phẩm của bạn
    5. E.Xác nhận tín hiệu và tìm doanh nghiệp
    6. F.Mở dashboard và chạy
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ công ty dịch vụ chỉ cần danh sách khách
    2. B.Nhân viên sales duyệt từng thư trước khi gửi
    3. C.Dev hoặc người làm vận hành muốn dừng khẩn cấp
    4. D.Người đang dùng Harvey cũ
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.