Docsbook FAQ：料金、制限、同期、データ所有権

質問は、意思決定をどれだけ早く妨げるかの順に並べています。まず料金、次に始め方、そして運用開始後の製品の動作についてです。

料金と請求#

Docsbookの料金はいくらですか？#

Docsbookでは、4つの項目について、すべてAIによる処理として、処理を依頼したプロジェクトの残高から料金が差し引かれます。

• Readers (AI Chat) — ドキュメントの読者に提供されるAIの回答。
• Admin & AI Agent — あなたまたは接続されたエージェントが開始したエージェントの実行。
• AI Translations — ページを別の言語に翻訳する処理。
• Semantic Index — AIチャットが検索する埋め込みを構築する処理。

それ以外はすべて従量課金の対象外です。サイトのホスティング、カスタムドメインとそのTLS証明書、読者による閲覧、編集者による執筆、GitHub同期、全文検索、ブランディング、アナリティクス、MCPの読み取り呼び出しが含まれます。最新の料金情報はdocsbook.io/pricingで確認できます。このページはリクエストのたびにDocsbookの請求定数から生成されるため、古くなる可能性のあるドキュメントページではなく、こちらに記載された料金を確認してください。仕組みについては料金をご覧ください。

Docsbookを無料で試す方法はありますか？#

はい。下書きサイトの生成にはアカウントもクレジットカードも必要ありません。リポジトリ、ウェブサイトのURL、または製品についての説明文をdocsbook.io/startに入力すると、サインインする前に結果を確認できます。その後、新しいプロジェクトには$1.00の残高が付与され、プロジェクト作成から3分経過すると、さらに$5.00を請求できます。どちらもAIによる作業に実際に使えるクレジットです。

利用を開始するにはどうすればよく、チャージ料金はいくらですか？#

Docsbookプロジェクトに最初から付与されている$1.00は、すぐに利用できます。AIチャットで質問すると、残高が動くことを確認できます。プロジェクトの作成から3分経過したら、プロジェクトの請求カードで受け取るを押して$5.00のウェルカムクレジットを追加してください。自動的に追加されることはありません。

その後は、チャージ額を自分で指定します。1回のチャージで指定できる最小額は$20.00、最大額は$5,000.00です。それ以上必要な場合は、2回に分けてチャージしてください。入金額は、選択した1つのプロジェクトの残高に追加されます。スケジュールに従って自動的に補充されることはありません。定期的な金額を設定したい場合は、請求画面で月次支払いを設定してください。

プロジェクトの残高がなくなるとどうなりますか？#

ドキュメントサイトはオンラインのままです。読者は引き続き閲覧でき、全文検索も引き続き機能し、GitHub との同期も実行され続け、何も削除されません。停止するのは従量制の AI 処理です。呼び出しは実行前に拒否され、どのプロジェクトの残高がなくなったのか、その呼び出しにかかるはずだった費用、残っている金額、そしてそのプロジェクトに残高を追加する場所が拒否メッセージに示されます。

MCP 経由の無料の探索呼び出しは引き続き機能するため、エージェントは何も通知せずに失敗するのではなく、何が起きたのかを報告できます。

支払いを停止できますか？その場合、ドキュメントサイトはどうなりますか？#

キャンセルするものはありません。必要なときにプロジェクトの残高を追加し、停止する場合はそれ以上追加しないだけです。ドキュメントサイトは docsbook.io/{owner}/{repo} で引き続きオンラインになり、Markdown はご自身の GitHub リポジトリに残り、設定（ブランディング、ナビゲーション、レイアウト）も保持されます。何も削除されません。

ご自身で毎月の定期支払いを設定している場合は、docsbook.io/chat の請求画面から終了できます。

ファイルは自分の所有物のままですか？#

はい。Markdown は常にご自身の GitHub リポジトリに保存されます。Docsbook はそれらのファイルをレンダリングするだけで、コンテンツを独自形式で保存することはなく、先にエクスポートする必要もありません。同じリポジトリを別のドキュメントツールに指定すれば、すべてのページ、画像、リンクをそのまま保持できます。

Docsbookの支払い方法を教えてください#

請求は、販売者として機能するPaddleを通じて行われます。docsbook.io/chatのダッシュボードから請求画面を開き、プロジェクトの残高にチャージしてください。チャージ額は最低$20.00、最高$5,000.00です。Visa、Mastercard、American Express、Apple Pay、Google Payをご利用いただけます。

