asinlens

asinlens

asinlensは、Easyparserがホストする MCP サーバーへの小規模なローカルブリッジです。Amazonのページを構造化データに変換し、 商品詳細や出品情報、キーワード検索、 バーコードからASINへの照会、販売履歴、 ベストセラーランキング、パッケージ寸法、出品者プロフィール、 フィードバックやカタログに加え、アカウントの一括ジョブ、 Webhookログ、エラーログ、クレジット残高の確認にも対応します。

このブリッジはAmazonのデータを保持せず、それ自体でスクレイピングを行うこともありません。 ライブエンドポイントから取得した内容そのままの上流サーバーのツール一覧を ローカルで提供し、各ツール呼び出しを上流へ転送して、結果を変更せずに返します。 取得したツールはすべてデータの読み取り用です。 この再構築で書き込み機能が追加されることはありません。

ツール

商品データ：

• get_product_detail — 商品の詳細なプロフィール： タイトル、ブランド、画像、箇条書き、Buy Boxの価格と 在庫状況、Prime対象かどうか、評価、ランキング、 バリエーション、仕様、上位のレビュー。asinまたはurlの どちらか一方を指定してください。両方は指定できません。任意の 引数はdomain、language、currency、a_plus_content、 seller_idです。必須引数はありません。
• get_product_offers — 1つの商品に対するすべての出品情報。 価格、送料、コンディション、フルフィルメントの 種類、Buy Boxの獲得者を含みます。必須：asin。 任意のフィルターにはprime、free_shipping、 condition、ページ範囲があります。
• search_products — キーワードまたは検索URLによる検索。 構造化された商品一覧と絞り込みフィルターを返します。 任意の引数はsort_by、exclude_sponsored、 refinements、ページ範囲です。必須 引数はありません。
• lookup_product — UPC、EAN、GTIN、ISBN、 JAN、MINSANコード（またはASIN）を、一致する Amazon ASINと商品スナップショットに変換します。必須： identifierとidentifier_type。
• get_sales_history — トラフィック、販売数、価格、ランキングの 週ごとの推移を最大12か月分取得します。 必須：asin。history_rangeで期間を指定します。
• get_bestseller_rank — メインカテゴリとサブカテゴリの現在の ベストセラーランキング。必須：asin。
• get_package_dimensions — FBA手数料と送料の見積もりに使える、 正確なパッケージサイズと重量、およびAmazonの手数料カテゴリ。必須：asin。

出品者データ：

• get_seller_profile — 出品者の正式な事業者名、 登録住所、フィードバックの推移。seller_idまたはurlの どちらか一方を指定してください。必須引数はありません。
• get_seller_products — 出品者の全カタログ。 価格、Primeのステータス、評価を含みます。seller_idまたはurlの どちらか一方を指定してください。必須引数はありません。
• get_seller_feedback — 購入者からの個別フィードバック項目。評価と期間で 絞り込めます。必須： seller_id。

アカウントと一括モニタリング：

• list_operations — パラメーター、クレジットコスト、使用例を含む 上流の操作カタログ。
• list_bulk_jobs — 一括抽出ジョブとその 進捗。ステータス、操作、ドメインで絞り込めます。
• get_bulk_job_items — 1つの一括 ジョブ内の項目。必須：group_id。
• get_bulk_item_result — 1つの一括項目の解析済み結果データ。 （完了後24時間保持されます。） 必須：item_id。
• get_bulk_webhook_logs — 一括ジョブのWebhook配信ログ。 任意で1つのgroup_idに絞り込めます。
• get_error_logs — リアルタイムおよび一括チャネルに関する アカウントのAPIエラーログ。
• check_credits — プラン、クレジット残高、リセット日、 レート制限、今月の操作別使用量。引数はありません。

設定

• EASYPARSER_MCP_URL（任意）— 上流エンドポイントを 上書きします。デフォルトは https://mcp.easyparser.com/mcpです。（この上書き用フックは、この再構築で独自に追加したものとして明記されています。）
• EASYPARSER_API_KEY（任意）— 設定すると、すべての上流リクエストに Authorization: Bearer <key>ヘッダーが付与されます。未設定の場合、 認証ヘッダーは送信されません。（この転送機能も 再構築で独自に追加したものとして明記されています。元のインターフェースは キーなしで取得されましたが、レジストリの記録には Authorizationヘッダーが記載されています。）

転送の仕組み

最初のツール呼び出し時に、クライアントはアップストリームとのストリーミング可能な HTTP セッションを開きます。まず JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、 clientInfo name asinlens）を送信し、続いて notifications/initialized 通知を送信してから、 呼び出し元の引数を変更せずに含めた tools/call リクエストを送信します。アップストリームが initialize への応答で Mcp-Session-Id ヘッダーを返した場合、その値は セッションの後続のすべてのリクエストに付与され、プロセスの存続期間中 再利用されます。応答はプレーンな JSON またはサーバー送信イベントとして届く場合がありますが、どちらも読み取ります。

アップストリームからの成功結果は、アップストリームが設定した isError フラグも含め、 そのまま返されます。 JSON-RPC エラー、2xx 以外のステータス、読み取り不能な応答、 または完了できないリクエストといった失敗は、テキストが asinlens error: で始まる isError 結果として返されます（この表現は この再構築独自のラベル付き再現です）。

CLI

各ツールはサブコマンドとしても使用できます。引数には JSON 文字列を 1 つ指定します（引数を取らないツールでは省略します）。

npx @reneturcios/asinlens get_product_offers '{"asin":"B0CJB6V2L5"}'
npx @reneturcios/asinlens lookup_product '{"identifier":"724382975021","identifier_type":"UPC"}'
npx @reneturcios/asinlens check_credits
npx @reneturcios/asinlens --version

終了コード：成功時は 0、isError 結果の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/asinlens mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "asinlens": {
      "command": "npx",
      "args": ["-y", "@reneturcios/asinlens", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/asinlens
docker run --rm ghcr.io/cloudcorprecords/asinlens --version

コンテナーのデフォルトコマンドは mcp なので、最初の形式は stdio MCP サーバーとして動作します。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC アップストリームに対して実行されます。実際のネットワーク呼び出しはありません。

ライセンス

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