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/ChatGPT — 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 bằng gói Claude/ChatGPT — 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, chạy trên máy bạn. Nó tìm công ty hợp với khách hàng của bạn, tìm người quyết định, kiểm tra email, viết và gửi cold email, rồi soạn sẵn câu trả lời cho thư phản hồi. Cài không quá khó nếu bạn quen terminal, và README có cách cho Claude Code tự hướng dẫn cài.

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

Người nên xem là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, freelancer và lập trình viên muốn tự dựng quy trình tìm khách thay vì trả tiền cho hàng loạt công cụ rời rạc. Điểm đáng giá nhất: Sellbird dùng "bộ não" là Claude Code CLI trên gói Claude Pro/Max, hoặc Codex trên gói ChatGPT. Theo README, bạn không cần API key của mô hình và không bị tính tiền theo token. Mặc định, không email nào được gửi đi nếu bạn chưa duyệt.

Repo hiện có khoảng 5.250 sao và 1.127 fork, giấy phép AGPL-3.0, và vẫn được cập nhật trong vài tháng gần đây. Bạn có thể xem video ngắn bên dưới để hình dung trước khi cài.

Ứng dụng

ethanplusai/sellbird

Sellbird là nền tảng mã nguồn mở tự tìm công ty và người ra 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.

★ 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 có thể chạy hết, 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ũng có thể chọn nguồn trả phí. Mỗi lần tìm trả phí đều hiện chi phí trước khi chạy, nên không sợ bị trừ tiền bất ngờ.
  • Hiểu vì sao họ sẽ mua. Sellbird đọc website của từng công ty để tìm các 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 nên không tốn gì. README nói có 29 tín hiệu.
  • Tìm người quyết định. Lấy 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 địa chỉ email. Sellbird học kiểu địa chỉ 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 bị gửi 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, rồi 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. Đọc mọi thư phản hồi, soạn câu trả lời, gạt thư tự động sang một bên, tôn trọng yêu cầu huỷ nhận ngay lập tức, và chuyển cho bạn những thư không nên trả lời tự động.

Nếu bạn chỉ cần danh sách khách tiềm năng, hãy dừng sau bước kiểm tra email rồi chạy sellbird export để xuất file CSV dùng được với các công cụ gửi email hàng loạt.

Về chi phí, README liệt kê: 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; viết và gửi dùng gói đăng ký của bạn cộng một hộp thư (README nêu khoảng 7 USD mỗi tháng cho Google Workspace). Không cần Apollo, ZoomInfo, Clearbit hay Clay.

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 có sẵn Python 3.9, nên nếu python3 --version báo 3.9 thì chạy trước brew install python@3.13.
  • Claude Pro hoặc Max với CLI đã đăng nhập (claude login), hoặc gói ChatGPT có Codex CLI.
  • Một hộp thư để gửi, lý tưởng 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) cho hộp thư đó. README khuyên dùng TrulyInbox; Sellbird đọc tỷ lệ vào hộp thư đến từ đây để báo bạn khi nào đã sẵn sàng. Lưu ý: link TrulyInbox trong dự án là link affiliate, người duy trì có thể nhận hoa hồng.

File .env.example liệt kê các biến cấu hình tuỳ chọn, ví dụ GMAIL_CLIENT_ID, SMTP_HOST, M365_CLIENT_ID, REOON_API_KEY, ZEROBOUNCE_API_KEY, HUNTER_API_KEY… 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.

Về hệ điều hành, README có hướng dẫn cho macOS, và có bảng thư mục dữ liệu cho cả macOS, Windows và Linux. Docker được nhắc là chạy được trên Linux. Lệnh kích hoạt môi trường ảo trong README là kiểu macOS/Linux; README không ghi lệnh riêng cho Windows.

Cold email gửi cho người lạ chịu ràng buộc pháp lý và có thể làm hỏng uy tín tên miền của bạn. Hãy dùng tên miền gửi riêng, warmup hộp thư kỹ và đọc tài liệu Legal and deliverability trong thư mục docs/ của repo trước khi gửi thật.

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

  1. Tải mã nguồnClone repo về máy và vào thư mục
  2. Tạo môi trường và càiTạo venv Python 3.13 rồi pip install -e .
  3. Điền thông tinSao 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. Tìm khách và chạydiscover, mở dashboard, rồi sellbird run

