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

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 — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Sellbird là nền tảng mã nguồn mở bằng Python giúp tự động hoá cả chuỗi outreach: tìm công ty, tìm người ra quyết định, kiểm tra email, viết thư cá nhân hoá, gửi 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) nên không cần API key mô hình. Cài không quá khó nhưng cần Python 3.11+, một hộp thư để gửi và nên có bước warmup.

Sellbird là một công cụ mã nguồn mở (trước đây tên Harvey) chạy trên máy của bạn, làm giúp cả chuỗi bán hàng bằng email lạnh: tìm doanh nghiệp phù hợp với khách hàng của bạn, tìm người 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.

Người nên dùng là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, và lập trình viên muốn có sẵn một “nhân viên outreach” mà không phải ghép nhiều công cụ trả phí. 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.

Điểm đáng giá nhất: Sellbird “suy nghĩ” qua Claude Code CLI trên gói Claude Pro hoặc Max của bạn, hoặc qua Codex trên gói ChatGPT. Nghĩa là không có API key mô hình và không bị tính tiền theo token. Mặc định, không 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 trước khi cài.

Ứ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 và gửi cold email, rồi xử lý thư trả lời — chạy bằng gói Claude hoặc ChatGPT bạn đang có.

★ 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 dây chuyền. Bạn có thể chạy hết, hoặc dừng ở bước nào tuỳ ý.

  • Tìm công ty. Tìm doanh nghiệp khớp với 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 trả phí đều hiện chi phí trước khi chạy. Bạn không bị trừ tiền bất ngờ.
  • Tìm lý do họ sẽ mua. Sellbird đọc website của từng công ty để tìm “tín hiệu mua” 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 mô hình, không tốn phí, chỉ cần vài yêu cầu HTTP cho mỗi công ty. Nhờ đó email của bạn có lý do cụ thể để mở đầu, thay vì một câu chào chung chung.
  • Tìm người quyết định. 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.
  • Kiểm tra địa chỉ email. 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. Chỉ địa chỉ gửi được mới được gửi thư. Việc này giúp bạn tránh gửi vào địa chỉ chết, vốn làm hỏng uy tín tên miền gửi.
  • Viết và gửi. 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, trong giới hạn mỗi ngày và theo giờ làm việc của người nhận.
  • Xử lý thư trả lời. Đọ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ư 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 để có file CSV sẵn cho công cụ gửi thư khác.

Về chi phí, theo README: tìm doanh nghiệp là 0 đồng trên nguồn mặc định, hoặc khoảng 0,37 USD cho 1.000 kết quả trên nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Phần viết và gửi dùng gói đăng ký bạn đã có, cộng một hộp thư (README nêu Google Workspace khoảng 7 USD mỗi tháng). Không cần Apollo, ZoomInfo, Clearbit hay Clay.

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 Python từ 3.11. README lưu ý macOS đ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.
  • 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 có 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 chạy được.
  • Warmup cho hộp thư đó. README giới thiệu TrulyInbox để “làm nóng” hộp thư mới trước khi gửi cold email, và Sellbird đọc tỷ lệ vào inbox của nó để báo khi nào bạn đã sẵn sàng. Lưu ý: link TrulyInbox trong dự án là link affiliate, tác giả có thể nhận hoa hồng.

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 chỉ điền những gì mình dùng, và README nói mỗi biến đều có chú thích ngay trong file.

Phần cứng: tư liệu không nêu yêu cầu GPU hay cấu hình tối thiểu. README chưa có hướng dẫn riêng cho từng hệ điều hành, nhưng bảng thư mục dữ liệu có nhắc macOS, Windows và Linux. Docker được README ghi là chạy được trên Linux.

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

  1. Mở thư mục dự ánTải mã nguồn về máy và vào thư mục sellbird
  2. Cách nhanh: nhờ ClaudeChạy claude trong thư mục và nói “set up Sellbird for me”
  3. Hoặc tự càiTạo môi trường Python ảo, cài gói, tạo file .env
  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. Mở dashboard và chạyChạy sellbird dashboard rồi sellbird run

