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

Sellbird: tự tìm khách, kiểm tra email, 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, kiểm tra email, 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à nền tảng outreach mã nguồn mở viết bằng Python, chạy trên máy của bạn. Nó tìm doanh nghiệp phù hợp, tìm người quyết định, xác minh email, viết cold email rồi gửi và soạn sẵn câu trả lời cho phản hồi. Cài không quá khó nếu bạn có Python 3.11 trở lên và gói Claude Pro/Max hoặc ChatGPT có Codex. Mặc định không email nào được gửi đi khi bạn chưa duyệt.

Sellbird là một nền tảng mã nguồn mở giúp bạn làm cold email từ đầu đến cuối: 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 thư riêng cho từng người, gửi đi và xử lý thư trả lời. Nó chạy ngay trên máy của bạn, viết bằng Python. Dự án trước đây tên là Harvey và hiện có khoảng 5.250 sao, 1.127 fork trên GitHub.

Ai nên dùng? Chủ doanh nghiệp nhỏ, nhân viên kinh doanh, người làm agency hoặc dev muốn tìm khách hàng mới nhưng không muốn trả tiền cho cả bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. README nói thẳng là Sellbird không dùng các công cụ đó.

Điểm đáng giá nhất là chuyện chi phí và quyền kiểm soát. Sellbird dùng "bộ não" AI thông qua gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex), nên không cần API key và không bị tính tiền theo token. Ngoài ra, theo mặc định, mọi email đều nằm chờ trong hộp Outbox cho đến khi bạn tự duyệt. 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

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 sau khi bạn duyệt 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 gồm nhiều bước. Bạn chạy trọn vòng, hoặc dừng ở bất kỳ bước nào.

  • 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ó 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ị "cháy túi" bất ngờ.
  • 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 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 AI nên không tốn phí. Mỗi công ty chỉ cần ba request HTTP.
  • Tìm người quyết định. Tìm chủ hoặc quản lý có 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. Bạn không bị ngập trong danh sách dài vô nghĩa.
  • Kiểm tra địa chỉ email. Sellbird học cách đặt 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. Chỉ địa chỉ gửi được mới được gửi thư. Điều này giúp giảm thư bị trả về và bảo vệ uy tín hộp thư của bạn.
  • 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 được, rồi gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn. Nó tuân theo giới hạn gửi mỗi ngày và 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 nháp câu đáp, tách riêng thư tự động, tôn trọng yêu cầu từ chối ngay lập tức, và chuyển cho bạn những thư mà nó không nên tự trả lời.

Nếu bạn chỉ cần danh sách khách hàng, hãy dừng sau bước xác minh rồi chạy sellbird export để lấy file CSV dùng được cho công cụ gửi email khác.

Ngoài ra còn một bảng điều khiển (dashboard) chạy ở máy bạn, và lệnh sellbird sending pause để dừng toàn bộ việc gửi ngay lập tứ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 đi kèm Python 3.9, nên nếu python3 --version báo 3.9 thì cài thêm bằng brew 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.
  • 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. README nhắc một mức giá tham khảo khoảng 7 USD mỗi tháng cho Google Workspace.
  • Warmup (làm nóng) hộp thư. README khuyên dùng TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Đây là liên kết affiliate, tác giả có thể nhận hoa hồng. Bạn không bắt buộc phải dùng.

Phần cứng đặc biệt thì tư liệu không yêu cầu. File .env.example còn liệt kê nhiều biến tuỳ chọn như khoá của Reoon, ZeroBounce, Hunter, Instantly, Cloudflare… Bạn chỉ cần điền những dịch vụ mình thật sự dùng.

Về hệ điều hành, README có nêu thư mục dữ liệu cho macOS, Windows và Linux. Các lệnh cài đặt thủ công trong README được viết theo kiểu macOS/Linux, và Docker được ghi là dành cho Linux.

