Bỏ qua tới nội dung
Ông T.vn

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

12 phút đọcCập nhật
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

Tóm tắt nhanh

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 công ty, tìm người ra quyết định, xác minh email, viết cold email 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) sẵn có nên không cần API key mô hình. Cài bằng vài lệnh, hoặc nhờ Claude Code cài giúp; mặc định không có email nào được gửi đi khi bạn chưa duyệt.

Sellbird là một nền tảng mã nguồn mở để làm outreach (tiếp cận khách hàng mới bằng email). Nó tìm các công ty có thể cần thứ bạn bán, tìm người quyết định, kiểm tra địa chỉ email, viết cho mỗi người một thư riêng, gửi đi và 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ử và cùng tác giả.

Bạn nên xem qua repo này nếu bạn là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, hay freelancer đang cần tìm khách mới mà không muốn trả tiền cho cả bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Theo README, Sellbird không dùng các công cụ đó. Repo hiện 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.

Điểm đáng giá nhất là hai thứ. Thứ nhất, nó “nghĩ” bằ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. Thứ hai, mặc định không có email nào rời máy bạn nếu bạn chưa duyệt. Bạn có thể xem video ngắn bên dưới để hình dung trước, rồi quay lại đọc phần cài đặt.

Ứng dụng

ethanplusai/sellbird

Sellbird tự tìm công ty hợp khách hàng, tìm người quyết định, kiểm tra email, viết thư cá nhân hoá, gửi đi và xử lý thư trả lời, chạy trên gói Claude hoặc ChatGPT của bạn.

★ 5.2kPythonAGPL-3.0
Xem repo trên GitHub
Video giới thiệu sellbirdXem trên YouTubeXem trên Facebook

I.Sellbird làm được gì

Sellbird là một dây chuyền gồm nhiều bước. Bạn có thể chạy trọn vẹn hoặc dừng ở bất kỳ bước nào.

  • 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. Nhờ vậy bạn không bị “cháy túi” bất ngờ.
  • Hiểu vì sao họ sẽ mua. Nó đọc website của từng công ty để tìm các tín hiệu mua hàng mà 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 nên không tốn tiền. README nói mỗi công ty chỉ cần ba request HTTP.
  • Tìm người quyết định. Nó tìm chủ hoặc quản lý được nêu tên ngay trên các trang của công ty đó, tối đa hai người mỗi công ty. Bạn không phải gửi thư đại trà vào hộp thư chung.
  • Kiểm tra địa chỉ email. Nó 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, và chỉ địa chỉ gửi được mới được dùng để gửi. Việc này giúp bạn giảm thư bị trả lại, vốn làm hỏng uy tín tên miền gửi thư.
  • 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, rồi gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn. Thư chỉ gửi trong giới hạn mỗi ngày và trong giờ làm việc của người nhận.
  • Xử lý thư trả lời. Nó đọ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ứ không nên tự trả lời.

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 để lấy file CSV dùng được ngay với các công cụ gửi thư hàng loạt.

Có thêm một lớp an toàn đáng chú ý. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ chặn thư còn sót merge tag chưa điền, cụm từ bị cấm, thư quá dài, thư có thêm link, và địa chỉ không gửi được. Ngay cả khi bạn bật autopilot, thư có link tới tên miền không phải của bạn vẫn bị giữ lại.

II.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 mặc định đ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 Code CLI bằng claude login. Hoặc gói ChatGPT có Codex CLI (README có hướng dẫn riêng cho Codex).
  • 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. Chi phí tham khảo trong README là khoảng 7 USD mỗi tháng cho Google Workspace.
  • Warmup (làm nóng) hộp thư. README khuyên dùng TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Sellbird đọc tỷ lệ inbox của TrulyInbox để báo bạn khi nào sẵn sàng. Lưu ý: link TrulyInbox trong dự án là link affiliate, tác giả có thể nhận hoa hồng.

Về hệ điều hành, README chỉ nói rõ lệnh mẫu cho macOS và Linux, kèm đường dẫn thư mục dữ liệu cho cả macOS, Windows và Linux. Docker được ghi là chạy trên Linux. Nếu bạn dùng Windows, hãy xem thêm trong thư mục docs/ của repo trước khi bắt đầu.

File .env.example liệt kê nhiều biến cấu hình, chẳng hạn cho Gmail, SMTP/IMAP, Microsoft 365, Instantly, các dịch vụ xác minh email như Reoon, ZeroBounce, Hunter, cùng TrulyInbox. Bạn không phải điền hết, chỉ điền phần ứng với dịch vụ bạn thật sự dùng.

