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

Sellbird: tự động tìm khách và gửi cold email bằng gói Claude — 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ự động 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 (trước đây tên Harvey) là nền tảng mã nguồn mở chạy trên máy bạn, giúp tìm công ty phù hợp, tìm người quyết định, xác minh email, viết và gửi cold email rồi xử lý phản hồi. Nó dùng gói Claude Pro/Max hoặc ChatGPT (qua Codex) bạn đang có nên không phải trả tiền API theo token. Cài bằng Python 3.11+ với vài lệnh, 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ở viết bằng Python, làm trọn quy trình gửi cold email: 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ý phản hồi. Nó chạy ngay trên máy của bạn. Trước đây dự án tên là Harvey, nay đã đổi tên 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à lập trình viên muốn có hệ thống tìm khách chủ động mà không muốn thuê thêm một loạt công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Repo hiện có khoảng 5250 sao và 1127 fork, giấy phép AGPL-3.0. Bạn có thể xem video ngắn bên dưới để thấy tổng quan trước khi cài.

Điểm đáng giá nhất: Sellbird "suy nghĩ" qua Claude Code CLI trên gói Claude Pro hoặc Max (hoặc Codex trên gói ChatGPT) bạn đã trả tiền, nên không cần API key của mô hình và không bị tính tiền theo token. Điểm đáng giá thứ hai: mặc định không có email nào đi ra nếu bạn chưa bấm duyệt.

Ứng dụng

ethanplusai/sellbird

Nền tảng mã nguồn mở tìm công ty và người ra quyết định, xác minh email, viết và gửi cold email rồi xử lý phản hồi, chạy bằng gói Claude hoặc ChatGPT.

★ 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 công đoạn. Bạn chạy trọn từ đầu đến cuố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. Nhờ vậy bạn không bị trừ tiền bất ngờ.
  • Tìm lý do họ sẽ mua. Công cụ đọ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 AI và không tốn tiền, theo README chỉ cần ba request HTTP cho mỗi công ty.
  • Tìm người quyết định. Lấy 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.
  • Kiểm tra địa chỉ email. Học quy luật đặ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ư tớ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ư được gửi từ hộp thư 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ý phản hồi. Đọc từng thư trả lời, soạn sẵn câu trả lời, gạt riêng các thư tự động, 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ư mà công cụ không nên tự trả lời.

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

Về chi phí, README liệt kê: 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 doanh nghiệp với nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Phần viết và gửi dùng gói đăng ký của bạn cộng với một hộp thư (README nêu Google Workspace khoảng 7 USD một tháng).

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 >=3.11. Trên macOS, máy thường có sẵn 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à đã đăng nhập CLI bằng claude login. Hoặc gói ChatGPT có Codex CLI. Phần 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 (làm nóng) cho hộp thư đó. README gợi ý TrulyInbox, nhưng đó là link tiếp thị liên kết của tác giả. Bạn không bắt buộc phải dùng đúng công cụ này, chỉ cần hiểu rằng hộp thư mới phải được làm nóng trước khi gửi cold email.

Về hệ điều hành, README ghi rõ đường dẫn thư mục dữ liệu cho macOS, Windows và Linux. Docker thì README chỉ nói là chạy được trên Linux. Các nguồn dữ liệu và dịch vụ trả phí khác (Hunter, ZeroBounce, Reoon, Cloudflare, Instantly…) chỉ cần khi bạn chọn dùng, và khóa của chúng điền trong file .env. README không nói bạn cần GPU, nên bạn không cần lo phần này.

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

  1. Lấy mã nguồnClone repo về máy và vào thư mục dự án
  2. Cài đặtTạo môi trường ảo Python và cài Sellbird
  3. Điền thông tinSao chép .env.example thành .env rồi điền khóa cần thiết
  4. Dạy sản phẩmCho Sellbird đọc website của bạn để học sản phẩm
  5. Tìm kháchXác nhận tín hiệu rồi chạy discover
  6. ChạyMở dashboard và bật vòng lặp chính

README có hai cách: nhờ Claude cài giúp, hoặc tự làm từng lệnh. Mình khuyên người mới thử cách đầu tiên.

A.Cách nhanh: để Claude cài giúp

Mở terminal (Terminal trên macOS/Linux, hoặc PowerShell/Git Bash trên Windows) ở 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

git clone tải mã nguồn về, cd sellbird đi vào thư mục vừa tải, và claude 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 bạn, cài phần còn thiếu, hỏi những gì cần hỏi và huấn luyện Sellbird theo sản phẩm của bạn. Chỗ hay vấp: bạn phải đứng đúng trong thư mục sellbird trước khi gõ claude, nếu không Claude sẽ không đọc được CLAUDE.md.

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

