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

X tính phí theo từng yêu cầu API, nên một vòng lặp không giám sát trên X là nơi duy nhất mà một agent chạy mất kiểm soát thực sự tốn tiền, và đáng mã hóa phụ phí 13× cho liên kết thành một quy tắc.

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

Kết nối Hermoso với Codex

  1. Một lệnh, không cần khóa.
    codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso
    Codex đọc tệp marketplace trong kho mã công khai của Hermoso và cài năm kỹ năng (research, ad-from-brand, generate, product-photoshoot và marketing). Các kỹ năng 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 làm việc của bạn và không tốn ngữ cảnh cho đến khi một lệnh chạy.
  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. Nếu máy đó không có trình duyệt, ví dụ CI hay container thì sao? Tạo khóa tại MCP & CLI → Terminal & API keys và chạy npx -y hermoso auth login --token hmk_…. Khóa mang quyền chi tiêu thực sự, vì vậy hãy coi nó như mật khẩu.
  3. Tùy chọn: cả máy chủ MCP.
    codex mcp add hermoso -- npx -y hermoso mcp
    Lệnh này ghi máy chủ vào ~/.codex/config.toml và đọc cùng thông tin xác thực đã lưu, nên không có khóa nào đi vào tệp. Bạn thích endpoint được lưu trữ hơn? Chạy codex mcp add hermoso --url https://app.hermoso.ai/mcp, rồi codex mcp login hermoso để đăng nhập OAuth. Các kỹ năng tiếp cận mọi công cụ mà không cần cái nào trong số này.
  4. Yêu cầu Codex 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.

Codex giữ các máy chủ MCP trong ~/.codex/config.toml, hoặc .codex/config.toml trong một dự án đáng tin cậy, và tệp đó là TOML chứ không phải JSON: một khối mcpServers chép vào sẽ không nạp được, còn một mục viết tay là [mcp_servers.hermoso] với command = "npx" và args = ["-y", "hermoso", "mcp"]. Chữ mcp ở cuối là bắt buộc: npx -y hermoso không có lệnh con sẽ chỉ in trợ giúp rồi thoát. Codex đọc các marketplace plugin theo cùng bố cục .claude-plugin mà Claude Code dùng, đó là lý do một kho mã cài được trên cả hai.

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à Codex 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ì

Văn bảnĐộ dài là của tài khoản đăng bài: thông thường 280 ký tự, và lên đến 25,000 với X Premium. Hermoso đọc gói đăng ký từ X, nên một bài dài được đăng nguyên vẹn. Không có gì bị cắ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. 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. Có các tài khoản được bảo vệ, nhưng đó là cài đặt cho toàn tài khoản mà Hermoso không đọc cũng không kiểm soát, chứ không phải lựa chọn theo từng bài.
CarouselTừ chối, theo tên, vì một lý do cụ thể. “X không có carousel để vuốt.” API của X đính kèm tối đa 4 phương tiện vào một bài và chúng hiển thị dưới dạng lưới, mọi ảnh đều thấy được cùng lúc và không có gì để vuốt, nên một bộ slide “1/6 · VUỐT” không thể đăng ở đó đúng như thiết kế. Lời từ chối nói phải làm gì thay thế: “Đăng slide mạnh nhất lên X, hoặc bỏ X khỏi bài này.” Một bộ slide yêu cầu người đọc vuốt, nhưng được đăng dưới dạng lưới, còn tệ hơn là không đăng.
Tài khoản nàoKhông có. X đăng lên tài khoản đã kết nối.

Thử trong Codex

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:

“Không tương tác: đăng một cập nhật X cho mỗi bản phát hành, dưới 280 ký tự, với liên kết nằm trong bài đăng duy nhất đó, và ghi lại chi phí đã tính.”

Quy trình gồm get_brand → generate_text → post_to_x → x_post_insights_historical. Khi tương tác, Codex hiển thị lệnh gọi trước khi chạy. Khi không tương tác thì không có ai để hỏi, nên đáng thiết kế cẩn thận ở mọi bước đăng bài hoặc chi tiêu.

Codex trên X: phần gây khó khăn

Hãy lập ngân sách cho việc này một cách có chủ đích. Mỗi bài đăng, lần xóa và lần đọc đều là một yêu cầu được tính phí, số liệu được tính phí theo từng bài trả về, và một bài có liên kết có giá khoảng gấp 13 lần bài thường. Với công việc không giám sát, điều đó nghĩa là: một bài cho mỗi sự kiện thay vì một chuỗi, một liên kết thay vì nhiều liên kết, và giới hạn số lần công việc được chạy. Giới hạn ký tự là một sự từ chối rõ ràng, nên công việc thất bại sẽ thất bại to tiếng thay vì đăng một điều còn dang dở.

Với các lần chạy không có người giám sát, hãy ưu tiên CLI hermoso với --json thay vì toàn bộ danh sách công cụ. Cách này tốn ít ngữ cảnh hơn nhiều và dễ kiểm tra kết quả hơ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ì Codex 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ừ Codex, đăng lên: Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram. Hoặc xem mọi nền tảng Codex có thể đăng lên.

Đăng lên X từ: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Quảng cáo từ dòng lệnh

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

Codex có thể đăng lên X không?

Có, với plugin Codex của Hermoso. Chạy codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, lệnh này cài các kỹ năng của 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. Với máy chủ MCP cũng vậy, chạy codex mcp add hermoso -- npx -y hermoso mcp. Khi đó Codex 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 Codex?

Hai bước, mỗi bước chỉ làm một lần. Chạy codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso, lệnh này cài các kỹ năng của 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. Với máy chủ MCP cũng vậy, chạy codex mcp add hermoso -- npx -y hermoso mcp. 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 đó, Codex đăng lên X như một lệnh gọi công cụ thông thường.

Codex có thể đăng carousel lên X không?

Không. API của X đính kèm tối đa bốn phương tiện vào một bài và chúng hiển thị dưới dạng lưới, mọi ảnh đều thấy được cùng lúc và không có gì để vuốt, nên một bộ slide đánh số không thể đăng ở đó đúng như thiết kế. Codex 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 X từ Codex tốn bao nhiêu?

X là connector duy nhất tính credit theo mỗi lệnh gọi, vì X tính phí theo mỗi yêu cầu API: khoảng $0.015 cho một bài và $0.200 cho một bài có chứa liên kết, đắt hơn khoảng 13 lần. Agent của bạn được báo giá trước khi đăng. 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.

Codex có cần mật khẩu X của tôi không?

Không. Bạn kết nối X với Hermoso một lần qua màn hình đồng ý OAuth trên trình duyệt, và Codex 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.

Codex có thể lên lịch bài X để đă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, và list_scheduled cùng cancel_scheduled đọc và rút lại bài đó. X là một trong mười một kênh có thể xếp hàng.

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á