# 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 tự động hoá cả chuỗi outreach: tìm khách hàng tiềm năng, kiểm tra email, viết thư cá nhân hoá, gửi và xử lý phản hồi. Nó dùng gói Claude Pro/Max hoặc ChatGPT có Codex bạn đang có, không cần API key của mô hình. Cài không quá khó nếu bạn quen terminal, nhưng cần thêm 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-05-29 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/sellbird-tu-dong-tim-khach-gui-cold-email-bang-claude-8

Sellbird là một nền tảng outreach mã nguồn mở, chạy ngay trên máy bạn, làm trọn chuỗi việc của người đi chào bán: 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 cold email riêng cho từng người, gửi đi và xử lý phản hồi. Repo này trước đây tên Harvey, sau đó đổi tên thành Sellbird. Hiện có khoảng 5.250 sao và 1.127 fork trên GitHub.

Người nên quan tâm là chủ doanh nghiệp nhỏ, nhân viên kinh doanh, freelancer, hoặc lập trình viên muốn có một hệ thống tìm khách chủ động mà không phải trả tiền cho Apollo, ZoomInfo, Clearbit hay Clay. README nói rõ Sellbird không dùng các công cụ prospecting đó.

Điểm đáng giá nhất có hai ý. Thứ nhất, phần “suy nghĩ” của Sellbird chạy qua Claude Code CLI trên gói Claude Pro hoặc Max của bạn (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. Thứ hai, mặc định không có 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, rồi quay lại đây làm theo từng bước.

```repo
- repo | ethanplusai/sellbird
- kind | Ứng dụng
- desc | Sellbird 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 soạn sẵn câu trả lời cho các phản hồi. Chạy trên máy 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 đường ống (pipeline). Bạn có thể 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 các doanh nghiệp giống khách hà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. Lợi ích: bạn không bị trừ tiền bất ngờ.
- **Tìm lý do họ sẽ mua.** Sellbird đọc website của chính công ty đó để tìm “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 và không tốn tiền, mỗi công ty chỉ cần ba request HTTP. Nhờ đó email sau này nói đúng việc của họ.
- **Tìm người quyết định.** Tìm chủ hoặc quản lý có tên trên 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.** Sellbird suy ra kiểu email của công ty và kiểm tra một địa chỉ. Mỗi địa chỉ được gắn nhãn verified, risky, guess hoặc invalid, và chỉ địa chỉ gửi được mới được dùng để gửi. Việc này giúp bạn bớt thư trả lại, một điều rất hại cho uy tín hộp thư.
- **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. Thư gửi từ 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.** Đọc mọi thư trả lời, soạn câu trả lời, 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 chỉ cần danh sách, bạn dừng sau bước kiểm tra email và chạy `sellbird export` để lấy file CSV đưa thẳng vào công cụ gửi mail khác.

Về an toàn: mọi email đi ra đều nằm trong Outbox chờ bạn duyệt, trừ khi chính bạn bật 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 merge tag chưa điền, có cụm từ bị cấm, quá dài, thừa link hoặc gửi tới địa chỉ không gửi được. Lệnh `sellbird sending pause` dừng mọi thứ ngay.

## Cần chuẩn bị gì

Theo README, bạn cần:

- **Python 3.11 trở lên** (pyproject.toml cũng yêu cầu >=3.11). Máy Mac mặc định có Python 3.9, nên nếu `python3 --version` báo 3.9 thì chạy `brew install python@3.13` trước.
- **Claude Pro hoặc Max** và đã đăng nhập CLI bằng `claude login`, hoặc **gói ChatGPT có Codex CLI**. Hướng dẫn Codex nằm trong tài liệu 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 cho hộp thư đó.** README giới thiệu TrulyInbox: warm hộp thư mới trước khi gửi cold email và giữ thư khỏi vào spam sau đó. Lưu ý: các link TrulyInbox trong dự án là link affiliate, người duy trì có thể nhận hoa hồng. Đây chỉ là gợi ý của tác giả, không bắt buộc theo README.
- Git, để tải mã nguồn.

Tư liệu không nói gì về yêu cầu phần cứng hay GPU. Nguồn tìm công ty mặc định không cần tài khoản. Các khoá như REOON_API_KEY, HUNTER_API_KEY hay ZEROBOUNCE_API_KEY chỉ xuất hiện trong file `.env.example` cho các dịch vụ tuỳ chọn.

```note
Sellbird gửi email thật từ hộp thư thật của bạn. Hãy dùng tên miền gửi riêng, không dùng hộp thư công ty chính, và đọc kỹ tài liệu Legal and deliverability trong repo trước khi bật autopilot. Giữ file .env ở máy bạn, đừng đăng lên GitHub hay gửi cho người khác vì trong đó có mật khẩu hộp thư.
```

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

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

README có hai đường: nhờ Claude cài giúp, hoặc tự làm. Mình đi theo đường tự làm trước, rồi nói đường nhờ Claude ở cuối.

### Tải mã nguồn

Mở terminal (Terminal trên Mac/Linux). Chạy hai lệnh sau để tải repo và đi vào thư mục:

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

Từ giờ mọi lệnh bên dưới phải chạy khi terminal đang ở trong thư mục `sellbird`. Người mới hay quên bước `cd` này.

### Tạo môi trường ảo và cài gói

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

Lệnh này làm ba việc nối nhau: tạo môi trường ảo `.venv`, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau khi xong bạn sẽ có lệnh `sellbird`. Dùng đúng `python3.13` (hoặc bản 3.11 trở lên của bạn) chứ đừng dùng `python3` trần nếu máy Mac còn bản 3.9.

Về Windows: README chỉ viết lệnh kích hoạt kiểu macOS/Linux (`source .venv/bin/activate`). README chưa ghi lệnh cho Windows, và phần Docker được ghi là dành cho Linux. Bạn xem thêm mục Troubleshooting và thư mục `docs/` trong repo trước khi thử trên Windows. Với đường dẫn dữ liệu, README có nói bản cài bằng pip lưu ở `%APPDATA%\sellbird` trên Windows.

### Điền thông tin đăng nhập

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

Lệnh đầu sao chép file mẫu thành `.env`, lệnh sau mở nó ra để sửa. Mỗi biến đều có chú thích ngay trong file. Với hộp thư Gmail bạn sẽ thấy GMAIL_CLIENT_ID và GMAIL_CLIENT_SECRET; với SMTP là SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD; còn các khoá kiểm tra email hay warmup thì tuỳ dịch vụ bạn chọn. Chỉ điền những gì bạn thực sự dùng. Nếu `$EDITOR` chưa được đặt, bạn cứ mở file `.env` bằng trình soạn thảo quen thuộc.

### Dạy Sellbird về sản phẩm của bạn

```bash
# 3. Learn your product from your website (writes sellbird.local.yaml).
sellbird train https://your-company.com
```

Thay địa chỉ bằng website của bạn. Sellbird đọc website và ghi hiểu biết về sản phẩm vào file `sellbird.local.yaml`. File này là của bạn, git không đụng tới.

### Xác nhận tín hiệu và tìm khách

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

Lệnh đầu chốt những “tín hiệu” cho biết một công ty là khách tốt. Lệnh sau tìm doanh nghiệp bằng nguồn mặc định, miễn phí, không cần tài khoản.

### Mở dashboard và bật vòng lặp

```bash
# 6. Open the dashboard and start the loop.
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`, tức là chỉ mở được trên máy bạn. `sellbird run` bật vòng lặp chính, cứ vài phút lại kiểm tra trạng thái và làm bước tiếp theo.

### Hoặc để Claude cài giúp

Nếu bạn đã có Claude Code, README có đường tắt:

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

Rồi gõ: “set up Sellbird for me”. 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 thứ còn thiếu, hỏi thông tin cần thiết và huấn luyện Sellbird về sản phẩm của bạn. Đây là cách dễ nhất cho người mới.

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

Sau khi cài, thử `sellbird dashboard`. Nếu thành công, terminal in ra một link riêng tới `http://127.0.0.1:5555`; mở link đó trên trình duyệt để thấy bảng điều khiển.

Với `sellbird run`, README mô tả màn hình mẫu như sau: dòng “Sellbird is online.”, rồi “Checking pipeline state...”, một dòng “Decision” (ví dụ viết chiến dịch cho prospect mới), các dòng của handler và writer, và dòng cuối cho biết có bao nhiêu email đang chờ bạn duyệt trong outbox, kèm “Cycle complete. Sleeping for 15 minutes.” Thấy kiểu đầu ra này là vòng lặp đã chạy. Con số và tên trong ví dụ README là dữ liệu mẫu bịa ra (công ty Bookwell bán đặt lịch cho thợ lợp mái, nha khoa, HVAC trên tên miền `.test`), nên của bạn sẽ khác.

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

Sellbird không thay đổi lòng tin của người nhận. Nó chỉ làm phần việc lặp đi lặp lại thay bạn, còn quyết định gửi vẫn nằm ở bạn.

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

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

Bạn bán phần mềm đặt lịch cho phòng khám nha khoa hoặc tiệm sửa chữa. Chạy `sellbird train` với website của bạn, xác nhận tín hiệu như “chưa có đặt lịch online”, rồi `sellbird discover`. Sellbird tìm doanh nghiệp trên OpenStreetMap, đọc website của họ và đưa ra danh sách công ty hợp. Kết quả: thay vì tự lục Google Maps, bạn có sẵn danh sách kèm lý do mỗi công ty có thể cần sản phẩm của bạn.

### Nhân viên sales chỉ cần danh sách để gửi bằng công cụ khác

Bạn đã có công cụ gửi mail riêng và chỉ muốn danh sách sạch. Chạy các bước tìm công ty, tìm người quyết định và kiểm tra email, rồi:

```bash
sellbird export
```

Kết quả là file CSV sẵn sàng đưa vào sequencer, mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid. Bạn có thể bỏ nhãn invalid và cân nhắc kỹ nhãn risky.

### Founder gửi chuỗi email cá nhân hoá

Bạn đã có hộp thư Google Workspace trên tên miền gửi riêng và đã warmup. Chạy `sellbird run`, để nó viết chuỗi email ngắn cho từng người dựa trên tín hiệu tìm được (ví dụ công ty đang tuyển một vị trí điều phối). Mở dashboard, vào Outbox và đọc từng thư. Thư nào ổn thì duyệt, thư nào không thì sửa. Kết quả: bạn chỉ mất thời gian đọc và duyệt thay vì viết từng thư.

### Xử lý phản hồi mà không bỏ sót

Khi có người trả lời, Sellbird đọc, phân loại (quan tâm, phản đối, thư tự động, từ chối nhận) và soạn sẵn câu trả lời. Người xin ngừng nhận thư được tôn trọng ngay. Những thư nó không nên tự trả lời được chuyển cho bạn. Bạn mở dashboard để xem và quyết định, và nếu cần dừng mọi thứ thì dùng `sellbird sending pause`.

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

- **Lệnh `python3` báo phiên bản 3.9 hoặc cài gói thất bại.** Máy Mac mặc định có Python 3.9 trong khi Sellbird cần 3.11 trở lên. Cài bản mới bằng `brew install python@3.13`, rồi tạo lại môi trường bằng `python3.13 -m venv .venv`.
- **Gõ `sellbird` báo không tìm thấy lệnh.** Thường là môi trường ảo chưa được kích hoạt trong terminal hiện tại, hoặc bạn mở terminal mới. Vào lại thư mục `sellbird` và chạy `source .venv/bin/activate`. Nếu đang nâng cấp từ Harvey, chạy `pip install -e .` một lần để có lệnh mới.
- **Claude hoặc Codex không phản hồi.** Sellbird dùng CLI bạn đã đăng nhập. Hãy chạy `claude login` (hoặc làm theo hướng dẫn Codex trong tài liệu) rồi thử lại. Gói của bạn cũng có hạn mức dùng; README nói Sellbird tự giảm tốc để chừa chỗ cho việc của bạn.
- **`git pull` bị chặn vì thay đổi cục bộ (khi nâng cấp từ Harvey).** Nếu bạn từng sửa trực tiếp `harvey.yaml`, 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 và chạy `git stash drop`. Cách tốt hơn là đặt cài đặt vào `sellbird.local.yaml`.
- **Email vào spam hoặc bị trả lại nhiều.** README nhấn mạnh warmup hộp thư và dùng tên miền gửi riêng. Hãy tạm dừng bằng `sellbird sending pause`, đọc phần Legal and deliverability trong repo và kiểm tra lại cách gửi.
- **Gặp lỗi khác.** Xem tài liệu Troubleshooting trong thư mục `docs/` của repo.

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

**Điểm mạnh.** Chạy trên máy bạn, dữ liệu nằm ở thư mục của bạn. Không cần API key mô hình, tận dụng gói Claude hoặc ChatGPT sẵn có. Nguồn tìm công ty mặc định miễn phí, bước đọc website không tốn tiền. Có cơ chế duyệt trước khi gửi và bước kiểm tra tự động trước khi thư đi. Giấy phép là AGPL-3.0, và repo còn được cập nhật trong vài tháng gần đây.

**Giới hạn.** Cần quen với terminal và Python, và phải chuẩn bị hộp thư, tên miền gửi và warmup, điều mà tự công cụ không làm thay. README chỉ giải thích cài đặt trên macOS/Linux, nên người dùng Windows nên đọc kỹ tài liệu trước. Cold email còn chịu ràng buộc pháp lý và quy định về spam ở từng nước; README có dẫn tới tài liệu pháp lý, nhưng bạn phải tự chịu trách nhiệm với việc gửi của mình. Vì giấy phép là AGPL-3.0, hãy đọc kỹ nếu bạn định đóng gói lại thành dịch vụ.

**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 early access, có sẵn tên miền gửi, hộp thư và warmup). Nếu bạn chỉ cần gửi một vài email thủ công, một công cụ nặng như thế này là thừa. Còn nếu bạn muốn thử, cứ để chế độ duyệt tay và bắt đầu với danh sách nhỏ.

