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/ChatGPT — cài đặt và dùng

11 phút đọcCập nhật

Bài này là một góc nhìn khác về ethanplusai/sellbird — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: 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: tự tìm khách, viết và gửi cold email bằng gói Claude/ChatGPT — 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 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.

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.

Ứng dụng

ethanplusai/sellbird

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.

★ 5.3kPythonAGPL-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 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.

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

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

  1. Tải mã nguồnClone repo về máy và vào thư mục dự án
  2. Cài đặtTạo môi trường ảo Python và chạy pip install -e .
  3. Điền thông tinSao chép .env.example thành .env rồi điền khoá cần dùng
  4. Dạy Sellbird về sản phẩmChạy sellbird train với website của bạn
  5. Tìm kháchXác nhận tín hiệu rồi chạy sellbird discover
  6. ChạyMở dashboard và chạy sellbird run

A.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 đó.

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

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

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

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

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

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

Terminal
sellbird train https://your-company.com

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

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

Terminal
sellbird signals --confirm free
sellbird discover

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

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

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

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

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

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

B.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:

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

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

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

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

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

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

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

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

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

VII.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ử.

4.8/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?

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.

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 Code cài giúp
    2. B.Hoặc tự làm: cài đặt
    3. C.Hoặc tự làm: điền thông tin
    4. D.Hoặc tự làm: dạy Sellbird về sản phẩm
    5. E.Hoặc tự làm: xác nhận tín hiệu và tìm khách
    6. F.Hoặc tự làm: mở dashboard và chạy
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ doanh nghiệp nhỏ muốn tìm khách địa phương
    2. B.Nhân viên sales chỉ cần danh sách sạch
    3. C.Người làm agency chạy chiến dịch cho khách
    4. D.Người bận rộn muốn có người lo thư trả lời
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.python3 --version báo 3.9 hoặc thấp hơn 3.11
    2. B.Lệnh sellbird không được nhận ra
    3. C.Claude không phản hồi hoặc báo chưa đăng nhập
    4. D.git pull báo "your local changes would be overwritten" khi nâng cấp từ Harvey
    5. E.Thư vào spam hoặc tỉ lệ gửi thấp
  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ỏ.