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

Sellbird: tự tìm khách, viết và gửi cold email — hướng dẫn 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 — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

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ý phản hồi. Nó chạy bằng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có. Cài không quá khó, nhưng cần Python 3.11+ và một hộp thư để gửi.

Sellbird là một nền tảng mã nguồn mở giúp bạn đi hết quy trình bán hàng chủ động bằng email. Nó tìm các công ty cần thứ bạn bán, tìm người ra quyết định, kiểm tra địa chỉ email, viết email lạnh (cold email) riêng cho từng người, gửi đi và xử lý phản hồi. Toàn bộ chạy trên máy của bạn. Mặc định, không có email nào được gửi cho đến khi bạn bấm duyệt.

Repo này dành cho chủ doanh nghiệp nhỏ, người làm sales, agency, hoặc lập trình viên muốn có quy trình tìm khách mà không phải trả thêm cho các công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Sellbird từng tên là Harvey. Hiện repo có khoảng 5.250 sao và 1.127 fork, và vẫn được cập nhật trong vài tháng gần đây. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi cài.

Điểm đáng giá nhất: Sellbird dùng chính gói Claude Pro/Max (qua Claude Code CLI) hoặc gói ChatGPT (qua Codex) của bạn để "suy nghĩ". Bạn không cần API key của model và không bị tính tiền theo token. Việc đọc website khách cũng không gọi model nên không tốn thêm.

Ứng dụng

ethanplusai/sellbird

Nền tảng mã nguồn mở chạy trên máy bạn: tìm công ty, tìm người quyết định, xác minh email, viết cold email cá nhân hoá, gửi và xử lý trả lời.

★ 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 đường ống (pipeline). Bạn có thể chạy trọn vẹn, hoặc dừng ở bất kỳ bước nào.

A.Tìm công ty phù hợp

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ị trừ tiền bất ngờ.

B.Hiểu vì sao họ sẽ mua

Sellbird đọc chính website của từng công ty để tìm "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, hoặc đang tuyển một vị trí nào đó. Bước này không gọi model và không tốn phí (mỗi công ty chỉ ba request HTTP). Email viết ra sau đó có chi tiết thật để nhắc tới.

C.Tìm người quyết định

Nó 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. Nó không đi lục dữ liệu ở nơi khác.

D.Kiểm tra địa chỉ email

Sellbird học cách đặ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. Chỉ địa chỉ gửi được mới bị gửi tới. Việc này bảo vệ uy tín hộp thư của bạn, vì gửi nhiều email trả lại sẽ khiến tên miền bị đánh giá xấu.

E.Viết và gửi

Nó viết một chuỗi email ngắn cho từng người dựa trên thông tin đã tìm được. Sau đó nó gửi từ hộp thư Gmail, Microsoft 365 hoặc SMTP của bạn, trong hạn mức mỗi ngày và theo giờ làm việc của người nhận.

F.Xử lý phản hồi

Nó đọc mọi thư trả lời và soạn sẵn câu trả lời. Thư tự động trả lời được tách riêng. Yêu cầu từ chối nhận mail được tôn trọng ngay. Những gì không nên tự trả lời thì nó chuyển cho bạn.

Ngoài ra, nếu bạn chỉ cần danh sách khách, hãy dừng sau bước kiểm tra email rồi chạy sellbird export để lấy file CSV dùng được với công cụ gửi mail khác.

II.Cần chuẩn bị gì

Theo README, bạn cần:

  • Python 3.11 trở lên. File cấu hình dự án cũng yêu cầu Python >=3.11. README lưu ý macOS mặc định là Python 3.9, nên nếu python3 --version báo 3.9 thì chạy brew install python@3.13 trước.
  • Một gói AI có sẵn: Claude Pro hoặc Max với CLI đã đăng nhập (claude login), hoặc gói ChatGPT kèm Codex CLI.
  • 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) hộp thư đó. README giới thiệu TrulyInbox cho việc này. Link TrulyInbox trong dự án là link affiliate, tức tác giả có thể nhận hoa hồng. Bạn không bắt buộc dùng nó, nhưng hộp thư mới mà gửi ồ ạt thì rất dễ vào thư rác.
  • Git để tải mã nguồn.

