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

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/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. Nó tìm công ty phù hợp, tìm người ra 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ó thay vì API key. Cài bằng Python 3.11 trở lên, khá dễ nếu bạn quen terminal; mặc định mọi email đều chờ bạn duyệt mới gửi.

Sellbird là một nền tảng mã nguồn mở chạy trên máy của bạn, giúp 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ý thư trả lời. Trước đây dự án tên là Harvey, nay đổi tên thành Sellbird, vẫn là cùng một dự án và cùng lịch sử.

Repo này hợp với chủ shop, người làm kinh doanh, nhân viên sales nhỏ lẻ hoặc lập trình viên muốn tự động hoá việc tìm khách B2B mà không phải trả thêm tiền cho các công cụ prospecting như Apollo, ZoomInfo, Clearbit hay Clay. Theo README, Sellbird không dùng các công cụ đó.

Điểm đáng giá nhất có hai ý. Một: nó chạy bằng gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex), nên không có API key mô hình và không bị tính tiền theo token. Hai: mặc định không có 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. Bạn có thể xem video ngắn bên dưới để thấy nó chạy ra sao.

Ứng dụng

ethanplusai/sellbird

Sellbird là nền tảng mã nguồn mở tự 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 đ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 đường ống (pipeline). Bạn có thể chạy hết từ đầu đến cuối, hoặc dừng ở bất kỳ bước nào.

  • Tìm công ty. Nó tìm các doanh nghiệp khớp với 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 có trả phí đều hiện chi phí trước khi chạy. Lợi ích: bạn không bị bất ngờ về tiền.
  • Tìm lý do họ sẽ mua. Nó đọ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, nên không tốn gì. Lợi ích: thư của bạn có lý do cụ thể để liên hệ, không phải thư chung chung.
  • Tìm người quyết định. Nó tìm chủ hoặc quản lý được nêu tên ngay 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. Nó 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, và chỉ địa chỉ gửi được mới được gửi 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. Nó viết một chuỗi thư 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, trong giới hạn gửi mỗi ngày và giờ làm việc của người nhận.
  • Xử lý thư trả lời. Nó đọc mọi thư trả lời, soạn sẵn câu trả lời, tách riêng thư tự động trả lời, 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ư nó không nên tự trả lời.

Nếu bạn chỉ cần danh sách, hãy dừng sau bước kiểm tra email và chạy sellbird export để có file CSV sẵn cho công cụ gửi thư khác.

Về chi phí, README nêu: tìm doanh nghiệp là 0 đồng trên nguồn mặc định, hoặc khoảng 0,37 USD cho 1.000 kết quả trên nguồn trả phí rẻ nhất. Đọc website là 0 đồng (ba request HTTP mỗi công ty, không gọi mô hình). Phần viết và gửi dùng gói đăng ký của bạn và một hộp thư (README nói Google Workspace khoảng 7 USD một tháng).

II.Cần chuẩn bị gì

Theo README và file cấu hình của repo, bạn cần:

  • Python 3.11 trở lên. 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.
  • Một trong hai gói AI: Claude Pro hoặc Max với Claude Code CLI đã đăng nhập 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.
  • Warmup (làm nóng) hộp thư đó. README giới thiệu TrulyInbox cho việc này. Lưu ý: các liên kết TrulyInbox trong dự án là liên kết affiliate, người duy trì có thể nhận hoa hồng. Đây không phải điều bắt buộc, nhưng README nhấn mạnh cần có warmup.

File .env.example liệt kê các biến cấu hình tuỳ chọn. Bạn chỉ điền cái nào mình dùng: thông tin Gmail (GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET), SMTP/IMAP, Microsoft 365, và các dịch vụ kiểm tra email như Reoon, ZeroBounce, Hunter. README nói mỗi biến đều có chú thích ngay trong file.

Về hệ điều hành: README nhắc tới macOS, Linux và Windows (khi nói về thư mục dữ liệu), và nói thêm trên Linux có thể chạy bằng Docker. README chưa ghi lệnh kích hoạt môi trường ảo riêng cho Windows, bạn cần tự xem cách của Python.

Bạn sẽ điền mật khẩu hộp thư, key dịch vụ vào file .env. Đừng đưa file này lên GitHub hay gửi cho người khác. Nên dùng tên miền và hộp thư gửi riêng, không dùng hộp thư chính của công ty.

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

Có hai cách: để Claude Code dẫn bạn cài, hoặc tự gõ lệnh. Với người mới, cách đầu thường dễ hơn.

  1. Tải mã nguồnClone repo về máy và vào thư mục
  2. Cài đặtTạo môi trường ảo Python và cài gói sellbird
  3. Điền thông tinSao chép .env.example thành .env rồi điền
  4. Dạy Sellbird về sản phẩmChạy sellbird train với website của bạn
  5. Chọn tín hiệu và tìm kháchChạy signals và discover
  6. Mở bảng điều khiểnChạy dashboard rồi run

A.Tải mã nguồn về máy

Mở terminal (PowerShell hoặc Terminal), đi 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

