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

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

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 bằng gói Claude — 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 mã nguồn mở viết bằng Python, giúp tìm doanh nghiệp phù hợp, tìm 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. Nó chạy trên máy bạn, dùng gói Claude Pro/Max hoặc ChatGPT (Codex) nên không cần API key mô hình. Cài đặt khá gọn, nhưng cần biết dùng terminal và có sẵn một hộp thư để gửi.

Sellbird là một nền tảng mã nguồn mở chạy trên máy bạn, làm trọn chuỗi việc "outreach" (chủ động tiếp cận khách hàng qua email): tìm doanh nghiệp 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 rồi xử lý thư trả lời. Dự án trước đây tên Harvey, hiện có khoảng 5.250 sao và 1.127 fork trên GitHub, viết bằng Python, giấy phép AGPL-3.0.

Người nên xem là chủ doanh nghiệp nhỏ, người làm sales, agency hoặc freelancer đang tự gửi cold email bằng tay, và lập trình viên muốn một hệ thống tự host thay vì thuê nhiều công cụ rời. Điểm đáng giá nhất theo tác giả: Sellbird "suy nghĩ" thông qua Claude Code CLI trên gói Claude Pro/Max của bạn, hoặc qua Codex trên gói ChatGPT. Không có API key mô hình, không tính tiền theo token.

Mặc định, không có email nào được gửi đi nếu bạn chưa duyệt. Bạn có thể xem video ngắn bên dưới để thấy tổng quan, 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ở tự tìm doanh nghiệp, kiểm tra email, viết và gửi cold email, xử lý trả lời, chạy trên gói Claude hoặc ChatGPT của bạn.

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

  • Tìm doanh nghiệp. Tìm các công ty 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. Lợi ích: không bị "cháy ví" bất ngờ.
  • Tìm lý do họ sẽ mua. Đọc chính website của từng công ty để tìm tín hiệu 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ì. Lợi ích: email của bạn có lý do cụ thể để viết, không phải thư gửi đại trà.
  • 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ỉ email. 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, và chỉ địa chỉ gửi được mới nhận thư. Lợi ích: giảm thư bị trả về, bảo vệ uy tín hộp thư 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, rồi gửi từ 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ý trả lời. Đọc mọi thư trả lời, soạn nháp câu đáp, tách thư tự động ra riê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ãy dừng sau bước kiểm tra email rồi chạy sellbird export để lấy file CSV sẵn sàng đưa vào công cụ gửi thư khác.

Ngoài ra có bảng điều khiển (dashboard) chạy trên máy, hộp "Outbox" để duyệt thư trước khi gửi, và lệnh sellbird sending pause để dừng mọi thứ ngay.

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). 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 đã đăng nhập Claude CLI (claude login), hoặc gói ChatGPT có Codex CLI.
  • Một hộp thư để gửi, tốt nhất là 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) hộp thư đó. README gợi ý TrulyInbox; Sellbird đọc tỷ lệ vào hộp thư đến của dịch vụ này để báo bạn khi nào sẵn sàng. Đây là link affiliate của tác giả, bạn không bắt buộc dùng.
  • Các khoá khác như GMAIL_CLIENT_ID, SMTP_HOST, REOON_API_KEY, HUNTER_API_KEY… nằm trong file .env.example. Bạn chỉ điền những gì mình dùng; README nói mỗi biến đều có chú thích ngay trong file.

Riêng chi phí: README ghi 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ả, và Google Workspace khoảng 7 USD một tháng. README không nói gì về yêu cầu GPU.

Cold email có quy định pháp lý và rủi ro bị đánh dấu spam. Hãy đọc tài liệu "Legal and deliverability" trong thư mục docs/ của repo trước khi gửi thật, và nên dùng một tên miền gửi riêng thay vì tên miền chính của công ty.

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

  1. Kiểm tra PythonĐảm bảo có Python 3.11 trở lên và Claude CLI đã đăng nhập
  2. Tải mã nguồnClone repo về máy rồi vào thư mục
  3. Cài đặtTạo môi trường ảo và cài gói sellbird
  4. Điền thông tinSao chép .env.example thành .env và điền khoá
  5. Dạy sản phẩmCho Sellbird học website của bạn
  6. ChạyTìm doanh nghiệp, mở dashboard, bật vòng lặp