Sellbird gửi email thật từ hộp thư thật của bạn. Hãy dùng tên miền gửi riêng, đừng dùng hộp thư chính của công ty. Tìm hiểu quy định gửi email thương mại và chuyện deliverability trong tài liệu Legal and deliverability của repo trước khi bật chế độ tự động.

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

  1. Tải mã nguồnClone repo về máy và vào thư mục sellbird
  2. Cài góiTạo môi trường ảo và cài bằng pip install -e .
  3. Điền thông tinSao chép .env.example thành .env rồi điền thông tin hộp thư
  4. Dạy SellbirdChạy sellbird train với website của bạn, rồi xác nhận tín hiệu
  5. Tìm kháchChạy sellbird discover
  6. Mở dashboardChạy sellbird dashboard và sellbird run

README đưa ra hai cách: nhờ Claude cài giúp, hoặc tự làm. Mình đi qua cả hai.

A.Cách dễ nhất: để Claude cài giúp

Mở terminal (macOS/Linux dùng Terminal; Windows dùng PowerShell hoặc Git Bash) tại thư mục bạn muốn đặt dự án, rồi chạy:

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

Lệnh đầu tải mã nguồn về. Lệnh thứ hai đi vào thư mục vừa tải. Lệnh claude mở Claude Code ngay trong thư mục này. Sau đó bạn gõ set up Sellbird for me (README ghi câu này bằng tiếng Anh). Theo README, file CLAUDE.md của repo biến Claude Code thành người hướng dẫn: kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi thứ nó cần và huấn luyện Sellbird về sản phẩm của bạn. Bạn cần đã chạy claude login trước đó.

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

Bạn vẫn ở trong thư mục sellbird. Lệnh dưới đây là nguyên văn README:

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 Python riêng tên .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau khi cài, bạn có lệnh sellbird. Chỗ người mới hay vấp: nếu máy chỉ có Python cũ, lệnh python3.13 sẽ báo không tìm thấy. Lúc đó hãy cài Python mới trước. Lệnh source .venv/bin/activate là kiểu macOS/Linux; README chưa ghi lệnh kích hoạt riêng cho Windows, nên người dùng Windows có thể chọn cách nhờ Claude cài ở trên hoặc xem mục Troubleshooting trong thư mục docs/ của repo.

C.Điền thông tin hộp thư

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 file .env thật rồi mở nó để bạn sửa. Mỗi biến đều có giải thích ngay trong file. Bạn điền thông tin của dịch vụ gửi mail mình dùng, ví dụ nhóm GMAIL_*, nhóm SMTP_* hoặc nhóm M365_*. Nếu $EDITOR chưa được đặt, bạn có thể mở file .env bằng trình soạn thảo quen thuộc. Tuyệt đối không đưa file .env lên mạng.

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 địa chỉ website thật của bạn. Lệnh signals --confirm free giúp bạn xác nhận điều gì làm nên một khách hàng tiềm năng tốt.

E.Tìm doanh nghiệp, mở dashboard 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

Lệnh discover dùng nguồn miễn phí, không cần tài khoản. Lệnh dashboard in ra một đường link riêng trỏ tới địa chỉ chạy trên máy bạn (127.0.0.1:5555). Lệnh run bật vòng lặp chính. Mở dashboard trong một cửa sổ terminal và chạy run ở cửa sổ khác là cách gọn nhất.

F.Chạy bằng Docker (tuỳ chọn, trên Linux)

README chỉ ghi ngắn gọn rằng trên Linux bạn có thể chạy bằng Docker; repo có sẵn Dockerfile và docker-compose.yml. Các lệnh cụ thể README có nêu trong phần nâng cấp từ Harvey, mình chép lại để bạn tham khảo:

Terminal
docker compose build
docker compose up -d

Nếu bạn mới dùng, hãy ưu tiên cách cài thường. Hướng dẫn Docker đầy đủ nằm trong thư mục docs/ của repo.

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:

Code
Sellbird is online.
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
  writer    → 2-email sequence: ...
  outbox    → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.