Lệnh đầu tải mã nguồn về, lệnh thứ hai đi vào thư mục vừa tải. Mọi lệnh sau đều phải chạy trong thư mục sellbird này, đây là chỗ người mới hay quên.

B.Cách dễ: để Claude Code cài giúp

Trong thư mục sellbird, chạy:

Terminal
claude

Rồi nhắn: “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: nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi thông tin cần thiết và huấn luyện Sellbird về sản phẩm của bạn. Nếu cách này ổn thì bạn có thể bỏ qua các bước tự làm bên dưới.

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

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 vào đó. Dòng source .venv/bin/activate dùng cho macOS/Linux. README chưa ghi lệnh tương đương cho Windows. Nếu bạn dùng Windows, hãy xem tài liệu Python về môi trường ảo, hoặc dùng cách để Claude Code cài giúp ở trên.

D.Điền thông tin đăng nhập

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ở ra để sửa. Điền thông tin hộp thư gửi và các key dịch vụ bạn định dùng. Biến nào không dùng thì cứ để nguyên.

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

Thay địa chỉ bằng website công ty bạn. Sellbird đọc site để hiểu bạn bán gì, rồi ghi kết quả vào sellbird.local.yaml. File này git không đụng tới, nên bạn có thể chỉnh sửa thoải mái.

F.Chọn tín hiệu và tìm khách

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

Lệnh đầu 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. Lệnh thứ hai tìm doanh nghiệp bằng nguồn mặc định, miễn phí và không cần tài khoản.

G.Mở bảng điều khiển 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 dẫn riêng tới địa chỉ http://127.0.0.1:5555 trên máy bạn. Mở link đó bằng trình duyệt. Sau đó sellbird run khởi động vòng lặp làm việc.

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

Khi chạy sellbird run, README cho thấy kết quả mẫu như sau:

Code
$ sellbird run

============================================================
Sellbird is online.
============================================================
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
  handler   → Elena Park, Harbor Dental Studio     interested, answer drafted
  handler   → Priya Nair, Highline Roofing         objection, answer drafted
  writer    → 2-email sequence: Phoenix HVAC hiring a dispatcher
  outbox    → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.

Bạn sẽ thấy dòng “Sellbird is online”, rồi các bước xử lý, và cuối cùng là các email đang chờ duyệt trong Outbox. Dữ liệu trong ví dụ là dữ liệu giả của README. Của bạn sẽ khác.

Một dấu hiệu nữa là mở được bảng điều khiển ở http://127.0.0.1:5555 bằng link riêng mà lệnh sellbird dashboard in ra. Nếu thấy hàng đợi email trong Outbox thì bạn đã cài thành công. README cũng nói Sellbird đọc tỷ lệ inbox từ TrulyInbox để cho bạn biết khi nào hộp thư đã sẵn sàng gửi, nhưng chỉ khi bạn dùng dịch vụ đó.

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

Phần nào cũng nên bắt đầu bằng việc duyệt tay trong Outbox. Dưới đây là vài tình huống bám đúng khả năng README mô tả.

A.Chủ công ty dịch vụ nhỏ tìm khách địa phươ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, rồi sellbird signals --confirm free để chọn tín hiệu như “chưa có đặt lịch online”, sau đó sellbird discover để tìm phòng khám trên nguồn miễn phí. Sellbird đọc website từng phòng khám, tìm chủ phòng, kiểm tra email và viết một chuỗi thư ngắn nhắc đúng điều nó thấy trên site họ. Kết quả: một hàng đợi thư cá nhân hoá đang chờ bạn duyệt, thay vì danh sách chung chung.

Không có email nào ra khỏi máy bạn nếu bạn chưa bấm duyệt.

Ông T

B.Nhân viên sales chỉ cần danh sách

Bạn đã có công cụ gửi thư riêng và chỉ cần một danh sách khách tiềm năng đã được kiểm tra. Bạn chạy từ sellbird discover đến bước kiểm tra email, rồi dừng và chạy:

Terminal
sellbird export

Kết quả là file CSV sẵn để đưa vào công cụ gửi thư của bạn. Mỗi địa chỉ đã có nhãn verified, risky, guess hoặc invalid, nên bạn lọc được địa chỉ đáng gửi.

C.Người làm một mình, cần trả lời thư nhanh

Sau khi gửi, khách trả lời “quan tâm” hoặc “giá hơi cao”. Sellbird đọc từng thư, soạn sẵn câu trả lời, bỏ riêng thư tự động trả lời, và xử lý ngay yêu cầu 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 trên bảng điều khiển. Kết quả: bạn chỉ phải đọc và duyệt thay vì viết từ đầu.

D.Lập trình viên muốn tuỳ biến cách viết thư

