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

Một lần cài plugin, và Claude Code có thể dựng, viết caption và đăng lên Instagram từ cùng phiên terminal nơi creative được tạo ra.

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 Instagram, và Instagram 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 Instagram, một lần, trong Settings → Connectors của Hermoso. Đây là màn hình đồng ý OAuth, nên là bước duy nhất cần trình duyệt. Mọi thứ sau đó đều là lệnh gọi công cụ.

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

  • post_to_meta: đăng lên Instagram với target: "instagram". Instagram là kênh trực quan và API cũng đồng ý: một bài cần hình ảnh hoặc video.
  • schedule_post: xếp bài vào lịch chung, kèm caption riêng cho từng kênh nếu nội dung cần khác với phiên bản Facebook hoặc LinkedIn của bạn.
  • list_meta_comments / reply_to_meta_comment / moderate_meta_comment: đọc, trả lời và kiểm duyệt bình luận dưới một bài.
  • meta_page_insights / meta_post_insights: lượt tiếp cận, lượt hiển thị, lượt lưu và tương tác, theo từng tài khoản và từng bài.
  • search_instagram: tìm kiếm theo từ khóa trên các Reel Instagram công khai, để nghiên cứu chứ không phải để đăng.

Hai điều về Instagram nên biết trước khi bạn tự động hóa bất cứ thứ gì. Trong API của Meta không có lên lịch Instagram gốc, nên một lịch là hàng đợi của Hermoso chứ không phải của Instagram, và truyền scheduleAt của Facebook cho Instagram sẽ bị từ chối thay vì âm thầm đăng ngay. Và một caption Instagram không thể sửa sau khi bài đã lên: điều duy nhất Meta cho phép thay đổi trên một bài đã đăng là bật hoặc tắt bình luận. Xóa bài thì được hỗ trợ: manage_meta_post xóa bài thường, Story, Reel và toàn bộ album carousel, nhưng không thể xóa riêng một thẻ khỏi album.

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

Văn bảnCaption Instagram tối đa 2,200 ký tự. Giới hạn được kiểm tra khi bài được tạo hoặc xếp hàng, nên bài quá dài sẽ bị từ chối khi bạn vẫn còn đó để sửa, thay vì bị cắt âm thầm trên đường đi.
Quyền hiển thịChỉ công khai. Content Publishing API của Meta chỉ đăng ngay hoặc không đăng gì cả, và Instagram “không có bài không công khai, riêng tư hay bản nháp.” Nếu bạn muốn có bước duyệt trên Instagram, nó phải diễn ra trước lệnh gọi, không phải sau.
Carousel2 đến 10 slide, và có thể trộn ảnh với video. Giới hạn trên là của chính Meta, được trích trong bảng năng lực mà họ thực thi: “Carousel được giới hạn 10 ảnh, video, hoặc hỗn hợp cả hai.” Mức sàn 2 là của chúng tôi, vì một slide không phải là carousel trên bất kỳ nền tảng nào. Yêu cầu một slide sẽ được đăng như một bài thông thường thay vì bị từ chối.
Tài khoản nàopageId. Instagram đăng qua Trang Facebook đã kết nối, nên cùng trường định danh đó chọn nó.

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:

“Dựng carousel 5 slide từ ./assets/slides, kiểm tra mỗi slide có nằm trong giới hạn của Instagram không, đăng nó, và lưu permalink vào ghi chú phát hành.”

Chuỗi này đi qua search_instagram → plan_ad → render_ad → post_to_meta (target: "instagram"). 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 Instagram: phần gây khó khăn

Caption Instagram không thể sửa sau khi bài đã đăng, nên hãy xây dựng việc kiểm tra vào script thay vì phải xin lỗi sau đó: để Claude Code cho bạn xem thứ tự slide và caption, rồi mới gọi công cụ đăng. Nếu một bản render hóa ra sai, manage_meta_post xóa toàn bộ bài, kể cả album. Thứ tự quan trọng hơn người ta nghĩ. Slide 2 phải theo sau slide 1, và Hermoso giữ đúng thứ tự bạn truyền vào.

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 Instagram trước khi đăng

search_meta_ads bao phủ cả vị trí hiển thị Instagram cũng như Facebook, vì đây là một thư viện chung. Với nội dung tự nhiên, search_instagram tìm Reel công khai theo từ khóa, đây là bề mặt mà định dạng thực sự tạo ra tác động; kéo hồ sơ và hashtag đi qua fetch_social_data và search_instagram_hashtag.

Phần trả phí

Vị trí hiển thị Instagram được mua qua cùng cây chiến dịch Meta như Facebook: create_meta_campaign → create_meta_adset → create_meta_ad, với vị trí có thể chọn theo từng nền tảng và từng vị trí. preview_meta_ad hiển thị quảng cáo đã render thật theo từng vị trí trước khi bạn chi tiêu, và meta_insights chia kết quả theo độ tuổi, giới tính, vị trí và quốc gia. Sự phân tích đó là thứ định hình creative tiếp theo.

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 cố ý không thể làm không cần giao diện: liên kết tài khoản là một màn hình đồng ý OAuth, nên bạn kết nối kênh một lần trong trình duyệt. 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 · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Hoặc xem mọi thứ Claude Code có thể đăng.

Đăng lên Instagram 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 Instagram 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 Instagram, 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 Instagram 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 đó kết nối Instagram trong Hermoso tại Workspace → Connectors, đây là màn hình đồng ý OAuth trên trình duyệt. Sau đó Claude Code đăng lên Instagram như một lệnh gọi công cụ thông thường.

Claude Code có cần mật khẩu Instagram của tôi không?

Không. Bạn kết nối Instagram với Hermoso một lần qua màn hình đồng ý OAuth trên trình duyệt, và Claude Code sau đó truy cập nó như một lệnh gọi công cụ. Liên kết tài khoản là bước duy nhất không chạy không cần giao diện; mọi thứ sau đó không cần mật khẩu, và không có thông tin xác thực nào được giao cho mô hình.

Claude Code có thể lên lịch bài Instagram để đă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 đó. Instagram là một trong mười một kênh có thể xếp hàng.

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

Có, từ 2 đến 10 slide, và có thể trộn ảnh với video. Mười là giới hạn đã được chính Meta công bố, không phải do Hermoso đặt ra. Claude Code gọi cùng một công cụ đăng trong cả hai trường hợp, và một kênh không thể mang carousel sẽ bị từ chối kèm lý do thực sự.

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

Đăng lên Instagram không tốn credit; Meta không tính phí theo mỗi lệnh gọi API. Credit dành cho chính bản render. 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.

Bắt đầu miễn phí với 30 credit khi đăng ký và kiếm thêm hơn 250 credit. Mọi tính năng đều có trong mọi gói.

Bắt đầu miễn phí →   Xem bảng giá