Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Codex は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Codex が TikTok で実際に何をできて、TikTok が何をさせないかです。
Hermoso を Codex に接続する
- コマンド1つ。キーは不要です。
Codex は Hermoso の公開リポジトリにあるマーケットプレイスのファイルを読み込み、5つのスキルをインストールします(リサーチ、ブランドからの広告作成、生成、商品撮影、マーケティング)。スキルはcodex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermosonpx経由でhermosoコマンドを実行するため、セッションにツール一覧は読み込まれず、コマンドが実行されるまでコンテキストも消費しません。 - 一度サインインします。
ブラウザでサインインすると、所有者のみが読める認証情報がnpx -y hermoso auth login~/.hermoso/config.jsonに保存されます。CI やコンテナなど、ブラウザがないマシンの場合は、MCP & CLI → Terminal & API keys でキーを作成し、npx -y hermoso auth login --token hmk_…を実行してください。キーには実際の支出権限があるため、パスワードと同じように扱ってください。 - 任意: MCP サーバーも追加する場合。
これでサーバーがcodex mcp add hermoso -- npx -y hermoso mcp~/.codex/config.tomlに書き込まれ、同じ保存済み認証情報を読み込みます。そのためファイルにキーは書かれません。ホストされたエンドポイントを使いたい場合は、codex mcp add hermoso --url https://app.hermoso.ai/mcpを実行し、codex mcp login hermosoで OAuth サインインを行います。スキルは、どちらを使わなくてもすべてのツールに届きます。 - Codex に何かを頼みます。「競合上位3社の、最も長く配信されている広告を取得して、一番良いフックを9:16の動画にリミックスして」、または「このレンダリングをチャンネルに投稿して」。エージェントがツールを選び、支出はあなたが承認します。
Codex は MCP サーバーを ~/.codex/config.toml に保存します。信頼されたプロジェクトでは .codex/config.toml に保存されます。このファイルは JSON ではなく TOML 形式なので、mcpServers のブロックをコピーしても読み込まれません。手書きする場合は [mcp_servers.hermoso] として、command = "npx" と args = ["-y", "hermoso", "mcp"] を指定します。末尾の mcp は必須です。npx -y hermoso だけではヘルプを表示して終了します。Codex は Claude Code と同じ .claude-plugin の形式でプラグインのマーケットプレイスを読み込むため、同じリポジトリで両方にインストールできます。
その後、Hermoso の 設定 → コネクタ で TikTok 自体を一度接続してください。これはブラウザでの OAuth 同意画面なので、唯一ブラウザが必要な手順です。そのあとはすべてツール呼び出しです。
Codex が使える TikTok のツール
post_to_tiktok：完成した動画、または最大35枚の画像の写真投稿を、選んだプライバシー設定でプロフィールに即時公開するか、アプリで仕上げるために TikTok の下書きに入れます。インタラクション設定（コメント、デュエット、スティッチ）、カバーフレーム、ブランドコンテンツの開示も扱います。schedule_post：共有カレンダーに後の時刻でキューします。プライバシーはキューに入れるときに固定されます。tiktok_account / tiktok_creator_info：アカウントのプロフィール、認証、フォロワー数と動画数、そしてアカウント自身が許可しているプライバシーのレベル。tiktok_post_status：TikTok がまだ処理中の投稿を追跡するので、アップロードが遅くても、二重投稿ではなく確認されます。list_tiktok_videos / tiktok_account_insights：最近の投稿と再生数、いいね、コメント、シェア、そしてアカウント自身の分析。100人以上のフォロワーがあるビジネスアカウントでは、フォロワーの属性も含みます。list_tiktok_comments / reply_to_tiktok_comment / moderate_tiktok_comment：投稿へのコメントを読み、アカウントとして返信し、いいね、非表示、削除ができます。TikTok アカウントの認可が接続されている必要があります。search_tiktok：公開された TikTok をキーワードで検索します。リサーチ側の半分です。
さらに運用上の事実が二つあります。TikTok の写真投稿は、アップロードではなく URL から取り込まれるので、写真投稿を出す前に、画像を配信するホストを TikTok の開発者ポータルで確認しておく必要があります。また、下書きにはカバーフレームが付きません。直接投稿では Hermoso が動画の最も良いフレームをカバーに設定しますが、下書きの場合はカバーを TikTok アプリで選びます。
自動化の前に知っておくべき TikTok の上限
| テキスト | TikTok の動画のキャプションは2,200文字、写真投稿のキャプションは4,000文字、写真のタイトルは90文字が上限です。投稿の作成またはキューに入れる時点で適用されるので、上限を超えた投稿は、黙って途中で切られるのではなく、あなたがまだそこにいるうちに拒否され、修正できます。 |
|---|---|
| 公開範囲 | 全員、フォロワー、友だち、自分だけ、または下書き。選ぶのはあなたです。Hermoso は2026年に TikTok の Direct Post 監査に合格したので、投稿はプロフィールで公開されます。TikTok のルールでは、投稿ごとに公開範囲を作成者が選び、あらかじめ選択された状態はなく、tiktok_creator_info がアカウントに許可すると示したレベルからのみ選べます。そのため Hermoso は既定値にせず尋ね、何も指定されていない投稿は、アップロード前に拒否します。下書きは TikTok のインボックスに入り、アプリで仕上げられます。TikTok のサウンドを追加するのもそこです。限定公開はありません。ブランドコンテンツを自分だけの投稿と組み合わせることはできず、その組み合わせは、こちらで解決するのではなく、拒否されます。 |
| カルーセル | 写真投稿として最大35枚の画像。画像のみです。その数は TikTok のものです。「最大35件の写真コンテンツの URL を含む配列」。順番がスライドショーなので、スライドの順序が製品そのものです。画像1枚は、拒否ではなく、1枚のスライドの投稿です。 |
| どのアカウントか | なし。TikTok は接続されたアカウントに公開します。 |
Codex で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
「非対話: フックのバリエーションを3つレンダリングし、1つ目は全体に公開して、残り2つは TikTok の下書きに送り、公開 ID を JSON で出力してください。」
これは search_tiktok → plan_ad → render_ad → post_to_tiktok の流れです。対話モードでは、Codex は実行前にその呼び出しを表示します。非対話モードでは確認する相手がいないため、投稿や支出を伴う手順は、その前提で設計する必要があります。
TikTok での Codex：要注意の点
TikTok のルールが最も重要になる組み合わせです。公開範囲は既定値にせず、必ず明示する必要があります。そのため、プロンプトに書いてください。書かれていなければ、アップロードの前にジョブが拒否されます。また、アップロードに時間がかかる場合は、完了ではなく保留中として返ります。実行の中で、公開 ID を使って tiktok_post_status を確認してください。TikTok の処理中にもう一度投稿すると、動画が2回公開されてしまいます。
無人実行では、ツールマニフェスト全体ではなく、--json 付きの hermoso CLI を使うことをおすすめします。コンテキストの消費がはるかに少なく、結果の検証もしやすくなります。
投稿の前に TikTok をリサーチする
Hermoso には、Meta で行っているようなTikTok 広告ライブラリの検索はありません。そのため TikTok のリサーチはオーガニックです。search_tiktok がキーワードで効いているものを見つけ、analyze_video が一本の動画をフック、ビート、画面上の文字に分解するので、パターンを推測ではなく再利用できます。
有料の側
TikTok Ads は、Hermoso がキャンペーンを構築し読み取る十二の有料プラットフォームの一つで、Smart+ キャンペーンや、オーガニックな投稿を宣伝する Spark Ads も含みます。また、オーガニックの接続とは別の接続です。キャンペーンは TikTok の Marketing API で、投稿は TikTok のコンテンツ投稿の承認で動くので、Hermoso は一方が他方を示唆しないように、それぞれを別々に報告します。実際のお金を動かすのは、確認が必要な状態の切り替えだけです。
Codex だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます（hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します）。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
あえて完全なヘッドレスにしていない手順が一つあります。アカウントの接続は OAuth の同意画面なので、ブラウザでチャンネルを一度接続します。そのあとはすべてツール呼び出しです。
その他のマトリクス
Codex からの投稿先: Facebook · Instagram · Threads · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram。または Codex から投稿できるすべての先をご覧ください。
TikTok への投稿元: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · コマンドラインからの広告
よくある質問
Codex から TikTok に投稿できますか？
はい、Hermoso の Codex プラグイン経由で可能です。codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso を実行し、Hermoso のスキルをインストールします。その後、npx -y hermoso auth login で一度サインインしてください。ブラウザが開き、認証情報は自動で保存されるため、キーの作成も貼り付けも不要です。MCP サーバーも使う場合は、codex mcp add hermoso -- npx -y hermoso mcp を実行します。その後、Codex では 922 以上のツールが使えます。TikTok に投稿するツールや、市場で配信中の広告を調べるツール、クリエイティブを作成するツールも含まれます。
TikTok を Codex に接続するには？
手順は2つ、それぞれ一度だけです。codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso を実行し、Hermoso のスキルをインストールします。その後、npx -y hermoso auth login で一度サインインしてください。ブラウザが開き、認証情報は自動で保存されるため、キーの作成も貼り付けも不要です。MCP サーバーも使う場合は、codex mcp add hermoso -- npx -y hermoso mcp を実行します。次に Hermoso の 設定 → コネクタ で TikTok を接続します。ブラウザ上の OAuth 同意画面です。以降、Codex は通常のツール呼び出しとして TikTok に投稿します。
Codex に TikTok のパスワードを渡す必要がありますか？
いいえ。TikTok は、ブラウザでの OAuth 同意画面を通して一度だけ Hermoso に接続します。その後、Codex はツール呼び出しとしてそれを使います。アカウントの接続は唯一ヘッドレスではない手順で、それ以降はパスワードは不要で、認証情報がモデルに渡されることは一切ありません。
Codex から TikTok に投稿するのにコストはかかりますか？
TikTok への投稿にはクレジットがかかりません。TikTok は API 呼び出しごとに料金を取らないためです。クレジットはレンダリングにかかります。プランは月額 $29、$69、$149 で、それぞれ 1,200、3,000、7,000 クレジットです。すべての機能が Free を含むすべてのプランに含まれます。例外はエンタープライズ向けの SSO だけです。
Codex で TikTok にカルーセルを投稿できますか？
はい。TikTok の写真投稿は最大35枚の画像を、渡した順番どおりに受け取り、その順番がスライドショーになります。動画は混在できません。Codex はどちらの場合も同じ公開ツールを呼び出し、カルーセルを載せられないチャンネルは、本当の理由を添えて拒否されます。
Codex で TikTok の投稿を後から予約できますか？
はい。schedule_post は、他のすべてのチャンネルと共有する一つのカレンダーに投稿を入れます。キャプションを変えたい場合は、チャンネルごとに付けられます。list_scheduled と cancel_scheduled で読み取りと取り消しができます。TikTok は、キューに入る十一チャンネルの一つです。