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

Sellbird: 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ì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 là nền tảng mã nguồn mở chạy trên máy bạn, tự động hoá cả quy trình cold email: tìm khách hàng tiềm năng, xác minh email, viết thư, gửi và soạn nháp trả lời. Nó dùng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có nên không cần API key mô hình. Cài đặt cần Python 3.11 trở lên và vài lệnh, mặc định không email nào được gử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, giúp bạn 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.

Bạn nên xem qua nếu bạn là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, hay lập trình viên muốn tự động hoá việc tìm khách. Điểm đáng giá nhất là Sellbird chạy bằng gói Claude Pro/Max hoặc gói ChatGPT (qua Codex) bạn đã có. Bạn không cần API key mô hình và không bị tính tiền theo token. Repo hiện có khoảng 5.250 sao và 1.127 fork. Sellbird chạy ngay trên máy bạn, và mặc định không có email nào được gửi đi khi bạn chưa bấm 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

Sellbird 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 và xử lý thư trả lời, chạy bằng 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 đườ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 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, nên khó 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 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 và không tốn tiền. README nói mỗi công ty chỉ cần ba request HTTP.
  • Tìm người quyết định. Nó tìm 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. Nhờ vậy thư của bạn đến đúng người thay vì hộp thư chung.
  • Kiểm tra địa chỉ email. Sellbird học kiểu địa chỉ 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 được gửi thư tới. Việc này giúp bạn hạn chế thư bị trả về, bảo vệ uy tín tên miền gửi.
  • Viết và gửi. Nó soạn 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ý trả lời. Nó đọc mọi thư trả lời, soạn nháp câu đáp, để 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ư nó không nên tự trả lời.

Ngoài ra có hai điểm tiện:

  • Nếu bạn chỉ cần danh sách, hãy dừng sau bước kiểm tra email rồi chạy sellbird export để có file CSV dùng được với công cụ gửi thư khác.
  • Có bảng điều khiển (dashboard) chạy trên máy bạn để xem và duyệt mọi thứ.

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

Theo README, bạn cần:

  • Python 3.11 trở lên. Máy Mac thường có sẵn Python 3.9, không đủ. README gợi ý chạy brew install python@3.13 nếu python3 --version báo bản cũ.
  • Gói Claude Pro hoặc Max, và Claude Code CLI đã đăng nhập bằng lệnh claude login. Hoặc gói ChatGPT kèm Codex CLI (có hướng dẫn riêng trong tài liệu của repo, mục dùng gói ChatGPT).
  • 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 chi phí Google Workspace vào khoảng 7 đô la mỗi tháng.
  • Warmup (làm nóng) cho hộp thư đó. Tác giả giới thiệu TrulyInbox, và Sellbird đọc tỷ lệ vào hộp thư đến của nó để báo bạn khi nào đã sẵn sàng. Đây là link affiliate của người duy trì dự án, nên bạn tự cân nhắc.
  • Một số khoá tuỳ chọn trong file .env.example, ví dụ cho dịch vụ xác minh email (REOON, ZEROBOUNCE, HUNTER) hoặc Instantly. Bạn chỉ cần điền thứ mình thực sự dùng.

Về hệ điều hành, README ghi đường dẫn thư mục dữ liệu cho macOS, Windows và Linux. Tuy nhiên các lệnh cài trong README viết theo kiểu macOS/Linux (ví dụ source .venv/bin/activate). README chưa ghi riêng cách làm trên Windows, và Docker được nói là dùng trên Linux.

Cold email dính đến luật và uy tín tên miền. Hãy gửi từ tên miền riêng, làm warmup trước, và đọc tài liệu "Legal and deliverability" trong thư mục docs/ của repo trước khi gửi thật. Không dùng dữ liệu liên hệ thật khi mới thử.

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

Có hai cách: để Claude Code hướng dẫn bạn, hoặc tự gõ lệnh.

  1. Tải mã nguồnClone repo về máy và vào thư mục
  2. Chọn cách càiĐể Claude Code hướng dẫn, hoặc tự cài bằng venv
  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. Tìm khách và chạyChạy discover, mở dashboard, rồi chạy run

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

Mở terminal (Terminal trên Mac, hoặc cửa sổ dòng lệnh bạn quen dùng), chạy:

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

Lệnh đầu tải repo về, lệnh sau đưa bạn vào thư mục sellbird. Mọi lệnh phía dưới đều phải chạy trong thư mục này. Nhiều người mới vấp ở chỗ chạy lệnh ở thư mục khác nên báo không tìm thấy file.

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

