Spicrawl

Spicrawl MCP サーバー：Claude、Cursor、AI エージェント向けのウェブスクレイピング

Claude、Cursor、その他の AI エージェントでウェブサイトをスクレイピングするには、Spicrawl MCP サーバーに接続します。Spicrawl API キーを使って、ホスト型エンドポイント https://mcp.spicrawl.com/mcp を追加するか、ローカルで npx -y @spicrawl/mcp を実行すると、エージェントは spicrawl_scrape を呼び出して、任意の URL を Markdown、テキスト、HTML、または JSON として読み取れます。JavaScript ページのレンダリング、構造化データの抽出、1 回のバッチジョブで最大 10,000 件の URL のスクレイピング、スクリーンショットの撮影、ログイン済みブラウザーセッションの維持が可能で、Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、Gemini CLI、Codex でネイティブの spicrawl_* ツールとして利用できます。無料プランには毎月 1,000 クレジットが含まれます。

ドキュメント · API キーを取得 · TypeScript SDK · CLI · エージェントプラグイン · 変更履歴

インストール先： npm · Smithery · Glama · MCP Registry · Dify プラグイン · Cursor Directory

1. app.spicrawl.comで API キーを作成します。キーは spicrawl_live_ または spicrawl_test_ で始まります。

2. ホスト型エンドポイントhttps://mcp.spicrawl.com/mcp（MCP Streamable HTTP、インストール不要）に接続します。

   export SPICRAWL_API_KEY=spicrawl_live_...
   claude mcp add --transport http spicrawl https://mcp.spicrawl.com/mcp \
     --header "Authorization: Bearer $SPICRAWL_API_KEY"
   

   Codex：codex mcp add spicrawl --url https://mcp.spicrawl.com/mcp --bearer-token-env-var SPICRAWL_API_KEY

3. または、ローカルサーバーのみを起動するクライアント向けに、stdio 経由でローカル実行します（Node.js 20 以降）。

   claude mcp add spicrawl --env SPICRAWL_API_KEY=$SPICRAWL_API_KEY -- npx -y @spicrawl/mcp
   

4. エージェントに次のように依頼します：「Spicrawl を使って https://example.com/pricing を Markdown で読み込み、各プランとその価格を一覧にしてください。」 spicrawl_scrape が呼び出され、ページが Markdown として返されます。

どちらのトランスポートでも同じ spicrawl_* ツールが提供されます（25 個が定義されています。リモートブラウザーが起動するまでは、ホスト型エンドポイントには 24 個が表示されます。ツールを参照）。すべての呼び出しはキーを使用して実行され、直接 API を呼び出す場合と同じスコープ、制限、クレジットが適用されます。

できること

• 1 つのツール spicrawl_scrape で、任意の URL を Markdown、テキスト、HTML、JSON エンベロープ、または印刷用 PDF にスクレイピングできます。デフォルトは Markdown で、ページの主要コンテンツを抽出します。
• render: true を指定してJavaScript をレンダリングできます（3 クレジット）。通常のフェッチは 1 クレジット、スクリーンショット、PDF、actions はフルブラウザーを使用するため 8 クレジットです。また、mode: "auto" はフェッチからブラウザーへと段階的に切り替わり、正常に処理できた段階の料金のみが請求されます（料金表）。レンダリング方法を選ぶ必要はありません。Spicrawl がリクエストを処理できる最も低コストな方法を選びます。
• CSS／XPath セレクターマップ（extract）を使って構造化データを抽出するか、ページが公開している JSON-LD、OpenGraph、Twitter Card、マイクロデータから抽出できます（autoparse）。
• 8 種類の型付きブラウザーアクション（click、fill、wait_for、wait_for_navigation、scroll（無限スクロールを含む）、select、evaluate、screenshot）で、キャプチャの前にページを操作できます。
• モデルが参照できるスクリーンショットと PDF を返せます。スクリーンショットは MCP の画像ブロック（base64 で最大 5 MB）、印刷されたページは application/pdf のリソースブロック（最大 10 MB）として返されます。
• 最大 10,000 件の URL を 1 つの非同期ジョブとして数千件まとめてスクレイピングできます。ジョブの送信、ポーリング、結果のページ送り、再試行、キャンセル、および URL を見つけるたびに追加できるようジョブを開いたままにするための 9 つのツールが用意されています。
• 永続セッションを使って、ログイン状態のブラウザーを保持できます。Cookie、ストレージ、固定のレンダリング階層がスクレイピング間で再利用されます。
• 使用状況やリクエストログのツールで**「費用はいくらでしたか？」に回答したり、エージェント内からSpicrawl のドキュメントを読んだり**できます。

