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/ChatGPT — 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/ChatGPT — 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 doanh nghiệp phù hợp, tìm người quyết định, kiểm tra email, viết thư cá nhân hoá, gửi đi và soạn sẵn câu trả lời cho phản hồi. Cài không quá khó nếu bạn quen terminal, và mặc định không có email nào được gửi khi bạn chưa duyệt.

Sellbird là một công cụ mã nguồn mở chạy ngay trên máy bạn, làm trọn quy trình bán hàng chủ động bằng email: tìm 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 thư riêng cho từng người, gửi đi và xử lý phản hồi. Trước đây dự án tên là Harvey, nay đổi tên thành Sellbird nhưng vẫn là cùng một dự án, cùng lịch sử.

Người nên xem là chủ doanh nghiệp nhỏ, người làm sales hoặc marketing, freelancer và lập trình viên muốn có danh sách khách tiềm năng mà không phải trả tiền cho các công cụ prospecting đắt đỏ. Repo hiện có khoảng 5250 sao và 1127 fork, và vẫn được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất là Sellbird không dùng API key của mô hình AI. Nó chạy 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, nên bạn không bị tính tiền theo token. Thêm nữa, mặc định không có email nào rời máy bạn cho đến khi bạn duyệt. Bạn có thể xem video ngắn bên dưới để thấy nó chạy trước khi bắt tay vào cài.

Ứ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, kiểm tra email, viết và gửi cold email, xử lý phản hồ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 dây chuyền nhiều bước. Bạn có thể chạy hết, hoặc dừng ở bất kỳ bước nào.

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

Nó tìm các 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 trả phí đều hiện chi phí trước khi chạy, nên không lo bị trừ tiền bất ngờ.

B.Hiểu vì sao họ có thể mua

Sellbird đọc website của từng công ty để tìm các 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 mô hình AI nên không tốn chi phí, mỗi công ty chỉ cần ba request HTTP. Nhờ vậy bức thư sau này có chi tiết thật để nói, không phải lời chào chung chung.

C.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 cơ sở dữ liệu liên hệ.

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

Sellbird học quy luật đặ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ư. Điều này giúp bảo vệ uy tín hộp thư của bạn, vì gửi nhiều thư bị trả lại là cách nhanh nhất để vào spam.

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

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

Sellbird đọc từng phản hồi và soạn sẵn câu trả lời. Nó tách thư trả lời tự động sang một bên, tôn trọng yêu cầu ngừng nhận thư ngay lập tức, và chuyển cho bạn những thứ 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 rồi chạy sellbird export để có file CSV đưa thẳng vào công cụ gửi thư khác.

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 bản này. README lưu ý macOS đi kèm Python 3.9, nên nếu python3 --version báo bản cũ thì chạy brew install python@3.13 trước.
  • Gói Claude Pro hoặc Max đã đăng nhập CLI bằng 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 dùng được.
  • Warmup (làm nóng) hộp thư đó. README giới thiệu TrulyInbox cho việc này. Lưu ý đây là liên kết affiliate của tác giả. Bạn không bắt buộc phải dùng nó theo tư liệu, nhưng cần có cách warmup nào đó.

Về chi phí, README nói 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ả với nguồn trả phí rẻ nhất. Đọc website là 0 đồng. Phần còn lại là gói AI bạn đang có và một hộp thư (README ước tính khoảng 7 USD mỗi tháng cho Google Workspace).

Về hệ điều hành, README chỉ nói rõ thư mục dữ liệu cho macOS, Windows và Linux. Phần Docker được ghi là cho Linux. Các lệnh cài trong README viết kiểu macOS/Linux. README không nói gì về yêu cầu phần cứng hay GPU.

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

  1. Tải mã nguồnDùng git clone rồi vào thư mục sellbird
  2. Cài đặtTạo môi trường ảo và cài bằng pip install -e .
  3. Điền thông tinSao chép .env.example thành .env và điền
  4. Dạy Sellbird về bạnChạ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

