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

Sellbird: tự động tìm khách và gửi cold email — 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ự động tìm khách và gửi cold email — 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 mã nguồn mở viết bằng Python. Nó tìm công ty hợp với khách hàng của bạn, tìm người quyết định, kiểm tra email, viết cold email riêng cho từng người, gửi đi và xử lý thư trả lời. Nó dùng gói Claude Pro/Max hoặc ChatGPT (Codex) bạn đang có nên không cần API key của mô hình. Cài không quá khó nếu bạn quen terminal, hoặc có thể nhờ Claude Code cài giúp.

Sellbird là một nền tảng mã nguồn mở chạy trên máy của bạn, làm trọn quy trình gửi cold email: 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 thư riêng cho từng người, gửi đi rồi xử lý thư trả lời. Dự án trước đây tên là Harvey, nay đổi tên thành Sellbird và vẫn giữ nguyên lịch sử.

Người nên xem là chủ doanh nghiệp nhỏ, nhân viên kinh doanh, người làm marketing hoặc lập trình viên đang cần tìm khách mới mà không muốn trả tiền cho cả bộ công cụ như Apollo, ZoomInfo, Clearbit hay Clay. Theo README, Sellbird không cần những công cụ đó.

Điểm đáng giá nhất có hai ý. Thứ nhất, nó tư duy qua Claude Code CLI trên gói Claude Pro hoặc Max (hoặc Codex trên gói ChatGPT), nên không có API key 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. Hiện repo có khoảng 5.250 sao và 1.127 fork, giấy phép AGPL-3.0. 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

Nền tảng mã nguồn mở tìm công ty và người quyết định, kiểm tra email, viết và gửi cold email cá nhân hoá, chạy trên gói Claude hoặc ChatGPT của 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 dây chuyền. Bạn có thể chạy hết từ đầu đến cuối, hoặc dừng ở bất kỳ bước nào.

A.Tìm công ty đúng khách hàng của bạn

Nó tìm doanh nghiệp khớp với mô tả khách hà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í. Mỗi lần tìm bằng nguồn trả phí đều hiện chi phí trước khi chạy, nên bạn không bị trừ tiền bất ngờ.

B.Đọc website để biết vì sao họ sẽ 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, hay đang tuyển một vị trí nào đó. Bước này không gọi mô hình, không tốn tiền, chỉ khoảng ba yêu cầu HTTP cho mỗi công ty. Lợi ích là email mở đầu bằng một lý do thật thay vì câu chào chung chung.

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

Nó tìm chủ hoặc quản lý được nêu 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. Vì lấy từ trang công khai của họ, bạn có thông tin có nguồn rõ ràng.

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

Sellbird học mẫu email của công ty rồi kiểm tra một địa chỉ. Mỗi địa chỉ được đánh dấu là verified, risky, guess hoặc invalid, và chỉ địa chỉ gửi được mới bị gửi tới. Điều này giúp giảm thư bị trả về, một việc rất quan trọng với tên miền gửi thư của bạn.

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. Sau đó gửi từ hộp thư 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.

F.Xử lý thư trả lời

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

G.Chỉ cần danh sách thì xuất CSV

Nếu bạn chỉ muốn danh sách khách, hãy dừng sau bước kiểm tra email và chạy sellbird export. Bạn nhận được một file CSV sẵn sàng đưa vào công cụ gửi email 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 Python từ 3.11. README lưu ý macOS có sẵn bản 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ới Claude Code CLI đã đăng nhập (claude login), hoặc gói ChatGPT có Codex CLI.
  • Một hộp thư để gửi đi, tốt nhất là Google Workspace trên một tên miền gửi thư riêng. Microsoft 365 và SMTP cũng dùng được.
  • Warmup (làm nóng) cho hộp thư đó. README gợi ý TrulyInbox. Sellbird đọc tỉ lệ vào hộp thư đến của công cụ này để báo khi nào bạn đã sẵn sàng gửi. Đây là link giới thiệu, người duy trì dự án có thể nhận hoa hồng.

Về chi phí, README nêu: tìm doanh nghiệp bằng nguồn mặc định là 0 đồng, nguồn trả phí rẻ nhất khoảng 0,37 USD cho 1.000 kết quả. Đọc website là 0 đồng. Hộp thư Google Workspace khoảng 7 USD mỗi tháng. Ngoài ra bạn dùng gói thuê bao Claude hoặc ChatGPT sẵn có.