## 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. Nguồn tìm công ty mặc định (OpenStreetMap) là $0 và bướ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 nhắc Google Workspace khoảng 7 đô la một tháng). Nguồn tìm trả phí hiện chi phí trước khi chạy.

### 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 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ố biến trong .env.example như REOON_API_KEY hay HUNTER_API_KEY là của các dịch vụ kiểm tra email tuỳ chọn, không phải của mô hình.

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

Tư liệu không nêu yêu cầu phần cứng nào và không nhắc đến GPU. Phần suy nghĩ chạy qua gói Claude hoặc ChatGPT của bạn, không chạy mô hình cục bộ.

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

README viết lệnh cài cho macOS/Linux và phần Docker được ghi là dành cho Linux. README chỉ nhắc rằng bản cài bằng pip lưu dữ liệu ở %APPDATA%\sellbird trên Windows. Chưa có hướng dẫn cài chi tiết cho Windows trong tư liệu, bạn nên xem thư mục docs/ và mục Troubleshooting trong repo.

### Email có tự gửi đi 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 đến khi bạn tự bật autopilot. Có bước kiểm tra trước khi gửi, và lệnh sellbird sending pause dừng mọi thứ ngay.

### 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, dữ liệu, cơ sở dữ liệu và log nằm trong một thư mục home của bạn, và dashboard mở ở địa chỉ 127.0.0.1. Tư liệu không nói thêm về các chi tiết bảo mật khác. Bạn nên tự giữ kín file .env vì trong đó có mật khẩu hộp thư.

### Tôi đang dùng Harvey thì có phải cài lại không?

Không. Harvey được đổi tên thành Sellbird từ bản 0.4.0, cấu hình, dữ liệu và đăng nhập dashboard được giữ lại. Bạn chạy git pull, pip install -e . một lần, rồi sellbird dashboard. Lệnh harvey cũ vẫn dùng được tạm thời nhưng sẽ bị bỏ trong bản sau.
