# Sellbird: tự động tìm khách 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 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, kiểm tra email, viết và gửi cold email rồi xử lý thư trả lời. Nó dùng gói Claude Pro/Max hoặc ChatGPT có Codex nên không cần API key mô hình. Cài đặt cần quen dòng lệnh, mặc định không email nào gửi đi khi bạn chưa duyệt.

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

Sellbird là một nền tảng mã nguồn mở viết bằng Python, chạy ngay trên máy của bạn, để làm trọn chuỗi việc gửi cold email bán hàng. Nó tìm các công ty có vẻ cần thứ bạn bán, tìm người ra quyết định, kiểm tra địa chỉ email, viết cho mỗi người một email riêng, 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ẫn cùng lịch sử.

Bạn nên xem repo này nếu bạn làm kinh doanh B2B (bán dịch vụ, phần mềm, giải pháp cho các công ty nhỏ như phòng khám, xưởng, cửa hàng dịch vụ) và đang mất nhiều thời gian dò danh sách khách rồi viết thư từng cái. Dev mới cũng dùng được, vì có sẵn cách để Claude Code dẫn bạn cài đặt.

Điểm đáng giá nhất là chi phí. Sellbird “suy nghĩ” qua Claude Code CLI trên gói Claude Pro hoặc Max (hoặc qua Codex trên gói ChatGPT) mà bạn đang trả. Bạn không cần API key mô hình, không bị tính tiền theo token và không phải mua các công cụ tìm khách như Apollo hay ZoomInfo. Một điểm nữa: mặc định không email nào được gửi nếu 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 ra sao. Hiện repo có khoảng 5250 sao và 1127 fork.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | Nền tảng mã nguồn mở chạy trên máy bạn: tìm công ty và người quyết định, kiểm tra email, viết cold email riêng từng người, gửi và xử lý thư trả lời.
- 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 chạy hết từ đầu đến cuối, hoặc dừng ở bước nào cũng được.

- **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ó 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ị “cháy túi” bất ngờ.
- **Tìm lý do họ sẽ mua:** đọc chính website của từng công ty để tìm các tín hiệu mua hàng 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 nên không tốn tiền. Nhờ vậy 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:** tìm chủ hoặc quản lý được nêu tên trên các trang của chính công ty đó, tối đa hai người mỗi công ty. Bạn không bị “bắn” email vào cả đống địa chỉ.
- **Kiểm tra địa chỉ email:** học mẫu email của công ty rồi kiểm tra một địa chỉ. Mỗi địa chỉ được gắn nhãn đã xác minh, rủi ro, đoán, hoặc không hợp lệ. Chỉ địa chỉ gửi được mới được gửi tới. Điều này giúp bảo vệ uy tín hộp thư gửi của bạn.
- **Viết và gửi:** 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 số thư mỗi ngày và trong 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 trả lời, gạt thư tự động sang một bên, 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.

Ngoài ra còn vài thứ đáng chú ý:

- **Chỉ lấy danh sách:** nếu bạn chỉ cần danh sách khách, dừng sau bước kiểm tra email và chạy `sellbird export` để có file CSV sẵn sàng đưa vào công cụ gửi thư khác.
- **Hộp thư chờ duyệt (Outbox):** mọi email đi ra đều nằm chờ bạn duyệt cho đến khi bạn tự bật chế độ tự động (autopilot). Trước khi gửi còn có bước kiểm tra không dùng mô hình, loại bỏ email còn sót mã điền tự động, cụm từ bị cấm, email quá dài, thừa liên kết hoặc địa chỉ không gửi được.
- **Dashboard:** một trang điều khiển chạy trên máy bạn để xem và duyệt.
- **Sửa được “sổ tay bán hàng”:** thư mục `prompts/` và `skills/` chứa các kịch bản bán hàng bạn có thể chỉnh theo ý mì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 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.
- **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** (README có hướng dẫn riêng cho Codex trong tài liệu của repo).
- **Một hộp thư để gửi đ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ư đó.** Tác giả gợi ý dùng TrulyInbox, và Sellbird đọc tỷ lệ vào hộp thư đến của nó để báo bạn khi nào sẵn sàng. Lưu ý: các liên kết TrulyInbox trong dự án là liên kết affiliate, người duy trì có thể nhận hoa hồng.
- **Git** để tải mã nguồn về. Bạn cũng cần biết mở terminal.

