Canopy API

Canopy MCP サーバー — AI エージェント向け Amazon 商品データ API

Model Context Protocol を介して提供される Amazon 商品データ API です。Claude、ChatGPT、Cursor、その他の MCP クライアントをリアルタイムの Amazon データに接続できます。Amazon 検索 API、レビュー API、価格トラッカー、ASIN 検索、ベストセラー、セール、売上推定を、Canopy API で提供します。ヘッドレスブラウザーも、壊れやすい HTML スクレイピングも不要です。標準の MCP ツールを通じて、型付けされた JSON を利用できます。

xmcp で構築され、Cloudflare Workers にデプロイされています。ホスト型リモート MCP サーバー https://mcp.canopyapi.co/mcp を使用するか、このリポジトリからセルフホストできます。セットアップガイドとクライアントごとの手順は、Amazon MCP server のページをご覧ください。

Amazon MCP サーバーを使う理由

AI エージェントや LLM アプリでは、リアルタイムの E コマースデータがますます必要になっています。このサーバーを使うと、MCP 対応のアシスタントやエージェントフレームワークから Amazon に直接ツールアクセスできます。

• ショッピングアシスタント — エージェント向けの Amazon 検索 API。商品を検索し、価格や Buy Box のオファーを比較して、チャットでセールやクーポンを提示できます
• 価格のモニタリングと競合情報の分析 — 任意の ASIN の価格、在庫推定、販売者オファーを取得する Amazon 価格トラッカー API
• 商品調査と市場分析 — ベストセラーランキング、売上推定、カテゴリ分類体系を備えた Amazon 商品調査ツール
• カタログの拡充 — ASIN 検索と ASIN ↔ GTIN/UPC/ISBN/EAN の変換に加え、画像、バリエーション、仕様を取得できます
• レビュー分析 — 要約用に、評価、有用票、メディアを含む上位のカスタマーレビューを返す Amazon レビュー API

Claude MCP サーバー（Desktop、Code、claude.ai のコネクタディレクトリ）、ChatGPT MCP コネクター（リッチな商品ウィジェットを備えた Apps SDK）、Cursor、MCP Inspector で動作します。また、MCP SDK、LangChain、OpenAI Agents SDK を使って構築されたあらゆるエージェントでも利用できます。

機能

• Amazon データツール 17 種類 — 商品情報、バリエーション、オファー、在庫、売上、レビュー、検索、オートコンプリート、カテゴリ、ベストセラー、販売者、著者、セール、ASIN/GTIN 検索
• /mcp での Streamable HTTP トランスポート（現行の MCP 仕様）
• ファイルベースのツール — src/tools/ の下にツールごとに 1 ファイル
• 型安全性 — openapi-typescript を使って Canopy OpenAPI 仕様から生成された TypeScript 型
• 柔軟な認証 — OAuth 2.1 サインイン（Supabase 認可サーバー、動的クライアント登録）、または 4 種類のヘッダー形式のいずれかによる API キー
• CORS 対応 — プリフライトとカスタム API キーヘッダーを許可

クイックスタート

ホスト型サーバーを使う（インストール不要）

リモート MCP サーバーをクライアントに追加し、OAuth でサインインするか、Canopy API キーを指定します。

https://mcp.canopyapi.co/mcp

Claude などの OAuth 対応 MCP クライアントでは、サインインの手順が自動的に案内されます。canopyapi.co で API キーを取得し、クライアントごとのセットアップ手順については Amazon MCP server guide をご覧ください。

エージェントプラグインとしてインストールする

このリポジトリはエージェントプラグイン（仕様 1.0.0）です。プラグインのルートはリポジトリのルートです。互換性のあるクライアントは plugin.json を読み込み、skills/ からスキルをロードし、mcp.json で宣言された MCP サーバーに接続します。

canopy-api-mcp/
├── plugin.json          # Agent Plugins 1.0.0 manifest
├── mcp.json             # hosted Streamable HTTP server
└── skills/
    └── amazon-product-research/
        ├── SKILL.md
        └── references/tools.md

mcp.json は、上記と同じホスト型エンドポイントを指定します。

{
  "mcpServers": {
    "canopy": {
      "type": "streamable-http",
      "url": "https://mcp.canopyapi.co/mcp"
    }
  }
}

認証はクライアント側で行います。OAuth 対応クライアントは、サーバーからサインイン方法を検出します。Agent Plugins では headers は公開パッケージデータとして扱われ、シークレットを記述する場所ではないため、プラグインに API キーを埋め込むことはありません。クライアントが静的ヘッダーしかサポートしていない場合は、そのクライアントで CANOPY-API-KEY を設定してください。

Cursor. プラグインが掲載されたら、Customize または Cursor Marketplace からインストールしてください。掲載前にディレクトリを試すには、このリポジトリを ~/.cursor/plugins/local/canopy-api-mcp にコピーし（そのフォルダーの外を指すシンボリックリンクは無視されます）、ウィンドウを再読み込みして、Customize で Canopy サーバーと amazon-product-research スキルを確認してください。

その他の Agent Plugins クライアント。 このディレクトリを読み込んでください。クライアントには Agent Plugins 1.0.0 と streamable-http トランスポートが必要です。仕様にはアーカイブもレジストリプロトコルもありません。パッケージはこのディレクトリです。

server.json に変更はありません。これは MCP Registry のサーバーカードであり、plugin.json とは別の形式です。npm install、npm run dev、npm run deploy に変更はありません。

公開済みスキーマに対してパッケージを検証します。

npm run validate:plugin

自分で実行する

canopyapi.co から Canopy API キーを取得してください。

