# Sellbird: tự động tìm khách và gửi cold email — hướng dẫn cài đặt và dùng

> Sellbird (trước đây là Harvey) là nền tảng mã nguồn mở viết bằng Python. Nó tìm công ty hợp với khách hàng của bạn, tìm người quyết định, kiểm tra email, viết cold email riêng cho từng người, gửi đi và 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 cần API key của mô hình. Cài không quá khó nếu bạn quen terminal, hoặc có thể nhờ Claude Code cài giúp.

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

Sellbird là một nền tảng mã nguồn mở chạy trên máy của bạn, làm trọn quy trình gửi cold email: tìm 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 thư riêng cho từng người, gửi đi rồi xử lý thư trả lời. Dự án trước đây tên là Harvey, nay đổi tên thành Sellbird và vẫn giữ nguyên lịch sử.

Người nên xem là chủ doanh nghiệp nhỏ, nhân viên kinh doanh, người làm marketing hoặc lập trình viên đang cần tìm khách mới mà không muốn trả tiền cho cả bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Theo README, Sellbird không cần những công cụ đó.

Điểm đáng giá nhất có hai ý. Thứ nhất, nó tư duy qua Claude Code CLI trên gói Claude Pro hoặc Max (hoặc Codex trên gói ChatGPT), nên không có API key và không tính tiền theo token. Thứ hai, mặc định không có email nào được gửi đi nếu bạn chưa duyệt. Hiện repo có khoảng 5.250 sao và 1.127 fork, giấy phép AGPL-3.0. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi cài.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | Nền tảng mã nguồn mở tìm công ty và người quyết định, kiểm tra email, viết và gửi cold email cá nhân hoá, chạy trên gói Claude hoặc ChatGPT của bạn.
- 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 từ đầu đến cuối, hoặc dừng ở bất kỳ bước nào.

### Tìm công ty đúng khách hàng của bạn

Nó tìm doanh nghiệp khớp với mô tả khách hà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í. Mỗi lần tìm bằng nguồn trả phí đều hiện chi phí trước khi chạy, nên bạn không bị trừ tiền bất ngờ.

### Đọc website để biết vì sao họ sẽ mua

Sellbird đọ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, hay đ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, chỉ khoảng ba yêu cầu HTTP cho mỗi công ty. Lợi ích là email mở đầu bằng một lý do thật thay vì câu chào chung chung.

### Tìm người ra 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. Vì lấy từ trang công khai của họ, bạn có thông tin có nguồn rõ ràng.

### 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 đánh dấu là verified, risky, guess hoặc invalid, và chỉ địa chỉ gửi được mới bị gửi tới. Điều này giúp giảm thư bị trả về, một việc rất quan trọng với tên miền gửi thư của bạn.

### 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 đó 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

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

### Chỉ cần danh sách thì xuất CSV

Nếu bạn chỉ muốn danh sách khách, hãy dừng sau bước kiểm tra email và chạy `sellbird export`. Bạn nhận được một 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 cũng yêu cầu Python từ 3.11. README lưu ý macOS có sẵn bản 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 Claude Code CLI đã đăng nhập (`claude login`), hoặc **gói ChatGPT có Codex CLI**.
- **Một hộp thư để gửi đi**, tốt nhất là Google Workspace trên một tên miền gửi thư riêng. Microsoft 365 và SMTP cũng dùng được.
- **Warmup (làm nóng) cho hộp thư đó.** README gợi ý TrulyInbox. Sellbird đọ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à link giới thiệu, người duy trì dự án có thể nhận hoa hồng.

Về chi phí, README nêu: tìm doanh nghiệp bằng nguồn mặc định là 0 đồng, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả. Đọc website là 0 đồng. Hộp thư Google Workspace khoảng 7 USD mỗi tháng. Ngoài ra bạn dùng gói thuê bao Claude hoặc ChatGPT sẵn có.