ユースケース

• ドキュメントをスクレイピングして RAG ナレッジベースを作成する。 spicrawl_scrape でドキュメントページをクリーンな Markdown として読み込む（Markdown では main_content_only がデフォルトで有効です）か、1 つの spicrawl_batch_submit ジョブで最大 10,000 件の URL をキューに追加します。Spicrawl は Markdown を返します。チャンク分割と埋め込みはご自身で行ってください。ナレッジベースのレシピを参照してください。
• 価格を監視する。 extract セレクターマップまたは autoparse を使って、商品のタイトル、価格、在庫状況を取得し、最新の情報を得るには cache: false を設定します。通常のフェッチによる確認は 1 クレジット、レンダリングありの場合は 3 クレジットです。ご自身のスケジュールに合わせて実行してください。価格の監視を参照してください。
• 求人情報を抽出する。 無限スクロールのページ（render: true と scroll アクションを使用）を含む求人サイトから、求人情報を構造化フィールドとして収集します。求人情報を参照してください。
• JavaScript を多用するページを読む。 通常のフェッチで空の枠だけが返される場合は、render: true（3 クレジット）を指定して spicrawl_scrape を呼び出し、ページがまず自身を構築するようにします。

スクレイピングする前に、各サイトの利用規約と robots.txt を確認してください。

使用するツール

• 1 ページ分のコンテンツやデータがすぐに必要な場合は、spicrawl_scrape を使用します。
• ページが空白、または JavaScript がない骨組みだけのページの場合は、render: true を指定して spicrawl_scrape を再度呼び出します。
• ページの構造がわかっている場合は CSS セレクターを指定して extract を使用し、わからない場合は autoparse を試します。
• URL が約 20 件を超える場合は、spicrawl_batch_submit を使用してから、spicrawl_batch_status と spicrawl_batch_results を呼び出します。
• URL を見つけながら進める場合は、open: true を指定して送信し、spicrawl_batch_add_items で追加して、最後に spicrawl_batch_close を呼び出します。
• 先にログインが必要な場合は、spicrawl_session_create を使用し、その id を session_id として spicrawl_scrape に渡します。
• 呼び出しが失敗し、原因を調べる必要がある場合は、リクエスト ID を指定して spicrawl_request_get を使用するか、only_errors を指定して spicrawl_requests_list を使用します。
• パラメーターやエラーコードが不明な場合は、推測する前に spicrawl_docs_search を使用します。

ツール

