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

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ự độ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 outreach mã nguồn mở viết bằng Python. Nó tìm công ty phù hợp, tìm người quyết định, kiểm tra email, viết và gửi cold email rồi xử lý thư trả lời. Nó dùng gói Claude Pro/Max hoặc ChatGPT có Codex nên không cần API key mô hình. Cài đặt cần quen dòng lệnh, mặc định không email nào 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, chạy ngay trên máy của bạn, để làm trọn chuỗi việc gửi cold email bán hàng. Nó tìm các công ty có vẻ cần thứ bạn bán, tìm người ra quyết định, kiểm tra địa chỉ email, viết cho mỗi người một 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, vẫn cùng lịch sử.

Bạn nên xem repo này nếu bạn làm kinh doanh B2B (bán dịch vụ, phần mềm, giải pháp cho các công ty nhỏ như phòng khám, xưởng, cửa hàng dịch vụ) và đang mất nhiều thời gian dò danh sách khách rồi viết thư từng cái. Dev mới cũng dùng được, vì có sẵn cách để Claude Code dẫn bạn cài đặt.

Điểm đáng giá nhất là chi phí. Sellbird “suy nghĩ” qua Claude Code CLI trên gói Claude Pro hoặc Max (hoặc qua Codex trên gói ChatGPT) mà bạn đang trả. Bạn không cần API key mô hình, không bị tính tiền theo token và không phải mua các công cụ tìm khách như Apollo hay ZoomInfo. Một điểm nữa: mặc định không email nào được gửi nếu bạn chưa bấm duyệt. Bạn có thể xem video ngắn bên dưới để thấy nó chạy ra sao. Hiện repo có khoảng 5250 sao và 1127 fork.

Ứng dụng

ethanplusai/sellbird

Nền tảng mã nguồn mở chạy trên máy bạn: tìm công ty và người quyết định, kiểm tra email, viết cold email riêng từng người, gử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 chạy hết 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ó 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. Bạn không bị “cháy túi” bất ngờ.
  • Tìm lý do họ sẽ mua: đọc chính 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, 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 tiền. Nhờ vậy email của bạn có chi tiết thật để nhắc tới, thay vì câu chào chung chung.
  • Tìm người quyết định: tìm chủ hoặc quản lý được nêu tên trên các trang của chính công ty đó, tối đa hai người mỗi công ty. Bạn không bị “bắn” email vào cả đống địa chỉ.
  • Kiểm tra địa chỉ email: học mẫu email của công ty rồi kiểm tra một địa chỉ. Mỗi địa chỉ được gắn nhãn đã xác minh, rủi ro, đoán, hoặc không hợp lệ. Chỉ địa chỉ gửi được mới được gửi tới. Điều này giúp bảo vệ uy tín hộp thư gửi của bạn.
  • 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 được. Sau đó 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à trong giờ làm việc của người nhận.
  • Xử lý thư trả lời: đọc mọi thư trả lời, soạn sẵn câu trả lời, gạt thư tự động sang một bên, 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òn vài thứ đáng chú ý:

  • Chỉ lấy danh sách: nếu bạn chỉ cần danh sách khách, dừng sau bước kiểm tra email và chạy sellbird export để có file CSV sẵn sàng đưa vào công cụ gửi thư khác.
  • Hộp thư chờ duyệt (Outbox): mọi email đi ra đều nằm chờ bạn duyệt cho đến khi bạn tự bật chế độ tự động (autopilot). Trước khi gửi còn có bước kiểm tra không dùng mô hình, loại bỏ email còn sót mã điền tự động, cụm từ bị cấm, email quá dài, thừa liên kết hoặc địa chỉ không gửi được.
  • Dashboard: một trang điều khiển chạy trên máy bạn để xem và duyệt.
  • Sửa được “sổ tay bán hàng”: thư mục prompts/ và skills/ chứa các kịch bản bán hàng bạn có thể chỉnh theo ý mình.

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 Python từ 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.
  • Gói Claude Pro hoặc Max và đã đăng nhập Claude CLI bằng claude login. Hoặc gói ChatGPT có Codex CLI (README có hướng dẫn riêng cho Codex trong tài liệu 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) hộp thư đó. Tác giả gợi ý dùng 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. 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.
  • Git để tải mã nguồn về. Bạn cũng cần biết mở terminal.

