Easyparser — Amazon Product & Seller Data

easyparser-mcp

公式のEasyparser MCP サーバーです。Model Context Protocolを通じて、AI エージェントに21のマーケットプレイスのAmazonデータをリアルタイムかつ構造化された形式で提供します。

商品詳細、出品者のオファー、検索結果、過去12か月の販売履歴、ベストセラーランキング、パッケージ寸法、出品者の法的身元、カタログ、フィードバックに対応しています。10種類のデータ操作に加え、一括ジョブのモニタリングとアカウントツールを、1つの接続で利用できます。

エージェントにできること

商品データ

ツール	取得できる内容	コスト
get_product_detail	商品の詳細情報：タイトル、価格、画像、評価、BSR、バリエーション、レビュー	1クレジット（A+コンテンツ付きの場合は+1）
get_product_offers	すべての販売者の出品情報：価格、コンディション、FBA/FBM、ショッピングカートボックスの獲得者	1ページあたり1クレジット（最大5ページ）
get_bestseller_rank	カテゴリー別の現在のベストセラーランキング	1クレジット
get_package_dimensions	正確な寸法、重量、Amazonの手数料カテゴリー	1クレジット
get_sales_history	12か月分の週次トレンド：閲覧数、売上、価格、BSR	5クレジット＋履歴1か月ごとに1クレジット（最大17クレジット）

検索と商品発見

ツール	取得できる内容	コスト
search_products	価格、評価、バッジを含むキーワード／カテゴリー検索結果	1ページあたり1クレジット（最大5ページ）
lookup_product	UPC/EAN/GTIN/ISBN → ASINへの変換	1クレジット

販売者情報

ツール	取得できる内容	コスト
get_seller_profile	販売者の正式名称、住所、過去30日／90日／365日のフィードバック傾向	1クレジット
get_seller_products	価格と評価を含む販売者の全商品カタログ	1ページあたり1クレジット（最大5ページ）
get_seller_feedback	購入者個人のフィードバック。評価／期間で絞り込み可能	1ページあたり1クレジット（最大5ページ）

一括ジョブのモニタリング：ウェブアプリまたはBulk APIから開始したジョブを追跡します

ツール	取得できる内容	コスト
list_bulk_jobs	進捗状況を含む一括ジョブ：ステータス、完了／失敗／無効の件数	無料
get_bulk_job_items	ジョブ内のアイテムごとの結果（失敗／無効なアイテムのデバッグ用）	無料
get_bulk_item_result	アイテムから生成された解析済みデータ（24時間保持）	無料
get_bulk_webhook_logs	ジョブ完了時のWebhook配信ログ	無料

エラーログ：ウェブアプリのエラーページと同じデータです

ツール	取得できる内容	コスト
get_error_logs	APIリクエストのエラー（リアルタイムおよび一括）：エラーコード、チャネル、操作、失敗したリクエストのパラメーター、タイムスタンプ	無料

アカウントと商品発見

ツール	取得できる内容	コスト
list_operations	パラメーター、コスト、対応ドメインを含む操作カタログ。キーなしで使用できます	無料
check_credits	プラン、クレジット残高、レート制限、今月の日ごとの操作別使用量	無料

APIキーを取得する

app.easyparser.com/signupで登録してください。無料プランが含まれており、クレジットカードは不要です。アカウント → プランからAPIキーをコピーしてください。以下のセットアップ手順でYOUR_API_KEYを求められたら、このキーを貼り付けてください。

セットアップ

接続方法は2つあります。ホスト型リモートサーバー（インストール不要で、常に最新）またはnpxを使ったローカル接続（お使いのマシン上で実行）です。

Cursor

ワンクリックでインストールできます（設定が入力済みの状態で Cursor が開きます。プロンプトが表示されたら YOUR_API_KEY を置き換えてください）。

• リモートサーバー： Cursor に追加
• ローカル（npx）： Cursor に追加

または、.cursor/mcp.json に手動で追加します。