Nếu muốn tự làm, bước đầu là cài Sellbird vào một môi trường ảo (một "hộp" Python riêng để không lẫn với các dự án khác):

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 thư mục .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được (pip install -e .). 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 lệnh kích hoạt riêng cho Windows PowerShell, nên nếu dùng Windows bạn có thể để Claude Code cài giúp theo cách ở trên, hoặc xem thêm trong thư mục docs của repo.

C.Điền thông tin vào .env

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. Trong .env.example có các nhóm: Gmail (GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET), SMTP/IMAP, Microsoft 365 (M365_CLIENT_ID, M365_TENANT_ID), và các dịch vụ xác minh email như REOON_API_KEY, ZEROBOUNCE_API_KEY, HUNTER_API_KEY. Bạn chỉ điền phần mình thực sự dùng. Nếu $EDITOR chưa được đặt trên máy, bạn cứ mở file .env bằng trình soạn thảo quen dùng.

File .env chứa mật khẩu và khóa truy cập hộp thư của bạn. Không gửi nó cho ai, không đưa lên GitHub, không dán vào ảnh chụp màn hình hay nhóm chat.

D.Cho Sellbird học 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 thật của bạn. Sellbird đọc trang đó để hiểu bạn bán gì, rồi ghi kết quả vào sellbird.local.yaml. File này là nơi lưu cấu hình riêng của bạn, git không đụng tới nên cập nhật phiên bản sau không làm mấ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

Bước 4 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. Bước 5 đi tìm doanh nghiệp, nguồn mặc định miễn phí và không cần tài khoản.

F.Mở dashboard và chạy 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ỉ http://127.0.0.1:5555, tức là chỉ mở trên chính máy của bạn. sellbird run bật vòng lặp chính. Hãy để cửa sổ terminal chạy lệnh này mở. Trên Linux, bạn cũng có thể chạy bằng Docker (repo có Dockerfile và docker-compose.yml, xem hướng dẫn Docker trong docs).

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

Sau sellbird run, README cho thấy kết quả mong đợi gần như sau:

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

Nếu bạn thấy dòng "Sellbird is online", thấy nó kiểm tra trạng thái và có email chờ duyệt trong Outbox, nghĩa là mọi thứ đã chạy. Số liệu trong ví dụ là dữ liệu giả của README, nên con số của bạn sẽ khác. Sau đó hãy mở link do sellbird dashboard in ra, bạn sẽ thấy các màn hình quản lý, trong đó có Outbox. Một dấu hiệu tốt nữa là khi chưa duyệt gì thì không có email nào rời khỏi máy.

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

Dưới đây là vài tình huống mình thấy khớp với khả năng README mô tả.

A.Chủ công ty phần mềm đặt lịch tìm khách địa phương

Bạn bán phần mềm đặt lịch hẹn online cho các tiệm nhỏ. README dùng đúng ví dụ này: công ty giả "Bookwell" bán đặt lịch cho thợ lợp mái, phòng nha và tiệm điện lạnh. Bạn chạy sellbird train với website của mình, rồi sellbird signals --confirm free để chọn dấu hiệu như "chưa có đặt lịch online". Sau đó sellbird discover để tìm doanh nghiệp. Kết quả: một danh sách công ty có lý do cụ thể để mua, thay vì danh sách mù.

Nothing sends without you: mọi email đều nằm chờ trong Outbox cho tới khi bạn bật autopilot.

Ông T

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

Bạn đã có công cụ gửi thư hàng loạt riêng và chỉ cần danh sách. Chạy các bước tìm, bổ sung người quyết định và xác minh, rồi dừng lại và gõ:

Terminal
sellbird export

Bạn nhận được file CSV để đưa vào công cụ gửi thư của mình, kèm nhãn verified/risky/guess/invalid cho từng địa chỉ để lọc bỏ địa chỉ không gửi được.

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

Bạn bật sellbird run và để máy chạy. Mỗi sáng mở dashboard, vào Outbox xem thư nháp đã viết cho từng người (ví dụ chuỗi 2 email nhắc việc công ty đang tuyển nhân viên điều phối), sửa nếu cần rồi duyệt. Với thư trả lời, công cụ soạn sẵn câu đáp cho các thư quan tâm hoặc phản đối, và chuyển cho bạn thư nó không nên tự trả lời. Kết quả: bạn chỉ còn việc đọc và quyết định thay vì viết từ đầu.

D.Cần dừng khẩn cấp

Gửi thử thấy có gì lạ, bạn chỉ cần chạy:

Terminal
sellbird sending pause

Lệnh này dừng mọi việc gửi ngay lập tức, theo README.

Cold email có quy định pháp lý và ảnh hưởng đến uy tín tên miền gửi. README khuyên dùng tên miền gửi riêng và có hướng dẫn "Legal and deliverability" trong docs. Hãy đọc kỹ trước khi bật autopilot.

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

