Cara menghubungkan X ke Claude Code

Hermoso adalah server MCP pemasaran: 1.000+ tool lewat satu endpoint ber-OAuth yang memungkinkan agen meneliti iklan yang sudah tayang di sebuah pasar, membuat iklan gambar dan video, memublikasikannya, dan membangun kampanye berbayar di baliknya. Claude Code menjangkau semuanya lewat satu koneksi. Halaman ini membahas satu bagiannya: apa yang bisa dilakukan Claude Code di X, dan apa yang tidak diizinkan X.

Hubungkan Hermoso ke Claude Code

1. Satu perintah, dan tanpa kunci.

   claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

   Sudah di dalam sesi? Ketik /plugin marketplace add hermoso-ai/hermoso, lalu /plugin install hermoso@hermoso. Ia memasang lima skill Hermoso (research, ad-from-brand, generate, product-photoshoot dan marketing) yang menjalankan perintah hermoso lewat npx, jadi tidak ada daftar tool yang dimuat ke sesi kamu dan tidak ada yang memakan konteks sampai ia dijalankan.
2. Masuk sekali.

   npx -y hermoso auth login

   Ini membuka sign-in browser di loopback, seperti yang dilakukan gh, dan menyimpan kredensial khusus pemilik di ~/.hermoso/config.json. Claude Code menjalankannya untuk kamu pertama kali ia membutuhkan Hermoso. Tidak ada browser di mesin itu, misalnya CI, server jarak jauh, atau container? Buat kunci di MCP & CLI → Terminal & API keys dan jalankan npx -y hermoso auth login --token hmk_…. Kunci membawa kewenangan belanja yang sungguhan, jadi perlakukan seperti password.
3. Opsional: server MCP juga. Jika kamu juga ingin tool Hermoso ada di daftar tool Claude Code sendiri, jalankan claude mcp add hermoso -- npx -y hermoso mcp setelah masuk. Ia membaca kredensial tersimpan yang sama, jadi tidak ada kunci yang masuk ke .claude.json. Skill menjangkau setiap tool tanpanya.
4. Minta sesuatu ke Claude Code. “Tarik iklan terlama dari tiga pesaing terdekat saya, lalu remix hook terbaiknya jadi video 9:16,” atau “posting render ini ke channel.” Agen memilih tool-nya; kamu yang menyetujui pengeluarannya.

Plugin dan server MCP opsional menjangkau tool dan akun yang sama. Bedanya ada pada konteks: daftar tool dimuat ke setiap sesi sebelum kamu mengetik apa pun, sedangkan skill tidak memakan apa pun sampai sebuah perintah dijalankan.

Lalu hubungkan X itu sendiri, sekali, di Settings → Connectors di Hermoso. Itu layar persetujuan OAuth, jadi inilah satu-satunya langkah yang butuh browser. Semua yang setelahnya adalah tool call.

Tool X yang didapat Claude Code

• post_to_x: memposting teks, gambar atau video dengan teks alternatif, seluruh thread, balasan, quote post, atau poll, dan bisa membatasi siapa yang boleh membalas.
• post_x_article: memublikasikan Article panjang. Tulis dalam Markdown dan heading, daftar, kutipan, tautan, blok kode, dan tabel ikut terbawa.
• edit_x_post: menulis ulang posting yang sudah kamu publikasikan, dalam satu jam yang diizinkan X.
• schedule_post: memasukkannya ke antrean di kalender bersama.
• x_post_metrics: hitungan publik pada sebuah posting.
• x_post_insights: angka setara pengiklan hanya untuk 28 jam terakhir: impresi, klik tautan, kunjungan profil, views video, dan kuartil penyelesaian.
• x_post_insights_historical: angka yang sama untuk rentang tanggal apa pun, hingga 25 posting sekaligus. Ini yang dipakai untuk “bagaimana bulan lalu”.
• x_mentions: siapa yang sedang membicarakan brand.
• delete_x_post: menghapus posting.