README có hai đường: nhờ Claude cài hộ, hoặc tự gõ lệnh. Người mới nên thử đường thứ nhất.

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

Mở terminal (macOS: Terminal; Windows: PowerShell) và chạy:

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

Dòng đầu tải mã nguồn về. Dòng hai đi vào thư mục vừa tải. Dòng ba mở Claude Code ngay trong thư mục đó (bạn cần đã cài Claude CLI và đăng nhập bằng claude login). Khi Claude Code mở, gõ: set up Sellbird for me. File CLAUDE.md của repo biến Claude Code thành người hướng dẫ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à dạy Sellbird về sản phẩm của bạn.

Chỗ hay vấp: phải chạy claude đúng trong thư mục sellbird, nếu không Claude sẽ không đọc được CLAUDE.md của repo.

B.Cách 2: tự cài, bước 1 — tạo môi trường và cài gói

Trong thư mục sellbird, chạy lệnh sau (theo README, dùng python3.13 chứ không dùng python3, vì macOS mặc định là 3.9):

Terminal
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. Sau khi xong, bạn có lệnh sellbird. Nếu thấy dòng (.venv) ở đầu terminal là môi trường đã bật. Mỗi lần mở terminal mới, bạn cần kích hoạt lại môi trường này. Trên Windows, README chưa ghi lệnh kích hoạt riêng; hãy xem thêm trong thư mục docs/ của repo.

C.Bước 2 — điền thông tin đăng nhập

Terminal
cp .env.example .env && $EDITOR .env

Lệnh đầu sao chép file mẫu thành .env; lệnh sau mở file để sửa ($EDITOR là trình soạn thảo mặc định của máy, bạn có thể tự mở .env bằng bất kỳ trình soạn thảo nào). Điền các giá trị cho hộp thư gửi và dịch vụ kiểm tra email bạn chọn. File .env chứa mật khẩu và key, đừng chia sẻ hay đưa lên mạng.

D.Bước 3 — dạy Sellbird về sản phẩm của bạn

Terminal
sellbird train https://your-company.com

Thay địa chỉ bằng website công ty bạn. Sellbird đọc website và ghi hiểu biết về sản phẩm vào file sellbird.local.yaml. Đây là file của riêng bạn, git không đụng tới.

E.Bước 4 — xác nhận khách hàng tốt trông như thế nào

Terminal
sellbird signals --confirm free

Bước này chọn các tín hiệu mua hàng mà Sellbird sẽ tìm trên website công ty, theo hướng mà README gọi là cách miễn phí.

F.Bước 5 — tìm doanh nghiệp

Terminal
sellbird discover

Nguồn mặc định miễn phí, không cần tài khoản.

G.Bước 6 — mở bảng điều khiển và bắt đầu vòng lặp

Terminal
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ỉ chạy trên máy bạn (127.0.0.1:5555). sellbird run khởi động vòng lặp chính. Hai lệnh nên chạy ở hai cửa sổ terminal, mỗi cửa sổ đều đã kích hoạt môi trường ảo. Trên Linux, bạn cũng có thể chạy bằng Docker; repo có Dockerfile và docker-compose.yml, chi tiết xem tài liệu Docker trong docs/.

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

Cách kiểm tra theo README là chạy sellbird run và xem đầu ra. Khi thành công, bạn sẽ thấy dòng "Sellbird is online", sau đó là các dòng kiểu "Checking pipeline state...", quyết định của chu kỳ (ví dụ viết chiến dịch cho các prospect mới), danh sách việc của các tác vụ con, và cuối cùng "Cycle complete. Sleeping for 15 minutes." Trong ví dụ của README còn có dòng cho biết có vài email đang chờ bạn duyệt trong Outbox.

Với bảng điều khiển, nếu sellbird dashboard in ra link tới http://127.0.0.1:5555 và mở được trên trình duyệt của chính máy bạn thì giao diện đã chạy. README cũng nói dữ liệu demo là hư cấu (công ty "Bookwell" bán hệ thống đặt lịch cho thợ lợp mái, nha khoa, điều hoà), nên đừng nhầm đó là dữ liệu thật của bạn.

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

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