README đưa ra hai cách: nhờ Claude cài hộ, hoặc tự cài. Mình khuyên người mới thử cách đầu.

A.Cách 1: Để Claude cài giúp

Mở terminal (Terminal trên macOS, hoặc cửa sổ dòng lệnh bạn quen dùng), 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ề máy. 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: 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 thiết và huấn luyện Sellbird về sản phẩm của bạn.

Chỗ dễ vấp: bạn phải đứng đúng trong thư mục sellbird trước khi gõ claude. Nếu chưa có Claude CLI hoặc chưa đăng nhập, hãy chạy claude login trước.

B.Cách 2: Tự cài

Bước đầu là tạo môi trường ảo và cài gói. README nhấn mạnh dùng python3.13, không dùng python3 trần vì trên macOS đó là bản 3.9.

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 .

Dòng này tạo môi trường ảo tên .venv, kích hoạt nó, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau bước này bạn sẽ có lệnh sellbird. Lưu ý: source .venv/bin/activate là cú pháp macOS/Linux. README không viết lệnh kích hoạt cho Windows. Nếu dùng Windows, bạn cần cách kích hoạt môi trường ảo Python theo chuẩn của Windows, hoặc nhờ Claude cài theo cách 1.

Bước hai là đ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. File mẫu có các biến cho Gmail (GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET), SMTP/IMAP, Microsoft 365, cùng một số dịch vụ kiểm tra email như Reoon, ZeroBounce, Hunter. Mỗi biến có chú thích ngay trong file. Bạn chỉ điền phần mình dùng, ví dụ hộp thư gửi.

File .env chứa mật khẩu và khoá truy cập hộp thư. Đừng gửi nó cho ai, đừng đưa lên GitHub hay chụp màn hình có lộ nội dung.

Bước ba là dạy Sellbird về sản phẩm của bạn từ website.

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

Thay địa chỉ bằng website thật của bạn. Lệnh này ghi kết quả vào file sellbird.local.yaml.

Bước bốn là xác nhận thế nào là khách tốt.

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

Bước năm là tìm doanh nghiệp. Nguồn mặc định miễn phí, không cần tài khoản.

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

Bước sáu là mở bảng điều khiển và khởi động 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ỉ trên máy bạn (127.0.0.1:5555). Link này chỉ mở được trên máy của bạn. Còn sellbird run bắt đầu vòng lặp làm việc.

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, và chi tiết nằm trong tài liệu Docker của repo (thư mục docs/).

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

Sau khi cài, lệnh sellbird phải gọi được trong terminal. Dấu hiệu rõ nhất là khi chạy sellbird run, bạn thấy một màn hình tương tự ví dụ trong README:

Code
$ sellbird run

============================================================
Sellbird is online.
============================================================
Checking pipeline state...
Decision: write_campaign (3 new prospects with no drafts)
  handler   → Elena Park, Harbor Dental Studio     interested, answer drafted
  handler   → Priya Nair, Highline Roofing         objection, answer drafted
  writer    → 2-email sequence: Phoenix HVAC hiring a dispatcher
  outbox    → 5 emails waiting for your approval
Cycle complete. Sleeping for 15 minutes.

Bạn sẽ thấy dòng Sellbird is online, một quyết định của vòng lặp, rồi các email xếp hàng chờ duyệt ở Outbox, và cuối cùng là thông báo nghỉ 15 phút. Dữ liệu trong ví dụ của README là bịa (công ty Bookwell bán đặt lịch cho thợ lợp mái, nha khoa, điều hoà), nên kết quả thật của bạn sẽ khác.

Bạn cũng nên mở link do sellbird dashboard in ra để xem các màn hình. Nếu dashboard mở được và thấy công ty vừa tìm, nghĩa là phần lõi đã chạy.

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

