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

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, 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 là Harvey) là nền tảng outreach mã nguồn mở viết bằng Python. Nó tìm công ty 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, dùng gói Claude hoặc ChatGPT bạn đang có. Cài bằng vài lệnh, nhưng cần hộp thư gửi riêng và nên khởi động (warmup) hộp thư trước khi gửi.

Sellbird là một nền tảng outreach mã nguồn mở chạy ngay trên máy bạn. Nó làm trọn chuỗi việc của người đi chào hàng qua email: tìm công ty cần thứ bạn bán, tìm người ra quyết định, kiểm tra địa chỉ email, viết thư cá nhân hoá, gửi đi và xử lý thư trả lời. Dự án trước đây tên Harvey, nay đổi tên thành Sellbird, vẫn giữ nguyên lịch sử.

Người nên xem là chủ doanh nghiệp nhỏ, người làm sales, người làm dịch vụ B2B (bán cho doanh nghiệp), hoặc lập trình viên muốn tự động hoá khâu tìm khách. Điểm đáng giá nhất: Sellbird không dùng API tính tiền theo token. Nó "suy nghĩ" qua Claude Code CLI trên gói Claude Pro/Max, hoặc qua Codex trên gói ChatGPT. Bạn dùng gói đã trả, không phát sinh hoá đơn model. Hiện repo có khoảng 5.250 sao và 1.127 fork.

Điểm đáng giá thứ hai là tính an toàn: theo mặc định, không có email nào rời máy bạn nếu bạn chưa duyệt. Xem video ngắn bên dưới để thấy cách nó chạy, rồi quay lại đây làm theo từng bước.

Ứng dụng

ethanplusai/sellbird

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 cold email cá nhân hoá, 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. Bạn chạy trọn chuỗi, 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. Đọc chính 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, hoặc đang tuyển một vị trí nào đó. Bước này không gọi model, không tốn tiền. Mỗi công ty chỉ tốn ba yêu cầu HTTP.
  • Tìm người quyết định. Tìm chủ hoặc quản lý được nêu tên trên trang của công ty, tối đa hai người mỗi công ty.
  • Kiểm tra địa chỉ. Học quy luậ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. Chỉ địa chỉ gửi được mới được gửi thư. Việc này giúp bạn tránh thư trả về và giữ uy tín tên miền gửi.
  • Viết và gửi. Viết một chuỗi email ngắn cho từng người dựa trên những gì đã tìm thấy. Thư gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn mỗi ngày và theo giờ làm việc của người nhận.
  • Xử lý phản hồi. Đọc mọi thư trả lời, soạn sẵn câu đáp, để riêng các thư tự động trả lời, tôn trọng yêu cầu từ chối nhận ngay lập tức. Những thứ nó không nên tự trả lời thì 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ấy file CSV đưa vào công cụ gửi thư khác.

