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

> Sellbird (trước đây là Harvey) là nền tảng mã nguồn mở viết bằng Python, giúp bạn làm outreach: tìm khách tiềm năng, xác minh email, viết thư lạnh và xử lý phản hồi. Nó dùng Claude Code CLI hoặc Codex trên gói thuê bao bạn đang có nê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 tự cài giúp, cần Python 3.11 trở lên và một hộp thư để gửi.

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

Sellbird là một nền tảng mã nguồn mở chạy trên máy của bạn, giúp làm cả chuỗi việc "tìm khách rồi gửi cold email": tìm công ty phù hợp, tìm người ra 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. Tên cũ của dự án là Harvey, giờ đã đổi thành Sellbird.

Điểm khiến mình thấy đáng chú ý nhất là chuyện chi phí và quyền kiểm soát. Sellbird không đòi API key của mô hình AI. Nó "suy nghĩ" qua Claude Code CLI trên gói Claude Pro hoặc Max, hoặc qua Codex trên gói ChatGPT. Nghĩa là bạn dùng luôn gói thuê bao đang trả, không bị tính tiền theo từng token. Mặc định, không có email nào được gửi đi khi bạn chưa duyệt.

Repo hiện có khoảng 5250 sao và 1127 fork. Ai nên dùng? Chủ doanh nghiệp nhỏ, nhân viên sales, người làm agency muốn tự động hoá việc tìm khách mà không muốn trả thêm cho Apollo, ZoomInfo hay Clay. Bạn xem video ngắn bên dưới để thấy nó chạy thế nào, rồi quay lại đây làm theo từng bước.

```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 cold email cá nhân hoá, gửi và xử lý trả lời, chạy bằng gói Claude hoặc ChatGPT của bạn.
- 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ông đoạn. Bạn có thể chạy hết, hoặc dừng ở bước nào cũng được.

- **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í 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.
- **Tìm lý do họ sẽ mua.** Sellbird đọc 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, hay đ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, chỉ gửi ba yêu cầu HTTP cho mỗi công ty.
- **Tìm người quyết định.** Nó tìm chủ hoặc quản lý có tên trên chính trang web 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 kiểu địa chỉ 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ư tới.
- **Viết và gửi.** Nó viết một chuỗi thư ngắn cho từng người dựa trên những gì tìm được. Thư được gửi từ Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn số thư mỗi ngày và theo giờ làm việc của người nhận.
- **Xử lý trả lời.** Nó đọc từng thư trả lời, soạn sẵn câu đáp, tách riêng thư tự động trả lời, 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ự đáp.

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` để có file CSV sẵn sàng đưa vào công cụ gửi thư khác.

Về an toàn, mọi email gửi đi đều nằm chờ trong hộp Outbox cho 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 không dùng mô hình, loại thư còn sót thẻ merge chưa điền, cụm từ bị cấm, thư quá dài, quá nhiều link, hoặc địa chỉ không gửi được. Lệnh `sellbird sending pause` dừng toàn bộ việc gửi ngay.

## 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 có sẵn Python 3.9, nên nếu `python3 --version` báo 3.9 thì phải cài thêm bằng `brew install python@3.13`.
- **Claude Pro hoặc Max**, đã đăng nhập Claude Code CLI bằng `claude login`. Hoặc **gói ChatGPT có Codex CLI** (repo có tài liệu riêng cho cách này).
- **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) cho hộp thư đó.** README giới thiệu TrulyInbox cho việc này. Tác giả ghi rõ link TrulyInbox là link affiliate. Đây chỉ là gợi ý, bạn không bắt buộc dùng.

Về chi phí: 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ả ở nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Phần còn lại là gói thuê bao của bạn và hộp thư (README nêu khoảng 7 USD một tháng cho Google Workspace).