Sellbird gửi email thật từ hộp thư của bạn. Hãy dùng một tên miền gửi riêng chứ không dùng tên miền chính của công ty, và đọc phần “Legal and deliverability” trong thư mục docs/ về quy định gửi thư. Quy định về email quảng cáo khác nhau theo từng nước, nên bạn tự kiểm tra trước khi gửi cho khách thật.

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

  1. Lấy mã nguồnClone repo về máy và vào thư mục dự án
  2. Cài gói PythonTạo môi trường ảo và cài Sellbird
  3. Điền thông tin đăng nhậpSao chép .env.example thành .env rồi điền
  4. Dạy Sellbird về sản phẩmChạy sellbird train với website của bạn
  5. Xác nhận khách lý tưởngChạy sellbird signals và sellbird discover
  6. Mở bảng điều khiểnChạy sellbird dashboard rồi sellbird run

README có hai cách: nhờ Claude cài giúp, hoặc tự gõ lệnh. Người mới nên thử cách thứ nhất trước.

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

Mở terminal (trên Windows là PowerShell hoặc Git Bash, trên macOS là Terminal), rồi chạy ba lệnh sau. Lệnh đầu tải mã nguồn về, lệnh hai vào thư mục vừa tải, lệnh ba mở Claude Code ngay trong thư mục đó.

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

Khi Claude Code mở ra, bạn gõ “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 cài đặt: kiểm tra máy của bạn, cài những gì còn thiếu, hỏi những thông tin cần thiết và dạy Sellbird về sản phẩm của bạn. Chỗ dễ vấp: bạn phải đứng đúng trong thư mục sellbird khi gõ claude, nếu không Claude sẽ không đọc được CLAUDE.md của dự án.

B.Cài bằng tay: tạo môi trường và cài gói

Nếu muốn tự làm, hãy chạy lệnh sau trong thư mục sellbird. Lệnh này tạo môi trường ảo .venv, kích hoạt nó rồi cài Sellbird.

Terminal
# 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 .

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 quá cũ. Dòng source .venv/bin/activate là cú pháp của macOS và Linux. README chưa ghi lệnh kích hoạt cho Windows, nên người dùng Windows hãy xem thư mục docs/ hoặc phần Troubleshooting trong repo.

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

Sao chép file mẫu thành .env, rồi mở ra để điền. README nói mọi biến đều có chú thích ngay trong file.

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

$EDITOR là trình soạn thảo mặc định của terminal. Nếu bạn không quen, cứ mở file .env bằng trình soạn văn bản quen thuộc rồi lưu lại. Đừng gửi file .env cho người khác hay đưa lên GitHub, vì trong đó có mật khẩu hộp thư.

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

Lệnh dưới đây cho Sellbird đọc website của công ty bạn để hiểu bạn bán gì, bán cho ai. Kết quả được ghi vào file sellbird.local.yaml.

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

Hãy thay https://your-company.com bằng địa chỉ website thật của bạn.

E.Xác nhận khách lý tưởng và tìm doanh nghiệp

Hai lệnh tiếp theo xác nhận thế nào là khách tiềm năng tốt, rồi tìm doanh nghiệp. Nguồn mặc định miễn phí và không cần tài khoản.

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

F.Mở bảng điều khiển và chạy vòng lặp

Lệnh sellbird dashboard in ra một đường link riêng tư tới http://127.0.0.1:5555. Đây là địa chỉ chỉ mở được trên máy bạn. Sau đó sellbird run khởi động vòng lặp chính.

Terminal
# 6. Open the dashboard and start the loop.
sellbird dashboard          # prints a private link to http://127.0.0.1:5555
sellbird run

Nếu bạn dùng Linux, README nói bạn cũng có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, và chi tiết nằm trong tài liệu Docker của repo.

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

Có ba dấu hiệu để biết mọi thứ ổn.

Trước hết, chạy python3 --version (hoặc python3.13 --version) và xác nhận số phiên bản từ 3.11 trở lên. Sau đó chạy sellbird dashboard. Nếu lệnh sellbird được nhận ra và in ra một link riêng tư tới http://127.0.0.1:5555, tức là gói đã cài xong. Mở link đó trên trình duyệt của máy bạn để xem bảng điều khiển.

