# 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 là nền tảng outreach mã nguồn mở viết bằng Python. Nó tìm doanh nghiệp phù hợp, 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. Nó dùng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có nên không phải trả tiền API. Cài bằng vài lệnh, nhưng cần Python 3.11 trở lên và một hộp thư để gửi.

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

Sellbird là một nền tảng mã nguồn mở để làm outreach (gửi email chào hàng lạnh, hay cold email) gần như từ đầu đến cuối. Nó tìm những công ty cần thứ bạn bán, tìm người quyết định ở đó, kiểm tra địa chỉ email, viết cho mỗi người một email riêng, 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à hiện có khoảng 5.249 sao cùng 1.127 fork.

Bạn nên xem qua nếu đang bán dịch vụ cho doanh nghiệp nhỏ (tiệm nha khoa, thợ sửa mái, cửa hàng điều hoà, hay những ngành tương tự). Bạn cũng nên xem nếu là lập trình viên muốn có sẵn một dây chuyền tìm khách mà mình kiểm soát được. Mọi thứ chạy trên máy của bạn, và mặc định không có email nào được gửi đi nếu bạn chưa duyệt.

Điểm đáng giá nhất là chuyện chi phí. Sellbird không dùng API key của mô hình AI. Nó "suy nghĩ" 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 bị tính tiền theo token. Bạn có thể xem video ngắn bên dưới để thấy tổng quan trước khi cài.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | Sellbird tìm công ty và người quyết định, kiểm tra email, viết cold email cá nhân hoá, gửi đi và xử lý thư trả lời — chạy bằng gói Claude hoặc ChatGPT của bạn.
- 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 dây chuyền nhiều bước. Bạn có thể chạy hết, 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 chi phí trước khi chạy. Nhờ vậy bạn không bị tính tiền bất ngờ.
- **Tìm lý do họ sẽ mua.** Nó đọc website của từng công ty để tìm những 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 AI nên không tốn gì.
- **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 email.** Nó suy ra mẫu email của công ty và 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 được dùng để gửi. Việc này giúp bạn bớt thư bị trả lại, vốn làm hỏng uy tín tên miền 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. Sau đó nó 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 trả lời, tôn trọng yêu cầu từ chối nhận thư ngay lập tức. Những gì không nên tự trả lời, nó chuyển cho bạn.

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`. Lệnh này cho ra file CSV sẵn sàng đưa vào công cụ gửi mail hàng loạt.

Về an toàn, mọi email gửi đi đều nằm trong mục Outbox chờ bạn duyệt, cho đến khi chính bạn bật chế độ autopilot. Trước khi gửi còn có một bước kiểm tra không dùng mô hình AI. Bước này chặn những email còn sót thẻ điền thông tin chưa thay, chứa cụm từ bị cấm, quá dài, có thêm link, hoặc gửi tới địa chỉ không gửi đượ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 Python >=3.11. 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.
- **Claude Pro hoặc Max** với CLI đã đăng nhập (`claude login`), hoặc **gói ChatGPT có Codex CLI**. Cách thiết lập Codex nằm trong tài liệu 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ư đó.** Tác giả gợi ý TrulyInbox. Sellbird đọc được tỷ lệ vào hộp thư đến của công cụ này để báo khi nào bạn đã sẵn sàng gửi. Đây là liên kết affiliate của người bảo trì, và bạn không bắt buộc phải dùng.

Về chi phí, README nêu: tìm doanh nghiệp là 0 đồng ở 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ột tháng. Repo này không dùng Apollo, ZoomInfo, Clearbit hay Clay.

File `.env.example` liệt kê nhiều biến tuỳ chọn như khoá cho dịch vụ xác minh email (Reoon, ZeroBounce, Hunter), Instantly, Cloudflare và DataForSEO. Bạn không cần điền hết. Chỉ điền những gì bạn thực sự dùng.

Về hệ điều hành, README ví dụ bằng lệnh macOS/Linux và nói Docker dùng được trên Linux. Thư mục dữ liệu trên Windows nằm ở `%APPDATA%\sellbird`. Phần cài đặt của README chưa có lệnh riêng cho Windows, bạn xem thêm mục Troubleshooting và Docker trong thư mục `docs/`.

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

```steps
- Tải mã nguồn | Clone repo về máy và vào thư mục dự án
- Tạo môi trường và cài | Tạo môi trường ảo Python 3.13 rồi cài gói sellbird
- Điền thông tin đăng nhập | 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
- Chọn tín hiệu và tìm khách | Xác nhận signals rồi chạy sellbird discover
- Mở dashboard và chạy vòng lặp | Chạy sellbird dashboard và sellbird run
```

README có hai cách: nhờ Claude cài giúp, hoặc tự gõ lệnh. Người mới nên thử cách đầu.

### Tải mã nguồn (và cách để Claude cài giúp)

Mở terminal (trên macOS là Terminal, trên Linux là cửa sổ dòng lệnh), rồi chạy:

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

`git clone` tải mã nguồn về, `cd sellbird` đi vào thư mục vừa tải, còn `claude` mở Claude Code ngay trong thư mục đó. Sau đó bạn gõ **"set up Sellbird for me"**. File `CLAUDE.md` của repo biến Claude Code thành người hướng dẫn cài đặt. Nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi thứ nó cần và dạy Sellbird về sản phẩm của bạn. Nếu dùng cách này, bạn có thể bỏ qua các bước còn lại bên dưới.

Lưu ý: lệnh `claude` chỉ chạy được khi bạn đã cài Claude Code CLI và đăng nhập bằng `claude login`.

### Tạo môi trường ảo và cài Sellbird

Nếu muốn tự làm, vẫn đứng trong thư mục `sellbird`, chạy:

```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 môi trường ảo `.venv` (một "hộp" riêng để gói Python không lẫn với máy), kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Chỗ người mới hay vấp là dùng `python3` thay vì `python3.13`, vì trên macOS `python3` trần có thể chỉ là bản 3.9 quá cũ. Lệnh `source` là của macOS/Linux. README chưa ghi lệnh kích hoạt cho Windows.

