FAQ返信ノート：コメント用のコピペ回答
社内用 — Reddit、X、IndieHackers、Product Hunt、HackerNews、および競合他社の投稿へのコメント用のコピペ返信。
質問ごとの形式： TL;DR（1～2文、ツイートに収まる長さ）＋ 長文（スレッドやブログコメント用の3～5文）。
トーン： 正直な創業者の語り口。マーケティング上の誇張や「革新的なAI搭載プラットフォーム」といった表現は使わない。まず具体的に何ができるかを伝え、トレードオフに触れ、関連する場合はドキュメントにリンクする。
数値と事実の情報源： 料金ページとドキュメント概要。ここにある数字がそれらと食い違う場合は、そちらを優先し、このファイルを修正する。
1. 一般#
Docsbookとは？#
TL;DR: Docsbookは、公開GitHubリポジトリを数秒でドキュメントサイトに変換します。github.com/user/repoを貼り付けると、docsbook.io/user/repoにサイトが表示されます。mainへのプッシュはすべて自動的に反映されますが、Webhookではなく24時間以内にタイマーで検知されるため、「ビルドステップ不要」と表現し、「即時」とは表現しないでください。
詳細: GitHub内のMarkdownとしてドキュメントを管理したい人向けの、ホスティング型ドキュメントプラットフォームです。独自CMSにドキュメントを保存する必要はありません。設定が必要なCI/CDはなく、面倒を見続ける必要のあるdocusaurus.config.jsもありません。ドキュメントサイト、コンテンツでトレーニングされた組み込みAIチャットボット、個別のSEOインデックスに対応した15言語へのAI翻訳、完全な分析機能、そしてAIエージェントがワークスペースを管理できるMCPサーバーを利用できます。無料SSL付きのカスタムドメインはBusinessプランのアドオンです。無料プランは本当に無料で、トライアルではありません。
対象者は？#
要約：2週間かけてDocusaurusをセットアップしたり、GitBookのエディターごとのサブスクリプション料金を支払ったりせずに、本格的なドキュメントを作りたいSaaSの創業者、開発者向けツールのチーム、OSSメンテナー。
詳細：最適なのは、すでにGitHubでMarkdownを書いていて、インフラを自分たちで管理せずに、公開サイト、検索、AIチャット、翻訳、分析を利用したい小規模チームです。カスタムドメインやWebhookも必要なチームは、Businessにアップグレードしてください。テクニカルライターがいて、カスタムデザインシステムを導入している場合は、Docusaurusのほうが適しているでしょう。20人規模のドキュメントチームで、エンタープライズSSOが必要なら、GitBookが適しています。その中間にいるすべてのチームのために、Docsbookは作られています。
公開まで実際にどのくらいかかりますか？#
要約： 5〜30秒です。GitHubに接続してリポジトリを指定すれば、サイトが公開されます。ビルド手順もデプロイも不要です。
詳細： 最初の公開に最も時間がかかるのは、GitHub APIを通じてリポジトリのインデックスを作成するためです。その後は、mainへのプッシュごとに数秒以内にサイトが更新されます。GitHub Actionも、独自に管理するVercelへのデプロイも必要ありません。インデックス作成パイプラインは README.md と docs/ フォルダーを読み込み、markdown-lsp（脆弱な正規表現ではなく、unified+remarkを介してASTを扱う、当社のオープンソースLSPパーサー）で解析し、shiki + rehypeでレンダリングします。
実際にコンテンツはどこに保存されるのですか？#
要約： GitHubリポジトリ内です。Docsbookはそこから読み取りますが、書き戻すことはありません。いつでもキャンセルできます — Markdownは元の場所にそのまま残ります。
詳しく： これはベンダーロックインを避けるための仕組みです。Notion、GitBook、そして（大部分の）Mintlifyでは、コンテンツはサービス側が管理しているため、離れるにはエクスポートする必要があります。Docsbookでは、信頼できる唯一の情報源はリポジトリです。コンテンツをキャッシュしてインデックス化しますが、正式な保存先としてコンテンツを保管することはありません。ワークスペース設定（ブランディング、AI設定、ドメイン、分析）は当社のPostgresに保存されます。利用を終了すると、それらの設定は失われますが、ドキュメントは失われません。
2. 料金 & プラン#
料金はいくらですか？#
要約：料金プランは販売していません。すべてのプロジェクトにはそれぞれ残高があり、その残高はAIの利用に充てられます。サイト、ホスティング、カスタムドメイン、ページビューは無料です。現在の料金はこちらです： https://docsbook.io/pricing
詳細：GitHubリポジトリからドキュメントサイトを公開すること、ホスティングすること、SSL付きで独自ドメインから配信すること、そしてページを開くすべての読者について、残高が消費されることはありません。従量課金の対象となるのはAIです。アシスタントへの質問と翻訳の実行は、プロジェクトごとに保持される残高から、回答に使用されたモデルのプロバイダー実費に当社のマージンを加えた金額で差し引かれます。ダッシュボードにはモデル、その料金、マージンが表示されるため、差し引き額を確認できます。請求は座席単位ではなくアカウント単位なので、誤字を修正するかもしれない同僚の分まで支払う必要はありません。私から料金を引用しないでください。https://docsbook.io/pricingはリクエストのたびに最新の料金定数から生成されるため、開いた時点で正確な料金が表示されます。
無料プランはトライアルですか？#
要約: トライアルはありません。試す対象となる有料プランがないためです。カスタムブランディング、ナビゲーション、テーマ、フォント、独自ドメイン、SSLを備えた実際の公開ドキュメントサイトを運用でき、料金は一切かかりません。残高を消費するのはAIの利用だけです。
詳しく: 私（Dan）は、OSSメンテナーやインディーハッカーに料金のことをまったく考えずに使ってほしかったので、サイト自体には料金を設定していません。費用がかかるのは、私たちにもコストが発生するもの、つまりLLMの推論です。リポジトリが公開されていて、独自ドメインの優れたドキュメントサイトが欲しいのであれば、購入するものは何もありません。アシスタントや翻訳を使い始めたときに、残高が重要になります。
Proはなぜ買い切りではなくサブスクリプションなのですか？#
要約：以前は一度きりの買い切りPROプランを販売していましたが、現在は提供しておらず、既存の買い切りプランのお客様には引き続きその権利が適用されます。代わりに従量課金制を採用したのは、AIチャットや翻訳には継続的な推論コストがかかり、定額の買い切り価格ではその費用をまかなえないためです。
詳細：定額の買い切り価格では、ワークスペースが実際に使用するLLMの推論量に応じて拡張できませんでした。1人のヘビーユーザーが、最初に支払った金額を1か月で上回るコストを発生させる可能性もあります。そのため現在のモデルでは、AIの使用量に対して正確に料金を請求します。料金はプロジェクトごとの残高に基づいて計測され、サイト自体は無料です。変更前に従来の一度きりの買い切りPROを購入した場合は、追加料金なしで元の機能を引き続き利用できます。このプランは終了しており、現在は販売していません。
AIリクエストの制限を超えるとどうなりますか？#
要約: プロジェクトの残高がなくなるとAIの利用は停止します。入金した金額を超えて請求されることはありません。さらに利用したい場合は、必要なときに残高を追加できます。また、ご自身のOpenAI / Anthropic / Gemini / OpenRouterのキーを使用して、プロバイダーに直接支払うこともできます。
詳細: 各プロジェクトには固有の残高があり、AIを呼び出すたびに、モデルの実際の料金に当社のマークアップを加えた金額が残高から差し引かれます。どちらもダッシュボードに表示されます。残高がゼロになると、追加請求されることなくアシスタントは回答を停止します。超過料金や予期しない請求書はありません。プロジェクトに残高を追加すると、利用が再開されます。また、AI設定にご自身のAPIキーを登録して、プロバイダー経由でリクエストを送信することもできます。その場合、当社が料金を計測することは一切ありません。現在の料金: https://docsbook.io/pricing
返金ポリシーはありますか？#
要約: はい — 30日以内に（dan@docsbook.io）までメールをお送りください。理由は問いません。Paddleを通じて全額返金します。
詳細: どの1件の販売よりも、信頼のほうが大切です。Docsbookがワークフローに合わないと分かった場合、不満を抱えたお客様に利用を勧めないと言われるより、返金したいと考えています。返金手続きはPaddleが処理し、通常は数営業日で完了します。
3. 競合他社#
GitBookとはどう違いますか？#
要約：結果（ホスティングされたドキュメントサイト）は同じですが、料金体系はまったく異なります — GitBookはサイト単位および編集者単位で課金しますが、当社はAIの利用に対してのみ課金し、サイト自体には料金がかかりません — そしてコンテンツはあなたのGitHubリポジトリに残ります。
詳細：GitBookの料金には、サイト単位の料金と、コンテンツを編集するすべてのユーザーに対するユーザー単位の料金という、2つの軸があります。2026-09-03時点で、料金ページにはFreeがサイトあたり月額$0（ユーザー1人）、Premiumがサイトあたり月額$65に加えてユーザー1人あたり月額$12、Ultimateがサイトあたり月額$249に加えてユーザー1人あたり月額$12と記載されていました — 最新の料金についてはhttps://www.gitbook.com/pricingを確認してください。コンテンツはGitBookのCMSに保存されるため、離れる場合はエクスポートが必要です。当社では、編集する人数にかかわらずサイトの料金はかからず、AIの利用量はプロジェクトごとの残高に対して計測され、MarkdownがGitHubリポジトリの外に出ることはありません。トレードオフがないわけではありません。GitBookにはより高機能なWYSIWYGエディターがありますが、当社にはありません — Markdownを記述します。
これはDocusaurusとどう違いますか？#
要約： Docusaurusは、自分でホスティングするReactフレームワークです。Docsbookはホスティング型の製品です。セットアップとNode.jsアプリの継続的なメンテナンスに2〜3日かかるのに対し、30秒で利用できます。
詳しく： Docusaurusは、完全な制御が必要で、ビルドパイプライン、プラグイン、テーマのオーバーライド、デプロイ先の管理を楽しめるチームがいる場合に最適です。Docsbookは、フレームワークを管理せずにドキュメントサイトを利用したい人向けです。また、Docusaurusでは別途プラグインやサービスが必要になる検索、AIチャット、翻訳、アナリティクスもまとめて提供しています。すでにDocusaurusを導入しているなら、移行する必要はありません。問題なく動作します。今日から始める場合で、フレームワークレベルのカスタマイズが必要ないなら、Docsbookなら数秒で利用を開始できます。
これはMintlifyとどう違いますか？#
要約：機能セット（ホスティングされたドキュメント、AI）は同程度ですが、Mintlifyではその構成上、MDXの使用を促されます。Docsbookは任意のGitHubリポジトリからプレーンなMarkdownを読み込み、一般的により低コストです。
詳しく：Mintlifyは優れています。デザインもよく、マーケティングも巧みです。私たちとの違いは次のとおりです。(1) README.mdまたはdocs/にMarkdownが含まれている公開GitHubリポジトリであれば、プロジェクト固有の設定なしで利用できます。(2) Mintlifyが月額プランを提供するのに対し、私たちはAIの使用量をプロジェクトごとの残高に対して従量計上し、サイト自体には料金を請求しません。https://mintlify.com/pricingとhttps://docsbook.io/pricingを比較してください。(3) 完全なMCPサーバーを公開しているため、AIエージェントがワークスペースをプログラムから管理できます。ドキュメントグラフの読み取り、シンボルによる検索、ブランディングの変更などが可能です。Mintlifyの中核となるドキュメント体験は、初期状態ではより洗練されています。一方、Docsbookはカスタマイズするほどその差が縮まります。
Notionとの違いは何ですか？#
TL;DR: Notionは社内Wikiには最適です。公開ドキュメントには不向きです — 本格的なSEOがなく、コンテンツを学習したAIチャットもなく、ほとんどのプランでカスタムドメインを利用できず、Googleにもドキュメントサイトと同じようにはインデックスされません。
詳細: Notionを「ドキュメント」として使い、その後、なぜ誰にも見つけてもらえないのか疑問に思っているチームをよく見かけます。Notionのページはドキュメントとして構造化されておらず（SEOに適した適切な見出し階層がなく）、sitemap.xml を公開せず、訪問者向けの組み込みAIチャットもなく、AIエージェント向けの llms.txt も生成しません。Docsbookは、Google、ChatGPT、Perplexityに見つけてもらう必要があるドキュメントのために特別に構築されています。Notionは社内Wikiとして使い続け、公開ドキュメントはそのために作られた場所に置きましょう。
Readme.ioとの違いは何ですか？#
要約： Readme.ioはAPIドキュメントに特化しており、プランに加えてAIを有料アドオンとして提供しています（2026-09-03時点で、同社のページにはStarterが月額$0、Proが年払いで月額$250、「Ask AI」が月額$150と記載されていました — https://readme.com/pricingを参照）。Docsbookはより幅広く、あらゆるGitHubリポジトリのあらゆるドキュメントに対応し、AIはプランとして販売するのではなく、使用量に応じて課金されます。
詳細： OpenAPI仕様があり、「今すぐ試す」機能を備えた洗練されたAPIリファレンスが必要なら、Readme.ioはまさにそのために作られており、優れた機能を提供します。Docsbookはより汎用的なドキュメントプラットフォームで、ガイド、リファレンス、ブログ記事など、Markdownで記述できるあらゆるものに対応します。両方が必要な場合、多くのチームがAPIリファレンスにはReadme.ioを、より幅広いドキュメントサイトにはDocsbookを利用しています。
4. AIチャット & 翻訳#
AIチャットはどのように機能しますか？#
要約： あなたのドキュメントのみを使ってトレーニングされており、オープンウェブは対象外です。訪問者が質問すると、ドキュメントのページを引用して回答します。
詳細： 流れは検索 → 読み取り → 回答です。チャットボットはインデックス化されたドキュメントグラフから関連セクションを取得し、LLMで回答を生成して、参照したページを引用します。候補の質問、システムプロンプト、LLMの前処理／後処理フック、モデルプロバイダー（デフォルトではOpenRouter openai/gpt-4o-miniを使用しますが、独自のOpenAI／Anthropic／Geminiキーを接続できます）を設定できます。ストリーミング応答、詳細な使用状況分析、そしてユーザーが実際に何を質問しているかを確認できるget_ai_questions MCPツールも利用できます。
どのAIプロバイダーを利用できますか？#
要約: OpenRouter（デフォルト）、OpenAI、Anthropic、Gemini。独自のAPIキーを使用でき、プロバイダーがサポートする任意のモデルを選択できます。
詳細: デフォルトは、openai/gpt-4o-mini を使用するOpenRouterです。料金が安く、ほとんどのドキュメントのQ&Aには十分だからです。AI設定のワークスペースレベルで上書きできます。キーを貼り付け、モデルを選択すれば完了です。独自のキーを使用したリクエストは、月間上限にカウントされません。コンプライアンス上必要な場合に、プライベートまたは専用のデプロイメントへルーティングする方法もこれです。
AI翻訳はどのように機能しますか？#
要約：15言語（EN、ES、FR、DE、PT、IT、RU、ZH、JA、KO、AR、HI、TR、PL、NL）に対応しています。翻訳版はそれぞれ個別のページとしてGoogleにインデックスされ、適切なhreflangが設定されます。
詳細：ワークスペースで言語を有効にすると、Docsbookが翻訳を生成し、翻訳版はdocsbook.io/[owner]/[repo]/[lang]/...に実際のページとして作成されます。Googleは各言語をインデックス可能な個別のURLとして扱うため、市場ごとに個別のSEO効果を得られます。サイドバーまたはヘッダー（設定可能）には言語切り替え機能があり、francを使用して訪問者の言語を自動検出します。Businessプランでは、Proプランよりも月間翻訳上限が高く設定されています。独自の翻訳ワークフローがある場合は、翻訳モードをexternalに設定し、MCPツールまたはWebhook経由で翻訳を送信してください。
公開前に翻訳を確認できますか？#
要約: はい — Pro と Business では承認待ちキューを利用できます。翻訳は下書きとして登録され、MCP（approve_translation）またはダッシュボードから承認すると公開されます。
詳細: これは、チームにネイティブスピーカーがいて、リリース前に内容を確認したい言語で役立ちます。list_pending_translations と get_translation の MCP ツールもあり、エージェントが下書きを事前にチェックし、問題がありそうなものだけを提示できます。
5. SEO & AI ディスカバリー#
Docsbook は llms.txt を生成しますか？#
要約: はい。すべてのワークスペースに /llms.txt と /llms-full.txt が自動的に生成され、何も有効化する必要はありません。プラットフォームレベルでも同様に、docsbook.io/llms.txt が生成されます。
詳細: llms.txt は、AIエージェント（Perplexity、ChatGPT Search、Cursor、Cline）にサイトの内容と構造を伝えるための新たな標準です。Docsbookでは、ドキュメントグラフから、タイトルと説明を含むページ一覧を、AIクライアントが実際に解析できる形式で生成します。llms-full.txt は、それに完全なコンテンツを加えたものです。どちらも設定不要で動作し、ワークスペースがインデックス化された時点で存在します。その後、アシスタントがあなたのサイトを引用するかどうかは、ファイルではなくコンテンツに左右されます。どのプラットフォームも引用を保証できず、私たちも保証しません。
通常のSEOはどうなりますか？#
要約：組み込み済みです。メタタグ、OpenGraph、sitemap.xml、JSON-LD（WebSite、Organization、SoftwareApplication、FAQPage）、canonical URL、言語ごとの個別インデックス登録がすべて標準搭載されており、有効化も追加料金も必要ありません。
詳細：各ページには適切な <title>、<meta description>、OpenGraph画像、構造化データ用のJSON-LDブロックが設定されます。サイトマップは自動生成され、更新時にはGoogleに通知されます。翻訳ページはhreflangで公開されます。カスタムドメインとSEO設定により、DocsbookのサイトはGoogleからSPAではなく、本格的なドキュメントサイトとして認識されます。これが、公開ドキュメントにNotionではなく当社を選ぶチームが多い主な理由です。
AI検索エンジンは実際に私のドキュメントを引用するのでしょうか？#
要約: 場合によります。それ以上のことは誰にも保証できません。Docsbookは、サーバーでレンダリングされたHTML、クリーンな見出し、サイトマップ、llms.txt、クローラーのアクセスといった機械的な障害を取り除きます。ただし、エンジンがあなたを引用するかどうかは、コンテンツとエンジン次第であり、同じプロンプトでも実行するたびに異なるソースが返されます。
詳細: AI検索で引用されるには、(1) インデックス可能であること（これは私たちが対応します）、(2) モデルが具体的な主張を抽出できるよう構造化されていること（見出しの階層、コードブロック、リストなど。あなたのMarkdownはすでにこれを実現しています）、(3) llms.txt があること（これは私たちが生成します）、(4) そのトピックについて権威性があること（これはあなた自身と、あなたの書き方次第です）が必要です。技術面では、Docsbookが通常の障害を取り除きます。あなたのリポジトリを直接操作するエージェント向けには、markdown-lsp がLSPスタイルのナビゲーション（doc_outline、doc_search_symbols、doc_resolve_link など）を追加するため、生のHTMLを丸ごと読み込むのではなく、正確にナビゲートできます。
6. テクノロジー & 統合#
Docsbookはどのような技術スタックで動作していますか？#
要約：Vercel上のNext.js 16、Neon上のPostgreSQL、Redisキャッシュ、Drizzle ORMを使用しています。AIにはOpenRouter/OpenAI/Anthropic/Geminiを利用しています。シンプルで、高速で、スケールします。
詳細：フロントエンドはNext.js 16 App Router + React 19 + Tailwind 4 + shadcn/uiです。認証はGitHub OAuthを使用するnext-auth v5です。データベースはDrizzleマイグレーションを使用するNeonのサーバーレスPostgresです。Markdownパイプラインはunified + remark-parse + remark-gfm + remark-rehype + rehype-pretty-code + shikiです。MCPサーバーは完全なOAuth 2.0を備えた@modelcontextprotocol/sdk 1.29です。ホスティングはカスタムドメインを含むVercelで、請求にはPaddle、アナリティクスにはAxiomを使用しています。
プライベートリポジトリでも利用できますか？#
要約: パブリックリポジトリはそのまま利用できます。プライベートリポジトリは、認証済みのGitHub OAuthを通じてアクセスします。同じフローで、特定のリポジトリへの読み取りアクセス権を使用します。
詳細: GitHubを接続すると、インデックス化するリポジトリへのアクセスを許可します。OSSプロジェクトの場合は、追加のスコープを必要としないパブリックリポジトリのフローを使用します。プライベートリポジトリの場合は、GitHub Appを通じて特定のリポジトリを承認し、ユーザーのトークンを使って読み取ります。コンテンツを権威ある形で保存することはありません。保存するのはインデックス化されたグラフとキャッシュのみで、これらはいつでも無効化できます。
カスタムドメインを使用できますか？#
TL;DR: はい、Businessプランで利用できます。CNAMEをDocsbookに向けると、SSL証明書はこちらでプロビジョニングされ、完了です。docs.yourcompany.com は数分で機能します。
詳細: カスタムドメインはVercelのドメインAPI経由で処理されます。ワークスペースのダッシュボードまたは update_domain MCPツールを使用して docs.yourcompany.com を追加し、DNSプロバイダーでCNAMEを設定すると、VercelがSSL証明書を自動的に発行します。また、/docs-proxy/[[...path]]/ 経由でもプロキシするため、URLをすっきり保ち、アナリティクスも引き続き機能します。
MCPサーバーはありますか？#
要約: はい — ワークスペース管理、ブランディング、分析、Webhook、翻訳のためのツールを備えた、完全なOAuth 2.0 MCPサーバーがhttps://docsbook.io/api/mcp/serverにあります。サーバーは接続時に独自のツール一覧を返すため、私からツール数を引用しないでください。ドキュメントグラフ検索には、ホステッドMCPではなく、ローカルでmarkdown-lspを使用してください。
詳細: claude mcp add --transport http https://docsbook.io/api/mcp/serverでホステッドMCPに接続します。OAuth後、エージェントはワークスペース管理（作成、ブランディング、UI）、AIチャット（システムプロンプト、フック）、翻訳（承認、アップロード、削除）、分析（質問、未回答、検索失敗）、Webhook（登録、一覧表示、再実行）にわたるツールを利用できます。LSPスタイルのドキュメントグラフ操作（アウトライン、シンボル検索、リンク解決、参照）には、代わりにローカルでmarkdown-lsp（npx markdown-lsp <subcommand> ./docs）を使用してください。これはディスク上のリポジトリを解析するため、ネットワーク経由で実行するよりも高速で低コストです。
7. セキュリティ、プライバシー & ロックイン#
解約するとデータはどうなりますか？#
要約： MarkdownはGitHubリポジトリに残ります。ご依頼に応じて、ワークスペースの設定（ブランディング、AI設定、アナリティクス）を削除します。「エクスポート」は必要ありません。コンテンツはそもそも私たちのものではなかったからです。
詳細： これがGitBookやNotionとの構造的な違いです。これらのサービスでは、解約するとコンテンツを取り戻すためにエクスポートの手順を踏む必要があります。Docsbookでは、コンテンツは常にリポジトリ内にあるため、ワークスペースとの接続を解除しても、リポジトリは変更されません。私たちが保持しているのはPostgres内のワークスペースメタデータ（料金をお支払いいただいている対象です）と、Axiom内のアナリティクスイベントであり、いずれもご依頼に応じて削除します。
データはどこでホスティングされていますか？#
要約: Vercel（グローバルエッジ）、Neon Postgres（US/EUリージョン）、Redisキャッシュ、ログにはAxiomを使用しています。すべてUS/EUのインフラストラクチャです。
詳細: 標準的なホスティング型SaaSインフラストラクチャです。VercelがHTTPとCDNをグローバルに処理します。NeonはサーバーレスPostgresで、デフォルトのリージョンで運用し、ポイントインタイムリカバリを利用しています。Redisはスキルインデックスのキャッシュに使用しています。ログと分析データはAxiomに送信されます。コンプライアンス上、特定のリージョンに関するコミットメントが必要な場合は、私にご相談ください — 現時点では標準のVercel/Neonフットプリントにデプロイしています。
ソースは公開されていますか？#
要約：Docsbook自体はクローズドソースです。markdown-lsp（パーサー）とdocs-skills（AIスキルカタログ）は、GitHubでオープンソースとして公開されています。
詳細：プラットフォームはクローズドですが、より広いエコシステムに役立つ部分はOSSとして公開しています。markdown-lspは、Markdownを構造化されたドキュメントグラフに変換するLSPスタイルのパーサーです。ローカルのドキュメントグラフ検索を支えており、ドキュメントツールを構築する誰にとっても役立ちます。docs-skillsは、AIエージェント向けの25個のSKILL.mdファイル（docs-analyze、docs-seoなど）からなる公開カタログです。Docsbook MCPと連携して動作するほか、単独でも使用できます。
8. 異議と反発#
「なぜDocusaurusをそのまま使わないのですか？無料ですよね？」#
要約: Docusaurusは金銭的には無料ですが、時間は無料ではありません。セットアップに2日かかり、さらにNode.jsアプリを継続的に保守する必要があります。自分の作業時間を請求するなら、その瞬間から実際のコストになります。自分の単価で計算してみてください。
詳細: Docusaurusは優れたツールであり、完全な制御を求めるチームにはおすすめです。しかし「無料」なのはフレームワークだけです。ホスティング、ビルドの保守、依存関係の管理、検索サービス（Algolia $$$）の追加、アナリティクスの追加、AIチャット（カスタム）の追加、i18n（カスタム）の追加などが必要になります。1年間の総所有コストは無視できません。Docsbookは、セットアップ時間と組み込み機能の代わりにカスタマイズの上限を受け入れるという選択肢です。どちらも有効な選択です。
「ドキュメントサイトにお金を払うのは高く感じます。」#
要約: 他の選択肢と比較してみてください — GitBook、Mintlify、Readme.ioはいずれも、同等の機能セットであればこれよりかなり高い価格から始まります。無料プランでも、AIを必要としない実際の公開ドキュメントサイトを利用できます。
詳細: 一見するとそのように感じるのは理解できますが、私たちの価格体系は他社とは異なります。GitBook、Mintlify、Readmeはいずれもプラン制で販売しています — 固定の月額サブスクリプションに加え、GitBookではユーザーごとの料金も発生します。私たちはプラン制を一切採用していません。各プロジェクトにそれぞれ残高があり、その残高はAIの利用に応じて消費されます。サイトの公開、ホスティング、カスタムドメイン、そして読者が開くすべてのページによって残高が消費されることはありません。したがって、ブランディング付きでAIを使わない公開ドキュメントサイトが必要な場合、支払う料金はありません。現在の料金はhttps://docsbook.io/pricingで確認できます。このページはリクエストごとに最新の料金定数から生成されるため、私から聞いた価格ではなく、そちらに掲載されている価格を引用してください。
「なぜGitHubのみ？ソースがGitLab/Bitbucketにある場合は？」#
要約：現在はGitHubのみです。GitLabとBitbucketへの対応はロードマップにありますが、すぐではありません。現在対応が必要な場合は、メールでご連絡ください。それが優先順位付けに役立ちます。
詳細：率直に言うと、私たちが対象としているOSSおよび開発ツールのプロジェクトの圧倒的多数は、実際にGitHubでコードを管理しています。また、3つのプロバイダーを浅くサポートするよりも、1つのプロバイダーを深くサポートする方がよいと考えています。GitLabのAPIは似ているため、対応できる可能性はありますが、Bitbucketはより困難です。GitLabへの対応が実現につながるのであれば、お知らせください。リストを管理しており、それによって機能の優先順位が上がります。
「GitHubがネイティブのドキュメントホスティングを追加したら、これが潰されないと言えるのはなぜですか？」#
要約: GitHubにはすでにPagesとWikiがありますが、どちらも本格的なドキュメントプラットフォームではありません。仮にGitHubがそのようなものを提供したとしても、AIチャット、翻訳、分析、MCP、カスタムドメインが差別化要因になります。
詳細: GitHub Pagesは10年前から存在していますが、今でもDocusaurus、GitBook、Mintlify、Readme.ioを使う人がいます。なぜでしょうか？「リポジトリから静的HTMLをホスティングすること」は簡単な部分だからです — 難しいのは、検索、AI、i18n、SEO、分析、カスタムドメインのUX、ダッシュボード、そして技術者ではない購入者向けの請求処理です。リスクはGitHubがドキュメントホスティングを追加することではありません。既存プレイヤーのいずれかが、AIとGitHubネイティブのアプローチをよりうまく実現することがリスクです。私たちはそこを自らに課す基準としています。
「良さそうですが、1人企業にドキュメントを預けるのは信用できません」#
要約：もっともです。コンテンツは当社のデータベースではなく、あなたのGitHubリポジトリにあります。つまり最悪の場合（当社が消滅した場合）でも、失うのはホストされたサイトであって、ドキュメントではありません。1日でDocusaurusに移行できます。
詳しく：これは「Docsbookがなくなったらどうなるのか」という疑問への本当の答えです。Markdownはあなたのリポジトリにあります。ワークスペースの設定は復元可能です（MCPとAPI経由で公開しています）。サイトのURLは機能しなくなりますが、コンテンツはそのまま残ります。GitBookやNotionでは、サービスの変更や乗り換えがエクスポートの苦痛につながるのと比較してみてください。ロックインに関するこの構造的な違いこそが、コンテンツを所有する競合サービスよりも、ここでは小規模ベンダーのリスクが低い理由です。
このノートブックを最新の状態に保つ方法#
難しいのはFAQを一度書くことではなく、製品の変化や実際の会話から寄せられる新しい質問に合わせて、正確な状態を保ち続けることです。Danが設定できる具体的な方法：
本番環境から実際の質問を自動取得#
- すでに利用できるMCPツール:
get_ai_questions、get_ai_unanswered、get_failed_searches、get_popular_searches、get_negative_feedback。毎週のcronを実行して、docsbook.ioワークスペース自体からこれらを取得します（自社のドキュメントサイトもDocsbook上にあるため）。これにより、サイトを訪れたユーザーが実際に尋ねたものの、AIが回答できなかった質問が明らかになります。これは、新しいFAQ項目を作成するための最も有力な情報源です。 - スクリプト:
scripts/faq-collect.ts— これらのMCPツールを呼び出し、このファイル内の既存の質問と重複しないよう整理して、Slack/Notionにダイジェストを投稿します。
ソーシャルチャネルから収集（MCPアクセスが必要）#
- Reddit MCP — 「GitBook」、「Docusaurus」、「Mintlify」、「docs hosting」について言及している
r/SaaS、r/devops、r/programmingのコメントを読む。既存のオーディエンス以外から寄せられた、実際の質問。 - X/Twitter MCP — 同様に、競合他社や「docs site」について言及しているツイートを対象とする。
- Discord/Slack — インスタンスがある場合は、サポートに関する質問を掘り起こす。まだ存在しない。
- HackerNews — Algolia HN APIは公開されているため、MCPは不要。50行のスクリプトで、Docsbookや競合他社に関するすべての言及を検出できる。
comment-replyスキルを構築#
.claude/skills/comment-reply/SKILL.mdは次の処理を行います：
- 入力を受け取る：コメント本文 + 対象プラットフォーム（Reddit / X / HN / IH）。
- 一致するFAQエントリ（または「該当なし」）を分類する。
- X/HN系プラットフォームにはTL;DRを、Reddit/IHには長文版を、プラットフォームに適した形式で返す。
- 一致しない場合は、新しいエントリを下書きし、このファイルへの追記を提案する。
CLIエイリアスとして便利です：claude comment-reply "<paste comment here>" --platform reddit。
update-faqスキルを構築する#
毎週実行するスキルで、以下を行います：
get_ai_questions/get_failed_searchesを使用して新しい質問を取得します。- このファイルとの差分を確認します。
- 類似する未回答の質問が3件を超える各クラスターについて、このファイルの形式で新しいFAQエントリを作成し、PRを作成します。
- README.md の数値がここで引用されている内容とずれているエントリにもフラグを付けます。
手動メンテナンスチェックリスト（その間）#
- 価格を変更するリリースごと → セクション2を更新する。
- 世間で新たに競合他社への言及があるたびに → セクション3への追加を検討する。
- 四半期ごと → README.mdの数値と、ここで引用している数値を照合する。
- 新しいMCPツールが追加されるたびに → セクション6または「これを最新の状態に保つ方法」で参照する。