Ghost 連携

RankTurn は、セルフホスト型または Ghost(Pro) のサイトに記事を直接公開します。各記事は Ghost の投稿として作成され、タイトル・本文・フィーチャー画像・抜粋・メタディスクリプション・スラッグ・正規 URL・タグがそのまま引き継がれます。記事内の画像とサムネイルは Ghost のメディアライブラリにコピーされるため、公開後の投稿は RankTurn に依存しません。

接続は安全に保たれます。RankTurn は公開のたびに、お持ちの Admin API キーを使って Ghost サイトに改めてサインインします。事前に Ghost と共有されるのは、サイト URL とこのキーだけです。

接続

Ghost の接続は 設定 → 連携（インテグレーション） から行います。Ghost のカードを見つけて 接続 をクリックします（既存の接続を更新する場合は 設定を編集 をクリック）。次の 2 項目の入力を求められます。

Ghost URL

Ghost サイトのベース URL を入力します（例: https://your-blog.ghost.io）。末尾にスラッシュが付いていても問題ありません。セキュリティのため、URL は実在し公開されてアクセスできるサイトを指している必要があります（内部アドレスやプライベートアドレスは拒否されます）。

Admin API キー

Admin API キーは、RankTurn がサイトに対して認証するために使用されます。作成手順は次のとおりです。

1. Ghost 管理画面を開く
2. Settings → Integrations に移動する
3. Add custom integration をクリックする
4. 名前（例: 「Rankturn」）を付け、Admin API Key をコピーする

キーは id:secret のように、途中にコロンが入った形をしています。コロンを含めた値全体を貼り付けてください。コロンが欠けているキーは拒否されます。

ここでは既定の公開フォーマットも選択できます（下記参照）。既存の接続を編集する際に Admin API キー欄を空白のままにすると、以前に保存したキーがそのまま維持されます。

接続のテスト。 接続時、RankTurn はお使いの Ghost サイトに対して認証情報を確認し、問題なければサイトのタイトルを表示します（例: 「Connected to Ghost: My Blog」）。

公開フォーマット

Ghost は 2 つの公開フォーマットに対応しています。接続ごとに既定値を設定でき、公開をスケジュールする際に個別の公開ごとに変更することもできます。

既定の公開フォーマットは 公開 で、投稿は即時公開されます。AI が生成した内容を公開前に確認したい場合は、接続時に ドラフト を選択してください。接続で設定したフォーマットが既定値となり、個々の公開ごとに変更することもできます。

Ghost メディアライブラリの画像

記事を公開すると、RankTurn は記事の画像を Ghost のメディアライブラリにコピーします。これにより、公開された投稿は RankTurn からではなく Ghost 自体から画像を配信します。

• サムネイル → フィーチャー画像。 記事のサムネイルは投稿のフィーチャー画像になります（代替テキストも引き継がれます）。Ghost はフィーチャー画像を投稿の上部に別途表示するため、本文からは取り除かれます。
• 本文中の画像。 RankTurn にホストされている本文中の画像もコピーされ、投稿は Ghost 上の新しいコピーを使うように更新されます。
• 1 枚の失敗で公開は止まりません。 いずれか 1 枚の画像のコピーに失敗しても投稿は公開され、その画像だけが元のリンクのまま残ります。
• 外部画像はそのまま。 サムネイルが既に他の場所（RankTurn 以外）でホストされている場合は、コピーせずそのままフィーチャー画像として使用します。

表やリストなどの記事の書式はそのまま保持されます。投稿タイトルは Ghost が独自に表示するため本文の先頭には繰り返されず、SEO のために構造化データ（Schema.org）が付加されます。

タイトル・抜粋・メタの文字数上限

Ghost はいくつかの短いフィールドに厳格な最大文字数を設けており、いずれかが長すぎると公開全体が拒否されます。AI が生成する抜粋やメタディスクリプションは長くなりがちなため、RankTurn は送信前にこれらのフィールドを自動的に切り詰めて収まるようにします。

切り詰めは可能な場合は適切な単語の区切りで行い、末尾に省略記号を付けます。そのため、わずかに長すぎる抜粋は公開を壊すことなく自然に短縮されます。記事の本文は切り詰められません — 対象はこれらの短いフィールドのみです。正確に制御したい場合は、記事エディタで抜粋とメタディスクリプションをこれらの上限内に収めてください。

Ghost が他の公開先の中でどう位置づけられるかは 連携・インテグレーション を参照してください。投稿のタイミングを制御するには 公開とスケジュール を参照してください。保存した認証情報の保護については 認証情報とセキュリティ を参照してください。