Dấu hiệu bạn thấy nên là dòng "Sellbird is online", rồi các bước như viết chiến dịch, và cuối cùng là "Cycle complete", tức hết một vòng và nghỉ 15 phút. Nếu có email chờ duyệt, nó nằm trong Outbox của dashboard.

Cách kiểm tra khác: chạy sellbird dashboard. Nếu terminal in ra đường link riêng và bạn mở được trang ở cổng 5555, nghĩa là cài thành công. Repo cũng có dữ liệu demo hư cấu (công ty "Bookwell" bán phần mềm đặt lịch cho thợ lợp mái, nha khoa, sửa điều hoà, dùng tên miền .test) để bạn làm quen mà không gửi thư thật.

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

Dưới đây là bốn tình huống bám đúng những gì README mô tả.

A.Chủ shop dịch vụ muốn có danh sách khách địa phương

Bạn mở tiệm làm tóc hoặc phòng khám nhỏ và chỉ cần danh sách doanh nghiệp quanh khu vực để mời hợp tác. Bạn chạy sellbird train với website của mình, sellbird signals --confirm free, rồi sellbird discover với nguồn miễn phí. Sellbird đọc website từng doanh nghiệp để tìm tín hiệu và tìm người có tên trên trang đó. Kết quả là một danh sách công ty cùng người liên hệ đã được phân loại.

B.Nhân viên kinh doanh chỉ cần file CSV

Bạn đã có công cụ gửi email riêng (sequencer) và chỉ cần danh sách sạch. Hãy chạy tới bước xác minh rồi gõ:

Terminal
sellbird export

Bạn nhận về file CSV chứa mọi thứ Sellbird tìm được, sẵn sàng đưa vào công cụ của mình. Vì mỗi địa chỉ có nhãn verified, risky, guess hoặc invalid, bạn biết ngay nên giữ địa chỉ nào.

Không email nào rời máy bạn nếu bạn chưa bấm duyệt.

Ông T

C.Chủ doanh nghiệp duyệt thư mỗi sáng

Bạn để sellbird run chạy nền. Mỗi chu kỳ, Sellbird viết chuỗi email cho khách mới và đặt vào Outbox. Sáng ra bạn mở dashboard, đọc từng email, sửa nếu cần rồi duyệt. Trước khi gửi, một bước kiểm tra không dùng mô hình AI sẽ loại thư còn sót merge tag chưa điền, cụm từ bị cấm, thư quá dài, thừa link hoặc địa chỉ không gửi được. Kết quả: bạn kiểm soát nội dung mà vẫn tiết kiệm phần lớn thời gian viết.

D.Người làm sales xử lý phản hồi

Khi khách trả lời, Sellbird đọc thư, phân loại (như quan tâm hay phản đối), soạn sẵn câu trả lời, để riêng thư tự động và ghi nhận ngay yêu cầu từ chối. Những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Bạn chỉ cần mở dashboard để xem nháp và quyết định. Nếu cần dừng tất cả, gõ sellbird sending pause.

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

  • python3 báo phiên bản 3.9 hoặc cài gói thất bại. Đây là lỗi README đã cảnh báo trên macOS. Hãy cài Python mới bằng brew install python@3.13 rồi dùng python3.13 để tạo môi trường ảo thay vì python3.
  • Không thấy lệnh sellbird. Thường do bạn chưa kích hoạt môi trường ảo hoặc chưa cài xong bằng pip install -e .. Mở lại terminal trong thư mục dự án, kích hoạt .venv rồi thử lại.
  • Claude hoặc Codex chưa đăng nhập. Sellbird nhờ vào gói đăng ký của bạn nên cần đăng nhập CLI trước. Với Claude, chạy claude login. Với ChatGPT, xem hướng dẫn Codex trong thư mục docs/.
  • Gửi mail không được hoặc lọt vào spam. Kiểm tra lại các biến hộp thư trong .env, dùng tên miền gửi riêng và làm warmup hộp thư trước khi gửi nhiều. Xem thêm tài liệu Legal and deliverability và Troubleshooting trong repo.
  • git pull báo "your local changes would be overwritten" khi nâng cấp từ Harvey. README hướng dẫn chạy git stash, git pull, git stash pop. Về lâu dài nên để cấu hình riêng trong sellbird.local.yaml, vì file này git không động tới.

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