Về hệ điều hành, README viết phần cài đặt theo kiểu macOS/Linux và nói Docker chạy được trên Linux. Bảng thư mục dữ liệu có ghi cả Windows. README không nói rõ cách cài trọn gói trên Windows, nên bạn xem thêm tài liệu Docker và Troubleshooting trong thư mục `docs/` của repo.

Các biến cấu hình nằm trong file `.env.example`, ví dụ `GMAIL_CLIENT_ID`, `SMTP_HOST`, `REOON_API_KEY`, `HUNTER_API_KEY`. Bạn chỉ điền những dịch vụ mình thật sự dùng.

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

Có hai đường: nhờ Claude Code cài giúp (dễ nhất), hoặc tự gõ lệnh. Phần dưới là tóm tắt cho cách tự làm.

```steps
- Tải mã nguồn | Clone repo về máy và vào thư mục dự án
- Cài đặt | Tạo môi trường ảo Python và chạy pip install -e .
- Điền thông tin | Sao chép .env.example thành .env rồi điền khoá cần dùng
- 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
- Chạy | Mở dashboard và chạy sellbird run
```

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

Mở terminal (Terminal trên macOS, hoặc cửa sổ dòng lệnh bạn quen dùng) và chạy ba lệnh sau. Lệnh đầu tải mã nguồn, lệnh hai vào thư mục vừa tải, lệnh 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ở ra, 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: nó kiểm tra máy của bạn, cài thứ còn thiếu, hỏi những gì cần hỏi và dạy Sellbird về sản phẩm của bạn. Chỗ người mới hay vấp: phải đứng trong thư mục `sellbird` rồi mới gõ `claude`, nếu không Claude Code sẽ không thấy `CLAUDE.md`.

### Hoặc tự làm: cài đặt

Lệnh dưới tạo môi trường ảo, kích hoạt và cài Sellbird. README dặn dùng `python3.13` chứ không dùng `python3`, vì trên macOS `python3` trần là bản 3.9. Dòng kích hoạt `source .venv/bin/activate` là của macOS/Linux. README không ghi dòng tương đương cho Windows.

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

### Hoặc tự làm: điền thông tin

Lệnh này sao chép file mẫu thành `.env` rồi mở bằng trình soạn thảo mặc định của bạn. Mỗi biến trong file đều có chú thích ngay bên cạnh.

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

Nếu `$EDITOR` chưa được đặt trên máy bạn, cứ tự mở file `.env` bằng trình soạn thảo quen dùng. Đừng chia sẻ file này cho ai vì nó chứa mật khẩu và khoá.

### Hoặc tự làm: dạy Sellbird về sản phẩm

Lệnh này đọc website công ty bạn để hiểu bạn bán gì. Kết quả được ghi vào file `sellbird.local.yaml`.

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

Thay địa chỉ bằng website thật của bạn.

### Hoặc tự làm: xác nhận tín hiệu và tìm khách

Lệnh đầu xác nhận thế nào là một khách 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.

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

### Hoặc tự làm: mở dashboard và chạy

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

`sellbird dashboard` in ra một đường link riêng tới địa chỉ `http://127.0.0.1:5555`, chỉ truy cập được trên máy bạn. `sellbird run` khởi động vòng lặp chính. Hai lệnh này cần chạy song song, nên bạn mở hai cửa sổ terminal.

Trên Linux bạn cũng có thể chạy bằng Docker, repo có sẵn `Dockerfile` và `docker-compose.yml`. README trỏ tới tài liệu Docker riêng trong `docs/`.

```note
Cold email có quy định pháp lý và rủi ro bị đánh dấu spam. Hãy đọc tài liệu "Legal and deliverability" trong repo trước khi gửi thật, dùng tên miền gửi riêng và warmup hộp thư. Giữ nguyên chế độ duyệt tay ở Outbox cho tới khi bạn thật sự tin vào chất lượng thư.
```

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

