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

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

12 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 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 là nền tảng outreach mã nguồn mở viết bằng Python. Nó tìm doanh nghiệp phù hợp, tìm người quyết định, kiểm tra email, viết và gửi cold email rồi xử lý thư trả lời. Nó dùng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có nên không phải trả tiền API. Cài bằng vài lệnh, nhưng 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ở để làm outreach (gửi email chào hàng lạnh, hay cold email) gần như từ đầu đến cuối. Nó tìm những 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 cho mỗi người một email riêng, gửi đi và xử lý thư trả lời. Repo này trước đây tên Harvey, nay đổi tên thành Sellbird và hiện có khoảng 5.249 sao cùng 1.127 fork.

Bạn nên xem qua nếu đang bán dịch vụ cho doanh nghiệp nhỏ (tiệm nha khoa, thợ sửa mái, cửa hàng điều hoà, hay những ngành tương tự). Bạn cũng nên xem nếu là lập trình viên muốn có sẵn một dây chuyền tìm khách mà mình kiểm soát được. Mọi thứ chạy trên máy của bạn, và mặc định không có email nào được gửi đi nếu bạn chưa duyệt.

Điểm đáng giá nhất là chuyện chi phí. Sellbird không dùng 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, nên không bị tính tiền theo token. Bạn có thể xem video ngắn bên dưới để thấy tổng quan trước khi cài.

Ứng dụng

ethanplusai/sellbird

Sellbird tìm công ty và người quyết định, kiểm tra email, viết cold email cá nhân hoá, gửi đi và xử lý thư trả lời — chạy bằng gói Claude hoặc ChatGPT của bạn.

★ 5.2kPythonAGPL-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 có thể chạy hết, hoặc dừng ở bất kỳ bước nào.

  • 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í. 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ị tính tiền bất ngờ.
  • Tìm lý do họ sẽ mua. Nó đọc website của từng công ty để tìm những 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 AI nên không tốn gì.
  • Tìm người quyết định. Nó tìm chủ hoặc quản lý được nêu 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.
  • Kiểm tra email. Nó suy ra mẫu email của công ty và 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 bớt thư bị trả lại, vốn làm hỏng 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. Sau đó nó 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 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. Những gì không nên tự trả lời, nó chuyển cho bạn.

Nếu bạn chỉ cần danh sách khách, hãy dừng sau bước kiểm tra email và chạy sellbird export. Lệnh này cho ra file CSV sẵn sàng đưa vào công cụ gửi mail hàng loạt.

Về an toàn, mọi email gửi đi đều nằm trong mục Outbox chờ bạn duyệt, cho đến khi chính bạn 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 AI. Bước này chặn những email còn sót thẻ điền thông tin chưa thay, chứa cụm từ bị cấm, quá dài, có thêm link, hoặc gửi tới đị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 yêu cầu Python >=3.11. README lưu ý macOS đi kèm Python 3.9, nên nếu python3 --version báo 3.9 thì chạy brew install python@3.13 trước.
  • Claude Pro hoặc Max với CLI đã đăng nhập (claude login), hoặc gói ChatGPT có Codex CLI. Cách thiết lập Codex nằm trong tài liệu của repo.
  • 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ư đó. Tác giả gợi ý TrulyInbox. Sellbird đọc được tỷ lệ vào hộp thư đến của công cụ này để báo khi nào bạn đã sẵn sàng gửi. Đây là liên kết affiliate của người bảo trì, và bạn không bắt buộc phải dùng.

Về chi phí, README nêu: tìm doanh nghiệp là 0 đồng ở 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. Repo này không dùng Apollo, ZoomInfo, Clearbit hay Clay.

File .env.example liệt kê nhiều biến tuỳ chọn như khoá cho dịch vụ xác minh email (Reoon, ZeroBounce, Hunter), Instantly, Cloudflare và DataForSEO. Bạn không cần điền hết. Chỉ điền những gì bạn thực sự dùng.

