# 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

> Sellbird (trước đây là 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à soạn sẵn câu trả lời. Cài bằng vài lệnh, dùng gói Claude Pro/Max hoặc ChatGPT có Codex thay vì API key, và mặc định không gửi gì khi bạn chưa duyệt.

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

Sellbird là nền tảng outreach mã nguồn mở, chạy ngay trên máy của bạn. Nó làm cả chuỗi việc bán hàng chủ động bằng email: 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 từng thư cá nhân hoá, gửi đi và xử lý thư trả lời. Trước đây dự án tên là Harvey, nay đổi tên nhưng giữ nguyên lịch sử. Hiện có khoảng 5250 sao và 1127 fork trên GitHub.

Bạn nên xem qua nếu bạn làm kinh doanh dịch vụ cho doanh nghiệp (agency, phần mềm, dịch vụ tại chỗ), hoặc là người làm sales muốn tự động hoá khâu tìm khách mà không trả thêm tiền cho các công cụ prospecting. Lập trình viên mới cũng cài được, vì repo có sẵn một cách để Claude Code dẫn bạn cài từng bước.

Điểm đáng giá nhất là chi phí và sự an toàn. Sellbird “suy nghĩ” qua Claude Code CLI trên gói Claude Pro hoặc Max của bạn (hoặc Codex trên gói ChatGPT), nên không cần API key và không tính tiền theo token. Và theo mặc định, không có email nào rời khỏi máy khi bạn chưa duyệt. Bạn có thể xem video ngắn bên dưới để thấy nó chạy thế nào.

```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, xử lý trả lời.
- 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 đường ống (pipeline). Bạn chạy trọn từ đầu đến cuối, hoặc dừng ở bước nào cũng được.

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

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í 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. Nhờ vậy bạn không bị “cháy túi” bất ngờ.

### Hiểu vì sao họ sẽ mua

Sellbird đọc website của từng công ty để tìm những 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, không tốn phí, chỉ mất ba request HTTP cho mỗi công ty. Thư viết ra sau đó nhờ vậy có chi tiết thật để nhắc tới.

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

Nó tìm chủ hoặc quản lý được nêu tên ngay trên các trang của công ty đó, tối đa hai người mỗi công ty. Bạn không phải mua thêm cơ sở dữ liệu liên hệ.

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

Sellbird 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: verified, risky, guess hoặc invalid. Chỉ địa chỉ gửi được mới được gửi thư. Việc này giúp giảm thư trả về, một lý do chính khiến hộp thư gửi bị đánh dấu spam.

### Viết và gửi

Với mỗi người, nó viết một chuỗi email ngắn dựa trên những gì đã tìm thấy. 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ý thư trả lời

Nó đọc mọi thư trả lời, soạn sẵn câu đáp, tách riêng thư tự động, tôn trọng yêu cầu từ chối nhận ngay lập tức, và chuyển cho bạn những thư nó không nên tự trả lời.

### Chỉ cần danh sách

Nếu bạn chỉ muốn danh sách khách, hãy dừng sau bước kiểm tra email rồi chạy `sellbird export` để ra file CSV dùng được cho công cụ gửi thư 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 đúng mức này. 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**, đã đăng nhập Claude CLI bằng `claude login`. Hoặc **gói ChatGPT có Codex CLI** (repo có tài liệu riêng cho Codex).
- **Một hộp thư để gửi.** Lý tưởng là 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ư đó.** Tác giả gợi ý TrulyInbox. README cũng ghi rõ link TrulyInbox là link affiliate, người duy trì dự án có thể nhận hoa hồng, bạn không trả thêm.

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. Hộp thư Google Workspace khoảng 7 USD mỗi tháng. Phần còn lại là gói thuê bao bạn đã có.

Tư liệu không nêu yêu cầu về phần cứng (GPU, RAM) hay hệ điều hành bắt buộc. README có nhắc thư mục dữ liệu cho cả macOS, Windows và Linux.

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

```steps
- Chuẩn bị | Có Python 3.11+, Claude CLI đã đăng nhập, một hộp thư để gửi
- Tải mã nguồn | Dùng git clone rồi vào thư mục sellbird
- Cài đặt | Tạo môi trường ảo và chạy pip install -e .
- Điền thông tin | Sao chép .env.example thành .env rồi điền
- Dạy và tìm khách | Chạy train, signals, discover
- Mở bảng điều khiển | Chạy dashboard và run
```

README đưa ra hai cách: nhờ Claude cài hộ, hoặc tự làm. Mình khuyên người mới thử cách đầu.

### Tải mã nguồn về máy

Mở terminal (macOS/Linux: Terminal; Windows: PowerShell). Chạy lệnh dưới đây. Lệnh đầu tải repo về, lệnh thứ hai đi vào thư mục vừa tải.

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

### Cách A: để Claude cài giúp

Trong thư mục `sellbird`, gõ `claude` để mở Claude Code.

```bash
claude
```

Sau đó nói: **“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 bạn đang ở đâu, cài phần còn thiếu, hỏi thông tin cần thiết và “dạy” Sellbird về sản phẩm của bạn. Chỗ dễ vấp: bạn phải mở `claude` đúng trong thư mục `sellbird`, nếu không nó sẽ không đọc được `CLAUDE.md`.

### Cách B: tự cài, bước 1 — tạo môi trường và cài gói

Lệnh dưới đây chép nguyên từ README. Nó tạo môi trường ảo `.venv`, kích hoạt, rồi cài Sellbird ở chế độ chỉnh sửa được.

```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ưu ý: `source .venv/bin/activate` là lệnh cho macOS/Linux. README chưa ghi lệnh riêng cho Windows. Trên Windows PowerShell, cách kích hoạt môi trường ảo Python thông thường là `.venv\Scripts\Activate.ps1`. Nếu gặp khó, hãy dùng Cách A hoặc xem phần Docker/Troubleshooting trong thư mục `docs/`. README cũng nói trên Linux có thể chạy bằng Docker.

### Bước 2 — điền thông tin đăng nhập

```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. Nếu `$EDITOR` không mở được gì, cứ mở file `.env` bằng trình soạn thảo quen thuộc. Mỗi biến đều có chú thích ngay trong file. Các nhóm biến có trong `.env.example` gồm: Gmail (`GMAIL_CLIENT_ID`, `GMAIL_CLIENT_SECRET`), SMTP/IMAP, Microsoft 365, các dịch vụ kiểm tra email (Reoon, ZeroBounce, Hunter), TrulyInbox và vài dịch vụ khác. Bạn chỉ điền phần mình dùng, không cần điền hết.

### Bước 3 và 4 — 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

# 4. Confirm what makes a good prospect.
sellbird signals --confirm free
```

Lệnh đầu đọc website công ty bạn để hiểu bạn bán gì, rồi ghi kết quả vào `sellbird.local.yaml`. Hãy thay `https://your-company.com` bằng website thật của bạn. Lệnh thứ hai xác nhận những tín hiệu cho thấy một khách tiềm năng tốt.

### Bước 5 và 6 — tìm khách và chạy

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

# 6. Open the dashboard and start the loop.
sellbird dashboard          # prints a private link to http://127.0.0.1:5555
sellbird run
```

`sellbird discover` dùng nguồn miễn phí, không cần tài khoản. `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). `sellbird run` khởi động vòng lặp chính. Bạn nên mở hai cửa sổ terminal: một cho dashboard, một cho run.