File `.env.example` liệt kê các khóa tùy chọn như thông tin Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ kiểm tra email (Reoon, ZeroBounce, Hunter) và TrulyInbox. Bạn chỉ điền cái nào thật sự dùng. Tư liệu không cho biết cần phần cứng đặc biệt nào.

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

```steps
- Tải mã nguồn | Clone repo về máy rồi vào thư mục sellbird
- Cách nhanh: nhờ Claude cài | Mở claude trong thư mục và nói yêu cầu cài đặt
- Hoặc tự cài | Tạo môi trường ảo và cài gói bằng pip
- Điền thông tin | Copy .env.example thành .env rồi đ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 và chạy | Chạy discover, mở dashboard, rồi chạy run
```

Có hai cách: để Claude Code hướng dẫn bạn, hoặc tự gõ lệnh. Người mới nên thử cách đầu.

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

Mở terminal (trên Windows là PowerShell hoặc Git Bash, trên macOS là ứng dụng Terminal), đi 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
```

Lệnh đầu tải mã nguồn về. Lệnh thứ hai đi vào thư mục vừa tải. Các lệnh sau đều phải chạy trong thư mục này, đây là chỗ người mới hay quên.

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

Trong thư mục `sellbird`, gõ:

```bash
claude
```

Khi Claude Code mở, bạn nói: **set up Sellbird for me** (cài Sellbird giúp tôi). Theo README, file `CLAUDE.md` trong repo biến Claude Code thành người hướng dẫn: kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi thứ cần hỏi và dạy Sellbird về sản phẩm của bạn. Bạn cần đã đăng nhập Claude CLI trước (`claude login`).

### Hoặc tự cài bằng tay

Bước 1 là tạo môi trường ảo và cài gói. Lệnh gốc của README:

```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` (môi trường Python riêng), bật nó lên, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau khi xong, bạn có lệnh `sellbird`. Lệnh `source .venv/bin/activate` dành cho macOS và Linux. README chưa ghi lệnh bật môi trường ảo riêng cho Windows. Nếu dùng Windows và gặp khó, hãy chọn cách để Claude Code cài giúp ở trên, hoặc xem thêm mục Troubleshooting trong thư mục `docs/` của repo.

### Đ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 để bạn sửa. Mỗi biến đều có chú thích ngay trong file. Điền thông tin hộp thư của bạn (ví dụ Gmail hoặc SMTP). Các khóa của dịch vụ kiểm tra email hay TrulyInbox là tùy chọn. Trên Windows, nếu `$EDITOR` không chạy, bạn có thể mở file `.env` bằng Notepad và sửa tay. Tuyệt đối không đăng file `.env` lên mạng.

### 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 là nơi để đặt cài đặt riêng, git không đụng tới.

### Xác nhận khách hàng tốt trông như thế nào

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

Bước này để bạn chọn các tín hiệu mua hàng cần dò. Tham số `free` đúng như README ghi.

### Tìm doanh nghiệp

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

Nguồn mặc định miễn phí và không cần tài khoản.

### Mở bảng điều khiển và chạy 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ỉ trên máy bạn (127.0.0.1:5555). `sellbird run` khởi động vòng lặp làm việc. Hãy để cửa sổ terminal này mở khi đang chạy. README cũng nói trên Linux bạn có thể chạy bằng Docker, repo có sẵn Dockerfile và docker-compose.yml.

```note
Cold email có luật riêng và hộp thư gửi sai cách có thể bị đánh dấu spam. Hãy đọc tài liệu Legal and deliverability trong thư mục docs của repo trước khi bật gửi thật. Nên dùng tên miền gửi thư riêng và làm warmup như README khuyên.
```

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

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

- Chạy `sellbird --help` hoặc các lệnh như `sellbird dashboard` mà không báo lỗi "command not found". Điều đó cho thấy gói đã được cài vào môi trường ảo đang bật.
- `sellbird dashboard` in ra một link riêng tới `http://127.0.0.1:5555`. Mở link đó trên trình duyệt sẽ thấy bảng điều khiển.
- `sellbird run` in ra dòng "Sellbird is online", kiểm tra trạng thái dây chuyền, rồi báo từng việc như viết chuỗi email hoặc soạn câu trả lời, cuối cùng là "Cycle complete" và nghỉ khoảng 15 phút. README cho ví dụ có dòng kiểu "5 emails waiting for your approval". Thấy email nằm chờ duyệt trong Outbox nghĩa là hệ thống đang làm việc đúng.

