Cách kết nối Bluesky với Claude Code

Hermoso là một máy chủ MCP tiếp thị: hơn 1.000 công cụ trên một endpoint OAuth duy nhất, cho phép một agent nghiên cứu các quảng cáo đang chạy trong một thị trường, tạo quảng cáo hình ảnh và video, đăng chúng, và xây dựng các chiến dịch trả phí phía sau chúng. Claude Code truy cập toàn bộ những thứ này qua một kết nối duy nhất. Trang này chỉ đề cập một phần: Claude Code thực sự làm được gì trên Bluesky, và Bluesky không cho phép Claude Code làm gì.

Kết nối Hermoso với Claude Code

1. Một lệnh, và không cần khóa.

   claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

   Đã ở trong một phiên? Gõ /plugin marketplace add hermoso-ai/hermoso, rồi /plugin install hermoso@hermoso. Nó cài năm kỹ năng Hermoso (research, ad-from-brand, generate, product-photoshoot và marketing) chạy lệnh hermoso qua npx, nên không có danh sách công cụ nào được nạp vào phiên của bạn và không có gì tốn ngữ cảnh cho đến khi nó chạy.
2. Đăng nhập một lần.

   npx -y hermoso auth login

   Lệnh này mở trình duyệt để đăng nhập qua loopback, giống cách gh làm, và lưu thông tin xác thực chỉ chủ sở hữu mới truy cập được vào ~/.hermoso/config.json. Claude Code sẽ chạy lệnh này giúp bạn ở lần đầu tiên cần đến Hermoso. Máy đó không có trình duyệt, chẳng hạn CI, máy từ xa hay container? Hãy tạo khóa trong MCP & CLI → Terminal & API keys rồi chạy npx -y hermoso auth login --token hmk_…. Khóa mang quyền chi tiêu thực sự, nên hãy coi nó như mật khẩu.
3. Tùy chọn: thêm máy chủ MCP. Nếu bạn cũng muốn các công cụ Hermoso nằm trong danh sách công cụ của Claude Code, hãy chạy claude mcp add hermoso -- npx -y hermoso mcp sau khi đăng nhập. Nó đọc cùng thông tin xác thực đã lưu, nên không có khóa nào được đưa vào .claude.json. Các kỹ năng tiếp cận mọi công cụ mà không cần nó.
4. Yêu cầu Claude Code làm gì đó. “Lấy những quảng cáo chạy lâu nhất của ba đối thủ gần nhất của tôi và phối lại hook tốt nhất thành video 9:16” hoặc “đăng bản render này lên kênh.” Agent tự chọn công cụ; bạn duyệt khoản chi tiêu.

Plugin và máy chủ MCP tùy chọn truy cập cùng các công cụ và cùng tài khoản. Khác biệt nằm ở ngữ cảnh: một danh sách công cụ được nạp vào mọi phiên trước khi bạn gõ bất cứ thứ gì, còn các kỹ năng không tốn gì cho đến khi một lệnh chạy.

Sau đó kết nối chính Bluesky, một lần, trong Settings → Connectors của Hermoso, với handle và một mật khẩu ứng dụng Bluesky. Không có màn hình đồng ý: mật khẩu ứng dụng được tạo trong phần cài đặt của chính Bluesky, và có thể thu hồi ở đó mà không ảnh hưởng đến mật khẩu thật của bạn.

Các công cụ Bluesky mà Claude Code có

• post_to_bluesky: đăng bài như tài khoản đã kết nối: tối đa 300 ký tự, tối đa bốn ảnh kèm alt text, hoặc một video MP4 với các track phụ đề tùy chọn. Một liên kết không kèm media sẽ có thẻ xem trước, do Hermoso dựng vì Bluesky không tự lấy.
• schedule_post: xếp lịch trên lịch chung mà mọi kênh khác dùng, với giới hạn 300 ký tự được kiểm tra khi xếp hàng chứ không phải khi kích hoạt.
• list_bluesky_posts: các bài gần đây của chính tài khoản, kèm AT-URI và số liệu trực tiếp, đánh dấu các bài đăng lại để một bài của người khác không bao giờ bị đọc nhầm là của bạn.
• bluesky_post_metrics / bluesky_account: lượt thích, lượt đăng lại, trả lời, trích dẫn và lượt lưu theo từng bài, cùng số người theo dõi, đang theo dõi và số bài cho tài khoản của bạn hoặc bất kỳ tài khoản công khai nào.
• list_bluesky_convos / read_bluesky_dm / send_bluesky_dm: đọc và trả lời tin nhắn trực tiếp, kể cả yêu cầu nhắn tin từ những người tài khoản không theo dõi.
• manage_bluesky_convo / react_to_bluesky_dm / mark_bluesky_convo_read: chấp nhận yêu cầu, tắt tiếng, khóa hoặc rời một cuộc trò chuyện, phản ứng bằng một emoji, và xóa số chưa đọc.
• delete_bluesky_post: xóa một bài, sau một lệnh gọi đầu tiên không xóa gì và đọc lại những gì sẽ bị xóa.