Cả ba tình huống dưới đây đều dùng đúng các lệnh có trong README. Nội dung tình huống là ví dụ của mình để bạn hình dung.

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ửa hàng nhỏ. Bạn chạy sellbird train với website của mình để Sellbird hiểu bạn bán gì. Sau đó sellbird signals --confirm free để xác nhận tín hiệu cần tìm, ví dụ cửa hàng chưa có đặt lịch online. Rồi sellbird discover để tìm trên nguồn miễn phí. Kết quả là danh sách doanh nghiệp kèm lý do họ có thể cần bạn, để bạn mở dashboard xem từng cái.

Nó tìm khách, viết thư và soạn câu trả lời, nhưng không có email nào đi ra nếu bạn chưa bấm duyệt.

Ông T

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

Bạn đã có công cụ gửi thư riêng và chỉ muốn nguồn khách. Hãy 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 dừng lại và chạy:

Terminal
sellbird export

Lệnh này xuất file CSV sẵn để đưa vào công cụ gửi thư (sequencer) của bạn. Mỗi địa chỉ đã được gắn nhãn verified, risky, guess hoặc invalid, nên bạn lọc được theo độ tin cậy.

C.Chủ doanh nghiệp duyệt thư mỗi sáng

Bạn để sellbird run chạy, vòng lặp nghỉ 15 phút giữa các lượt. Mỗi sáng bạn mở dashboard, vào Outbox, đọc các email đang chờ rồi duyệt cái nào ổn. Khi có phản hồi, Sellbird đã soạn sẵn câu trả lời cho các thư quan tâm hoặc phản đối, bạn chỉ đọc lại. Thư nào nó không nên tự trả lời sẽ được chuyển cho bạn. Nếu thấy có gì không ổn, một lệnh dừng tất cả:

Terminal
sellbird sending pause

D.Người dùng Harvey cũ nâng cấp

Nếu bạn đang chạy Harvey, README nói cấu hình, dữ liệu và đăng nhập dashboard đượ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 tương ứng. Nó không ghi đè file đã có tên mới. Nếu bạn từng sửa trực tiếp file harvey.yaml thì git pull có thể báo lỗi, và README có hướng dẫn dùng git stash. Cách tốt hơn là đặt thiết lập riêng vào sellbird.local.yaml, file mà git không đụng tới.

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

A.Python quá cũ, cài không được

Trên macOS, python3 thường là bản 3.9, trong khi Sellbird cần 3.11 trở lên. Hãy chạy python3 --version kiểm tra. Nếu thấy bản cũ, cài bản mới theo README bằng brew install python@3.13 rồi dùng python3.13 để tạo môi trường ảo.

B.Gõ sellbird báo không tìm thấy lệnh

Thường là bạn chưa kích hoạt môi trường ảo, hoặc mở terminal mới nên môi trường ảo không còn hiệu lực. Vào lại thư mục sellbird, kích hoạt .venv rồi thử lại. Nếu vẫn lỗi, chạy lại pip install -e . trong môi trường đó.

C.Claude chưa đăng nhập

Sellbird dựa vào Claude Code CLI đã đăng nhập. Nếu chưa, hãy chạy claude login rồi thử lại. Nếu dùng ChatGPT, bạn cần Codex CLI, và README có hướng dẫn riêng cho Codex trong thư mục docs/.

D.Dashboard không mở được

Dashboard chạy tại địa chỉ trên máy bạn và dùng link riêng do sellbird dashboard in ra. Hãy dùng đúng link đó, không tự gõ địa chỉ. Nếu vẫn không được, xem tài liệu Troubleshooting trong repo.

E.Thư rơi vào spam hoặc bị trả lại

Đây là rủi ro của mọi công cụ cold email. README khuyên dùng tên miền gửi riêng, có warmup cho hộp thư, và chỉ gửi tới địa chỉ đã được xác minh. Đừng bỏ qua bước warmup, và đừng tắt các kiểm tra trước khi gửi. Hãy đọc tài liệu Legal and deliverability trong repo về các quy tắc bạn phải tuân thủ.

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

