# 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

> 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 thư lạnh cá nhân hoá, gửi đi và đọc phản hồi giúp bạn. Cài bằng vài lệnh trên máy của bạn, mặc định không có email nào được gửi nếu bạn chưa duyệt.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-24 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/sellbird-tu-tim-khach-gui-cold-email-bang-claude-chatgpt

Sellbird là một nền tảng mã nguồn mở giúp bạn làm outreach (gửi email chào hàng lạnh) gần như 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 rồi xử lý phản hồi. Trước đây dự án tên là Harvey, nay đổi tên thành Sellbird. Hiện repo có khoảng 5250 sao và 1127 fork.

Người nên quan tâm là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, và lập trình viên muốn có một "nhân viên bán hàng" tự động chạy ngay trên máy mình. Đặc biệt, bạn không cần trả tiền theo token cho API của mô hình AI. Sellbird dùng Claude Code CLI trên gói Claude Pro hoặc Max, hoặc Codex trên gói ChatGPT mà bạn đã có sẵn.

Điểm đáng giá nhất là chữ "duyệt". Mặc định mọi email đều nằm chờ trong Outbox cho bạn xem trước, và có bước kiểm tra tự động (không dùng mô hình AI) chặn thư lỗi trước khi gửi. Bạn xem video ngắn bên dưới để thấy tổng quan, rồi quay lại đọc phần cài đặt.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | Sellbird là nền tảng mã nguồn mở tự tìm công ty, tìm người quyết định, xác minh email, viết và gửi cold email, xử lý phản hồi, chạy trên gói Claude hoặc ChatGPT.
- stars | 5.3k
- lang | Python
- license | AGPL-3.0
```

```video
- youtube | https://youtube.com/shorts/JTq4Uz5waNI
- facebook | https://www.facebook.com/reel/2017725532236661
- title | Video giới thiệu sellbird
```

## Sellbird làm được gì

Sellbird là một dây chuyền. Bạn có thể chạy hết, hoặc dừng ở bất kỳ bước nào.

### Tìm công ty phù hợp

Sellbird 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í và không cần tài khoản. 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ông lo bị trừ tiền bất ngờ.

### Hiểu vì sao 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 AI nên không tốn gì, mỗi công ty chỉ cần ba request HTTP. Nhờ đó thư sau này có chi tiết thật, không phải câu chung chung.

### Tìm người quyết định

Sellbird 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. Ít người nhưng đúng người, đỡ làm phiền cả công ty.

### Kiểm tra địa chỉ email

Nó học quy luậ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ỉ những địa chỉ giao được mới được gửi tới. Việc này giữ tỷ lệ bounce thấp, rất quan trọng để hộp thư gửi không bị đánh dấu spam.

### Viết và gửi

Sellbird viết một chuỗi email ngắn cho từng người dựa trên những gì nó tìm được. Thư được 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ý phản hồi

Nó đọc mọi phản hồi, soạn sẵn câu trả lời, tách riêng thư trả lời 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. Bạn theo dõi mọi thứ trên dashboard.

### Chỉ muốn lấy danh sách?

Nếu bạn chỉ cần danh sách khách, dừng sau bước xác minh rồi chạy `sellbird export` để có file CSV sẵn sàng đưa vào công cụ gửi email khác.

## Cần chuẩn bị gì

Theo README, bạn cần:

- **Python 3.11 trở lên** (file pyproject.toml yêu cầu `>=3.11`). Trên macOS, máy mặc định có 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ới Claude Code CLI đã đăng nhập (`claude login`), hoặc **gói ChatGPT có Codex CLI**. Không cần API key của mô hình.
- **Một hộp thư để gửi**, tốt nhất là Google Workspace trên một tên miền gửi riêng. Microsoft 365 và SMTP cũng dùng được. README ghi Google Workspace khoảng 7 USD một tháng.
- **Warmup (làm nóng) hộp thư đó.** README gợi ý TrulyInbox, và Sellbird đọc tỷ lệ inbox của công cụ này để báo khi nào bạn sẵn sàng gửi. Lưu ý link TrulyInbox trong dự án là link affiliate, tác giả có thể nhận hoa hồng.

Về chi phí: 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 doanh nghiệp với nguồn trả phí rẻ nhất. Đọc website là 0 đồng. README không dùng Apollo, ZoomInfo, Clearbit hay Clay.

Về hệ điều hành: README có nêu thư mục dữ liệu cho macOS, Windows và Linux, và nói Docker chạy được trên Linux. Phần hướng dẫn nhanh của README viết theo cú pháp macOS/Linux. README không có hướng dẫn riêng cho Windows ở phần này, nên bạn nên xem thêm thư mục `docs/` trong repo.

File `.env.example` còn liệt kê nhiều biến cho các dịch vụ tuỳ chọn, như Gmail, SMTP/IMAP, Microsoft 365, Instantly, Reoon, ZeroBounce, Hunter, TrulyInbox… Bạn chỉ điền những gì mình thật sự dùng.

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

```steps
- Tải mã nguồn | git clone repo về máy rồi vào thư mục
- Cài đặt | Tạo môi trường ảo và cài gói sellbird
- Điền thông tin | Sao chép .env.example thành .env và điền
- Dạy Sellbird về sản phẩm | Chạy sellbird train với website của bạn
- Tìm khách | Xác nhận tín hiệu rồi chạy sellbird discover
- Mở dashboard và chạy | sellbird dashboard rồi sellbird run
```

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

### Cách dễ nhất: nhờ Claude cài giúp

Bạn cần mở terminal (trên Windows là PowerShell hoặc Git Bash, trên macOS là Terminal), chạy ba lệnh sau. Lệnh cuối mở Claude Code ngay trong thư mục dự án.

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

Sau đó gõ **"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 máy bạn, cài những gì 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. Chỗ người mới hay vấp là chạy `claude` ở sai thư mục, nên hãy chắc bạn đã `cd sellbird` rồi.

### Tự cài: tải mã nguồn và tạo môi trường

Vẫn là hai lệnh đầu ở trên để tải và vào thư mục. Sau đó tạo môi trường ảo và cài. README ghi rõ dùng `python3.13`, không dùng `python3` trần, vì trên macOS `python3` là bản 3.9.

```bash
# 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 thư mục `.venv`, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được (`pip install -e .`). Sau khi xong, bạn có lệnh `sellbird`. Dòng `source .venv/bin/activate` dành cho macOS/Linux. Nếu bạn dùng PowerShell trên Windows, lệnh kích hoạt môi trường ảo thông thường của Python là `.venv\Scripts\Activate.ps1`, đây không phải lệnh riêng của Sellbird và README không nói về nó.

