Hermoso はマーケティング用の MCP サーバーです。922+ のツールを一つの OAuth 対応エンドポイントで提供し、エージェントが市場で既に配信されている広告をリサーチし、完成した画像と動画の広告を生成し、それらを投稿し、その背後にある有料キャンペーンを作れるようにします。Cursor は一つの接続からこれらすべてを使えます。このページでは、その中の一部を扱います。Cursor が TikTok で実際に何をできて、TikTok が何をさせないかです。
Hermoso を Cursor に接続する
- インストールとサインイン。
ブラウザが1回開きます。作成も貼り付けも不要です。認証情報は所有者のみが読める形でnpm install -g hermoso && hermoso auth login~/.hermoso/config.jsonに保存されます。ブラウザのないマシンでは、MCP & CLI → Terminal & API keys で作成したキーをhermoso auth login --token hmk_…で渡してください。 ~/.cursor/mcp.jsonに追加(またはプロジェクトの.cursor/mcp.json)。hermoso mcpは上で行ったサインインを読み込むため、ファイルにキーは書きません:{ "mcpServers": { "hermoso": { "command": "npx", "args": ["-y", "hermoso", "mcp"] } } }- またはワンクリックインストールは MCP のページから行えます。このディープリンクは、ホストされた URL をインストールし、認証は Cursor 自身の OAuth フローに任せます。どちらも使えますが、前提条件が異なります。
- Cursor に何かを頼みます。「競合上位3社の、最も長く配信されている広告を取得して、一番良いフックを9:16の動画にリミックスして」、または「このレンダリングをチャンネルに投稿して」。エージェントがツールを選び、支出はあなたが承認します。
上のブロックは、公開済みの hermoso npm パッケージをマシン上で実行します。そのためキーを貼り付ける必要はなく、ツールを呼び出すまではツール一覧のコストもかかりません。代わりにディープリンクを使う場合は、Cursor が認可サーバーに対して動的クライアント登録を行うため、やはりキーを持つ必要はありません。
その後、Hermoso の 設定 → コネクタ で TikTok 自体を一度接続してください。これはブラウザでの OAuth 同意画面なので、唯一ブラウザが必要な手順です。そのあとはすべてツール呼び出しです。
Cursor が使える 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 は接続されたアカウントに公開します。 |
Cursor で試す
普通の言葉で頼んでください。これは DSL ではなく、普通の文章です。
「./assets/slides の画像をファイル名順に使って TikTok の写真投稿を作成し、3枚目をカバーに設定して、どの公開範囲で投稿するかを私に確認してください。」
これは search_tiktok → plan_ad → render_ad → post_to_tiktok の流れです。Cursor は各ツール呼び出しを、実行前にコンポーザーに表示します。そのため、投稿は偶然起きる副作用ではなく、クリック1回の操作になります。
TikTok での Cursor：要注意の点
TikTok の写真投稿は、エディタとの相性が特に良い形式です。スライドはファイルであり、順番がストーリーになるからです。見落としやすい前提条件が1つあります。TikTok は写真投稿をアップロードではなく URL から取得するため、画像を配信するホストを TikTok の開発者ポータルで先に確認しておく必要があります。動画には影響しません。公開範囲のルールは両方に当てはまります。TikTok は投稿ごとに公開範囲を選ぶことを求めるため、Cursor が確認します。
特定のブランドに常に紐づけたいリポジトリでは、ホームディレクトリではなくプロジェクトの .cursor/mcp.json に設定を置いてください。そうしないと、hermoso auth login が使うワークスペースが固定されません。
投稿の前に TikTok をリサーチする
Hermoso には、Meta で行っているようなTikTok 広告ライブラリの検索はありません。そのため TikTok のリサーチはオーガニックです。search_tiktok がキーワードで効いているものを見つけ、analyze_video が一本の動画をフック、ビート、画面上の文字に分解するので、パターンを推測ではなく再利用できます。
有料の側
TikTok Ads は、Hermoso がキャンペーンを構築し読み取る十二の有料プラットフォームの一つで、Smart+ キャンペーンや、オーガニックな投稿を宣伝する Spark Ads も含みます。また、オーガニックの接続とは別の接続です。キャンペーンは TikTok の Marketing API で、投稿は TikTok のコンテンツ投稿の承認で動くので、Hermoso は一方が他方を示唆しないように、それぞれを別々に報告します。実際のお金を動かすのは、確認が必要な状態の切り替えだけです。
Cursor だけではできないこと
予算を持ったエージェントは、被害の範囲が限られていて初めて役に立つので、囲いはプロンプトではなくサーバー側にあります。すべての広告キャンペーン、広告セット、広告グループ、広告は一時停止の状態で作成され、実際のお金を動かす支出の切り替えは、明示的な確認フラグなしでは実行されません。すべてのレンダリングは、まず見積もられます（hermoso_capabilities が、支出の前に各モデルの正確なクレジット費用を公開します）。クレジットは最初のプロバイダー呼び出しの前に確保され、後で正確な費用で精算されるので、送信に失敗しても、何も得られないのに請求されることはありません。削除も確認が必要で、エージェントが何を作ったかを伝える前に、すべてのキャンペーンのツリーは広告プラットフォームから読み戻されます。
あえて完全なヘッドレスにしていない手順が一つあります。アカウントの接続は OAuth の同意画面なので、ブラウザでチャンネルを一度接続します。そのあとはすべてツール呼び出しです。
その他のマトリクス
Cursor からの投稿先: Facebook · Instagram · Threads · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram。または Cursor から投稿できるすべての先をご覧ください。
TikTok への投稿元: Claude · ChatGPT · Claude Code · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
よくある質問
Cursor から TikTok に投稿できますか？
はい、Hermoso の MCP サーバー経由で可能です。npm install -g hermoso && hermoso auth login を実行し、~/.cursor/mcp.json が npx -y hermoso mcp を指すようにします。ブラウザでサインインすると認証情報が保存されるため、ファイルにキーは書かれません。その後、Cursor では 922 以上のツールが使えます。TikTok に投稿するツールや、市場で配信中の広告を調べるツール、クリエイティブを作成するツールも含まれます。
TikTok を Cursor に接続するには？
手順は2つ、それぞれ一度だけです。npm install -g hermoso && hermoso auth login を実行し、~/.cursor/mcp.json が npx -y hermoso mcp を指すようにします。ブラウザでサインインすると認証情報が保存されるため、ファイルにキーは書かれません。次に Hermoso の 設定 → コネクタ で TikTok を接続します。ブラウザ上の OAuth 同意画面です。以降、Cursor は通常のツール呼び出しとして TikTok に投稿します。
Cursor から TikTok に非公開や下書きで投稿できますか？
はい。TikTok の投稿は、全員、フォロワー、友だち、またはあなただけに公開できます。または下書きに保存することもできます。TikTok は、アカウントで許可されている公開範囲の中から、投稿ごとに作成者が選ぶことを求めています。そのため Hermoso は、勝手に選ぶのではなく確認します。Hermoso は、TikTok が対応できない公開範囲を指定された場合、より弱い形で黙って公開するのではなく、その場で拒否します。
Cursor で、投稿だけでなく TikTok 広告も運用できますか？
はい。TikTok Ads は、Hermoso が管理する12の有料プラットフォームのひとつで、オーガニックの TikTok 投稿とは別に接続します。それぞれ個別の TikTok 承認で動作します。Hermoso は、片方から他方を推測するのではなく、それぞれを個別に報告します。
Cursor から投稿するときの TikTok の文字数上限は？
TikTok の動画キャプションは2,200文字まで、写真投稿のキャプションは4,000文字までです。Hermoso は投稿の作成またはキューへの追加時に適用するため、Cursor にはすぐに伝わります。誰も見ていないときに後から失敗することはありません。
Cursor は、投稿の前に TikTok をリサーチできますか？
はい。ただしオーガニックのみです。Hermoso には TikTok の広告ライブラリ検索はありません。search_tiktok はキーワードで効果のあるものを探し、analyze_video は動画をフック、ビート、画面内テキストに分解します。