Vẫn trong thư mục sellbird, gõ:

Terminal
claude

Khi Claude Code mở, bạn nói: "set up Sellbird for me". File CLAUDE.md của repo biến Claude Code thành người hướng dẫn. Nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi các thông tin cần thiết và dạy Sellbird về sản phẩm của bạn. Cách này hợp với người mới vì bạn không phải tự nhớ từng bước.

C.Hoặc tự cài bằng tay

Chạy lần lượt các lệnh sau, đúng như 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ưu ý dùng python3.13 chứ không phải python3 trên Mac. Lệnh kích hoạt này theo kiểu macOS/Linux. README chưa ghi lệnh tương ứng cho Windows.

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 .env rồi mở ra để bạn điền. Mỗi biến đều có chú thích ngay trong file. Bạn điền thông tin hộp thư (Gmail, Microsoft 365 hoặc SMTP) và các khoá dịch vụ bạn định dùng. Đừng chia sẻ file .env cho ai.

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.

Terminal
# 4. Confirm what makes a good prospect.
sellbird signals --confirm free

Bước này xác nhận những tín hiệu cho biết một công ty là khách tiềm năng tốt.

Terminal
# 5. Find businesses. The default source is free and needs no account.
sellbird discover

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

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 http://127.0.0.1:5555, chỉ mở được trên máy bạn. sellbird run khởi động vòng lặp chính. Nếu cần chạy bằng Docker trên Linux, README chỉ nói là có thể và dẫn tới tài liệu Docker trong thư mục docs/. README chính chưa ghi lệnh chạy Docker từ đầu.

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

Sau khi chạy sellbird run, bạn sẽ thấy dòng chữ kiểu "Sellbird is online", rồi chương trình kiểm tra trạng thái và đưa ra quyết định cho từng chu kỳ. README minh hoạ kết quả 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.

Con số và tên công ty của bạn sẽ khác, nhưng dấu hiệu tốt là có dòng "online", có quyết định cho chu kỳ và có email đang chờ trong Outbox. Rồi mở link từ sellbird dashboard để xem Outbox. Nếu thấy email nháp chờ duyệt mà không có email nào tự đi, nghĩa là mọi thứ đang hoạt động đúng thiết kế.

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

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

Bạn bán phần mềm đặt lịch cho tiệm nha khoa và thợ sửa điều hoà. Bạn chạy sellbird train với website của mình, rồi sellbird signals --confirm free và sellbird discover. Sellbird tìm các doanh nghiệp phù hợp trên OpenStreetMap và đọc website của họ để xem ai chưa có đặt lịch online. Kết quả là một danh sách công ty có lý do cụ thể để bạn liên hệ, không tốn tiền ở bước này.

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

Bạn đã có công cụ gửi thư riêng và chỉ cần dữ liệu. Bạn chạy pipeline đến bước kiểm tra email, rồi chạy:

Terminal
sellbird export

Bạn nhận một file CSV tương thích với công cụ gửi thư, gồm những gì Sellbird tìm được. Mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid, nên bạn lọc được các địa chỉ rủi ro trước khi nạp vào công cụ khác.

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

Ông T

C.Người làm một mình muốn gửi thư nhưng vẫn kiểm soát

Bạn chạy sellbird run, để vòng lặp tự viết chuỗi thư (ví dụ hai email nhắc tới việc công ty đang tuyển người điều phối). Các email nằm trong Outbox. Bạn mở dashboard, đọc từng thư, sửa nếu cần rồi duyệt. Trước khi gửi, bước kiểm tra không dùng mô hình sẽ loại thư còn sót thẻ 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. Nếu thấy chưa ổn, sellbird sending pause dừng mọi thứ ngay.

D.Dev muốn trả lời khách nhanh hơn