File .env.example liệt kê các khóa tùy 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 cái nào thật sự dùng. Tư liệu không cho biết cần phần cứng đặc biệt nào.

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

  1. Tải mã nguồnClone repo về máy rồi vào thư mục sellbird
  2. Cách nhanh: nhờ Claude càiMở claude trong thư mục và nói yêu cầu cài đặt
  3. Hoặc tự càiTạo môi trường ảo và cài gói bằng pip
  4. Điền thông tinCopy .env.example thành .env rồi điền
  5. Dạy Sellbird về sản phẩmChạy sellbird train với website của bạn
  6. Tìm khách và chạyChạy discover, mở dashboard, rồi chạy run

Có hai cách: để Claude Code hướng dẫn bạn, hoặc tự gõ lệnh. Người mới nên thử cách đầu.

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

Mở terminal (trên Windows là PowerShell hoặc Git Bash, trên macOS là ứng dụng Terminal), đi tới thư mục bạn muốn đặt dự án, rồi chạy:

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

Lệnh đầu tải mã nguồn về. Lệnh thứ hai đi vào thư mục vừa tải. Các lệnh sau đều phải chạy trong thư mục này, đây là chỗ người mới hay quên.

B.Cách nhanh: để Claude cài giúp

Trong thư mục sellbird, gõ:

Terminal
claude

Khi Claude Code mở, bạn nói: set up Sellbird for me (cài Sellbird giúp tôi). Theo README, file CLAUDE.md trong repo biến Claude Code thành người hướng dẫn: kiểm tra bạn đang ở đâu, cài những gì còn thiếu, hỏi thứ cần hỏi và dạy Sellbird về sản phẩm của bạn. Bạn cần đã đăng nhập Claude CLI trước (claude login).

C.Hoặc tự cài bằng tay

Bước 1 là tạo môi trường ảo và cài gói. Lệnh gốc của README:

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 thư mục .venv (môi trường Python riêng), bật nó lên, rồi cài Sellbird ở chế độ chỉnh sửa được. Sau khi xong, bạn có lệnh sellbird. Lệnh source .venv/bin/activate dành cho macOS và Linux. README chưa ghi lệnh bật môi trường ảo riêng cho Windows. Nếu dùng Windows và gặp khó, hãy chọn cách để Claude Code cài giúp ở trên, hoặc xem thêm mục Troubleshooting trong thư mục docs/ của repo.

D.Đ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 để bạn sửa. Mỗi biến đều có chú thích ngay trong file. Điền thông tin hộp thư của bạn (ví dụ Gmail hoặc SMTP). Các khóa của dịch vụ kiểm tra email hay TrulyInbox là tùy chọn. Trên Windows, nếu $EDITOR không chạy, bạn có thể mở file .env bằng Notepad và sửa tay. Tuyệt đối không đăng file .env lên mạng.

E.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ông ty bạn. Sellbird đọc trang đó để hiểu bạn bán gì rồi ghi vào file sellbird.local.yaml. File này là nơi để đặt cài đặt riêng, git không đụng tới.

F.Xác nhận khách hàng tốt trông như thế nào

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

Bước này để bạn chọn các tín hiệu mua hàng cần dò. Tham số free đúng như README ghi.

G.Tìm doanh nghiệp

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

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

H.Mở bảng điều khiển và chạy 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). sellbird run khởi động vòng lặp làm việc. Hãy để cửa sổ terminal này mở khi đang chạy. README cũng nói trên Linux bạn có thể chạy bằng Docker, repo có sẵn Dockerfile và docker-compose.yml.

Cold email có luật riêng và hộp thư gửi sai cách có thể bị đánh dấu spam. Hãy đọc tài liệu Legal and deliverability trong thư mục docs của repo trước khi bật gửi thật. Nên dùng tên miền gửi thư riêng và làm warmup như README khuyên.

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

Có ba dấu hiệu theo README:

  • Chạy sellbird --help hoặc các lệnh như sellbird dashboard mà không báo lỗi "command not found". Điều đó cho thấy gói đã được cài vào môi trường ảo đang bật.
  • sellbird dashboard in ra một link riêng tới http://127.0.0.1:5555. Mở link đó trên trình duyệt sẽ thấy bảng điều khiển.
  • sellbird run in ra dòng "Sellbird is online", kiểm tra trạng thái dây chuyền, rồi báo từng việc như viết chuỗi email hoặc soạn câu trả lời, cuối cùng là "Cycle complete" và nghỉ khoảng 15 phút. README cho ví dụ có dòng kiểu "5 emails waiting for your approval". Thấy email nằm chờ duyệt trong Outbox nghĩa là hệ thống đang làm việc đúng.

