Docsbook
概要

MCPツールリファレンス

このページでは、https://docsbook.io/api/mcp/server にあるDocsbook MCPサーバーが公開するすべてのツールを一覧表示します。サーバーは309個のツールを公開しています。各ツールでは、OAuth 2.0 + PKCEによるBearer認証が必要です。

Billing列には、プロジェクト固有の残高に対して呼び出しが従量課金されるクラスが示されています。

クラス 対象
Included 検出と接続 — 従量課金なし
Read Docsbookがすでに保存しているページ、設定、またはレジストリ行の読み取り
Write コンテンツ、設定、目標、登録情報などの変更
Analytics イベントウェアハウスのスキャン:ファネル、ジャーニー、リテンション、フィード
Egress Docsbookのネットワーク外への処理 — URLの取得または実際の配信の実行
Probe モデルを介さずに、1つの種類の情報を収集して正規化
AI モデルを利用:モデルがユーザーに代わって何かを書き込み、読み取り、または順位付け
Agent エージェントの一連の実行:数分間の処理、レポート、および独自の実行記録

クラスごとの現在の料金はDocsbookの料金ページで公開されています。残高不足で拒否された呼び出しはその旨を示します。このページの内容は、それ以外の条件によって制限されません。

Claude Codeから接続するには:

mcp add --transport http https://docsbook.io/api/mcp/server

ワークスペースとブランディング#

ツール 請求 説明
get_info 含まれる サーバーの機能、バージョン、利用可能なツール一覧
list_workspaces 含まれる 認証済みユーザーのすべてのワークスペースと機能
get_workspace 含まれる ID または owner/repo でワークスペースを1つ取得
create_workspace 含まれる GitHub リポジトリからワークスペースを作成
update_branding 書き込み 色、フォント、ロゴ、アイコン、デフォルトテーマ、行動喚起 URL、サイトソース URL、平均商品価格
update_ui_settings 書き込み ヘッダー、検索、フィードバック、コピーボタン、パンくずリストの切り替え
update_navigation 書き込み ヘッダーリンク、ソーシャルリンク、サブヘッダーのフォルダータブ(オプションのアイコン付き)、左サイドバーのページ/フォルダーアイコン、サイドバーのラベル上書き — ページまたはフォルダーがサイドバーに表示する名前を変更(アドレスやツリー内の位置は変更しない)
update_ai_settings 書き込み AI チャットを有効化し、プロバイダーと API キーを設定し、モデルを選択 — 独自のプロバイダーキーの持ち込みにも対応
update_seo 書き込み SEO メタタグ、サイトマップ、OpenGraph
update_access 書き込み ワークスペースを非公開にし、パスワードを設定、かつ/または独自の SSO/OIDC ID プロバイダーを使用
update_domain 書き込み カスタムドメインを接続または削除
update_languages 書き込み AI 翻訳の対象言語を有効化

コンテンツとドキュメント#

ツール 課金 説明
search_docs AI ワークスペースのドキュメントコンテンツを対象に、全文・正規表現・見出し・パス検索を行います。読み取り専用で、読み取り・書き込み範囲にかかわらず、どのトークンでも利用できます。
search AI ワークスペースのドキュメントコンテンツを対象に、セマンティック(埋め込みベース)検索を行います。文字どおりのキーワードの重複ではなく、意味によってページを検索します。事前構築されたベクトルインデックスを読み取るため、検索時の再インデックスはありません。すべてのプランで読み取り専用として利用でき、公開サイトではリポジトリスコープのエンドポイントからトークンなしで提供されます。インデックスが構築されていない、または有効になっていない場合は、拒否する代わりに全文検索で回答し、modesemantic / lexical)によってどのエンジンが応答したかを示します。
get_doc_outline 読み取り 検索や書き込みの前に、すべての Markdown ページのタイトル、見出し数、サイズを一覧表示します。読み取り専用で、読み取り・書き込み範囲にかかわらず、どのトークンでも利用できます。
write_docs AI 1 回のアトミックな Git コミットで、1 つ以上の Markdown ファイルをワークスペースの docs リポジトリにコミットします。読み取り・書き込み範囲を持つトークンが必要で、読み取り専用トークンは拒否されます。オプションの intent を受け取ります。これは、その人が自分の言葉で依頼した内容です。変更パネルでコミットとともに表示されるため、編集の目的は、それを生み出した会話が終わった後も残ります。
fetch_url 外部アクセス 公開ウェブページを 1 ページ読み取り、タイトル、説明、リダイレクト後の最終 URL とともに、クリーンな Markdown として返します。ワークスペース外のページに対して主張を確認するために使用します。たとえば、競合他社の料金、自社のマーケティングサイト、またはドキュメントが依存するリンクが現在も解決できるかどうかを確認できます。404 やログイン画面は、失敗としてではなく明示された結果として返されます。リンクが機能するかどうかが質問の場合、それが答えになるためです。プライベートアドレスと内部アドレスは拒否され、robots.txt が尊重されます。また、ページコンテンツは常にデータとして扱われ、指示として扱われることはありません。
list_sources 読み取り このワークスペースが信頼できる情報源として接続しているリポジトリとウェブサイト、およびサイトのビルド元となるリポジトリを一覧表示します。各エントリには、接続した理由について所有者自身が記したメモが含まれます。読み取り専用です。ドキュメントの書き込みや更新の前に呼び出してください。接続されたソースは、思い出すのではなく、実際に読み取りに行ける事実です。
read_source 外部アクセス それらのソースの 1 つを読み取ります。path のないリポジトリの場合は読み取り可能なファイルを返し、ある場合はそのファイルを返します。path のないウェブサイトの場合は、独自のサイトマップから検出し、接続されたセクションに限定した複数のページを Markdown として返します。fetch_url と同じ保護が適用されます。プライベートアドレスは拒否され、robots.txt は尊重され、ページコンテンツはデータとして扱われ、決して指示として扱われません。
connect_source 書き込み リポジトリ、ウェブサイト、または単一のページを信頼できる情報源として接続します。接続されたソースは list_sources によって一覧表示され、read_source によって読み取られ、enable_agent を備えたエージェントによって監視されます。GitHub リポジトリは、保存前に読み取り可能であること(公開されているか、このプロジェクトがすでに保持している GitHub 認証によって読み取り可能であること)が確認されます。まだ誰も認証していないプライベートリポジトリは、読み取り不能なまま保存するのではなく、それを解決するために必要な 1 つの事柄とともに拒否されます。note は、ソースの用途について所有者自身が記した言葉であり、後からそれを読み取るすべてのものによって指示として解釈されます。読み取り・書き込みトークンが必要です。
configure_source 書き込み 接続されたソースの名前を変更したり、note を書き換えたり、一時停止したり(enabled: false — 接続状態は維持されますが、何も読み取りません)、完全に接続解除したりします(関連付けられた GitHub 認証も削除されます)。list_sourcessource_id、または match(ラベルや URL に含まれる単語)でソースを特定します。読み取り・書き込みトークンが必要です。

