# Sellbird: tìm khách, viết và gửi cold email bằng gói Claude/ChatGPT — hướng dẫn cài đặt và dùng

> Sellbird (trước đây là Harvey) là một nền tảng outreach mã nguồn mở viết bằng Python, chạy trên máy của bạn. Nó tìm công ty phù hợp, tìm người quyết định, kiểm tra email, viết cold email cá nhân hoá, gửi đi và soạn sẵn câu trả lời cho phản hồi. Cài không quá khó nếu bạn quen terminal, và 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-06-21 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/sellbird-cold-email-tu-dong-chay-bang-goi-claude-chatgpt-3

Sellbird là một nền tảng outreach (tiếp cận khách hàng bằng email lạnh) mã nguồn mở, chạy ngay trên máy của bạn. Nó làm cả chuỗi việc: 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 từng email riêng cho từng người, gửi đi và xử lý phản hồi. Tên cũ của dự án là Harvey, hiện repo có khoảng 5250 sao và 1127 fork.

Bạn nên xem qua repo này nếu bạn là chủ doanh nghiệp nhỏ, người làm sales hay marketing, hoặc dev muốn có hệ thống tìm khách B2B mà không phải thuê Apollo, ZoomInfo, Clearbit hay Clay. Người dùng cuối cùng vẫn phải tự chịu trách nhiệm về nội dung và pháp lý khi gửi email, nên đây không phải công cụ “bấm một nút là xong”.

Điểm đáng giá nhất: Sellbird không đòi API key của mô hình AI. Nó “nghĩ” qua Claude Code CLI trên gói Claude Pro/Max của bạn, hoặc qua Codex trên gói ChatGPT. Vì vậy không có hoá đơn tính theo token. Và mặc định, không email nào rời máy bạn cho đến khi bạn bấm duyệt. 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ở tự tìm công ty, tìm người ra quyết định, kiểm tra email, viết và gửi cold email, xử lý phản hồi bằng 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 đường ống (pipeline). Bạn có thể chạy hết, hoặc dừng ở bất cứ bước nào.

- **Tìm công ty.** 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ị “cháy túi” bất ngờ.
- **Tìm lý do 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, 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, mỗi công ty chỉ cần ba request HTTP.
- **Tìm người quyết định.** Nó tìm chủ hoặc quản lý có 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 địa chỉ email.** Nó học mẫ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. Chỉ địa chỉ gửi được mới được dùng để 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 thông tin đã tìm được. Email đượ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 từng phản hồi, soạn câu trả lời, gạt thư tự động trả lời sang một bên, 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.
- **Xuất danh sách.** Nếu bạn chỉ cần danh sách khách, hãy dừng sau bước xác minh và chạy `sellbird export` để lấy file CSV dùng được cho các công cụ gửi mail hàng loạt.

Ngoài ra còn một bảng điều khiển (dashboard) chạy local, và các kịch bản bán hàng (skills, prompts) nằm trong thư mục repo để bạn tự chỉnh.

## 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 đ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** đã đăng nhập CLI bằng `claude login`, hoặc **gói ChatGPT có Codex CLI**.
- **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 chạy được.
- **Warmup (làm nóng) hộp thư đó.** README giới thiệu TrulyInbox cho việc này. Đây là link affiliate của tác giả, bạn không bắt buộc phải dùng.
- **Git** để tải repo về.

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ả với nguồn trả phí rẻ nhất. Đọc website không tốn tiền. Hộp thư Google Workspace khoảng 7 USD mỗi tháng.

File `.env.example` có sẵn các biến cho Gmail, SMTP/IMAP, Microsoft 365, và một số dịch vụ kiểm tra email, nhưng bạn chỉ điền cái nào mình thực sự dùng.

```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, giữ chế độ duyệt tay lúc đầu, và đọc tài liệu “Legal and deliverability” trong thư mục docs/ trước khi gửi hàng loạt. Đừng chia sẻ file .env vì trong đó có mật khẩu và khoá.
```

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

```steps
- Kiểm tra Python | Chắc chắn máy có Python 3.11 trở lên
- Tải repo | Dùng git clone rồi vào thư mục sellbird
- Cài gói | Tạo môi trường ảo và cài bằng pip install -e .
- Điền thông tin | Sao chép .env.example thành .env và điền
- Dạy sản phẩm | Chạy sellbird train với website của bạn
- Chạy | Tìm khách, mở dashboard và chạy vòng lặp
```

README có hai đường: nhờ Claude cài hộ, hoặc tự làm. Các lệnh trong README viết theo kiểu macOS/Linux (bash). README chưa ghi lệnh riêng cho Windows PowerShell. Nếu bạn dùng Windows, hãy xem thêm mục Troubleshooting và Docker trong thư mục `docs/` của repo.

### Cách nhanh: để Claude cài hộ

Mở terminal (Terminal trên macOS, hoặc cửa sổ dòng lệnh trên Linux), rồi chạy ba lệnh sau. Lệnh `git clone` tải mã nguồn về, `cd` vào thư mục vừa tải, và `claude` mở Claude Code ngay trong thư mục đó.

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

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: nó kiểm tra bạn đang ở đâu, cài thứ 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. Cách này hợp với người mới nhất.