Lệnh sellbird không được nhận ra. Thường do bạn chưa kích hoạt môi trường ảo hoặc chưa chạy pip install -e .. Mở lại terminal trong thư mục dự án, kích hoạt .venv rồi cài lại.

Python quá cũ trên macOS. python3 mặc định là 3.9, trong khi dự án cần 3.11 trở lên. Làm theo README: brew install python@3.13 rồi dùng python3.13 thay vì python3 khi tạo môi trường ảo.

Claude chưa đăng nhập. Sellbird dựa vào Claude Code CLI. Nếu chưa đăng nhập, hãy chạy claude login rồi thử lại. Nếu bạn dùng ChatGPT thì xem hướng dẫn Codex trong docs.

Email không gửi đi. Kiểm tra lần lượt: thư còn nằm trong Outbox chờ bạn duyệt (đây là mặc định), địa chỉ nhận có bị đánh dấu invalid không, và thông tin hộp thư trong .env đã điền đúng chưa. Pre-send check của Sellbird cũng chặn thư còn sót merge tag, cụm từ bị cấm, thư quá dài, quá nhiều link. Chi tiết xử lý lỗi nằm ở tài liệu Troubleshooting của repo.

Nâng cấp từ Harvey bị báo lỗi khi git pull. Nếu bạn từng sửa trực tiếp harvey.yaml, git sẽ báo "your local changes would be overwritten". README hướng dẫn chạy git stash, git pull, rồi git stash pop. Lần sau hãy đặt thiết lập vào sellbird.local.yaml để tránh phiền phức.

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

Điểm mạnh. Không phải trả tiền API theo token vì dùng gói Claude hoặc ChatGPT sẵn có. Chi phí tìm khách có thể bằng 0 với nguồn mặc định. Dữ liệu và cấu hình nằm trên máy bạn. Mặc định phải duyệt thư trước khi gửi, có bước kiểm tra trước khi gửi không dùng mô hình, và có lệnh dừng khẩn cấp. Mã nguồn mở, bạn sửa được các prompt và kỹ năng bán hàng trong thư mục prompts/ và skills/.

Giới hạn. Bạn phải tự lo hộp thư, tên miền gửi và việc warmup, đây là phần khó nhất của cold email và Sellbird không tự giải quyết hộ khi chạy bản tự cài. Công cụ cần máy chạy liên tục để vòng lặp hoạt động. README chỉ nói Docker dùng được trên Linux. Nguồn tìm miễn phí là OpenStreetMap nên phù hợp nhất với doanh nghiệp địa phương, và tôi chưa thấy tư liệu nói về độ phủ ở Việt Nam. Giấy phép AGPL-3.0 cũng cần để ý 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ự vận hành, README nhắc có 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ỉ gửi vài thư thủ công mỗi tuần, tự viết có lẽ đơn giản hơn. Và nếu bạn chưa hiểu quy định về thư quảng cáo, hãy đọc kỹ phần pháp lý trước khi gửi.

4.5/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?

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 là OpenStreetMap, miễn phí. 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/tháng).

Có cần API key của mô hình AI không?

Không. README nói Sellbird chạy qua Claude Code CLI trên gói Claude Pro/Max hoặc Codex trên gói ChatGPT, không có API key và không tính tiền theo token. Một số nguồn dữ liệu hoặc dịch vụ xác minh email tùy chọn thì có khóa riêng trong file .env.

Có cần GPU không?

Tư liệu không nhắc tới yêu cầu GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhiệm, nên có vẻ không cần GPU, nhưng chưa có thông tin chính thức về cấu hình tối thiểu.

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

README có ghi thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh mẫu viết theo kiểu macOS/Linux. Phần Docker README chỉ nói chạy trên Linux. Chưa có hướng dẫn riêng cho Windows ở phần Quick start.

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 đến khi bạn tự bật autopilot. Lệnh sellbird sending pause dừng mọi việc gửi ngay, và có bước kiểm tra trước khi gửi không dùng mô hình.

Sellbird khác gì Harvey?

Là cùng một dự án, cùng lịch sử, chỉ đổi tên từ Harvey sang Sellbird ở bản 0.4.0. Cấu hình, dữ liệu và đăng nhập dashboard được giữ khi nâng cấp. Các biến HARVEY_* vẫn chạy khi biến SELLBIRD_* chưa được đặt.

Dữ liệu của tôi lưu ở đâu?

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 home. Với bản clone thì là chính thư mục repo, còn bản cài bằng pip thì là thư mục dữ liệu người dùng của hệ điều hành. Cơ sở dữ liệu, log và token dashboard nằm trong thư mục data/.

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 nhanh: để Claude cài giúp
    2. B.Tạo môi trường ảo và cài gói
    3. C.Điền thông tin vào .env
    4. D.Cho Sellbird học 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 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 đặt lịch 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ụ khác
    3. C.Chủ doanh nghiệp duyệt thư mỗi sáng
    4. D.Cần 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ỏ.