Về phần cứng, tư liệu không nói cần GPU hay cấu hình riêng. Docker được nhắc là chạy được trên Linux. Về Windows, README chỉ nêu thư mục dữ liệu (%APPDATA%\sellbird), chưa có hướng dẫn cài riêng cho Windows.

File .env.example liệt kê nhiều biến tuỳ chọn: thông tin Gmail, SMTP/IMAP, Microsoft 365, và các dịch vụ xác minh email như Reoon, ZeroBounce, Hunter. Bạn không phải điền hết. Chỉ điền những gì bạn thật sự dùng.

Lưu ý an toàn: file .env chứa mật khẩu và khoá của hộp thư. Không đưa nó lên GitHub, không gửi cho người khác. Dùng một tên miền gửi riêng thay vì tên miền chính của công ty, để nếu có sự cố thì website chính không bị ảnh hưởng.

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

  1. Tải mã nguồngit clone repo về máy và vào thư mục
  2. Cài đặttạo môi trường ảo và cài gói sellbird
  3. Điền thông tinsao 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. Chọn tín hiệu và tìm kháchsignals rồi discover
  6. Mở bảng điều khiểnchạy dashboard và run

Có hai cách. Cách dễ nhất là nhờ Claude Code cài giúp. Cách còn lại là tự gõ lệnh.

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

Mở terminal (trên Windows là PowerShell, trên macOS là Terminal), rồi chạy:

Terminal
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 thứ ba mở Claude Code ngay trong thư mục đó. Sau đó bạn gõ câu: "set up Sellbird for me". Theo README, file CLAUDE.md trong repo biến Claude Code thành người hướng dẫn cài đặt: nó kiểm tra máy bạn, cài phần còn thiếu, hỏi những gì cần và dạy Sellbird về sản phẩm của bạn. Cách này hợp với người mới nhất.

B.Cách tự làm: tạo môi trường và cài gói

Nếu muốn tự làm, vẫn phải ở trong thư mục sellbird vừa clone. Chạy:

Terminal
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, bật nó lên, rồi cài Sellbird vào đó. 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 và sẽ không đủ. Lệnh source .venv/bin/activate là cú pháp của macOS/Linux. README chưa ghi lệnh bật môi trường ảo cho Windows. Nếu bạn dùng Windows, cách chắc ăn là chọn cách để Claude cài giúp ở trên, hoặc xem thư mục docs/ trong repo.

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

Terminal
cp .env.example .env && $EDITOR .env

Lệnh đầu sao chép file mẫu thành .env. Lệnh sau mở file đó để bạn sửa ($EDITOR là trình soạn thảo mặc định trên máy). README nói mỗi biến đều có chú thích ngay trong file. Nếu không quen terminal, bạn cứ mở file .env bằng Notepad hay VS Code để điền.

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

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

Thay địa chỉ bằng website của bạn. Sellbird đọc trang web để hiểu bạn bán gì, rồi ghi kết quả vào file sellbird.local.yaml. Đây là file riêng của bạn, git không đụng tới.

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

Terminal
sellbird signals --confirm free
sellbird discover

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

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

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

Lệnh sellbird dashboard in ra một đường link riêng tới địa chỉ trên máy bạn (127.0.0.1:5555). Chỉ máy bạn mở được. Lệnh sellbird run khởi động vòng lặp chính. Người mới hay vấp ở chỗ: hai lệnh này nên chạy ở hai cửa sổ terminal khác nhau nếu lệnh đầu vẫn đang chiếm cửa sổ.

Trên Linux, bạn cũng có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml, chi tiết xem tài liệu Docker trong thư mục docs/.

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

Sau khi chạy sellbird run, bạn sẽ thấy màn hình tương tự ví dụ trong README: dòng "Sellbird is online", rồi "Checking pipeline state...", rồi một dòng "Decision" cho biết bước tiếp theo. Cuối chu kỳ có dòng "Cycle complete. Sleeping for 15 minutes." và số email đang chờ bạn duyệt trong Outbox.

Cách kiểm tra đơn giản:

  • Lệnh sellbird dashboard in ra được link và mở được trong trình duyệt.
  • Sau sellbird discover, bảng điều khiển hiện danh sách công ty tìm được.
  • Sau sellbird run, có email nằm trong Outbox chờ duyệt.

Nếu có email xuất hiện trong Outbox mà chưa có gì bị gửi đi, đó là hành vi đúng: mặc định mọi thư đều chờ bạn.

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