Tệp .env.example liệt kê các biến cấu hình như GMAIL_CLIENT_ID, SMTP_HOST, M365_CLIENT_ID, REOON_API_KEY, HUNTER_API_KEY… Bạn không phải điền hết. Bạn chỉ điền phần ứng với dịch vụ mình dùng (hộp thư nào, công cụ kiểm tra email nào). README ghi “mỗi biến đều có chú thích ngay trong file”.

Về phần cứng, tư liệu không nói cần GPU hay cấu hình đặc biệt. Chi phí tìm công ty: nguồn mặc định là 0 đồng, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả. Hộp thư Google Workspace khoảng 7 USD mỗi tháng.

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

  1. Tải mã nguồnClone repo về máy bằng git
  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 khoá, hộp thư
  4. Dạy sản phẩmCho Sellbird đọc website của bạn
  5. ChạyXác nhận tín hiệu, tìm khách, mở dashboard và chạy vòng lặp

README đưa ra hai đường: nhờ Claude cài hộ, hoặc tự cài tay. Người mới nên thử đường thứ nhất.

A.Cách dễ nhất: nhờ Claude Code cài hộ

Mở terminal ở 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

Lệnh đầu tải mã nguồn về. Lệnh thứ hai đi vào thư mục vừa tải. Lệnh claude mở Claude Code ngay trong thư mục đó. Sau đó bạn gõ: set up Sellbird for me (hoặc diễn đạt tương tự). 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 thứ còn thiếu, hỏi những gì nó cần và “dạy” Sellbird về sản phẩm của bạn. Bạn chỉ cần trả lời các câu hỏi.

B.Tự cài tay: tạo môi trường và cài gói

Nếu muốn tự làm, vào thư mục sellbird rồi chạy lệnh sau (README viết cho macOS/Linux):

Terminal
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .

Lệnh này tạo một môi trường Python riêng tên .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được (-e). README nhấn mạnh dùng python3.13 chứ không phải python3, vì trên macOS python3 trần là bản 3.9 quá cũ. Chỗ người mới hay vấp là quên kích hoạt môi trường ảo, khiến lệnh sellbird không tìm thấy.

README chưa ghi lệnh kích hoạt môi trường ảo riêng cho Windows. Nếu bạn dùng Windows, hãy xem thư mục docs/ (mục Troubleshooting) hoặc dùng đường “nhờ Claude cài hộ” ở trên.

C.Đ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 (file thật của bạn). Lệnh sau mở nó trong trình soạn thảo mặc định. Bạn điền thông tin hộp thư và các khoá của dịch vụ kiểm tra email nếu dùng. Đừng chia sẻ file .env cho ai.

D.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 trang đó để hiểu bạn bán gì, rồi ghi kết quả vào file sellbird.local.yaml. File này của riêng bạn, git không đụng tới.

E.Xác nhận tín hiệu và tìm doanh nghiệp

Terminal
sellbird signals --confirm free
sellbird discover

Lệnh đầu giúp bạn xác nhận thế nào là một khách hàng tốt. Lệnh thứ hai 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

Terminal
sellbird dashboard          # prints a private link to http://127.0.0.1:5555
sellbird run

