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

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 (trước đây tên Harvey) là nền tảng mã nguồn mở viết bằng Python, giúp tự động hoá cả chuỗi outreach: tìm khách hàng tiềm năng, kiểm tra email, viết thư cá nhân hoá, gửi và xử lý phản hồi. Nó dùng gói Claude Pro/Max hoặc ChatGPT có Codex bạn đang có, không cần API key của mô hình. Cài không quá khó nếu bạn quen terminal, nhưng cần thêm hộp thư gửi và nên có bước warmup.

Sellbird là một nền tảng outreach mã nguồn mở, chạy ngay trên máy bạn, làm trọn chuỗi việc của người đi chào bán: tìm công ty cần thứ bạn 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ý phản hồi. Repo này trước đây tên Harvey, sau đó đổi tên thành Sellbird. Hiện có khoảng 5.250 sao và 1.127 fork trên GitHub.

Người nên quan tâm là chủ doanh nghiệp nhỏ, nhân viên kinh doanh, freelancer, hoặc lập trình viên muốn có một hệ thống tìm khách chủ động mà không phải trả tiền cho Apollo, ZoomInfo, Clearbit hay Clay. README nói rõ Sellbird không dùng các công cụ prospecting đó.

Điểm đáng giá nhất có hai ý. Thứ nhất, phần “suy nghĩ” của Sellbird chạy qua Claude Code CLI trên gói Claude Pro hoặc Max của bạn (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 đượ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, rồi quay lại đây làm theo từng bước.

Ứng dụng

ethanplusai/sellbird

Sellbird 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 soạn sẵn câu trả lời cho các phản hồi. Chạy trên máy 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 đường ống (pipeline). Bạn có thể chạy hết từ đầu đến cuối, hoặc dừng ở bước nào cũng được.

  • Tìm công ty. Tìm các doanh nghiệp giống khách hà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. Lợi ích: bạn không bị trừ tiền bất ngờ.
  • Tìm lý do họ sẽ mua. Sellbird đọc website của chính công ty đó để tìm “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, hoặc đ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, mỗi công ty chỉ cần ba request HTTP. Nhờ đó email sau này nói đúng việc của họ.
  • Tìm người quyết định. Tìm chủ hoặc quản lý có tên trên 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. Sellbird suy ra kiểu email của công ty và kiểm tra 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 bớt thư trả lại, một điều rất hại cho uy tín hộp thư.
  • Viết và gửi. Viết một chuỗi email ngắn cho từng người dựa trên những gì đã tìm được. Thư gửi từ Gmail, Microsoft 365 hoặc SMTP của bạn, trong giới hạn gửi mỗi ngày và theo giờ làm việc của người nhận.
  • Xử lý phản hồi. Đọc mọi thư trả lời, soạn câu trả lời, 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 chỉ cần danh sách, bạn 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 mail khác.

Về an toàn: mọi email đi ra đều nằm trong Outbox chờ bạn duyệt, trừ khi chính bạn bật 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 merge tag chưa điền, có cụm từ bị cấm, quá dài, thừa link hoặc gửi tới địa chỉ không gửi được. Lệnh sellbird sending pause dừng mọi thứ ngay.

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

Theo README, bạn cần:

  • Python 3.11 trở lên (pyproject.toml cũng yêu cầu >=3.11). Máy Mac mặc định có Python 3.9, nên nếu python3 --version báo 3.9 thì chạy brew install python@3.13 trước.
  • Claude Pro hoặc Max và đã đăng nhập CLI bằng claude login, hoặc gói ChatGPT có Codex CLI. Hướng dẫn Codex nằm trong tài liệu của repo.
  • 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 cho hộp thư đó. README giới thiệu TrulyInbox: warm hộp thư mới trước khi gửi cold email và giữ thư khỏi vào spam sau đó. Lưu ý: các link TrulyInbox trong dự án là link affiliate, người duy trì có thể nhận hoa hồng. Đây chỉ là gợi ý của tác giả, không bắt buộc theo README.
  • Git, để tải mã nguồn.

Tư liệu không nói gì về yêu cầu phần cứng hay GPU. Nguồn tìm công ty mặc định không cần tài khoản. Các khoá như REOON_API_KEY, HUNTER_API_KEY hay ZEROBOUNCE_API_KEY chỉ xuất hiện trong file .env.example cho các dịch vụ tuỳ chọn.

Sellbird gửi email thật từ hộp thư thật của bạn. Hãy dùng tên miền gửi riêng, không dùng hộp thư công ty chính, và đọc kỹ tài liệu Legal and deliverability trong repo trước khi bật autopilot. Giữ file .env ở máy bạn, đừng đăng lên GitHub hay gửi cho người khác vì trong đó có mật khẩu hộp thư.

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 bằng pip
  3. Điền thông tinSao chép .env.example thành .env rồi điền
  4. Dạy SellbirdCho nó đọc website của bạn để hiểu sản phẩm
  5. Tìm kháchXác nhận tín hiệu và chạy discover
  6. ChạyMở dashboard và bật vòng lặp

README có hai đường: nhờ Claude cài giúp, hoặc tự làm. Mình đi theo đường tự làm trước, rồi nói đường nhờ Claude ở cuối.

A.Tải mã nguồn

Mở terminal (Terminal trên Mac/Linux). Chạy hai lệnh sau để tải repo và đi vào thư mục:

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

Từ giờ mọi lệnh bên dưới phải chạy khi terminal đang ở trong thư mục sellbird. Người mới hay quên bước cd này.

B.Tạo môi trường ảo 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 làm ba việc nối nhau: tạo môi trường ảo .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau khi xong bạn sẽ có lệnh sellbird. Dùng đúng python3.13 (hoặc bản 3.11 trở lên của bạn) chứ đừng dùng python3 trần nếu máy Mac còn bản 3.9.

Về Windows: README chỉ viết lệnh kích hoạt kiểu macOS/Linux (source .venv/bin/activate). README chưa ghi lệnh cho Windows, và phần Docker được ghi là dành cho Linux. Bạn xem thêm mục Troubleshooting và thư mục docs/ trong repo trước khi thử trên Windows. Với đường dẫn dữ liệu, README có nói bản cài bằng pip lưu ở %APPDATA%\sellbird trên Windows.

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 đầu sao chép file mẫu thành .env, lệnh sau mở nó ra để sửa. Mỗi biến đều có chú thích ngay trong file. Với hộp thư Gmail bạn sẽ thấy GMAIL_CLIENT_ID và GMAIL_CLIENT_SECRET; với SMTP là SMTP_HOST, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD; còn các khoá kiểm tra email hay warmup thì tuỳ dịch vụ bạn chọn. Chỉ điền những gì bạn thực sự dùng. Nếu $EDITOR chưa được đặt, bạn cứ mở file .env bằng trình soạn thảo quen thuộc.

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

Thay địa chỉ bằng website của bạn. Sellbird đọc website và ghi hiểu biết về sản phẩm 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 tín hiệu và tìm khách

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

Lệnh đầu chốt những “tín hiệu” cho biết một công ty là khách tốt. Lệnh sau tìm doanh nghiệp bằng nguồn mặc định, miễn phí, không cần tài khoản.

F.Mở dashboard và bật vòng lặp

Terminal
# 6. Open the dashboard and start the loop.
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, tức là chỉ mở được trên máy bạn. sellbird run bật vòng lặp chính, cứ vài phút lại kiểm tra trạng thái và làm bước tiếp theo.

G.Hoặc để Claude cài giúp

Nếu bạn đã có Claude Code, README có đường tắt:

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

Rồi gõ: “set up Sellbird for me”. 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 thứ còn thiếu, hỏi thông tin cần thiết và huấn luyện Sellbird về sản phẩm của bạn. Đây là cách dễ nhất cho người mới.

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

Sau khi cài, thử sellbird dashboard. Nếu thành công, terminal in ra một link riêng tới http://127.0.0.1:5555; mở link đó trên trình duyệt để thấy bảng điều khiển.

Với sellbird run, README mô tả màn hình mẫu như sau: dòng “Sellbird is online.”, rồi “Checking pipeline state...”, một dòng “Decision” (ví dụ viết chiến dịch cho prospect mới), các dòng của handler và writer, và dòng cuối cho biết có bao nhiêu email đang chờ bạn duyệt trong outbox, kèm “Cycle complete. Sleeping for 15 minutes.” Thấy kiểu đầu ra này là vòng lặp đã chạy. Con số và tên trong ví dụ README là dữ liệu mẫu bịa ra (công ty Bookwell bán đặt lịch cho thợ lợp mái, nha khoa, HVAC trên tên miền .test), nên của bạn sẽ khác.

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

Sellbird không thay đổi lòng tin của người nhận. Nó chỉ làm phần việc lặp đi lặp lại thay bạn, còn quyết định gửi vẫn nằm ở bạn.

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

Ông T

A.Chủ dịch vụ nhỏ tìm khách địa phương

Bạn bán phần mềm đặt lịch cho phòng khám nha khoa hoặc tiệm sửa chữa. 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 tìm doanh nghiệp trên OpenStreetMap, đọc website của họ và đưa ra danh sách công ty hợp. Kết quả: thay vì tự lục Google Maps, bạn có sẵn danh sách kèm lý do mỗi công ty có thể cần sản phẩm của bạn.

B.Nhân viên sales chỉ cần danh sách để gửi bằng công cụ khác

Bạn đã có công cụ gửi mail riêng và chỉ muốn danh sách sạch. Chạy các bước tìm công ty, tìm người quyết định và kiểm tra email, rồi:

Terminal
sellbird export

Kết quả là file CSV sẵn sàng đưa vào sequencer, mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid. Bạn có thể bỏ nhãn invalid và cân nhắc kỹ nhãn risky.

C.Founder gửi chuỗi email cá nhân hoá

Bạn đã có hộp thư Google Workspace trên tên miền gửi riêng và đã warmup. Chạy sellbird run, để nó viết chuỗi email ngắn cho từng người dựa trên tín hiệu tìm được (ví dụ công ty đang tuyển một vị trí điều phối). Mở dashboard, vào Outbox và đọc từng thư. Thư nào ổn thì duyệt, thư nào không thì sửa. Kết quả: bạn chỉ mất thời gian đọc và duyệt thay vì viết từng thư.

D.Xử lý phản hồi mà không bỏ sót

Khi có người trả lời, Sellbird đọc, phân loại (quan tâm, phản đối, thư tự động, từ chối nhận) và soạn sẵn câu trả lời. Người xin ngừng nhận thư được tôn trọng ngay. Những thư nó không nên tự trả lời được chuyển cho bạn. Bạn mở dashboard để xem và quyết định, và nếu cần dừng mọi thứ thì dùng sellbird sending pause.

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

  • Lệnh python3 báo phiên bản 3.9 hoặc cài gói thất bại. Máy Mac mặc định có Python 3.9 trong khi Sellbird cần 3.11 trở lên. Cài bản mới bằng brew install python@3.13, rồi tạo lại môi trường bằng python3.13 -m venv .venv.
  • Gõ sellbird báo không tìm thấy lệnh. Thường là môi trường ảo chưa được kích hoạt trong terminal hiện tại, hoặc bạn mở terminal mới. Vào lại thư mục sellbird và chạy source .venv/bin/activate. Nếu đang nâng cấp từ Harvey, chạy pip install -e . một lần để có lệnh mới.
  • Claude hoặc Codex không phản hồi. Sellbird dùng CLI bạn đã đăng nhập. Hãy chạy claude login (hoặc làm theo hướng dẫn Codex trong tài liệu) rồi thử lại. Gói của bạn cũng có hạn mức dùng; README nói Sellbird tự giảm tốc để chừa chỗ cho việc của bạn.
  • git pull bị chặn vì thay đổi cục bộ (khi nâng cấp từ Harvey). Nếu bạn từng sửa trực tiếp harvey.yaml, 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 và chạy git stash drop. Cách tốt hơn là đặt cài đặt vào sellbird.local.yaml.
  • Email vào spam hoặc bị trả lại nhiều. README nhấn mạnh warmup hộp thư và dùng tên miền gửi riêng. Hãy tạm dừng bằng sellbird sending pause, đọc phần Legal and deliverability trong repo và kiểm tra lại cách gửi.
  • Gặp lỗi khác. Xem tài liệu Troubleshooting trong thư mục docs/ của repo.

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

Điểm mạnh. Chạy trên máy bạn, dữ liệu nằm ở thư mục của bạn. Không cần API key mô hình, tậ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í, bước đọc website không tốn tiền. Có cơ chế duyệt trước khi gửi và bước kiểm tra tự động trước khi thư đi. Giấy phép là AGPL-3.0, và repo còn được cập nhật trong vài tháng gần đây.

Giới hạn. Cần quen với terminal và Python, và phải chuẩn bị hộp thư, tên miền gửi và warmup, điều mà tự công cụ không làm thay. README chỉ giải thích cài đặt trên macOS/Linux, nên người dùng Windows nên đọc kỹ tài liệu trước. Cold email còn chịu ràng buộc pháp lý và quy định về spam ở từng nước; README có dẫn tới tài liệu pháp lý, nhưng bạn phải tự chịu trách nhiệm với việc gửi của mình. Vì giấy phép là AGPL-3.0, hãy đọc kỹ nếu bạn định đóng gói lại thành dịch vụ.

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 chạy sẵn trên sellbird.ai (đang ở giai đoạn early access, có sẵn tên miền gửi, hộp thư và warmup). Nếu bạn chỉ cần gửi một vài email thủ công, một công cụ nặng như thế này là thừa. Còn nếu bạn muốn thử, cứ để chế độ duyệt tay và bắt đầu với danh sách nhỏ.

4.4/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 (OpenStreetMap) là $0 và bước đọc website cũng không tốn tiền. 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 nhắc Google Workspace khoảng 7 đô la một tháng). Nguồn tìm trả phí hiện chi phí trước khi chạy.

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 hoặc 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ố biến trong .env.example như REOON_API_KEY hay HUNTER_API_KEY là của các dịch vụ kiểm tra email tuỳ chọn, không phải của mô hình.