Cuối cùng, chạy sellbird run. Theo README, bạn sẽ thấy dòng “Sellbird is online”, rồi các dòng kiểu “Checking pipeline state…”, “Decision: …” và “Cycle complete. Sleeping for 15 minutes.” Giữa đó là các dòng cho biết agent nào đang làm gì (handler, writer, outbox). Ví dụ trong README có dòng “outbox → 5 emails waiting for your approval”, nghĩa là các thư đang chờ bạn duyệt chứ chưa gửi.

Nếu sellbird báo không tìm thấy lệnh, hãy kiểm tra bạn đã kích hoạt môi trường ảo .venv trong cửa sổ terminal hiện tại chưa.

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

A.Chủ công ty dịch vụ nhỏ cần danh sách khách

Bạn bán phần mềm đặt lịch cho phòng khám nha khoa và tiệm sửa điều hoà, và chưa muốn gửi thư tự động. Bạn chạy sellbird train với website của mình, sellbird signals --confirm free, rồi sellbird discover. Sau khi bước xác minh xong, bạn chạy:

Terminal
sellbird export

Bạn nhận được một file CSV gồm các công ty, người quyết định và địa chỉ đã xác minh, dùng được ngay trong công cụ gửi thư bạn đang có. Bạn tận dụng được phần tìm khách mà không phải để Sellbird gửi thay mình.

Công cụ tốt nhất là công cụ cho bạn quyền bấm “duyệt” trước khi thư rời máy.

Ông T

B.Nhân viên sales duyệt thư mỗi sáng

Bạn để sellbird run chạy nền. Mỗi sáng bạn mở bảng điều khiển bằng sellbird dashboard, vào mục Outbox và đọc từng thư mà agent đã viết. Mỗi thư dựa trên những gì tìm thấy trên website của công ty đó, ví dụ họ đang tuyển nhân viên điều phối. Bạn sửa vài chữ, bấm duyệt, và Sellbird gửi trong giới hạn mỗi ngày cùng giờ làm việc của người nhận. Kết quả là bạn dành vài phút duyệt thay vì cả buổi viết thư tay.

C.Xử lý thư trả lời mà không bỏ sót

Sau vài ngày có người trả lời. Sellbird đọc từng thư, phân loại (ví dụ quan tâm, phản đối), soạn sẵn câu trả lời và tách thư tự động ra riêng. Ai yêu cầu ngừng nhận thư thì được ghi nhận ngay. Những thư Sellbird không nên tự trả lời sẽ được chuyển cho bạn. Bạn chỉ cần xem lại phần được đánh dấu cần bạn quyết định.

D.Cần dừng khẩn cấp

Bạn thấy nội dung thư chưa ổn, hoặc muốn kiểm tra lại cấu hình. Chạy lệnh sau để dừng mọi việc gửi thư ngay lập tức:

Terminal
sellbird sending pause

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

1. Cài đặt báo lỗi vì Python quá cũ. Gói yêu cầu Python 3.11 trở lên. Trên macOS, python3 trần thường là 3.9. Hãy cài bản mới (brew install python@3.13) rồi tạo lại môi trường ảo bằng python3.13, đúng như README dặn.

2. Sellbird không “nghĩ” được vì chưa đăng nhập Claude. Vì không dùng API key, Sellbird cần Claude Code CLI đã đăng nhập gói Pro hoặc Max. Chạy claude login và làm theo hướng dẫn. Nếu bạn dùng ChatGPT, hãy làm theo hướng dẫn Codex trong thư mục docs/.

3. Thư vào spam hoặc bị trả lại. Hộp thư mới chưa được làm nóng rất dễ bị đánh dấu spam. Hãy làm warmup trước khi gửi hàng loạt, dùng tên miền gửi riêng, và chỉ gửi tới địa chỉ có nhãn deliverable như Sellbird đã lọc. Đừng tự ép gửi tới các địa chỉ nhãn guess hoặc invalid.

4. git pull bị chặn khi nâng cấp từ Harvey. Nếu bạn từng sửa trực tiếp file harvey.yaml, git pull sẽ báo “your local changes would be overwritten”. Theo README, hãy chạy git stash, rồi git pull, rồi git stash pop. Nếu có xung đột, giữ lại các dòng của bạn, xoá các dấu xung đột và chạy git stash drop. Về lâu dài nên đặt cài đặt trong sellbird.local.yaml, file mà git không đụng tới.