A.Chủ một dịch vụ địa phương muốn có danh sách khách tiềm năng

Bạn bán phần mềm đặt lịch cho phòng khám nha khoa. Bạn chạy sellbird train với website của mình, xác nhận tín hiệu như "chưa có đặt lịch online", rồi chạy sellbird discover để tìm các phòng khám phù hợp từ nguồn miễn phí. Sellbird đọc website từng nơi và lọc ra những nơi có tín hiệu. Kết quả là một danh sách công ty có lý do cụ thể để bạn tiếp cận, thay vì danh sách đại trà.

Sellbird không gửi gì đi khi bạn chưa gật đầu: mọi email đều nằm chờ trong Outbox cho tới khi bạn tự bật autopilot.

Ông T

B.Nhân viên sales chỉ cần danh sách để dùng công cụ khác

Công ty bạn đã có công cụ gửi email hàng loạt riêng. Bạn chạy các bước tìm công ty, tìm người quyết định và kiểm tra địa chỉ, rồi dừng lại và chạy:

Terminal
sellbird export

Bạn nhận được file CSV các liên hệ đã tìm thấy, mỗi địa chỉ có nhãn verified, risky, guess hoặc invalid để bạn tự quyết định nên dùng cái nào.

C.Người làm outreach muốn duyệt từng email trước khi gửi

Sau khi sellbird run chạy, bạn mở dashboard và vào Outbox. Ở đó có các email Sellbird đã viết, ví dụ chuỗi hai email nhắm vào một công ty đang tuyển nhân viên điều phối (đúng như ví dụ README). Bạn đọc, sửa, duyệt hoặc bỏ. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ chặn các lỗi như merge tag chưa điền, cụm từ bị cấm, email quá dài, quá nhiều link hoặc địa chỉ không gửi được. Nếu cần dừng ngay, chạy sellbird sending pause.

D.Người đang dùng Harvey muốn chuyển sang Sellbird

Nếu bạn đã chạy Harvey, README nói cấu hình, dữ liệu và đăng nhập dashboard của bạn đượ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à cơ sở dữ liệu tương ứng, không ghi đè file đã có. Hãy dừng tiến trình Harvey đang chạy trước.

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

Báo sai phiên bản Python hoặc cài lỗi. Dự án cần Python 3.11 trở lên. Trên macOS, python3 trần thường là 3.9. Hãy cài python@3.13 bằng Homebrew rồi dùng đúng lệnh python3.13 để tạo môi trường ảo như README ghi.

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

git pull báo "your local changes would be overwritten" khi nâng cấp từ Harvey. Theo README, nguyên nhân là bạn đã sửa trực tiếp file harvey.yaml. Chạy git stash, git pull, rồi git stash pop. Nếu có xung đột, giữ các dòng của bạn, xoá dấu xung đột và chạy git stash drop. Lần sau hãy đặt cài đặt vào sellbird.local.yaml.

Không biết dữ liệu và file cấu hình nằm ở đâu. Nếu bạn cài như một gói (pip hoặc pipx), thư mục gốc nằm trong thư mục dữ liệu người dùng, ví dụ Windows là %APPDATA%\sellbird. Nếu bạn chạy từ thư mục clone, thư mục đó chính là nơi chứa. Biến SELLBIRD_HOME nếu có sẽ được ưu tiên.

Email gửi ít hoặc vào thư rác. Dự án nhấn mạnh warmup và dùng tên miền gửi riêng. Hãy làm nóng hộp thư trước khi gửi nhiều, đừng đưa tên miền chính của công ty vào chiến dịch cold email, và xem tài liệu Troubleshooting cùng Legal and deliverability trong docs/.

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

Điểm mạnh. Bạn tự chạy trên máy mình, mã nguồn mở, không phụ thuộc bộ công cụ prospecting trả phí. Không có hoá đơn API mô hình, vì dùng gói Claude hoặc ChatGPT bạn đã có. Cơ chế duyệt thủ công mặc định cùng bước kiểm tra trước khi gửi giúp bạn yên tâm hơn so với công cụ gửi tự động hoàn toàn. Bạn cũng có thể dùng từng phần, ví dụ chỉ lấy danh sách rồi xuất CSV.

