# 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 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, xác minh email, viết thư cá nhân hoá, gửi đi và soạn sẵn câu trả lời cho phản hồi. Cài đặt ở mức trung bình: cần Python 3.11 trở lên, Claude Code CLI đã đăng nhập và một hộp thư để gửi. Mặc định không có email nào được gửi nếu bạn chưa duyệt.

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

Sellbird là một nền tảng mã nguồn mở để làm outreach (tiếp cận khách hàng mới bằng cold email), chạy ngay trên máy của bạn. Nó tìm các công ty có thể 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 email riêng cho từng người, gửi đi rồi xử lý phản hồi. Dự án trước đây tên là Harvey, nay đã đổi tên thành Sellbird.

Bạn nên xem qua repo này nếu bạn là chủ doanh nghiệp nhỏ, người làm sale hoặc marketing, hoặc lập trình viên muốn có một "nhân viên bán hàng" chạy tự động mà không phải trả tiền thuê bao cho cả bộ công cụ prospecting. Repo hiện có khoảng 5250 sao và 1127 fork trên GitHub, giấy phép AGPL-3.0, và vẫn được cập nhật trong vài tháng gần đây.

Đ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ó. Bạn không cần API key của mô hình và không bị tính tiền theo token. Thêm một điểm nữa: mặc định không email nào được gửi khi bạn chưa bấm duyệt. Bạn có thể xem video ngắn bên dưới để thấy nó chạy thế nào, rồi quay lại đọc phần hướng dẫn.

```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 quyết định, kiểm tra email, viết cold email và xử lý phản hồi, chạy trên 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 chuỗi các bước. 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.** 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 thị chi phí trước khi chạy, nên không lo bị trừ tiền bất ngờ.
- **Tìm lý do họ sẽ mua.** Nó đọc website của từng công ty để tìm "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 AI nên không tốn thêm chi phí. README nói mỗi công ty chỉ cần khoảng ba request HTTP.
- **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 địa chỉ email.** Nó học quy luật đặt 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 những gì tìm được. Email gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong hạn mức 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 sẵ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 ngừng 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 tiềm năng, hãy dừng sau bước xác minh rồi chạy `sellbird export`. Lệnh này xuất ra một file CSV sẵn sàng để nạp vào công cụ gửi mail khác.

Về chi phí, README liệt kê rõ: 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 là 0 đồng. Phần viết và gửi dùng gói đăng ký bạn đã có, cộng với một hộp thư (README nêu Google Workspace khoảng 7 USD một tháng). Nó không dùng Apollo, ZoomInfo, Clearbit hay Clay.

## 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 ý máy Mac thường có sẵn Python 3.9, nên nếu `python3 --version` báo 3.9 thì cài thêm bằng `brew install python@3.13`.
- **Gói Claude Pro hoặc Max** với Claude Code CLI đã đăng nhập (lệnh `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 gợi ý dịch vụ TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Sellbird đọc tỉ lệ vào inbox từ đó để báo bạn khi nào đã sẵn sàng. Lưu ý đây là liên kết affiliate của người duy trì dự án, README có nói rõ.
- Về hệ điều hành, README hướng dẫn lệnh cho macOS và Linux, và nói chạy Docker được trên Linux. README cũng có nêu thư mục dữ liệu trên Windows (`%APPDATA%\sellbird`), nhưng phần cài nhanh chưa ghi lệnh kích hoạt môi trường ảo riêng cho Windows.

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

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

```steps
- Lấy mã nguồn | Tải repo về máy bằng git clone
- Tạo môi trường và cài | Tạo .venv rồi pip install -e .
- Đ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 sellbird discover
- Bật dashboard và vòng lặp | Chạy sellbird dashboard và sellbird run
```

README đưa ra hai cách: nhờ Claude cài hộ, hoặc tự làm từng lệnh. Mình đi qua cả hai.

### Cách dễ nhất: để Claude cài giúp

Mở terminal (Terminal trên Mac/Linux), rồi chạy ba lệnh sau. Lệnh đầu tải mã nguồn, lệnh thứ hai vào thư mục vừa tải, lệnh thứ ba mở Claude Code ngay trong thư mục đó.

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

Khi Claude Code mở lên, 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 cài đặt. Theo README, nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi những gì cần hỏi và huấn luyện Sellbird về sản phẩm của bạn. Bạn phải đã đăng nhập Claude Code trước đó (`claude login`).

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

Nếu muốn tự kiểm soát, làm theo từng lệnh dưới đây trong thư mục `sellbird` vừa clone.

**Bước 1: cài đặt.** Dùng `python3.13` chứ đừng dùng `python3` trần, vì trên macOS `python3` có thể là bản 3.9 quá cũ. Lệnh này tạo môi trường ảo `.venv`, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được.

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