### Cách tự cài: tạo môi trường và cài gói

Làm trong thư mục `sellbird` vừa tải về. Lưu ý của README: dùng `python3.13`, không dùng `python3` trơn, vì trên macOS `python3` có thể là bản 3.9 quá cũ.

```bash
python3.13 -m venv .venv && source .venv/bin/activate && pip install -e .
```

Lệnh này tạo một môi trường Python riêng tên `.venv`, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được (`-e`). Sau khi xong, bạn có lệnh `sellbird`. Mỗi lần mở terminal mới, bạn cần kích hoạt lại môi trường trước khi dùng lệnh này.

### Điền thông tin đăng nhập

```bash
cp .env.example .env && $EDITOR .env
```

Lệnh đầu sao chép file mẫu thành `.env`, lệnh sau mở file để bạn sửa. Mỗi biến đều có giải thích ngay trong file. Chỗ hay vấp: bạn chỉ cần điền phần hộp thư gửi (Gmail, Microsoft 365 hoặc SMTP/IMAP) và các dịch vụ bạn thực sự dùng. Không cần điền hết.

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

```bash
sellbird train https://your-company.com
```

Thay địa chỉ bằng website của bạn. Sellbird đọc trang đó để hiểu bạn bán gì và ghi kết quả vào file `sellbird.local.yaml`.

### Chọn tín hiệu và tìm khách

```bash
sellbird signals --confirm free
sellbird discover
```

Lệnh đầu xác nhận thế nào là một khách hàng tiềm năng tốt. Lệnh sau tìm doanh nghiệp. Nguồn mặc định miễn phí và không cần tài khoản.

### Mở dashboard và chạy vòng lặp

```bash
sellbird dashboard
sellbird run
```

`sellbird dashboard` in ra một đường dẫn riêng tới `http://127.0.0.1:5555`, tức là chỉ truy cập được trên máy bạn. `sellbird run` khởi động vòng lặp chính. README cũng cho biết trên Linux bạn có thể chạy bằng Docker, repo có sẵn `Dockerfile` và `docker-compose.yml`, nhưng README không ghi lệnh Docker cụ thể cho người mới, nên hãy xem tài liệu Docker trong `docs/`.

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

Cách đơn giản nhất là chạy `sellbird run`. Theo README, nếu mọi thứ ổn bạn sẽ thấy dòng “Sellbird is online”, rồi một bản tóm tắt tình trạng pipeline, ví dụ có bao nhiêu khách mới chưa có thư nháp, bao nhiêu email đang chờ bạn duyệt trong Outbox. Cuối vòng là dòng “Cycle complete. Sleeping for 15 minutes.”, tức là nó nghỉ 15 phút rồi chạy vòng tiếp.

Bạn cũng có thể mở đường dẫn do `sellbird dashboard` in ra. Nếu trang dashboard hiện lên và có mục Outbox, nghĩa là phần cài đặt đã ổn. README cho biết dữ liệu demo trong repo là dữ liệu bịa (công ty “Bookwell” bán phần mềm đặt lịch cho thợ lợp mái, nha khoa, thợ điều hoà), dùng tên miền `.test`.

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

Sellbird chỉ làm đúng những việc README mô tả. Dưới đây là vài tình huống bám sát khả năng đó.

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

Bạn bán phần mềm đặt lịch hoặc dịch vụ cho các tiệm nhỏ. Bạn chạy `sellbird train` với website của mình, rồi `sellbird signals --confirm free` để chốt những dấu hiệu cho thấy một công ty cần bạn, như chưa có đặt lịch online. Sau đó `sellbird discover` tìm doanh nghiệp. Kết quả là một danh sách công ty kèm lý do họ có thể mua, và email đã được gắn nhãn verified, risky, guess hoặc invalid.

> Không email nào được gửi đi nếu bạn chưa bấm duyệt.
>
> — Ông T

### Nhân viên sales muốn danh sách để dùng công cụ khác

Bạn đã có công cụ gửi mail hàng loạt và chỉ cần danh sách. Bạn chạy pipeline đến bước kiểm tra địa chỉ, rồi chạy:

```bash
sellbird export
```

Bạn nhận được một file CSV chứa mọi thứ Sellbird tìm thấy, dùng được cho công cụ gửi chuỗi email. Cách này phù hợp nếu bạn không muốn Sellbird tự gửi.

### Người bận rộn muốn duyệt email mỗi ngày

Bạn để `sellbird run` chạy và mở dashboard mỗi sáng. Những email Sellbird viết nằm chờ trong Outbox. Bạn đọc, sửa nếu cần, rồi duyệt. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ chặn các lỗi như merge tag chưa điền, cụm từ bị cấm, email quá dài, thừa link hoặc địa chỉ không gửi được. Muốn dừng khẩn cấp, bạn chạy `sellbird sending pause`.

### Dev đang dùng Harvey cần nâng cấp