Bluesky kết nối bằng mật khẩu ứng dụng thay vì màn hình đăng nhập: tạo một cái trong phần cài đặt của Bluesky và dán cùng handle tại Workspace → Connectors. Chọn quyền truy cập tin nhắn trực tiếp khi tạo nó, nếu không các công cụ DM sẽ báo rằng mật khẩu không thể chat, đó là thuộc tính của mật khẩu chứ không phải kết nối bị hỏng. Hai quy tắc Bluesky nữa mà Hermoso kiểm tra trước khi gửi: video cần một email đã xác nhận trên tài khoản Bluesky, và một thẻ liên kết cùng một ảnh không thể chung một bài. Đăng bài không tốn credit, vì Bluesky không tính phí theo mỗi lệnh gọi.

Các giới hạn của Bluesky cần biết trước khi bạn tự động hóa bất cứ thứ gì

Thử trong Claude Code

Hãy yêu cầu bằng ngôn ngữ thông thường. Đây là những câu thông thường, không phải DSL:

“Đăng ghi chú phát hành trong ./notes/bluesky.txt lên Bluesky cùng hai ảnh chụp màn hình trong ./assets dưới dạng ảnh kèm alt text, và nối AT-URI của bài vào ./out/posts.log.”

Chuỗi này đi qua get_brand → generate_image → post_to_bluesky → bluesky_post_metrics. Claude Code hỏi trước khi chạy một công cụ, và bản ghi nằm ngay trong terminal, nên một bước đăng là một dòng bạn có thể đọc trước khi nhấn y.

Claude Code trên Bluesky: phần gây khó khăn

Hãy giữ AT-URI. bluesky_post_metrics và delete_bluesky_post đều định vị một bài bằng URI at://, không phải liên kết bsky.app, và một script chỉ giữ URL web phải quay lại list_bluesky_posts để tìm nó. Các con số bạn đọc sau đó chỉ là số đếm: lượt thích, lượt đăng lại, trả lời, trích dẫn và lượt lưu. Bluesky không công bố lượt hiển thị ở bất kỳ đâu trong giao thức của nó, nên không có tỷ lệ tương tác nào để tính, và một báo cáo hiển thị một con số như vậy là đã bịa ra nó.

Plugin không mang manifest công cụ nào, điều này quan trọng nhất trong một lần chạy dài không có người giám sát: agent gọi lệnh hermoso cho mỗi bước, và --json trên bất kỳ lệnh nào cho nó đầu ra máy để kiểm tra.

Nghiên cứu Bluesky trước khi đăng

Không có thư viện quảng cáo Bluesky và cũng không có tìm kiếm Bluesky trong Hermoso, nên nghiên cứu đối thủ ở đó chỉ còn một điều trung thực: bluesky_account đọc số người theo dõi, số đang theo dõi và số bài của bất kỳ tài khoản công khai nào, đủ để đo quy mô đối thủ và theo dõi theo tuần. Mọi thứ khác trong bề mặt nghiên cứu (các thư viện quảng cáo Meta, Google và LinkedIn, TikTok tự nhiên, Instagram, YouTube, Reddit và Threads) không bị ảnh hưởng.

Phần trả phí

Không có sản phẩm quảng cáo Bluesky trong Hermoso, và chúng tôi không ngụ ý có. Bluesky ở đây là kênh tự nhiên: đăng, lên lịch, đọc, trả lời và đo lường. Các công cụ trả phí bao phủ Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads và AppLovin Ads.

Những gì Claude Code không tự làm được

Một agent có ngân sách chỉ hữu ích khi bán kính ảnh hưởng được giới hạn, nên hàng rào nằm trong máy chủ chứ không nằm trong prompt. Mọi chiến dịch, ad set, ad group và quảng cáo đều được tạo ở trạng thái tạm dừng, và các lệnh đổi trạng thái khiến tiền thật chạy sẽ từ chối nếu không có cờ xác nhận rõ ràng. Mọi bản render đều được báo giá trước (hermoso_capabilities công bố chi phí credit chính xác của từng mô hình trước khi có bất kỳ khoản nào được chi). Credit được giữ trước lệnh gọi nhà cung cấp đầu tiên và quyết toán theo chi phí chính xác sau đó, nên một lần gửi thất bại sẽ được hoàn lại thay vì để bạn bị tính phí cho không có gì. Thao tác xóa cũng cần xác nhận, và mọi cây chiến dịch đều được đọc lại từ nền tảng quảng cáo trước khi agent của bạn cho bạn biết nó đã dựng gì.