A.Kiểm tra Python và Claude CLI

Mở terminal (trên macOS là Terminal, trên Windows là PowerShell hoặc Git Bash) và kiểm tra phiên bản Python:

Terminal
python3 --version

Nếu ra 3.9 (hay gặp trên macOS), cài bản mới theo README:

Terminal
brew install python@3.13

Sau đó đăng nhập Claude CLI (nếu bạn dùng gói Claude):

Terminal
claude login

Nếu bạn dùng ChatGPT, README trỏ sang tài liệu "Using a ChatGPT plan (Codex)" trong repo. Mình không chép lệnh ở đây vì tư liệu chưa nêu chi tiết.

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

Tác giả làm sẵn file CLAUDE.md để Claude Code tự hướng dẫn cài đặt. Bạn chỉ cần:

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

Lệnh đầu tải mã nguồn, 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 đó. Rồi bạn gõ: "set up Sellbird for me". Claude sẽ kiểm tra máy, cài phần còn thiếu, hỏi những gì cần hỏi và "dạy" Sellbird về sản phẩm của bạn. Chỗ người mới hay vấp: phải chạy claude đúng trong thư mục sellbird, nếu không nó không đọc được CLAUDE.md.

C.Cách tự làm: cài gói

Nếu muốn tự làm, sau khi đã git clone và cd sellbird như trên, chạy lệnh sau (chép đúng 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ôi trường ảo .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa để 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 riêng cho Windows, nên nếu bạn dùng Windows hãy xem thêm mục Troubleshooting trong thư mục docs/ hoặc nhờ Claude Code cài giúp theo cách nhanh ở trên.

D.Điền thông tin xác thực

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 mặc định. Hãy điền thông tin hộp thư (Gmail, Microsoft 365 hoặc SMTP/IMAP) và các dịch vụ kiểm tra email nếu bạn dùng. Đừng chia sẻ file .env cho ai và đừng đưa nó lên GitHub.

E.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

Thay https://your-company.com bằng website thật của bạn. Lệnh đầu đọc website và ghi kết quả vào sellbird.local.yaml. Lệnh thứ hai để bạn xác nhận những tín hiệu cho thấy một công ty là khách tiềm năng tốt.

F.Tìm khách, 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

sellbird discover tìm doanh nghiệp từ nguồn miễn phí mặc định. sellbird dashboard in ra một đường link riêng tới địa chỉ trên máy bạn (127.0.0.1:5555). sellbird run bật vòng lặp chính; nó chạy theo chu kỳ, nghỉ 15 phút giữa các vòng. README cho biết trên Linux bạn cũng có thể chạy bằng Docker (repo có Dockerfile và docker-compose.yml).

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

Cách đơn giản nhất là chạy sellbird run. README minh hoạ kết quả mong đợi như sau: màn hình báo "Sellbird is online", kiểm tra trạng thái pipeline, đưa ra quyết định tiếp theo (ví dụ viết chiến dịch cho các prospect mới), rồi báo có bao nhiêu email đang chờ bạn duyệt và "Cycle complete".

Bạn cũng kiểm tra bằng cách chạy sellbird dashboard và mở link riêng nó in ra. Nếu thấy giao diện hiện lên, phần cài đặt đã ổn. Nếu lệnh sellbird báo không tìm thấy, thường là bạn quên kích hoạt môi trường ảo .venv trong cửa sổ terminal hiện tại.

Về nơi lưu dữ liệu: nếu chạy từ thư mục đã clone, mọi thứ nằm ngay trong thư mục đó. Nếu cài như gói thông thường, thư mục gốc là %APPDATA%\sellbird trên Windows, ~/Library/Application Support/sellbird trên macOS, ~/.local/share/sellbird trên Linux. Cơ sở dữ liệu, log và mã đăng nhập dashboard nằm trong thư mục con data/.

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

A.Chủ phần mềm nhỏ muốn tìm khách đầu tiên

Bạn bán phần mềm đặt lịch cho tiệm nha khoa, thợ sửa mái nhà hay cửa hàng điều hoà (đây cũng chính là ví dụ demo "Bookwell" trong README). Bạn chạy sellbird train với website của mình, xác nhận tín hiệu bằng sellbird signals --confirm free, rồi sellbird discover. Sellbird tìm các doanh nghiệp phù hợp, đọc website để thấy ai chưa có đặt lịch online, tìm người chủ và viết chuỗi email riêng cho từng người. Kết quả: một danh sách thư nháp nằm sẵn trong Outbox, mỗi thư nhắc đúng điều đã thấy ở công ty đó.

B.Người làm sales chỉ cần danh sách sạch

Bạn đã có công cụ gửi thư riêng và chỉ cần danh sách. Chạy các bước tìm và kiểm tra, sau đó dừng lại và gõ:

Terminal
sellbird export

Bạn nhận được file CSV chứa mọi thứ Sellbird tìm được, kèm nhãn verified, risky, guess hoặc invalid cho từng địa chỉ. Bạn có thể chỉ giữ dòng verified để giảm thư bị trả lại.

Sellbird không gửi gì đi nếu bạn chưa gật đầu, nên bạn thử được ngay mà không sợ phát tán nhầm.

Ông T

C.Duyệt thư mỗi sáng trong Outbox

Bạn đang là chủ cửa hàng, không có nhiều thời gian. Mỗi sáng bạn mở dashboard (sellbird dashboard), vào Outbox và đọc các email đang chờ. Trước khi thư rời đi, hệ thống còn tự kiểm tra bằng quy tắc, không dùng mô hình: loại 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 hoặc địa chỉ không gửi được. Bạn sửa, duyệt hoặc loại bỏ. Chỉ khi bạn tự bật chế độ autopilot thì Sellbird mới gửi mà không chờ duyệt, và ngay cả khi đó nó vẫn giữ lại thư chứa link tới tên miền không phải của bạn.

D.Xử lý thư trả lời và dừng khẩn cấp

Khi có người trả lời, Sellbird đọc thư, soạn nháp câu đáp (ví dụ khách quan tâm hay phản đối giá), tách thư trả lời tự động ra riêng và ghi nhận ngay những ai từ chối nhận thư. Những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Nếu thấy có gì không ổn, chạy một lệnh để dừng tất cả:

Terminal
sellbird sending pause

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

A.Python quá cũ, cài gói báo lỗi

Triệu chứng: pip install -e . báo lỗi về phiên bản Python. Nguyên nhân hay gặp là macOS dùng Python 3.9 mặc định. Cách xử lý: cài python@3.13 bằng Homebrew như README, rồi dùng python3.13 thay cho python3 khi tạo môi trường ảo.

B.Gõ sellbird báo không tìm thấy lệnh

Bạn chưa kích hoạt môi trường ảo trong cửa sổ terminal này, hoặc chưa cài gói. Hãy vào lại thư mục sellbird, kích hoạt .venv, và chạy lại pip install -e ..

C.Claude hoặc Codex CLI chưa đăng nhập

Sellbird dùng gói của bạn thông qua CLI nên nếu chưa đăng nhập thì nó không "suy nghĩ" được. Chạy claude login (với gói Claude) và thử lại. Sellbird còn tự giới hạn tốc độ để chừa chỗ cho việc của bạn, nhưng nếu gói của bạn hết hạn mức thì cần đợi hoặc nâng gói.

D.Email vào thư rác hoặc bị trả lại

Cold email phụ thuộc rất nhiều vào hộp thư gửi. Hãy dùng tên miền gửi riêng, warmup hộp thư trước khi gửi, và chỉ gửi tới địa chỉ có nhãn verified. Đừng bật autopilot khi hộp thư còn mới.

E.Dùng bản Harvey cũ gặp lỗi khi git pull

Nếu bạn từng chạy Harvey và sửa trực tiếp harvey.yaml, git pull 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. Tốt hơn, đặt cấu hình riêng vào sellbird.local.yaml vì git không đụng tới file này.

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

Điểm mạnh. Chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Không cần API key mô hình, tận dụng gói Claude hoặc ChatGPT sẵn có. Mặc định phải duyệt thư trước khi gửi, có bước kiểm tra an toàn không dùng mô hình, có lệnh dừng khẩn cấp. Bạn có thể chỉnh sửa các playbook bán hàng và prompt vì chúng là file nằm ngay trong repo (prompts/, skills/). Có tài liệu khá đầy đủ trong thư mục docs/.

Giới hạn. Bạn vẫn cần biết dùng terminal, tự chuẩn bị hộp thư gửi và warmup, và tự chịu trách nhiệm về quy định gửi email. Nguồn tìm miễn phí (OpenStreetMap) phù hợp nhất với doanh nghiệp địa phương; README không hứa nó phủ được mọi ngành hay mọi quốc gia. Tác giả ghi sẵn ví dụ bằng tiếng Anh, còn việc viết email tiếng Việt chưa được nêu trong tư liệu nên bạn nên thử và đọc kỹ trước khi duyệt. Giấy phép AGPL-3.0 cũng cần để ý nếu bạn định dùng thương mại hay đóng gói lại.

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), lo sẵn tên miền gửi, hộp thư và warmup. Còn nếu bạn chỉ cần gửi vài thư thủ công mỗi tuần, một công cụ đơn giản hơn có lẽ đủ dùng.