Tệp `.env.example` liệt kê các biến cấu hình như `GMAIL_CLIENT_ID`, `SMTP_HOST`, `M365_CLIENT_ID`, `REOON_API_KEY`, `HUNTER_API_KEY`… Bạn không phải điền hết. Bạn chỉ điền phần ứng với dịch vụ mình dùng (hộp thư nào, công cụ kiểm tra email nào). README ghi “mỗi biến đều có chú thích ngay trong file”.

Về phần cứng, tư liệu không nói cần GPU hay cấu hình đặc biệt. Chi phí tìm công ty: 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ả. Hộp thư Google Workspace khoảng 7 USD mỗi tháng.

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

```steps
- Tải mã nguồn | Clone repo về máy bằng git
- Cài đặt | Tạo môi trường ảo Python và cài Sellbird
- Điền thông tin | Sao chép .env.example thành .env rồi điền khoá, hộp thư
- Dạy sản phẩm | Cho Sellbird đọc website của bạn
- Chạy | Xác nhận tín hiệu, tìm khách, mở dashboard và chạy vòng lặp
```

README đưa ra hai đường: nhờ Claude cài hộ, hoặc tự cài tay. Người mới nên thử đường thứ nhất.

### Cách dễ nhất: nhờ Claude Code cài hộ

Mở terminal ở 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
claude
```

Lệnh đầu tải mã nguồn về. Lệnh thứ hai đi vào thư mục vừa tải. Lệnh `claude` mở Claude Code ngay trong thư mục đó. Sau đó bạn gõ: **set up Sellbird for me** (hoặc diễn đạt tương tự). 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 thứ còn thiếu, hỏi những gì nó cần và “dạy” Sellbird về sản phẩm của bạn. Bạn chỉ cần trả lời các câu hỏi.

### Tự cài tay: tạo môi trường và cài gói

Nếu muốn tự làm, vào thư mục `sellbird` rồi chạy lệnh sau (README viết cho macOS/Linux):

```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`). README nhấn mạnh dùng `python3.13` chứ không phải `python3`, vì trên macOS `python3` trần là bản 3.9 quá cũ. Chỗ người mới hay vấp là quên kích hoạt môi trường ảo, khiến lệnh `sellbird` không tìm thấy.

README chưa ghi lệnh kích hoạt môi trường ảo riêng cho Windows. Nếu bạn dùng Windows, hãy xem thư mục `docs/` (mục Troubleshooting) hoặc dùng đường “nhờ Claude cài hộ” ở trên.

### Đ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` (file thật của bạn). Lệnh sau mở nó trong trình soạn thảo mặc định. Bạn điền thông tin hộp thư và các khoá của dịch vụ kiểm tra email nếu dùng. Đừng chia sẻ file `.env` cho ai.

### 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 trang đó để hiểu bạn bán gì, rồi ghi kết quả vào file `sellbird.local.yaml`. File này của riêng bạn, git không đụng tới.

### Xác nhận tín hiệu và tìm doanh nghiệp

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

Lệnh đầu giúp bạn xác nhận thế nào là một khách hàng tốt. Lệnh thứ hai 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

```bash
sellbird dashboard          # prints a private link to http://127.0.0.1:5555
sellbird run
```

Lệnh `dashboard` in ra một liên kết riêng tư tới địa chỉ chạy trên máy bạn (`http://127.0.0.1:5555`). Lệnh `sellbird run` bắt đầu vòng lặp: kiểm tra trạng thái, viết thư, xử lý thư trả lời, rồi nghỉ 15 phút trước khi lặp lại. Nếu muốn chạy bằng Docker (README nói dùng được trên Linux), repo có `Dockerfile` và `docker-compose.yml`, xem thêm hướng dẫn Docker trong `docs/`.

```note
Sellbird gửi email thật từ hộp thư của bạn. Hãy giữ chế độ mặc định (mọi thư chờ bạn duyệt) cho đến khi bạn đã đọc kỹ vài email mẫu. Cần dừng khẩn cấp thì chạy sellbird sending pause. Đừng bật autopilot khi chưa xem phần Legal and deliverability trong docs.
```

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

Sau khi chạy `sellbird run`, README cho thấy màn hình mẫu trông như sau:

```
Sellbird is online.
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
...
outbox    → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.
```

Dấu hiệu thành công là bạn thấy dòng “Sellbird is online”, các bước quyết định và dòng “Cycle complete”. Sau đó mở liên kết do `sellbird dashboard` in ra. Nếu trang dashboard mở được ở `http://127.0.0.1:5555` và bạn thấy hộp thư chờ duyệt (Outbox), tức là đã chạy.

Repo cũng có dữ liệu demo bịa sẵn (công ty “Bookwell” bán đặt lịch online cho thợ lợp mái, phòng nha, tiệm điều hoà, dùng tên miền `.test`). Nó giúp bạn xem giao diện trước khi chạy với dữ liệu thật.

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

### Chủ công ty phần mềm tìm khách là phòng khám nha khoa

Bối cảnh: bạn bán phần mềm đặt lịch hẹn, và khách mục tiêu là các phòng khám nhỏ chưa có đặt lịch online. Bạn chạy `sellbird train` với website của bạn để nó hiểu sản phẩm. Sau đó `sellbird signals --confirm free` để xác nhận tín hiệu như “chưa có đặt lịch online”, rồi `sellbird discover` để tìm phòng khám. Sellbird đọc website từng nơi, tìm chủ hoặc quản lý, kiểm tra email và soạn chuỗi thư ngắn nhắc đúng chi tiết của từng phòng khám. Kết quả: bạn mở Outbox và thấy các email đã viết sẵn, chờ bạn duyệt.

> Việc khó nhất của cold email không phải gửi, mà là biết gửi cho ai và nói điều gì cho đúng.
>
> — Ông T

### Nhân viên kinh doanh chỉ cần danh sách để dùng công cụ khác

Bối cảnh: công ty bạn đã có công cụ gửi thư riêng và chỉ thiếu danh sách khách sạch. Bạn chạy các bước tìm và kiểm tra, rồi dừng lại, không cho gửi. Chạy:

```bash
sellbird export
```

Bạn nhận về file CSV gồm những gì Sellbird tìm được, sẵn sàng đưa vào công cụ gửi thư (sequencer) khác. Mỗi địa chỉ đã có nhãn đã xác minh, rủi ro, đoán hoặc không hợp lệ, nên bạn dễ lọc bỏ địa chỉ xấu.

### Người phụ trách bán hàng duyệt và trả lời thư mỗi ngày

Bối cảnh: chiến dịch đã chạy, khách bắt đầu trả lời. Bạn mở dashboard, vào Outbox để duyệt các thư mới, và xem các thư trả lời Sellbird đã đọc. Với khách quan tâm hoặc phản đối, nó đã soạn sẵn câu trả lời để bạn sửa rồi duyệt. Thư tự động trả lời được gạt sang bên, yêu cầu từ chối nhận thư được ghi nhận ngay, và những thư nó thấy không nên tự trả lời sẽ được đẩy cho bạn. Kết quả: bạn chỉ phải quyết định, không phải đọc từng thư từ đầu.

### Dev tuỳ chỉnh giọng văn và cách bán

Bối cảnh: bạn thấy email viết ra chưa giống giọng công ty mình. Thư mục `prompts/` và `skills/` chứa các kịch bản bán hàng có thể sửa. Bạn chỉnh các file ở đó, và bản cài từ gói (pip/pipx) sẽ không ghi đè chỉnh sửa của bạn khi nâng cấp. Bạn cũng nên đặt các cài đặt riêng vào `sellbird.local.yaml` thay vì sửa `sellbird.yaml` gốc, để `git pull` không bị xung đột.

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