エージェントがディスク上でドキュメントをチェックアウトしている間に、より詳細なローカルグラフナビゲーション(アウトライン、あいまいな見出し、リンク参照、リンク解決)を行うには、代わりに markdown-lsp を使用してください。npx markdown-lsp <subcommand> ./docs を実行すると、作業ツリー上で LSP スタイルの doc_* ツールを公開できます。セットアップについては markdown-lsp README を参照してください。search_docs/write_docsmarkdown-lsp は相補的です。前者はローカルチェックアウトなしでホストされた MCP 接続上で動作し、後者はディスク上にリポジトリを必要とします。

イシュートラッカー#

ドキュメントの基になっている GitHub リポジトリ上の課題、つまりプロジェクトで未対応となっている作業です。ここでは、ドキュメントを監査したばかりのエージェントが、チャットログに残すのではなく、見つけたことを書き留めることができます。

管理パネルの Issues セクションが読み書きするのも同じ 3 つのツールなので、Claude Code から登録した課題はその表に表示され、その逆も同様です。

ツール 課金 説明
list_issues 読み取り プロジェクトのリポジトリにある課題を一覧表示します。オープン、クローズ済み、またはすべてを対象にでき、ラベルで絞り込むこともできます。プルリクエストは決して含まれません。読み取り専用です。create_issue の前に呼び出してください。オープンな課題と重複する課題は、課題がないよりも悪い結果になります。
get_issue 読み取り 1 件の課題を完全に読み取ります。本文全体、ラベル、状態、リンクを取得します。読み取り専用です。list_issues が返す 280 文字のプレビューをもとに対応すると、リクエストの誤った部分を実装することになります。
create_issue 書き込み タイトル、Markdown 本文、ラベルを指定して、プロジェクトのリポジトリに課題を登録します。読み書きスコープで認証されたトークンが必要です。読み取り専用トークンは拒否されます。課題 1 件につき 1 回の呼び出しが必要です。課題の番号とリンクを返します。

Docsbook がホストするサイトの課題は、Docsbook がそのサイト用にホストしているリポジトリに保存されます。自分のリポジトリから構築したサイトでは、そのリポジトリが使用されます。また、MCP 呼び出しはそこで Docsbook 自身のアカウントとして動作します。そのため、公開リポジトリの読み取りや課題の登録が可能で、非公開リポジトリの場合は空の一覧ではなく、権限エラーが明示的に返されます。

AIチャット#

ツール 課金 説明
get_chat_system_prompt 読み取り ワークスペースのチャットシステムプロンプトを読み取る
set_chat_system_prompt 書き込み チャットシステムプロンプトを置き換える
set_chat_hooks 書き込み LLMの前後フックを設定する
test_chat_hook 送信 合成ペイロードに対してフックを実行する

翻訳#

ツール 課金 説明
set_translation_mode 書き込み auto(組み込みAI)またはexternal(Webhookフロー)
list_pending_translations 読み取り 承認待ちの翻訳
get_translation 読み取り 言語とパスで1件の翻訳を取得
upload_translation 書き込み 外部で作成された翻訳をアップロード
approve_translation 書き込み 保留中の翻訳を公開
delete_translation 書き込み 翻訳を削除

分析と可観測性#

ツール 課金 説明
get_analytics 分析 期間ごとの閲覧数、訪問者数、人気ページ、参照元
get_ai_usage 分析 AIチャットと翻訳の利用状況、および残りの残高
get_ai_questions 分析 AIチャットに寄せられたすべての質問
get_ai_unanswered 分析 AIが回答できなかった質問
get_negative_feedback 分析 低評価のフィードバックが付いたページ
get_failed_searches 分析 検索結果が0件だった検索クエリ
get_popular_searches 分析 頻度順の人気検索クエリ
get_page_journeys 分析 ページ間の閲覧者のナビゲーション経路
query_events 分析 プラットフォームのイベントウェアハウスに対する任意のクエリ

Webhook#

Webhookの登録を維持するための料金はかかりません。従量課金の対象となるのは、エグレスとしての送信配信と再配信のみです。

ツール 課金 説明
register_webhook_<event> 書き込み 18種類の型付きイベントのいずれかに対するWebhookを登録(HMACシークレット + URL)
list_webhooks 読み取り ワークスペースに登録されているWebhookの一覧を取得
unregister_webhook 書き込み Webhookサブスクリプションを削除
list_webhook_deliveries 分析 ステータス、再試行回数、ペイロードを含む配信履歴
replay_webhook_delivery エグレス 過去の特定の配信を再配信
test_webhook エグレス URLに合成ペイロードを送信