Về hệ điều hành, README ví dụ bằng lệnh macOS/Linux và nói Docker dùng được trên Linux. Thư mục dữ liệu trên Windows nằm ở %APPDATA%\sellbird. Phần cài đặt của README chưa có lệnh riêng cho Windows, bạn xem thêm mục Troubleshooting và Docker trong thư mục docs/.

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

  1. Tải mã nguồnClone repo về máy và vào thư mục dự án
  2. Tạo môi trường và càiTạo môi trường ảo Python 3.13 rồi cài gói sellbird
  3. Điền thông tin đăng nhậpSao chép .env.example thành .env và điền
  4. Dạy Sellbird về sản phẩmChạy sellbird train với website của bạn
  5. Chọn tín hiệu và tìm kháchXác nhận signals rồi chạy sellbird discover
  6. Mở dashboard và chạy vòng lặpChạy sellbird dashboard và sellbird run

README có hai cách: nhờ Claude cài giúp, hoặc tự gõ lệnh. Người mới nên thử cách đầu.

A.Tải mã nguồn (và cách để Claude cài giúp)

Mở terminal (trên macOS là Terminal, trên Linux là cửa sổ dòng lệnh), rồi chạy:

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

git clone tải mã nguồn về, cd sellbird đi vào thư mục vừa tải, còn claude mở Claude Code ngay trong thư mục đó. Sau đó bạn gõ "set up Sellbird for me". File CLAUDE.md của repo biến Claude Code thành người hướng dẫn cài đặt. Nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi thứ nó cần và dạy Sellbird về sản phẩm của bạn. Nếu dùng cách này, bạn có thể bỏ qua các bước còn lại bên dưới.

Lưu ý: lệnh claude chỉ chạy được khi bạn đã cài Claude Code CLI và đăng nhập bằng claude login.

B.Tạo môi trường ảo và cài Sellbird

Nếu muốn tự làm, vẫn đứng trong thư mục sellbird, 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 (một "hộp" riêng để gói Python không lẫn với máy), kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Chỗ người mới hay vấp là dùng python3 thay vì python3.13, vì trên macOS python3 trần có thể chỉ là bản 3.9 quá cũ. Lệnh source là của macOS/Linux. README chưa ghi lệnh kích hoạt cho Windows.

C.Điền thông tin đăng nhập vào .env

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ở nó để bạn sửa. Mỗi biến đều có chú thích ngay trong file. Bạn điền thông tin hộp thư gửi (Gmail, Microsoft 365 hoặc SMTP) và các khoá dịch vụ bạn dùng. Đừng đăng file .env lên bất kỳ đâu công khai.

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 địa chỉ bằng website công ty bạn. Sellbird đọc trang đó để hiểu bạn bán gì rồi ghi vào file sellbird.local.yaml. File này nằm ngoài phần git theo dõi nên cập nhật sau này sẽ không đè lên.

E.Chọn tín hiệu và tìm khách

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

Bước 4 xác nhận những dấu hiệu cho thấy một công ty là khách tốt. Bước 5 tìm doanh nghiệp, mặc định bằng nguồn miễn phí không cần tài khoản.

F.Mở dashboard và bật vòng lặp

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ới địa chỉ 127.0.0.1:5555, tức chỉ mở được trên máy bạn. sellbird run khởi động vòng lặp chính. Nó kiểm tra tình trạng, viết chiến dịch cho khách mới và đưa email vào Outbox chờ bạn duyệt.

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

Có ba dấu hiệu theo README:

  • python3.13 --version (hoặc python3 --version) cho ra 3.11 trở lên.
  • sellbird dashboard in ra đường link riêng, và mở được trang tại 127.0.0.1:5555.
  • sellbird run in dòng "Sellbird is online.", rồi báo từng bước như viết chiến dịch, xử lý thư trả lời, và số email đang chờ bạn duyệt, kết thúc bằng "Cycle complete" rồi nghỉ 15 phút trước vòng sau.

README còn nói dữ liệu demo là bịa (công ty "Bookwell" bán đặt lịch online, dùng tên miền .test). Đừng bất ngờ nếu thấy tên lạ khi xem ví dụ.

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

A.Chủ công ty phần mềm: chỉ lấy danh sách khách để gửi bằng công cụ khác

