ドキュメント
型付きページ、リストページ、新しいパス
会社や職種といった要素からアドレスが組み立てられるページをコンテンツエンジンがどのように書き、リストページを最新に保ち、パスを追加・削除するかを説明します。
サイトの一部のセクションは、複数の要素を組み合わせて構成されています。たとえば、/interviews/google/software-engineer のように、企業と職種ごとに用意された面接ガイドです。コンテンツエンジンは、この構造をお客様自身のページから読み取り、検索されている組み合わせのページを作成します。さらに、それらのページから項目を集めるリストページを維持し、新しい値(たとえば新しい企業)の追加や、既存の値の削除も行えます。新しいアドレスにページを書く前には、必ずお客様のサイトに確認します。
AutoPSEO が構造を見つける仕組み
構造は、宣言からではなく、常にお客様自身のページから読み取られます。AutoPSEO はスキャンのたびに、アドレスをセクションと階層の深さでグループ化します。
- グループとして認識されるには、セクションから 2 階層以上下に、値が複数のページで繰り返されるセグメントを持つページが 6 ページ以上必要です。その結果、
/interviews/{company}/{role}のようなパターンが得られます。 - 各値の名前はページのタイトルから読み取られます。たとえば
goldman-sachsは「Goldman Sachs」になり、略称(Boston Consulting Group に対するbcgなど)も認識されます。 - これらのページがどのように検索されているかは Search Console から取得します。ある言い回しは、該当する検索のうち 20% 以上を占めた場合に採用されます。
- ページが守っている件数やリストの項目数は、AutoPSEO が保持するページのコピーで測定します(5 ページ以上が対象)。件数は全ページの 90% が収まる範囲を、リストは 80% のページが備えている場合にその項目を、それぞれ基準とします。
この構造が適用されるのは、お客様が AutoPSEO に任せたセクション、つまりそのパスに設定された管理対象のコンテンツタイプだけです。どのセクションを任せるかは、お客様のサイトが webhook を通じて伝えます(配信)。セクションに関するそれ以外の情報は、すべてページから読み取られます。
型付きページの作成
- ルーティング。 すべての要素について、名前、エイリアス、アドレスのセグメントのいずれかで 1 つずつ値を指定した検索は、型付きコンテンツタイプに振り分けられます。たとえば「amazon data engineer interview questions」は、company が
amazon、role がdata-engineerと解釈されます。 - ブリーフ には、アドレス、選択された値、そしてそれらの値についてお客様自身のページに書かれている内容が含まれます。内容はブリーフの作成時にリアルタイムで読み込まれます。
- チェック。 記事内のすべての数値は、それらのページ、または値に記録された事実のいずれかに記載されている必要があります。独自のページを持つ値は、H1 または冒頭の直接的な回答で名前を挙げなければなりません。各リストには所定の項目数が必要で、アドレスはまだ使われていない状態でなければなりません。お客様の AI は、値を
partsとしてcontent_get_briefとcontent_submitに渡します。 - 翻訳 では、すべてのリストの長さが同じに保たれます。
- 配信 には
article.partsが含まれます(例:{ "company": "google", "role": "software-engineer" })。
検索される組み合わせの計画
スキャンのたびに、パターン上は成立するもののまだページがない組み合わせを最大 500 件のアドレスとして洗い出し、各アドレスにページを受け入れるかどうかを path.check でお客様のサイトに 50 件ずつ問い合わせます。拒否された場合は理由とともに記録され、二度と問い合わせることはありません。サイトから応答がなかったアドレスは、次回のスキャンで改めて問い合わせます。path.check が接続されていない場合は、「接続されるまで新しいページは計画されません」。
1 回のスキャンで受け入れられたアドレスのうち最大 200 件について、AutoPSEO は リサーチクレジット を使って月間検索数を調べます。月間検索数が 10 以上の組み合わせは、サイトがすでにそのアドレスを受け入れているため、モデルによるレビューを経ずに バックログ に計画されます。10 未満の場合は、「独立したページを作るには検索数が少なすぎる」として見送られます。
リストページ
リストページは、同じ値を共有するすべてのページから 1 つのリストを集めたものです。たとえば /interview-questions/data-engineer には、ある職種のサンプル質問がすべて集められ、各項目は元のページにリンクします。AutoPSEO がリストページを作成するのは、お客様のサイトが任せたセクションのうち、スキャンでハブと判定されたものに限られます(ページが、ある要素の値の 60% 以上、かつ 3 つ以上をカバーしている場合)。
- リストページはすべての言語に存在します。翻訳に存在しない項目は、原文のテキストで表示されます。
- 配信では
article.kind = "list"とarticle.partsが付与され、本文は{ title, h1, items: [{ from, text }] }の形式になります。 - 集めている元のページが変更されるたびに再構築されます。モデル、レビュー、クォータはいずれも使わず、他のページがすでに使っているアドレスを取ることもありません(メンテナンス)。
- 手動での編集はできません。クレーム、リライト、ロールバック、取り下げ、統合はすべて拒否されます。このコンテンツタイプには 他のページから生成 と表示されます。
新しいパス
新しいパスとは、アドレスの最初の要素に加わる新しい値のことです。たとえば /interviews/jane-street のような新しい企業が該当します。
- 提案。 お客様の AI が
content_propose_valueで提案するか、AutoPSEO が月に 1 回、検索需要から見つけ出します。既存の検索と同じ形で、企業名の部分を除いたものについてキーワード候補を取得し、モデルが企業名を表すフレーズを選び、コンテンツタイプごとに最大 5 件を提案します。対象は、合計で月 100 回以上、かつ単独の検索で 10 回以上検索されているものです。探索にはpath.addの接続とリサーチクレジットが必要です。 - 確認。 各提案は、まずお客様のサイトに
new: { part, value, name }を付けたpath.checkとして送られます。拒否された場合は理由とともに記録され、その値が再び提案されることはありません。 - 執筆。 受け入れられた値は、キュー内の値タスクになります。このタスクを引き受けられるのは、Web を読めるライターだけです。具体的には、お客様の AI、または無人ランナーの values セッションです(お客様の AI)。AutoPSEO 側のライターは値タスクをスキップし、値タスクはクォータを消費しません。
- 提出。 ライターはブリーフ(ルール、他の値についてのお客様のページ 2 件、新しい値の名前を含む検索)を読み、
content_submit_valueを送信します。内容は、名前、エイリアス最大 10 件、その値自身の https サイト、その他の公式ページ最大 5 件、160 文字以内の説明、そして 3〜12 件の事実です。各事実は、https の出典、それを読んだ日付(過去 1 年以内)、ティアを備えた 1 文の平易な文とします。ティアは、出典がその値自身のサイトならofficial、それ以外はreportedです。値には、officialの事実が 1 件、または 2 つ以上のサイトに由来するreportedの事実が 3 件必要です。現在のルールでは、その企業の採用方法に関する事実を求めています。 - レビューと送信。 値はドラフトと同様にレビューを待ち、その後
path.addが配信アウトボックスを通じてお客様のサイトに送られます。サイト側でこのコマンドが接続されていない間は、送信は保留されます。 - 受理または拒否。 受理されると、その値は サイトに反映済み と表示され、事実とともにコンテンツタイプの値に加わり、次回のスキャンでそのページが計画されます。
invalid_valueで拒否された場合は、理由とともにライターに差し戻され、3 回目の拒否で確定します。それ以外のエラーコードで拒否された場合は、そのまま確定します。
コンテンツページの「AutoPSEO が提案、追加、または削除したパス」には、すべての値が一覧表示され、状態として「執筆中」「レビュー中」「サイトに送信済み」「サイトに反映済み」「見送り」などが表示されます。
パスの削除
この操作を開始できるのは人だけです。コンテンツページの パスを削除 (「削除するパス」「アドレスの転送先(任意)」)から行うか、MCP 経由でお客様の承認のもとに content_remove_path を実行します。path.remove は、その値のパス配下にあるすべてのページとともに値を削除し、それらのアドレスに redirectTo への 301 で応答するよう、お客様のサイトに依頼します。転送先は、お客様がサイト上の別のアドレスを選ばない限り、そのコンテンツタイプ自身のページになります。
- コンテンツタイプに値が 1 つしかない場合、その値は削除できません。
- サイトが削除を受け入れた場合、または
not_foundで 404 を返した場合、それらのページの AutoPSEO 側のコピーは追加の配信なしで取り下げられます。それらに関する送信待ちの配信は破棄され、タスクとその値について計画されていたトピックは見送りとなり、値はコンテンツタイプから外れます。ただし、旧ページはスキャン結果にはしばらく表示されます。 - サイトが 409
in_useなど別のエラーで拒否した場合、何も変更されません。
path.check、path.add、path.remove のペイロードの形式については、配信 をご覧ください。