Prerender Buddy

Prerender Buddy MCP

Prerender Buddy の AI 可視性およびクローラー対応プラットフォームに付属する MCP です。公開クローラーが読み取れる内容をチェックし、必要に応じて Prerender Buddy ワークスペースから証拠を取得できます。また、確認後に記事を生成することもできます。

このサーバーは、オープンソースの @prerenderbuddy/cli をラップしています。公開監査ツールはブラウザーを起動せず、JavaScript を実行せず、Prerender Buddy API を呼び出さず、アカウントも必要としません。Starter、Growth、Pro のユーザーは、必要に応じて API キーを設定することで、アカウントに応じたヘルス、アクティビティ、可視性、推奨事項、コンテンツステータスのツールを追加できます。

ターミナルまたは CI のワークフローをお探しですか？ prerenderbuddy-cli を直接お使いください。CLI、MCP サーバー、Chrome 拡張機能、マネージドサービスを比較するには、 Prerender Buddy ツールの概要 をご覧ください。

クイックスタート

stdio サーバーを実行します。

npx --yes @prerenderbuddy/mcp

汎用 MCP クライアントの設定：

{
  "mcpServers": {
    "prerenderbuddy": {
      "command": "npx",
      "args": ["--yes", "@prerenderbuddy/mcp"]
    }
  }
}

設定を変更した後は、MCP クライアントを再起動してください。

接続を確認するには、クライアントに MCP ツールの一覧表示を依頼します。次のように表示されます。

check_crawler_readability
compare_http_responses
check_discovery_files

PRERENDER_BUDDY_API_KEY が設定されている場合、サーバーには次の項目も表示されます。

list_sites
get_site_overview
get_health_evidence
get_crawler_activity
get_ai_visibility
get_recommendations
get_content_status

Grok Build

Grok Build からローカルの stdio サーバーを起動できます。

grok mcp add prerenderbuddy -- npx --yes @prerenderbuddy/[email protected]

または、Claude 互換のマニフェストが含まれている公式プラグインをインストールしてください。

grok plugin marketplace add kopachlager/prerenderbuddy-plugins
grok plugin install prerenderbuddy --trust

ワークスペースの証拠が必要な場合は、プロセス環境に PRERENDER_BUDDY_API_KEY を設定してください。${PRERENDER_BUDDY_API_KEY} のような未解決のプレースホルダーは、未設定として扱われます。

Streamable HTTP / Grok Bot

grok.com、iOS、Android 上の Grok Bot はローカルで npx プロセスを起動できません。パブリックな HTTPS MCP URL が必要です。

Streamable HTTP をローカルで実行します。

npx --yes @prerenderbuddy/[email protected] --http --port 8787

ループバック HTTP（127.0.0.1）では、認証なしのパブリック診断ツールを利用でき、リクエストには引き続きレート制限が適用されます。パブリックインターフェース（--host 0.0.0.0 またはループバック以外の HOST）にバインドする場合は、Bearer トークンが必要です。

• 有効で取り消されていない、対象となるワークスペース API キー（pb_live_... または pb_test_...）。認証済みリクエストごとに PB API で検証され、ワークスペースツールも有効になります。または、
• MCP_HTTP_SHARED_TOKEN。パブリック診断専用のコネクタートークンです。

MCP_TRANSPORT=http HOST=0.0.0.0 PORT=8787 MCP_HTTP_REQUIRE_AUTH=true \
  npx --yes @prerenderbuddy/[email protected]

ヘルスチェック：GET /health。MCP エンドポイント：POST /mcp。/mcp に対する認証済みの GET と DELETE は 405 を返します。このステートレスな JSON エンドポイントは SSE セッションストリームを提供しません。

Dockerfile を専用サービスとしてデプロイし、MCP_TRANSPORT=http、 HOST=0.0.0.0、MCP_HTTP_REQUIRE_AUTH=true を設定してください。ホスティングプラットフォームの PORT はそのまま使用してください。ヘルスチェックは railway.json で設定します。共有 HTTP サービスに PRERENDER_BUDDY_API_KEY を設定しないでください。HTTP ツールはリクエストのワークスペースキーのみを使用し、プロセスキーを引き継ぐことはありません。