Giới hạn. Cần quen terminal, Python và việc cấu hình hộp thư gửi, nên chưa phải công cụ bấm là chạy cho người hoàn toàn mới. README hướng dẫn chi tiết cho macOS; Windows có thông tin thư mục dữ liệu nhưng chưa có hướng dẫn cài riêng. Chất lượng danh sách phụ thuộc nguồn dữ liệu: nguồn mặc định là OpenStreetMap, và README chưa nói độ phủ ở từng quốc gia. Việc dùng gói đăng ký để chạy tác vụ tự động có thể ăn vào hạn mức dùng của bạn (README nói Sellbird tự hạn chế để chừa chỗ cho việc của bạn). Cold email còn có yếu tố pháp lý và uy tín tên miền, bạn phải tự chịu trách nhiệm.

Khi nên 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 host sellbird.ai (đang ở 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 gửi email cho danh sách khách hàng đã có sự đồng ý, một công cụ email marketing thông thường sẽ đơn giản hơn. Và với giấy phép AGPL-3.0, nếu bạn định biến nó thành dịch vụ cho người khác dùng, hãy đọc kỹ điều khoản giấy phép trước.

4.4/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 tải và dùng không mất phí bản quyền. Nguồn tìm doanh nghiệp mặc định là 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 khoảng 7 USD mỗi tháng cho Google Workspace).

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 hoặc Max, hoặc qua 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ụ kiểm tra email tuỳ chọn có biến API key riêng trong file .env.example.

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

README không nêu yêu cầu phần cứng, và phần suy nghĩ do Claude hoặc Codex thực hiện qua gói đăng ký của bạn. Chưa có thông tin về cấu hình máy tối thiểu.

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

README hướng dẫn chi tiết cho macOS và có bảng thư mục dữ liệu cho cả Windows (%APPDATA%\sellbird) lẫn Linux. Lệnh kích hoạt môi trường ảo trong README là kiểu macOS/Linux, và README chưa có hướng dẫn cài riêng cho Windows. Docker được nhắc là chạy được trên Linux.

Sellbird có tự gửi email lung tung không?

Mặc định thì không. Mọi email nằm chờ trong Outbox cho đến 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 không dùng mô hình để chặn merge tag chưa điền, cụm từ bị cấm, email quá dài, link thừa và địa chỉ không gửi được. Lệnh `sellbird sending pause` dừng mọi việc gửi ngay.

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 gốc trên máy bạn, gồm file .env, cơ sở dữ liệu, nhật ký và token dashboard. Dashboard chạy ở địa chỉ nội bộ 127.0.0.1. README không đưa ra cam kết bảo mật nào xa hơn; riêng file .env chứa mật khẩu và key nên bạn phải tự giữ kín.

Khác gì Harvey?

Không khác dự án: Harvey được đổi tên thành Sellbird ở phiên bản 0.4.0, giữ nguyên lịch sử. Cấu hình, dữ liệu và đăng nhập dashboard của người dùng Harvey được mang sang. Lệnh `harvey` cũ vẫn chạy tạm thời nhưng sẽ bị gỡ ở 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.Cách 1: để Claude Code cài giúp
    2. B.Cách 2: tự cài, bước 1 — tạo môi trường và cài gói
    3. C.Bước 2 — điền thông tin đăng nhập
    4. D.Bước 3 — dạy Sellbird về sản phẩm của bạn
    5. E.Bước 4 — xác nhận khách hàng tốt trông như thế nào
    6. F.Bước 5 — tìm doanh nghiệp
    7. G.Bước 6 — mở bảng điều khiển và bắt đầu 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ủ một dịch vụ địa phương muốn có danh sách khách tiềm năng
    2. B.Nhân viên sales chỉ cần danh sách để dùng công cụ khác
    3. C.Người làm outreach muốn duyệt từng email trước khi gửi
    4. D.Người đang dùng Harvey muốn chuyển sang Sellbird
  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ỏ.