Một bước hoàn toàn thuộc về bạn: tạo mật khẩu ứng dụng Bluesky và kết nối nó một lần. Mọi thứ sau đó là lệnh gọi công cụ.

Phần còn lại của ma trận

Từ Claude Code, đăng lên: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Telegram. Hoặc xem mọi thứ Claude Code có thể đăng.

Đăng lên Bluesky từ: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code marketing

Câu hỏi thường gặp

Claude Code có thể đăng lên Bluesky không?

Có, với plugin Claude Code của Hermoso. Một lệnh: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, hoặc trong một phiên, /plugin marketplace add hermoso-ai/hermoso rồi /plugin install hermoso@hermoso. Nó cài năm kỹ năng Hermoso điều khiển CLI hermoso, nên không có danh sách công cụ nào được nạp vào phiên của bạn. Đăng nhập một lần bằng npx -y hermoso auth login, lệnh này mở trình duyệt và tự lưu thông tin xác thực, nên không có khóa nào cần tạo và không có khóa nào cần dán. Khi đó Claude Code có hơn 1.000 công cụ, bao gồm những công cụ đăng lên Bluesky, cùng những công cụ nghiên cứu quảng cáo đang chạy trong thị trường của bạn và dựng creative ngay từ đầu.

Làm sao để kết nối Bluesky với Claude Code?

Hai bước, mỗi bước làm một lần. Một lệnh: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, hoặc trong một phiên, /plugin marketplace add hermoso-ai/hermoso rồi /plugin install hermoso@hermoso. Nó cài năm kỹ năng Hermoso điều khiển CLI hermoso, nên không có danh sách công cụ nào được nạp vào phiên của bạn. Đăng nhập một lần bằng npx -y hermoso auth login, lệnh này mở trình duyệt và tự lưu thông tin xác thực, nên không có khóa nào cần tạo và không có khóa nào cần dán. Sau đó tạo mật khẩu ứng dụng trong phần cài đặt của Bluesky (chọn quyền truy cập tin nhắn trực tiếp nếu bạn muốn các công cụ DM) và dán cùng handle tại Workspace → Connectors trong Hermoso. Sau đó Claude Code đăng lên Bluesky như một lệnh gọi công cụ thông thường.

Claude Code có thể đăng riêng tư hoặc dưới dạng bản nháp lên Bluesky không?

Không. Một bài Bluesky là một bản ghi công khai trên AT Protocol, không có dạng không công khai, riêng tư hay bản nháp, nên việc duyệt phải diễn ra trước lệnh gọi. Hermoso từ chối một quyền hiển thị mà Bluesky không thể đáp ứng ngay tại thời điểm bạn yêu cầu, thay vì âm thầm đăng một thứ kém hơn.

Đăng lên Bluesky từ Claude Code tốn bao nhiêu?

Đăng lên Bluesky không tốn credit; Bluesky không tính phí theo mỗi lệnh gọi. Credit được dùng để tạo creative. Các gói có giá $29, $69 và $149 mỗi tháng cho 1,300, 3,100 và 6,750 credit, và mọi tính năng đều có trong mọi gói kể cả Free. Ngoại lệ duy nhất là SSO doanh nghiệp.

Giới hạn caption khi đăng Bluesky từ Claude Code là bao nhiêu?

Bài Bluesky tối đa 300 ký tự và 3,000 byte, nên một bài nhiều emoji có thể dưới 300 ký tự nhưng vẫn bị từ chối; Hermoso cho biết giới hạn nào được áp dụng và vượt bao nhiêu. Hermoso kiểm tra khi bài được tạo hoặc xếp hàng, nên Claude Code được báo ngay thay vì thất bại sau đó khi không ai theo dõi.

Claude Code có thể lên lịch bài Bluesky để đăng sau không?

Có. schedule_post xếp bài vào một lịch chung với mọi kênh khác, kèm caption riêng cho từng kênh nếu nội dung cần khác. list_scheduled và cancel_scheduled đọc và rút lại bài đó. Bluesky là một trong mười một kênh có thể xếp hàng.