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

Sellbird: tự tìm khách 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 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 soạn sẵn câu trả lời khi khách phản hồi. Cài bằng vài lệnh, hoặc nhờ Claude Code hướng dẫn cài; 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ở giúp bạn làm cold email từ đầu đến cuối: tìm công ty cần thứ bạn bán, tìm người ra 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. Repo này trước đây tên Harvey, nay đổi tên thành Sellbird, vẫn là cùng một dự án và cùng lịch sử.

Người nên xem là chủ doanh nghiệp nhỏ, nhân viên kinh doanh, người làm tăng trưởng, hoặc lập trình viên muốn tự động hoá việc tìm khách mà không phải trả phí cho các công cụ prospecting đắt tiền. Sellbird chạy trên máy của bạn, không cần Apollo, ZoomInfo, Clearbit hay Clay.

Điểm đáng giá nhất: Sellbird dùng chính gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex) mà bạn đang có, nên không cần API key của mô hình và không bị tính tiền theo token. Và theo mặc định, không có email nào rời máy bạn nếu bạn chưa bấm duyệt. Hiện repo có khoảng 5.249 sao và 1.127 fork. Bạn có thể xem video ngắn bên dưới để thấy nó chạy.

Ứng dụng

ethanplusai/sellbird

Sellbird là nền tảng mã nguồn mở chạy trên máy bạn: tìm công ty, 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.

★ 5.2kPythonAGPL-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 chạy hết cả chuỗ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 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. Nhờ vậy bạn không bị “cháy ví” bất ngờ.
  • Tìm lý do họ sẽ mua: đọ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, không tốn tiền, mỗi công ty chỉ cần ba request HTTP.
  • Tìm người quyết định: lấy chủ hoặc quản lý được nêu tên trên chính 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 kiểu 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 bị gửi tới. Việc này giúp bạn tránh thư bị trả về, bảo vệ uy tín hộp thư.
  • 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, 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 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 huỷ nhận ngay lập tức, và chuyển cho bạn những thứ 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 và chạy sellbird export để có file CSV dùng được với công cụ gửi thư khác.

Về chi phí, README nêu: tìm doanh nghiệp là 0 đồng với 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. Phần viết và gửi dùng gói đăng ký của bạn cộng một hộp thư (README ước khoảng 7 USD mỗi tháng cho Google Workspace).

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 brew install python@3.13 trước.
  • Claude Pro hoặc Max với CLI đã đăng nhập (claude login), hoặc gói ChatGPT có Codex CLI. Cách dùng Codex có hướng dẫn riêng trong thư mục docs/ của repo.
  • 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) cho hộp thư đó. README giới thiệu TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Đây là liên kết affiliate, tác giả có thể nhận hoa hồng. Sellbird đọc tỉ lệ vào inbox của công cụ này để báo khi bạn đã sẵn sàng.

Tư liệu không nói về yêu cầu phần cứng hay GPU. README chỉ nhắc cài bằng Docker trên Linux là một lựa chọn. Các lệnh trong README viết cho macOS/Linux (có source .venv/bin/activate). Tư liệu không ghi lệnh riêng cho Windows, bạn xem thêm trong thư mục docs/ của repo.

Sellbird gửi email thật từ hộp thư của bạn. Đừng dùng hộp thư chính của công ty. Hãy dùng tên miền gửi riêng, warmup đầy đủ, và đọc tài liệu Legal and deliverability trong `docs/` để biết các quy định bạn phải tuân thủ ở nước người nhận.

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. 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 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áchXác nhận tín hiệu rồi chạy discover
  6. Mở bảng điều khiểnChạy dashboard và run

Có hai cách: để Claude Code cài giúp, hoặc tự làm từng lệnh. Với người mới, cách đầu dễ hơn.

A.Cách 1: nhờ Claude cài giúp

Mở terminal (trên macOS là Terminal, trên Linux là cửa sổ terminal) 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
claude

Sau khi Claude Code mở, bạn gõ “set up Sellbird for me”. File CLAUDE.md trong repo biến Claude Code thành người hướng dẫn: nó kiểm tra máy bạn, cài những gì 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. Lệnh claude chỉ chạy được khi bạn đã cài Claude Code và đăng nhập.

B.Cách 2: tự cài

Bạn vẫn clone repo và cd sellbird như trên. Sau đó làm lần lượt:

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 .

