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

Sellbird: tự tìm khách, viết và gửi cold email chạy 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, viết và gửi cold email chạy 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, xác minh email, viết thư cá nhân hoá, gửi đi và soạn sẵn câu trả lời cho phản hồi. Cài đặt ở mức trung bình: cần Python 3.11 trở lên, Claude Code CLI đã đăng nhập và một hộp thư để gửi. Mặc định không có email nào được gửi nếu bạn chưa duyệt.

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

Bạn nên xem qua repo này nếu bạn là chủ doanh nghiệp nhỏ, người làm sale hoặc marketing, hoặc lập trình viên muốn có một "nhân viên bán hàng" chạy tự động mà không phải trả tiền thuê bao cho cả bộ công cụ prospecting. Repo hiện có khoảng 5250 sao và 1127 fork trên GitHub, giấy phép AGPL-3.0, và vẫn được cập nhật trong vài tháng gần đây.

Đ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ó. Bạn không cần API key của mô hình và không bị tính tiền theo token. Thêm một điểm nữa: mặc định không email nào được gửi khi 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 thế nào, rồi quay lại đọc phần hướng dẫn.

Ứng dụng

ethanplusai/sellbird

Sellbird là nền tảng mã nguồn mở tự tìm công ty, tìm người quyết định, kiểm tra email, viết cold email và xử lý phản hồi, chạy trên gói Claude hoặc ChatGPT.

★ 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 chuỗi các bước. 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 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 thị chi phí trước khi chạy, nên không lo bị trừ tiền bất ngờ.
  • Tìm lý do họ sẽ mua. Nó đọc website của từng công ty để tìm "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 AI nên không tốn thêm chi phí. README nói mỗi công ty chỉ cần khoảng 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.
  • Kiểm tra địa chỉ email. Nó học quy luật đặt 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. Chỉ địa chỉ gửi được mới được dùng để gửi.
  • Viết và gửi. Nó viết một chuỗi email ngắn cho từng người dựa trên những gì tìm được. Email gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong hạn mức mỗi ngày và theo giờ làm việc của người nhận.
  • Xử lý phản hồi. Nó đọc từng phản hồi, soạn sẵn câu trả lời, gạt thư tự động trả lời sang một bên, tôn trọng yêu cầu ngừng 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 tiềm năng, hãy dừng sau bước xác minh rồi chạy sellbird export. Lệnh này xuất ra một file CSV sẵn sàng để nạp vào công cụ gửi mail khác.