Nếu bạn đã chạy 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 .
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. Nó không ghi đè file đã có tên mới, và sẽ chờ nếu tiến trình Harvey vẫn đang chạy trong thư mục đó, nên hãy tắt tiến trình cũ trước.

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

- **`python3 --version` báo 3.9 trên macOS.** Đây là Python hệ thống quá cũ. Cài bản mới bằng `brew install python@3.13` rồi dùng `python3.13` khi tạo môi trường ảo, như README dặn.
- **Gõ `sellbird` báo không tìm thấy lệnh.** Rất có thể bạn chưa kích hoạt môi trường ảo ở terminal mới, hoặc chưa chạy `pip install -e .`. Vào thư mục repo, kích hoạt `.venv` rồi thử lại.
- **`git pull` báo “your local changes would be overwritten” khi nâng cấp từ Harvey.** Bạn đã 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`. Nếu có xung đột, giữ các dòng của bạn, xoá dấu xung đột, rồi chạy `git stash drop`. Về lâu dài, nên đặt cấu hình trong `sellbird.local.yaml`, git không đụng tới file này.
- **Không chắc nên gửi hay chưa, hoặc thư vào spam.** Đây là rủi ro chung của cold email. README khuyên warmup hộp thư và dùng tên miền gửi riêng. Hãy đọc tài liệu “Legal and deliverability” và chỉ bật autopilot khi bạn đã quen.
- **Cần xem lỗi chi tiết hơn.** README có tài liệu Troubleshooting trong thư mục `docs/`. Nếu cần hỗ trợ, xem `SUPPORT.md`. Vấn đề bảo mật thì làm theo `SECURITY.md`, đừng mở issue công khai.

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

**Điểm mạnh.** Không cần API key mô hình, nên chi phí dễ đoán: gói Claude hoặc ChatGPT bạn đã có cộng với hộp thư gửi. Chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Mặc định phải duyệt tay trước khi gửi, có kiểm tra trước khi gửi, và có lệnh dừng tức thì. Các kịch bản bán hàng nằm trong thư mục `skills/` và `prompts/` để bạn tự chỉnh. Giấy phép AGPL-3.0, và dự án vẫn được cập nhật trong vài tháng gần đây.

**Giới hạn.** Các lệnh cài đặt trong README theo kiểu macOS/Linux, README chưa có hướng dẫn riêng cho Windows PowerShell. Bạn cần quen terminal và phải tự lo hộp thư, tên miền gửi và warmup. Nó tìm người ra quyết định từ chính các trang của công ty, tối đa hai người mỗi công ty, nên không thay thế được một cơ sở dữ liệu liên hệ lớn. Giấy phép AGPL-3.0 cũng 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, hãy đọc kỹ trước.

**Khi nào chọn cách khác.** Nếu bạn không muốn tự vận hành, tác giả có bản hosted tại trang chủ sellbird.ai (đang 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 gửi vài email thủ công cho khách quen, một công cụ này là hơi nhiều. Và dù dùng cách nào, hãy kiểm tra quy định về email quảng cáo ở nơi bạn gửi trước khi chạy hàng loạt.

## 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, tải và chạy không mất phí. Tuy vậy bạn cần gói Claude Pro/Max hoặc gói ChatGPT có Codex, và một hộp thư để gửi (README nhắc Google Workspace khoảng 7 USD một tháng). 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ả.

### Sellbird có cần API key của OpenAI hay Anthropic không?

Không. README nói Sellbird chạy qua Claude Code CLI trên gói Claude Pro/Max, hoặc Codex trên gói ChatGPT, nên 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 có thể cần key riêng, bạn chỉ điền nếu dùng.

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

Tư liệu không nhắc tới GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhiệm qua gói của bạn, còn việc đọc website chỉ là vài request HTTP nên không cần mô hình chạy trên máy.

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

README có ghi thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng các lệnh cài đặt được viết theo kiểu macOS/Linux và README chưa có hướng dẫn riêng cho Windows PowerShell. Phần Docker được nói là chạy trên Linux. Bạn nên xem Troubleshooting và Docker trong thư mục docs/ của repo.

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

Không theo mặc định. Mọi email chờ trong Outbox cho tới khi bạn duyệt, trừ khi bạn tự bật autopilot. Trước khi gửi còn có bước kiểm tra chặn merge tag chưa điền, cụm từ bị cấm, email quá dài, thừa link và địa chỉ không gửi được. Lệnh sellbird sending pause dừng mọi thứ ngay.

### Sellbird khác gì Apollo, ZoomInfo, Clearbit hay Clay?

README nói Sellbird không dùng các công cụ prospecting đó. Nó tự tìm công ty, tìm người ra quyết định từ chính trang của công ty, rồi xác minh email. Bản tư liệu không so sánh chi tiết về độ phủ dữ liệu, nên chưa có thông tin về chuyện bên nào nhiều dữ liệu hơn.

### Harvey và Sellbird có phải là một không?

Có. Harvey được đổi tên thành Sellbird từ phiên 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 giữ khi nâng cấp, và các biến HARVEY_* vẫn hoạt động nếu chưa đặt biến SELLBIRD_* tương ứng.
