# 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 là nền tảng mã nguồn mở bằng Python giúp tự động hoá cả chuỗi outreach: tìm công ty, tìm người ra quyết định, kiểm tra email, viết thư cá nhân hoá, gửi và xử lý thư trả lời. Nó chạy trên máy bạn, dùng gói Claude Pro/Max hoặc ChatGPT (Codex) nên không cần API key mô hình. Cài không quá khó nhưng cần Python 3.11+, một hộp thư để gửi và nên có bước warmup.

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

Sellbird là một công cụ mã nguồn mở (trước đây tên Harvey) chạy trên máy của bạn, làm giúp cả chuỗi bán hàng bằng email lạnh: tìm doanh nghiệp phù hợp với khách hàng của 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 và xử lý thư trả lời.

Người nên dùng là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, và lập trình viên muốn có sẵn một “nhân viên outreach” mà không phải ghép nhiều công cụ trả phí. Hiện repo có khoảng 5.250 sao và 1.127 fork, và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất: 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. Nghĩa là không có API key mô hình và không bị tính tiền theo token. Mặc định, không email nào được gửi đi nếu bạn chưa duyệt. 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 | Sellbird tự tìm công ty 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 — chạy bằng gói Claude hoặc ChatGPT bạn đang có.
- 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, hoặc dừng ở bước nào tuỳ ý.

- **Tìm công ty.** Tìm doanh nghiệp khớp với 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. Bạn không bị trừ tiền bất ngờ.
- **Tìm lý do họ sẽ mua.** Sellbird đọc website của từng công ty để tìm “tín hiệu mua” 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, không tốn phí, chỉ cần vài yêu cầu HTTP cho mỗi công ty. Nhờ đó email của bạn có lý do cụ thể để mở đầu, thay vì một câu chào chung chung.
- **Tìm người quyết định.** 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.** Học quy luậ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 gửi thư. Việc này giúp bạn tránh gửi vào địa chỉ chết, vốn làm hỏng uy tín tên miền gửi.
- **Viết và gửi.** Viết một chuỗi thư ngắn cho từng người dựa trên những gì tìm được, rồi gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn mỗi ngày và theo giờ làm việc của người nhận.
- **Xử lý thư trả lời.** Đọc mọi thư trả lời, soạn sẵn câu đáp, tách riêng thư tự động, tôn trọng yêu cầu từ chối nhận thư ngay lập tức, và chuyển cho bạn những thư nó không nên tự trả lời.

Nếu bạn chỉ cần danh sách, hãy dừng sau bước kiểm tra email và chạy `sellbird export` để có file CSV sẵn cho công cụ gửi thư khác.