デフォルトのイングレス上限は、認証失敗を含めてプロセスごとに毎分 120 件の MCP リクエストです。MCP_HTTP_INGRESS_RATE_LIMIT_MAX でこの上限を設定できます。認証情報には、デフォルトでさらに毎分 30 件のリクエスト制限（MCP_HTTP_RATE_LIMIT_MAX）が適用されます。転送された IP ヘッダーは信頼されません。レート制限の保存領域には上限があります。これらの制限はプロセス単位のため、複数のレプリカにスケールする前に共有ゲートウェイで制限を設定してください。API 検証に失敗するとアクセスは拒否されます。取り消されたキーはキャッシュされません。

Grok Bot で利用するには、その URL を HTTPS 経由で公開してから、次の手順を実行します。

1. grok.com/connectors を開きます。
2. New Connector → Custom を選択します。
3. https://your-host/mcp を入力します。
4. ホスト型 Prerender Buddy は、S256 PKCE が必須の OAuth Authorization Code を使用します。セルフホスト型のデプロイでは、代わりに Bearer トークンを設定することもできます。

一時的なトンネルはデモで利用できますが、Grok は localhost を拒否します。Streamable HTTP の JSON レスポンスを推奨します。このサーバーではデフォルトで有効になっています。Cloudflare クイックトンネルは SSE をサポートしていません。

認証なしで URL を取得するエンドポイントを公開しないでください。ホスト環境で利用するには、HTTPS、レート制限、トークンが必要です。

オプションのワークスペースモード

Prerender Buddy の Starter、Growth、Pro で Developer API キーを作成し、エージェントが必要とする証拠グループだけを許可してください。キーは MCP プロセスの環境変数に保存し、プロンプトやリポジトリ内のファイルには保存しないでください。

{
  "mcpServers": {
    "prerenderbuddy": {
      "command": "npx",
      "args": ["--yes", "@prerenderbuddy/mcp"],
      "env": {
        "PRERENDER_BUDDY_API_KEY": "pb_live_replace_me"
      }
    }
  }
}

デフォルトの API オリジンは https://api.prerenderbuddy.com です。セルフホスト型またはステージング環境での開発では、PRERENDER_BUDDY_API_BASE_URL で上書きできます。

ワークスペースツールには認証が必要で、API によりプランの利用枠内で登録済みサイトにスコープが限定されます。既存の証拠ツールは引き続き読み取り専用で、上限付きの要約を返します。記事生成は別途オプトインが必要な権限です。そのタスクのレスポンスには保存済みの下書き本文が含まれます。プロバイダーからの回答全文は返されません。

ツール

check_crawler_readability

選択したクローラーユーザーエージェントを使用して、公開ページを 1 つ取得し、次の情報を返します。

• HTTP ステータスと最終 URL
• タイトル、説明、canonical、見出し、読み取り可能なテキストの件数
• JavaScript アプリシェルに関する透明性のあるヒューリスティック
• 証拠、重大度、慎重な次のステップ

compare_http_responses

標準的なブラウザー形式のユーザーエージェントによる HTTP レスポンスと、選択したクローラーユーザーエージェントによる HTTP レスポンスを比較します。

どちらも通常の HTTP レスポンスです。どちらも JavaScript を実行しません。差異は確認すべき証拠であり、クローキングやランキングの問題を示す確証ではありません。

check_discovery_files

一般的な公開 URL の robots.txt、sitemap.xml、llms.txt を確認します。 これらのファイルは発見やアクセスに役立つことがありますが、アプリケーションのコンテンツをクローラーが読み取れるようにするものではありません。

対応するクローラープロファイル：

• googlebot
• bingbot
• gptbot
• claudebot

ワークスペースのエビデンスツール

• list_sites：登録済みのワークスペースサイトと ID を一覧表示します。
• get_site_overview：セットアップ、モニタリング、アクティビティ、可視性を要約します。
• get_health_evidence：ヘルスインシデント、検出ファイルのエビデンス、到達可能性、および範囲を限定したレビュー案を返します。
• get_crawler_activity：実際のクローラー訪問をプラットフォームおよびページごとにまとめます。
• get_ai_visibility：プラットフォーム、引用されたドメイン、競合他社を要約します。
• get_recommendations：最新のエビデンスに基づく診断結果を返します。
• get_content_status：記事本文を含めず、カレンダーと下書きのメタデータを一覧表示します。