npm install
npm run dev      # xmcp watcher + wrangler dev (local Workers runtime)
npm run deploy   # build + wrangler deploy --env production

テスト

npm test を実行すると、ワーカーをビルドして回帰テストを実行します。出力スキーマのテストでは、モック化した REST レスポンスを使い、null 値のフィールド（利用できない価格、クーポン、評価）が MCP クライアントに届く前に除去されること、レスポンスが公開された JSON Schema に一致すること、不正な値が引き続き拒否されることを確認します。これらのテストに実際の Canopy API キーは必要ありません。

MCP Inspector を使用して http://localhost:8787/mcp（またはデプロイ先の URL）に接続してください。リクエストヘッダーとして API キーを指定します。

npx -y @modelcontextprotocol/inspector@latest

または、curl を使用します。

curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "CANOPY-API-KEY: $CANOPY_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

認証

すべてのリクエストに認証情報が必要です。次の 2 つの方式をサポートしています。

1. OAuth 2.1（MCP クライアントに推奨）。 OAuth 対応クライアントはフローを自動的に検出します。認証されていないリクエストには、WWW-Authenticate: Bearer resource_metadata="https://mcp.canopyapi.co/.well-known/oauth-protected-resource" を伴う 401 が返されます。Supabase が認可サーバーです（動的クライアント登録をサポート）。同意画面は canopyapi.co にあります。検証済みユーザーの Canopy API キーはサーバー側で解決されます。

2. API キーヘッダー。 次のいずれの形式も使用できます（以下の順で確認されます）。

• CANOPY-API-KEY: your-api-key
• API-KEY: your-api-key
• X-API-KEY: your-api-key
• Authorization: Bearer your-api-key

認証情報がない場合、または無効な場合、リクエストが MCP トランスポートに到達する前に、JSON-RPC エラーを伴う HTTP 401 が返されます（src/middleware.ts を参照）。

利用可能なツール

17 個すべてのツールは読み取り専用（readOnlyHint: true）で、title が付与されています。

商品情報

• get_amazon_product — ASIN、URL、または GTIN による商品詳細
• get_amazon_product_variants — 商品バリエーション
• get_amazon_product_offers — 出品者のオファーと Buy Box 情報
• get_amazon_product_stock — 在庫レベルの推定値
• get_amazon_product_sales — 販売数の推定値（週次、月次、年次）
• get_amazon_product_top_reviews — 上位のカスタマーレビュー（タイトル、本文、評価、参考になった票数、画像／動画）

検索と発見

• search_amazon_products — フィルターと並べ替えを使った検索
• get_amazon_autocomplete — 検索語の候補
• get_amazon_deals — 現在のセール。オプションでカテゴリーによる絞り込みが可能
• get_amazon_bestsellers — カテゴリー別のベストセラー商品
• get_amazon_bestseller_categories — ベストセラーカテゴリーの一覧

カテゴリ

• get_amazon_categories — ルートカテゴリの分類体系
• get_amazon_category — 商品とサブカテゴリを含むカテゴリの詳細

エンティティ

• get_amazon_seller — 販売者情報と商品リスト
• get_amazon_author — 著者情報と書籍リスト

識別子

• get_amazon_asin_from_gtin — ISBN/UPC/EAN による ASIN の検索
• get_amazon_gtin_from_asin — ASIN による GTIN の検索

プロジェクト構成

canopy-api-mcp/
├── plugin.json                 # Agent Plugins 1.0.0 manifest
├── mcp.json                    # MCP server declaration (Streamable HTTP)
├── skills/
│   └── amazon-product-research/
│       ├── SKILL.md
│       └── references/tools.md
├── server.json                 # MCP Registry server card (separate from plugin.json)
├── LICENSE                     # MIT License
├── src/
│   ├── tools/                  # one file per tool (auto-discovered by xmcp)
│   │   ├── get-amazon-product.ts
│   │   └── ...
│   ├── lib/
│   │   └── api-key.ts          # reads API key from extra.authInfo
│   ├── middleware.ts           # auth middleware (lifts header → authInfo.token)
│   ├── api-client.ts           # type-safe Canopy REST client
│   └── types/
│       └── api.d.ts            # generated from OpenAPI
├── xmcp.config.ts              # xmcp config (endpoint, CORS, paths)
├── wrangler.jsonc              # Cloudflare Workers config
├── worker-entry.ts             # Workers entry (unchanged)
├── tsconfig.json
└── package.json

型安全性

src/types/api.d.ts は Canopy OpenAPI 仕様から生成されています。API が変更された場合は再生成してください。

npm run generate

スクリプト

• npm run dev — xmcp ウォッチャーと wrangler dev（ローカルの Workers ランタイム）
• npm run build — xmcp build --cf（Cloudflare 用の worker.js を出力）
• npm run deploy — ビルドと wrangler deploy --env production
• npm run delete — デプロイ済み Worker を削除
• npm run generate — OpenAPI 仕様から API 型を再生成
• npm run validate:plugin — plugin.json、mcp.json、skills/ が Agent Plugins 1.0.0 に準拠しているか確認

v1.x からの移行

v2.0 では ModelFetch を xmcp に置き換えています。MCP エンドポイントは /sse/mcp（非推奨の SSE トランスポートのマウント先）から /mcp（現在の Streamable HTTP の慣例）に移動しました。クライアントもそれに応じて更新してください。

ライセンス

このプロジェクトは MIT License の下で公開されています。著作権 (c) 2026 Canopy API。

関連リンク

• Model Context Protocol
• xmcp フレームワーク
• Amazon MCP Server — Canopy
• Canopy API
• Cloudflare Workers