A.Chủ agency web tìm khách là tiệm nha khoa

Bạn bán dịch vụ đặt lịch online cho nha khoa. Bạn chạy sellbird train với website của mình, rồi sellbird signals --confirm free để chọn tín hiệu như "chưa có đặt lịch online". Sau đó sellbird discover tìm các phòng khám theo nguồn miễn phí. Sellbird đọc website từng phòng khám, tìm chủ phòng, kiểm tra email và viết một chuỗi hai email nhắc đúng chi tiết đó. Kết quả là một hàng email nằm trong Outbox, bạn đọc lại từng thư rồi duyệt.

Mặc định không có gì được gửi đi nếu bạn chưa bấm duyệt, nên bạn thử thoải mái mà không sợ lỡ tay.

Ông T

B.Nhân viên sales chỉ cần danh sách khách

Công ty bạn đã có công cụ gửi mail (sequencer) riêng. Bạn chỉ muốn Sellbird làm phần tìm và kiểm tra. Hãy chạy pipeline tới bước xác minh, rồi chạy:

Terminal
sellbird export

Bạn nhận file CSV gồm những gì nó tìm được, dán thẳng vào công cụ đang dùng. Hãy lọc theo nhãn verified để chỉ giữ địa chỉ đáng tin.

C.Duyệt thư và xử lý phản hồi hằng ngày

Bạn để sellbird run chạy nền. Mỗi vài phút nó kiểm tra lại. Khi khách trả lời, Sellbird phân loại (quan tâm, phản đối…), soạn sẵn câu trả lời và đưa vào Outbox. Bạn mở bảng điều khiển, sửa một chữ ở đây, bấm duyệt ở kia. Thư tự động trả lời bị đặt riêng, người xin ngừng gửi được tôn trọng ngay. Nếu thấy có gì không ổn, chạy sellbird sending pause để dừng toàn bộ việc gửi.

D.Lập trình viên đang dùng Harvey cần nâng cấp

Nếu bạn đã chạy Harvey, README nói cấu hình, dữ liệu và đăng nhập bảng điều khiển được giữ nguyên. Bạn chạy:

Terminal
git pull
pip install -e .        # once, to get the new `sellbird` command
sellbird dashboard

Lần chạy đầu, Sellbird tự đổi tên harvey.local.yaml thành sellbird.local.yaml và đổi tên file dữ liệu. Nó không ghi đè file nào đã có sẵn. Biến HARVEY_* vẫn dùng được khi chưa có biến SELLBIRD_* tương ứng.

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

A.Báo sai phiên bản Python hoặc không cài được

Nếu python3 --version ra 3.9 (hay gặp trên macOS), gói sẽ không cài được vì cần 3.11 trở lên. Cài bản mới như README gợi ý (brew install python@3.13) rồi tạo lại môi trường ảo bằng python3.13.

B.Claude hoặc Codex chưa đăng nhập

Sellbird dựa vào CLI của gói bạn đang có. Nếu CLI chưa đăng nhập, nó sẽ không "suy nghĩ" được. Với Claude, chạy claude login rồi thử lại. Với Codex, xem tài liệu Codex trong thư mục docs/.

C.Không thấy email nào được gửi

Thường là bình thường: mặc định mọi email chờ bạn duyệt trong Outbox. Mở bảng điều khiển và duyệt. Ngoài ra, trước khi gửi còn có bước kiểm tra không dùng model: nó loại thư còn sót thẻ 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. Thư bị loại là do bộ lọc này chứ không phải lỗi.

D.git pull báo "your local changes would be overwritten"

Chuyện này xảy ra khi bạn từng sửa trực tiếp file harvey.yaml. Làm theo README: chạy git stash, rồi 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. Lần sau hãy đặt cài đặt riêng trong sellbird.local.yaml.

E.Thư vào hộp thư rác

Đây không hẳn lỗi của phần mềm. Hộp thư mới chưa warmup hoặc gửi quá nhiều sẽ bị đánh dấu spam. Hãy warmup hộp thư trước, giữ hạn mức gửi thấp, và đọc tài liệu "Legal and deliverability" trong docs/ về quy định gửi email và độ tin cậy của hộp thư.

VII.Có nên dùng không