- **`python3 --version` báo 3.9 trên macOS:** đó là bản mặc định quá cũ. Chạy `brew install python@3.13` rồi dùng `python3.13` để tạo môi trường ảo, đúng như README dặn.
- **Lệnh `sellbird` không được nhận ra:** thường do chưa kích hoạt môi trường ảo hoặc chưa chạy `pip install -e .`. Kích hoạt lại `.venv` trong thư mục dự án rồi cài lại.
- **Claude chưa đăng nhập:** Sellbird dựa vào Claude Code CLI đã đăng nhập. Chạy `claude login` và đảm bảo gói của bạn là Pro hoặc Max (hoặc dùng Codex với gói ChatGPT).
- **Thư không vào hộp thư chính của khách:** hộp thư mới chưa được warmup dễ rơi vào spam. README khuyên warmup hộp thư trước khi gửi và dùng một tên miền gửi riêng. Đừng gửi hàng loạt ngay từ đầu.
- **Nâng cấp từ Harvey và `git pull` báo “your local changes would be overwritten”:** làm theo README: chạy `git stash`, `git pull`, rồi `git stash pop`. Nếu có xung đột trong `sellbird.yaml`, giữ các dòng của bạn, xoá dấu xung đột rồi chạy `git stash drop`. Tốt nhất là đặt cài đặt vào `sellbird.local.yaml` từ đầu.

Còn các lỗi khác, xem mục Troubleshooting trong thư mục `docs/` của repo, hoặc file `SUPPORT.md`.

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

**Điểm mạnh:** chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Không cần API key mô hình và không bị tính tiền theo token. Mặc định mọi thư chờ bạn duyệt, lại có bước kiểm tra trước khi gửi. Mỗi lần tìm trả phí đều hiện giá trước khi chạy. Giấy phép AGPL-3.0, repo vẫn được cập nhật trong vài tháng gần đây.

**Giới hạn:** bạn vẫn cần quen dòng lệnh, có gói Claude Pro/Max (hoặc ChatGPT có Codex) và một hộp thư gửi riêng được warmup. README chưa ghi hướng dẫn riêng cho Windows trong phần cài đặt. Bạn cũng phải tuân thủ quy định về gửi email thương mại ở nơi bạn và người nhận sinh sống. README có một mục Legal and deliverability để bạn đọc kỹ. Giấy phép AGPL-3.0 cũng đáng đọc kỹ nếu bạn định sửa đổi rồi cung cấp thành dịch vụ cho người khác.

**Khi nên chọn cách khác:** nếu bạn không muốn tự cài và tự vận hành, tác giả có bản chạy sẵn trên sellbird.ai (đang trong giai đoạn truy cập sớm). Nếu bạn chỉ gửi vài thư mỗi tuần cho khách quen, một công cụ gửi thư thông thường là đủ. Còn nếu bạn bán cho các doanh nghiệp nhỏ và muốn tự động hoá từ tìm khách đến trả lời mà vẫn kiểm soát được từng thư, Sellbird rất đáng thử.

## Câu hỏi thường gặp

### Sellbird có miễn phí không?

Mã nguồn miễn phí, giấy phép AGPL-3.0. Bạn cần gói Claude Pro/Max hoặc gói ChatGPT có Codex đang có sẵn, cùng một hộp thư gửi (README nhắc Google Workspace khoảng 7 USD mỗi tháng). Nguồn tìm doanh nghiệp 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ó cần API key của Claude hay OpenAI không?

Không. Sellbird dùng 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 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ó biến khoá riêng trong .env, nhưng bạn chỉ điền khi dùng.

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

Tư liệu không nói cần GPU hay cấu hình phần cứng đặc biệt. Phần suy nghĩ chạy qua Claude Code hoặc Codex, còn Sellbird chạy bằng 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 (%APPDATA%\sellbird), nhưng các lệnh cài đặt trong phần Quick start viết cho macOS/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/ hoặc nhờ Claude Code cài hộ.

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

Không, mặc định mọi email chờ trong Outbox cho đến khi bạn duyệt. Chỉ khi bạn tự bật autopilot thì thư mới tự đi, và dù vậy nó vẫn giữ lại thư có liên kết tới tên miền không phải của bạn. 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 của bạn, cấu hình, dữ liệu và cơ sở dữ liệu nằm trong một thư mục riêng của bạn. Dashboard mặc định chạy ở địa chỉ nội bộ 127.0.0.1. Tư liệu không nói thêm về mô hình bảo mật khác, nếu cần hãy đọc SECURITY.md trong repo.

### Sellbird khác gì bản trên sellbird.ai?

Repo này là bản mã nguồn mở bạn tự chạy. Theo README, sellbird.ai là bản lưu trữ sẵn, có sẵn tên miền gửi, hộp thư và warmup, đang trong giai đoạn truy cập sớm. Tư liệu chưa có thông tin chi tiết hơn về giá hay tính năng của bản đó.
