mcp-api-change-monitor

API 変更モニター MCP サーバー

Mamba Labs の API 廃止および破壊的変更モニター Apify アクター向けの MCP サーバーです。API ベンダーや URL を指定すると、実行ごとに各ソースを前回実行時に保存された状態と比較し、変更点のみを返します。

内容

• 機能
• クイックスタート
• 前提条件
• プロンプトの例
• ツール
• 入力
• 料金
• キーについて
• アクターの完全なドキュメント
• ライセンス

機能

• 変更履歴：ベンダーの変更履歴フィードまたはページから新しい項目を取得します。記述内容に応じて deprecation_notice または breaking_change のタグを付け、最初に記載された sunset_date を返します。
• ステータス：ベンダーのステータス履歴フィードから、新しいインシデントとステータスの変更を取得します。
• OpenAPI：公開されている OpenAPI JSON ドキュメントから、追加、削除、または非推奨になった操作と API バージョンを取得します。
• ヘッダー：指定した API エンドポイントのレスポンスヘッダー Sunset と Deprecation を取得します。
• 実行ごとにソースあたり 1 行：state_key で初めて確認した場合は source_baseline を返し、その後は changes_found を含む source_check を返します。変更がない場合は、料金のかからない no_change 行を返します。

処理はすべて Apify 上で実行されます。このパッケージは、アクターの実行を開始して完了を待ち、データセットの行を返す軽量なクライアントです。

クイックスタート

Node.js 18 以降と、API トークンを設定した Apify アカウントが必要です。

Claude Desktop の設定ファイル（claude_desktop_config.json）、Cursor、または任意の MCP クライアントに以下を追加してください。

{
  "mcpServers": {
    "mamba-api-change-monitor": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-api-change-monitor"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

クライアントを再起動すると、monitor_api_changes ツールが表示されます。

前提条件

• Node.js 18 以降。
• console.apify.com/account/integrations から取得した Apify API トークンを APIFY_TOKEN として設定してください。サーバーはトークンがなくてもツールを一覧表示しますが、呼び出しにはトークンが必要です。

プロンプトの例

• 「先週以降、GitHub または OpenAI は廃止や破壊的変更を発表しましたか？」
• 「Stripe と GitHub の OpenAPI ドキュメントを監視して、削除または非推奨になった操作を教えてください。」
• 「昨日以降、Cloudflare または Vercel のステータスページでインシデントが発生しましたか？」

ツール

monitor_api_changes。ツールは 1 つです。引数の例：

{
  "vendors": [
    "github",
    "openai"
  ],
  "state_key": "api-watch-daily"
}

入力

このアクターの購入者向け入力がすべて、そのまま記載されています。省略された入力には、アクター独自のデフォルト値が使用されます。数値とブール値は文字列として送信されます。

入力	型	説明
vendors	array	監視する API ベンダーを1行に1つ指定します。それぞれについて、読み取る公開ソース（変更履歴、非推奨ページ、ステータス履歴、および公開されている場合は OpenAPI ドキュメント）が展開されます。利用可能なもの：github、stripe、shopify、hubspot、openai、anthropic、google-ads、twilio、slack、notion、atlassian、cloudflare、vercel、plaid
sources	array	監視するその他の公開 URL を1行に1つ指定します。変更履歴またはリリースノートのページ、RSS または Atom フィード、非推奨または提供終了日のページ、Statuspage サイトまたはその history.rss フィード、OpenAPI または Swagger JSON ドキュメントを指定できます。URL の応答内容から種類を判定します
endpoint_urls	array	認証情報なしで呼び出す API エンドポイントを1行に1つ指定します。応答ヘッダーから Sunset（RFC 8594）、Deprecation（RFC 9745）、および Link 関係の deprecation、sunset、successor-version を読み取ります。GET リクエストのみを送信します
watch	array	ベンダープリセットで監視する項目を指定します。指定できる値：changelog、deprecations、status、headers、openapi。空の場合は changelog、deprecations、status、headers が対象です。openapi を指定すると、ベンダーの OpenAPI ドキュメント（最大 14 MB）を読み取り、追加、削除、または非推奨になったオペレーションを報告します。changelog を指定しない場合、変更履歴ソースからは非推奨と破壊的変更のみが返されます。Source URLs に指定した URL は常に読み取られます
keywords	array	タイトル、要約、カテゴリ、またはオペレーションに指定した単語のいずれかが含まれる変更行のみを返します。すべての変更は引き続き保存状態に反映されます
only_deprecations_and_breaking	string	true の場合、非推奨または破壊的変更のタグが付いた変更行、削除または非推奨になった OpenAPI オペレーション、ヘッダーの変更のみを返します。インシデントと通常の変更履歴項目は除外されます。デフォルトは false です
max_changes_per_source	string	ソースごと、実行ごとに返す変更行数。1～1000。残りは changes_found に計上されます。デフォルトは 100 です
include_snapshot	string	true の場合、ソースの初回チェック時に、現在の項目、インシデント、またはオペレーションも返します。ソースごとの変更行数上限までです。各スナップショット行は課金対象です。デフォルトは false です
state_key	string	保存状態の名前を指定します。スケジュールごとに別々のベースラインを保持できます。同じ state key とソースを使用した実行同士が比較されます
reset_state	string	true の場合、保存状態を無視し、すべてのソースについて新しいベースラインを記録します。デフォルトは false です
max_charge_usd	string	省略可能です。この金額を超えて課金される前に実行を停止します
proxy_mode	string	ソースの取得方法を指定します。デフォルトは auto です

料金

Apify ではイベント単位で課金され、料金は Apify アカウントに請求されます。価格は米ドルです。

イベント	Free プラン	Bronze	Silver	Gold
change-row：前回の実行以降に監視対象ソースで発生した変更1件。新しい変更履歴項目、非推奨の通知、破壊的変更、新規または更新されたステータスインシデント、追加、削除、または非推奨になった OpenAPI オペレーション、API バージョンの変更、または Sunset／Deprecation ヘッダーの変更	$0.0035	$0.003325	$0.00315	$0.002975
source-check：ソースを1つ読み取り、保存状態と比較すること。ベースラインを記録するソースの初回チェック、または少なくとも1件の変更が見つかった後続のチェックが対象です。変更のないソースは無料の no_change 行を返し、読み取れないソースも無料です	$0.003	$0.00285	$0.0027	$0.00255
snapshot-row：ソースの初回チェック時における現在の項目、インシデント、またはオペレーション1件。include_snapshot が有効な場合のみ返されます	$0.001	$0.00095	$0.0009	$0.00085
apify-actor-start：実行開始ごと	$0.001	$0.001	$0.001	$0.001

変更のないソースは無料の no_change 行を返し、読み取れないソースも無料です。拒否された入力に対して返される1行も無料です。

API キー

このアクターにキーは必要ありません。公開されている変更履歴、フィード、ステータス履歴、OpenAPI ドキュメントを読み込み、認証情報なしで指定されたエンドポイントを呼び出します。いかなる種類のキーも保持しません。プロキシ経由のトラフィックによって料金が加算されることはありません。実行にかかるプラットフォーム費用は Mamba Labs が負担します。

アクターの詳細なドキュメント

apify.com/mambalabs/api-change-monitor

ライセンス

MIT。LICENSE をご覧ください。