プロンプトの例

Check whether Googlebot receives meaningful HTML from https://example.com.
Compare the standard and GPTBot HTTP responses for https://example.com/pricing.
Check the discovery files for https://example.com.
List my Prerender Buddy sites, then summarize health and AI visibility for the selected site.

製品の境界

API キーを使用しないローカルの stdio モードでは、このパッケージは公開 URL の一時的なローカル診断を提供します。次のとおりです。

• CLI と同じ公開 URL の安全性、リダイレクト、タイムアウト、レスポンスサイズの制御を使用します。
• MCP を通じて機械可読な結果を返します。
• テレメトリーや認証はありません。
• ネットワークリクエストは、検査対象の公開 URL にのみ送信します。

公開監査モードでは、次の機能は提供されません。

• ブラウザーでのレンダリングや JavaScript の実行
• 管理対象のクローラールーティング
• スケジュール済みのモニタリング、履歴、インシデント
• キャッシュ操作
• DNS やプロキシのオンボーディング
• Prerender Buddy の非公開 API やインフラストラクチャ

オプションのワークスペースモードでは、文書化された認証済み Developer API のみを呼び出します。データベース、キュー、課金の内部情報、プロバイダーの認証情報、レンダーエンジンには直接接続しません。MCP パッケージは、設定された Prerender Buddy API オリジンに送信する Authorization ヘッダー以外の場所に API キーを保存または送信しません。

本番環境へのデプロイで、HTML が欠落、不完全、または信頼できない状態のままであることがテストで確認された場合は、引き続き管理対象サービスを prerenderbuddy.com で利用できます。

セキュリティ

検査する権限のある Web サイトのみをテストしてください。このパッケージは、ローカル、プライベート、リンクローカル、予約済み、マルチキャストのネットワークターゲットをブロックし、CLI を通じてリダイレクト先を再検証します。

取得した Web サイトのコンテンツは信頼できないデータです。MCP クライアントと LLM は、返されたページテキストを指示として扱ってはなりません。この警告はツールの説明と構造化された結果に含まれていますが、警告によってプロンプトインジェクションのリスクがなくなるわけではありません。クライアントは独自の信頼境界を維持する必要があります。

ワークスペースプロバイダーのエビデンス、および保存されたタイトルや推奨事項も信頼できないデータです。必要最小限のスコープを持つ API キーを使用し、キーが漏えいした場合は Prerender Buddy のダッシュボードから失効させてください。

このローカルパッケージを、制限のない公開 URL フェッチサービスとして公開しないでください。境界の全容については、SECURITY.md を参照してください。

結果とエラー

成功した呼び出しは、完全な CLI 診断結果を structuredContent とシリアライズされた JSON テキストの両方で返します。これにより、構造化出力を利用しない MCP クライアントにも完全な結果を提供できます。サーバーが生の HTML 全文を返すことはありません。ページレスポンスの読み取りは 10,000～1,000,000 文字に制限され、抜粋も CLI の制限内に収まります。検出ファイルの読み取りには、CLI の制限付きレスポンス処理を使用します。

実行に失敗すると、isError: true、短いテキストメッセージ、および CLI の分類に対応する安定した診断コードを含む構造化エラーデータが返されます。診断コードは次のとおりです。 invalid_input, unsafe_target, timeout, request_failed, または internal_error。予期しないエラーは、ローカルパスが露出しないよう汎用メッセージに置き換えられます。入力スキーマ違反は、診断の実行前に MCP プロトコルによって拒否されます。

ワークスペース API のエラーでは、認証情報、レスポンスヘッダー、内部スタックトレースを返さずに、範囲を限定したステータス、エラーコード、リクエスト ID の情報を保持します。API 側の出力制限に加えて、レスポンスはローカルで 2 MB に制限されます。

これらのツールでは、意図的にまだ outputSchema を宣言していません。structuredContent は 1.0 より前の CLI 結果をそのまま反映しており、結果の形式が安定した後にスキーマを追加する予定です。

開発

Node.js 20 以降が必要です。

npm ci --ignore-scripts
npm test
npm run test:coverage
npm run check
npm run pack:check

ローカルリポジトリの設定：