Bạn bán phần mềm đặt lịch cho phòng khám nha khoa và đã có công cụ gửi mail hàng loạt. Bạn chỉ cần danh sách sạch. Chạy sellbird train với website của bạn, sellbird signals --confirm free, rồi sellbird discover. Khi dữ liệu đã qua bước kiểm tra email, chạy:

Terminal
sellbird export

Kết quả là file CSV chứa những gì Sellbird tìm được, sẵn sàng nhập vào công cụ gửi mail. Bạn dùng Sellbird như máy tìm khách và kiểm tra email, không cần cho nó gửi gì.

Cold email tốt bắt đầu từ danh sách đúng người, không phải từ nút gửi.

Ông T

B.Người làm kinh doanh: chạy cả dây chuyền nhưng tự duyệt từng thư

Bạn quản lý kinh doanh cho một dịch vụ cho doanh nghiệp nhỏ. Bạn cài Sellbird, nối hộp thư Google Workspace đã warmup, rồi chạy sellbird run. Mỗi vòng, nó tìm khách mới, viết chuỗi 2 email dựa trên tín hiệu như "đang tuyển nhân viên điều phối". Các email nằm trong Outbox. Bạn mở dashboard, đọc từng thư, sửa nếu cần rồi duyệt. Khi thấy chất lượng ổn định, bạn mới cân nhắc bật autopilot. 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.

C.Nhân viên văn phòng: xử lý thư trả lời mà không bỏ sót

Sau vài ngày gửi, hộp thư có phản hồi lẫn lộn: người quan tâm, người phản đối, thư tự động báo vắng mặt, người xin ngừng nhận. Sellbird đọc tất cả, đặt thư tự động sang một bên, ghi nhận ngay những người từ chối, và soạn sẵn câu trả lời cho người quan tâm hoặc phản đối. Bạn vào dashboard xem những thư đã soạn. Với thứ nó không nên tự đáp, nó chuyển cho bạn quyết định.

D.Lập trình viên: nâng cấp từ Harvey và dừng khẩn cấp

Nếu bạn đang chạy Harvey, README nói cấu hình, dữ liệu và đăng nhập dashboard được giữ nguyên:

Terminal
git pull
pip install -e .        # once, to get the new `sellbird` command
sellbird dashboard

Lầ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. Nếu thấy có gì bất thường khi đang gửi, một lệnh dừng mọi thứ ngay:

Terminal
sellbird sending pause

Cold email có luật riêng và rủi ro về uy tín tên miền. README có hẳn tài liệu Legal and deliverability trong docs/. Hãy đọc trước khi gửi thật, dùng tên miền gửi riêng và để Outbox ở chế độ duyệt tay cho đến khi bạn tin chất lượng thư. Không chia sẻ file .env.

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

  • Báo Python quá cũ hoặc cài không được. Thường do dùng python3 trần trên macOS, vốn là bản 3.9. Hãy cài brew install python@3.13 rồi chạy lại bằng python3.13 như README hướng dẫn.
  • Không có lệnh sellbird sau khi cài. Có thể bạn chưa kích hoạt môi trường ảo .venv, hoặc chưa chạy pip install -e . trong thư mục repo. Kích hoạt lại môi trường rồi cài lại. Khi nâng cấp từ Harvey, README cũng dặn chạy pip install -e . một lần để có lệnh mới.
  • Chạy được nhưng không thấy email nào đi. Đây là hành vi mặc định, không phải lỗi. Email chờ trong Outbox cho tới khi bạn duyệt, hoặc bạn tự bật autopilot. Trước hết hãy mở dashboard và kiểm tra Outbox.
  • git pull báo "your local changes would be overwritten". Xảy ra khi 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. Về lâu dài, hãy đặt cấu hình riêng vào sellbird.local.yaml để git không đụng tới.
  • Sellbird chưa đổi tên file dữ liệu sau khi nâng cấp. README nói nó sẽ chờ nếu tiến trình Harvey cũ vẫn đang chạy trong thư mục. Hãy tắt tiến trình đó trước rồi chạy lại.

Nếu gặp lỗi khác, README trỏ tới tài liệu Troubleshooting trong thư mục docs/.

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

