Pangolinfo Review Mining MCP

Pangolinfo レビューマイニング MCP

Amazon 商品レビューに特化した、差別化されたレビューマイニング専用の MCP サーバーです。 購入者が何に不満を感じているか、センチメントがどのように推移しているか、どの不満のテーマが中心となっているかを分析します。一般的な Pangolinfo Amazon Data MCP の機能を重複して提供するものではありません。

一般的な Amazon Data MCP との違い

	一般的な Amazon Data MCP	この Review Mining MCP
対象範囲	19 以上のツール：商品検索、商品詳細、ベストセラー、新着商品、販売者、カテゴリー、ニッチ、WIPO、SERP、Alexa	5 つのツール。レビューのみ
目的	Amazon のコマース全般に関するインテリジェンス	レビューマイニング：不満、センチメント、不満のトピック
分析	生データを返します	取得したレビューに対するローカル分析（キーワードによるテーマのタグ付け、分布、月次トレンド、統合レポート）
上流	ホスト型 Pangolinfo MCP サーバー	同じホスト型サーバーの get_amazon_reviews ツールを MCP クライアントとして利用

商品検索やレビュー以外の機能が必要な場合は、一般的な MCP をご利用ください。購入者が何に不満を感じていて、それが時間とともにどのように変化するかを知りたい場合は、こちらをご利用ください。

アーキテクチャ

MCP client (Claude Code, Cursor, Codex, ...)
  └─ stdio ─► this server (src/index.ts)
        └─ Streamable HTTP MCP client ─► https://mcp.pangolinfo.com/mcp
              └─ upstream tool: get_amazon_reviews
        └─ local analysis (src/analysis.ts): tagging, sentiment, topics

このサーバーはブリッジと分析機能を提供します。API キーやレビューデータは保存しません。キーは環境変数から取得され、Authorization: Bearer ヘッダーでホスト型サーバーにのみ送信されます。

直接 REST 呼び出しではなくブリッジを使う理由：Pangolinfo の Review API ドキュメントページにはパラメーターとレスポンスフィールドが記載されていますが、リクエスト URL とサンプルのブロックはテキスト抽出時に失われていました。そのため、直接 REST エンドポイントは未確認であり、意図的にここではハードコードしていません。ブリッジ経由の方法では、確認済みの情報のみを使用します。公式の amazon-data-mcp README に記載されたホスト型エンドポイント（https://mcp.pangolinfo.com/mcp）と、上流の get_amazon_reviews ツール名および入力スキーマ（無料のメタデータ呼び出しを使い、2026-10-26 に tools/list で実稼働環境から確認済み）です。直接 REST を使う方法の今後の対応については、以下の TODO をご覧ください。

セットアップ

要件：Node.js 18 以降（Node 24 で開発・テスト済み）。

npm install
npm run build

実行（ライブモード）：

export PANGOLINFO_API_KEY="your-key-here"   # never commit a real key
node dist/src/index.js

実行（モックモード。ネットワーク接続やキーは不要。テストとデモ用）：

PANGOLINFO_REVIEW_MINING_MOCK=1 node dist/src/index.js

MCP クライアントの設定例（Claude Code スタイル）：

{
  "mcpServers": {
    "pangolinfo-review-mining": {
      "command": "node",
      "args": ["/absolute/path/to/pangolinfo-review-mining-mcp/dist/src/index.js"],
      "env": { "PANGOLINFO_API_KEY": "your-key-here" }
    }
  }
}

環境変数：

変数	必須	用途
PANGOLINFO_API_KEY	はい（ライブモード）	ホスト型 Pangolinfo MCP サーバー用のベアラートークン
PANGOLINFO_MCP_URL	いいえ	上流の MCP エンドポイント。デフォルトは https://mcp.pangolinfo.com/mcp
PANGOLINFO_REVIEW_MINING_MOCK	いいえ	=1 でモックモード（モックレビュー、ネットワーク接続なし）が有効になります

ツール（5つ、すべてレビュー分析専用）

ツール	内容	主な入力
get_product_reviews	1つのASINのレビューをページネーションで取得し、課金額（pointCost）をそのまま報告します	asin（必須）、site、pageCount（1～10）、filterByStar、sortBy、mediaType
mine_complaints	否定的なレビュー（「critical」、星1～3）から苦情の兆候を抽出し、それぞれにテーマと該当キーワードを付与します。minHelpfulで絞り込むこともできます	asin、site、pageCount、minHelpful
review_sentiment_summary	評価の分布、平均評価、否定的／批判的／肯定的なレビューの割合、月ごとの傾向を表示します	asin、site、pageCount
top_complaint_topics	苦情のテーマを件数、割合、タイトル例とともにランキング形式で表示します	asin、site、pageCount、topN
review_mining_report	ASINごとの概要をまとめて表示します。合計、感情、上位のテーマ、最も賛同されている苦情、課金情報を含みます。B0FQFB8FMGの10月12日のベースラインは、過去の参考情報としてのみ引用します	asin、site、pageCount

苦情のテーマ（英語キーワードによるヒューリスティック、v1 — 分類器ではなく、透明性を重視）：quality_defect、battery_power、connectivity、comfort_fit、sound_quality、shipping_delivery、returns_refunds、value_price、authenticity、app_software。一致した場合はすべて、該当したキーワードを報告します。

マーケットプレイス（site）：amz_us（デフォルト）、amz_de、amz_uk、amz_jp、amz_fr、amz_it、amz_es、amz_br、amz_au、amz_mx、amz_in、amz_eg、amz_ae、amz_ca