タスク別に分類された 25 個のツールがあります。リモートブラウザーが起動するまでは、ホスト型エンドポイントに表示されるのは 24 個です。キーなしの tools/list とサーバーカードでは、spicrawl_browser_connect_url（近日公開）が除外されています。一方、キーを使って開いたセッションと stdio パッケージ（npx -y @spicrawl/mcp）には、25 個すべてが表示されます。ツールは未知の引数を拒否するため、フィールド名を間違えると、黙って無視されるのではなく、そのフィールド名を示すエラーが発生します。すべてのツールには title と readOnlyHint、destructiveHint、openWorldHint の明示的なアノテーションが設定されているため、クライアントは確認が必要な呼び出しを判断できます。spicrawl_scrape は読み取り専用ではありません（method と actions によりフォームを送信できます）。また、spicrawl_batch_cancel、spicrawl_session_release、spicrawl_session_delete は破壊的な操作です。すべてのツールは outputSchema も宣言し、従来と同じテキストに加えて、一致する structuredContent を返すため、クライアントはテキストを解析せずに credits、status、next_cursor などのフィールドを読み取れます。スキーマにはエージェントが信頼できる内容が列挙されていますが、拡張可能な設計になっています。API が後から追加したフィールドもそのまま渡され、ステータスとティアは通常の文字列です。ドキュメントまたは JSON 配列を返すツール（spicrawl_docs_read、spicrawl_batch_task_content）は、structuredContent 内の content にその内容を格納します。引数の完全なリファレンスは、docs.spicrawl.com/agents/mcp をご覧ください。

ウェブサイトを Markdown にスクレイピングする

複数の URL を一括スクレイピングする

ブラウザーセッション

使用状況とリクエスト履歴

ドキュメント

近日公開

spicrawl_browser_connect_url は、任意の CDP クライアントから Spicrawl ホストのブラウザーを操作するための、1 回限りの CDP WebSocket URL を発行します。リモートブラウザーはまだ利用できません。これは 25 番目のツールであり、ホスト型のキーレス一覧とサーバーカードで除外されている唯一のツールです（そちらには 24 個のツールが記載されています）。スキーマでは、リリースに先立ち ai_extract、stealth、extract_preset、premium_proxy、proxy_country、sticky_key も受け付けます。エージェントはまだこれらを送信しないでください。現在利用可能なものだけを一覧表示するには、SPICRAWL_MCP_HIDE_UNAVAILABLE=1 を設定してください（環境変数を参照）。

プロンプトの例

• 「https://example.com/pricing を Markdown としてスクレイピングし、プランを要約してください。」
• 「この URL から製品名、価格、在庫状況を取得してください。」（extract または autoparse を指定して spicrawl_scrape を使用）
• 「Cookie バナーが消えた後の https://example.com の全ページスクリーンショットを撮ってください。」（render、actions、screenshot_fullpage）
• 「この 500 件の URL をスクレイピングし、それぞれのページタイトルを教えてください。」（spicrawl_batch_submit を実行し、その後 spicrawl_batch_results を実行）
• 「最後のスクレイピングが失敗した理由を教えてください。」（only_errors を指定して spicrawl_requests_list を実行し、その後 spicrawl_request_get を実行）
• 「今月、クレジットをいくつ使用しましたか？」（spicrawl_usage_summary）

MCP クライアントのセットアップ

キーを SPICRAWL_API_KEY に設定し、クライアントが対応している場合は設定から参照してください。これにより、キーがコミット対象のファイルに含まれることを防げます。

claude mcp add --transport http spicrawl https://mcp.spicrawl.com/mcp \
  --header "Authorization: Bearer $SPICRAWL_API_KEY"

{
  "mcpServers": {
    "spicrawl": {
      "type": "http",
      "url": "https://mcp.spicrawl.com/mcp",
      "headers": { "Authorization": "Bearer ${SPICRAWL_API_KEY}" }
    }
  }
}

claude plugin marketplace add OfficialSpicrawl/agent-plugins
claude plugin install spicrawl@spicrawl-plugins

{
  "mcpServers": {
    "spicrawl": {
      "command": "npx",
      "args": ["-y", "@spicrawl/mcp"],
      "env": { "SPICRAWL_API_KEY": "spicrawl_live_..." }
    }
  }
}

