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

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 X, và X 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 X, 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 đó là lệnh gọi công cụ.

Các công cụ X mà Gemini CLI có

• post_to_x: đăng văn bản, một hình ảnh hoặc video kèm alt text, cả một thread, một trả lời, một bài trích dẫn hoặc một khảo sát, và có thể giới hạn ai được phép trả lời.
• post_x_article: đăng một Article dài. Viết bằng Markdown và các tiêu đề, danh sách, trích dẫn, liên kết, khối mã và bảng sẽ được giữ nguyên.
• edit_x_post: viết lại một bài bạn đã đăng, trong khoảng một giờ mà X cho phép.
• schedule_post: xếp bài vào lịch chung.
• x_post_metrics: các số liệu công khai trên một bài.
• x_post_insights: số liệu ngang tầm nhà quảng cáo, chỉ cho 28 giờ gần nhất: lượt hiển thị, lượt nhấp liên kết, lượt xem hồ sơ, lượt xem video và các phân vị hoàn thành.
• x_post_insights_historical: cùng các số liệu đó cho bất kỳ khoảng ngày nào, tối đa 25 bài mỗi lần. Đây là công cụ cho câu hỏi “tháng trước thế nào”.
• x_mentions: ai đang nói về thương hiệu.
• delete_x_post: xóa một bài.

X là connector duy nhất tốn tiền theo mỗi lệnh gọi, và các con số được công bố chứ không bị che giấu. Meta, TikTok, LinkedIn, YouTube, Threads và Drive không tốn phí theo mỗi yêu cầu; X tính phí chúng tôi, nên các lệnh gọi đó bị tính một lượng nhỏ credit mỗi lần. Một bài thường được tính $0.015 mỗi yêu cầu, còn một bài có chứa liên kết là $0.200, đắt hơn khoảng 13 lần. Xóa, đọc và ghi metadata alt text mỗi thao tác có giá riêng, còn insight tính phí theo số bài được trả về. Việc phát hiện liên kết cố ý nghiêng về giả định là có liên kết, vì đoán sai theo chiều kia khiến chúng tôi tốn gấp 13 lần. Hệ quả thực tế: trên X, một bài tốt đánh bại năm bài, và agent của bạn được báo giá trước khi đăng. Độ dài là của tài khoản đăng bài, không phải cố định 280. Hermoso đọc gói đăng ký X của chính tài khoản và cho phép tối đa 25,000 ký tự khi Premium cho phép, nên một bài dài được đăng nguyên vẹn thay vì bị từ chối, và không có gì bị cắt. Đó cũng tình cờ là hình dạng rẻ nhất: một bài dài là một lệnh gọi X được tính phí, còn cùng những chữ đó chia thành năm bài là năm lệnh gọi. X Premium cũng mở khóa hai thứ Hermoso đăng hộ bạn: một Article dài, viết bằng Markdown với tiêu đề, danh sách, trích dẫn, khối mã và bảng còn nguyên vẹn, và một lần sửa bài đã đăng, trong khoảng một giờ mà X cho phép.

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

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:

“Biến ./notes/launch.md thành một bài X, hoặc một chuỗi ngắn nếu không vừa, với liên kết chỉ trong bài cuối cùng, và báo cho tôi chi phí trước.”

Quy trình gồm get_brand → generate_text → post_to_x → x_post_insights_historical. 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 X: phần gây khó khăn

Nếu bạn thêm máy chủ MCP của Hermoso vào Gemini CLI, đừng bao giờ thêm nó với --trust khi nó sẽ đăng lên X. Cờ đó bỏ qua mọi xác nhận của máy chủ, và trên X mỗi bài đăng, lần đọc và lần xóa đều là một lệnh gọi được tính phí, với một bài có liên kết có giá khoảng 13 lần một bài thường. Với tài khoản Premium, một bài dài là một lệnh gọi được tính phí, còn một chuỗi năm phần là năm.

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

Không có thư viện quảng cáo X để tìm kiếm, vì X không công bố thư viện nào. Nghiên cứu X ở đây là về chính tài khoản của bạn: lượt nhắc đến, số liệu bài đăng và các con số lịch sử dành cho nhà quảng cáo. Mọi thứ khác trong bề mặt nghiên cứu không bị ảnh hưởng: thư viện quảng cáo Meta, Google và LinkedIn, cùng TikTok, Instagram, YouTube, Reddit và Threads tự nhiên.

Phần trả phí

X Ads đã ra mắt vào tháng 8 năm 2026, nên X giờ có cả hai nửa. API X Ads là một sản phẩm riêng, trên một host riêng với chữ ký OAuth 1.0a riêng, đó là lý do nó đến sau các phần còn lại. Hermoso giờ xây dựng toàn bộ cây bài quảng cáo được tăng cường trên nó: chiến dịch, line item (tên của X cho một ad group), promoted tweet, nhắm mục tiêu, ngân sách, trạng thái và báo cáo. Một quảng cáo X quảng bá một bài đăng, nên creative chính là một bài, cùng bài mà Hermoso đăng tự nhiên. Công tắc khiến tiền thật chạy sẽ từ chối nếu không có xác nhận rõ ràng, giống hệt trên mười một nền tảng còn lại. Một điều cần biết trước khi lên ngân sách: X cấp quyền truy cập Ads API theo từng tài khoản quảng cáo chứ không theo ứng dụng, nên không có nút OAuth cho nó: bạn thêm người dùng X của Hermoso vào tài khoản quảng cáo của mình tại business.x.com → Account access, và nó xuất hiện trong list_x_ads_accounts với quyền hạn mà X đã cấp.

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

Đăng lên X 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 X 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 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. Khi đó Gemini CLI có 1.000+ công cụ, bao gồm các công cụ đăng lên X, 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 X 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 X 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 X 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 X không?

Không. Một bài trên X là công khai ngay khi nó tồn tại; API không có bản nháp và không có bài không công khai. Hermoso từ chối một quyền hiển thị mà X 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 X trước khi đăng không?

Không qua thư viện quảng cáo, vì X không công bố thư viện nào. Những gì Hermoso đọc trên X là tài khoản của chính bạn: số liệu bài đăng, insight dành cho nhà quảng cáo trong bất kỳ khoảng ngày nào, và lượt nhắc đến thương hiệu.

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

Điều đó tùy vào tài khoản, và Hermoso kiểm tra thay vì đoán. Một tài khoản X thông thường bị giới hạn 280 ký tự; tài khoản có X Premium lên đến 25,000. Hermoso đọc gói đăng ký từ X và gửi bài, nên một bài dài được đăng nguyên vẹn, và không có gì bị cắt. Trên tài khoản Premium, một bài dài thường đọc hay hơn một thread và rẻ hơn, vì đó là một lệnh gọi X được tính phí duy nhất, trong khi năm phần là năm lệnh gọi. Premium cũng mở khóa các Article dài viết bằng Markdown, và việc sửa một bài đã đăng trong khoảng một giờ mà X cho phép. 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 X ngoài việc đăng bài không?

Có, từ tháng 8 năm 2026. X Ads chạy trên một host riêng với chữ ký OAuth 1.0a riêng, và Hermoso xây dựng toàn bộ cây trên đó: chiến dịch, line item, promoted tweet, nhắm mục tiêu, ngân sách, trạng thái và báo cáo. X cấp quyền truy cập Ads API theo từng tài khoản quảng cáo chứ không theo ứng dụng, nên không có nút OAuth cho nó: bạn thêm người dùng X của Hermoso vào tài khoản quảng cáo tại business.x.com → Account access.