4.9/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, tải về dùng được. Bạn cần gói Claude Pro/Max hoặc ChatGPT có Codex sẵn có, và một hộp thư để gửi (README ước tính 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. 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, không có API key và không tính theo token. Bạn vẫn cần đăng nhập CLI tương ứng, ví dụ bằng `claude login`.

Có cần GPU không?

README không nhắc yêu cầu GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhiệm thông qua CLI, còn Sellbird chạy bằng Python 3.11 trở lên.

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

README có nêu thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt trong README viết theo kiểu macOS/Linux, và Docker được ghi là dùng trên Linux. Chưa có hướng dẫn riêng cho Windows trong phần Quick start, bạn nên xem thư mục docs/ hoặc nhờ Claude Code cài giúp.

Email có tự gửi đi mà tôi không biết không?

Mặc định thì không. Mỗi email chờ trong Outbox cho tới khi bạn duyệt, trừ khi bạn tự bật autopilot. Trước khi gửi còn có bước kiểm tra bằng quy tắc, và lệnh `sellbird sending pause` dừng mọi thứ ngay lập tức.

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 trên máy bạn, gồm cơ sở dữ liệu, log và mã đăng nhập dashboard. Dashboard chạy ở địa chỉ 127.0.0.1 trên máy. Tư liệu không nêu chi tiết thêm về bảo mật, nên hãy tự giữ file `.env` kín.

Khác gì Apollo, ZoomInfo hay Clay?

README ghi rõ Sellbird không dùng các công cụ prospecting như Apollo, ZoomInfo, Clearbit hay Clay. Nó tự tìm công ty, tìm người quyết định và kiểm tra email, rồi viết, gửi và xử lý trả lời trong cùng một hệ thống tự host. Tư liệu không so sánh chi tiết về chất lượng dữ liệu.

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.Kiểm tra Python và Claude CLI
    2. B.Cách nhanh: để Claude cài giúp
    3. C.Cách tự làm: cài gói
    4. D.Điền thông tin xác thực
    5. E.Dạy Sellbird về sản phẩm của bạn
    6. F.Tìm khách, 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ủ phần mềm nhỏ muốn tìm khách đầu tiên
    2. B.Người làm sales chỉ cần danh sách sạch
    3. C.Duyệt thư mỗi sáng trong Outbox
    4. D.Xử lý thư trả lời và dừng khẩn cấp
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Python quá cũ, cài gói báo lỗi
    2. B.Gõ sellbird báo không tìm thấy lệnh
    3. C.Claude hoặc Codex CLI chưa đăng nhập
    4. D.Email vào thư rác hoặc bị trả lại
    5. E.Dùng bản Harvey cũ gặp lỗi khi git pull
  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ỏ.