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

Sellbird: 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

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ì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 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 cold email cá nhân hoá, gửi đi và soạn trả lời. Cài bằng Python 3.11 trở lên và Claude Code CLI, không cần API key cho mô hình, nhưng bạn cần thêm hộp thư gửi riêng và nên làm warmup.

Sellbird là một nền tảng outreach mã nguồn mở chạy ngay trên máy của bạn. Nó làm cả chuỗi việc của người đi bán hàng chủ động: tìm các công ty có thể cần sản phẩm của 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ý thư trả lời. Dự án trước đây tên là Harvey, nay đổi tên thành Sellbird.

Nếu bạn làm kinh doanh, chạy một dịch vụ cho doanh nghiệp nhỏ, hoặc là dev muốn tự dựng công cụ tìm khách mà không trả tiền cho Apollo, ZoomInfo hay Clay, repo này dành cho bạn. Hiện repo có khoảng 5.250 sao và 1.127 fork, và vẫn được cập nhật trong 3 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 tiếp.

Điểm đáng giá nhất là hai thứ. Thứ 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ĩ”, nên không có API key mô hình và không bị 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.

Ứ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 và người ra quyết định, kiểm tra email, viết và gửi cold email, xử lý thư trả lời bằng gói Claude hoặc ChatGPT.

★ 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 từ đầu đến cuối 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í. Bạn cũng có thể chọn nguồn trả phí, và mỗi lần tìm có trả phí đều hiện chi phí trước khi chạy. Bạn không bị trừ tiền bất ngờ.
  • Đọc tín hiệu mua hàng. Sellbird đọc website của từng công ty để tìm những dấu hiệu 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 gì. 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ó tên trên chính 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 mua danh sách liên hệ từ bên thứ ba.
  • Kiểm tra địa chỉ email. Nó học mẫu 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 tránh gửi vào địa chỉ sai và hỏng uy tín hộp thư.
  • Viết và gửi. Nó viết một chuỗi email 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. Việc gửi tuân theo giới hạn mỗi ngày và giờ làm việc của người nhận.
  • Xử lý thư trả lời. Nó đọc từng thư trả lời, soạn sẵn câu trả lời, để riêng các thư tự động, tôn trọng yêu cầu từ chối ngay lập tức, và chuyển cho bạn những thư mà nó không nên tự trả lời.

Nếu bạn chỉ cần danh sách, hãy 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 email khác.

Sellbird cũng có bước kiểm tra trước khi gửi, không dùng mô hình. Bước này chặn email còn sót merge tag chưa điền, cụm từ bị cấm, email quá dài, có thêm link, hoặc gửi tới địa chỉ không gửi được.

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

Theo README, bạn cần:

  • Python 3.11 trở lên. Trên macOS, máy thường có sẵn bản 3.9. Nếu python3 --version báo bản đó, README bảo chạy brew install python@3.13 trước.
  • Một gói để Sellbird “suy nghĩ”: Claude Pro hoặc Max với CLI đã đăng nhập (claude login), hoặc gói ChatGPT kèm Codex CLI. Không cần API key cho mô hình.
  • 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. README nêu chi phí tham khảo khoảng 7 USD mỗi tháng cho Google Workspace.
  • Warmup cho hộp thư đó. README đề xuất TrulyInbox để làm nóng hộp thư mới trước khi gửi cold email. Sellbird đọc tỷ lệ vào inbox của công cụ này để báo bạn khi nào đã sẵn sàng. Đây là link affiliate của tác giả, bạn không bắt buộc dùng.
  • Hệ điều hành: README nhắc macOS và Linux (có thêm chạy bằng Docker trên Linux). Thư mục dữ liệu cũng có đường dẫn cho Windows, nhưng README không có hướng dẫn cài riêng cho Windows.

File .env.example liệt kê nhiều biến tuỳ chọn như thông tin Gmail, SMTP/IMAP, Microsoft 365, các dịch vụ kiểm tra email (Reoon, ZeroBounce, Hunter) và TrulyInbox. Bạn không cần điền hết. Chỉ điền phần liên quan tới hộp thư và dịch vụ bạn định dùng.