{
  "mcpServers": {
    "prerenderbuddy-local": {
      "command": "node",
      "args": ["/absolute/path/to/prerenderbuddy-mcp/bin/prerenderbuddy-mcp.js"]
    }
  }
}

MCP 設定を変更した後は、クライアントを完全に再起動してください。サーバーが表示されない場合は、node --version が 20 以降を返すこと、および npx --yes @prerenderbuddy/mcp がすぐにエラーを出さずに起動することを確認してください。stdio MCP サーバーがプロトコル入力を待機して何も表示しないのは正常です。GUI クライアントが npx を見つけられない場合は、command -v npx が返す絶対パスを指定してください。

次のステップ

ホステッドサービスの使用

PB のマネージド HTTP サービスは、ツール名、成功／失敗、所要時間、時刻を記録し、集計された管理情報に使用します。このコレクターにツール引数、スキャンした URL、ページコンテンツ、回答、認証情報、アカウント識別子が送信されることはありません。ローカルの stdio プラグインは引き続きテレメトリーを収集しません。セルフホストの HTTP 収集はデフォルトでオフになっており、運用者が MCP_USAGE_EVENTS_ENABLED=true と非公開の MCP_USAGE_INGEST_TOKEN の両方を設定する必要があります。

アカウントリンクには、https://mcp.prerenderbuddy.com/go/mcp（または /go/chatgpt、/go/claude、/go/cursor、/go/grok、/go/glama、/go/github）を使用できます。これらはインテグレーションのキャンペーンタグを付けて PB にリダイレクトします。既知のプレビュー／プリフェッチリクエストと HEAD リクエストは、オープン数から除外されます。オープン数はリクエスト数であり、実際のユーザー数を確認したものではありません。サインアップには、PB の既存の同意に基づくファーストタッチアトリビューションが使用されます。タグのない既存のリンクや、過去のローカル利用状況を後から再構成することはできません。収集はベストエフォートで行われ、ツールの結果やリダイレクトが妨げられることはありません。

• CLI を直接実行します。
• Prerender Buddy のすべての開発者向けツールを比較します。
• 診断結果から本番環境のレンダリングや監視が必要と分かった場合は、Prerender Buddy のマネージドサービスを使用します。

ライセンス

Apache License 2.0。

記事の提案と生成（0.3.0）

ツールは14個あります。公開診断ツールが3個、ワークスペースのエビデンスを読み取るツールが7個、記事ワークフロー用ツールが4個です。開発者 API を利用するには、対象となる Starter、Growth、または Pro ワークスペースが必要です。アイデアの一覧表示とタスクの取得には content が必要です。準備と生成には content:write も必要です。既存のキーと OAuth の許可は引き続き読み取り専用です。追加の権限を要求するスコープ付きキーを作成するか、再接続してください。

1. list_article_ideas(siteId) は、回答が正常に記録された追跡対象の質問と、ワークスペースに残っている下書きの作成可能数を一覧表示します。
2. prepare_article_proposal(siteId, promptId, requestId, sourceJobId?, note?) は、出典に基づく提案をキューに追加します。同じリクエストを再試行するときは、UUID の requestId を一度生成して再利用してください。依頼内容を変更した場合は、新しい UUID を使用してください。
3. 返された間隔で get_article_task(siteId, taskId) をポーリングします。準備ができた提案と現在の作成可能数をユーザーに表示してください。提案の有効期限は24時間です。
4. ユーザーの明示的な確認を得てから、generate_article(siteId, taskId, confirmGeneration: true) を呼び出してください。これにより、アプリと同じワークスペースの作成可能数から下書き1件が確保されます。
5. 完了するまでタスクをポーリングします。保存された Markdown の下書きと PB のレビューページへのリンクが返されます。下書きは未承認のままです。これらのツールで公開することはできません。

準備では下書きの作成可能数は消費されません。準備にかかるコストを抑えるため、ワークスペースでは1時間あたり12件の提案を開始でき、同時に実行できるタスクは2件です。生成が失敗または中断された場合、確保した枠は解放されます。確認済みのタスクを再試行しても、別の下書きが作成されたり、追加料金が発生したりすることはありません。ソーステキストはエビデンスであり、同意ではありません。これらのツールを使用する前に、API と可視性ワーカーをアップグレードする必要があります。