Về an toàn, mọi email gửi đi nằm chờ trong Outbox cho bạn duyệt, cho đến khi bạn tự bật chế độ autopilot. Trước khi gửi còn có một lượt kiểm tra không dùng model: chặn 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. Ngay cả khi bật autopilot, email có link sang tên miền không phải của bạn vẫn bị giữ lại.

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 >=3.11). README lưu ý macOS có sẵn Python 3.9, nên nếu python3 --version báo 3.9 thì cài thêm bản mới bằng brew install python@3.13.
  • Claude Pro hoặc Max và đã đăng nhập Claude Code CLI bằng claude login. Hoặc gói ChatGPT có Codex CLI (README 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 cho hộp thư đó. Tác giả gợi ý TrulyInbox để khởi động hộp thư mới trước khi gửi cold email. Lưu ý link TrulyInbox trong dự án là link affiliate. Đây chỉ là gợi ý, bạn tự cân nhắc.

Về chi phí, README nêu: tìm doanh nghiệp là 0 đồng với nguồn mặc định, hoặc khoảng 0,37 đô la cho 1.000 kết quả với nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Hộp thư Google Workspace khoảng 7 đô la mỗi tháng. Không cần Apollo, ZoomInfo, Clearbit hay Clay.

File .env.example liệt kê các biến cấu hình tuỳ chọn như khoá của các dịch vụ kiểm tra email (Reoon, ZeroBounce, Hunter) hay thông tin Gmail, SMTP, IMAP, Microsoft 365. Bạn chỉ cần điền phần mình dùng. Mỗi biến đều có giải thích ngay trong file.

README chỉ nêu cách cài chi tiết cho macOS và Linux (có hỗ trợ Docker trên Linux). Với Windows, README chỉ cho biết thư mục dữ liệu nằm ở %APPDATA%\sellbird. Lệnh kích hoạt môi trường ảo trong README viết cho macOS/Linux, nên người dùng Windows hãy xem thêm tài liệu trong thư mục docs/ của repo.

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

  1. Chuẩn bịCó Python 3.11+, Claude Code CLI đã đăng nhập, một hộp thư gửi
  2. Tải mã nguồngit clone repo rồi cd vào thư mục
  3. Cài góiTạo môi trường ảo và pip install -e .
  4. Điền thông tinSao chép .env.example thành .env rồi sửa
  5. Dạy SellbirdChạy sellbird train với website của bạn
  6. Tìm khách và chạydiscover, mở dashboard, rồi run

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

A.Để Claude Code dẫn bạn cài

Mở terminal (macOS: Terminal; Windows: PowerShell hoặc Git Bash), gõ ba lệnh sau. Lệnh đầu tải mã nguồn về máy, lệnh thứ hai vào thư mục vừa tải, lệnh thứ ba mở Claude Code ngay trong thư mục đó.

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

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 cài đặt: nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi những thứ cần hỏi và huấn luyện Sellbird về sản phẩm của bạn. Chỗ dễ vấp: phải đứng trong thư mục sellbird rồi mới gõ claude, nếu không Claude không đọc được CLAUDE.md.

B.Tự cài bằng tay: tạo môi trường và cài gói

Nếu bạn muốn tự làm, vẫn tải mã nguồn như trên. Sau đó chạy lệnh dưới đây trong thư mục sellbird.

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ột môi trường ảo tên .venv (không làm rối Python của máy), kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được để có lệnh sellbird. Chỗ hay vấp: trên macOS hãy gõ python3.13 chứ không phải python3, vì python3 có thể là bản 3.9 quá cũ.

C.Điền thông tin truy cập

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

Lệ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. Điền thông tin hộp thư gửi và khoá của dịch vụ bạn dùng. Phần nào bạn chưa dùng thì để nguyên.

.env chứa mật khẩu và khoá truy cập. Đừng gửi file này cho ai, đừng đưa lên GitHub hay dán vào nhóm chat. Nên dùng một hộp thư riêng trên tên miền gửi riêng, không dùng hộp thư công ty chính.

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

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

Lệnh train đọc website của bạn để hiểu bạn bán gì, rồi ghi kết quả vào file sellbird.local.yaml. Hãy thay https://your-company.com bằng website thật của bạn. Lệnh signals --confirm free giúp bạn xác nhận những dấu hiệu nào cho thấy một công ty là khách tiềm năng tốt.

E.Tìm doanh nghiệp, mở bảng điều khiển và chạy

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

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

sellbird discover tìm doanh nghiệp từ nguồn miễn phí mặc định, không cần tài khoản. sellbird dashboard in ra một đường link riêng tới http://127.0.0.1:5555, tức bảng điều khiển chạy ngay trên máy bạn. sellbird run khởi động vòng lặp chính. Trên Linux bạn cũng có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, và README có trang Docker riêng.

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

Sau khi chạy sellbird run, bạn sẽ thấy màn hình như README minh hoạ: dòng "Sellbird is online", rồi dòng "Checking pipeline state...", một dòng "Decision" cho biết bước nó định làm, các dòng của handler (xử lý thư trả lời) và writer (viết thư), và cuối cùng "Cycle complete. Sleeping for 15 minutes." Một dòng như "outbox → 5 emails waiting for your approval" cho biết thư đang chờ bạn duyệt chứ chưa gửi.

Cách kiểm tra thứ hai: chạy sellbird dashboard, mở link nó in ra, và xem trong bảng điều khiển có danh sách doanh nghiệp tìm được và mục Outbox hay không. README cũng có dữ liệu mẫu giả (công ty "Bookwell" bán đặt lịch online cho thợ lợp mái, nha khoa, điện lạnh, trên tên miền .test) để bạn làm quen giao diện.

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

README mô tả Sellbird theo hướng một dây chuyền bạn kiểm soát. Dưới đây là vài tình huống bám đúng khả năng đó.

A.Chủ một đơn vị dịch vụ muốn tìm khách địa phương

Chị Hà có một công ty làm phần mềm đặt lịch cho tiệm làm đẹp và phòng khám nhỏ. Chị chạy sellbird train với website công ty, rồi sellbird signals --confirm free để xác nhận dấu hiệu khách tốt, ví dụ website chưa có đặt lịch online. Sau đó chị chạy sellbird discover để tìm doanh nghiệp từ nguồn miễn phí. Kết quả là danh sách công ty kèm lý do họ có thể cần sản phẩm, không tốn phí model.

Sellbird chỉ gửi thứ bạn đã duyệt, trừ khi bạn tự bật autopilot.

Ông T

B.Nhân viên sales chỉ cần danh sách để gửi bằng công cụ riêng

Anh Nam đã có công cụ gửi thư hàng loạt và không muốn Sellbird gửi thay. Anh chạy các bước tìm công ty, tìm người quyết định, kiểm tra email, rồi dùng:

Terminal
sellbird export

Lệnh này xuất file CSV các liên hệ đã tìm thấy, sẵn sàng đưa vào công cụ gửi thư. Mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid, nên anh có thể loại những địa chỉ không đáng tin trước khi gửi.

C.Chạy cả chuỗi với bước duyệt thủ công

Chị Lan muốn thử gửi thật nhưng không dám giao hẳn cho phần mềm. Chị chạy sellbird run và để nó viết các chuỗi email ngắn, mỗi chuỗi dựa trên điều tìm được về từng công ty (ví dụ công ty đang tuyển người điều phối). Chị mở bảng điều khiển bằng sellbird dashboard, đọc từng thư trong Outbox, sửa nếu cần rồi mới duyệt. Khi khách trả lời, Sellbird soạn sẵn câu đáp và chị là người bấm gửi.

D.Dừng khẩn cấp khi có chuyện lạ

Nếu bạn thấy kết quả không như ý, hoặc cần dừng mọi thứ ngay, chỉ cần chạy:

Terminal
sellbird sending pause

README nói lệnh này dừng toàn bộ việc gửi cùng lúc. Nên nhớ lệnh này, nhất là sau khi bạn bật autopilot.

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

Báo Python quá cũ hoặc cài lỗi ngay bước đầu. Trên macOS, python3 thường là bản 3.9, thấp hơn mức 3.11 repo yêu cầu. Cài bản mới bằng brew install python@3.13 rồi tạo môi trường ảo bằng python3.13 như README hướng dẫn.

Gõ sellbird báo không tìm thấy lệnh. Thường do bạn chưa kích hoạt môi trường ảo .venv trong cửa sổ terminal đó, hoặc chưa chạy pip install -e .. Mở lại terminal ở đúng thư mục sellbird, kích hoạt môi trường rồi thử lại.

Claude Code chưa đăng nhập. Sellbird dùng Claude Code CLI để "suy nghĩ". Nếu CLI chưa đăng nhập, nó không chạy được. Chạy claude login trước. Nếu bạn dùng ChatGPT thì xem hướng dẫn Codex trong tài liệu của repo.

Thư không gửi đi hoặc không thấy thư nào. Có hai nguyên nhân thường gặp. Thứ nhất, thư đang nằm trong Outbox chờ bạn duyệt, đây là hành vi mặc định. Thứ hai, thư bị chặn bởi bước kiểm tra trước khi gửi (địa chỉ không gửi được, thẻ merge chưa điền, quá dài, thừa link). Hãy mở bảng điều khiển để xem lý do thay vì tắt các lớp bảo vệ.

Lỗi khi nâng cấp từ Harvey. Nếu bạn từng sửa trực tiếp file harvey.yaml, git pull có thể báo "your local changes would be overwritten". README hướng dẫn: chạy git stash, git pull, rồi git stash pop. Nếu có xung đột thì giữ phần của bạn, xoá dấu xung đột, rồi git stash drop. Lần sau hãy đặt cấu hình riêng trong sellbird.local.yaml để git không đụng tới.

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

Điểm mạnh. Bạn dùng gói Claude hoặc ChatGPT đã có nên không có hoá đơn model riêng. Mã nguồn mở, chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Mặc định nó chờ bạn duyệt trước khi gửi, có lớp kiểm tra trước khi gửi và có lệnh dừng khẩn. Bạn có thể dừng ở bất kỳ bước nào, chẳng hạn chỉ lấy danh sách.

Giới hạn. Bạn phải tự lo hộp thư gửi, nên có tên miền riêng và warmup. Đây là phần tốn công và tốn tiền nhất, và nó quyết định thư có vào hộp thư chính hay vào spam. Các ví dụ trong README thiên về doanh nghiệp địa phương và thị trường nước ngoài. Tôi chưa thấy tư liệu nói về độ phủ dữ liệu doanh nghiệp Việt Nam trên nguồn miễn phí, nên bạn nên chạy thử sellbird discover để tự đánh giá. Hướng dẫn cài đặt trong README viết cho macOS và Linux, người dùng Windows có thể sẽ phải đọc thêm tài liệu.

Lưu ý pháp lý. Gửi cold email chịu quy định của từng nước. README có trang Legal and deliverability nói về luật và độ gửi tới được hộp thư. Hãy đọc trước khi gửi hàng loạt. Giấy phép là AGPL-3.0, nên nếu bạn định sửa đổi rồi cung cấp thành dịch vụ cho người khác, hãy đọc kỹ điều khoản.

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 chạy sẵn trên 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 gửi vài thư thủ công cho khách quen, một công cụ gửi thư thông thường là đủ.

4.6/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 là mã nguồn mở theo giấy phép AGPL-3.0 nên dùng được miễn phí. Nguồn tìm doanh nghiệp mặc định cũng miễn phí. Bạn vẫn cần gói Claude Pro/Max hoặc gói ChatGPT có Codex, cùng một hộp thư gửi (README nêu Google Workspace khoảng 7 đô la một tháng).

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

Không. README nói 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 model và không tính tiền theo token. Một số dịch vụ tuỳ chọn khác như kiểm tra email có biến khoá riêng trong file .env.example.

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

Tư liệu không nhắc tới yêu cầu GPU hay cấu hình máy. Việc suy nghĩ do Claude hoặc Codex thực hiện, còn Sellbird chạy bằng Python 3.11 trở lên.

Sellbird có tự gửi email mà tôi không biết 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. Ngay cả khi bật autopilot, email có link tới tên miền không phải của bạn vẫn bị giữ lại. Bạn có thể dừng mọi thứ bằng sellbird sending pause.

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

README viết hướng dẫn cho macOS và Linux (Linux có thêm Docker). Nó chỉ nhắc thư mục dữ liệu trên Windows là %APPDATA%\sellbird, còn lệnh cài đặt cho Windows thì README chưa ghi rõ. Bạn nên xem thư mục docs/ trong repo.

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

Sellbird chạy trên máy bạn, cấu hình, kiến thức và dữ liệu nằm trong một thư mục riêng, bảng điều khiển chạy tại địa chỉ 127.0.0.1 trên máy bạn. Tuy vậy việc suy nghĩ vẫn đi qua Claude hoặc Codex, nên bạn nên xem chính sách của các dịch vụ đó. File .env chứa mật khẩu, hãy giữ kín.

Tôi đang dùng Harvey thì có phải cài lại không?

Không. Harvey đã đổi tên thành Sellbird từ bản 0.4.0. Bạn chạy git pull, rồi pip install -e . một lần để có lệnh sellbird. Cấu hình, dữ liệu và đăng nhập bảng điều khiển được chuyển tự động. Lệnh harvey cũ vẫn chạy tạm thời nhưng sẽ bị bỏ ở 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.Để Claude Code dẫn bạn cài
    2. B.Tự cài bằng tay: tạo môi trường và cài gói
    3. C.Điền thông tin truy cập
    4. D.Dạy Sellbird về sản phẩm của bạn
    5. E.Tìm doanh nghiệp, mở bảng điều khiển 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ủ một đơn vị dịch vụ muốn tìm khách địa phương
    2. B.Nhân viên sales chỉ cần danh sách để gửi bằng công cụ riêng
    3. C.Chạy cả chuỗi với bước duyệt thủ công
    4. D.Dừng khẩn cấp khi có chuyện lạ
  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ỏ.