{
  "mcpServers": {
    "spicrawl": {
      "url": "https://mcp.spicrawl.com/mcp",
      "headers": { "Authorization": "Bearer ${env:SPICRAWL_API_KEY}" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "spicrawl-api-key", "description": "Spicrawl API key", "password": true }
  ],
  "servers": {
    "spicrawl": {
      "type": "http",
      "url": "https://mcp.spicrawl.com/mcp",
      "headers": { "Authorization": "Bearer ${input:spicrawl-api-key}" }
    }
  }
}

devin mcp add spicrawl https://mcp.spicrawl.com/mcp -H "Authorization: Bearer $SPICRAWL_API_KEY"

{
  "mcpServers": {
    "spicrawl": {
      "serverUrl": "https://mcp.spicrawl.com/mcp",
      "headers": { "Authorization": "Bearer ${env:SPICRAWL_API_KEY}" }
    }
  }
}

export SPICRAWL_MCP_BEARER="$SPICRAWL_API_KEY"

{
  "mcpServers": {
    "spicrawl": {
      "httpUrl": "https://mcp.spicrawl.com/mcp",
      "headers": { "Authorization": "Bearer $SPICRAWL_MCP_BEARER" }
    }
  }
}

codex mcp add spicrawl --url https://mcp.spicrawl.com/mcp --bearer-token-env-var SPICRAWL_API_KEY

[mcp_servers.spicrawl]
url = "https://mcp.spicrawl.com/mcp"
bearer_token_env_var = "SPICRAWL_API_KEY"

[mcp_servers.spicrawl]
command = "npx"
args = ["-y", "@spicrawl/mcp"]
env = { SPICRAWL_API_KEY = "spicrawl_live_..." }

ドキュメント関連の変数が設定されていない場合、セルフホスト API を参照するサーバーは、その API 自身のドキュメントを <SPICRAWL_PUBLIC_BASE_URL or SPICRAWL_BASE_URL>/docs から読み取ります。

MCP サーバーを HTTP 経由でセルフホストする

ホストされたエンドポイントでは、このパッケージの Streamable HTTP サーバーが実行されます。独自に実行するには：

SPICRAWL_MCP_ADDR=127.0.0.1:8090 \
SPICRAWL_BASE_URL=https://api.spicrawl.com \
npx -y @spicrawl/mcp --http

• HTTP モードでの SPICRAWL_BASE_URL のデフォルト値は http://127.0.0.1:8080（同じホスト上の Spicrawl API）であり、公開 API ではありません。公開 API を利用するには、https://api.spicrawl.com に設定してください。
• MCP は POST／GET／DELETE /mcp で提供されます。稼働確認用エンドポイントは GET /healthz です（認証不要）。
• GET /.well-known/mcp/server-card.json（認証不要、Cache-Control: public, max-age=3600）は、キーなしでは /mcp をスキャンできない Smithery などのディレクトリ向けの静的なサーバーカードです。serverInfo、トランスポート、ベアラー認証、ツール一覧が含まれます。ツールは tools/list と同じ定義から読み込まれ、SPICRAWL_MCP_HIDE_UNAVAILABLE が有効な場合と同じになります。ツールは 24 個で、spicrawl_browser_connect_url は含まれません。キーを使って開いたセッションでは、その変数が設定されていない限り、このツールも一覧に含まれます。
• キーがない場合、/mcp が応答するのはディスカバリーのみです。対象は initialize、ping、initialized 通知、tools/list（サーバーカードと同じ 24 個のツール一覧）です。Mcp-Session-Id は発行されず、上流には何も送信されません。その他のリクエスト（tools/call を含む）は 401 になります。不正な形式のキーを送信するリクエストや、セッションを指定するリクエストも同様です。セッションを指定しない GET は 405 になります。
• 各呼び出し元は、自身のキーを Authorization: Bearer spicrawl_live_... として送信します。または、Bearer プレフィックスを送信できないゲートウェイの場合は、Authorization: spicrawl_live_...、x-api-key、api-key ヘッダーに生の値を設定します（上記の「Smithery とその他のゲートウェイ」を参照。クエリパラメーターは使用しないでください）。セッションを開く前に API に対してキーを検証します（拒否された場合は 401、API に接続できない場合は Retry-After 付きの 503）。セッションは、それを開いたキーに固定されます。
• サーバーは平文の HTTP を使用します。ネットワーク経由でキーを送信する前に、TLS の背後に配置してください。

ChatGPT エンドポイント（OAuth）

同じプロセスで、ChatGPT アプリ向けの制限付き MCP エンドポイントも提供できます。SPICRAWL_CHATGPT_ENABLED が有効でない限り、このエンドポイントは無効です。有効・無効にかかわらず、/mcp に変更はありません。

認証で受け付けるのは OAuth アクセストークン（spicrawl_oat_…）のみです。

• トークンがない場合：WWW-Authenticate: Bearer resource_metadata="https://mcp.spicrawl.com/.well-known/oauth-protected-resource/chatgpt/mcp", scope="scrape batch" 付きの 401。
• 不正、無効化済み、期限切れ、または対象者が異なるトークンの場合、あるいは API キー（spicrawl_live_…／spicrawl_test_…。このエンドポイントでは受け付けません）の場合：error="invalid_token", error_description="…" を伴う同じ 401。
• トークンのスコープで許可されていないツール呼び出しの場合：error="insufficient_scope" 付きの 403。spicrawl_scrape には scrape、バッチツールには batch が必要です。ドキュメントツールには有効なトークンのみが必要です。
• 認可サーバーに到達できない場合、またはこのサーバーのシークレットが拒否された場合：Retry-After 付きの 503。 各トークンは POST <issuer>/api/oauth/introspect（Authorization: Bearer <SPICRAWL_OAUTH_INTROSPECT_SECRET>、フォーム本文 token=…）で検証されます。active: true で、aud がリソースと一致する場合のみ受け入れられます。肯定的な応答は、トークンの SHA-256 をキーとして最大 30 秒間キャッシュされます。ただし、そのトークンの exp を過ぎて保持されることはありません。ツールは、イントロスペクションで返された api_key を使って上流で実行されます。api_key もトークンもログには記録されません。API が呼び出し中にそのキーを拒否した場合、ツールは _meta["mcp/www_authenticate"] に新しい invalid_token チャレンジを含むエラーを返し、トークンをキャッシュから削除します。

エンドポイントには 6 つのツールが列挙されており、それぞれに readOnlyHint／destructiveHint／openWorldHint、タイトル、securitySchemes: [{type: "oauth2", scopes: [...]}]（_meta.securitySchemes にも含まれます）が明示されています。

spicrawl_scrape は、/mcp とは異なり、このエンドポイントでは読み取り専用です。このエンドポイントが送信するのは GET のみで、method、本文、ヘッダー、actions は送信しません。spicrawl_batch_submit はジョブを作成するため、読み取り専用ではありません。

spicrawl_batch_results は、ジョブの完了処理中に結果ページへ内容が含まれずに掲載される成功済み項目について、GET /v1/batch/{id}/tasks/{seq}/content からその内容を取得します。1 ページあたり最大 25 件、2 MiB まで取得します。まだ読み取れない項目は unavailable として返され、サイズ上限を超えた項目は omitted として返されます。

それ以外の引数はすべて拒否され、無視されることはありません。結果には内容、サイトのステータス、課金されたクレジットが含まれます。リクエスト ID、タイムスタンプ、エンジンとプロキシの詳細、ストレージ参照、プロジェクト ID は含まれません。

グローバルにインストールすると（npm install -g @spicrawl/mcp）、コマンドは spicrawl-mcp（エイリアス spicrawl-mcp-server）です。--http、--version、--help を使用できます。

よくある質問

JavaScript を使ったサイトをスクレイピングできる MCP サーバーはどれですか？

Spicrawl MCP サーバーです。spicrawl_scrape を render: true（3 クレジット）で呼び出すと、ブラウザーでページが読み込まれ、スクリプトが実行され、処理済みの Markdown、テキスト、HTML、JSON が返されます。後から表示されるコンテンツには CSS セレクターを指定して wait_for を追加するか、mode: "auto" を設定すると、プレーンなフェッチから始め、必要な場合にのみより強力なレンダリングへ切り替えます。Spicrawl はリクエストごとにレンダリングを選択し、その処理を行ったティア（fetch、js、browser）に応じて課金します。使用されたティアは JSON 結果の engine として報告されます。ティアを選択する引数はありません。

Claude にウェブアクセスを許可するにはどうすればよいですか？

API キーを使って Spicrawl MCP サーバーを Claude に接続します。Claude Code の場合：

claude mcp add --transport http spicrawl https://mcp.spicrawl.com/mcp \
  --header "Authorization: Bearer $SPICRAWL_API_KEY"

Claude は spicrawl_scrape を呼び出して、指定された URL を読み取れるようになります。Spicrawl がページを読み取るには URL を指定します。検索エンジンではありません。Claude Desktop については、以下のインストールに関する回答をご覧ください。

無料プランはありますか？

はい。ベータ期間中は、すべての組織が月 1,000 クレジットの単一プランを利用できます。プレーンフェッチは 1 クレジット、JavaScript レンダリングは 3 クレジット、フルブラウザーレンダリング（スクリーンショット、PDF、actions）は 8 クレジットです。失敗したリクエストは 0 クレジットで、キャッシュヒットには、そのキャッシュを保存したフェッチと同じ料金が適用されます。当月のクレジットを使い切ると、リセットされるまで呼び出しは ERR::LIMIT::QUOTA_EXCEEDED で失敗します。クレジットをご覧ください。

ボットで保護されたページに対応していますか？

ご自身のプロキシを使う場合に限り対応しています。proxy に指定してください（http:// URL。レジデンシャルプロキシが最適です）。サイトが Cloudflare のマネージドチャレンジを返すと、Spicrawl はそれを検出し、同じプロキシの出口を使ってフルブラウザーでのレンダリングにリクエストを切り替え、実際のページを返します。料金は 8 クレジットです。すべての段階でチャレンジが返された場合は ERR::UPSTREAM::CHALLENGE が返され、料金はかかりません。成功する可能性は高いものの、保証はされず、Spicrawl は CAPTCHA を解決しません。デフォルトの共有プールでは、チャレンジが返されたページに対してこのエラーが返されます。Cloudflare で保護されたページをスクレイピングするをご覧ください。

Cursor または Claude Desktop にインストールするには？

**Cursor：**上の Add to Cursor をクリックするか、.cursor/mcp.json に以下を追加し、SPICRAWL_API_KEY を設定して Cursor を起動します。

{
  "mcpServers": {
    "spicrawl": {
      "url": "https://mcp.spicrawl.com/mcp",
      "headers": { "Authorization": "Bearer ${env:SPICRAWL_API_KEY}" }
    }
  }
}

Claude Desktop はローカル（stdio）サーバーのみを起動するため、パッケージを実行してください。claude_desktop_config.json に以下を追加し、アプリを再起動します。

{
  "mcpServers": {
    "spicrawl": {
      "command": "npx",
      "args": ["-y", "@spicrawl/mcp"],
      "env": { "SPICRAWL_API_KEY": "spicrawl_live_..." }
    }
  }
}

キーは app.spicrawl.com で取得できます。Claude Code、VS Code、Windsurf、Gemini CLI、Codex の設定手順は、MCP クライアントをセットアップするをご覧ください。

ウェブサイト全体をクロールできますか？

単一のクロールツールはありません。links: true を指定してページをスクレイピングし、取得したリンクをオープン状態のバッチジョブ（open: true と spicrawl_batch_add_items）に渡してください。

その他の質問

ホスト型の Spicrawl MCP サーバーはありますか？

はい。https://mcp.spicrawl.com/mcp が MCP Streamable HTTP で、Authorization: Bearer <API key> で認証します。そのため、インストールは不要です。

OAuth に対応していますか？

/mcp では対応していません。Spicrawl API キーのみを受け付けるため、401 のときに OAuth を試すクライアントでは OAuth をオフにしてください。別の ChatGPT エンドポイントである /chatgpt/mcp は、運用者が有効にした場合に限り、OAuth アクセストークンのみを受け付けます。

MCP サーバー、SDK、CLI のどれを使うべきですか？

AI エージェントに Spicrawl をツールとして呼び出させる場合は、MCP サーバーを使ってください。独自の TypeScript または JavaScript コードでは @spicrawl/sdk を、ターミナルまたはシェルスクリプトでは @spicrawl/cli を、その他の言語では REST API を使ってください。

トラブルシューティング

キーなしで実行した curl -i https://mcp.spicrawl.com/mcp は 401 を返します。これはエンドポイントに到達できることを示しています。

関連パッケージ

• @spicrawl/sdk：Spicrawl API の公式 TypeScript SDK。
• @spicrawl/cli：Spicrawl のコマンドラインインターフェース。
• OfficialSpicrawl/agent-plugins：このサーバーと Spicrawl スキルを Claude Code、Codex、Cursor、Gemini CLI などにまとめたプラグイン。

リンク

• ドキュメント：docs.spicrawl.com/agents/mcp
• LLM 向けドキュメント：docs.spicrawl.com/llms.txt
• ダッシュボードと API キー：app.spicrawl.com
• 課題：github.com/OfficialSpicrawl/mcp/issues
• セキュリティ：SECURITY.md。API キーは決してコミットしないでください。漏えいしたキーは app.spicrawl.com で無効化してください。

MCP Registry への公開

server.json には、io.github.OfficialSpicrawl/mcp の下に npm/stdio パッケージとホストされた Streamable HTTP エンドポイントの両方が記載されています。API キーはサーバーをインストールする人に要求されます。マニフェストにキーを含めないでください。

既存の release ワークフローは、npm ジョブの成功後、main へのプッシュ時または main からの手動実行時に MCP Registry へ公開します。Registry の認証には GitHub OIDC（id-token: write）を使用するため、新しいシークレット、デバイスログイン、DNS レコードは必要ありません。npm のリリースには、引き続き既存の NPM_TOKEN シークレットを使用します。

リリースするには、npm version --no-git-tag-version X.Y.Z を実行して変更履歴を更新し、変更を main に反映します。npm のバージョンフックによって、server.json に記載された両方のバージョンが同期されます。package.json を手動で編集した場合は、npm run registry:sync を実行してください。CI では、公式の $schema に対して Ajv でマニフェストを検証し、npm への公開前に名前またはバージョンの不一致を検出して拒否します。このチェックをローカルで実行するには、次のコマンドを実行してください。

npm ci
npm run registry:validate
# Offline: pass a downloaded copy of the exact server.json $schema URL.
npm run registry:validate -- /path/to/server.schema.json

Registry のジョブでは、公開前に、公開済み npm パッケージに一致する mcpName があることを確認します。Registry に既存のバージョンがある場合はスキップされます。検索に失敗した場合、ジョブは停止します。Registry への公開失敗を再試行する場合、またはすでに公開されている現在の npm バージョンを一覧表示する場合は、main で release ワークフローを再度実行してください。既存のリスティングのメタデータを変更する場合は、新しいバージョンを使用してください。公開用バイナリはバージョンが固定されており、ダウンロードしたファイルはリリースチェックサムと照合されます。CLI をアップグレードする場合は、release.yml のバージョンを更新してください。

公開状況は https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.OfficialSpicrawl/mcp で確認してください。OIDC によるこの名前空間への公開には、ワークフローが OfficialSpicrawl/mcp にマージされている必要があります。フォークからのプルリクエストでは検証とテストを実行しますが、Registry のジョブは実行しません。

公式リファレンス：公開クイックスタート、GitHub Actions、リモートサーバー。

ライセンス

Apache-2.0