Notion 連携

Rankturn は Notion ワークスペースと連携し、キーワード・記事・連載を Notion 上の複数のデータベースに反映します。連携後の編集は双方向に流れます。Rankturn 側の変更は Notion へ反映され、Notion 側の変更は Rankturn へ取り込めます。さらに、チェックボックス 1 つで Notion から記事の公開承認を行うこともできます。

Notion の設定は 設定 → 連携 の Notion カードから行います。

接続とセットアップ

Notion の接続は 2 ステップです。まず Notion で Rankturn を認可し、続いて短いセットアップ画面でデータベースを作成します。

1. 設定 → 連携 を開き、Notion カードを探します。
2. Notion で接続 をクリックします。Notion が開くので、Rankturn を認可し、アクセスを許可するワークスペースとページを選びます。少なくとも、データベースを作成したいページへのアクセスを許可してください。
3. 認可すると、Notion から Rankturn へ戻ります。カードは 接続済み になりますが、セットアップはまだ完了していません。セットアップを完了 の案内が表示されます。
4. セットアップを完了 をクリックしてセットアップ画面を開きます。

セットアップ画面での操作:

1. Rankturn が、ワークスペース内で参照できるトップレベルのページを表示します。参照できるページがちょうど 1 つの場合は、そのページが自動選択され、確認用に表示されます。それ以外の場合は検索できる一覧が表示されるので、タイトルを入力してページを探します。
2. データベースを作成する親ページを選択します。
3. データベースのプロパティ名に使うカラム言語を選びます。英語または日本語です。既定では現在の Rankturn の表示言語に合わせられます（下記「カラムマッピングとローカライズされたプロパティ名」を参照）。
4. データベースを作成 をクリックします。Rankturn は選択したページの中に RankTurn ページを作成し、その中に同期用データベースを作成します。続けて、既存のキーワード・記事・連載を初回として Notion へコピーします。

この初回のコピーはバックグラウンドで実行されます。Notion ではデータを追加できる速さに制限があるため、同期する量により10〜30分ほどかかることがあります。

セットアップが完了すると、カードは通常状態に切り替わり、同期・再接続・接続を解除 のボタンが表示されます。

再接続について: Notion のアクセスが失効した場合や、アクセスを付与し直す必要がある場合は 再接続 を使います。既存のデータベースを削除することなく、接続を認可し直します。

4 つのデータベース（キーワード・記事・連載）

Rankturn は単一の Notion データベースではなく、親ページの下に4 つの連携データベースを作成します。それぞれ独自のアイコンと既定のテーブルビューを持ちます。

これらのデータベースは Notion 内で相互にリレーションで結ばれています。

• 記事は キーワード リレーションを持ち、キーワードデータベースの該当行と紐づきます。
• 連載トピックは シリーズ リレーションと 記事 リレーションを持ち、連載データベース・記事データベースの該当行と紐づきます。

キーワードのカラム: キーワード（タイトル）、検索意図、検索ボリューム、難易度、CPC、ソース。このほかに、日付と、レコードの照合に使う内部用 ID を保持する非表示の列があります。

記事のカラム: タイトル（タイトル）、ステータス、自動公開、スラッグ、抜粋、カテゴリ、タグ、著者、キーワード（リレーション）、メタタイトル、メタディスクリプション、正規URL、SEOスコア、文字数、読了時間、公開日。このほかに、同じく非表示の日付・ID 列があります。記事本文そのものは列ではなく、Notion ページの本文として書き込まれます。

連載のカラム: シリーズ名（タイトル）とテーマのみです。連載のその他の設定（頻度・採番・スケジュール・テンプレート・自動生成・自動公開）は Rankturn が管理し、意図的に Notion へは反映しません。

連載トピックのカラム: タイトル（タイトル）、説明、キーワード、ステータス。このほかに、シリーズリレーション、記事リレーション、そして並び順・日付・ID を保持する非表示の列があります。

カラムマッピングとローカライズされたプロパティ名（EN/JA）

Notion はプロパティを名前で識別します。そのため Rankturn が書き込むカラム名は安定している必要があります。ウィザードで選んだカラム言語がこの名前を決定します。

• 表示カラムはローカライズされます。例えば、検索ボリュームの列は英語では Search Volume、日本語では 検索ボリューム です。記事の Title は タイトル、Status は ステータス、Auto Publish は 自動公開 になります。
• 非表示の日付・ID 列は両言語で英語名のまま保たれます。これにより、選んだ言語に関係なく Rankturn が確実にレコードを照合できます。

ローカライズされたプロパティ名の一部:

同期対象のプロパティを Notion 上でリネームしないでください。 名前がキーであるため、列名を変更するとそのフィールドのマッピングが壊れます。別のラベルにしたい場合は、接続のセットアップ時に適切なカラム言語を選んでください。