A.Tải mã nguồn về máy

Mở terminal (trên Windows có thể dùng PowerShell hoặc Git Bash) và chạy:

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

Lệnh đầu tải repo về, lệnh sau đi vào thư mục vừa tải. Chỗ người mới hay vấp: các lệnh sau đó phải chạy trong đúng thư mục sellbird này.

B.Cách nhanh: để Claude hướng dẫn cài

README có sẵn cách này. Trong thư mục sellbird, chạy:

Terminal
claude

Rồi gõ câu: “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: nó kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi những thông tin cần và dạy Sellbird về sản phẩm của bạn. Với người mới, đây là đường dễ nhất. Điều kiện là bạn đã cài Claude Code và đăng nhập bằng claude login.

C.Hoặc tự cài từng lệnh

Tạo môi trường ảo và cài gói. README nhấn mạnh dùng python3.13 chứ không dùng python3, vì trên macOS python3 trần là bản 3.9:

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

Lệnh này tạo 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. Dòng source ... là cú pháp macOS/Linux. README không ghi lệnh kích hoạt riêng cho Windows, nên nếu dùng Windows bạn nên dùng cách để Claude hướng dẫn ở trên, hoặc xem thêm tài liệu trong thư mục docs/ của repo.

Tiếp theo, tạo file cấu hình:

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

Lệnh này sao chép file mẫu thành .env rồi mở ra để bạn điền thông tin đăng nhập (hộp thư, dịch vụ kiểm tra email…). Mỗi biến có chú thích ngay trong file. Đừng đưa file .env cho ai và đừng đăng nó lên mạng.

.env chứa mật khẩu và khoá truy cập hộp thư. Không chia sẻ, không đăng lên GitHub. Tốt nhất dùng một hộp thư và tên miền gửi riêng, đừng dùng hộp thư công việc chính của bạ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ông ty bạn. Sellbird đọc website để hiểu bạn bán gì và ghi kết quả vào file sellbird.local.yaml. File này là của bạn, git không động tới.

E.Xác nhận kiểu khách hàng tốt

Terminal
sellbird signals --confirm free

Bước này để bạn xác nhận những “tín hiệu” cho thấy một công ty là khách hàng tốt. README nói có 29 tín hiệu. Tham số free là đúng như trong README.

F.Tìm doanh nghiệp

Terminal
sellbird discover

Nguồn mặc định miễn phí và không cần tài khoản.

G.Mở dashboard và chạy

Terminal
sellbird dashboard
sellbird run

sellbird dashboard in ra một đường link riêng tư tới http://127.0.0.1:5555, tức là chỉ mở được trên máy bạn. sellbird run khởi động vòng lặp chính. Nếu dùng 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 docs/.

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

Khi chạy sellbird run, bạn sẽ thấy dòng “Sellbird is online.” rồi một chu kỳ báo cáo. README minh hoạ kết quả có dạng như sau:

Code
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
  writer    → 2-email sequence: Phoenix HVAC hiring a dispatcher
  outbox    → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.

Cách kiểm tra thực tế:

  1. Chạy sellbird dashboard, mở link nó in ra, và xem có vào được giao diện không.
  2. Sau sellbird discover, xem dashboard có danh sách công ty chưa.
  3. Sau sellbird run, kiểm tra Outbox. Nếu có thư đang chờ duyệt, nghĩa là dây chuyền đã chạy tới bước viết thư.

