# Sellbird: tự tìm khách, viết và gửi cold email 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 mã nguồn mở viết bằng Python, giúp bạn tìm công ty phù hợp, tìm người quyết định, xác minh email, viết và gửi cold email rồi xử lý phản hồi. Nó chạy trên máy của bạn và dùng gói Claude Pro/Max hoặc ChatGPT (Codex) có sẵn, không cần API key của mô hình. Cài bằng vài lệnh, hoặc nhờ Claude Code cài giúp.

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

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

Bạn nên xem qua nếu bạn là chủ doanh nghiệp nhỏ, người làm sale, làm marketing hoặc lập trình viên cần một danh sách khách tiềm năng và muốn tiếp cận họ mà không phải trả tiền cho một loạt công cụ prospecting. Điểm đáng giá nhất là Sellbird "suy nghĩ" qua Claude Code CLI trên gói Claude Pro hoặc Max của bạn, hoặc qua Codex trên gói ChatGPT. Vì vậy không có API key mô hình và không bị tính tiền theo token.

Điểm an toàn thứ hai cũng quan trọng: 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.249 sao và 1.127 fork, và vẫn được cập nhật trong vài tháng gần đây. 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, tìm người ra quyết định, xác minh email, viết và gửi cold email cá nhân hoá, 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 (pipeline). Bạn chạy trọn từ đầu đến cuối, hoặc dừng ở bước nào tuỳ ý.

### 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" ngoài ý muốn.

### Đọc tín hiệu mua hàng

Sellbird đọc website của từng công ty để tìm những dấu 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 và không tốn tiền, vì mỗi công ty chỉ cần ba request HTTP. Kết quả là email của bạn có chi tiết thật để nhắc tới, thay vì câu chào chung chung.

### 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 trang web của công ty, tối đa hai người mỗi công ty. Bạn gửi đúng người có quyền gật đầu.

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

Sellbird 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ỉ có thể nhận được thư mới được gửi tới. Việc này giúp bảo vệ uy tín hộp thư gửi 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 đó 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ý phản hồi

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

Nếu bạn chỉ cần danh sách, hãy dừng sau bước xác minh và chạy `sellbird export` để lấy file CSV có thể đưa vào công cụ gửi mail 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 Python 3.9, nên nếu `python3 --version` báo 3.9, hãy chạy `brew install python@3.13` trước.
- **Gói Claude Pro hoặc Max** và đã đăng nhập Claude CLI bằng `claude login`. Hoặc **gói ChatGPT có Codex CLI**, cách thiết lập nằm trong tài liệu Codex 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) hộp thư đó.** Tác giả giới thiệu TrulyInbox, và Sellbird đọc được tỷ lệ vào hộp thư chính của dịch vụ này để báo bạn khi nào đã sẵn sàng. Đây là liên kết affiliate của người duy trì dự án, README có nói rõ.

Giấy phép là AGPL-3.0. Các bản Harvey đến 0.3.x trước đó dùng giấy phép MIT.

Trong tệp `.env.example` có nhiều biến tuỳ chọn, như thông tin Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ xác minh email (Reoon, ZeroBounce, Hunter)… Bạn không cần điền hết. Chỉ điền phần dịch vụ bạn thật sự dùng.

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

```steps
- Lấy mã nguồn | git clone repo rồi cd vào thư mục sellbird
- Cách nhanh: nhờ Claude cài | mở claude trong thư mục và nói "set up Sellbird for me"
- Hoặc cài thủ công | tạo môi trường ảo và pip install -e .
- Điền thông tin | sao chép .env.example thành .env rồi sửa
- Huấn luyện và tìm khách | chạy sellbird train, signals, discover
- Mở bảng điều khiển | chạy sellbird dashboard và sellbird run
```

### Lấy mã nguồn

Mở terminal (trên Windows là PowerShell hoặc Git Bash, trên macOS là Terminal) rồi chạy:

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