{
  "mcpServers": {
    "easyparser": {
      "type": "http",
      "url": "https://mcp.easyparser.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

ワンクリックでインストールできます（VS Code が入力プロンプトを使って API キーを安全に尋ねます）。

• リモートサーバー： VS Code に追加

または、.vscode/mcp.json に手動で追加します。

{
  "servers": {
    "easyparser": {
      "type": "http",
      "url": "https://mcp.easyparser.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Code

claude mcp add --scope user --transport http easyparser https://mcp.easyparser.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop & claude.ai

カスタムコネクターを追加します。

1. Settings → Connectors → Add → Add custom connector を開きます。
2. Name： Easyparser
3. Remote MCP server URL： https://mcp.easyparser.com/mcp を入力し、Continue をクリックします。
4. Authentication で None を選択します（Easyparser は OAuth ではなく API キーを使用します）。
5. Request headers でヘッダーを追加します。名前は authorization、値は Bearer YOUR_API_KEY とし、Required に設定します。
6. Add をクリックします。

Manus

Settings → Integrations → Custom MCP Servers → Add Server に移動し、フォームに入力します。

項目	値
サーバー名	Easyparser
トランスポートタイプ	HTTP
サーバー URL	https://mcp.easyparser.com/mcp
カスタムヘッダー	ヘッダー名：Authorization、値：Bearer YOUR_API_KEY（「Bearer 」の後に Easyparser API キーを貼り付けます）

Test をクリックして接続を確認し、Save をクリックします。値には常に Easyparser API キーを使用します。別途トークンは必要ありません。

任意の MCP クライアント

ホスト型エンドポイントは https://mcp.easyparser.com/mcp で Streamable HTTP を使用します。Authorization: Bearer YOUR_API_KEY で認証します。x-api-key と api-key ヘッダーも使用できます。list_operations 検出ツールはキーなしで利用できるため、エージェントは登録前に機能を確認できます。

ローカルの stdio クライアントでは、環境で EASYPARSER_API_KEY を設定し、npx -y easyparser-mcp を実行します。

プロンプトの例

What is the current price and rating of ASIN B0F25371FH?

Find the ASIN for UPC 041604458187, then show me its 6-month sales trend.

Who is the seller behind this product, what is their legal business name,
and what do their negative reviews say?

Compare the top 10 organic results for "stainless steel water bottle" on
amazon.de: prices, ratings, and which ones are Prime.

Is the bulk job I started this morning finished? If any items failed,
tell me which ASINs and why.

組み込みプロンプトとリソース

MCP プロンプトに対応したクライアントは、以下のワークフローをワンステップで開始できます。

プロンプト	内容
analyze_competitor_product	1 つの ASIN の出品詳細、販売者のオファー、過去 3 か月の売上および BSR の推移
estimate_fba_logistics	FBA の計画に必要な正確な梱包寸法、重量、手数料カテゴリー
match_barcodes_to_asins	UPC、EAN、GTIN、ISBN コードのリストを ASIN に変換
vet_amazon_seller	販売者の法的身元、評判の推移、否定的なフィードバック
product_market_research	キーワードのニッチ市場における上位のオーガニック検索結果と需要の比較

読み取り専用リソース。無料で、キーなしで利用できます。

• easyparser://operations：クレジット費用を含むすべての操作
• easyparser://marketplaces：対応する Amazon ドメイン 21 件
• easyparser://guide：ツールの選び方とクレジットの節約方法に関する判断ルール

データツールは、宣言された outputSchema に一致する structuredContent も返します。

HTTP サーバーのセルフホスト

npm install -g easyparser-mcp
PORT=3000 easyparser-mcp-http   # or: node dist/http.js from a clone

Docker を使用する場合：

docker build -t easyparser-mcp .
docker run -p 3000:3000 easyparser-mcp

エンドポイント：POST /mcp（MCP）、GET /health（ヘルスチェック）。

仕組み

このサーバーは、Easyparser Real-Time API を介する、シンプルな読み取り専用アダプターです。ツールの説明は AI エージェント向けに書かれており、それぞれのツールが返す内容、使用するタイミング、より低コストなツールが適している場合、クレジットの消費量が記載されています。すべての応答に credits_remaining が含まれるため、エージェントは予算を考慮した判断ができます。レート制限エラーや認証エラーでは、HTTP コードをそのまま返すのではなく、実行可能な対処方法（サインアップリンクを含む）が示されます。

ライセンス

MIT。LICENSE を参照してください。