Sellbird gửi email thật từ hộp thư của bạn. Hãy dùng tên miền gửi riêng, không dùng hộp thư chính của công ty. Đọc kỹ phần pháp lý và deliverability trong tài liệu của repo, và kiểm tra quy định về email quảng cáo ở nước bạn trước khi gửi. Không commit file .env hay dữ liệu liên hệ thật lên GitHub.

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

  1. Kiểm tra môi trườngPython 3.11+, Claude CLI đã đăng nhập, có hộp thư để gửi
  2. Tải mã nguồngit clone repo rồi cd vào thư mục
  3. Cài đặtTạo môi trường ảo và pip install -e .
  4. Điền thông tinSao chép .env.example thành .env rồi điền
  5. Dạy Sellbird về sản phẩmsellbird train và sellbird signals
  6. Tìm khách và chạysellbird discover, sellbird dashboard, sellbird run

README có hai cách: nhờ Claude cài hộ, hoặc tự gõ lệnh. Người mới nên thử cách đầu.

A.Cách nhanh: để Claude cài hộ

Mở terminal (trên Windows là PowerShell hoặc Git Bash, trên macOS là Terminal), rồi chạy ba lệnh:

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

git clone tải mã nguồn về máy. cd sellbird đi vào thư mục vừa tải. claude mở Claude Code ngay trong thư mục này. Bạn cần chạy đúng trong thư mục sellbird, vì Claude sẽ đọc file CLAUDE.md của repo.

Sau đó gõ câu: “set up Sellbird for me”. Theo README, CLAUDE.md biến Claude Code thành người hướng dẫn cài đặt: nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi những gì nó 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 ít quen terminal.

B.Hoặc tự cài: tạo môi trường và cài gói

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 .

Lệnh này tạo một môi trường Python riêng tên .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Lý do dùng python3.13 thay vì python3 là trên macOS, python3 trần có thể là bản 3.9, quá cũ. Dòng source .venv/bin/activate là cú pháp macOS/Linux. README chưa ghi lệnh kích hoạt riêng cho Windows, nên nếu bạn dùng Windows, hãy dùng cách “để Claude cài hộ” hoặc xem hướng dẫn trong thư mục docs/ của repo.

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

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

Lệnh này sao chép file mẫu thành .env rồi mở ra để sửa. Mỗi biến đều có chú thích ngay trong file. Chỗ hay vấp là đây: bạn phải sửa file .env, không sửa .env.example. Chỉ điền những dịch vụ bạn thực sự dùng, ví dụ thông tin hộp thư gửi.

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

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

# 4. Confirm what makes a good prospect.
sellbird signals --confirm free

Lệnh đầu đọc website của bạn để hiểu bạn bán gì, rồi ghi vào sellbird.local.yaml. Hãy thay https://your-company.com bằng địa chỉ website thật của bạn. Lệnh thứ hai giúp bạn xác nhận những tín hiệu nào cho thấy một công ty là khách tốt. Khi chạy train, Claude CLI của bạn sẽ được dùng, nên phải đăng nhập bằng claude login trước.

E.Tìm doanh nghiệp, mở dashboard và chạy

Terminal
# 5. Find businesses. The default source is free and needs no account.
sellbird discover

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

sellbird discover tìm doanh nghiệp bằng nguồn mặc định, miễn phí, không cần tài khoản. 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). Hãy mở link đó bằng trình duyệt. sellbird run bắt đầu vòng lặp làm việc. Bạn nên để dashboard và run ở hai cửa sổ terminal khác nhau.

Trên Linux, README nói bạn cũng có thể chạy bằng Docker. Repo có sẵn Dockerfile và docker-compose.yml. README chính chưa ghi lệnh Docker chi tiết ở phần cài, nên hãy xem trang Docker trong thư mục docs/.

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

Cách đơn giản nhất là chạy sellbird run. README cho thấy một màn hình mẫu như sau:

Terminal
sellbird run

Bạn sẽ thấy dòng “Sellbird is online.”, rồi “Checking pipeline state...”. Sau đó nó in quyết định của chu kỳ hiện tại, ví dụ “write_campaign” khi có người mới chưa có email nháp. Cuối cùng là “Cycle complete. Sleeping for 15 minutes.”. Nghĩa là vòng lặp chạy theo chu kỳ và nghỉ giữa các lần.