### Điền thông tin vào .env

```bash
# 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 để sửa. Mỗi biến đều có chú thích ngay trong file. Hãy điền thông tin hộp thư gửi và các dịch vụ bạn dùng. Nếu bạn chưa có `$EDITOR`, cứ mở file `.env` bằng trình soạn thảo quen thuộc như Notepad hay VS Code.

```note
File .env chứa mật khẩu và khoá truy cập hộp thư của bạn. Đừng gửi nó cho ai, đừng đưa lên GitHub. Nên dùng một hộp thư riêng trên tên miền gửi riêng, không dùng hộp thư chính của công ty.
```

### Dạy Sellbird về sản phẩm của bạn

```bash
# 3. Learn your product from your website (writes sellbird.local.yaml).
sellbird train https://your-company.com
```

Thay địa chỉ bằng website thật của bạn. Sellbird đọc trang web, hiểu bạn bán gì và cho ai, rồi ghi vào file `sellbird.local.yaml`. File này là của bạn, git không đụng tới.

### Xác nhận tín hiệu và tìm khách

```bash
# 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 để bạn xác nhận thế nào là một khách tiềm năng tốt. Lệnh sau tìm doanh nghiệp bằng nguồn miễn phí mặc định, không cần tài khoản.

### Mở dashboard và khởi động vòng chạy