Khi khách phản hồi, Sellbird đọc thư, soạn nháp câu trả lời cho các thư quan tâm hoặc phản đối, đặt riêng thư tự động và xử lý yêu cầu từ chối ngay. Bạn chỉ phải xem những thư nó không nên tự trả lời. Với người ít thời gian, đây là phần giúp giảm việc lặp lại nhiều nhất.

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

  • Lệnh python3 --version báo 3.9 trên Mac. Python quá cũ so với yêu cầu 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, đúng như README.
  • Không có lệnh sellbird. Thường do chưa kích hoạt môi trường .venv hoặc chưa chạy pip install -e .. Mở terminal mới trong thư mục sellbird, kích hoạt lại venv rồi cài lại.
  • Claude hoặc Codex chưa đăng nhập. Sellbird dựa vào CLI đã đăng nhập. Chạy claude login với Claude, hoặc làm theo tài liệu Codex nếu dùng ChatGPT.
  • Gửi thư không được hoặc vào spam. Kiểm tra lại thông tin hộp thư trong .env, và chắc rằng hộp thư đã warmup. README khuyên dùng tên miền gửi riêng và theo dõi tỷ lệ vào hộp thư đến. Xem thêm mục Troubleshooting và Legal and deliverability trong docs/.
  • git pull bị chặn khi nâng cấp từ Harvey. README nói 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. Về lâu dài hãy đặt cài đặt trong sellbird.local.yaml, file mà git không đụng tới.

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

Điểm mạnh: chạy trên máy bạn, dùng gói Claude hoặc ChatGPT sẵn có nên không phải trả phí API mô hình. Nguồn tìm công ty mặc định miễn phí, chi phí trả phí đều hiện trước khi chạy. Mặc định mọi thư phải được bạn duyệt, lại có bước kiểm tra tự động trước khi gửi. Mã nguồn mở, có tài liệu khá đầy đủ và repo còn được cập nhật trong vài tháng gần đây.

Giới hạn:

  • Bạn vẫn cần hộp thư gửi, tên miền riêng và warmup, nên không hoàn toàn "miễn phí".
  • README chưa có hướng dẫn riêng cho Windows.
  • Chất lượng nguồn dữ liệu miễn phí phụ thuộc vào OpenStreetMap, vốn có thể thiếu doanh nghiệp ở một số nơi. README chưa nói gì về độ phủ ở Việt Nam, nên bạn nên thử nhỏ trước.
  • 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ó ràng buộc pháp lý. Hãy đọc tài liệu pháp lý trong repo và luật nơi bạn gửi.

Nếu bạn không muốn tự vận hành, README có nhắc bản host sellbird.ai (đang trong giai đoạn early access). Nếu chỉ cần gửi thư hàng loạt từ danh sách có sẵn, một công cụ gửi email thông thường sẽ đơn giản hơn. Còn nếu bạn muốn một quy trình từ tìm khách đến trả lời, do chính bạn kiểm soát, Sellbird đáng để thử.

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. Nguồn tìm công ty mặc định miễn phí, nguồn trả phí rẻ nhất khoảng 0,37 đô la cho 1.000 kết quả theo README. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT và một hộp thư gửi (README nhắc Google Workspace khoảng 7 đô la mỗi tháng).

Sellbird có cần API key của Claude hoặc OpenAI không?

Không. 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ư xác minh email thì có khoá riêng trong file .env.

Có cần GPU hay máy mạnh 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 nhận qua gói đăng ký của bạn, còn Sellbird chạy bằng Python 3.11 trở lên.

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

README có ghi thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt viết theo kiểu macOS/Linux và chưa có hướng dẫn riêng cho Windows. Docker được nói là dùng trên Linux. Bạn nên xem mục Troubleshooting 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 chờ trong Outbox cho tới khi bạn duyệt, trừ khi bạn tự bật chế độ autopilot. Bạn cũng có thể dùng lệnh `sellbird sending pause` để dừng mọi việc gửi ngay lập tức.

Dữ liệu của tôi nằm ở đâu?

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, nhật ký và token đăng nhập dashboard. Dashboard chạy ở địa chỉ 127.0.0.1 trên máy bạn. Tư liệu chưa nói chi tiết hơn về việc dữ liệu được gửi đi đâu khi bạn dùng các dịch vụ bên thứ ba.

Tôi đang dùng Harvey thì nâng cấp thế nào?

Harvey được đổi tên thành Sellbird từ bản 0.4.0, cấu hình và dữ liệu được giữ lại. Bạn chạy `git pull`, `pip install -e .` rồi `sellbird dashboard`. Lần chạy đầu Sellbird tự đổi tên các file cũ và không ghi đè file đã có tên mới.

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ễ nhất: để Claude Code cài giúp
    3. C.Hoặc tự cài bằng tay
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ cửa hàng dịch vụ muốn có danh sách khách địa phương
    2. B.Nhân viên sales chỉ cần danh sách sạch
    3. C.Người làm một mình muốn gửi thư nhưng vẫn kiểm soát
    4. D.Dev muốn trả lời khách nhanh hơn
  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ỏ.