```note
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 warmup trước, và đọc tài liệu “Legal and deliverability” trong thư mục docs/ để biết quy định gửi thư lạnh ở nơi bạn kinh doanh. File .env chứa mật khẩu và key, đừng gửi hay đưa lên mạng.
```

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

Cách nhanh nhất là chạy `sellbird run`. README minh hoạ kết quả mong đợi là dòng “Sellbird is online”, rồi các bước như kiểm tra trạng thái pipeline, quyết định việc tiếp theo (ví dụ viết chiến dịch cho prospect mới), và dòng “Cycle complete” cùng thông báo nghỉ 15 phút trước vòng tiếp theo. Một số email nằm chờ trong Outbox để bạn duyệt.

Bạn cũng có thể chạy `sellbird dashboard`, mở link nó in ra và xem có thấy Outbox, danh sách công ty và người liên hệ hay không. Nếu lệnh `sellbird` báo không tìm thấy, thường là môi trường ảo chưa được kích hoạt hoặc `pip install -e .` chưa chạy xong.

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

### Chủ dịch vụ tại chỗ muốn có khách B2B mới

Bạn bán phần mềm đặt lịch cho tiệm nha, thợ mái nhà hay cửa hàng điều hoà, giống ví dụ “Bookwell” trong README. Bạn chạy `sellbird train` với website của mình, `sellbird signals --confirm free` để chốt tín hiệu như “chưa có đặt lịch online”, rồi `sellbird discover`. Kết quả là danh sách doanh nghiệp phù hợp, kèm lý do họ có thể cần sản phẩm của bạn, mà chưa tốn đồng nào ở nguồn mặc định.

