# 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 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.

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

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.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | 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.
- stars | 5.2k
- 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 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).

## 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.

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

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

```steps
- Tải mã nguồn | Clone repo về máy và vào thư mục
- Cài đặt | Tạo môi trường ảo Python và cà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 discover
- Mở bảng điều khiển | Chạ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.

### 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:

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

### 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:

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

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ũ.

```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 để 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.

```bash
# 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`.

```bash
# 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/`.

```bash
# 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.

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

## 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.

## 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, 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

### 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:

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

### 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ư.

### 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:

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

## 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.

## 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.

## 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ụ.