Về chi phí, README liệt kê rõ: 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ả với 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ý bạn đã có, cộng với một hộp thư (README nêu Google Workspace khoảng 7 USD một tháng). Nó không dùng 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 ý máy Mac thường có sẵn Python 3.9, nên nếu python3 --version báo 3.9 thì cài thêm bằng brew install python@3.13.
  • Gói Claude Pro hoặc Max với Claude Code CLI đã đăng nhập (lệnh 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 chạy được.
  • Warmup (làm nóng) hộp thư. README gợi ý dịch vụ TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Sellbird đọc tỉ lệ vào inbox từ đó để báo bạn khi nào đã sẵn sàng. Lưu ý đây là liên kết affiliate của người duy trì dự án, README có nói rõ.
  • Về hệ điều hành, README hướng dẫn lệnh cho macOS và Linux, và nói chạy Docker được trên Linux. README cũng có nêu thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng phần cài nhanh chưa ghi lệnh kích hoạt môi trường ảo riêng cho Windows.

File .env.example liệt kê các biến cấu hình tuỳ chọn như thông tin Gmail, SMTP, IMAP, Microsoft 365, các dịch vụ xác minh email (Reoon, ZeroBounce, Hunter), TrulyInbox và vài dịch vụ khác. Bạn không cần điền hết. Chỉ điền những gì bạn thực sự dùng.

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

  1. Lấy mã nguồnTải repo về máy bằng git clone
  2. Tạo môi trường và càiTạo .venv 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áchXác nhận tín hiệu rồi chạy sellbird discover
  6. Bật dashboard và vòng lặpChạy sellbird dashboard và sellbird run

README đưa ra hai cách: nhờ Claude cài hộ, hoặc tự làm từng lệnh. Mình đi qua cả hai.

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

Mở terminal (Terminal trên Mac/Linux), rồi chạy ba lệnh sau. Lệnh đầu tải mã nguồn, lệnh thứ hai vào thư mục vừa tải, lệnh thứ ba mở Claude Code ngay trong thư mục đó.

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

Khi Claude Code mở lên, 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 cài đặt. Theo README, nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi những gì cần hỏi và huấn luyện Sellbird về sản phẩm của bạn. Bạn phải đã đăng nhập Claude Code trước đó (claude login).

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

Nếu muốn tự kiểm soát, làm theo từng lệnh dưới đây trong thư mục sellbird vừa clone.

Bước 1: cài đặt. Dùng python3.13 chứ đừng dùng python3 trần, vì trên macOS python3 có thể là bản 3.9 quá cũ. 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.

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

Bước 2: thêm thông tin đăng nhập. Lệnh này sao chép file mẫu thành .env và mở bằng trình soạn thảo mặc định. README nói mỗi biến đều có chú thích ngay trong file.

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

Bước 3: dạy Sellbird về sản phẩm của bạn. Thay địa chỉ bằng website công ty bạn. Lệnh này ghi kết quả vào file sellbird.local.yaml.

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

Bước 4: xác nhận thế nào là khách tiềm năng tốt.

Terminal
sellbird signals --confirm free

Bước 5: tìm doanh nghiệp. Nguồn mặc định miễn phí và không cần tài khoản.

Terminal
sellbird discover

Bước 6: mở dashboard và bắt đầu vòng lặp. Lệnh sellbird dashboard in ra một đường link riêng tới http://127.0.0.1:5555. Mở link đó trong trình duyệt để xem Outbox và các màn hình khác.

Terminal
sellbird dashboard
sellbird run

Người mới hay vấp ở hai chỗ. Một là gõ lệnh ngoài thư mục sellbird, nên hãy chắc bạn đã cd sellbird. Hai là quên kích hoạt .venv, khiến lệnh sellbird báo không tìm thấy. README chưa ghi lệnh kích hoạt môi trường ảo cho Windows, nên nếu dùng Windows, bạn nên xem thư mục docs/ và mục Troubleshooting trong repo.

Về Docker, README chỉ nói "trên Linux bạn cũng có thể chạy bằng Docker". Repo có sẵn Dockerfile và docker-compose.yml, và hướng dẫn chi tiết nằm trong tài liệu Docker ở thư mục docs/.

Sellbird gửi email thật từ hộp thư của bạn. Hãy dùng tên miền gửi riêng, làm nóng hộp thư trước, và đừng bật chế độ tự động (autopilot) khi chưa đọc kỹ các email trong Outbox. Không chia sẻ file .env cho ai, vì trong đó có mật khẩu và khoá truy cập.

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

Cách kiểm tra đơn giản nhất là chạy sellbird run. Theo README, bạn sẽ thấy dòng "Sellbird is online.", sau đó nó kiểm tra trạng thái pipeline, đưa ra quyết định (ví dụ viết chiến dịch cho các prospect mới chưa có bản nháp), liệt kê việc của từng thành phần (handler, writer, outbox) và báo "Cycle complete" rồi nghỉ 15 phút trước chu kỳ kế tiếp.

Song song đó, mở link dashboard do sellbird dashboard in ra. Nếu bạn thấy giao diện và có email đang chờ duyệt trong Outbox thì hệ thống đã chạy đúng. Nếu chưa muốn gửi gì thật, cứ để nguyên: mặc định mọi email đều nằm chờ bạn duyệt.

Bạn cũng có thể thử chỉ với phần tìm kiếm: chạy sellbird discover, rồi sellbird export để xem file CSV kết quả.

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

A.Chủ doanh nghiệp dịch vụ địa phương muốn có danh sách khách

Bạn bán phần mềm đặt lịch cho tiệm nha khoa, thợ mái nhà hoặc cửa hàng điều hoà. Bạn chạy sellbird train với website của mình, xác nhận tín hiệu "chưa có đặt lịch online", rồi chạy sellbird discover. Nguồn OpenStreetMap miễn phí sẽ trả về doanh nghiệp phù hợp. Đây cũng chính là ví dụ demo trong README (một công ty tên "Bookwell" bán đặt lịch online, dữ liệu là dữ liệu giả).

Mặc định không có email nào rời máy bạn cho tới khi bạn bấm duyệt — đó mới là chỗ khiến mình yên tâm thử.

Ông T

B.Nhân viên sale chỉ cần danh sách, không cần gửi

Bạn đã có công cụ gửi mail riêng. Bạn chạy pipeline đến bước xác minh, rồi chạy:

Terminal
sellbird export

Kết quả là một file CSV gồm công ty, người ra quyết định và địa chỉ đã được gắn nhãn. Chỉ các địa chỉ có thể gửi được mới nên đưa vào chiến dịch. Cách này giúp bạn tránh phải mua thêm công cụ tìm lead.

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

Bạn chạy sellbird run và để nó làm việc theo chu kỳ 15 phút. Mỗi lần có người mới, nó viết một chuỗi 2 email (ví dụ: nói về việc công ty đang tuyển người điều phối) và đưa vào Outbox. Bạn mở dashboard, đọc từng bản nháp, sửa hoặc duyệt. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ chặn các email còn sót merge tag chưa điền, cụm từ bị cấm, email quá dài, nhiều link thừa hoặc địa chỉ không gửi được.

D.Xử lý phản hồi mà không bị ngập thư

Khi khách trả lời, Sellbird đọc, phân loại (ví dụ quan tâm hoặc phản đối), soạn sẵn câu trả lời, và bỏ qua thư trả lời tự động. Yêu cầu ngừng nhận email được tôn trọng ngay. Việc của bạn là đọc những thư nó đánh dấu cần bạn xử lý. Nếu cần dừng mọi thứ ngay lập tức, dùng:

Terminal
sellbird sending pause

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

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

Python quá cũ. Nếu python3 --version cho ra 3.9 (hay gặp trên Mac), cài bản mới hơn bằng brew install python@3.13 và dùng python3.13 để tạo môi trường ảo, đúng như README dặn.

Claude Code chưa đăng nhập. Sellbird dùng Claude Code CLI để "suy nghĩ". Nếu chưa đăng nhập, hãy chạy claude login bằng tài khoản Pro hoặc Max rồi chạy lại. Nếu bạn dùng ChatGPT, xem tài liệu về Codex trong thư mục docs/.

git pull báo "your local changes would be overwritten" khi nâng cấp từ Harvey. Đây là trường hợp bạn đã sửa trực tiếp file harvey.yaml. README hướng dẫn chạy git stash, git pull, rồi git stash pop. Nếu gặp xung đột trong sellbird.yaml, giữ lại các dòng của bạn, xoá các dấu xung đột, rồi chạy git stash drop. Tốt hơn, hãy đặt cài đặt của bạn vào sellbird.local.yaml vì git không đụng tới file này.

Email bị vào spam hoặc tỉ lệ vào inbox thấp. Thường do hộp thư chưa được làm nóng hoặc dùng luôn tên miền chính. Hãy dùng tên miền gửi riêng, làm warmup và xem tài liệu "Legal and deliverability" của repo trước khi tăng số lượng gử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 đăng ký sẵn có nên không phải trả tiền theo token. Phần tìm công ty và đọc website có thể chạy với chi phí 0 đồng. Cơ chế duyệt trước khi gửi và bước kiểm tra trước khi gửi là điểm cộng rất lớn cho an toàn. Mã nguồn mở nên bạn có thể đọc và chỉnh sửa prompt, skill của nó.

Giới hạn. Bạn phải tự lo hộp thư gửi, tên miền và warmup. Đây là phần quyết định cold email có vào được inbox hay không, và công cụ không thay bạn làm được hết. Cài đặt cần dùng terminal, và README chưa ghi chi tiết cho Windows. Nguồn tìm miễn phí (OpenStreetMap) hợp nhất với doanh nghiệp địa phương. Nếu bạn nhắm vào thị trường khác, bạn nên đọc tài liệu Discovery để xem nguồn nào phù hợp. Ngoài ra, gửi cold email có quy định pháp lý riêng tuỳ nơi, hãy tự đọc tài liệu pháp lý của repo và quy định ở nơi bạn hoạt động.

Giấy phép. Sellbird dùng AGPL-3.0 (các bản Harvey đến 0.3.x dùng MIT). Nếu bạn định tích hợp vào sản phẩm thương mại, hãy đọc kỹ giấy phép.

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

3.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?

Phần mềm là mã nguồn mở, giấy phép AGPL-3.0. Tìm doanh nghiệp bằng nguồn mặc định và đọc website đều tốn 0 đồng. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex, một hộp thư để gửi (README nêu Google Workspace khoảng 7 USD một tháng) và có thể trả phí cho các nguồn tìm kiếm tuỳ chọn.

Có cần API key của Claude hay OpenAI không?

Không. Theo README, 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. Bạn chỉ cần đăng nhập Claude Code bằng lệnh claude login.

Có cần GPU hay máy cấu hình mạnh không?

Tư liệu không nhắc đến yêu cầu GPU hay cấu hình phần cứng. Phần suy luận chạy qua Claude Code hoặc Codex chứ không chạy mô hình cục bộ. Yêu cầu được nêu rõ là 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 là %APPDATA%\sellbird, nhưng các lệnh cài đặt trong phần cài nhanh viết cho macOS và Linux, và Docker được ghi là dùng trên 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/ và mục Troubleshooting trong repo.

Sellbird có tự gửi email mà không hỏi tôi không?

Mặc định là không. Mọi email nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật chế độ autopilot. Trước khi gửi còn có bước kiểm tra 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 thứ ngay.

Dữ liệu của tôi lưu ở đâu, có an toàn không?

README nói 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ơ sở dữ liệu, log, token dashboard nằm trong data/). Tư liệu không nói gì thêm về mức độ bảo mật ngoài điều đó, nên bạn tự giữ kỹ file .env.

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 và cấu hình, dữ liệu, đăng nhập dashboard của bạn được giữ nguyên. Bạn chạy git pull, pip install -e . một lần để có lệnh sellbird mới, rồi sellbird dashboard. Lần chạy đầu Sellbird tự đổi tên các file harvey.local.yaml và data/harvey.db sang 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.Cách dễ nhất: để Claude cài giúp
    2. B.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ủ doanh nghiệp dịch vụ địa phương muốn có danh sách khách
    2. B.Nhân viên sale chỉ cần danh sách, không cần gửi
    3. C.Người làm outreach muốn duyệt từng email trước khi gửi
    4. D.Xử lý phản hồi mà không bị ngập 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ỏ.