課金

• Review APIのドキュメントでは1ページあたり5クレジットと記載されています（ドキュメントには「积点消耗：5个/次」、またbizContext.pageCountによるページ単位の課金も記載）。2026年10月に測定したget_amazon_reviewsの呼び出しでは、1ページ分のpointCost: 5が返されました。
• **不一致に関する注意：**上流のMCPツールの説明には、現在、1ページあたり10クレジットと記載されています。このサーバーは断定によってこの不一致を解消しません。各ツールは上流のレスポンスで返されたpointCostをそのまま報告し、各レスポンスの課金に関する注記には両方の数値を記載します。
• 無料プランは月60クレジットで、毎月繰り返し利用できます。測定された1ページあたり5クレジットのレートでは、月に約12ページ分のレビューを取得できます。pageCountは予算に合わせて設定してください。review_mining_reportは上流へのフェッチを2回（all_stars + critical）行うため、1回のフェッチの2倍の費用がかかります。
• 保存されていたPangolinfo APIキーは有効期限が切れています（2026-10-24に測定）。キーが再接続されるまで、ライブ環境でのエンドツーエンドテストは保留中です。TEST_REPORT.mdを参照してください。

テスト

npm test   # builds, then runs node --test on dist/test/

ビルド時点で17件のテストがすべて合格しています（TEST_REPORT.mdを参照）。分析のユニットテスト、モックされた上流サービスを使ったツールハンドラーのテスト、10月12日のベースラインのフィクスチャテスト、そしてモックモードで実サーバーを起動し、MCP JSON-RPCで通信するstdioのスモークテストが含まれています。テスト用のレビューはすべてモックデータです（合成した投稿者「Mock Reviewer A」など）。リポジトリ内の実測値は、fixtures/airpods-pro-3-baseline.jsonにある集計済みのベースライン値（ASIN B0FQFB8FMGのレビュー総数4,268件、否定的なレビュー1,392件。2026-10-12に測定。参考情報のみ）だけです。

制限事項（結果を事実として提示する前にお読みください）

• 苦情のタグ付けには、感情分析の機械学習ではなく、英語キーワードによるヒューリスティックを使用しています。各言語の辞書が追加されるまでは、英語以外のレビューは十分に検出されません。
• 星の評価は「5.0 out of 5 stars」のような文字列から取得します。解析できない星の値はunknownに分類され、平均から除外されます。
• 日付は「October 14, 2026」のような文字列から取得します。解析できない日付は、月別のunknown区分に分類されます。
• totalReviewsは上流から文字列として返され、利用できない場合は空になることがあります。値はそのまま渡され、計算し直されることはありません。
• review_mining_reportはall_stars + criticalを取得するため、レビュー件数は重複を除いた単一のサンプルではなく、各フェッチごとの件数です。

公開状況（2026-10-26）

mcprush が受け付けるのは MCP サーバーまたはエージェントスキルのみです（2026-10-26 に確認済み： サーバー登録ウィザードではリポジトリ／npm／PyPI／コンテナ／ホスト型 MCP エンドポイントが必須で、initialize と tools/list の検証に合格する必要があります）。

• GitHub リポジトリ：https://github.com/Pangolin-spg/pangolinfo-review-mining-mcp で公開中
• npm パッケージ：pangolinfo-review-mining-mcp 0.1.1、2026-10-26 に公開（0.1.0 は同日に初回公開。0.1.1 では MCP Registry に必要な mcpName フィールドを追加）
• mcprush の掲載：2026-10-26 に申請、審査中（予定 URL： https://mcprush.com/pangolin-spg/pangolinfo-review-mining-mcp）
• サーバーカードに必要な情報：名前、1 行の説明、機能と対象ユーザーを 120 文字以上で説明する段落。
• 料金：無料プラン、またはプラン名、月額料金、呼び出し回数の上限が設定された有料プラン。審査には最大 2 営業日かかります。
• 読み取り専用の確認時、申請フォームの展開された手順には動画／紹介 URL のフィールドは見当たりませんでした。表示された場合は、プロジェクトの紹介動画として保存済みの Pangolinfo EN/ZH 動画を使用します。
• バックリンクのルール（継続適用）：掲載情報から pangolinfo.com のコンテンツにリンクする場合、GA4 の参照元アトリビューションのため、必ず ?utm_source=<platform>&utm_medium=referral を付けてください（1 つのプラットフォームで複数の製品を扱う場合は、さらに utm_content=<product> を付けてください）。

TODO／未確認項目

1. 直接 REST エンドポイント（未確認）： ドキュメントページのリクエスト URL とサンプルブロックを抽出できず、Review API の REST URL を記録したワークスペースファイルもありません。ブリッジ設計ではこの URL は不要ですが、ドキュメントまたは実測した呼び出しで URL を確認するまで、直接 REST モードを追加しないでください。
2. ライブのエンドツーエンドテスト（2026-10-26 に完了）： 一時的な 7 日間有効のキーで、ASIN B0FQFB8FMG に対する get_product_reviews と mine_complaints を検証しました。テスト時点で、各ページの料金は 5 クレジット、レビュー総数は 4,446 件、批判的なレビューは 1,457 件でした。
3. 課金の不一致（2026-10-26 に解決）： ライブの pointCost は 1 ページあたり 5 です。上流ツールの説明にある 1 ページあたり 10 という記載は古くなっています。
4. 公開（2026-10-26 に完了）： GitHub リポジトリは公開済み、npm 0.1.0 は公開済み、mcprush の掲載は申請済み（審査中）。