### Người làm sales chỉ cần danh sách để dùng công cụ khác

Bạn đã có công cụ gửi thư riêng và chỉ cần dữ liệu. Chạy pipeline đến bước kiểm tra email rồi xuất file:

```bash
sellbird export
```

Bạn nhận một file CSV sẵn sàng đưa vào công cụ gửi thư, gồm những gì Sellbird đã tìm được. Mỗi địa chỉ đã có nhãn verified, risky, guess hoặc invalid để bạn lọc.

> Sellbird chạy bằng gói thuê bao bạn đang có, và không có gì được gửi đi khi bạn chưa gật đầu.
>
> — Ông T

### Người bán hàng duyệt thư mỗi sáng

Sau khi `sellbird run` chạy, các thư viết xong nằm trong Outbox chờ bạn. Bạn mở dashboard, đọc từng thư, sửa hoặc duyệt. Trước khi thư rời đi, một bước kiểm tra không dùng mô hình sẽ loại thư còn sót thẻ merge chưa điền, cụm từ bị cấm, thư quá dài, thừa link hoặc địa chỉ không gửi được. Kết quả: bạn kiểm soát được từng thư, chỉ tốn vài phút mỗi ngày. Chỉ bật chế độ autopilot khi bạn đã tin tưởng cách nó viết.

### Xử lý thư trả lời và dừng khẩn cấp

Khi có người trả lời, Sellbird phân loại (quan tâm, phản đối, thư tự động), soạn sẵn câu đáp và đưa những ca nó không nên tự trả lời cho bạn. Nếu thấy có gì không ổn, một lệnh dừng mọi thứ ngay:

```bash
sellbird sending pause
```

Bạn nhận lại quyền kiểm soát tức thì, thư nào chưa gửi sẽ không đi nữa.

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

### Python quá cũ trên macOS

Nếu `python3 --version` báo 3.9 thì `pip install -e .` sẽ không đáp ứng yêu cầu Python 3.11 trở lên. Chạy `brew install python@3.13`, rồi tạo môi trường ảo bằng `python3.13` như README hướng dẫn, đừng dùng `python3` trơn.

### Lệnh sellbird không được nhận ra

Thường là bạn chưa kích hoạt môi trường ảo, hoặc mở terminal mới mà quên kích hoạt lại, hoặc chạy `pip install -e .` ở sai thư mục. Hãy `cd` vào thư mục `sellbird`, kích hoạt `.venv`, rồi chạy lại lệnh cài.

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

Sellbird suy nghĩ qua Claude Code CLI nên cần đăng nhập trước. Chạy `claude login` và làm theo hướng dẫn. Nếu bạn dùng ChatGPT, hãy xem tài liệu “Using a ChatGPT plan (Codex)” trong repo.

### Thư gửi đi vào spam hoặc bị trả về

Đây là vấn đề của mọi 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ỉ được đánh dấu deliverable. Tài liệu “Legal and deliverability” của repo giải thích chi tiết.