型付きイベントは18種類あり、その中にはcontent.indexedtranslation.completedchat.no_answerchat.negative_feedbackusage.limit_approachingがあります。完全な一覧とペイロードスキーマについては、Webhookを参照してください。

スキルの発見#

ツール 請求 説明
find_skill 含まれる query によって docs-skills カタログを検索し、オプションで category および requires_plan フィルターを使用できます。エージェントが SKILL.md を直接取得するための raw_url を返します。

アクションツール — 作業の1ステップに1つのツール#

読み取り専用のツールが135個あります。それぞれは1つの対象に対する1つのアクションであり、分野全体を扱うものではありません。observe_link_graphはページ間のつながりを報告し、decide_next_marketは1つの市場を選び、他を選ばない理由を示し、draft_comparison_pageはページを書きます。呼び出し側が選ぶのは部門ではなく、1つのステップです。

このファミリーは3つの軸を組み合わせたものであり、すべてのツールが3軸すべてにおける自分の位置を宣言します。

  • 動詞は、回答の形と、その実行が拒否する内容を決めます。
  • ドメインは、対象と読み取る証拠を決めます。
  • 成果 — サポート負荷、オーガニックトラフィック、AIによる引用、回答までの時間、コンバージョンなど、さらに8項目 — は、そのツールを導入して変化させる数値であり、ツール自身の説明に記載されています。
動詞 回答する内容 拒否する内容
observe_* 何が存在するか、および各行の出典 何かを推奨すること
explain_* その背後にある仕組み。相関関係を言い換えただけのものではない どのステップを指しているのか示せないストーリー
discover_* 何が不足しているか。構築できるほど具体的に記述 「Xに関するコンテンツをもっと増やす」
decide_* 1つの選択と、すべての却下理由 判断ではなく順位付きリストを返すこと
plan_* 最初のステップが呼び出しになっている、順序付けられた手順 それを無効にし得る最初の事柄を確認する前に、その先の計画を立てること
draft_* そのまま適用できる成果物そのもの 概要を返してドラフトと呼ぶこと
measure_* こちらで算出した、実行間で比較可能なスコアカード スコアを書くこと、または不足分をゼロで埋めること
verify_* 「早すぎる」も許容する、対照値に対する判定 短すぎる期間に対して「確定」を使うこと
learn_* 適用可能な範囲と、適用が止まる地点を含む、移転可能なルール 境界のない教訓
handoff_* 正確な呼び出し、その引数、および受け入れ確認 受け入れテストを記述できない作業

それぞれは文章ではなく検証済みのJSONペイロードを返します。そこには、実行で収集したすべての生の事実を保持するevidenceマップと、引用する証拠に現れる数値だけを記述できる主張が含まれます。何にもたどれない数値は出荷されずに実行失敗となるため、作り上げられた数値がないかを確認する必要はありません。

ツールがスコアを算出する場合 — ドメインごとに1つずつ、15個のmeasure_*ツール — そのスコアは、ペイロードに重み付けを公開したうえで、収集した証拠からこちらで算出されます。モデルが記述したものではありません。あるモデルの0〜100という値は、同じモデルの翌週の値と比較できません。それでは、スコアを持つ唯一の理由である、その変化を追跡することができなくなります。確認できなかった軸は未測定として報告され、決してゼロにはなりません。

135個すべてが変更を行わず読み取り専用トークンで動作します。実行全体を通じて書き込みは拒否されます。すべてがAgentクラスとして課金されます。これには、ページまたはブロックを生成し、それを適用する呼び出し(run_docs_create / run_docs_manage)を示すdraft_*も含まれます。ただし、それ自体が適用するわけではありません。すべての行にその呼び出しが含まれるため、分析結果は人間が間に入って翻訳しなくても引き渡せます。

それぞれの価格は、宣言された作業量に基づいて設定されています — 読み取る証拠のファミリー数、実行する可能性のあるモデルとの往復回数、サイト外に出るかどうか、成果物を出力するかどうか — そのため、狭い範囲の観察には、すべてのアクションに一律のエージェント料金を課すのではなく、深いドラフトの一部に相当する費用がかかります。待ち時間も同じ仕組みで異なり、標準的な待ち時間は以下の各ツールに記載されています。各ツールの現在の価格は、パネルおよびDocsbookの料金ページに表示されています。

製品 & 機能マップ#

ツール それだけが教えてくれること 標準的な待ち時間
observe_capability_inventory 製品が実際に公開している機能ごとに1行を割り当て、それを説明するページと並べて示します。また、ページが存在しない場合は空欄になります。 約41秒
explain_capability_confusion 製品がすでに備えている機能について読者が質問する原因となる仕組みを示します。既存の機能を見えなくしている正確な表現、配置、または欠落です。 約45秒
discover_undocumented_capabilities 製品には存在するもののドキュメントのどこにも記載されていない機能を、それぞれ明日からページを書けるほど具体的な名前で示します。 約45秒
decide_capability_priority 次にドキュメント化すべき機能を1つ示し、真剣に検討すべき代替案をすべて挙げ、それぞれが選ばれなかった理由を説明します。 約26秒
plan_capability_page_set 1つの機能に実際に必要なページ一式を示します。さらに重要な点として、不要なページも示し、書くべき順序に並べます。 約39秒
draft_capability_matrix 完成した機能マトリックスページを、コミット可能なMarkdown形式で提供します。すべての機能、その状態、計画上のゲート、ページへのリンクを含みます。 約52秒
measure_capability_coverage ドキュメントが製品のどれだけを実際にカバーしているかを、異なる担当者が定める5つの軸で繰り返し評価できるスコアカードです。 約45秒
verify_capability_claims ドキュメントが主張する各機能について、製品が現在もその機能を提供しているかを判定し、それを確定させる根拠も示します。 約52秒
handoff_capability_backlog 次に実行する担当者向けに機能作業をまとめたものです。正確な呼び出し、その引数、成功を確認する方法を含みます。 約20秒