X adalah satu-satunya connector yang memungut biaya uang per panggilan, dan angkanya dipublikasikan, bukan disembunyikan. Meta, TikTok, LinkedIn, YouTube, Threads, dan Drive tidak memungut biaya per permintaan; X memungut biaya dari kami, jadi panggilan itu menagih sejumlah kecil kredit setiap kali. Posting biasa dihargai $0.015 per permintaan dan posting yang berisi tautan $0.200, kira-kira 13× lebih mahal. Penghapusan, pembacaan, dan penulisan metadata teks alternatif masing-masing punya harga sendiri, dan insight ditagih per posting yang dikembalikan. Deteksi tautan sengaja condong ke asumsi bahwa tautan ada, karena menebak salah ke arah sebaliknya membuat kami terkena 13×. Konsekuensi praktisnya: di X, satu posting bagus mengalahkan lima, dan agen kamu dikutip harganya sebelum memposting. Panjang ditentukan oleh akun pemosting, bukan flat 280. Hermoso membaca langganan X milik akun itu sendiri dan mengirim hingga 25,000 karakter jika Premium mengizinkannya, jadi posting panjang keluar utuh alih-alih kembali sebagai penolakan, dan tidak ada yang pernah dipotong. Itu kebetulan juga bentuk yang murah: satu posting panjang adalah satu panggilan X yang ditagih, sedangkan kata-kata yang sama dipecah menjadi lima posting adalah lima panggilan. X Premium juga membuka dua hal yang Hermoso publikasikan untuk kamu: sebuah Article panjang, ditulis dalam Markdown dengan heading, daftar, kutipan, blok kode, dan tabelnya utuh, serta sebuah edit pada posting yang sudah kamu publikasikan, dalam satu jam yang diizinkan X.

Batas X yang perlu kamu tahu sebelum mengotomatisasi apa pun

Coba di Claude Code

Mintalah dengan bahasa sehari-hari. Ini kalimat biasa, bukan DSL:

“Ubah ./notes/launch.md menjadi utas X berisi maksimal lima postingan, simpan tautan hanya di postingan terakhir, dan beri tahu aku biayanya sebelum memposting.”

Itu menjalankan get_brand → generate_text → post_to_x → x_post_insights_historical. Claude Code meminta izin sebelum menjalankan alat, dan transkripnya langsung terlihat di terminal, jadi setiap langkah publikasi bisa kamu baca sebelum menekan y.

Claude Code di X: bagian yang sering bikin repot

Letakkan tautan di satu postingan, bukan lima. Postingan yang memuat tautan dihargai sekitar 13× lipat dari postingan biasa, sehingga utas di mana setiap postingan memuat tautan adalah bentuk yang mahal, dan deteksi tautan memang sengaja cenderung menganggap tautan ada. Salinan yang melebihi batas ditolak, bukan dipotong, dan kelebihannya dihitung. Dalam skrip, itu berarti kegagalan bersih yang bisa kamu tangani, bukan postingan yang terkirim setengah jadi.

Plugin tidak membawa manifest tool, yang paling penting pada eksekusi tanpa pengawasan yang panjang: agen memanggil perintah hermoso untuk setiap langkah, dan --json pada perintah apa pun memberinya keluaran mesin untuk diperiksa.

Riset X sebelum kamu posting

Tidak ada pustaka iklan X untuk dicari. Riset X di sini adalah akun kamu sendiri: mention, metrik posting, dan angka historis pengiklan. Bagian riset lainnya tidak terpengaruh: pustaka iklan Meta, Google, dan LinkedIn, serta TikTok, Instagram, YouTube, Reddit, dan Threads yang organik.

Bagian berbayar

X Ads mendarat pada Agustus 2026, jadi X kini menjadi kedua bagiannya. X Ads API adalah produk terpisah dengan host sendiri dan penandatanganan OAuth 1.0a sendiri, itulah sebabnya ia datang setelah yang lain. Hermoso sekarang membangun seluruh pohon promoted-post di atasnya: kampanye, line item (nama X untuk ad group), promoted tweet, targeting, anggaran, status, dan pelaporan. Iklan X mempromosikan sebuah posting, jadi kreatifnya adalah posting, yang sama dengan yang Hermoso publikasikan secara organik. Switch yang mengaktifkan uang sungguhan menolak berjalan tanpa konfirmasi yang eksplisit, persis seperti di sebelas platform lainnya. Satu hal yang perlu diketahui sebelum merencanakan anggaran: X memberikan akses Ads API per akun iklan, bukan per aplikasi, jadi tidak ada tombol OAuth untuk itu: kamu menambahkan pengguna X Hermoso ke akun iklan kamu di business.x.com → Account access, dan ia muncul di list_x_ads_accounts dengan tingkat izin yang diberikan X.

Yang tidak bisa dilakukan Claude Code sendiri