Sau khi chạy `sellbird run`, README cho thấy màn hình mẫu như sau: dòng "Sellbird is online.", rồi "Checking pipeline state...", rồi một dòng "Decision" cho biết nó sẽ làm gì tiếp theo, ví dụ viết chiến dịch cho các prospect mới. Tiếp theo là các dòng của handler (xử lý thư trả lời), writer (viết chuỗi thư) và outbox (số email đang chờ bạn duyệt). Cuối cùng là "Cycle complete. Sleeping for 15 minutes." Nghĩa là mỗi vòng xong, nó nghỉ 15 phút rồi lặp lại.

Bạn không cần thấy đúng từng chữ, nhưng nếu có dòng "online" và không báo lỗi thì cài đặt ổn. Mở link riêng do `sellbird dashboard` in ra để xem danh sách công ty, người liên hệ và Outbox. Repo cũng có dữ liệu demo giả (công ty "Bookwell" bán phần mềm đặt lịch cho thợ lợp mái, nha khoa, điện lạnh, dùng tên miền `.test`) để bạn xem thử mà không đụng tới khách thật.

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

Dưới đây là các tình huống bám đúng khả năng repo mô tả. Câu lệnh là lệnh có trong README.

### Chủ doanh nghiệp nhỏ muốn tìm khách địa phương

Bạn bán phần mềm đặt lịch hoặc dịch vụ cho các cửa hàng địa phương. Bạn chạy `sellbird train` với website của mình để Sellbird hiểu sản phẩm, rồi `sellbird signals --confirm free` để chốt các tín hiệu như "chưa có đặt lịch online". Sau đó `sellbird discover` tìm doanh nghiệp từ OpenStreetMap, miễn phí. Kết quả là một danh sách công ty có lý do cụ thể để bạn liên hệ, thay vì gửi đại trà.

> Không có email nào ra khỏi máy bạn khi bạn chưa bấm duyệt.
>
> — Ông T

### Nhân viên sales chỉ cần danh sách sạch

Bạn đã có công cụ gửi thư riêng và chỉ cần danh sách. Bạn cho Sellbird chạy tới bước tìm người quyết định và xác minh email, rồi chạy:

```bash
sellbird export
```

Bạn nhận file CSV gồm những gì Sellbird tìm được, sẵn sàng đưa vào công cụ gửi. Mỗi địa chỉ có nhãn verified, risky, guess hoặc invalid, nên bạn biết địa chỉ nào đáng tin.

### Người làm agency chạy chiến dịch cho khách

Bạn muốn có chuỗi thư riêng cho từng người nhận. Sellbird viết một chuỗi ngắn dựa trên những gì tìm được ở website, ví dụ "công ty đang tuyển một nhân viên điều phối", như trong ví dụ HVAC ở README. Các thư nằm ở Outbox. Bạn đọc, sửa, duyệt từng thư. Nếu có gì bất thường, `sellbird sending pause` dừng mọi thứ ngay.

### Người bận rộn muốn có người lo thư trả lời

Khi khách trả lời, Sellbird đọc, phân loại (quan tâm, phản đối, thư tự động), soạn sẵn câu đáp, và xử lý yêu cầu từ chối nhận thư ngay. Những thư nó không nên tự trả lời sẽ được chuyển cho bạn. Bạn chỉ mở dashboard, xem bản nháp, chỉnh và gửi.

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

### `python3 --version` báo 3.9 hoặc thấp hơn 3.11

Sellbird cần Python 3.11 trở lên. Trên macOS, 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. Dùng `python3` trần sẽ cài sai phiên bản.

### Lệnh `sellbird` không được nhận ra

Thường là do bạn chưa kích hoạt môi trường ảo, hoặc chưa chạy `pip install -e .`. Quay lại thư mục `sellbird`, kích hoạt `.venv` rồi cài lại. Nếu bạn nâng cấp từ Harvey, README nói cần chạy `pip install -e .` một lần để có lệnh `sellbird` mới.

### Claude không phản hồi hoặc báo chưa đăng nhập