完了すべきジョブ#

ツール それだけが教えてくれること 通常の待ち時間
observe_reader_jobs 読者が自分の言葉で述べたジョブ — アシスタントへの質問や検索から得られたものを、グループ化し、集計し、逐語的に引用したもの。 約32秒
explain_job_abandonment 1つのジョブが完了不能になる箇所と、それを止める仕組み — 読者が離脱する前に行き着くステップ、欠けている前提条件、または文。 約42秒
discover_unserved_jobs 製品が対応できるにもかかわらず、ドキュメントのどこにも対応方法がないジョブ — 対応できる機能から読者へと論理的にたどって導き出したもの。どこにも対応されていないジョブには、測定できる痕跡が残らないため。 約48秒
decide_primary_job このドキュメントが軸に構成されるべき唯一のジョブと、競合するジョブ、およびそれぞれを退けるコストを明示したもの。 約32秒
plan_job_journey 1つのジョブを最初の接触から完了まで運ぶ、ページの順序付けられた流れと、その流れにあるギャップを示したもの。 約33秒
draft_job_walkthrough 1つのジョブのために最初から最後まで書かれた、ウォークスルーページそのもの。すべての前提条件が明記され、すべてのステップを検証できる。 約55秒
measure_job_completion ジョブを持つ読者が実際に完了できたかどうかのスコアカード — 開始、継続、行き止まり、申告された結果、再訪。 約39秒
verify_job_now_served ジョブのために書かれたページが、実際に読者の行動を変えたかどうか — 変更前、変更後、期間、対照、判定。 約36秒
learn_job_patterns ドキュメントがうまく対応しているジョブの背後にあるルールを、他にも適用できる形で示したもの — そして、そのルールが通用しなくなる境界。 約32秒

トピックオーソリティ#

ツール これだけが教えてくれること 通常の待ち時間
observe_topic_inventory このコーパスが扱うすべてのトピック、それぞれを扱うページ数、最も深いページがどこまで掘り下げているか、そしてそこへリンクしているページ数。 約32秒
explain_authority_shortfall このコーパスが、そのトピックについて言及するサイトに見えても、そのトピックを扱うサイトに見えない理由――そうした印象を生む具体的な欠落。 約39秒
discover_missing_entities そのトピックに必要だが、このコーパスが一度も名前を挙げていないエンティティ――読者が本物の情報源なら知っているはずだと期待する概念、ツール、形式、失敗パターン。 約39秒
decide_topic_cluster_focus 次に構築すべき1つのトピッククラスター、候補として挙がった競合、およびそれぞれが却下された理由。 約32秒
plan_topic_cluster ハブとそのスポーク――クラスターに必要なすべてのページ、それぞれが担う内容、相互のリンク方法、そして執筆順。 約33秒
draft_topic_hub_page ハブページそのものを執筆したもの――定義、サブトピックのマップ、そしてクラスターをグラフにするリンク。 約46秒
measure_topical_depth このコーパスがトピックの権威として読まれるかどうかを判定する、再現可能なスコア――定義、網羅性、関係性、根拠、接続性。 約36秒
verify_cluster_effect 構築したクラスターが実際に成果を上げたかどうか――対照群と明示した期間を基準に、ランキング、流入、または引用を獲得したか。 約36秒
learn_authority_wins このサイトが実際に勝ち取ったトピックの背後にあるルール――それらのページに他のページにはなかったもの、そしてそのルールが適用されなくなる範囲。 約32秒

検索意図#

ツール それだけが示すこと 通常の待ち時間
observe_query_intents このサイトがどの検索クエリで見つかるかを、それぞれが持つ意図(方法、定義、比較、エラー、価格、リファレンス)ごとに分類したもの。 約32秒
explain_intent_mismatch 検索順位を獲得したページでも読者を逃してしまう理由――質問の形とページの形の間にある具体的なギャップ。 約36秒
discover_intent_gaps 読者が実際に持ち込む意図のうち、このサイトのどのページも答えられる形になっていないもの。 約36秒
decide_page_shape 実際に流入している意図を踏まえ、1つのページがチュートリアル、ハウツー、リファレンス、解説、比較のどれであるべきかを示したもの。採用しなかった形も明記。 約26秒
plan_intent_coverage このサイトが集める意図をカバーするために必要なページを、順序付けて並べたもの。それぞれが1つの意図だけに正確に合わせられている。 約30秒
draft_intent_matched_opening 実際に検索順位を獲得している意図に合わせて書き直した、ページのタイトル、説明、ファーストビュー――そのまま適用できる形で記述したもの。 約39秒
measure_intent_match 読者に表示されたページが、読者が持ち込んだ意図にどの程度一致しているかを、観測結果から算出した5つの軸で評価するスコアカード。 約36秒
verify_intent_fix 意図に基づく書き直しによってクリックやエンゲージメントが実際に変化したかを、対照群と検索データの遅延を考慮して示したもの。 約36秒
handoff_intent_rewrites 意図に基づく書き直しを作業指示としてまとめたもの:どのページを、何に変更し、どの検索クエリで勝つ必要があるか。 約20秒

プログラマティックSEO#