Hãy kiểm tra thêm ba thứ:

  • sellbird dashboard in ra link riêng và bạn mở được trang quản lý trong trình duyệt.
  • Sau sellbird discover, danh sách công ty xuất hiện.
  • Email nháp nằm trong Outbox chờ bạn duyệt, chứ chưa gửi đi. Nếu thấy email “đang chờ duyệt” là bạn cài đúng.

README cũng nói dữ liệu demo là hoàn toàn bịa (công ty “Bookwell” bán đặt lịch online cho thợ lợp mái, nha khoa, điện lạnh, dùng tên miền .test), nên đừng nhầm đó là khách thật.

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

A.Chủ một dịch vụ muốn tìm khách địa phương

Bạn bán phần mềm đặt lịch cho các cơ sở dịch vụ nhỏ. Hãy 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 đọc website từng cơ sở và viết email nhắc đúng vấn đề của họ. Kết quả là một danh sách công ty kèm lý do họ có thể cần bạn, thay vì một danh sách tên trơn.

Nó không bắt bạn tin vào máy: không có email nào đi ra ngoài khi bạn chưa bấm duyệt.

Ông T

B.Nhân viên sale chỉ cần danh sách sạch

Bạn đã có công cụ gửi email riêng và chỉ cần danh sách khách tiềm năng. Hãy chạy các bước tìm công ty, tìm người ra quyết định và kiểm tra email, rồi dừng lại và chạy:

Terminal
sellbird export

Bạn nhận một file CSV sẵn sàng đưa vào công cụ gửi email của mình, mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid. Bạn nên chỉ dùng địa chỉ gửi được.

C.Chủ shop muốn duyệt từng email trước khi gửi

Bạn lo máy viết sai giọng hoặc sai thông tin. Hãy giữ chế độ mặc định: mọi email chờ trong Outbox. Mở sellbird dashboard, đọc từng email, sửa nếu cần rồi duyệt. Khi cần dừng khẩn cấp, chạy:

Terminal
sellbird sending pause

Lệnh này dừng toàn bộ việc gửi ngay lập tức. Kết quả là bạn kiểm soát nội dung từng thư mà vẫn không phải tự viết.

D.Dev muốn tuỳ chỉnh cách viết và quy trình

Bạn muốn đổi cách Sellbird viết email. README cho biết thư mục prompts/ và skills/ là các “sales playbook” bạn được sửa, và sellbird.local.yaml là nơi đặt cấu hình riêng mà git không đụng tới. Bạn chỉnh các file đó rồi chạy lại. Tài liệu Skills and sub-agents và Extensions trong docs/ giải thích agent nào dùng playbook nào và cách thêm bước mới.

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

  • python3 --version báo 3.9 trên macOS. README nói rõ đây là bản mặc định của macOS. Chạy brew install python@3.13 rồi dùng python3.13 để tạo môi trường, đúng như lệnh trong phần cài.
  • Lệnh sellbird không được nhận ra. Rất có thể 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 bước cài, kích hoạt môi trường rồi thử lại. Phải đứng trong thư mục sellbird khi cài.
  • Claude CLI chưa đăng nhập. Các bước dùng mô hình sẽ không chạy nếu bạn chưa đăng nhập. Chạy claude login theo README rồi thử lại.
  • git pull bị chặn khi nâng cấp từ Harvey. Nếu bạn từng sửa trực tiếp harvey.yaml, git báo “your local changes would be overwritten”. README hướng dẫn chạy git stash, git pull, rồi git stash pop. Nếu có xung đột, giữ phần của bạn, xoá các dấu xung đột và chạy git stash drop. Tốt hơn nữa, hãy đặt cài đặt riêng trong sellbird.local.yaml.
  • Email vào thư rác. Điều này có thể xảy ra với mọi công cụ cold email khi hộp thư chưa được warmup. Hãy làm warmup cho hộp thư gửi trước, dùng tên miền gửi riêng và đọc phần Legal and deliverability trong docs/. Trang Troubleshooting trong docs/ cũng có thêm cách xử lý.

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