Theo README, thư mục prompts/ và skills/ là các kịch bản bán hàng có thể chỉnh sửa. Bạn sửa chúng để đổi giọng văn hoặc cách tiếp cận. Chi tiết nằm ở tài liệu Skills and sub-agents trong thư mục docs/ của repo.

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

  • python3 --version báo 3.9 (thường trên macOS). README nói rõ cần Python 3.11 trở lên. Cài bản mới bằng brew install python@3.13 rồi dùng python3.13 khi tạo môi trường ảo.
  • Gõ sellbird báo không tìm thấy lệnh. Rất có thể bạn chưa kích hoạt môi trường ảo hoặc chưa chạy pip install -e .. Hãy đảm bảo bạn đang ở thư mục sellbird và môi trường ảo đã bật, rồi cài lại.
  • Thiếu đăng nhập Claude hoặc Codex. Sellbird dùng Claude Code CLI hoặc Codex trên gói của bạn. Hãy chạy claude login để đăng nhập trước. Với Codex, xem tài liệu Using a ChatGPT plan (Codex) trong repo.
  • Dùng Docker trên máy không phải Linux. README chỉ nói Docker dùng được trên Linux. Nếu bạn dùng Windows hoặc macOS, nên cài theo cách Python ở trên.
  • git pull báo “your local changes would be overwritten” khi nâng cấp từ Harvey. Đây là lỗi nếu bạn từng sửa trực tiếp file harvey.yaml. README hướng dẫn chạy git stash, git pull, git stash pop. Tốt hơn, hãy để thiết lập của bạn trong sellbird.local.yaml, file mà git không đụng tới.

Nếu gặp lỗi khác, xem tài liệu Troubleshooting trong thư mục docs/ của repo. Muốn dừng ngay mọi thứ, chạy sellbird sending pause.

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

Điểm mạnh. Chạy trên máy của bạn, dùng gói Claude hoặc ChatGPT sẵn có, không có hoá đơn API mô hình. Nguồn tìm khách mặc định miễn phí. Mọi thư chờ bạn duyệt trước khi gửi, và trước khi gửi còn có bước kiểm tra không dùng mô hình: chặn thẻ ghép chưa điền, cụm từ bị cấm, thư quá dài, thêm link và địa chỉ không gửi được. Ngay cả khi bạn bật chế độ tự động (autopilot), nó vẫn giữ lại thư có link tới tên miền không phải của bạn.

Giới hạn. Bạn vẫn cần một hộp thư gửi tốt, nên có tên miền riêng và warmup, nếu không thư dễ rơi vào spam. Cài đặt cần quen terminal, và README chưa ghi lệnh kích hoạt môi trường ảo cho Windows. Giấy phép là AGPL-3.0 (các bản Harvey đến 0.3.x dùng MIT), nên nếu bạn định tích hợp vào sản phẩm của mình hãy đọc kỹ điều khoản. Ngoài ra, cold email có quy định pháp lý riêng, README có tài liệu Legal and deliverability để bạn đọc trước khi gửi.

Khi nào chọn cách khác. Nếu bạn không muốn tự vận hành, README nói có bản hosted tại 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ỉ gửi vài email thủ công mỗi tuần, một công cụ đơn giản hơn có lẽ là đủ.

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 và nguồn tìm doanh nghiệp mặc định là 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 một tháng). Nguồn tìm 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 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 mô hình và không tính tiền theo token. Một số dịch vụ tuỳ chọn như kiểm tra email có biến key riêng trong file .env.example.

Có cần GPU không?

Tư liệu không nhắc đến yêu cầu GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhận qua gói đăng ký của bạn, và yêu cầu nêu rõ chỉ là Python 3.11 trở lên.

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

README có nhắc thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng chưa ghi lệnh kích hoạt môi trường ảo cho Windows. Docker được nói là dùng được trên Linux. Cách an toàn là để Claude Code dẫn cài hoặc xem thêm các tài liệu trong thư mục docs/ của repo.

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 đến khi bạn duyệt, trừ khi bạn tự bật autopilot. Lệnh sellbird sending pause dừng mọi thứ ngay lập tức.

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

Sellbird chạy trên máy của bạn, cấu hình, kiến thức và dữ liệu nằm trong một thư mục home. Bảng điều khiển chạy ở địa chỉ 127.0.0.1 trên máy bạn. Tư liệu chưa nêu chi tiết hơn về bảo mật, nên hãy xem SECURITY.md trong repo.

Tôi đang dùng Harvey thì sao?

Cấu hình, dữ liệu và đăng nhập bảng điều khiển của bạn được giữ lại. Chạy git pull, rồi pip install -e . một lần để có lệnh sellbird mới. Lệnh harvey vẫn dùng được 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.Tải mã nguồn về máy
    2. B.Cách dễ: để Claude Code cài giúp
    3. C.Cách tự làm: cài gói
    4. D.Điền thông tin đăng nhập
    5. E.Dạy Sellbird về sản phẩm của bạn
    6. F.Chọn tín hiệu và tìm khách
    7. G.Mở bảng điều khiển 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 dịch vụ nhỏ tìm khách địa phương
    2. B.Nhân viên sales chỉ cần danh sách
    3. C.Người làm một mình, cần trả lời thư nhanh
    4. D.Lập trình viên muốn tuỳ biến cách viết thư
  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ỏ.