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

Gemini CLI có thể tạo bảng và tạo creative cho Pin hôm nay. Việc tạo Pin là điều Pinterest chặn trên môi trường thực tế đối với các ứng dụng quyền truy cập Trial, và thông báo lỗi nói rõ điều đó.

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 Pinterest, và Pinterest 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 Pinterest, 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ụ Pinterest mà Gemini CLI có

  • list_pinterest_boards: các bảng của tài khoản, kể cả bảng bí mật, kèm id của chúng.
  • create_pinterest_board: tạo một bảng mới.
  • post_to_pinterest: tạo một Pin ảnh hoặc video trên một bảng bạn chỉ định, kèm tiêu đề, mô tả, liên kết đích và alt text.
  • schedule_post: xếp lịch Pin, mang theo boardId.
  • list_pinterest_ads_campaigns / pinterest_ads_report: đọc phía quảng cáo trả phí.

Giới hạn bạn cần biết trước khi lên kế hoạch quy trình Pinterest: ứng dụng này giữ quyền truy cập Trial, và Pinterest từ chối tạo Pin trong production khi ở Trial. Lời của họ, ghi nhận từ Pin thật đầu tiên: “Các ứng dụng có quyền truy cập Trial có thể không tạo Pin trong production.” Bảng và đọc dữ liệu vẫn hoạt động trên Trial (liệt kê bảng, tạo bảng, đọc Pin), và lỗi của Hermoso nêu đúng cấp quyền truy cập thay vì bảo bạn kết nối lại, vì kết nối lại không thể sửa được điều này. Nâng cấp lên quyền truy cập Standard là thứ mở khóa việc tạo Pin, và nó đang chờ duyệt. Cùng cấp quyền đó cũng giới hạn phía quảng cáo trả phí: trên Trial, Pinterest không để lộ tài khoản quảng cáo nào cả.

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

Văn bảnMô tả Pin tối đa 800 ký tự và tiêu đề Pin tối đa 100. 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ịCông khai, và điều khiển nằm ở bảng chứ không phải Pin. Một Pin kế thừa trạng thái công khai hoặc bí mật của bảng của nó, nên “đăng nó ở chỗ riêng tư” được diễn đạt bằng cách chọn một bảng bí mật. Đó là lý do bảng là một đối số bắt buộc chứ không phải mặc định.
Carousel2 đến 5 ảnh, chỉ ảnh. Cả hai giới hạn đều lấy thẳng từ OpenAPI v5 chính thức của Pinterest (minItems: 2, maxItems: 5), đó là nguồn máy đọc được duy nhất mà Pinterest công bố (trang nhà phát triển của họ là một ứng dụng render phía client và không trả về gì khi được tải). Không có nguồn nhiều video, nên một slide video bị từ chối chứ không bị bỏ đi.
Tài khoản nàoboardId, và đây là trường định danh duy nhất bị từ chối khi xếp hàng chứ không phải khi đăng. Bỏ trống thì không có gì được lên lịch, vì “một Pin trên sai bảng là một sai sót công khai, nên chúng tôi không bao giờ tự chọn một bảng cho bạ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:

“Tạo một bảng cho bộ sưu tập mùa thu, dựng sáu ảnh Pin dọc kèm tiêu đề và mô tả, và ghi bộ đó vào ./out/pins.json.”

Quy trình gồm list_pinterest_boards → plan_ad → generate_image → post_to_pinterest. 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 Pinterest: phần gây khó khăn

Hãy chuẩn bị các Pin dưới dạng dữ liệu ngay bây giờ. Bảng liệt kê và tạo được với quyền truy cập Trial; việc tạo Pin bị Pinterest từ chối trên môi trường thực tế, và không lần thử lại nào thay đổi được một cấp độ quyền truy cập. Khi quyền truy cập Standard được cấp, tệp bạn đã chuẩn bị chính là lô. boardId là bắt buộc và bị từ chối khi xếp hàng nếu thiếu, vì một Pin trên sai bảng là một lỗi công khai.

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

Không có thư viện quảng cáo Pinterest, nên Hermoso không đưa ra tuyên bố nghiên cứu đối thủ trên Pinterest. Creative bạn sẽ chạy ở đó được các phần còn lại của studio bao phủ tốt: make_template_ad và các mô hình hình ảnh tạo ra những bức tĩnh dọc, nhiều chữ mà bề mặt này thưởng cho.

Phần trả phí

Có các công cụ Pinterest Ads cho chiến dịch, ad group và quảng cáo quảng bá một Pin hiện có, với việc lưu trữ thay vì xóa, vì API Ads của Pinterest không có động từ xóa (Pin và bảng tự nhiên thì xóa được, qua delete_pinterest_pin và delete_pinterest_board; chính các đối tượng trả phí mới chỉ có thể lưu trữ). Nhưng cùng cấp Trial chặn việc tạo Pin cũng không để lộ tài khoản quảng cáo nào, nên việc ghi quảng cáo chưa dùng được cho đến khi quyền truy cập Standard về. Đó là trạng thái trung thực, và nói rõ ở đây vẫn tốt hơn là phát hiện ra khi đã đến hạn chót.

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

Đăng lên Pinterest 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 Pinterest 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 Pinterest, 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 Pinterest 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 Pinterest 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 Pinterest như một lệnh gọi công cụ thông thường.

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

Mô tả Pin tối đa 800 ký tự và tiêu đề Pin tối đa 100. 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ể nghiên cứu Pinterest trước khi đăng không?

Không có thư viện quảng cáo Pinterest, và Hermoso không tuyên bố nghiên cứu đối thủ ở đó. Phần còn lại của bề mặt nghiên cứu không bị ảnh hưởng: các thư viện quảng cáo Meta, Google và LinkedIn cùng TikTok tự nhiên, Instagram, YouTube, Reddit và Threads.

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

Quyền hiển thị trên Pinterest nằm ở bảng chứ không phải Pin: một Pin kế thừa trạng thái công khai hoặc bí mật của bảng, đó là lý do bảng là một đối số bắt buộc chứ không phải mặc định. Hermoso từ chối một quyền hiển thị mà Pinterest 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ể chạy quảng cáo Pinterest ngoài việc đăng bài không?

Các công cụ Pinterest Ads tồn tại (chiến dịch, ad group, và một quảng cáo quảng bá một Pin), nhưng cùng cấp Trial chặn việc tạo Pin cũng không để lộ tài khoản quảng cáo nào, nên việc ghi quảng cáo chưa dùng được cho đến khi quyền truy cập Standard về.

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á