Sellbird dùng Claude Code CLI trên gói thuê bao của bạn, nên cần đăng nhập trước bằng `claude login`. Nếu dùng ChatGPT, hãy xem tài liệu "Using a ChatGPT plan (Codex)" trong repo.

### `git pull` báo "your local changes would be overwritten" khi nâng cấp từ Harvey

Chuyện này xảy ra nếu bạn từng 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`. Cách tốt hơn: đặt cài đặt của bạn trong `sellbird.local.yaml`, file này git không đụng tới.

### Thư vào spam hoặc tỉ lệ gửi thấp

Đây là rủi ro chung của cold email, không riêng Sellbird. Hãy dùng tên miền gửi riêng, warmup hộp thư trước khi gửi, giữ số thư mỗi ngày thấp và đọc tài liệu "Legal and deliverability" trong repo. Không có công cụ nào đảm bảo thư tới hộp thư chính.

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

**Điểm mạnh.** Chạy trên máy của bạn, dùng gói Claude hoặc ChatGPT bạn đã có nên không phải trả tiền API theo token. Có bước duyệt tay mặc định, kiểm tra trước khi gửi không dùng mô hình, và lệnh dừng khẩn cấp. Nguồn tìm khách mặc định miễn phí. Giấy phép là AGPL-3.0, repo vẫn được cập nhật trong vài tháng gần đây, và có file `CLAUDE.md` để Claude Code cài đặt giúp bạn.

**Giới hạn.** Bạn vẫn cần hộp thư gửi, nên chuẩn bị tên miền riêng và warmup, nghĩa là có thêm chi phí và thời gian chuẩn bị. README viết cho macOS/Linux, nên người dùng Windows nên đọc kỹ tài liệu hoặc thử Docker. Dữ liệu từ OpenStreetMap phù hợp nhất với doanh nghiệp địa phương, không chắc đủ cho mọi ngành. Giấy phép AGPL-3.0 có ràng buộc nếu bạn muốn sửa và cung cấp lại như một dịch vụ. Và quan trọng nhất, chất lượng cold email vẫn phụ thuộc vào sản phẩm và cách bạn chọn tệp khách.

**Khi nào nên 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 sellbird.ai, đ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ỉ cần vài thư gửi tay cho khách quen, một công cụ đơn giản hơn là đủ. Còn nếu bạn muốn thử cách làm outreach tự động mà vẫn nắm quyền duyệt từng thư, Sellbird là một lựa chọn đáng cài thử.

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

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

Bản mã nguồn mở là miễn phí, giấy phép AGPL-3.0. 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ột tháng cho Google Workspace). 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ụ tuỳ chọn như xác minh email có biến API key riêng trong file .env.example.

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

Tư liệu không nhắc tới yêu cầu GPU. Phần suy luận chạy qua Claude Code hoặc Codex trên gói thuê bao của bạn, không chạy mô hình trên máy bạn.

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

README viết hướng dẫn cài theo kiểu macOS/Linux và nói Docker chạy được trên Linux. Bảng thư mục dữ liệu có ghi đường dẫn cho Windows, nhưng README không nêu rõ các bước cài trọn gói trên Windows. Bạn xem tài liệu Docker và Troubleshooting trong thư mục docs/ của 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 nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật autopilot. Lệnh sellbird sending pause dừng toàn bộ 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, kiến thức và dữ liệu nằm trong một thư mục riêng. Dashboard mở ở địa chỉ 127.0.0.1 với link riêng. Tư liệu không nói chi tiết hơn về bảo mật, và bạn vẫn nên giữ kín file .env. Repo có tệp SECURITY.md cho việc báo lỗi bảo mật.

### Sellbird khác gì Harvey?

Đó là cùng một dự án. Harvey được đổi tên thành Sellbird từ bản 0.4.0, giữ nguyên lịch sử. Cấu hình, dữ liệu và đăng nhập dashboard của bạn được chuyển sang tự động, README có hướng dẫn nâng cấp riêng.