Bạn cũng có thể thử với dữ liệu demo. README nói dữ liệu demo là bịa, một công ty tên Bookwell bán phần mềm đặt lịch cho thợ lợp mái, phòng khám nha và tiệm điều hoà, dùng tên miền `.test`.

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

Phần này bám theo những gì README mô tả.

### Chủ doanh nghiệp nhỏ muốn tìm khách mới

Bạn bán phần mềm đặt lịch hẹn cho các tiệm dịch vụ. 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" bằng `sellbird signals --confirm free`, rồi chạy `sellbird discover`. Sellbird tìm các tiệm phù hợp trên OpenStreetMap, đọc website của họ và đánh dấu tiệm nào đang thiếu đặt lịch. Kết quả là một danh sách khách tiềm năng có lý do cụ thể để liên hệ, chưa tốn đồng nào.

> Sellbird không gửi gì đi nếu bạn chưa bấm duyệt. Tự động hoá phần việc nặng, giữ quyền quyết định trong tay mình.
>
> — Ông T

### Nhân viên kinh doanh cần duyệt thư trước khi gửi

Bạn mở dashboard và vào Outbox. Mỗi email chờ duyệt là một thư riêng cho từng người, ví dụ chuỗi hai email nói về việc công ty đang tuyển nhân viên điều phối. Trước khi cho gửi, hệ thống tự kiểm tra, không dùng mô hình, để loại thư còn sót mã điền tự động, cụm từ bị cấm, thư quá dài, thừa link hoặc địa chỉ không gửi được. Bạn đọc, sửa nếu cần rồi duyệt. Thư đi từ hộp thư thật của bạn, trong giới hạn mỗi ngày.

### Người làm marketing chỉ cần danh sách

Bạn đã có công cụ gửi email riêng nên chỉ cần dữ liệu. Hãy chạy `sellbird discover`, để Sellbird tìm người quyết định và kiểm tra email, rồi dừng và chạy:

```bash
sellbird export
```

Bạn nhận file CSV sẵn sàng nhập vào công cụ gửi khác. Mỗi địa chỉ đã có nhãn verified, risky, guess hoặc invalid để bạn lọc.

### Người đang chạy Harvey muốn nâng cấp

Nếu trước đây bạn dùng Harvey, README nói cấu hình, dữ liệu và đăng nhập dashboard đều được giữ. Bạn chạy:

```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 cơ sở dữ liệu cũ. Nó không ghi đè file đã có tên mới. Nếu bạn sửa trực tiếp file `harvey.yaml` thì `git pull` sẽ báo xung đột, README hướng dẫn dùng `git stash`, `git pull`, `git stash pop`.

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

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

Thường là bạn chưa bật môi trường ảo hoặc chưa chạy bước cài gói. Mở terminal mới, vào thư mục `sellbird`, bật lại môi trường ảo (trên macOS/Linux dùng `source .venv/bin/activate`) rồi chạy lại `pip install -e .`. Trên Windows, README chưa ghi lệnh bật môi trường ảo, hãy xem mục Troubleshooting trong `docs/`.

### Python quá cũ

Sellbird cần Python từ 3.11. Trên macOS, lệnh `python3` có thể là bản 3.9. Hãy cài bản mới như README gợi ý (`brew install python@3.13`) rồi dùng `python3.13` để tạo môi trường ảo.

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

Sellbird nghĩ qua Claude Code CLI, nên nếu chưa đăng nhập nó không làm việc được. Chạy `claude login` và dùng tài khoản Pro hoặc Max. Nếu bạn dùng ChatGPT thì xem hướng dẫn Codex trong thư mục `docs/`.

### Git báo local changes would be overwritten khi nâng cấp

Đây là lỗi người dùng Harvey cũ hay gặp nếu đã sửa `harvey.yaml`. Làm theo README: `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ừ nay hãy đặt cài đặt riêng trong `sellbird.local.yaml`.

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