Có cần GPU hoặc máy cấu hình mạnh không?

Tư liệu không nêu yêu cầu phần cứng nào và không nhắc đến GPU. Phần suy nghĩ chạy qua gói Claude hoặc ChatGPT của bạn, không chạy mô hình cục bộ.

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

README viết lệnh cài cho macOS/Linux và phần Docker được ghi là dành cho Linux. README chỉ nhắc rằng bản cài bằng pip lưu dữ liệu ở %APPDATA%\sellbird trên Windows. Chưa có hướng dẫn cài chi tiết cho Windows trong tư liệu, bạn nên xem thư mục docs/ và mục Troubleshooting trong repo.

Email có tự gửi đi 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 đến khi bạn tự bật autopilot. Có bước kiểm tra trước khi gửi, và lệnh sellbird sending pause dừng mọi thứ ngay.

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, dữ liệu, cơ sở dữ liệu và log nằm trong một thư mục home của bạn, và dashboard mở ở địa chỉ 127.0.0.1. Tư liệu không nói thêm về các chi tiết bảo mật khác. Bạn nên tự giữ kín file .env vì trong đó có mật khẩu hộp thư.

Tôi đang dùng Harvey thì có phải cài lại không?

Không. Harvey được đổi tên thành Sellbird từ bản 0.4.0, cấu hình, dữ liệu và đăng nhập dashboard được giữ lại. Bạn chạy git pull, pip install -e . một lần, rồi sellbird dashboard. Lệnh harvey cũ vẫn dùng được tạm thời nhưng sẽ bị bỏ trong 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.Tải mã nguồn
    2. B.Tạo môi trường ảo 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 khách
    6. F.Mở dashboard và bật vòng lặp
    7. G.Hoặc để Claude cài giúp
  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ụ nhỏ tìm khách địa phương
    2. B.Nhân viên sales chỉ cần danh sách để gửi bằng công cụ khác
    3. C.Founder gửi chuỗi email cá nhân hoá
    4. D.Xử lý phản hồi mà không bỏ sót
  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ỏ.