Dòng này tạo môi trường ảo tên .venv, kích hoạt nó, rồi cài Sellbird từ thư mục hiện tại. Chỗ hay vấp: phải đứng trong thư mục sellbird khi chạy, và dùng python3.13 chứ không phải python3 nếu máy bạn mặc định là Python cũ.

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 chỉ điền phần mình dùng. Ví dụ file mẫu có các biến cho 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. Không điền gì bạn không dùng.

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 trang để 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

Lệnh này để 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. Chi tiết 29 tín hiệu nằm trong tài liệu Signals ở thư mục docs/.

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

Nguồn mặc định miễn phí, 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 liên kết riêng tới http://127.0.0.1:5555, đây là địa chỉ chỉ mở được trên máy bạn. sellbird run khởi động vòng lặp tự làm việc. Mỗi chu kỳ xong nó nghỉ một lúc rồi chạy tiếp.

Trên Linux bạn cũng có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, và README có trang Docker trong docs/.

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

Sau sellbird run, bạn sẽ thấy dòng thông báo Sellbird đã online, rồi một chu kỳ in ra trạng thái, ví dụ nó quyết định viết chiến dịch cho các prospect mới, các bộ xử lý thư trả lời, bộ viết email, và số email đang chờ bạn duyệt. Cuối chu kỳ nó báo hoàn tất và nghỉ 15 phút.

Dấu hiệu cài thành công:

  • Lệnh sellbird chạy được trong terminal (không báo “command not found”).
  • sellbird dashboard in ra liên kết riêng, mở được bảng điều khiển trên trình duyệt.
  • Sau sellbird discover, bảng điều khiển có danh sách công ty.
  • Các email viết xong nằm trong Outbox chờ bạn duyệt, chưa gửi đi.

Nếu sellbird không nhận ra, thường là bạn chưa kích hoạt môi trường ảo trong cửa sổ terminal hiện tại.

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

A.Chủ doanh nghiệp nhỏ muốn tìm khách địa phương

Bạn bán phần mềm đặt lịch, và khách hợp là các tiệm nha, thợ mái nhà, tiệm đ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 doanh nghiệp, đọc website của họ để thấy ai chưa có đặt lịch online, rồi tìm chủ hoặc quản lý. Kết quả là một danh sách công ty có lý do cụ thể để bạn liên hệ, không phải danh sách mua sẵn.

Không email nào rời máy bạn nếu bạn chưa duyệt, nên bạn thử được mà không sợ gửi nhầm.

Ông T

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

Bạn đã có công cụ gửi thư riêng (sequencer) và chỉ cần danh sách khách đã kiểm tra email. Bạn chạy các bước tìm và kiểm tra, dừng sau bước verify, rồi chạy:

Terminal
sellbird export

Bạn nhận file CSV để đưa vào sequencer. Mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid, nên bạn lọc được cái đáng gửi.

C.Người làm outreach muốn duyệt từng email

Bạn mở bảng điều khiển bằng sellbird dashboard, vào Outbox, đọc từng email Sellbird viết. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ chặn email còn sót thẻ merge chưa điền, có cụm từ bị cấm, quá dài, có thêm link thừa hoặc gửi tới địa chỉ không giao được. Bạn sửa hoặc duyệt, và nếu cần dừng toàn bộ thì chạy sellbird sending pause. Kết quả là bạn giữ quyền quyết định cuối cùng với từng thư.

D.Lập trình viên đang dùng Harvey

Bạn đã chạy Harvey và muốn lên bản mới. README ghi rằng cấu hình, dữ liệu và đăng nhập bảng điều khiể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à đổi tên file dữ liệu. Nó không ghi đè file đã có tên mới. Nếu bạn từng sửa trực tiếp harvey.yaml và git pull báo lỗi, README hướng dẫn dùng git stash, git pull, git stash pop.

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

1. 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 . trong thư mục repo. Mở terminal mới, vào thư mục sellbird, kích hoạt .venv rồi cài lại.

2. Cài trên macOS báo sai phiên bản Python. macOS có sẵn Python 3.9 trong khi dự án cần 3.11 trở lên. Cài python@3.13 bằng Homebrew rồi dùng python3.13 để tạo môi trường ảo, đúng như README dặn.

3. Lệnh claude không chạy hoặc Sellbird không “suy nghĩ” được. Sellbird dựa vào Claude Code CLI đã đăng nhập (hoặc Codex). Chạy claude login và xác nhận gói Pro/Max còn hiệu lực. Nếu bạn dùng ChatGPT, xem tài liệu dùng Codex trong docs/.