Điểm mạnh. Chạy trên máy bạn nên bạn kiểm soát dữ liệu. Không tốn tiền API mô hình vì dùng gói bạn đã có. Các bước tìm kiếm cơ bản miễn phí. Mặc định mọi email chờ bạn duyệt, kèm bước kiểm tra tự động không dùng mô hình để chặn thẻ chưa điền, cụm từ bị cấm, thư quá dài, quá nhiều link và địa chỉ không gửi được. Giấy phép AGPL-3.0 và có thể chỉnh sửa prompt, kỹ năng bán hàng.

Giới hạn. Bạn vẫn phải có hộp thư gửi, tên miền và warmup. Các lệnh cài đặt trong README viết cho macOS/Linux, người dùng Windows sẽ phải tự xoay xở thêm hoặc nhờ Claude. Nguồn tìm miễn phí dựa trên OpenStreetMap, nên độ phủ phụ thuộc vào dữ liệu có ở đó. Tôi cũng không thấy README nói gì về độ phủ doanh nghiệp tại Việt Nam, bạn nên thử với một ngành nhỏ trước. Giấy phép AGPL cũng đáng đọc kỹ nếu bạn định tích hợp vào sản phẩm thương mại.

Khi nào chọn cách khác. Nếu bạn không muốn đụng đến terminal hay cấu hình, README có nhắc bản hosted tại trang chủ dự án, ở giai đoạn truy cập sớm, với tên miền gửi, hộp thư và warmup được thiết lập sẵn. Nếu bạn chỉ cần vài chục khách và muốn tự viết thư thì công cụ này có thể là quá nhiều. Cuối cùng, gửi thư lạnh có quy định pháp lý ở từng nơi, vì vậy hãy tự kiểm tra luật áp dụng cho bạn trước khi bật chế độ tự động.

4.0/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. Nguồn tìm doanh nghiệp mặc định và bước đọc website đều miễn phí theo README. 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 ước tính Google Workspace khoảng 7 USD mỗi tháng).

Có cần API key của mô hình AI không?

Không. Theo README, 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. Không có API key mô hình và không tính tiền theo token. Một số dịch vụ kiểm tra email hay nguồn tìm trả phí thì có biến API key riêng trong file .env, nhưng chúng là tuỳ chọn.

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

README không nêu yêu cầu phần cứng nào, và phần xử lý AI chạy qua gói đăng ký của bạn nên chưa có thông tin về cấu hình tối thiểu. Yêu cầu rõ ràng duy nhất là Python 3.11 trở lên.

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

README có ghi thư mục dữ liệu cho Windows, nên có hỗ trợ ở mức đó. Nhưng các lệnh cài đặt trong README viết theo kiểu macOS/Linux, và phần Docker được ghi là cho Linux. Người dùng Windows nên nhờ Claude cài theo cách 1 hoặc xem tài liệu trong thư mục docs/.

Email có tự gửi đi mà tôi không biết không?

Không, trừ khi bạn tự bật autopilot. Mặc định mọi email nằm ở Outbox chờ bạn duyệt. Có kiểm tra trước khi gửi, 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 lưu ở đâ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 chung trên máy, gồm database, log và token của dashboard. README không nói gì thêm về mức độ bảo mật ngoài việc chạy nội bộ, nên hãy tự bảo vệ file .env.

Khác gì Harvey?

Sellbird chính là Harvey đã đổi tên, cùng dự án và cùng lịch sử. Cấu hình và dữ liệu cũ được chuyển sang tên mới khi chạy lần đầu. Lệnh harvey cũ vẫn dùng được tạm thời nhưng sẽ bị gỡ ở bản sau.

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ọ có thể 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 1: Để Claude cài giúp
    2. B.Cách 2: Tự cài
  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 sales chỉ cần danh sách
    3. C.Chủ doanh nghiệp duyệt thư mỗi sáng
    4. D.Người dùng Harvey cũ nâng cấp
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Python quá cũ, cài không được
    2. B.Gõ sellbird báo không tìm thấy lệnh
    3. C.Claude chưa đăng nhập
    4. D.Dashboard không mở được
    5. E.Thư rơi vào spam hoặc bị trả lại
  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ỏ.