### Điền thông tin đăng nhập vào .env

```bash
# 2. Add credentials. Every variable is documented inline.
cp .env.example .env && $EDITOR .env
```

Lệnh sao chép file mẫu thành `.env` rồi mở nó để bạn sửa. Mỗi biến đều có chú thích ngay trong file. Bạn điền thông tin hộp thư gửi (Gmail, Microsoft 365 hoặc SMTP) và các khoá dịch vụ bạn dùng. Đừng đăng file `.env` lên bất kỳ đâu công khai.

### 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 công ty bạn. Sellbird đọc trang đó để hiểu bạn bán gì rồi ghi vào file `sellbird.local.yaml`. File này nằm ngoài phần git theo dõi nên cập nhật sau này sẽ không đè lên.

### Chọ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
```

Bước 4 xác nhận những dấu hiệu cho thấy một công ty là khách tốt. Bước 5 tìm doanh nghiệp, mặc định bằng nguồn miễn phí không cần tài khoản.

### Mở dashboard và bật vòng lặp

```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ỉ 127.0.0.1:5555, tức chỉ mở được trên máy bạn. `sellbird run` khởi động vòng lặp chính. Nó kiểm tra tình trạng, viết chiến dịch cho khách mới và đưa email vào Outbox chờ bạn duyệt.

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

Có ba dấu hiệu theo README:

- `python3.13 --version` (hoặc `python3 --version`) cho ra 3.11 trở lên.
- `sellbird dashboard` in ra đường link riêng, và mở được trang tại 127.0.0.1:5555.
- `sellbird run` in dòng "Sellbird is online.", rồi báo từng bước như viết chiến dịch, xử lý thư trả lời, và số email đang chờ bạn duyệt, kết thúc bằng "Cycle complete" rồi nghỉ 15 phút trước vòng sau.