Bạn cũng có thể thử với dữ liệu demo. README nói dữ liệu demo là bịa, một công ty tên Bookwell bán phần mềm đặt lịch cho thợ lợp mái, phòng khám nha và tiệm điều hoà, dùng tên miền .test.

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

Phần này bám theo những gì README mô tả.

A.Chủ doanh nghiệp nhỏ muốn tìm khách mới

Bạn bán phần mềm đặt lịch hẹn cho các tiệm dịch vụ. Bạn chạy sellbird train với website của mình, xác nhận tín hiệu "chưa có đặt lịch online" bằng sellbird signals --confirm free, rồi chạy sellbird discover. Sellbird tìm các tiệm phù hợp trên OpenStreetMap, đọc website của họ và đánh dấu tiệm nào đang thiếu đặt lịch. Kết quả là một danh sách khách tiềm năng có lý do cụ thể để liên hệ, chưa tốn đồng nào.

Sellbird không gửi gì đi nếu bạn chưa bấm duyệt. Tự động hoá phần việc nặng, giữ quyền quyết định trong tay mình.

Ông T

B.Nhân viên kinh doanh cần duyệt thư trước khi gửi

Bạn mở dashboard và vào Outbox. Mỗi email chờ duyệt là một thư riêng cho từng người, ví dụ chuỗi hai email nói về việc công ty đang tuyển nhân viên điều phối. Trước khi cho gửi, hệ thống tự kiểm tra, không dùng mô hình, để loại thư còn sót mã điền tự động, cụm từ bị cấm, thư quá dài, thừa link hoặc địa chỉ không gửi được. Bạn đọc, sửa nếu cần rồi duyệt. Thư đi từ hộp thư thật của bạn, trong giới hạn mỗi ngày.

C.Người làm marketing chỉ cần danh sách

Bạn đã có công cụ gửi email riêng nên chỉ cần dữ liệu. Hãy chạy sellbird discover, để Sellbird tìm người quyết định và kiểm tra email, rồi dừng và chạy:

Terminal
sellbird export

Bạn nhận file CSV sẵn sàng nhập vào công cụ gửi khác. Mỗi địa chỉ đã có nhãn verified, risky, guess hoặc invalid để bạn lọc.

D.Người đang chạy Harvey muốn nâng cấp

Nếu trước đây bạn dùng Harvey, README nói cấu hình, dữ liệu và đăng nhập dashboard đều được giữ. 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 cơ sở dữ liệu cũ. Nó không ghi đè file đã có tên mới. Nếu bạn sửa trực tiếp file harvey.yaml thì git pull sẽ báo xung đột, README hướng dẫn dùng git stash, git pull, git stash pop.

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

A.Lệnh sellbird không được nhận

Thường là bạn chưa bật môi trường ảo hoặc chưa chạy bước cài gói. Mở terminal mới, vào thư mục sellbird, bật lại môi trường ảo (trên macOS/Linux dùng source .venv/bin/activate) rồi chạy lại pip install -e .. Trên Windows, README chưa ghi lệnh bật môi trường ảo, hãy xem mục Troubleshooting trong docs/.

B.Python quá cũ

Sellbird cần Python từ 3.11. Trên macOS, lệnh python3 có thể là bản 3.9. Hãy cài bản mới như README gợi ý (brew install python@3.13) rồi dùng python3.13 để tạo môi trường ảo.

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

Sellbird nghĩ qua Claude Code CLI, nên nếu chưa đăng nhập nó không làm việc được. Chạy claude login và dùng tài khoản Pro hoặc Max. Nếu bạn dùng ChatGPT thì xem hướng dẫn Codex trong thư mục docs/.

D.Git báo local changes would be overwritten khi nâng cấp

Đây là lỗi người dùng Harvey cũ hay gặp nếu đã sửa harvey.yaml. Làm theo README: git stash, git pull, rồi git stash pop. Nếu có xung đột, giữ các dòng của bạn, xoá các dấu xung đột rồi chạy git stash drop. Từ nay hãy đặt cài đặt riêng trong sellbird.local.yaml.

E.Email vào spam hoặc bị trả về nhiều

Tư liệu không liệt kê lỗi cụ thể, nhưng đây là rủi ro rất dễ gặp với cold email. Hãy dùng tên miền gửi thư riêng, làm warmup trước khi gửi, chỉ gửi tới địa chỉ verified và giữ chế độ duyệt tay. Nếu cần dừng gấp, README ghi lệnh sellbird sending pause sẽ dừng mọi thứ ngay.

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