支払いは安全ですか？#

はい。支払いは販売者としてのPaddleによって処理され、Docsbookがお客様のカード番号を目にすることはありません。チェックアウト全体がPaddle独自のホスト型フローで実行されます。

1つのアカウントで複数のドキュメントサイトを運用できますか？#

はい。1つのDocsbookアカウントで多数のプロジェクトを所有でき、各プロジェクトはそれぞれ独自の残高を持ちます。あるプロジェクトの残高がなくなっても、別のプロジェクトが停止することはありません。従量課金の呼び出しをどのプロジェクトが支払うかは、呼び出し自体（指定したワークスペース、またはスコープが設定されたリポジトリ）から決まります。

返金は受け付けていますか？#

アカウントのメールアドレスとお支払い内容を support@docsbook.io までメールでお知らせください。返金は、お支払いの処理を行ったPaddleを通じて、ケースごとに対応します。

組織向けの割引はありますか？#

support@docsbook.io までメールでお問い合わせください。こちらでご案内できる、公開されている組織向け割引はありません。

はじめに#

Docsbookを試すのにGitHubリポジトリは必要ですか？#

いいえ。docsbook.io/startでは、1つのフィールドに、ウェブサイトのURL、リポジトリのリンク、PDFやスクリーンショット、または販売しているものについての文章など、お手元にあるものを入力するだけで、それをもとにサイトの下書きが生成されます。ドキュメントにワンクリックでアクセスできる下書きの管理画面が表示され、アカウントを作成する前に、ブランディング、レイアウト、SEOを変更できます。

GitHubが必要になるのは、既存のリポジトリをリンクする場合、または公開する場合だけです。サインイン方法は問いません。GitHub、Google、Apple、またはワンタイムコードを使ったメールでサインインできます。

Docsbookにはどのようなリポジトリが必要ですか？#

Markdownファイルを含むGitHubリポジトリであれば何でも構いません。単一の README.md、docs/ フォルダー、APIリファレンス、または .md ファイルが平らに並んだ構成でも構いません — Docsbookは、そこにある構造からナビゲーションを構築します。

GitHubで何か設定する必要がありますか？#

いいえ。GitHub OAuthを通じてDocsbookを認証すると、リポジトリのファイルが読み込まれます。追加するワークフローファイルも、インストールするGitHub Actionも、登録するWebhookもありません。

どのようなフォルダー構成を使用すべきですか？#

Docsbook は見つけたフォルダーからナビゲーションツリーを構築するため、どのような構成でも機能します。一般的な構成は次のとおりです。

repo/
├── README.md
├── docs/
│   ├── getting-started.md
│   ├── api/
│   └── guides/

フォルダーのルートにある README.md が、そのフォルダーのランディングページになります。

.mdの代わりに.markdownを使用できますか？#

はい。Docsbook は .md と .markdown の両方を読み取ります。その他の形式（.txt、.rst、.adoc）のファイルはページに変換されません。

Markdownファイル間のリンクは機能しますか？#

はい。Markdownファイル間の相対リンクは公開URLに解決されるため、GitHubで機能するリンクはサイト上でも機能します。次のように、これまでどおり記述してください：

[Concepts](/docsbook-io/docs/basics)
[Custom domain](/docsbook-io/docs/guides/advanced/custom-domain)

ページ内の見出しへのアンカー（./basics.md#indexing）も同様に解決されます。

ドキュメントに画像を追加するにはどうすればよいですか？#

画像ファイルをリポジトリに配置します — docs/images/ が一般的な選択肢です — そして相対パスで参照します。PNG、JPG、GIF、WebP はすべて配信されます。