Lệnh dashboard in ra một liên kết riêng tư tới địa chỉ chạy trên máy bạn (http://127.0.0.1:5555). Lệnh sellbird run bắt đầu vòng lặp: kiểm tra trạng thái, viết thư, xử lý thư trả lời, rồi nghỉ 15 phút trước khi lặp lại. Nếu muốn chạy bằng Docker (README nói dùng được trên Linux), repo có Dockerfile và docker-compose.yml, xem thêm hướng dẫn Docker trong docs/.

Sellbird gửi email thật từ hộp thư của bạn. Hãy giữ chế độ mặc định (mọi thư chờ bạn duyệt) cho đến khi bạn đã đọc kỹ vài email mẫu. Cần dừng khẩn cấp thì chạy sellbird sending pause. Đừng bật autopilot khi chưa xem phần Legal and deliverability trong docs.

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

Sau khi chạy sellbird run, README cho thấy màn hình mẫu trông 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.

Dấu hiệu thành công là bạn thấy dòng “Sellbird is online”, các bước quyết định và dòng “Cycle complete”. Sau đó mở liên kết do sellbird dashboard in ra. Nếu trang dashboard mở được ở http://127.0.0.1:5555 và bạn thấy hộp thư chờ duyệt (Outbox), tức là đã chạy.

Repo cũng có dữ liệu demo bịa sẵn (công ty “Bookwell” bán đặt lịch online cho thợ lợp mái, phòng nha, tiệm điều hoà, dùng tên miền .test). Nó giúp bạn xem giao diện trước khi chạy với dữ liệu thật.

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

A.Chủ công ty phần mềm tìm khách là phòng khám nha khoa

Bối cảnh: bạn bán phần mềm đặt lịch hẹn, và khách mục tiêu là các phòng khám nhỏ chưa có đặt lịch online. Bạn chạy sellbird train với website của bạn để nó hiểu sản phẩm. Sau đó sellbird signals --confirm free để xác nhận tín hiệu như “chưa có đặt lịch online”, rồi sellbird discover để tìm phòng khám. Sellbird đọc website từng nơi, tìm chủ hoặc quản lý, kiểm tra email và soạn chuỗi thư ngắn nhắc đúng chi tiết của từng phòng khám. Kết quả: bạn mở Outbox và thấy các email đã viết sẵn, chờ bạn duyệt.

Việc khó nhất của cold email không phải gửi, mà là biết gửi cho ai và nói điều gì cho đúng.

Ông T

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

Bối cảnh: công ty bạn đã có công cụ gửi thư riêng và chỉ thiếu danh sách khách sạch. Bạn chạy các bước tìm và kiểm tra, rồi dừng lại, không cho gửi. Chạy:

Terminal
sellbird export

Bạn nhận về file CSV gồm những gì Sellbird tìm được, sẵn sàng đưa vào công cụ gửi thư (sequencer) khác. Mỗi địa chỉ đã có nhãn đã xác minh, rủi ro, đoán hoặc không hợp lệ, nên bạn dễ lọc bỏ địa chỉ xấu.

C.Người phụ trách bán hàng duyệt và trả lời thư mỗi ngày

Bối cảnh: chiến dịch đã chạy, khách bắt đầu trả lời. Bạn mở dashboard, vào Outbox để duyệt các thư mới, và xem các thư trả lời Sellbird đã đọc. Với khách quan tâm hoặc phản đối, nó đã soạn sẵn câu trả lời để bạn sửa rồi duyệt. Thư tự động trả lời được gạt sang bên, yêu cầu từ chối nhận thư được ghi nhận ngay, và những thư nó thấy không nên tự trả lời sẽ được đẩy cho bạn. Kết quả: bạn chỉ phải quyết định, không phải đọc từng thư từ đầu.

D.Dev tuỳ chỉnh giọng văn và cách bán

Bối cảnh: bạn thấy email viết ra chưa giống giọng công ty mình. Thư mục prompts/ và skills/ chứa các kịch bản bán hàng có thể sửa. Bạn chỉnh các file ở đó, và bản cài từ gói (pip/pipx) sẽ không ghi đè chỉnh sửa của bạn khi nâng cấp. Bạn cũng nên đặt các cài đặt riêng vào sellbird.local.yaml thay vì sửa sellbird.yaml gốc, để git pull không bị xung đột.

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

  • python3 --version báo 3.9 trên macOS: đó là bản mặc định quá cũ. Chạy brew install python@3.13 rồi dùng python3.13 để tạo môi trường ảo, đúng như README dặn.
  • Lệnh sellbird không được nhận ra: thường do chưa kích hoạt môi trường ảo hoặc chưa chạy pip install -e .. Kích hoạt lại .venv trong thư mục dự án rồi cài lại.
  • Claude chưa đăng nhập: Sellbird dựa vào Claude Code CLI đã đăng nhập. Chạy claude login và đảm bảo gói của bạn là Pro hoặc Max (hoặc dùng Codex với gói ChatGPT).
  • Thư không vào hộp thư chính của khách: hộp thư mới chưa được warmup dễ rơi vào spam. README khuyên warmup hộp thư trước khi gửi và dùng một tên miền gửi riêng. Đừng gửi hàng loạt ngay từ đầu.
  • Nâng cấp từ Harvey và git pull báo “your local changes would be overwritten”: làm theo README: chạy git stash, git pull, rồi git stash pop. Nếu có xung đột trong sellbird.yaml, giữ các dòng của bạn, xoá dấu xung đột rồi chạy git stash drop. Tốt nhất là đặt cài đặt vào sellbird.local.yaml từ đầu.

Còn các lỗi khác, xem mục Troubleshooting trong thư mục docs/ của repo, hoặc file SUPPORT.md.

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 và không bị tính tiền theo token. Mặc định mọi thư chờ bạn duyệt, lại có bước kiểm tra trước khi gửi. Mỗi lần tìm trả phí đều hiện giá trước khi chạy. Giấy phép AGPL-3.0, repo vẫn được cập nhật trong vài tháng gần đây.

Giới hạn: bạn vẫn cần quen dòng lệnh, có gói Claude Pro/Max (hoặc ChatGPT có Codex) và một hộp thư gửi riêng được warmup. README chưa ghi hướng dẫn riêng cho Windows trong phần cài đặt. Bạn cũng phải tuân thủ quy định về gửi email thương mại ở nơi bạn và người nhận sinh sống. README có một mục Legal and deliverability để bạn đọc kỹ. Giấy phép AGPL-3.0 cũng đáng đọc kỹ nếu bạn định sửa đổi rồi cung cấp thành dịch vụ cho người khác.

Khi nên chọn cách khác: nếu bạn không muốn tự cài và tự vận hành, tác giả có bản chạy sẵn trên sellbird.ai (đang trong giai đoạn truy cập sớm). Nếu bạn chỉ gửi vài thư mỗi tuần cho khách quen, một công cụ gửi thư thông thường là đủ. Còn nếu bạn bán cho các doanh nghiệp nhỏ và muốn tự động hoá từ tìm khách đến trả lời mà vẫn kiểm soát được từng thư, Sellbird rất đáng thử.

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 miễn phí, giấy phép AGPL-3.0. Bạn cần gói Claude Pro/Max hoặc gói ChatGPT có Codex đang có sẵn, cùng một hộp thư gửi (README nhắc Google Workspace khoảng 7 USD mỗi 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. Sellbird dùng Claude Code CLI trên gói Claude Pro hoặc 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ụ phụ như kiểm tra email có biến khoá riêng trong .env, nhưng bạn chỉ điền khi dùng.

Có cần GPU không?

Tư liệu không nói cần GPU hay cấu hình phần cứng đặc biệt. Phần suy nghĩ chạy qua Claude Code hoặc Codex, 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 phần Quick start viết cho macOS/Linux. README chưa ghi lệnh kích hoạt môi trường ảo cho Windows. Bạn nên xem thư mục docs/ hoặc nhờ Claude Code cài hộ.

Sellbird có tự gửi email mà tôi không biết không?

Không, mặc định mọi email chờ trong Outbox cho đến khi bạn duyệt. Chỉ khi bạn tự bật autopilot thì thư mới tự đi, và dù vậy nó vẫn giữ lại thư có liên kết tới tên miền không phải của bạn. 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 có an toàn không?

Sellbird chạy trên máy của bạn, cấu hình, dữ liệu và cơ sở dữ liệu nằm trong một thư mục riêng của bạn. Dashboard mặc định chạy ở địa chỉ nội bộ 127.0.0.1. Tư liệu không nói thêm về mô hình bảo mật khác, nếu cần hãy đọc SECURITY.md trong repo.

Sellbird khác gì bản trên sellbird.ai?

Repo này là bản mã nguồn mở bạn tự chạy. Theo README, sellbird.ai là bản lưu trữ sẵn, có sẵn tên miền gửi, hộp thư và warmup, đang trong giai đoạn truy cập sớm. Tư liệu chưa có thông tin chi tiết hơn về giá hay tính năng của bản đó.

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 dễ nhất: nhờ Claude Code cài hộ
    2. B.Tự cài tay: tạo môi trường và cài gói
    3. C.Điền thông tin đăng nhập
    4. D.Dạy Sellbird về 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
  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ìm khách là phòng khám nha khoa
    2. B.Nhân viên kinh doanh chỉ cần danh sách để dùng công cụ khác
    3. C.Người phụ trách bán hàng duyệt và trả lời thư mỗi ngày
    4. D.Dev tuỳ chỉnh giọng văn và cách bá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ỏ.