5. Lệnh harvey cũ vẫn chạy nhưng có cảnh báo. Lệnh harvey và python -m harvey vẫn chạy tạm thời và thông báo đã chuyển sang sellbird. Hãy chuyển sang lệnh mới, vì README nói các lệnh cũ sẽ bị gỡ ở bản sau. Nếu bạn đang chạy một tiến trình Harvey trong thư mục đó, hãy dừng nó trước.

Nếu gặp lỗi khác, repo có tài liệu Troubleshooting trong thư mục docs/ và file SUPPORT.md.

VII.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ó chạy trên gói Claude hoặc ChatGPT sẵn có. Nguồn tìm khách mặc định miễn phí. Mọi thứ chạy trên máy bạn và dữ liệu nằm trong một thư mục của bạn. Mặc định không gửi gì khi chưa duyệt, và có bước kiểm tra trước khi gửi không dùng mô hình. Đây là cách làm khá thận trọng cho một công cụ gửi email tự động.

Giới hạn. Cold email dễ vướng quy định về thư quảng cáo và rất dễ làm hỏng uy tín tên miền nếu làm ẩu. Công cụ không thay được việc bạn tự đọc lại thư và hiểu luật. Bạn cũng cần một hộp thư gửi riêng và thời gian warmup. Về cài đặt, README viết sẵn cho macOS và Linux, người dùng Windows sẽ phải tự tìm thêm trong tài liệu. Giấy phép là AGPL-3.0 (các bản Harvey đến 0.3.x dùng MIT), nên nếu bạn định tích hợp vào sản phẩm thương mại, hãy đọc kỹ giấy phép.

Khi nào chọn cách khác. Nếu bạn không muốn tự chạy và quản lý hộp thư, README nhắc tới bản trả phí sellbird.ai, có sẵn tên miền gửi, hộp thư và warmup, hiện ở giai đoạn early access. Nếu bạn chỉ cần danh sách khách mà không cần gửi thư, hãy dừng sau bước xác minh và dùng sellbird export. Nếu bạn cần tìm khách ở quy mô rất lớn với dữ liệu liên hệ phong phú, bạn sẽ phải xem nguồn trả phí và tự cân nhắc chi phí.

4.3/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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. Nguồn tìm doanh nghiệp mặc định (OpenStreetMap) không tốn tiền, và đọc website cũng không tốn tiền. Bạn vẫn cần gói Claude Pro/Max hoặc gói ChatGPT có Codex, cùng một hộp thư để gửi (README nhắc 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 dùng Claude Code CLI trên gói Claude Pro/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 khác như xác minh email có thể cần key riêng, xem 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 nghĩ do Claude hoặc Codex đảm nhiệm, nên máy của bạn chủ yếu cần Python 3.11 trở lên và kết nối mạng.

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

README ghi đường dẫn thư mục dữ liệu cho Windows, nhưng các lệnh mẫu viết cho macOS và Linux, và Docker được ghi là cho Linux. Tư liệu chưa nói rõ hướng dẫn cài trên Windows, nên bạn hãy xem thư mục docs/ và phần Troubleshooting 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 cho tới khi bạn duyệt, trừ khi chính bạn bật autopilot. 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 nằm ở đâu?

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 home, là thư mục dự án nếu bạn clone repo, hoặc thư mục dữ liệu người dùng nếu cài như một gói. Tư liệu không nói thêm về việc dữ liệu có đi đâu khác khi dùng các dịch vụ bên thứ ba bạn tự bật.

Tôi đang dùng Harvey thì nâng cấp thế nào?

Harvey đã đổi tên thành Sellbird ở bản 0.4.0, cấu hình và dữ liệu của bạn được giữ lại. Chạy git pull, rồi pip install -e . và sellbird dashboard. Các biến HARVEY_* vẫn dùng được khi chưa có biến SELLBIRD_* tương ứng.

Chuyển nhanh tới mục

  1. I.Sellbird làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cách dễ nhất: để Claude cài giúp
    2. B.Cài bằng tay: tạo môi trường và cài gói
    3. C.Điền thông tin đăng nhập
    4. D.Dạy Sellbird về sản phẩm của bạn
    5. E.Xác nhận khách lý tưởng và tìm doanh nghiệp
    6. F.Mở bảng điều khiển và chạy vòng lặp
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ công ty dịch vụ nhỏ cần danh sách khách
    2. B.Nhân viên sales duyệt thư mỗi sáng
    3. C.Xử lý thư trả lời mà không bỏ sót
    4. D.Cần dừng khẩn cấp
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.