ツール それだけが教えてくれること 通常の待ち時間
observe_page_families このサイトですでに軸に沿って繰り返されているURLパターン、そのメンバー数、そしてその軸が実際に持つ数。 約26秒
explain_thin_family_pages あるファミリーの生成メンバーが成果を上げられない理由 — その大半で空欄になっている、同一である、または作り出されているフィールド。 約36秒
discover_scalable_patterns このプロダクトが大規模に答えられる、繰り返し現れる検索パターン — 軸、クエリテンプレート、そして各メンバーが持つ固有の事実。 約48秒
decide_family_worth_building 提案されたファミリーを構築すべきかどうかについての1つの判定。代替案を示し、打ち切り条件を最初に明記する。 約30秒
plan_family_rollout 展開計画 — 最初に公開するメンバー、データを供給するフィード、ガードレール、そしてチェックポイント。 約42秒
draft_family_template テンプレートそのもの — ページの骨格、メンバーごとの変数、そして完全にレンダリングされた2つのメンバー例。 約58秒
measure_family_coverage ファミリーごとのスコアカード:軸をどの程度カバーしているか、メンバーがどの程度明確に異なるか、どの程度適切にリンクされているか、そして事実がどの程度最新であるか。 約32秒
verify_family_indexation 生成されたメンバーが実際に到達可能でインデックス登録されているかどうか — ライブで取得し、該当しないものは個別に名前を挙げる。 約45秒
learn_family_thresholds このサイトで、生成されたメンバーが何らかの成果を得るために超えるべきしきい値 — 背後にあるケースとともにルールとして示す。 約32秒

無料ツール#

ツール それだけが教えてくれること 通常の待ち時間
observe_tool_demand 読者がすでに求めている、計算・変換・検証・生成・チェックのようなツール形式のリクエストを、引用して集計したもの。 約32秒
explain_tool_underuse 既存の無料ツールが使われない理由 — 読者がそこに到達したり、利用を完了したりするのを妨げる入口、使いにくさ、またはミスマッチ。 約45秒
discover_tool_ideas このプロダクトが信頼性をもって提供できる無料ツールと、それぞれが答えるクエリおよび実現に必要なデータ。 約48秒
decide_tool_to_build 構築するツールを1つ選び、残りを理由付きで却下し、選んだツールの保守コストを開始前に明示したもの。 約39秒
plan_tool_launch ローンチの計画: ツールをどこに置くか、何からリンクするか、その後に読者へ何を渡すか、そして成功をどう評価するか。 約33秒
draft_tool_page ツールのページの原稿: ファーストビューで何をするものか、実例、使用する方法、次のステップ — さらにウィジェット自体の埋め込み仕様。 約58秒
measure_tool_pull ツールが実際に生み出すもののスコアカード — 流入、完了、次の行動、獲得リンク、単独での可読性。 約32秒
verify_tool_traffic ツールのローンチによって測定可能な変化が生じたか — 対照群と比較し、定めた期間で評価し、「時期尚早」という判定も可能にしたもの。 約32秒
handoff_tool_build 構築担当者向けに定義されたツールの仕様: 入力、ルール、出力、エッジケース、そして合格すべき受け入れ確認。 約29秒

独自調査#

ツール それだけが教えてくれること 通常の待ち時間
observe_own_data_assets 外部の誰も算出できない、この製品がすでに保有しているデータ――何をカバーしているか、どこまで遡れるか、そもそも公開可能かどうか。 約41秒
explain_research_ignored 公開された研究が引用を一件も獲得できなかった理由――欠けていた手法、引用できない形式、または誰かが再利用できたはずの主張の不在。 約48秒
discover_research_questions 自社データだからこそ答えられる、他の誰にも答えられない問い。その問いに答えるためのデータの切り口と、それを繰り返し取り上げる読者層まで。 約45秒
decide_research_to_publish 実施すべき一つの研究。却下した問いを明示し、答えがつまらないものだった場合に何が起きるかという、正直なリスクまで示す。 約30秒
plan_research_release リリース内容――実行するデータの切り口、明記すべき手法、公開すべき成果物、そして翌年も再現可能にする実施頻度。 約33秒
draft_research_report レポートそのもの――引用可能な一文にまとめた見出しの主張、分母を伴う数値、手法、そして限界。 約68秒
measure_research_citations 公開された研究が実際にどれだけ引用可能かを示すスコアカード――引用可能な主張、明記された手法、アクセス可能なデータ、日付情報、機械可読性。 約45秒
verify_research_claims 同じデータの切り口で再実行したときにも、公開済みの各数値が有効であり続けるかどうか――不一致があれば個別に明示する。 約39秒
learn_research_formats 公開したコンテンツのうち、どれが繰り返し取り上げられたかを決めたルール――形式、主張の形、またはリリースのパターン――と、それが適用できなくなる範囲。 約39秒
ツール それだけが教えてくれること 通常の待ち時間
observe_assistant_answers 現在、回答エンジンがこの製品について何を述べているか、そしてそれを述べるためにどの情報源を使ったかを、引用、日付、生成に使われた質問とともに示します。 約46秒
explain_citation_absence このドキュメントがアシスタントの引用元にならない理由、つまりページのどの特性によって引用できないのかを具体的に示します。 約48秒
discover_quotable_atoms このコーパスにあるべきなのに存在しない、自己完結した文章を示します。1つの質問に対する1つの完全な回答で、周囲の文章なしでも引用できます。 約39秒
decide_geo_surface_priority 最初に修正すべき機械向けの接点がどれかを示します。ページ構成、llms.txt、構造化データ、フィード、クローラーアクセスの中から選び、残りは順位付けして却下します。 約39秒
plan_geo_surfaces 機械向けの接点に対して行う作業を順序立てて示し、各ステップについて、変更する設定またはページと、反映を確認するチェックを記載します。 約39秒
draft_answer_blocks そのまま引用できる文章自体を、質問、完全な回答、情報源、日付とともに、全体を抜き出しても正確になるように記述します。 約55秒
measure_ai_visibility 回答エンジンにこの製品がどの程度現れているかを示すスコアカードです。存在感、正確性、帰属、鮮度、そして対象となる質問のカバー率を評価します。 約48秒
verify_citation_gain GEOの作業によってアシスタントの回答が変わったかどうかを、同じ質問を前後に尋ね、回答を逐語的に比較して示します。 約45秒
learn_citation_patterns どのページが引用されるかを決めるルールを、その境界とともに示します。ページの構成、回答の位置、日付が要素となります。 約45秒

