Cách kết nối Instagram với Gemini CLI

Từ Gemini CLI, Instagram là một bản dựng và một chú thích được kiểm tra trước lệnh gọi, vì chú thích là thứ bạn không thể thay đổi sau đó.

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. Gemini CLI 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: Gemini CLI thực sự làm được gì trên Instagram, và Instagram không cho phép Gemini CLI làm gì.

Kết nối Hermoso với Gemini CLI

  1. Cài tiện ích.
    gemini extensions install https://github.com/hermoso-ai/hermoso
    Lệnh này cài bản phát hành mới nhất của kho mã công khai của Hermoso: năm kỹ năng (research, ad-from-brand, generate, product-photoshoot và marketing) cùng một tệp ngữ cảnh GEMINI.md. Các kỹ năng chạy lệnh hermoso qua npx, nên không có gì được thêm vào danh sách công cụ của Gemini CLI và không tốn ngữ cảnh cho đến khi một lệnh chạy. gemini extensions list hiển thị chúng dưới Agent skills.
  2. Đăng nhập một lần.
    npx -y hermoso auth login
    Lệnh này mở đăng nhập trên trình duyệt và lưu một thông tin xác thực chỉ chủ sở hữu mới đọc được vào ~/.hermoso/config.json. Gemini CLI có thể chạy nó giúp bạn lần đầu nó cần Hermoso. Không có trình duyệt trên máy đó? Tạo khóa tại MCP & CLI → Terminal & API keys và chạy npx -y hermoso auth login --token hmk_….
  3. Tùy chọn: cả máy chủ MCP.
    gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp
    Gemini CLI tìm máy chủ ủy quyền của Hermoso khi kết nối đầu tiên trả về 401 và tự đăng ký, nên không có khóa nào đi vào settings.json; /mcp auth hermoso trong một phiên sẽ chạy đăng nhập. 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 Gemini CLI 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.

Chúng tôi đã chạy cài đặt trên vào ngày 2026-09-23 với Gemini CLI 0.60.0 trong một thư mục home sạch: nó kéo bản phát hành hiện tại của hermoso-ai/hermoso, và gemini extensions list báo cáo năm kỹ năng cùng tệp ngữ cảnh. Tiện ích không mang máy chủ MCP riêng, và điều đó là có chủ ý: một danh sách công cụ được nạp vào mọi phiên, còn kỹ năng không tốn gì cho đến khi chạy. Hermoso không liên kết hay được Google tán thành.

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à Gemini CLI 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 Gemini CLI

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 Instagram 6 slide từ ./assets/slides theo thứ tự tên tệp, cho tôi xem chú thích, và đăng sau khi tôi đồng ý.”

Quy trình gồm search_instagram → plan_ad → render_ad → post_to_meta (target: "instagram"). Gemini CLI hỏi trước khi chạy một lệnh shell, và các kỹ năng hành động qua lệnh hermoso, nên một lần đăng hiện ra như một dòng bạn có thể đọc trước khi nói đồng ý. Với công cụ MCP, nó đề nghị một lần, luôn luôn cho công cụ đó, hoặc luôn luôn cho máy chủ.

Gemini CLI trên Instagram: phần gây khó khăn

Gemini CLI hỏi trước khi chạy một lệnh shell, và các kỹ năng tiếp cận Hermoso qua lệnh hermoso, nên lời nhắc đó là nơi việc duyệt chú thích diễn ra. Meta không cho sửa chú thích Instagram đang hoạt động, chỉ có thể bật hoặc tắt bình luận. Việc xóa được hỗ trợ với manage_meta_post, kể cả toàn bộ album, nhưng không bao giờ là từng thẻ riêng lẻ trong một album.

Hai chi tiết của Gemini CLI quyết định mức độ an toàn của việc này. gemini mcp add ghi vào .gemini/settings.json của dự án trừ khi bạn truyền --scope user, điều này hữu ích khi một repo luôn nên chạy với một thương hiệu. Và đừng bao giờ thêm Hermoso với --trust: nó bỏ qua mọi xác nhận của máy chủ, kể cả những xác nhận trước một lần đăng. Công cụ MCP đến với tên mcp_hermoso_ cộng tên công cụ, và --exclude-tools giữ bất kỳ công cụ nào ngoài hoàn toàn.

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ì Gemini CLI 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ừ Gemini CLI, đăng lên: Facebook · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. Hoặc xem mọi nền tảng Gemini CLI có thể đăng lên.

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

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

Gemini CLI có thể đăng lên Instagram không?

Có, với tiện ích Gemini CLI của Hermoso. Chạy gemini extensions install https://github.com/hermoso-ai/hermoso, lệnh này cài các kỹ năng điều khiển lệnh hermoso, rồi đăng nhập một lần bằng npx -y hermoso auth login. Đăng nhập sẽ mở trình duyệt và tự lưu thông tin xác thực, nên không cần tạo hay dán khóa nào. Nếu bạn cũng muốn công cụ của Hermoso có trong danh sách công cụ của Gemini CLI, chạy gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp để thêm máy chủ được lưu trữ, máy chủ này đăng nhập bằng OAuth. Khi đó Gemini CLI có 1.000+ công cụ, bao gồm các 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 trên thị trường của bạn và dựng creative ngay từ đầu.

Làm sao để kết nối Instagram với Gemini CLI?

Hai bước, mỗi bước chỉ làm một lần. Chạy gemini extensions install https://github.com/hermoso-ai/hermoso, lệnh này cài năm kỹ năng điều khiển lệnh hermoso, rồi đăng nhập một lần bằng npx -y hermoso auth login. Đăng nhập sẽ mở trình duyệt và tự lưu thông tin xác thực, nên không cần tạo hay dán khóa nào. Nếu bạn cũng muốn công cụ của Hermoso có trong danh sách công cụ của Gemini CLI, chạy gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp để thêm máy chủ được lưu trữ, máy chủ này đăng nhập bằng OAuth. Sau đó kết nối Instagram trong Hermoso tại Workspace → Connectors, đó là một màn hình cấp quyền OAuth trên trình duyệt. Sau bước đó, Gemini CLI đăng lên Instagram như một lệnh gọi công cụ thông thường.

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

Không. Content Publishing API của Instagram chỉ đăng hoặc không làm gì cả. Không có bài không công khai, riêng tư hay bản nháp. Một caption đã đăng cũng không thể sửa; trường duy nhất Meta cho phép thay đổi trên bài đang hoạt động là bật hoặc tắt bình luận. Xóa bài được hỗ trợ, và bao gồm bài thường, Story, Reel và toàn bộ album carousel. Hermoso từ chối một quyền hiển thị mà Instagram 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.

Gemini CLI có thể nghiên cứu Instagram trước khi đăng không?

Có. search_meta_ads bao phủ các vị trí hiển thị Instagram trong Meta Ad Library, và search_instagram tìm Reel công khai theo từ khóa.

Giới hạn caption khi đăng Instagram từ Gemini CLI là bao nhiêu?

Caption Instagram tối đa 2,200 ký tự, và giới hạn được thực thi khi bài được xếp hàng chứ không phải khi kích hoạt. Hermoso kiểm tra khi bài được tạo hoặc xếp hàng, nên Gemini CLI được báo ngay thay vì thất bại sau đó khi không ai theo dõi.

Gemini CLI có thể chạy quảng cáo Instagram ngoài việc đăng bài không?

Có, thông qua cây chiến dịch Meta. Các vị trí hiển thị Instagram được chọn bên trong một ad set của Meta. preview_meta_ad dựng quảng cáo thật theo từng vị trí trước khi bạn chi tiêu.

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á