```bash
# 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 địa chỉ trên máy bạn (127.0.0.1:5555). Hãy mở link đó trong trình duyệt. `sellbird run` khởi động vòng lặp làm việc. Nếu bạn dùng Docker trên Linux, README có nói chạy được, chi tiết xem thư mục `docs/` và các file `Dockerfile`, `docker-compose.yml`.

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

Theo README, khi chạy `sellbird run` thành công bạn sẽ thấy màn hình dạng này (dữ liệu demo là công ty đặt lịch tên Bookwell):

```
$ 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.
```

Dấu hiệu tốt: dòng "Sellbird is online", có quyết định của vòng chạy, và email nằm chờ trong Outbox "for your approval". Sau mỗi vòng nó nghỉ 15 phút rồi lặp lại. Bạn cũng nên mở link từ `sellbird dashboard` để chắc chắn thấy giao diện. Trước đó, gõ `sellbird --help` hoặc xem README phần Configuration and commands để biết đủ các lệnh (README không chép sẵn danh sách lệnh ở trang chính).

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

### 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 cho nha khoa và tiệm sửa điều hoà. Bạn chạy `sellbird train` với website công ty, xác nhận tín hiệu bằng `sellbird signals --confirm free`, rồi `sellbird discover`. Sellbird tìm các cơ sở phù hợp trên OpenStreetMap, đọ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ể để họ cần bạn, thay vì danh sách mua đại trà.

> Sellbird không cố gửi nhiều nhất, nó cố gửi đúng người và chờ bạn gật đầu.
>
> — Ông T

### Người làm sales chỉ cần danh sách để gửi bằng công cụ khác

Nếu bạn đã có công cụ gửi email riêng, hãy dừng sau bước xác minh. Chạy `sellbird export` để xuất file CSV những người đã tìm được cùng nhãn email (verified, risky, guess, invalid). Bạn lọc lấy các địa chỉ giao được rồi nạp vào công cụ của mình. Đây là cách dùng nhẹ nhất, hợp với người chưa sẵn sàng để phần mềm tự gửi.

### Duyệt thư và xử lý phản hồi hằng ngày

Sau khi `sellbird run` chạy, mở dashboard và vào Outbox. Mỗi email được viết riêng cho từng người, ví dụ chuỗi hai email nhắm tới một tiệm HVAC đang tuyển nhân viên điều phối. Bạn đọc, sửa nếu cần rồi duyệt. Khi có người trả lời, Sellbird soạn sẵn câu đáp cho trường hợp "quan tâm" hay "phản đối", còn thư trả lời tự động bị tách ra. Bạn chỉ cần xem những ca nó giao lại cho bạn. Cần dừng khẩn cấp thì chạy `sellbird sending pause`, mọi thứ ngừng ngay.

### Lập trình viên mới muốn cài mà không đọc tài liệu dài

Bạn không rành terminal. Hãy `git clone`, `cd sellbird`, chạy `claude` rồi gõ "set up Sellbird for me". Claude Code đọc file `CLAUDE.md` và dẫn bạn từng bước: kiểm tra máy, cài phần còn thiếu, hỏi thông tin cần thiết. Bạn nhận được một bản Sellbird đã cấu hình xong mà không phải tự ghép từng lệnh.

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

### Python quá cũ, cài lỗi

Sellbird cần Python 3.11 trở lên. Nếu `python3 --version` báo 3.9 (thường gặp trên macOS), hãy cài bản mới như README gợi ý (`brew install python@3.13`) và dùng `python3.13` khi tạo môi trường ảo, không dùng `python3` trần.

### Gõ `sellbird` báo không tìm thấy lệnh

Thường do chưa kích hoạt môi trường ảo hoặc chưa chạy `pip install -e .`. Quay lại bước cài đặt, kích hoạt `.venv` trong cùng cửa sổ terminal rồi chạy lại. Mỗi lần mở terminal mới, bạn cần kích hoạt lại `.venv` trước khi dùng lệnh.

### Claude chưa đăng nhập

Sellbird nghĩ thông qua Claude Code CLI trên gói của bạn. Nếu CLI chưa đăng nhập, mọi bước cần mô hình sẽ không chạy được. Chạy `claude login` theo README rồi thử lại. Nếu bạn dùng ChatGPT thì xem phần hướng dẫn Codex trong `docs/`.

### Email vào spam hoặc bị trả lại nhiều

Đây là vấn đề của mọi công cụ cold email, không riêng Sellbird. Hãy dùng tên miền gửi riêng, warmup hộp thư trước khi gửi, giữ giới hạn gửi mỗi ngày thấp, và chỉ gửi tới địa chỉ "verified". README có tài liệu riêng về luật và khả năng giao thư (Legal and deliverability) trong thư mục `docs/`, bạn nên đọc trước khi gửi thật.

### Cập nhật từ Harvey bị chặn khi git pull

Nếu bạn từng sửa trực tiếp file `harvey.yaml`, lệnh `git pull` sẽ báo "your local changes would be overwritten". README hướng dẫn dùng `git stash`, `git pull`, rồi `git stash pop`. Về lâu dài, hãy đặt cấu hình riêng của bạn vào `sellbird.local.yaml`, file mà git không bao giờ đụng tới.

## Có nên dùng không

**Điểm mạnh.** Chạy trên máy của bạn, dữ liệu và cấu hình nằm trong một thư mục riêng. Không phải trả tiền theo token vì dùng gói Claude hoặc ChatGPT bạn đã có. Nguồn tìm doanh nghiệp mặc định miễn phí. Có cơ chế duyệt thư và bước kiểm tra trước khi gửi (chặn merge tag chưa điền, cụm từ bị cấm, thư quá dài, link thừa, địa chỉ không giao được). Giấy phép AGPL-3.0, và repo còn được cập nhật gần đây.

**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, nghĩa là có chi phí và thời gian chuẩn bị. Phần hướng dẫn nhanh viết theo macOS/Linux, người dùng Windows nên đọc thêm tài liệu trong repo. Giấy phép AGPL-3.0 có điều kiện riêng nếu bạn định biến nó thành dịch vụ cho người khác, nên hãy đọc kỹ file LICENSE. Dữ liệu demo trong README chỉ là ví dụ, bạn cần tự kiểm chứng chất lượng kết quả với thị trường của mình. Và cold email có quy định pháp lý khác nhau theo từng nước, README không thay thế cho tư vấn pháp lý.

**Khi nào nên chọn cách khác.** Nếu bạn không muốn tự chạy, tác giả có bản dịch vụ trên sellbird.ai (hiện ở giai đoạn truy cập sớm, tự lo giúp tên miền gửi, hộp thư và warmup). Nếu bạn chỉ gửi vài thư thủ công mỗi tuần, một công cụ mail thông thường là đủ. Còn nếu bạn muốn thử, hãy bắt đầu bằng `sellbird discover` và `sellbird export` để xem chất lượng danh sách trước, rồi mới bật gửi thật, và giữ chế độ duyệt tay càng lâu càng tốt.

## 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 không trả tiền theo token vì nó dùng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đã có. 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 doanh nghiệp. Bạn vẫn cần hộp thư gửi, ví dụ Google Workspace khoảng 7 USD một tháng theo README.

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

Không. README nói rõ không cần API key và không tính tiền theo token. Sellbird chạy qua Claude Code CLI (sau khi `claude login`) hoặc Codex CLI trên gói ChatGPT. Một số dịch vụ tuỳ chọn khác như kiểm tra email có biến key riêng trong file .env.example.

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

Mặc định thì không. Mọi email nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật autopilot. Trước khi gửi còn có bước kiểm tra không dùng mô hình AI. Bạn có thể dừng tất cả bằng lệnh `sellbird sending pause`.

### Có chạy được trên Windows không?

README liệt kê thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng phần hướng dẫn nhanh viết theo cú pháp macOS/Linux và nói Docker dùng trên Linux. README chưa ghi rõ hướng dẫn riêng cho Windows ở phần này, nên bạn xem thêm thư mục docs/ trong repo.

### 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 riêng, còn dashboard mở ở địa chỉ 127.0.0.1 với link riêng. README không nói gì thêm về mã hoá hay lưu trữ, nên hãy tự bảo vệ file .env, vì nó chứa mật khẩu hộp thư.

### Tôi chỉ muốn lấy danh sách khách, không muốn gửi thì sao?

Được. Bạn có thể dừng sau bước xác minh email rồi chạy `sellbird export` để có file CSV sẵn sàng đưa vào công cụ gửi email khác. Mỗi địa chỉ có nhãn verified, risky, guess hoặc invalid.

### Tôi đang dùng Harvey, có phải cài lại không?

Không cần. Harvey đã đổi tên thành Sellbird từ bản 0.4.0, cấu hình, dữ liệu và đăng nhập dashboard đượ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ệnh `harvey` cũ vẫn chạy tạm thời nhưng sẽ bị gỡ ở bản sau.