### git pull báo lỗi khi nâng cấp từ Harvey

Nếu bạn từng sửa trực tiếp file `harvey.yaml`, `git pull` sẽ dừng với thông báo “your local changes would be overwritten”. README hướng dẫn: chạy `git stash`, `git pull`, rồi `git stash pop`. Nếu có xung đột, giữ 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 để cài đặt riêng trong `sellbird.local.yaml`, file mà git không đụng tới.

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

**Điểm mạnh.** Không cần API key mô hình và không tính tiền theo token. Dữ liệu và cấu hình nằm trên máy bạn. Nguồn tìm công ty mặc định miễn phí, các bước trả phí đều báo giá trước. Mặc định phải duyệt thư trước khi gửi, kèm bước kiểm tra tự động trước khi gửi. Tài liệu đầy đủ, và repo vẫn được cập nhật trong 3 tháng gần đây.

**Giới hạn.** Đây là công cụ dòng lệnh, nên bạn phải quen mở terminal. Bạn vẫn cần tự lo hộp thư gửi, tên miền và warmup. Nguồn dữ liệu miễn phí (OpenStreetMap) có thể không phủ hết ngành bạn nhắm tới, và ví dụ trong README thiên về doanh nghiệp dịch vụ nhỏ. Việc gửi thư lạnh có quy định pháp lý khác nhau theo từng nước, bạn cần tự kiểm tra. Giấy phép là AGPL-3.0, hãy đọc kỹ nếu định dùng lại mã trong sản phẩm thương mại.

**Khi nào chọn cách khác.** Nếu bạn không muốn tự chạy, tác giả có bản đám mây tại sellbird.ai (đang trong giai đoạn truy cập sớm), đã lo sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ cần một vài khách mỗi tháng, gửi thủ công có thể đủ rồi. Và nếu bạn cần một danh sách liên hệ khổng lồ theo ngành, một dịch vụ dữ liệu chuyên dụng sẽ phù hợp hơn.

## 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à dùng được miễn phí. Nguồn tìm doanh nghiệp mặc định và việc đọc website đều tốn 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 nêu Google Workspace khoảng 7 USD mỗi tháng).

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

Không. README nói Sellbird chạy qua Claude Code CLI trên gói Claude Pro hoặc Max, hoặc qua Codex trên gói ChatGPT, nên không có API key và không tính tiền theo token. Một số dịch vụ phụ như kiểm tra email có biến key riêng trong .env.example, nhưng bạn chỉ điền khi dùng.

### Có cần GPU không?

Tư liệu không nêu yêu cầu GPU hay phần cứng nào. Phần suy nghĩ do Claude hoặc Codex đảm nhận, còn Sellbird chỉ cần Python 3.11 trở lên.

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

README có nhắc thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng các lệnh cài mẫu viết cho macOS/Linux. README chưa ghi lệnh riêng cho Windows, vì vậy cách an toàn là để Claude cài giúp hoặc xem tài liệu trong thư mục docs/. Trên Linux còn có thể chạy bằng Docker.

### Sellbird có tự gửi email lung tung không?

Không, mặc định mỗi email đều nằm trong Outbox chờ bạn duyệt cho đến 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, và lệnh sellbird sending pause dừng mọi thứ ngay lập tức.

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

README cho biết cấu hình, kiến thức và dữ liệu nằm trong một thư mục home trên máy bạn, gồm cơ sở dữ liệu, log và token đăng nhập dashboard. Dashboard chạy ở địa chỉ nội bộ 127.0.0.1. Tư liệu không có thêm thông tin về mã hoá hay bảo mật sâu hơn.

### Khác gì Apollo, ZoomInfo hay Clay?

README nói Sellbird không dùng các công cụ prospecting như Apollo, ZoomInfo, Clearbit hay Clay. Nó tự tìm công ty, người quyết định và kiểm tra email bằng chính các nguồn công khai và dịch vụ bạn chọn. Tư liệu không so sánh thêm về chất lượng dữ liệu.