競合他社 & 市場の空白#

ツール それだけが教えてくれること 標準待ち時間
observe_competitor_docs 特定の競合他社のドキュメントに実際に含まれている内容 — セクション、ページタイプ、自社にはない相手のドキュメント内容 — を取得日時付きで示します。 約46秒
explain_switching_objections 両方のドキュメントを読む際に評価者が抱く具体的な懸念と、それを生む自社のページおよび文。 約48秒
discover_market_gaps 自社も指定した競合他社も満たしていないニーズ — そのニーズを誰かが抱えていること、そして誰も答えていないことを示す証拠付きで。 約52秒
decide_positioning_wedge この製品が提案すべき唯一の比較、その製品が避けるべき比較、そしてそれぞれを避ける理由。 約33秒
plan_comparison_pages 用意する価値のある比較ページの一覧、信頼性を持たせるために各ページに必要な内容、そして執筆順序。 約39秒
draft_comparison_page 取得した証拠に基づいて書かれた比較ページそのもの — 相手側に関するすべての主張を、相手が勝っている場合も含め、取得日時と出典付きで示します。 約58秒
measure_competitive_coverage 評価者が実際に開く情報面において、自社のドキュメントが指定した競合他社に対してどの程度通用するかを示すスコアカード。 約48秒
verify_competitor_claims 競合他社に関して自社のページが掲げる主張が現在も正しいかどうか — それぞれを再取得し、古くなったものを特定します。 約42秒
learn_competitor_moves 前回の確認以降に競合他社側で何が変わったか、そしてその変化の背後にあるパターン — 次に注視すべきこととして示します。 約42秒

ユーザーの言葉#

ツール それだけが教えてくれること 通常の待ち時間
observe_reader_vocabulary 読者が実際に入力して尋ねる言葉を、文字どおりの形と件数で、ドキュメントが同じものに使っている言葉の隣に示します。 約29秒
explain_term_misses 読者の言葉で何も返されない理由と、それが大きく異なる2つの原因のどちらなのかを示します。概念の名前が異なるのか、それとも概念自体が完全に欠けているのかです。 約36秒
discover_missing_synonyms すでにドキュメント化されている概念について、コーパス内のどこにも現れない別名を、それを掲載すべきページとともに示します。 約32秒
decide_canonical_terms 各概念につき1つの正式名称を定め、採用しなかった名称は削除せず同義語として残し、それぞれの選択理由を示します。 約30秒
plan_terminology_migration 命名の決定をコーパス全体に反映するための順序付き計画を、変更してはならないページとその理由を含めて示します。 約30秒
draft_glossary_entries 用語集の各エントリそのものです。各概念を、新規利用者が使える一文で定義し、同義語とそれを管理するページを示します。 約52秒
measure_vocabulary_alignment コーパスの言葉が読者の言葉からどれだけ離れているかを示す評価表です。読者の用語の網羅率、こちらの用語の一貫性、そして検索でどの程度解決できるかを評価します。 約32秒
verify_renaming_effect 読者の言葉を追加することで実際に失敗が減ったかどうかを、同じ検索を変更前と変更後で比較し、対照条件も含めて示します。 約32秒
handoff_term_changes 命名作業を実行項目としてまとめたものです。どのページで、どの言葉をどの言葉に変更し、その後どの検索の失敗を止めるべきかを示します。 約20秒

コンテンツアーキテクチャ#

ツール これだけが教えてくれること 通常の待ち時間
observe_corpus_shape コーパスの実際の構成 — セクション、分岐ごとの深さ、ページサイズ、そして宣言されたナビゲーションが実際にどれだけの範囲に到達しているか。 約26秒
explain_navigation_failure 読者が情報を見つけられない理由 — 宣言したツリーと、読者が実際にたどるルートとの具体的な不一致。 約42秒
discover_orphan_pages どこからもリンクされていないページと、読者が到達したもののそこから出られないページ — ツリーの内部からは見えない、コーパスの両端。 約32秒
decide_structure_model このコーパスが採用すべき整理原則 — 仕事別、製品領域別、ページタイプ別、読者別のいずれにするか、却下したモデルとそのコストも含む。 約36秒
plan_restructure 移動リスト — どのページをどこへ、どの順番で移すか。すべてのURL変更と、それに必要なリダイレクトをそれぞれ1行に明記。 約39秒
draft_navigation_tree ナビゲーションそのものを書き起こしたもの — 読者の言葉によるラベルを付けた完全なツリーで、そのまま適用できる。 約42秒
measure_findability 読者が自分の到着地点から必要な情報までたどり着けるかどうかの評価表 — 到達可能性、深さのバランス、現在地の把握、入口、検索による代替手段。 約39秒
verify_restructure_effect 再構成が役立ったかどうか — リダイレクトと対照セクションを確認しながら、実施前後で同じ見つけやすさと行動の指標を比較。 約45秒
learn_structure_lessons このコーパスで機能しているセクションの背後にあるルール — どのようにまとめ、どこまで深くし、どのように開くか、そしてその適用がどこで止まるか。 約32秒

内部リンク#