Lệnh đầu tải repo về máy. Lệnh thứ hai đi vào thư mục vừa tải. Mọi lệnh sau đều chạy trong thư mục này. Chỗ người mới hay vấp là chạy lệnh ở sai thư mục.

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

Nếu bạn đã có Claude Code, chỉ cần mở nó ngay trong thư mục vừa tải:

```bash
claude
```

Sau đó gõ câu: **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 những thông tin cần và huấn luyện Sellbird về sản phẩm của bạn. Với người mới, đây là đường dễ nhất.

### Hoặc tự cài thủ công

README đưa ra các lệnh sau (chú thích bằng dấu # là của tác giả):

```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 .

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

# 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

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

Giải thích từng bước:

- **Bước 1** 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 (`pip install -e .`). Lệnh này tạo ra lệnh `sellbird`. README dùng cú pháp của macOS/Linux. README chưa ghi lệnh kích hoạt riêng cho Windows, nên người dùng Windows hãy xem thêm mục Troubleshooting trong thư mục `docs/` của repo.
- **Bước 2** sao chép file mẫu thành `.env` rồi mở ra để sửa. Đây là nơi bạn điền thông tin hộp thư và các dịch vụ bạn dùng. Mỗi biến có chú thích ngay trong file. Trên Windows, `$EDITOR` có thể không có sẵn, bạn cứ mở file `.env` bằng Notepad cũng được.
- **Bước 3** cho Sellbird đọc website của bạn để hiểu bạn bán gì. Kết quả ghi vào `sellbird.local.yaml`. Hãy thay địa chỉ mẫu bằng website thật của bạn.
- **Bước 4** xác nhận những tín hiệu cho thấy một công ty là khách tốt.
- **Bước 5** tìm doanh nghiệp. Nguồn mặc định miễn phí, không cần tài khoản.
- **Bước 6** mở bảng điều khiển (lệnh in ra một đường link riêng tư tới địa chỉ 127.0.0.1:5555, chỉ truy cập được từ máy bạn), rồi bật vòng lặp chính bằng `sellbird run`.

Trên Linux bạn cũng có thể chạy bằng Docker. Repo có Dockerfile và docker-compose.yml. Hướng dẫn chi tiết nằm trong tài liệu Docker của repo.

```note
Mặc định Sellbird không gửi gì khi bạn chưa duyệt. Hãy giữ nguyên chế độ này cho đến khi bạn đã đọc kỹ email nháp, đã warmup hộp thư xong và hiểu quy định gửi email thương mại ở nước bạn. Mật khẩu hộp thư nằm trong file .env, đừng chia sẻ file này hay đưa nó lên GitHub.
```

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

Theo README, bạn biết mình đã chạy được khi:

1. Lệnh `sellbird dashboard` in ra một đường link riêng tư dạng `http://127.0.0.1:5555`. Mở link đó trong trình duyệt trên cùng máy sẽ thấy bảng điều khiển.
2. Lệnh `sellbird run` hiện dòng "Sellbird is online.", kiểm tra trạng thái dây chuyền, đưa ra quyết định (ví dụ viết chiến dịch cho các khách mới chưa có email nháp), rồi báo có bao nhiêu email đang chờ bạn duyệt trong Outbox. Sau đó nó nghỉ 15 phút rồi lặp lại.
3. Sau `sellbird discover`, bạn thấy danh sách doanh nghiệp xuất hiện trong bảng điều khiển.

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 bước `pip install -e .` chưa chạy xong. Xem thêm phần lỗi hay gặp bên dưới.

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

README dùng dữ liệu mẫu hoàn toàn bịa là công ty "Bookwell" bán phần mềm đặt lịch cho thợ lợp mái, phòng nha và tiệm điện lạnh, trên các tên miền `.test`. Bạn có thể hình dung theo đó.

### Chủ phần mềm quản lý lịch hẹn muốn có danh sách khách

Bạn bán phần mềm đặt lịch cho các cơ sở dịch vụ nhỏ và chỉ cần danh sách khách tiềm năng, chưa muốn gửi mail tự động. Bạn huấn luyện Sellbird bằng website của mình, xác nhận tín hiệu, tìm doanh nghiệp, rồi xuất file:

```bash
sellbird train https://your-company.com
sellbird signals --confirm free
sellbird discover
sellbird export
```

Kết quả là một file CSV các công ty, người quyết định và địa chỉ email đã được gắn nhãn verified, risky, guess hoặc invalid. Bạn đưa file này vào công cụ gửi mail bạn đang dùng. Chi phí của bước tìm kiếm là 0 đồng với nguồn mặc định.

> Sellbird không bắt bạn tin vào máy: mọi email đều nằm chờ bạn duyệt trước khi rời đi.
>
> — Ông T

### Nhân viên sale B2B chạy cả quy trình

Bạn làm sale cho một công ty phần mềm, đã có hộp thư Google Workspace trên tên miền gửi riêng và đã warmup. Bạn chạy đủ các bước, rồi mở bảng điều khiển bằng `sellbird dashboard` và bật vòng lặp bằng `sellbird run`. Mỗi chu kỳ, Sellbird viết chuỗi email ngắn, ví dụ hai email nhắc tới việc một công ty đang tuyển nhân viên điều phối. Các email này nằm trong Outbox. Bạn đọc, sửa nếu cần, rồi duyệt. Khi có phản hồi, nó soạn sẵn câu trả lời, bạn chỉ cần xem và quyết định.

### Lập trình viên muốn kiểm soát và tuỳ biến

Bạn là dev và muốn chỉnh cách Sellbird viết email. Repo có thư mục `prompts/` và `skills/`, README mô tả đó là các kịch bản bán hàng có thể chỉnh sửa. Bạn sửa các file này theo giọng văn của mình. Nếu cần thêm tính năng, tài liệu Extensions cho biết cách thêm route, bước trong vòng lặp hoặc lệnh từ một gói riêng. Khi muốn dừng khẩn cấp, bạn chạy:

```bash
sellbird sending pause
```

Lệnh này dừng toàn bộ việc gửi ngay lập tức.

### Người đang dùng Harvey muốn nâng cấp

Nếu bạn từng chạy Harvey, cấu hình, dữ liệu và đăng nhập bảng điều khiển vẫn dùng tiếp được. README hướng dẫ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ó không ghi đè file đã có tên mới. Nó cũng đợi nếu vẫn còn tiến trình Harvey đang chạy trong thư mục, nên hãy tắt tiến trình đó trước.

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

### Python quá cũ, cài đặt báo lỗi

Trên macOS, lệnh `python3` có thể là bản 3.9, trong khi Sellbird cần 3.11 trở lên. Hãy chạy `python3 --version` để kiểm tra. Nếu thấy 3.9, cài bản mới bằng `brew install python@3.13` rồi dùng `python3.13` để tạo môi trường ảo như README ghi.

### Gõ `sellbird` báo không tìm thấy lệnh

Thường do môi trường ảo chưa được kích hoạt, hoặc bước cài đặt chưa hoàn tất. Mở terminal mới, `cd` vào thư mục repo, kích hoạt lại môi trường ảo rồi chạy lại `pip install -e .`. Nhớ rằng lệnh `sellbird` chỉ có sau khi cài xong.

### Claude chưa đăng nhập nên không chạy được

Sellbird dùng Claude Code CLI trên gói của bạn. Nếu CLI chưa đăng nhập, nó sẽ không làm việc được. Hãy chạy `claude login` và đăng nhập đúng tài khoản có gói Pro hoặc Max. Nếu bạn dùng ChatGPT, hãy làm theo tài liệu Codex trong repo.

### `git pull` báo "your local changes would be overwritten"

Lỗi này xảy ra với người nâng cấp từ Harvey đã sửa trực tiếp file `harvey.yaml`. Cách xử lý theo README: chạy `git stash`, rồi `git pull`, rồi `git stash pop`. Nếu báo xung đột trong `sellbird.yaml`, hãy giữ các dòng của bạn, xoá các dấu xung đột, rồi chạy `git stash drop`. Về lâu dài, nên để thiết lập riêng trong `sellbird.local.yaml` vì git không đụng tới file này.

### Email gửi đi bị vào thư rác hoặc bị chặn

Đây là rủi ro chung của cold email, không riêng Sellbird. Hãy đảm bảo hộp thư đã được warmup, gửi từ tên miền riêng, và giữ giới hạn gửi mỗi ngày thấp. Đọc thêm tài liệu Legal and deliverability của repo. Nếu nghi ngờ, chạy `sellbird sending pause` để dừng rồi kiểm tra lại.

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

**Điểm mạnh.** Bạn không phải trả tiền API mô hình, vì nó dùng gói Claude hoặc ChatGPT sẵn có. Bước tìm doanh nghiệp và đọc website có thể tốn 0 đồng. Dữ liệu nằm trên máy bạn. README cũng nói rõ không cần các công cụ prospecting như Apollo, ZoomInfo, Clearbit hay Clay. Cơ chế an toàn khá chặt: mặc định phải duyệt từng email, có bước kiểm tra trước khi gửi không dùng mô hình (chặn thẻ chưa điền, cụm từ bị cấm, email quá dài, link thừa, địa chỉ không gửi được), và có lệnh dừng khẩn cấp.

**Giới hạn.** Bạn vẫn cần tự lo hộp thư gửi, tên miền riêng và warmup. Tôi không thấy tài liệu nói về dữ liệu doanh nghiệp tại Việt Nam. Nguồn mặc định là OpenStreetMap nên độ phủ phụ thuộc vào dữ liệu có trên bản đồ ở khu vực bạn nhắm tới. README viết bằng tiếng Anh và ví dụ hướng tới thị trường nói tiếng Anh. Việc viết email tiếng Việt chất lượng ra sao thì README chưa nói, bạn nên thử với vài liên hệ trước. Giấy phép AGPL-3.0 cũng có điều khoả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 làm vậy. Ngoài ra, gửi email thương mại có quy định pháp lý ở từng quốc gia, bạn tự chịu trách nhiệm tuân thủ.

**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 chạy sẵn trên sellbird.ai (đang ở 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 gửi vài chục email thủ công, một công cụ quen thuộc như bảng tính cộng hộp thư thường là đủ. Còn nếu bạn thoải mái với dòng lệnh và muốn kiểm soát toàn bộ quy trình, Sellbird là lựa chọn đáng thử.

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

### 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 Pro hoặc Max, hoặc qua 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ụ tuỳ chọn như xác minh email thì có biến API key riêng trong .env.example.

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

Mặc định thì không. Mọi email đều chờ trong Outbox cho đến khi bạn duyệt, trừ khi bạn tự bật chế độ 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 việc gửi ngay lập tức.

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

README không nhắc yêu cầu GPU, vì phần suy nghĩ do Claude hoặc Codex đảm nhiệm. README có nêu thư mục dữ liệu trên Windows (trong APPDATA) nên Windows được hỗ trợ ở mức nào đó. Tuy nhiên README chỉ ghi lệnh kích hoạt môi trường ảo cho macOS/Linux, và Docker được nói là dành cho Linux.

### 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, và cấu hình, dữ liệu, nhật ký nằm trong một thư mục riêng. Bảng điều khiển mở ở địa chỉ 127.0.0.1 với đường link riêng tư. Với việc gửi email, bạn vẫn phải tự giữ an toàn cho file .env chứa mật khẩu hộp thư.

### Sellbird khác gì Harvey?

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

### Có dùng được cho thị trường Việt Nam không?

Chưa có thông tin rõ trong README. Ví dụ và dữ liệu mẫu hướng tới thị trường nói tiếng Anh, và nguồn tìm mặc định là OpenStreetMap nên độ phủ phụ thuộc vào dữ liệu bản đồ. Bạn nên thử nhỏ trước khi dùng thật.