Điểm mạnh. Không cần API key mô hình và không tính tiền theo token nếu bạn đã có gói Claude hoặc ChatGPT. Dữ liệu chạy trên máy bạn. Mặc định phải duyệt tay trước khi gửi, lại có bước kiểm tra tự động không dùng mô hình để chặn thư lỗi. Có bảng điều khiển, xuất CSV, và mã nguồn mở nên bạn đọc và sửa được các prompt và kỹ năng bán hàng.

Giới hạn. Bạn phải tự lo hộp thư gửi, tên miền và warmup. Cài đặt cần quen dòng lệnh, và ví dụ trong README viết theo hướng macOS/Linux. Nguồn tìm miễn phí dựa trên OpenStreetMap nên phù hợp nhất với doanh nghiệp địa phương. Tư liệu không nói độ phủ dữ liệu ở Việt Nam. Giấy phép AGPL-3.0 có điều kiện riêng nếu bạn định tích hợp vào sản phẩm khác.

Khi nên chọn cách khác. Nếu bạn không muốn tự vận hành, README nói có bản hosted tại 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ỉ gửi vài email thủ công mỗi tuần thì một công cụ đơn giản là đủ. Và nếu bạn không rõ quy định gửi thư thương mại ở thị trường của người nhận, hãy tìm hiểu trước khi bật chế độ tự động.

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

Phần mềm là mã nguồn mở, giấy phép AGPL-3.0. README nói không có hoá đơn API cho mô hình vì nó dùng gói Claude Pro/Max hoặc ChatGPT bạn đã có. Nguồn tìm doanh nghiệp mặc định là 0 đồng, còn hộp thư gửi (ví dụ Google Workspace khoảng 7 USD mỗi tháng) là chi phí của bạn.

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

Không. README ghi rõ Sellbird nghĩ qua Claude Code CLI hoặc Codex trên gói thuê bao, không dùng API key và không tính theo token. Một số dịch vụ tuỳ chọn như kiểm tra email có biến khoá riêng trong file .env.example.

Cần GPU hay máy mạnh không?

Tư liệu không nêu yêu cầu phần cứng đặc biệt, và phần suy nghĩ chạy qua Claude hoặc Codex chứ không chạy mô hình tại máy. Bạn chỉ 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 cài đặt được viết theo hướng macOS/Linux và README chưa ghi lệnh bật môi trường ảo cho Windows. Bạn có thể thử để Claude Code cài giúp hoặc xem mục Troubleshooting trong thư mục docs của repo.

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

Mặc định thì không. Mọi email đều nằm trong Outbox chờ bạn duyệt cho tới khi bạn tự bật autopilot. Ngay cả khi bật, các thư có link tới tên miền không phải của bạn vẫn bị giữ lạ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?

README nói Sellbird chạy trên máy của bạn, cấu hình, kiến thức và dữ liệu nằm trong một thư mục home. Tư liệu không bàn thêm về bảo mật chi tiết. Nếu thấy lỗ hổng, repo yêu cầu làm theo SECURITY.md thay vì mở issue công khai.

Sellbird khác gì Harvey?

Là cùng một dự án, cùng lịch sử, chỉ đổi tên từ phiên bản 0.4.0. Cấu hình, dữ liệu và đăng nhập dashboard được giữ khi nâng cấp. 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ì
    1. A.Tìm công ty đúng khách hàng của bạn
    2. B.Đọc website để biết vì sao họ sẽ mua
    3. C.Tìm người ra quyết định
    4. D.Kiểm tra địa chỉ email
    5. E.Viết và gửi
    6. F.Xử lý thư trả lời
    7. G.Chỉ cần danh sách thì xuất CSV
  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 cài giúp
    3. C.Hoặc tự cài bằng tay
    4. D.Điền thông tin đăng nhập
    5. E.Dạy Sellbird về sản phẩm của bạn
    6. F.Xác nhận khách hàng tốt trông như thế nào
    7. G.Tìm doanh nghiệp
    8. H.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ủ doanh nghiệp nhỏ muốn tìm khách mới
    2. B.Nhân viên kinh doanh cần duyệt thư trước khi gửi
    3. C.Người làm marketing chỉ cần danh sách
    4. D.Người đang chạy Harvey muốn nâng cấp
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Lệnh sellbird không được nhận
    2. B.Python quá cũ
    3. C.Claude chưa đăng nhập
    4. D.Git báo local changes would be overwritten khi nâng cấp
    5. E.Email vào spam hoặc bị trả về nhiều
  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ỏ.