ツール それだけで分かること 通常の待ち時間
observe_link_graph コーパスをグラフとして捉えたもの:どのページがどのページにリンクしているか、それぞれのページに入るエッジと出るエッジの数、そしてグラフがハブとみなすページ。 約29秒
explain_unreachable_pages 実際にはページに到達できない理由 — 欠落しているエッジ、誰もたどらないリンク、またはクリックする理由を与えないアンカーテキスト。 約36秒
discover_missing_links 同じエンティティについて述べているにもかかわらず互いにリンクしていないページの組み合わせ — それぞれについて、リンクを配置すべき文も示す。 約39秒
decide_hub_pages どのページがハブになるか — 他のすべてのページからリンクされるページ — と、却下された候補およびその理由。 約30秒
plan_linking_pass リンク付けの工程:どのページをどの順番で編集し、それぞれがいくつリンクを獲得するか、そしてリンクスパム化を防ぐルール。 約30秒
draft_link_insertions 編集内容の詳細:各ページについて、リンク挿入後の文面、アンカーテキスト、リンク先。 約46秒
measure_graph_health リンクグラフの評価表 — 接続性、ハブの集中度、クラスター間の横断、アンカーの品質、そしてナビゲーションだけに依存するページ数。 約36秒
verify_link_effect 内部リンクの工程によって何かが変わったかどうか — リンク先ページへの到達数、行き止まり率、順位を対照群と比較したもの。 約36秒
handoff_link_edits ページごとにリンク編集を呼び出しとしてまとめ、到達数またはインバウンド数による受け入れ確認を明記したもの。 約20秒

信頼性(E-E-A-T)#

ツール これだけが教えてくれること 通常の待ち時間
observe_trust_signals ページが実際に備えている信頼性の根拠 — 著者、日付、出典、分母付きの数値、具体例、明示された制限事項 — をページごとに確認できます。 約32秒
explain_disbelief 事実として正しいページを読者が信じない理由 — 出典のない数値、明示されていない制限事項、またはあなたしか主張していない内容。 約45秒
discover_unsourced_claims 商業上重要なページにある、出典も分母も日付もないすべての主張 — 個別に一覧化されます。 約35秒
decide_evidence_standard 各種類の主張が公開前に備えるべき証拠 — 不採用にした基準とそのコストも含め、一度決定します。 約29秒
plan_trust_upgrade ページを証拠の基準に適合させるための優先順位付き作業 — 実際に信頼が投じられているページから着手します。 約30秒
draft_evidence_blocks 書き直された主張そのもの — それぞれに出典、分母、日付、そして制限事項が併記されます。 約55秒
measure_trust 信頼できるかどうかを5つの軸で評価したスコアカード — まず検証可能性を重視します。これは競合他社が午後の作業だけでは模倣できない要素だからです。 約45秒
verify_claim_freshness 日付付きまたは数値を含む各主張が、現在も正しいかどうか — 出典と照合して再確認し、古くなったものを個別に示します。 約48秒
learn_trust_objections 読者が疑問を抱いたすべての内容に共通する反論パターン — この読者層が何を証明される必要があるかというルールとして示します。 約32秒
ツール これだけが教えてくれること 通常の待ち時間
observe_inbound_mentions 現在この製品を公開の場で参照しているのは誰か、何を述べているか、そしてその参照がリンク、言及、引用のいずれであるか。 ~42 s
explain_unlinkable_pages なぜ誰もそのページにリンクしないのか — このテーマについて書く人が必要とする情報のうち、何が欠けているのか。 ~45 s
discover_link_targets この製品を参照しそうな具体的な場所 — それぞれについて、リンク先となるページと、リンクする理由。 ~51 s
decide_linkable_asset 参照を生み出すために作るべき1つのアセット — データ、ツール、定義、論拠のいずれかと、採用しなかった選択肢およびそれらが劣る理由。 ~39 s
plan_outreach_sequence 順序付けられた行形式のアウトリーチ計画:誰に、どの順番で、何を使ってアプローチし、どの時点で終了するか。 ~42 s
draft_outreach_pitch ターゲットごとに作成されたメッセージそのもの — 相手のどの内容に触れるか、何を提供するか、そして依頼する1つの事項。 ~51 s
measure_linkability このコンテンツ群がどれだけ参照されやすいかを示すスコアカード — 独自の事実、指定可能なセクション、引用しやすい形式、URLの新しさと永続性。 ~45 s
verify_mention_gain 作業後に実際に新しい参照が現れたかどうか — 再検索し、以前のセットと比較し、参照トラフィックも併記する。 ~42 s
handoff_pr_targets 相手に合わせてまとめたアウトリーチ:ターゲット、そのページ、作成済みのメッセージ、依頼内容、返信が意味すること。 ~33 s

市場拡大#

ツール これだけが教えてくれること 通常の待ち時間
observe_audience_origins 読者がすでにどこから来ているか — 国、言語、参照元 — と、ここに来た後に各グループがどれほど異なる行動を取るか。 約32秒
explain_market_stall 訪問者が来てもコンバージョンに至らない理由 — それを阻む言語、例、価格に関する前提、または不足している証拠。 約42秒
discover_adjacent_markets この製品が対応できるにもかかわらず、まったくリーチできていないオーディエンス — それぞれについて、ニーズが存在する証拠と、通過すべき障壁。 約48秒
decide_next_market 次に参入する市場を1つ選び、残りを却下するとともに、誰かがコミットする前に、その選択を継続するためのコストを明示する。 約36秒
plan_market_entry 参入計画:最初に作成するページ、言語以外にローカライズすべきもの、そして継続するかどうかを決めるチェックポイント。 約33秒
draft_market_landing その市場のランディングページを、その市場の言語、例、通貨、そして市場が求める証拠を使って作成する。 約46秒
measure_market_readiness ドキュメントが市場向けに準備できているかを評価するスコアカード — カバレッジ、言語以外のローカライズ、証拠、見つけやすさ、維持管理。 約36秒
verify_market_traction 市場への参入によって何かが変わったかどうか — その市場からの訪問、成果、リターンを、対照群および明示した期間と比較する。 約36秒
learn_expansion_lessons ここでうまくいった市場の背後にあるルール — 他の市場にはしなかったことを、その市場のために何をしたのか — と、その適用範囲。 約32秒