Dữ liệu demo trong repo là bịa (công ty “Bookwell” bán phần mềm đặt lịch trên 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ủ dịch vụ địa phương tìm khách mới

Bạn là chủ một công ty bán phần mềm đặt lịch cho phòng khám nha khoa. Bạn chạy lần lượt sellbird train với website của mình, sellbird signals --confirm free, rồi sellbird discover. Sellbird tìm các phòng khám trên OpenStreetMap, đọc website của họ để xem ai chưa có đặt lịch online, rồi tìm chủ phòng khám. Kết quả là một danh sách khách tiềm năng kèm lý do cụ thể để liên hệ, thay vì danh sách tên chung chung.

B.Chỉ lấy danh sách, gửi bằng công cụ khác

Bạn đã có công cụ gửi thư quen dùng và chỉ cần thêm lead. Bạn chạy pipeline tới bước kiểm tra email, rồi chạy:

Terminal
sellbird export

Bạn nhận file CSV sẵn cho công cụ gửi thư, với các địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid. Bạn có thể lọc lấy địa chỉ verified để gửi.

Mặc định, không email nào rời khỏi máy bạn nếu bạn chưa bấm duyệt.

Ông T

C.Duyệt thư và trả lời khách mỗi sáng

Bạn để sellbird run chạy nền. Mỗi sáng bạn mở dashboard, vào Outbox, đọc các thư chờ duyệt và bấm duyệt những thư ưng ý. Trước khi gửi, một bước kiểm tra không dùng mô hình sẽ loại các thư còn sót mẫu chưa điền, có cụm từ bị cấm, quá dài, có thêm link, hoặc gửi tới địa chỉ không gửi được. Với thư trả lời, Sellbird soạn sẵn câu đáp cho khách quan tâm hoặc phản đối, còn thư tự động thì tách riêng. Bạn chỉ phải xử lý những ca nó không nên tự trả lời.

D.Dừng khẩn cấp khi thấy có vấn đề

Giả sử bạn thấy một thư soạn sai giọng điệu và muốn dừng mọi thứ để chỉnh lại. Bạn chạy:

Terminal
sellbird sending pause

Lệnh này dừng toàn bộ việc gửi ngay lập tức. Bạn có thể chỉnh nội dung, kiểm tra lại rồi mới tiếp tục.

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

Báo lỗi hoặc ra phiên bản Python cũ. Nếu python3 --version cho ra 3.9 (hay gặp trên macOS), hãy cài Python mới theo README bằng brew install python@3.13, rồi tạo môi trường ảo bằng python3.13 chứ không dùng python3.

Lệnh sellbird không tìm thấy. Thường do chưa kích hoạt môi trường ảo hoặc chưa chạy pip install -e .. Hãy kiểm tra bạn đang ở trong thư mục sellbird và môi trường .venv đã được kích hoạt, rồi cài lại.

Claude hoặc Codex chưa đăng nhập. Sellbird dựa vào CLI đã đăng nhập, nên nếu chưa chạy claude login thì phần viết thư sẽ không chạy được. Với ChatGPT, xem tài liệu “Using a ChatGPT plan (Codex)” trong docs/.

Thư không vào inbox hoặc vào spam. Thường do hộp thư chưa warmup hoặc tên miền mới. README nhấn mạnh phải có warmup trước khi gửi cold email, và Sellbird có thể đọc tỷ lệ vào inbox từ TrulyInbox để báo bạn khi nào sẵn sàng. Đừng bật gửi hàng loạt khi hộp thư còn mới. Hãy đọc tài liệu “Legal and deliverability” trong docs/ để biết các quy định bạn đang gửi thư theo, nhất là khi gửi cho khách ở nước khác.

Nâng cấp từ Harvey bị chặn khi git pull. Nếu bạn từng sửa trực tiếp file harvey.yaml, git pull sẽ dừng với thông 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 báo xung đột, giữ các dòng của bạn, xoá dấu xung đột rồi chạy git stash drop. Tốt hơn, hãy đặt cài đặt của bạn vào sellbird.local.yaml, file mà git không đụng tới.

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

Điểm mạnh. Không phải trả tiền API mô hình nếu bạn đã có gói Claude hoặc ChatGPT. Chạy trên máy bạn, dữ liệu nằm trong thư mục của bạn. Có bước duyệt thủ công mặc định, kèm kiểm tra trước khi gửi bằng quy tắc cứng. Có thể dùng từng phần: chỉ lấy danh sách, hoặc chạy cả chuỗi. Prompt và “kỹ năng” bán hàng nằm trong thư mục prompts/ và skills/ để bạn chỉnh sửa.

Giới hạn. Bạn phải tự lo hộp thư gửi, tên miền và warmup, đây là phần khó nhất với người mới. Nguồn tìm miễn phí (OpenStreetMap) phù hợp nhất với doanh nghiệp địa phương, còn mảng khác có thể cần nguồn trả phí. README không nói rõ mức độ phủ cho thị trường Việt Nam, nên bạn hãy thử với một nhóm nhỏ trước. Giấy phép là AGPL-3.0, bạn nên đọc kỹ nếu định dùng mã trong sản phẩm thương mại. Phần Windows chưa có hướng dẫn riêng trong README.

Khi nào chọn cách khác. Nếu bạn không muốn tự vận hành, dự án có bản hosted tại trang chủ sellbird.ai (README nói đang trong 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 gửi vài thư thủ công, một công cụ gửi thư đơn giản là đủ. Và dù chọn cách nào, hãy bắt đầu với số lượng nhỏ, duyệt từng thư, và tìm hiểu quy định gửi email thương mại trước khi mở rộng.

4.5/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 mở theo giấy phép AGPL-3.0 và bản tự chạy không tính phí phần mềm. Theo README, nguồn tìm doanh nghiệp mặc định là miễn phí, đọc website không tốn phí, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả. Bạn vẫn cần gói Claude/ChatGPT và một hộp thư gửi (README nêu Google Workspace khoảng 7 USD mỗi tháng).

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/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ố dịch vụ tuỳ chọn khác như kiểm tra email thì có biến key riêng trong file .env.example.

Cần GPU hoặc máy mạnh không?

Tư liệu không nêu yêu cầu GPU hay cấu hình phần cứng. Phần suy nghĩ chạy qua dịch vụ Claude hoặc Codex mà bạn đăng nhập, còn Sellbird cần Python 3.11 trở lên.

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

README có nhắc thư mục dữ liệu trên Windows (%APPDATA%\sellbird), nhưng các lệnh mẫu viết theo kiểu macOS/Linux và chưa có hướng dẫn cài riêng cho Windows. Bạn có thể nhờ Claude Code hướng dẫn bằng cách nói “set up Sellbird for me”, 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 chờ trong Outbox để bạn duyệt cho tới khi bạn tự bật autopilot. Trước khi gửi còn có bước kiểm tra không dùng mô hình, và 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 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 riêng của bạn, dashboard mở ở địa chỉ 127.0.0.1. README không nói chi tiết hơn về bảo mật. Bạn vẫn nên giữ kín file .env và dùng hộp thư riêng để gửi; vấn đề bảo mật có thể xem SECURITY.md.

Khác gì Harvey và bản sellbird.ai?

Harvey là tên cũ của chính dự án này, đổi tên thành Sellbird từ bản 0.4.0, và cấu hình, dữ liệu của bạn được mang sang. Còn sellbird.ai là bản hosted do tác giả cung cấp, lo sẵn tên miền gửi, hộp thư và warmup, README nói đang trong giai đoạn early access.

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.Tải mã nguồn về máy
    2. B.Cách nhanh: để Claude hướng dẫn cài
    3. C.Hoặc tự cài từng lệnh
    4. D.Dạy Sellbird về sản phẩm của bạn
    5. E.Xác nhận kiểu khách hàng tốt
    6. F.Tìm doanh nghiệp
    7. G.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ủ dịch vụ địa phương tìm khách mới
    2. B.Chỉ lấy danh sách, gửi bằng công cụ khác
    3. C.Duyệt thư và trả lời khách mỗi sáng
    4. D.Dừng khẩn cấp khi thấy có vấn đề
  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ỏ.