Điểm mạnh. Bạn không phải trả tiền API model, vì 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í. Mọi thư chờ bạn duyệt, có bộ lọc trước khi gửi, và có lệnh dừng khẩn. Dữ liệu và cấu hình nằm trên máy bạn. Mã nguồn mở nên bạn đọc và sửa được.

Giới hạn. Bạn vẫn cần một hộp thư gửi, nên có thể tốn khoảng 7 đô la một tháng nếu dùng Google Workspace theo README. Warmup cũng là việc bạn phải tự lo. Gói Claude hay ChatGPT có hạn mức riêng, nên Sellbird tự giãn nhịp để chừa chỗ cho việc của bạn. Mỗi công ty tối đa hai người, và chỉ gửi tới một địa chỉ đã xác minh. Với người dùng Windows, tư liệu chưa có hướng dẫn cài riêng. Giấy phép là AGPL-3.0: nếu bạn định sửa và cung cấp nó như một dịch vụ cho người khác, hãy đọc kỹ điều khoản.

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 được lưu trữ sẵn (đang trong giai đoạn truy cập sớm). Nếu bạn cần dữ liệu liên hệ cho thị trường mà OpenStreetMap ít phủ, hãy kiểm tra trước bằng một lượt sellbird discover nhỏ. Và dù dùng công cụ nào, cold email vẫn cần tuân thủ quy định nơi bạn gửi tới. Hãy gửi ít, viết thật và đọc lại từng thư trước khi duyệt.

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

Phần mềm là mã nguồn mở theo giấy phép AGPL-3.0. Nguồn tìm doanh nghiệp mặc định (OpenStreetMap) miễn phí, và việc đọc website không tốn phí. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có sẵn, và một hộp thư để gửi (README nêu khoảng 7 đô la một tháng cho Google Workspace).

Có cần API key của Claude hoặc OpenAI không?

Không. README nói Sellbird chạy qua Claude Code CLI trên gói Claude Pro/Max, hoặc qua Codex trên gói ChatGPT. Không có API key model và không tính tiền theo token.

Cần GPU không?

Tư liệu không yêu cầu GPU. Phần suy nghĩ do Claude hoặc Codex đảm nhiệm qua gói đăng ký của bạn, không chạy model trên máy.

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

README có nêu thư mục dữ liệu cho Windows nhưng các lệnh cài đặt chỉ ghi cho macOS/Linux, và Docker được nhắc cho Linux. Chưa có hướng dẫn riêng cho Windows trong tư liệu. Bạn có thể nhờ Claude Code cài giúp hoặc xem thư mục docs/ trong repo.

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

Không, mặc định. Mọi email đều chờ trong Outbox cho tới khi bạn duyệt hoặc tự bật chế độ 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 nằm ở đâu, có an toàn không?

Cấu hình, kiến thức và dữ liệu nằm trong một thư mục trên máy bạn, và bảng điều khiển chạy ở địa chỉ nội bộ 127.0.0.1. Tư liệu không nói thêm về mức an toàn chi tiết, nên hãy tự bảo vệ file .env và xem SECURITY.md trong repo.

Khác gì Apollo, ZoomInfo hay Clay?

README nói Sellbird không dùng các công cụ prospecting đó. Nó tự tìm công ty, tìm người quyết định từ trang của chính công ty và xác minh email. Tư liệu không so sánh chi tiết về độ phủ dữ liệu, nên bạn nên thử một lượt nhỏ trước.

Chuyển nhanh tới mục

  1. I.Sellbird làm được gì
    1. A.Tìm công ty phù hợp
    2. B.Hiểu vì sao họ sẽ mua
    3. C.Tìm người quyết định
    4. D.Kiểm tra địa chỉ email
    5. E.Viết và gửi
    6. F.Xử lý phản hồi
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cách dễ: để Claude cài giúp
    2. B.Cách tự làm: 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 tín hiệu 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ủ agency web tìm khách là tiệm nha khoa
    2. B.Nhân viên sales chỉ cần danh sách khách
    3. C.Duyệt thư và xử lý phản hồi hằng ngày
    4. D.Lập trình viên đang dùng Harvey cần nâng cấp
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Báo sai phiên bản Python hoặc không cài được
    2. B.Claude hoặc Codex chưa đăng nhập
    3. C.Không thấy email nào được gửi
    4. D.git pull báo "your local changes would be overwritten"
    5. E.Thư vào hộp thư rác
  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ỏ.