Điểm mạnh. Chạy trên máy bạn, dùng gói AI bạn đã trả tiền nên không có hoá đơn API theo token. Dây chuyền đầy đủ, từ tìm khách đến xử lý thư trả lời. Mặc định không gửi gì nếu bạn chưa duyệt, và có bước kiểm tra trước khi gửi không dùng AI. Bạn cũng có thể dùng từng phần, như chỉ xuất danh sách. Giấy phép AGPL-3.0, repo còn được cập nhật trong ba tháng gần đây.

Giới hạn. Bạn phải tự lo hộp thư gửi, tên miền riêng và warmup, vì cold email không chỉ là chuyện phần mềm. README nhắm tới người dùng macOS/Linux, phần Windows chưa rõ. Nguồn tìm doanh nghiệp miễn phí là OpenStreetMap nên độ phủ phụ thuộc vào dữ liệu ở đó, và tôi chưa thấy tư liệu nào nói rõ độ phủ ở Việt Nam. Giấy phép AGPL cũng đáng đọc kỹ nếu bạn định tích hợp 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ự cài và tự lo hộp thư, README có nhắc bản hosted tại sellbird.ai, hiện đang truy cập sớm, đã thiết lập sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ gửi vài thư thủ công mỗi tuần, cài cả dây chuyền này là hơi thừa.

4.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?

Phần mềm mã nguồn mở, giấy phép AGPL-3.0. Nguồn tìm doanh nghiệp mặc định miễn phí, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả theo README. 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 Google Workspace khoảng 7 USD một tháng).

Có cần API key của Claude hay OpenAI không?

Không. README nói Sellbird chạy qua Claude Code CLI trên gói Claude Pro/Max, hoặc qua Codex trên gói ChatGPT, nên không có API key và không tính tiền theo token. Nó cũng tự giảm tốc để chừa chỗ cho việc của bạn.

Có cần GPU hay máy mạnh không?

Tư liệu không nêu yêu cầu GPU hay phần cứng riêng. Phần xử lý AI đi qua Claude Code hoặc Codex, không chạy mô hình trên máy bạn. Yêu cầu được nêu là Python 3.11 trở lên.

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

README ghi thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt trong phần Quick start viết cho macOS/Linux, và Docker được nói là dùng trên Linux. README chưa ghi lệnh kích hoạt môi trường ảo cho Windows, bạn xem thêm tài liệu Troubleshooting và Docker trong thư mục docs/.

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

Không, mặc định mọi email chờ trong Outbox cho tới khi bạn duyệt, trừ khi chính bạn 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 việc ngay lập tức.

Dữ liệu của tôi nằm ở đâu, có an toàn không?

README nói cấu hình, kiến thức và dữ liệu nằm trong một thư mục home trên máy bạn, gồm cả cơ sở dữ liệu và log. Dashboard mở tại 127.0.0.1:5555 với link riêng. Tư liệu không nói thêm về các biện pháp bảo mật khác, vấn đề bảo mật xem SECURITY.md trong repo.

Khác gì Harvey? Tôi đang dùng Harvey thì sao?

Harvey chính là Sellbird sau khi đổi tên từ bản 0.4.0, cùng dự án và cùng lịch sử. Cấu hình, dữ liệu và đăng nhập dashboard được mang sang; làm theo mục Upgrading from Harvey: git pull, pip install -e ., rồi sellbird dashboard.

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.Tải mã nguồn (và cách để Claude cài giúp)
    2. B.Tạo môi trường ảo và cài Sellbird
    3. C.Điền thông tin đăng nhập vào .env
    4. D.Dạy Sellbird về sản phẩm của bạn
    5. E.Chọn tín hiệu và tìm khách
    6. F.Mở dashboard và bật vòng lặp
  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 phần mềm: chỉ lấy danh sách khách để gửi bằng công cụ khác
    2. B.Người làm kinh doanh: chạy cả dây chuyền nhưng tự duyệt từng thư
    3. C.Nhân viên văn phòng: xử lý thư trả lời mà không bỏ sót
    4. D.Lập trình viên: nâng cấp từ Harvey và dừng khẩn cấp
  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ỏ.