双方向同期とリアルタイム更新

既定の同期は一方向で、Rankturn の変更を Notion へ反映します。Notion 側の編集をリアルタイムで取り込むには、リアルタイム同期を有効にします。

接続済みの Notion カードにある リアルタイム同期 トグルでこれを制御します。有効にすると次のようになります。

1. このアカウント用の接続 URL が表示されます。コピーします。
2. Notion の連携設定にこの URL を追加します。これにより、何か変更があるたびに Notion から Rankturn へ即時の更新通知が届くようになります。
3. Notion が一度きりの検証コードを送ります。カードの トークンを表示 で表示してコピーし、Notion が検証を求める箇所に貼り付けます。
4. Notion が確認すると、カードに 検証済み バッジが表示されます。それまでは 検証待ち と表示されます。

検証後、Notion 上のページ変更（作成・更新・削除）が Rankturn へ届き、該当レコードに適用されます。同じレコードが両方で変更された場合は、より新しい編集が優先されます。Rankturn のレコードが Notion ページよりも新しく更新されていた場合は、取り込もうとした Notion の変更はスキップされ、新しい作業を上書きしないようにします。

データベースごとに、Notion から取り込まれる内容は次のとおりです。

• キーワード — キーワード文言、検索ボリューム、難易度、CPC、検索意図、ソース。
• 記事 — タイトル、スラッグ、抜粋、メタタイトル、メタディスクリプション、正規URL、SEOスコア、文字数、読了時間、タグ、カテゴリ、著者、キーワードリレーション、そして本文（Notion ページでの編集がそのまま記事の内容になります）。ステータスは取り込まれません — ステータスは Rankturn が唯一の正本であり、確認できるように Notion へ反映するだけです。
• 連載 — シリーズ名とテーマのみ。
• 連載トピック — タイトル・説明・キーワード。ただしトピックがまだキューで待機している間のみです。生成が始まった、またはすでに使われたトピックへの Notion の編集は無視されます。

リアルタイム同期が有効な状態で Notion のページを削除すると、対応する Rankturn のレコードが削除されます。Rankturn のレコードを削除すると、対応する Notion ページはアーカイブされます。

Notion からのレコード作成: リアルタイム同期が有効な場合、キーワード・記事・連載トピック データベースに新規行を追加すると、Rankturn 側に対応するレコードが作成されます。Notion で作成した新規記事は下書きとして取り込まれ、取り込みであることが記録されます。新しい連載トピックは、どの連載に属するかを Rankturn が把握できるよう シリーズ リレーションを設定する必要があります。連載 データベースの新規行は Rankturn 側へは作成されません — 連載は Rankturn 上でのみ設定します。

手動同期と新規取り込み

データを動かすのにリアルタイム同期の有効化は必須ではありません。接続済みカードの 同期 は、一度きりの双方向同期を実行します。

1. 現在の Rankturn のキーワード・記事・連載をすべて Notion へプッシュします。
2. 続けて、上記と同じルールで Notion から変更をプルします。

リアルタイム同期を有効にせずに Notion でまとめて編集したとき、あるいは設定を切り替えた後に全体を再整合させたいときに 同期 を使います。初回のコピーと同様に Notion 側の速度制限に合わせて行われるため、データ量の多いアカウントでは少し時間がかかることがあります。

Notion で追加した行は、リアルタイム同期の場合と同じように手動同期のプル時に取り込まれます。新規に追加したキーワード・記事・連載トピックの行は新しい Rankturn レコードになり、すでに Rankturn から来ている行は既存レコードとして扱われ、重複ではなく更新されます。

Notion から記事の公開を承認する

記事データベースには 自動公開（Auto Publish） チェックボックスがあります。これは公開を起動できる唯一の Notion コントロールであり、チェックすると Rankturn 上でその記事を公開承認します。

挙動は次のとおりです。

• ステータスは表示専用です。 Rankturn は記事の ステータス（下書き・生成中・公開済み・却下など）を Notion へ反映し、各記事の状態を確認できるようにします。ただし、Notion 上でステータスの列を編集しても無視され、次回の同期で上書きされます。Notion から記事のステータスを変更することはできません。
• 自動公開が承認のサインです。 Notion でこれをチェックすると、次回の同期（リアルタイムまたは手動）で Rankturn が承認を適用し、記事を公開へと進めます。すでに同期済みの記事でチェックした場合でも、Notion で直接作成した新規記事でチェックした場合でも機能します。

これにより Notion は手軽なレビューの場になります。チームは Notion 上で記事を読み、推敲し、ステータスを確認し、チェックボックス 1 つで公開承認できます。Notion から離れる必要はありません。

公開の仕組みについて詳しくは 自動公開 と 公開とスケジュール を参照してください。すべての連携での双方向同期の挙動については 双方向同期 を参照してください。