![Workspace settings with the API key field highlighted](https://raw.githubusercontent.com/docsbook-io/docs/main/images/workspace-settings.png)

代替テキストはスクリーンリーダーや AI クローラーが読み取るものなので、ファイル名ではなく画像に何が表示されているかを説明してください。

MarkdownでHTMLを使用できますか？#

はい。MarkdownではインラインHTMLを使用でき、Docsbookはそれをレンダリングします。それでも、プレーンなMarkdownをデフォルトにする方が適切です。GitHubやエディターで読まれる場合、またMCP経由でエージェントに読み取られる場合にも、そのまま利用できるからです。

GitHubアカウントと組織を切り替えるにはどうすればよいですか？#

AIチャットの右上隅にあるGitHubボタンをクリックします。サインインしているアカウントと、所属しているすべてのGitHub組織を一覧表示する切り替えメニューが開きます。ボタン上の緑色のドットは、GitHubが接続されていることを示します。アカウントまたは組織にカーソルを合わせると（タッチスクリーンではタップすると）、そのリポジトリが表示され、そこから新しいプロジェクトとして1つを接続できます。

Docsbookでホストされているプロジェクトを自分のGitHubリポジトリに移動できますか？#

はい、同じGitHubボタンから行えます。Docsbookはあなたのアカウントにリポジトリを作成し、すべてのページを1つのコミットでそこにコピーして、プロジェクトをそのリポジトリに紐付けます。その後の編集は直接あなたのリポジトリにコミットされます。

移動する前に、2つの点に注意してください。公開URLが変わります。また、以前のホストアドレスはリダイレクトなしで使えなくなるため、共有したすべての場所を更新してください。そして、この移動は一方向です — プロジェクトをDocsbookのホスティングに戻すボタンはありません。

公開と同期#

Docsbookのドキュメントを更新するにはどうすればよいですか？#

Markdownファイルを編集してGitHubにコミットします。サイトは次回のアクセス時に変更を反映するため、実行するビルドも、完了を待つデプロイもありません。Docsbookのウェブエディターで編集することも、MCP経由でエージェントを使って編集することもできます。いずれの場合も、同じリポジトリへのコミットとして反映されます。

プッシュ後、Docsbookサイトはどのくらい早く更新されますか？#

次回の訪問時です。Docsbookはサイトの読み込み時にGitHubで新しいコミットを確認し、変更された内容を再インデックスするため、開いたページはキャッシュされたビルドではなく、現在のリポジトリの状態から構築されます。

Docsbookサイトが更新されないのはなぜですか？#

次の4点を順番に確認してください：

1. コミットは実際にGitHubにありますか？github.comでファイルを確認してください。
2. ブラウザを強制更新しましたか（Ctrl+F5、またはCmd+Shift+R）？
3. コミットしてから1～2分経過していますか？
4. ファイルの末尾は.mdまたは.markdownですか？その他の拡張子はインデックス登録されません。

4点すべてに問題がなければ、リポジトリとコミットを添えてsupport@docsbook.ioまでメールしてください。

Docsbookのサイト内検索は機能しますか？#

はい。すべてのDocsbookサイトには、全ページを対象とした全文検索機能が組み込まれています。ヘッダーの検索アイコンをクリックするか、macOSではCmd+K、WindowsとLinuxではCtrl+Kを押してください。

ダークテーマはありますか？#

はい。ライト、ダーク、システム設定に従うテーマをすべてサポートしています。ワークスペースの所有者がブランディング設定でデフォルトを選択し、閲覧者はヘッダーのテーマ切り替えから変更できます。

Docsbookサイトは同時に何人の訪問者に対応できますか？#

Docsbookサイトは、VercelのCDNから配信され、自動的にスケールします。設定が必要な訪問者数の上限はなく、購入が必要なトラフィック階層もありません。

アクセスとプライバシー#

Docsbookのドキュメントを閲覧できるのは誰ですか？#

デフォルトでは、全員です。リンクを知っている人、GitHubアカウントを持っていない人、検索エンジンのクローラーなどが閲覧できます。通常はこれが望ましい設定です。公開サイトであるからこそ、Googleにインデックスされ、AIアシスタントが引用できます。

変更することもできます。次の回答をご覧ください。

ドキュメントを非公開にできますか？#

はい。ワークスペースを非公開に切り替えると、読者にはコンテンツの代わりにロック解除画面が表示されます。共有パスワード、または独自のSSO IDプロバイダーのいずれかで認証できます。読者がロックを解除するまで、構成、ページ、検索インデックスは非表示のままとなり、所有者は常に完全なアクセス権を持ちます。

設定については、非公開ドキュメント：パスワードとSSOをご覧ください。

非公開の GitHub リポジトリにすると、公開されたサイトも非公開になりますか？#

いいえ。2 つの設定は独立しています。Docsbook は、付与された GitHub の認証を通じてリポジトリを読み取り、ビルドしたページを配信します。それらのページを誰が読めるかは、リポジトリの公開設定ではなく、Docsbook 独自のアクセス設定によって決まります。

ドキュメントはHTTPS経由で提供されますか？#

はい。すべてのDocsbookサイトはVercelのCDNを通じてHTTPS経由で提供され、カスタムドメインにはTLS証明書が自動的にプロビジョニングされます。

Docsbookを通じて他の人が自分のドキュメントを編集できますか？#

リポジトリへのアクセス権を付与していない限り、できません。Docsbookはサイトの構築元リポジトリにコミットとして変更を書き込むため、誰が何を変更できるかはリポジトリの権限によって決まります。

フロートウィジェットを見るのは誰ですか？#

サインインして自分のドキュメントを表示している間の、あなた自身だけです。読者にはドキュメントだけが表示され、それ以外は何も表示されません。フロートウィジェットは読者にはまったくレンダリングされません。

カスタムドメイン#

Docsbookで独自ドメインを使用するには？#

ワークスペースの設定でドメインを入力し、Docsbookが表示するCNAMEレコードをDNSプロバイダーに追加して、反映されるまで待ちます。TLS証明書はDocsbookが自動で発行します。

詳しい手順：独自ドメインの設定。

ドキュメントにはルートドメインとサブドメインのどちらを使うべきですか？#

通常はサブドメインです — docs.example.com。CNAMEレコードを1つ設定するだけで、マーケティングサイト用のアペックスドメインには手を加えずに済みます。ルートドメインでも機能しますし、異なるワークスペースを指す複数のサブドメインも同様です。

SSL を自分で設定する必要がありますか？#

いいえ。Docsbook はカスタムドメイン用の TLS 証明書を自動的に取得・更新します。追加費用はかからず、お客様が設定する必要もありません。

DNSの伝播にはどのくらい時間がかかりますか？#

通常は15〜30分、最悪の場合は最大48時間かかります。遅延はDocsbookではなくDNSプロバイダー側で発生します。レコードが解決されるとすぐに、ドメインでの配信が開始されます。

翻訳#

Docsbookのドキュメントを翻訳するには？#

ワークスペースの設定を開き、対象言語を選択して保存します。Docsbookがページを翻訳し、各言語をそれぞれのルートで提供します。翻訳はAIによる処理のため、プロジェクトの残高が使用されます。

詳しい手順：翻訳とi18n。

Docsbookがサポートしている言語は？#

15言語: 英語、スペイン語、フランス語、ドイツ語、ポルトガル語、イタリア語、ロシア語、中国語、日本語、韓国語、アラビア語、ヒンディー語、トルコ語、ポーランド語、オランダ語。各言語は正しいhreflangタグを備えた独自のルートで提供されるため、検索エンジンはそれぞれを個別のページとしてインデックス登録します。

DocsbookのAI翻訳の品質はどの程度ですか？#

語彙が一貫していて文が短い技術文書であれば、公開できる十分な品質です。イディオム、ジョーク、文化に特有の例については人による確認が必要です。言語の公開を告知する前に、そうしたページを読んで確認してください。

元のページを更新すると翻訳も更新されますか？#

はい。ソースページが変更されると、Docsbookは再翻訳するため、言語版が英語版から気づかないうちにずれてしまうことはありません。

翻訳を手動で編集できますか？#

はい。翻訳をダウンロードして修正し、再度アップロードできます。手順について説明をご希望の場合は、support@docsbook.io までメールでお問い合わせください。

AI とエージェント#

SEO、GEO、AEOとは何ですか？また、ドキュメントにとってなぜ重要なのですか？#

SEOは、ドキュメントをGoogleの検索結果に表示します。GEO（生成エンジン最適化）は、Perplexityの引用、ChatGPT Search、Google AI OverviewsなどのAIによる回答にドキュメントを表示します。AEO（回答エンジン最適化）は、強調スニペットや音声アシスタントが読み取る構造化マークアップを追加します。

Docsbookは、Markdownからこれら3つすべてを生成します。メタタグ、sitemap.xml、OpenGraph、正規URL、TL;DRブロック、表示されるdateModified、著者マークアップ、FAQPageおよびHowToのJSON-LD、さらにspeakableセレクターを生成します。詳しくはSEO、GEO、AEOをご覧ください。

Docsbookスキルとは？#

Docsbookスキルは、AIエージェントにドキュメント作業の方法を教えるSKILL.mdファイルです。カタログには、作業ごとに1つずつ、4つのオーケストレータースキルがあります。docs-analyzeは何が問題かを見つけ、docs-createは不足しているものを書き、docs-manageはページに何を書くべきかを決め、docs-automateはそのいずれも繰り返し実行させます。

npx skills add Docsbook-io/docs-skills --skill '*'でインストールするか、MCPに接続されたエージェントにfind_skillを使って実行時に発見させることができます。Docsスキルを参照してください。

AIエージェントは私のドキュメントを編集できますか？#

はい。DocsbookのMCPサーバーはhttps://docsbook.io/api/mcp/serverで309個のツールを公開しているため、Claude Code、Cursor、ChatGPTはページの読み取り、検索、設定の変更、新しいページのコミットを行えます。書き込みには読み取り／書き込みスコープが承認されたトークンが必要です。読み取り専用トークンは拒否されます。

MCPサーバーおよびMCPツールリファレンスを参照してください。

別のツールからの移行#

GitBook から Docsbook に移行するには？#

3 つの手順があります：

1. GitBook からエクスポートします。 GitBook は Git リポジトリと同期するか、Markdown を .zip としてエクスポートできます。生成された .md ファイルを GitHub リポジトリにプッシュします — 構成は問いません。
2. リポジトリを接続します。 docsbook.io/start で github.com/your-org/your-repo を貼り付けます。
3. ドメインの向き先を変更します。 GitBook でカスタムドメインを削除し、Docsbook に追加して、CNAME レコードを更新します。TLS 証明書は自動的に発行されます。

自動的に引き継がれるもの：ページ構造、内部リンク（相対 .md パスは解決されます）、画像、GFM コードブロック、見出し、フロントマター。やり直しが必要なもの：ブランディング、ナビゲーションリンク、AI チャットの推奨質問。比較については、GitBook と Docsbook の比較をご覧ください。

Docsbookが終了した場合、ドキュメントはどうなりますか？#

何も失われません。Markdownファイルは、履歴を含め、オープンな形式でご自身のGitHubリポジトリに保存されています。同じリポジトリを別のツールで指定すれば、すべてをそのまま保持できます。移行すべき独自ストアも、要求すべきエクスポートもありません。

サポート、法務、技術#

Docsbookのサポートにはどう連絡すればよいですか？#

support@docsbook.ioにメールを送るか、Docsbook Discordで質問してください。プロジェクトのアドレス（docsbook.io/{owner}/{repo}）を含めると、正しいサイトを確認して回答できます。

何かが壊れている場合はどうすればよいですか？#

support@docsbook.io まで、ページの URL、期待していたこと、実際に起きたことの 3 つをメールでお知らせください。スクリーンショットがあると役立ちます。表示されなかったコンテンツに関する問題の場合は、コミット SHA があるとさらに役立ちます。

Docsbookの製品アップデートはどこで確認できますか？#

変更履歴には、リリースされたすべての変更と、それによって実現しようとした内容が記録されています。より短いお知らせはtwitter.com/docsbookで発信しています。

Docsbookは何で構築されていますか？#

Vercel上でNext.js 16、React 19、TypeScript、Tailwind CSSを使用し、その背後でPostgres（Neon）とRedisを稼働させ、ORMにはDrizzle、請求にはPaddle、リポジトリへのアクセスにはGitHub APIを使用しています。AIへの呼び出しはOpenRouterまたは独自のプロバイダーキーを経由します。

Docsbookのデータはどこに保存されますか？#

Vercelのインフラストラクチャと、米国およびその他の地域でホストされているNeon Postgresに保存されます。ドキュメントのコンテンツ自体はGitHubリポジトリに残ります。Docsbookが保存するのは、そこから構築したインデックスであり、信頼できる情報源のコピーを別に保存するわけではありません。

DocsbookではどのMarkdownパーサーを使用していますか？#

remarkとrehypeをunified経由で使用しており、GitHub Flavored Markdown（GFM）に対応しています。ナビゲーションとリンク解決にはmarkdown-lsp（Docsbookのオープンソースのドキュメントパーサー）を使用し、構文ハイライトにはShikiを使用しています。

利用規約とプライバシーポリシーはありますか？#

はい：利用規約とプライバシーがあります。サイトが規約に違反した場合、Docsbookはまず所有者に連絡し、通常はそれ以外の対応を取る前に修正の機会を与えます。

関連#

• 料金 — 何が従量課金の対象となり、プロジェクト残高が何に充てられるか
• クイックスタート — ソースから公開 URL まで、ドキュメントサイトを公開する方法
• 概念 — 上記で使用したすべての用語を一度に定義
• ユースケース — チームがドキュメントを依頼する業務