Agen yang punya anggaran hanya berguna jika dampaknya terbatas, jadi pagarnya ada di server, bukan di prompt. Setiap kampanye iklan, ad set, ad group, dan iklan dibuat paused, dan switch status yang mengaktifkan uang sungguhan menolak berjalan tanpa flag konfirmasi yang eksplisit. Setiap render dikutip harganya lebih dulu (hermoso_capabilities mempublikasikan biaya kredit pasti setiap model sebelum apa pun dibelanjakan). Kredit dicadangkan sebelum panggilan provider pertama dan diselesaikan sesuai biaya pasti setelahnya, jadi dispatch yang gagal dikembalikan alih-alih membuat kamu ditagih untuk tidak ada apa-apa. Penghapusan juga dikunci konfirmasi, dan setiap pohon kampanye dibaca ulang dari platform iklan sebelum agen kamu memberi tahu apa yang sudah dibangun.

Satu langkah sengaja tidak bisa dilakukan tanpa kamu: menautkan akun adalah layar persetujuan OAuth, jadi kamu menghubungkan channel sekali di browser. Semua setelah itu adalah tool call.

Sisa matriksnya

Dari Claude Code, posting ke: Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram. Atau lihat semua yang bisa dipublikasikan Claude Code.

Posting ke X dari: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code marketing

Pertanyaan yang sering diajukan

Bisakah Claude Code memposting ke X?

Bisa, dengan plugin Claude Code dari Hermoso. Satu perintah: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, atau di dalam sesi /plugin marketplace add hermoso-ai/hermoso lalu /plugin install hermoso@hermoso. Plugin ini memasang lima skill Hermoso yang menjalankan CLI hermoso, sehingga tidak ada daftar alat yang dimuat ke sesimu. Masuk sekali dengan npx -y hermoso auth login, yang membuka browser dan menyimpan kredensialnya sendiri, jadi tidak ada kunci yang perlu dibuat atau ditempel. Claude Code kemudian punya 1.000+ alat, termasuk yang memposting ke X, serta yang meneliti iklan yang sedang berjalan di pasarmu dan merender kreatifnya sejak awal.

Bagaimana cara menghubungkan X ke Claude Code?

Dua langkah, masing-masing sekali. Satu perintah: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, atau di dalam sesi /plugin marketplace add hermoso-ai/hermoso lalu /plugin install hermoso@hermoso. Masuk sekali dengan npx -y hermoso auth login, yang membuka browser dan menyimpan kredensialnya sendiri, jadi tidak ada kunci yang perlu dibuat atau ditempel. Lalu hubungkan X di dalam Hermoso lewat Workspace → Connectors, yang berupa layar persetujuan OAuth di browser. Setelah itu Claude Code memposting ke X sebagai panggilan alat biasa.

Apakah Claude Code butuh password X saya?

Tidak. Kamu menghubungkan X ke Hermoso sekali lewat layar persetujuan OAuth di browser, dan Claude Code kemudian menjangkaunya sebagai tool call. Menautkan akun adalah satu-satunya langkah yang tidak bisa dilakukan tanpa kamu; tidak ada yang setelahnya membutuhkan password, dan tidak ada kredensial yang pernah diserahkan ke model.

Bisakah Claude Code menjadwalkan posting X untuk nanti?

Bisa. schedule_post memasukkannya ke satu kalender bersama dengan semua channel lain, dengan caption khusus per channel jika isinya perlu berbeda, dan list_scheduled serta cancel_scheduled membacanya dan menariknya kembali. X adalah salah satu dari sebelas channel yang bisa masuk antrean.

Bisakah Claude Code memposting carousel ke X?

Tidak. API X melampirkan hingga empat media ke satu posting dan semuanya tampil sebagai grid, dengan setiap gambar terlihat sekaligus dan tidak ada yang bisa digeser, jadi deck slide bernomor tidak bisa dipublikasikan di sana seperti yang dimaksud. Claude Code memanggil tool publikasi yang sama dalam kedua kasus, dan channel yang tidak bisa membawa carousel ditolak dengan alasan sebenarnya.

Berapa biaya memposting ke X dari Claude Code?

X adalah satu-satunya connector yang menagih kredit per panggilan, karena X mengenakan biaya per permintaan API: kira-kira $0.015 untuk posting dan $0.200 untuk posting yang berisi tautan, sekitar 13 kali lebih mahal. Agen kamu dikutip harganya sebelum memposting. Paketnya $29, $69, dan $149 per bulan untuk 1,300, 3,100, dan 6,750 kredit, dan setiap fitur tersedia di setiap paket termasuk Free. Satu-satunya pengecualian adalah enterprise SSO.