Điểm mạnh. Bạn không cần trả tiền API mô hình, vì Sellbird dùng gói Claude hoặc ChatGPT bạn đang có. Bước tìm công ty mặc định miễn phí. Dữ liệu và cấu hình nằm trên máy bạn. Mặc định có duyệt tay, kèm một bước kiểm tra trước khi gửi không dùng mô hình. Mã nguồn mở, bạn sửa được prompt và playbook theo ý mình.

Giới hạn. Bạn vẫn phải có hộp thư gửi (tốn phí Google Workspace hoặc tương tự) và nên làm warmup. Cách cài chính trong README thiên về macOS và Linux, chưa có hướng dẫn riêng cho Windows. Công cụ dùng gói đăng ký của bạn nên nó tự giảm tốc để chừa chỗ cho việc của bạn, nghĩa là không phù hợp nếu bạn muốn gửi khối lượng cực lớn. Giấy phép là AGPL-3.0, bạn nên đọc kỹ nếu định đưa vào sản phẩm thương mại. Tôi cũng không có thông tin về chất lượng email tiếng Việt, nên bạn hãy tự đọc kỹ trước khi duyệt.

Khi nào nên chọn cách khác. Nếu bạn không muốn tự cài, tác giả có bản chạy sẵn trên sellbird.ai (đang truy cập sớm), đã dựng sẵn tên miền gửi, hộp thư và warmup. Nếu bạn chỉ cần gửi vài email tay cho vài khách quen thì công cụ này là hơi nặng. Và nếu thị trường của bạn không có nhiều thông tin công khai trên website công ty, bước tìm tín hiệu có thể cho ít kết quả.

Tóm lại, đây là lựa chọn đáng thử nếu bạn muốn tự động hoá việc tìm khách và viết email mà vẫn giữ quyền duyệt cuối cùng. Hãy bắt đầu với dữ liệu nhỏ, giữ chế độ duyệt tay, và gửi ít trước.

3.9/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). Nguồn tìm công ty mặc định cũng miễn phí. Bạn vẫn cần gói Claude Pro/Max hoặc ChatGPT có Codex, và một hộp thư để gửi, ví dụ Google Workspace khoảng 7 USD mỗi tháng theo README.

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

Không. 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. README nói rõ là không có API key và không tính tiền theo token.

Có cần GPU không?

Tư liệu không nhắc tới yêu cầu GPU. Mô hình chạy qua gói đăng ký của bạn, nên phần nặng không nằm trên máy bạn. Bạn chỉ cần Python 3.11 trở lên.

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

README tập trung vào macOS và Linux, và chưa có hướng dẫn cài riêng cho Windows. Thư mục dữ liệu có đường dẫn cho Windows (%APPDATA%\sellbird). Bạn có thể thử cách nhờ Claude cài hộ, hoặc xem thư mục docs/ 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 nằm trong Outbox chờ bạn duyệt, trừ khi bạn tự bật autopilot. Khi cần, lệnh sellbird sending pause sẽ dừng toàn bộ việc gửi ngay.

Dữ liệu của tôi nằm ở đâu, có an toàn không?

Sellbird chạy trên máy bạn. Cấu hình, kiến thức và dữ liệu nằm trong một thư mục home riêng, gồm file .env, cơ sở dữ liệu và log. Dashboard mở ở địa chỉ trên máy bạn (127.0.0.1:5555) với link riêng. Tư liệu không nói thêm về các biện pháp bảo mật khác.

Harvey và Sellbird có phải một không?

Đúng, Harvey được đổi tên thành Sellbird từ bản 0.4.0, cùng dự án và cùng lịch sử. Cấu hình, dữ liệu và đăng nhập dashboard được chuyển tự động. Lệnh harvey cũ vẫn chạy tạm thời nhưng sẽ bị bỏ ở bản sau.

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 nhanh: để Claude cài hộ
    2. B.Hoặc tự cài: 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.Tìm doanh nghiệp, 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ủ một dịch vụ muốn tìm khách địa phương
    2. B.Nhân viên sale chỉ cần danh sách sạch
    3. C.Chủ shop muốn duyệt từng email trước khi gửi
    4. D.Dev muốn tuỳ chỉnh cách viết và quy trình
  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ỏ.