4. git pull báo “your local changes would be overwritten” khi nâng cấp từ Harvey. Làm theo README: git stash, git pull, git stash pop. Nếu có xung đột trong sellbird.yaml, giữ phần của bạn, xoá dấu xung đột rồi chạy git stash drop. Cách tốt hơn là đặt thiết lập riêng vào sellbird.local.yaml, file mà git không đụng tới.

5. Email không vào được inbox hoặc gửi bị chặn. Thường là hộp thư chưa warmup hoặc tên miền gửi mới. Hãy làm nóng hộp thư trước khi gửi cold email, và xem tài liệu Legal and deliverability cùng Troubleshooting trong docs/. Nếu gặp sự cố, sellbird sending pause dừng mọi việc gửi ngay.

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 ở thư mục của bạn. Không cần API key mô hình, dùng luôn gói Claude hoặc ChatGPT sẵn có. Nguồn tìm công ty mặc định miễn phí, và chi phí của nguồn trả phí được hiện trước khi chạy. Có bước duyệt thủ công mặc định, có kiểm tra trước khi gửi, và có thể dừng ở bất kỳ bước nào để chỉ lấy danh sách.

Giới hạn: bạn vẫn cần một hộp thư gửi, nên có tên miền riêng và warmup, nên nó không phải “bấm là có khách”. Các lệnh trong README thiên về macOS/Linux, người dùng Windows cần tự tìm cách tương đương hoặc xem tài liệu. Nguồn miễn phí OpenStreetMap có thể không phủ hết ngành của bạn. Giấy phép là AGPL-3.0, bạn nên đọc kỹ nếu định dùng trong sản phẩm thương mại. Và việc gửi cold email có quy định pháp lý khác nhau theo từng nước, trách nhiệm là ở bạn.

Khi nên chọn cách khác: nếu bạn không muốn tự chạy gì, tác giả có bản hosted ở sellbird.ai (đang trong giai đoạn early access) lo sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ làm vài thư thủ công mỗi tuần, một công cụ đơn giản hơn là đủ. Còn nếu bạn muốn một quy trình tìm khách có kiểm soát, rẻ và bạn nắm được từng bước, Sellbird đáng để thử với một chiến dịch nhỏ trước.

5.0/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à README nói nguồn tìm công ty mặc định là 0 đồng, đọc website cũng 0 đồng. 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 ước khoảng 7 USD mỗi tháng cho Google Workspace). 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. Sellbird dùng Claude Code CLI trên gói Pro hoặc Max, hoặc Codex trên gói ChatGPT, nên README nói 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 (Reoon, ZeroBounce, Hunter) có biến API key riêng trong `.env.example`, nhưng đó là tuỳ chọn.

Có cần GPU không?

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

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

README ghi sẵn thư mục dữ liệu cho Windows (`%APPDATA%\sellbird`), nhưng các lệnh cài đặt trong README viết cho macOS/Linux. Tư liệu chưa có hướng dẫn cài riêng cho Windows, bạn nên xem thư mục `docs/` và trang Troubleshooting 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 đều nằm trong Outbox chờ bạn duyệt cho đến khi bạn tự bật chế độ autopilot. Trước khi gửi còn có bước kiểm tra không dùng mô hình, và lệnh `sellbird sending pause` dừng toàn bộ việc gửi.

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 của bạn. Tư liệu không nói gì thêm về các biện pháp bảo mật chi tiết ngoài việc có file SECURITY.md để báo lỗi bảo mật. Bạn cần tự giữ kín file `.env` vì nó chứa thông tin đăng nhập.

Khác gì Apollo, ZoomInfo hay Clay?

README nói Sellbird không dùng các công cụ prospecting đó. Nó tự tìm công ty, đọc website, tìm người quyết định và kiểm tra email bằng chính pipeline của mình. Tư liệu chưa có so sánh chi tiết về chất lượng dữ liệu giữa các công cụ.

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: nhờ Claude cài giúp
    2. B.Cách 2: tự cài
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ doanh nghiệp nhỏ muốn tìm khách địa phương
    2. B.Nhân viên kinh doanh chỉ cần danh sách
    3. C.Người làm outreach muốn duyệt từng email
    4. D.Lập trình viên đang dùng Harvey
  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ỏ.