Điểm mạnh. Không cần API mô hình riêng và không bị tính tiền theo token, vì dùng gói Claude hoặc ChatGPT bạn đang có. Nguồn tìm doanh nghiệp mặc định miễn phí. Mỗi tìm kiếm trả phí đều báo giá trước. Mọi thư chờ duyệt trước khi gửi, và có lệnh dừng khẩn cấp. Mã nguồn mở nên bạn đọc và chỉnh được các prompt, skill. Dự án vẫ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, đây là phần dễ sai nhất của cold email. Cài đặt thủ công cần quen terminal, và README chưa ghi rõ lệnh cho Windows. Giấy phép là AGPL-3.0, bạn nên đọc kỹ nếu định tích hợp vào sản phẩm thương mại. Cold email có quy định pháp lý riêng tuỳ quốc gia, nên hãy đọc tài liệu pháp lý của repo và tự kiểm tra luật nơi bạn hoạt động.

Khi nào chọn cách khác. Nếu bạn không muốn tự vận hành gì cả, README nhắc tới bản hosted tại sellbird.ai (đang trong giai đoạn early access), có sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ cần vài chục liên hệ một lần, làm tay hoặc dùng công cụ quen thuộc có thể nhanh hơn. Còn nếu bạn muốn một dây chuyền tìm khách chạy trên máy mình, kiểm soát từng email gửi đi, thì Sellbird rất đáng thử.

4.3/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. Theo README, nguồn tìm doanh nghiệp mặc định là miễn phí, còn nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả. 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 nhắc Google Workspace khoảng 7 USD mỗi tháng.

Sellbird có cần API key của OpenAI hay Anthropic 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ần API key mô hình và không tính tiền theo token. Một số dịch vụ tuỳ chọn khác như xác minh email vẫn có biến khoá riêng trong .env.example.

Có cần GPU không?

Tư liệu không yêu cầu GPU hay phần cứng đặc biệt. Phần suy nghĩ do Claude hoặc Codex đảm nhiệm thông qua gói đăng ký của bạn.

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

README có nêu thư mục dữ liệu cho Windows, nhưng các lệnh cài thủ công được viết theo kiểu macOS/Linux và Docker được ghi là dành cho Linux. README chưa ghi lệnh kích hoạt môi trường ảo cho Windows, nên bạn có thể nhờ Claude cài giúp hoặc xem tài liệu 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. Ngay cả khi bật, các email có link tới tên miền không phải của bạn sẽ bị giữ lại, và bạn có thể dừng tất cả bằng lệnh sellbird sending pause.

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

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ơ sở dữ liệu, log và token dashboard. Dashboard chạy ở địa chỉ cục bộ 127.0.0.1. README không nói thêm về mức bảo mật nên bạn nên tự bảo vệ file .env và xem SECURITY.md của repo.

Sellbird khác Harvey thế nào?

Đó là cùng một dự án. Harvey được đổi tên thành Sellbird từ bản 0.4.0, cấu hình và dữ liệu của bạn được mang sang tự động. Các bản Harvey đến 0.3.x dùng giấy phép MIT, còn từ khi đổi tên là AGPL-3.0.

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ễ nhất: để Claude cài giúp
    2. B.Tự cài: tạo môi trường và cài gói
    3. C.Điền thông tin hộp thư
    4. D.Dạy Sellbird về sản phẩm của bạn
    5. E.Tìm doanh nghiệp, mở dashboard và chạy
    6. F.Chạy bằng Docker (tuỳ chọn, trên Linux)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop dịch vụ muốn có danh sách khách địa phương
    2. B.Nhân viên kinh doanh chỉ cần file CSV
    3. C.Chủ doanh nghiệp duyệt thư mỗi sáng
    4. D.Người làm sales xử lý phản hồi
  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ỏ.