README còn nói dữ liệu demo là bịa (công ty "Bookwell" bán đặt lịch online, dùng tên miền `.test`). Đừng bất ngờ nếu thấy tên lạ khi xem ví dụ.

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

### Chủ công ty phần mềm: chỉ lấy danh sách khách để gửi bằng công cụ khác

Bạn bán phần mềm đặt lịch cho phòng khám nha khoa và đã có công cụ gửi mail hàng loạt. Bạn chỉ cần danh sách sạch. Chạy `sellbird train` với website của bạn, `sellbird signals --confirm free`, rồi `sellbird discover`. Khi dữ liệu đã qua bước kiểm tra email, chạy:

```bash
sellbird export
```

Kết quả là file CSV chứa những gì Sellbird tìm được, sẵn sàng nhập vào công cụ gửi mail. Bạn dùng Sellbird như máy tìm khách và kiểm tra email, không cần cho nó gửi gì.

> Cold email tốt bắt đầu từ danh sách đúng người, không phải từ nút gửi.
>
> — Ông T

### Người làm kinh doanh: chạy cả dây chuyền nhưng tự duyệt từng thư

Bạn quản lý kinh doanh cho một dịch vụ cho doanh nghiệp nhỏ. Bạn cài Sellbird, nối hộp thư Google Workspace đã warmup, rồi chạy `sellbird run`. Mỗi vòng, nó tìm khách mới, viết chuỗi 2 email dựa trên tín hiệu như "đang tuyển nhân viên điều phối". Các email nằm trong Outbox. Bạn mở dashboard, đọc từng thư, sửa nếu cần rồi duyệt. Khi thấy chất lượng ổn định, bạn mới cân nhắc bật autopilot. Ngay cả khi bật, Sellbird vẫn giữ lại thư có link tới tên miền không phải của bạn.

### Nhân viên văn phòng: xử lý thư trả lời mà không bỏ sót

Sau vài ngày gửi, hộp thư có phản hồi lẫn lộn: người quan tâm, người phản đối, thư tự động báo vắng mặt, người xin ngừng nhận. Sellbird đọc tất cả, đặt thư tự động sang một bên, ghi nhận ngay những người từ chối, và soạn sẵn câu trả lời cho người quan tâm hoặc phản đối. Bạn vào dashboard xem những thư đã soạn. Với thứ nó không nên tự đáp, nó chuyển cho bạn quyết định.

### Lập trình viên: nâng cấp từ Harvey và dừng khẩn cấp

Nếu bạn đang chạy Harvey, README nói cấu hình, dữ liệu và đăng nhập dashboard đượ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ếu thấy có gì bất thường khi đang gửi, một lệnh dừng mọi thứ ngay:

```bash
sellbird sending pause
```

```note
Cold email có luật riêng và rủi ro về uy tín tên miền. README có hẳn tài liệu Legal and deliverability trong docs/. Hãy đọc trước khi gửi thật, dùng tên miền gửi riêng và để Outbox ở chế độ duyệt tay cho đến khi bạn tin chất lượng thư. Không chia sẻ file .env.
```

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