Tư liệu không liệt kê lỗi cụ thể, nhưng đây là rủi ro rất dễ gặp với cold email. Hãy dùng tên miền gửi thư riêng, làm warmup trước khi gửi, chỉ gửi tới địa chỉ verified và giữ chế độ duyệt tay. Nếu cần dừng gấp, README ghi lệnh `sellbird sending pause` sẽ dừng mọi thứ ngay.

## 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 nếu bạn đã có gói Claude hoặc ChatGPT. Dữ liệu chạy trên máy bạn. Mặc định phải duyệt tay trước khi gửi, lại có bước kiểm tra tự động không dùng mô hình để chặn thư lỗi. Có bảng điều khiển, xuất CSV, và mã nguồn mở nên bạn đọc và sửa được các prompt và kỹ năng bán hàng.

**Giới hạn.** Bạn phải tự lo hộp thư gửi, tên miền và warmup. Cài đặt cần quen dòng lệnh, và ví dụ trong README viết theo hướng macOS/Linux. Nguồn tìm miễn phí dựa trên OpenStreetMap nên phù hợp nhất với doanh nghiệp địa phương. Tư liệu không nói độ phủ dữ liệu ở Việt Nam. Giấy phép AGPL-3.0 có điều kiện riêng nếu bạn định tích hợp vào sản phẩm khác.

**Khi nên chọn cách khác.** Nếu bạn không muốn tự vận hành, README nói có bản hosted tại sellbird.ai, đang ở giai đoạn early access, có 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 thì một công cụ đơn giản là đủ. Và nếu bạn không rõ quy định gửi thư thương mại ở thị trường của người nhận, hãy tìm hiểu trước khi bật chế độ tự độ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. README nói không có hoá đơn API cho mô hình vì nó dùng gói Claude Pro/Max hoặc ChatGPT bạn đã có. Nguồn tìm doanh nghiệp mặc định là 0 đồng, còn hộp thư gửi (ví dụ Google Workspace khoảng 7 USD mỗi tháng) là chi phí của bạn.

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

Không. README ghi rõ Sellbird nghĩ qua Claude Code CLI hoặc Codex trên gói thuê bao, không dùng API key và không tính theo token. Một số dịch vụ tuỳ chọn như kiểm tra email có biến khoá riêng trong file .env.example.

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

Tư liệu không nêu yêu cầu phần cứng đặc biệt, và phần suy nghĩ chạy qua Claude hoặc Codex chứ không chạy mô hình tại máy. Bạn chỉ cần Python 3.11 trở lên.

### 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 đặt được viết theo hướng macOS/Linux và README chưa ghi lệnh bật môi trường ảo cho Windows. Bạn có thể thử để Claude Code cài giúp hoặc xem mục Troubleshooting trong thư mục docs của repo.

### Email có bị gửi đi 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 tới khi bạn tự bật autopilot. Ngay cả khi bật, các thư có link tới tên miền không phải của bạn vẫn bị giữ lại, và lệnh sellbird sending pause dừng mọi thứ ngay.

### Dữ liệu của tôi 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. Tư liệu không bàn thêm về bảo mật chi tiết. Nếu thấy lỗ hổng, repo yêu cầu làm theo SECURITY.md thay vì mở issue công khai.

### Sellbird khác gì Harvey?

Là cùng một dự án, cùng lịch sử, chỉ đổi tên từ phiên bản 0.4.0. Cấu hình, dữ liệu và đăng nhập dashboard được giữ khi nâng cấp. Lệnh harvey cũ vẫn chạy tạm thời nhưng sẽ bị bỏ ở bản sau.