多くは、独自の言葉で記述する任意の request を受け付けます。これは手法を置き換えることなく実行範囲を絞り込むものであり、さらに、その質問に必要な型付き入力(pathpath_prefixpagescompetitorswindow_days)も受け付けます。独自の契約に違反するペイロードは、違反内容を列挙した失敗として報告されます — 結果が空の成功した回答として報告されることは決してありません。「検出結果なし」は「サイトに問題はない」と受け取られるためです。

Collectors — 読み取りなしの証拠#

このファミリーには、独自のより安価な料金クラスに属する5つのツール、Probeがあります: collect_page_textcollect_corpus_mapcollect_assistant_questionscollect_trafficcollect_onsite_search。これらは、アクションが読み取るはずだった正規化済みの行に加え、各行の背後にある正確な呼び出しを示す reproduce ブロックを返します — 経路上にモデルがないため、そこに含まれる内容を疑う理由はありません。読み取り結果を購入するかどうかを決める前に、まず数値が欲しい場合に購入してください。audit_geo も前世代から引き続き利用できます。その証拠レイヤーはモデルではなくコードで構成されており、アンサーエンジンがそもそもあなたのページを取得できるかどうかに答えます。

バックグラウンドエージェントの実行#

find_skill は SKILL.md をあなたのエージェントに渡して実行させます。これらのツールは逆のことを行います。Docsbook 側で、あなたのワークスペースに対して、そのスキル向けに用意された完全な管理ツールセットを使ってスキルを実行します。そのため、他の Docsbook ツールが接続されていないアシスタントでも作業を完了できます。

run_docs_* 呼び出しは、直ちに { run_id, state } を返します。結果は返しません。処理には数分かかるため、開始を回答として報告する呼び出し元は、まだ実行されていない作業を報告していることになります。返された run_id を使って get_agent_run をポーリングしてください。

ツール 課金 説明
run_docs_analyze エージェント docs-analyze スキルを実行します。実際の数値に基づいてサイトを監査し、問題点とそのコストを報告します。監査モードが宣言されており、実行中は書き込みが拒否されるため、読み取り専用トークンで動作します。
run_docs_create エージェント docs-create スキルを実行します。サイト、リポジトリ、別のドキュメントプラットフォーム、または製品名だけを元にドキュメントを構築します。ページをコミットするため、読み書きトークンが必要です。
run_docs_manage エージェント docs-manage スキルを実行します。執筆およびサイト運用のルールブックに基づいてページを書き換え、サイトを設定します。読み書きトークンが必要です。
run_docs_automate エージェント docs-automate スキルを実行します。ドリフトガード、イベントサブスクリプション、受信した変更に対するチェック、アラート、常時監視を設定します。読み書きトークンが必要です。
get_agent_run 読み取り 1 回の実行の状態(queuedrunningsucceededfailedcanceledexpired)、実行中のリアルタイムの進捗、そして成功時には完全な結果(レポート、実行したすべてのアクション、サイト上で変更された内容)を取得します。
list_agent_runs 読み取り 最近の実行を新しい順に取得します。2 つ目のジョブを開始する前に、すでに実行中かどうかを確認するために使用します。
cancel_agent_run 読み取り 完了していない実行を停止します。実行がすでに行ったことを取り消すものではありません。すでにコミットされたページは、そのままコミットされた状態になります。

実行は、それを開始したアカウントに属します。別のアカウントの run_id では、未知のものとまったく同じように読み取られます。開始していないキュー内の実行は、数時間後に遅れて実行されるのではなく期限切れになります。これは、監査が依頼された時点のサイトについての質問に答えるものだからです。また、実行は 1 回だけ試行され、再試行されることはありません。失敗した実行でもすでにページをコミットしている可能性があり、2 回目の試行では同じページが二重にコミットされるためです。

常駐エージェント#

上記のツールは、リクエストに応じて一度だけ実行されます。これら2つは、スケジュール、ワークスペースが発行するイベント、または接続されたリポジトリへの新しいコミットをきっかけに自律的に実行される常駐ルートを有効にします。管理パネルの「エージェント」タブに表示され、そこで有効化できるものと同じカタログです。

ツール 課金 説明
find_agent 読み取り このワークスペースで有効化できるルートのカタログを、望む結果(「ドキュメントをリポジトリと同期する」「翻訳する」「トラフィックを監視する」)から検索します。各結果には state が含まれます。これは、このワークスペースですでに有効化されているか、何を対象にしているかを示すため、「リポジトリを監視しているものはない」のか「有効化されているが、火曜日から失敗している」のかを判断できます。手作業で何かを設定する前に呼び出してください。通常、そのルートはすでに存在します。
enable_agent 書き込み find_agent のカタログから、agent_key により1つのエージェントを有効化(または無効化)します。エージェントを起動する条件は、schedule(cron式。最短では1時間ごと)、on_event(このワークスペースが発行するもの)、または watch_source_idlist_sources/connect_source にある接続済みのGitHubリポジトリ。エージェントはそこにプッシュされたコミットに対して実行されます)のいずれか1つです。リポジトリを対象に有効化すると、その現在のコミットが記録されるため、最初の実行は履歴全体の再実行ではなく、次回のプッシュ時に行われます。enabled: false は、設定内容を忘れずに無効化します。読み書きトークンが必要です。

Updated

このページは役に立ちましたか?