- **Báo Python quá cũ hoặc cài không được.** Thường do dùng `python3` trần trên macOS, vốn là bản 3.9. Hãy cài `brew install python@3.13` rồi chạy lại bằng `python3.13` như README hướng dẫn.
- **Không có lệnh `sellbird` sau khi cài.** Có thể bạn chưa kích hoạt môi trường ảo `.venv`, hoặc chưa chạy `pip install -e .` trong thư mục repo. Kích hoạt lại môi trường rồi cài lại. Khi nâng cấp từ Harvey, README cũng dặn chạy `pip install -e .` một lần để có lệnh mới.
- **Chạy được nhưng không thấy email nào đi.** Đây là hành vi mặc định, không phải lỗi. Email chờ trong Outbox cho tới khi bạn duyệt, hoặc bạn tự bật autopilot. Trước hết hãy mở dashboard và kiểm tra Outbox.
- **`git pull` báo "your local changes would be overwritten".** Xảy ra khi bạn từng 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`. Về lâu dài, hãy đặt cấu hình riêng vào `sellbird.local.yaml` để git không đụng tới.
- **Sellbird chưa đổi tên file dữ liệu sau khi nâng cấp.** README nói nó sẽ chờ nếu tiến trình Harvey cũ vẫn đang chạy trong thư mục. Hãy tắt tiến trình đó trước rồi chạy lại.

Nếu gặp lỗi khác, README trỏ tới tài liệu Troubleshooting trong thư mục `docs/`.

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

**Điểm mạnh.** Chạy trên máy bạn, dùng gói AI bạn đã trả tiền nên không có hoá đơn API theo token. Dây chuyền đầy đủ, từ tìm khách đến xử lý thư trả lời. Mặc định không gửi gì nếu bạn chưa duyệt, và có bước kiểm tra trước khi gửi không dùng AI. Bạn cũng có thể dùng từng phần, như chỉ xuất danh sách. Giấy phép AGPL-3.0, repo còn được cập nhật trong ba tháng gần đây.

**Giới hạn.** Bạn phải tự lo hộp thư gửi, tên miền riêng và warmup, vì cold email không chỉ là chuyện phần mềm. README nhắm tới người dùng macOS/Linux, phần Windows chưa rõ. Nguồn tìm doanh nghiệp miễn phí là OpenStreetMap nên độ phủ phụ thuộc vào dữ liệu ở đó, và tôi chưa thấy tư liệu nào nói rõ độ phủ ở Việt Nam. Giấy phép AGPL cũng đáng đọc kỹ nếu bạn định tích hợp vào 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ự cài và tự lo hộp thư, README có nhắc bản hosted tại sellbird.ai, hiện đang truy cập sớm, đã thiết lập sẵn 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, cài cả dây chuyền này là hơi thừa.

## Câu hỏi thường gặp

### Sellbird có miễn phí không?

Phần mềm mã nguồn mở, giấy phép AGPL-3.0. Nguồn tìm doanh nghiệp mặc định miễn phí, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả theo README. 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ột 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/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. Nó cũng tự giảm tốc để chừa chỗ cho việc của bạn.

### Có cần GPU hay máy mạnh không?

Tư liệu không nêu yêu cầu GPU hay phần cứng riêng. Phần xử lý AI đi qua Claude Code hoặc Codex, không chạy mô hình trên máy bạn. Yêu cầu được nêu là Python 3.11 trở lên.

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

README ghi thư mục dữ liệu cho Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt trong phần Quick start viết cho macOS/Linux, và Docker được nói 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 xem thêm tài liệu Troubleshooting và Docker trong thư mục docs/.

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

Không, mặc định mọi email chờ trong Outbox cho tới khi bạn duyệt, trừ khi chính bạn bật autopilot. Có thêm bước kiểm tra trước khi gửi, và lệnh sellbird sending pause dừng mọi việc ngay lập tức.

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

README nói 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ả cơ sở dữ liệu và log. Dashboard mở tại 127.0.0.1:5555 với link riêng. Tư liệu không nói thêm về các biện pháp bảo mật khác, vấn đề bảo mật xem SECURITY.md trong repo.

### Khác gì Harvey? Tôi đang dùng Harvey thì sao?

Harvey chính là Sellbird sau khi đổi tên từ bản 0.4.0, cùng dự án và cùng lịch sử. Cấu hình, dữ liệu và đăng nhập dashboard được mang sang; làm theo mục Upgrading from Harvey: git pull, pip install -e ., rồi sellbird dashboard.