Về chi phí, theo README: tìm doanh nghiệp là 0 đồng trên nguồn mặc định, hoặc khoảng 0,37 USD cho 1.000 kết quả trên 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 một hộp thư (README nêu Google Workspace khoảng 7 USD mỗi tháng). Không cần 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 Python từ 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.
- **Một gói để Sellbird “suy nghĩ”:** Claude Pro hoặc Max với CLI đã đăng nhập (`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 cho hộp thư đó.** README giới thiệu TrulyInbox để “làm nóng” hộp thư mới trước khi gửi cold email, và Sellbird đọc tỷ lệ vào inbox của nó để báo khi nào bạn đã sẵn sàng. Lưu ý: link TrulyInbox trong dự án là link affiliate, tác giả có thể nhận hoa hồng.

File `.env.example` liệt kê nhiều biến tuỳ 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 những gì mình dùng, và README nói mỗi biến đều có chú thích ngay trong file.

Phần cứng: tư liệu không nêu yêu cầu GPU hay cấu hình tối thiểu. README chưa có hướng dẫn riêng cho từng hệ điều hành, nhưng bảng thư mục dữ liệu có nhắc macOS, Windows và Linux. Docker được README ghi là chạy được trên Linux.

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

```steps
- Mở thư mục dự án | Tải mã nguồn về máy và vào thư mục sellbird
- Cách nhanh: nhờ Claude | Chạy claude trong thư mục và nói “set up Sellbird for me”
- Hoặc tự cài | Tạo môi trường Python ảo, cài gói, tạo file .env
- 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
- Mở dashboard và chạy | Chạy sellbird dashboard rồi sellbird run
```

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

Mở terminal (trên Windows có thể dùng PowerShell hoặc Git Bash) và chạy:

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

Lệnh đầu tải repo về, lệnh sau đi vào thư mục vừa tải. Chỗ người mới hay vấp: các lệnh sau đó phải chạy trong đúng thư mục `sellbird` này.

### Cách nhanh: để Claude hướng dẫn cài

README có sẵn cách này. Trong thư mục `sellbird`, chạy:

```bash
claude
```

Rồi gõ câu: **“set up Sellbird for me”**. Theo README, 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 những gì còn thiếu, hỏi những thông tin cần và dạy Sellbird về sản phẩm của bạn. Với người mới, đây là đường dễ nhất. Điều kiện là bạn đã cài Claude Code và đăng nhập bằng `claude login`.

### Hoặc tự cài từng lệnh

Tạo môi trường ảo và cài gói. README nhấn mạnh dùng `python3.13` chứ không dùng `python3`, vì trên macOS `python3` trần là bản 3.9:

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

Lệnh này tạo 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. Dòng `source ...` là cú pháp macOS/Linux. README không ghi lệnh kích hoạt riêng cho Windows, nên nếu dùng Windows bạn nên dùng cách để Claude hướng dẫn ở trên, hoặc xem thêm tài liệu trong thư mục `docs/` của repo.

Tiếp theo, tạo file cấu hình:

```bash
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 điền thông tin đăng nhập (hộp thư, dịch vụ kiểm tra email…). Mỗi biến có chú thích ngay trong file. Đừng đưa file `.env` cho ai và đừng đăng nó lên mạng.

```note
.env chứa mật khẩu và khoá truy cập hộp thư. Không chia sẻ, không đăng lên GitHub. Tốt nhất dùng một hộp thư và tên miền gửi riêng, đừng dùng hộp thư công việc chính của bạn.
```

### 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ông ty bạn. Sellbird đọc website để hiểu bạn bán gì và ghi kết quả vào file `sellbird.local.yaml`. File này là của bạn, git không động tới.

### Xác nhận kiểu khách hàng tốt

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

Bước này để bạn xác nhận những “tín hiệu” cho thấy một công ty là khách hàng tốt. README nói có 29 tín hiệu. Tham số `free` là đúng như trong README.

### Tìm doanh nghiệp

```bash
sellbird discover
```

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

### Mở dashboard và chạy

```bash
sellbird dashboard
sellbird run
```

`sellbird dashboard` in ra một đường link riêng tư tới `http://127.0.0.1:5555`, tức là chỉ mở được trên máy bạn. `sellbird run` khởi động vòng lặp chính. Nếu dùng Linux, bạn cũng có thể chạy bằng Docker. Repo có sẵn `Dockerfile` và `docker-compose.yml`, chi tiết xem tài liệu Docker trong `docs/`.

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

Khi chạy `sellbird run`, bạn sẽ thấy dòng “Sellbird is online.” rồi một chu kỳ báo cáo. README minh hoạ kết quả có dạng như sau:

```
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
  writer    → 2-email sequence: Phoenix HVAC hiring a dispatcher
  outbox    → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.
```

Cách kiểm tra thực tế:

1. Chạy `sellbird dashboard`, mở link nó in ra, và xem có vào được giao diện không.
2. Sau `sellbird discover`, xem dashboard có danh sách công ty chưa.
3. Sau `sellbird run`, kiểm tra Outbox. Nếu có thư đang chờ duyệt, nghĩa là dây chuyền đã chạy tới bước viết thư.

Dữ liệu demo trong repo là bịa (công ty “Bookwell” bán phần mềm đặt lịch trên tên miền `.test`), nên đừng nhầm đó là khách thật.

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

### Chủ dịch vụ địa phương tìm khách mới

Bạn là chủ một công ty bán phần mềm đặt lịch cho phòng khám nha khoa. Bạn chạy lần lượt `sellbird train` với website của mình, `sellbird signals --confirm free`, rồi `sellbird discover`. Sellbird tìm các phòng khám trên OpenStreetMap, đọc website của họ để xem ai chưa có đặt lịch online, rồi tìm chủ phòng khám. Kết quả là một danh sách khách tiềm năng kèm lý do cụ thể để liên hệ, thay vì danh sách tên chung chung.

### Chỉ lấy danh sách, gửi bằng công cụ khác

Bạn đã có công cụ gửi thư quen dùng và chỉ cần thêm lead. Bạn chạy pipeline tới bước kiểm tra email, rồi chạy:

```bash
sellbird export
```

Bạn nhận file CSV sẵn cho công cụ gửi thư, với các địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid. Bạn có thể lọc lấy địa chỉ verified để gửi.

> Mặc định, không email nào rời khỏi máy bạn nếu bạn chưa bấm duyệt.
>
> — Ông T

### Duyệt thư và trả lời khách mỗi sáng

Bạn để `sellbird run` chạy nền. Mỗi sáng bạn mở dashboard, vào Outbox, đọc các thư chờ duyệt và bấm duyệt những thư ưng ý. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ loại các thư còn sót mẫu chưa điền, có 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. Với thư trả lời, Sellbird soạn sẵn câu đáp cho khách quan tâm hoặc phản đối, còn thư tự động thì tách riêng. Bạn chỉ phải xử lý những ca nó không nên tự trả lời.

### Dừng khẩn cấp khi thấy có vấn đề

Giả sử bạn thấy một thư soạn sai giọng điệu và muốn dừng mọi thứ để chỉnh lại. 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. Bạn có thể chỉnh nội dung, kiểm tra lại rồi mới tiếp tục.

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

**Báo lỗi hoặc ra phiên bản Python cũ.** Nếu `python3 --version` cho ra 3.9 (hay gặp trên macOS), hãy cài Python mới theo README bằng `brew install python@3.13`, rồi tạo môi trường ảo bằng `python3.13` chứ không dùng `python3`.

**Lệnh `sellbird` không tìm thấy.** Thường do chưa kích hoạt môi trường ảo hoặc chưa chạy `pip install -e .`. Hãy kiểm tra bạn đang ở trong thư mục `sellbird` và môi trường `.venv` đã được kích hoạt, rồi cài lại.

**Claude hoặc Codex chưa đăng nhập.** Sellbird dựa vào CLI đã đăng nhập, nên nếu chưa chạy `claude login` thì phần viết thư sẽ không chạy được. Với ChatGPT, xem tài liệu “Using a ChatGPT plan (Codex)” trong `docs/`.

**Thư không vào inbox hoặc vào spam.** Thường do hộp thư chưa warmup hoặc tên miền mới. README nhấn mạnh phải có warmup trước khi gửi cold email, và Sellbird có thể đọc tỷ lệ vào inbox từ TrulyInbox để báo bạn khi nào sẵn sàng. Đừng bật gửi hàng loạt khi hộp thư còn mới. Hãy đọc tài liệu “Legal and deliverability” trong `docs/` để biết các quy định bạn đang gửi thư theo, nhất là khi gửi cho khách ở nước khác.

**Nâng cấp từ Harvey bị chặn khi `git pull`.** Nếu bạn từng sửa trực tiếp file `harvey.yaml`, `git pull` sẽ dừng với thông báo “your local changes would be overwritten”. README hướng dẫn chạy `git stash`, `git pull`, rồi `git stash pop`. Nếu báo xung đột, giữ các dòng của bạn, xoá 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`, file mà git không đụng tới.

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

**Điểm mạnh.** Không phải trả tiền API mô hình nếu bạn đã có gói Claude hoặc ChatGPT. Chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Có bước duyệt thủ công mặc định, kèm kiểm tra trước khi gửi bằng quy tắc cứng. Có thể dùng từng phần: chỉ lấy danh sách, hoặc chạy cả chuỗi. Prompt và “kỹ năng” bán hàng nằm trong thư mục `prompts/` và `skills/` để bạn chỉnh sửa.

**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 khó nhất với người mới. Nguồn tìm miễn phí (OpenStreetMap) phù hợp nhất với doanh nghiệp địa phương, còn mảng khác có thể cần nguồn trả phí. README không nói rõ mức độ phủ cho thị trường Việt Nam, nên bạn hãy thử với một nhóm nhỏ trước. Giấy phép là AGPL-3.0, bạn nên đọc kỹ nếu định dùng mã trong sản phẩm thương mại. Phần Windows chưa có hướng dẫn riêng trong README.

**Khi nào chọn cách khác.** Nếu bạn không muốn tự vận hành, dự án có bản hosted tại trang chủ sellbird.ai (README nói đang trong giai đoạn early access, 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 thư thủ công, một công cụ gửi thư đơn giản là đủ. Và dù chọn cách nào, hãy bắt đầu với số lượng nhỏ, duyệt từng thư, và tìm hiểu quy định gửi email thương mại trước khi mở rộng.

## 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 và bản tự chạy không tính phí phần mềm. Theo README, nguồn tìm doanh nghiệp mặc định là miễn phí, đọc website không tốn phí, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả. Bạn vẫn cần gói Claude/ChatGPT và một hộp thư gửi (README nêu Google Workspace khoảng 7 USD mỗi 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 mô hình và không tính tiền theo token. Một số dịch vụ tuỳ chọn khác như kiểm tra email thì có biến key riêng trong file .env.example.

### Cần GPU hoặc máy mạnh không?

Tư liệu không nêu yêu cầu GPU hay cấu hình phần cứng. Phần suy nghĩ chạy qua dịch vụ Claude hoặc Codex mà bạn đăng nhập, còn Sellbird 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 mẫu viết theo kiểu macOS/Linux và chưa có hướng dẫn cài riêng cho Windows. Bạn có thể nhờ Claude Code hướng dẫn bằng cách nói “set up Sellbird for me”, hoặc xem thư mục docs/ trong repo.

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

Mặc định thì không. Mọi email chờ trong Outbox để bạn duyệt cho tới khi bạn tự bật 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.

### Dữ liệu của tôi có an toàn không?

Sellbird chạy trên máy bạn, cấu hình, kiến thức và dữ liệu nằm trong một thư mục riêng của bạn, dashboard mở ở địa chỉ 127.0.0.1. README không nói chi tiết hơn về bảo mật. Bạn vẫn nên giữ kín file .env và dùng hộp thư riêng để gửi; vấn đề bảo mật có thể xem SECURITY.md.

### Khác gì Harvey và bản sellbird.ai?

Harvey là tên cũ của chính dự án này, đổi tên thành Sellbird từ bản 0.4.0, và cấu hình, dữ liệu của bạn được mang sang. Còn sellbird.ai là bản hosted do tác giả cung cấp, lo sẵn tên miền gửi, hộp thư và warmup, README nói đang trong giai đoạn early access.
