Docsbookが機械に引用されるドキュメントを公開する方法
Docsbookは、GitHubリポジトリ、ウェブサイトのスキャン、または作成した概要からMarkdownを公開し、docsbook.io/{owner}/{repo} にライブサイトとして提供するドキュメントプラットフォームです。このページを読めば、Docsbookが自社のプロダクトに適しているか、そして3つの役割のうちどれを最初に必要としているかを判断できます。3つの役割とは、検索する人々にリーチすること、AIアシスタントがあなたについて引用できる事実を提供すること、そしてページがもたらした成果を測定することです。
プロダクト、顧客、広告予算がある企業の多くは、それでもGoogleやAIアシスタントに推薦されることがありません。読むべきものが存在しないからです。存在する情報が古い、ログインの背後に隠れている、またはプロダクトと食い違っているのです。Docsbookは、すでに書かれているものを機械が読み取る場所に公開し、どれだけの読者をもたらしたかを示します。
リポジトリと公開ページの間で起こること#
| ステージ | Docsbook が行うこと | 得られるもの |
|---|---|---|
| 1. ソースを接続 | GitHub リポジトリを読み取り、ウェブサイトをスキャンするか、製品についての一文から下書きを作成します | サインイン前に開ける下書きサイト |
| 2. インデックス化 | Markdown と frontmatter を解析し、見出し、リンク、メタデータを抽出して、ナビゲーション可能なグラフを構築します | 全文検索、ページごとのアウトライン、ファイル間リンクの解決 |
| 3. 公開 | サーバー上でレンダリングされたサイトを docsbook.io/{owner}/{repo} で提供します |
sitemap、OpenGraph、JSON-LD を備えた公開 URL |
| 4. マシンに公開 | llms.txt と 309 個のツールを備えた MCP サーバーを提供します |
アシスタントやエージェントがドキュメントを読み取り、エージェントが編集できます |
| 5. 同期 | サイトへのアクセス時に GitHub を再確認し、変更された内容を再インデックス化します | ビルド手順や CI パイプラインなしで、ページがリポジトリと一致します |
| 6. 測定 | ページビュー、検索、イベント、フィードバック、AI の利用状況を記録します | どのページが読まれ、読者がどこで離脱するかに関するレポート |
リーチ：顧客が尋ねる各質問に1ページ#
1つの狭い質問に答えるドキュメントページは、ランディングページよりも少ない労力で作成でき、質問が廃れることがないため、何年にもわたって検索トラフィックを獲得し続けます。Docsbookでは、各ページに固有のURL、固有のタイトルと説明、sitemap.xml内の固有のエントリ、そして固有のJSON-LDが付与されます。これにより、ある1つの質問についてのページがマーケティングサイトの中に埋もれるのではなく、その質問自体で競争できます。
Docsbookは、これに必要な機械可読な要素を自動的に生成します。メタタグ、sitemap.xml、OpenGraph、正規URL、そしてFAQおよびHowToコンテンツ用のJSON-LDです。検索エンジン向けの要素についてはSEOを、生成エンジン向けの要素についてはGEOをご覧ください。
機械可読な事実：アシスタントがあなたについて引用する内容#
商品を推奨するAIアシスタントは、低コストで読み取り、検証できる情報、つまり価格、制限事項、その商品ができないこと、そして企業が何者であるかを引用します。ドキュメントに何も書かれていない場合、アシスタントはその空白を競合他社のページで埋めます。ここでのDocsbookの役割は、これらの事実を読み取り可能にすることです。つまり、サーバー上でHTMLとしてレンダリングし、llms.txtとして提供し、MCPサーバーとして公開します。
この役割を果たす3つの提供形態があります：
llms.txt— サイトのルートにあるドキュメントのプレーンテキストインデックスです。これを探すAIエージェント向けです。llms.txtを参照してください。- MCPサーバー — Model Context Protocol上で309個のツールを提供し、Claude Code、Cursor、ChatGPTがページを読み取り、検索し、変更をコミットして戻せるようにします。MCPサーバーを参照してください。
- AEOマークアップ — Markdownから生成されたFAQPage、HowTo、speakableのJSON-LDで、アンサーボックスや音声アシスタント向けです。AEOを参照してください。
分析：どのページが読まれ、読者がどこで離脱するか#
Docsbookは、ドキュメント上のすべてのページビュー、検索クエリ、フィードバック投票、追跡対象イベントを記録し、ページごとにレポートします。これにより、マーケターがドキュメントサイトについて尋ねる次のような疑問に答えられます。誰も訪れないページはどれか、結果が何も返されない検索はどれか、読者は離脱するまでにどこまで読むのか、そしてどの国や言語から訪れているのか。
イベント、目標、ファネルを使うと、ドキュメント内の経路を設定し、何人の読者が完了したかを数えられます。測定対象については追跡の概要を、イベントカタログについてはイベントをご覧ください。
Docsbookの対象者#
| 読者 | 購入するもの |
|---|---|
| 創業者 | 顧客からの質問に対するChatGPT、Perplexity、Googleの回答に自社製品が表示されること |
| マーケター | チャネルとしてのドキュメント：ボタンを押す前にコンバージョンを可視化し、目標とファネルを把握し、行き止まりのページを特定できること |
| エンジニアまたはプロダクトマネージャー | リポジトリから数秒でサイトを作成し、GitHubを信頼できる情報源とし、Claude CodeからMCPを利用し、ワンクリックでエクスポートできること |
Docsbookが対応していないこと#
Docsbookは、SAML SSO、ロールベースのアクセス制御を備えたチームアカウント、SOC 2 Type IIレポート、またはデータ処理契約を提供していません。これら4つはすべてコンプライアンス対応のロードマップに含まれており、まだ提供されていません。技術者ではない執筆者向けのWYSIWYGエディターはありません。ページはMarkdownファイルであり、ウェブエディター、GitHub、またはMCP経由のエージェントで編集します。現在のコンプライアンス対応状況については、MCPセキュリティを参照してください。
Docsbookの動作基盤#
DocsbookはVercel上で動作するNext.js 16およびReact 19のアプリケーションで、バックエンドにPostgres（Neon）とRedisを備え、ORMにはDrizzle、販売主体にはPaddleを使用しています。Markdownの解析にはunified、remark、rehypeを使用し、Shikiでシンタックスハイライトを適用し、Docsbookのオープンソースドキュメントパーサーであるmarkdown-lspでナビゲーションを実現しています。AIへの呼び出しはOpenRouter経由、またはご自身のプロバイダーキー経由でルーティングされます。
料金#
Docsbookでは、各プロジェクト固有の残高に対して、次の4項目のみが計測されます。
- 読者（AIチャット） — ドキュメントの読者に提供されるAIの回答。
- 管理者 & AIエージェント — あなたまたは接続されたエージェントが開始したエージェントの実行。
- AI翻訳 — ページを別の言語に翻訳すること。
- セマンティックインデックス — AIチャットが検索する埋め込みを構築すること。
ホスティング、カスタムドメインとそのTLS証明書、読者、編集者、GitHub同期、全文検索、ブランディング、分析には使用量の計測はありません。新しいプロジェクトにはすべて$1.00の残高が付与され、作成から3分経過するとさらに$5.00を請求できます。その後のチャージ額は$20.00から$5,000.00までです。仕組みについては料金を、現在の金額についてはdocsbook.io/pricingをご覧ください。
次のステップ#
- クイックスタート — ソースから公開 URL まで、ドキュメントサイトを公開する
- 概念 — ワークスペース、プロジェクトの残高、インデックス作成、その他ここで使われる用語
- 利用例 — チームがドキュメントを依頼する用途
- FAQ — 同期、プライバシー、データ所有権、請求に関する質問