**Bước 2: thêm thông tin đăng nhập.** Lệnh này sao chép file mẫu thành `.env` và mở bằng trình soạn thảo mặc định. README nói mỗi biến đều có chú thích ngay trong file.

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

**Bước 3: dạy Sellbird về sản phẩm của bạn.** Thay địa chỉ bằng website công ty bạn. Lệnh này ghi kết quả vào file `sellbird.local.yaml`.

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

**Bước 4: xác nhận thế nào là khách tiềm năng tốt.**

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

**Bước 5: tìm doanh nghiệp.** Nguồn mặc định miễn phí và không cần tài khoản.

```bash
sellbird discover
```

**Bước 6: mở dashboard và bắt đầu vòng lặp.** Lệnh `sellbird dashboard` in ra một đường link riêng tới `http://127.0.0.1:5555`. Mở link đó trong trình duyệt để xem Outbox và các màn hình khác.

```bash
sellbird dashboard
sellbird run
```

Người mới hay vấp ở hai chỗ. Một là gõ lệnh ngoài thư mục `sellbird`, nên hãy chắc bạn đã `cd sellbird`. Hai là quên kích hoạt `.venv`, khiến lệnh `sellbird` báo không tìm thấy. README chưa ghi lệnh kích hoạt môi trường ảo cho Windows, nên nếu dùng Windows, bạn nên xem thư mục `docs/` và mục Troubleshooting trong repo.

Về Docker, README chỉ nói "trên Linux bạn cũng có thể chạy bằng Docker". Repo có sẵn `Dockerfile` và `docker-compose.yml`, và hướng dẫn chi tiết nằm trong tài liệu Docker ở thư mục `docs/`.

```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 nóng hộp thư trước, và đừng bật chế độ tự động (autopilot) khi chưa đọc kỹ các email trong Outbox. Không chia sẻ file .env cho ai, vì trong đó có mật khẩu và khoá truy cập.
```

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

Cách kiểm tra đơn giản nhất là chạy `sellbird run`. Theo README, bạn sẽ thấy dòng "Sellbird is online.", sau đó nó kiểm tra trạng thái pipeline, đưa ra quyết định (ví dụ viết chiến dịch cho các prospect mới chưa có bản nháp), liệt kê việc của từng thành phần (handler, writer, outbox) và báo "Cycle complete" rồi nghỉ 15 phút trước chu kỳ kế tiếp.

Song song đó, mở link dashboard do `sellbird dashboard` in ra. Nếu bạn thấy giao diện và có email đang chờ duyệt trong Outbox thì hệ thống đã chạy đúng. Nếu chưa muốn gửi gì thật, cứ để nguyên: mặc định mọi email đều nằm chờ bạn duyệt.

Bạn cũng có thể thử chỉ với phần tìm kiếm: chạy `sellbird discover`, rồi `sellbird export` để xem file CSV kết quả.

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

### Chủ doanh nghiệp dịch vụ địa phương muốn có danh sách khách

Bạn bán phần mềm đặt lịch cho tiệm nha khoa, thợ mái nhà hoặc cửa hàng điều hoà. 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", rồi chạy `sellbird discover`. Nguồn OpenStreetMap miễn phí sẽ trả về doanh nghiệp phù hợp. Đây cũng chính là ví dụ demo trong README (một công ty tên "Bookwell" bán đặt lịch online, dữ liệu là dữ liệu giả).

> Mặc định không có email nào rời máy bạn cho tới khi bạn bấm duyệt — đó mới là chỗ khiến mình yên tâm thử.
>
> — Ông T

### Nhân viên sale chỉ cần danh sách, không cần gửi

Bạn đã có công cụ gửi mail riêng. Bạn chạy pipeline đến bước xác minh, rồi chạy:

```bash
sellbird export
```

Kết quả là một file CSV gồm công ty, người ra quyết định và địa chỉ đã được gắn nhãn. Chỉ các địa chỉ có thể gửi được mới nên đưa vào chiến dịch. Cách này giúp bạn tránh phải mua thêm công cụ tìm lead.

### Người làm outreach muốn duyệt từng email trước khi gửi

Bạn chạy `sellbird run` và để nó làm việc theo chu kỳ 15 phút. Mỗi lần có người mới, nó viết một chuỗi 2 email (ví dụ: nói về việc công ty đang tuyển người điều phối) và đưa vào Outbox. Bạn mở dashboard, đọc từng bản nháp, sửa hoặc 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 email còn sót merge tag chưa điền, cụm từ bị cấm, email quá dài, nhiều link thừa hoặc địa chỉ không gửi được.

### Xử lý phản hồi mà không bị ngập thư

Khi khách trả lời, Sellbird đọc, phân loại (ví dụ quan tâm hoặc phản đối), soạn sẵn câu trả lời, và bỏ qua thư trả lời tự động. Yêu cầu ngừng nhận email được tôn trọng ngay. Việc của bạn là đọc những thư nó đánh dấu cần bạn xử lý. Nếu cần dừng mọi thứ ngay lập tức, dùng:

```bash
sellbird sending pause
```

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

**Lệnh `sellbird` báo không tìm thấy.** Thường là bạn chưa chạy `pip install -e .` hoặc chưa kích hoạt `.venv` trong terminal hiện tại. Mở lại terminal, vào thư mục `sellbird`, kích hoạt môi trường ảo rồi thử lại.

**Python quá cũ.** Nếu `python3 --version` cho ra 3.9 (hay gặp trên Mac), cài bản mới hơn bằng `brew install python@3.13` và dùng `python3.13` để tạo môi trường ảo, đúng như README dặn.

**Claude Code chưa đăng nhập.** Sellbird dùng Claude Code CLI để "suy nghĩ". Nếu chưa đăng nhập, hãy chạy `claude login` bằng tài khoản Pro hoặc Max rồi chạy lại. Nếu bạn dùng ChatGPT, xem tài liệu về Codex trong thư mục `docs/`.

**`git pull` báo "your local changes would be overwritten" khi nâng cấp từ Harvey.** Đây là trường hợp 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 gặp xung đột trong `sellbird.yaml`, giữ lại 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 đặt cài đặt của bạn vào `sellbird.local.yaml` vì git không đụng tới file này.

**Email bị vào spam hoặc tỉ lệ vào inbox thấp.** Thường do hộp thư chưa được làm nóng hoặc dùng luôn tên miền chính. Hãy dùng tên miền gửi riêng, làm warmup và xem tài liệu "Legal and deliverability" của repo trước khi tăng số lượng gửi.

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

**Điểm mạnh.** Chạy trên máy bạn, dùng gói đăng ký sẵn có nên không phải trả tiền theo token. Phần tìm công ty và đọc website có thể chạy với chi phí 0 đồng. Cơ chế duyệt trước khi gửi và bước kiểm tra trước khi gửi là điểm cộng rất lớn cho an toàn. Mã nguồn mở nên bạn có thể đọc và chỉnh sửa prompt, skill của nó.

**Giới hạn.** Bạn phải tự lo hộp thư gửi, tên miền và warmup. Đây là phần quyết định cold email có vào được inbox hay không, và công cụ không thay bạn làm được hết. Cài đặt cần dùng terminal, và README chưa ghi chi tiết cho Windows. Nguồn tìm miễn phí (OpenStreetMap) hợp nhất với doanh nghiệp địa phương. Nếu bạn nhắm vào thị trường khác, bạn nên đọc tài liệu Discovery để xem nguồn nào phù hợp. Ngoài ra, gửi cold email có quy định pháp lý riêng tuỳ nơi, hãy tự đọc tài liệu pháp lý của repo và quy định ở nơi bạn hoạt động.

**Giấy phép.** Sellbird dùng AGPL-3.0 (các bản Harvey đến 0.3.x dùng MIT). Nếu bạn định tích hợp vào sản phẩm thương mại, hãy đọc kỹ giấy phép.

**Khi nào chọn cách khác.** Nếu bạn không muốn tự vận hành, README nhắc đến bản hosted tại trang chủ dự án (đang ở giai đoạn early access), đã lo 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, có lẽ một công cụ đơn giản hơn là đủ.

## 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. Tìm doanh nghiệp bằng nguồn mặc định và đọc website đều tốn 0 đồng. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex, một hộp thư để gửi (README nêu Google Workspace khoảng 7 USD một tháng) và có thể trả phí cho các nguồn tìm kiếm tuỳ chọn.

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

Không. Theo README, Sellbird dùng 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. Bạn chỉ cần đăng nhập Claude Code bằng lệnh claude login.

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

Tư liệu không nhắc đến yêu cầu GPU hay cấu hình phần cứng. Phần suy luận chạy qua Claude Code hoặc Codex chứ không chạy mô hình cục bộ. Yêu cầu được nêu rõ là Python 3.11 trở lên.

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

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

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

Mặc định là không. Mọi email nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật chế độ 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, link thừa và địa chỉ không gửi được. Lệnh sellbird sending pause dừng mọi thứ ngay.

### Dữ liệu của tôi lưu ở đâu, 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 (cơ sở dữ liệu, log, token dashboard nằm trong data/). Tư liệu không nói gì thêm về mức độ bảo mật ngoài điều đó, nên bạn tự giữ kỹ file .env.

### Tôi đang dùng Harvey thì nâng cấp thế nào?

Harvey được đổi tên thành Sellbird từ bản 0.4.0 và cấu hình, dữ liệu, đăng nhập dashboard của bạn được giữ nguyên. Bạn chạy git pull, pip install -e . một lần để có lệnh sellbird mới, rồi sellbird dashboard. Lần chạy đầu Sellbird tự đổi tên các file harvey.local.yaml và data/harvey.db sang tên mới.
