Pangolinfo-mcp

pangolinfo-mcp

Pangolinfo MCP サーバー — Model Context Protocol を介して AI アシスタントに Amazon の EC コマースおよび IP データを提供する 18 個のツールです。

🔗 公式サイト：www.pangolinfo.com

お好みの AI クライアント（Claude Code、Cursor、Cline、Windsurf、Codex、Hermes、OpenClaw）を Pangolinfo の Amazon Scraper API に接続すれば、AI に リアルタイム広告トラッキング、Sponsored Products 分析、VOC 感情分析、キーワードモニタリング、競合商品の監査を実行させることができます。さらに、キーワード調査、商品リスティング分析、レビュー分析、ニッチ市場の発見、カテゴリーの閲覧、AI 検索、キーワードトレンドの確認、WIPO 商標クリアランスも、自然言語の指示だけで行えます。

⚠️ 0.7.0 での重大な変更 — pacer_search を廃止し、wipo_search に統合しました

単独の pacer_search ツールは削除されました。米国の特許訴訟（PACER）の検索は、 wipo_search に enableLitigation=true を渡して実行できるようになりました。このツールは特許を検索し、 関連する米国の訴訟事例も 1 回の呼び出しで取得します。pacer_search を指定している プロンプトやスクリプトは ToolNotFound になるため、enableLitigation を指定した wipo_search に切り替えてください。

以前の重大な変更（0.3.0 — ツール名の変更）

旧名称（≤ 0.2.x）	新名称（0.3.0 以降）
google_ai_search	ai_search
google_trends	keyword_trends

公開 MCP インターフェースからサードパーティブランドへの言及をなくすため、ツール名を変更しました。 ツールのパラメーター、戻り値の形式、料金に変更はありません。

バージョン	0.7.3
ツール	18 個のビジネスツール（無料のローカル pangolinfo_capabilities 情報取得呼び出しを追加）
トランスポート	stdio（ローカル） · ストリーミング可能な HTTP（ホスト型 — 下記参照）
ランタイム	Node.js 18 以降
ライセンス	MIT
API キーの取得	https://tool.pangolinfo.com/#/en/system/loading?sourceTag=github_amz

---

インストール

おすすめ：1 行インストーラー（7 種類の AI クライアントに対応）

Pangolinfo Installer が AI クライアントを検出し、適切な設定ファイルを書き込むので、あとは完了するのを待つだけです。--scope=mcp を渡すと、この MCP サーバーのみをインストールし、Skills パッケージをスキップします。

macOS / Linux

curl -fsSL https://pangolinfo.dev/install.sh | sh -s -- \
  --agent=<your-agent> \
  --scope=mcp \
  --api-key=pgl_xxxxxxxxxxxx

Windows（PowerShell）

irm https://pangolinfo.dev/install.ps1 | iex; `
  Install-Pangolinfo -Agent <your-agent> -Scope mcp -ApiKey pgl_xxxxxxxxxxxx

<your-agent> に指定できる値は、claude-code、cursor、cline、windsurf、codex、hermes、openclaw です。

インストーラーの実行後、新しい mcpServers エントリーを読み込ませるため、AI クライアントを再起動してください。

手動インストール（ファイルを 1 つダウンロードするだけ）

リリース成果物は 自己完結型の単一ファイル server.mjs（約 800 KB）です。依存関係はすべてバンドルされているため、npm install は不要です。

# macOS / Linux
mkdir -p ~/.local/lib/pangolinfo-mcp
curl -fsSL https://github.com/pangolinfo/pangolinfo-mcp/releases/latest/download/server.mjs \
  -o ~/.local/lib/pangolinfo-mcp/server.mjs
chmod +x ~/.local/lib/pangolinfo-mcp/server.mjs

# Windows (PowerShell)
$dir = "$env:LOCALAPPDATA\pangolinfo-mcp"
New-Item -ItemType Directory -Force -Path $dir | Out-Null
irm https://github.com/pangolinfo/pangolinfo-mcp/releases/latest/download/server.mjs `
  -OutFile "$dir\server.mjs"

その後、AI クライアントに接続します。クライアントごとの設定例は以下を参照してください。args には、ダウンロードしたファイルのパスを指定します。

開発者向け：ソースからビルドするには、このリポジトリを git clone し、npm install && npm run build を実行してください。生成される dist/server.mjs はリリースアセットと同一です。

---

API キーの取得

1. https://tool.pangolinfo.com/#/en/system/loading?sourceTag=github_amz で登録します
2. ダッシュボードから pgl_xxxxxxxx キーをコピーします
3. 必要に応じてクレジットをチャージします（Amazon Scraper API の各呼び出しには 0.75 クレジットがかかります。pangolinfo_capabilities は無料です）

---

手動設定（AI クライアントごと）

/abs/path/to/pangolinfo-mcp/dist/server.mjs を実際のパスに、pgl_xxxxxxxx をご自身のキーに置き換えてください。

Claude Code（~/.claude/settings.json）

{
  "mcpServers": {
    "pangolinfo": {
      "command": "node",
      "args": ["/abs/path/to/pangolinfo-mcp/dist/server.mjs"],
      "env": { "PANGOLINFO_API_KEY": "pgl_xxxxxxxx" }
    }
  }
}

claude mcp add --scope user pangolinfo node /abs/path/to/dist/server.mjs の使用をおすすめします。JSON を手動編集せず、同じエントリーを追加できます。

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "pangolinfo": {
      "command": "node",
      "args": ["/abs/path/to/pangolinfo-mcp/dist/server.mjs"],
      "env": { "PANGOLINFO_API_KEY": "pgl_xxxxxxxx" }
    }
  }
}

Cline（VS Code 拡張機能）

Cline → MCP Servers → Edit settings JSON を開き、次を追加します。

{
  "mcpServers": {
    "pangolinfo": {
      "command": "node",
      "args": ["/abs/path/to/pangolinfo-mcp/dist/server.mjs"],
      "env": { "PANGOLINFO_API_KEY": "pgl_xxxxxxxx" }
    }
  }
}

設定ファイルは <vscode-user>/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json にあります。 スタンドアロンの Cline CLI を使用する場合は、代わりに ~/.cline/data/settings/cline_mcp_settings.json を使用してください。

Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "pangolinfo": {
      "command": "node",
      "args": ["/abs/path/to/pangolinfo-mcp/dist/server.mjs"],
      "env": { "PANGOLINFO_API_KEY": "pgl_xxxxxxxx" }
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.pangolinfo]
command = "node"
args = ["/abs/path/to/pangolinfo-mcp/dist/server.mjs"]

[mcp_servers.pangolinfo.env]
PANGOLINFO_API_KEY = "pgl_xxxxxxxx"

Hermes (~/.hermes/config.yaml)

mcp_servers:
  pangolinfo:
    command: node
    args: ["/abs/path/to/pangolinfo-mcp/dist/server.mjs"]
    env:
      PANGOLINFO_API_KEY: pgl_xxxxxxxx

OpenClaw (~/.openclaw/openclaw.json)

{
  "mcpServers": {
    "pangolinfo": {
      "command": "node",
      "args": ["/abs/path/to/pangolinfo-mcp/dist/server.mjs"],
      "env": { "PANGOLINFO_API_KEY": "pgl_xxxxxxxx" }
    }
  }
}

---

ホステッド（リモート HTTP）— ローカルへのインストール不要

何もインストールしたくない場合は、ローカルの server.mjs の代わりに、AI クライアントをホステッドエンドポイントに接続してください。これはストリーミング可能な HTTP（MCP 仕様）トランスポートで、マルチテナント方式です。リクエストごとにご自身のキーを使用します。

エンドポイント	https://mcp.pangolinfo.com/mcp
トランスポート	Streamable HTTP（POST + SSE）
認証	Bearer ヘッダーまたは URL クエリで、ご自身の pgl_xxxxxxxx キーを指定

API キーの指定方法 — 2 通り

1. Authorization ヘッダー（推奨）

Authorization: Bearer pgl_xxxxxxxx

こちらが推奨される方法です。キーが URL、ログ、ブラウザー履歴に残りません。Bearer スキームは大文字と小文字を区別せず（bearer、BEARER、Bearer のいずれも動作します）、余分な空白も許容されます。

2. ?api_key= URL クエリ（代替手段）

https://mcp.pangolinfo.com/mcp?api_key=pgl_xxxxxxxx

URL を貼り付ける方法しか使えないクライアントに最適です。キーに URL で特別な意味を持つ文字が含まれる場合は、URL エンコードしてください。両方が指定された場合は、ヘッダー（方法 1）が優先されます。

クライアント設定例（Claude Code / Cursor — "url" 形式のリモート MCP）

{
  "mcpServers": {
    "pangolinfo": {
      "url": "https://mcp.pangolinfo.com/mcp",
      "headers": { "Authorization": "Bearer pgl_xxxxxxxx" }
    }
  }
}

クライアントでヘッダーを設定できない場合は、URL 形式を使用してください。 "url": "https://mcp.pangolinfo.com/mcp?api_key=pgl_xxxxxxxx"。

カスタム／HTTP を直接使用する連携に関する注意

標準の MCP クライアントを介さず、エンドポイントを直接呼び出す場合：

• JSON-RPC ボディを /mcp にPOSTしてください。
• MCP のストリーミング可能なトランスポートでは通常、リクエストの Accept ヘッダーに application/json と text/event-stream の両方を指定する必要があります。このサーバーは不足しているメディアタイプを補完するため、Accept: application/json、Accept: */*、または Accept ヘッダーがない場合でも動作します。手動で指定する必要はありません。
• 401 は、ヘッダーにもクエリ文字列にもキーが見つからなかったことを意味します。クライアントから実際に送信されたことを確認してください（ライブラリーによっては、クロスオリジンリダイレクト時に Authorization ヘッダーが削除されることがあります）。

---

ツール（20）

ツール間の連携グラフ（どのツールがどのツールにつながるか）全体については、MCP-TOOLS-MAP.md を参照してください。

#	ツール	用途	コスト（クレジット）
1	search_amazon	Amazon のキーワード検索 → 構造化された商品リスト	0.75
2	get_amazon_product	単一 ASIN の出品詳細（タイトル／箇条書き／特徴／type と section を含む動画／aiReviewsSummary）	0.75
3	get_amazon_delivery_time	配送先ごとの配達予定を含む単一 ASIN の出品詳細	2
4	get_amazon_reviews	ASIN のレビューを一括取得（VOC 分析）。フランス（site: "amz_fr" → www.amazon.fr）と日本（amz_jp）を含む11のマーケットプレイスに対応	0.75
5	list_bestsellers	カテゴリー別の Amazon ベストセラー	0.75
6	list_new_releases	カテゴリー別の Amazon 新着商品	0.75
7	list_seller_products	1つの販売者が出品する商品のカタログ	0.75
8	list_category_products	カテゴリー末端のすべての商品	0.75
9	search_categories	キーワードで Amazon のカテゴリー階層を検索	0.75
10	get_category_children	カテゴリー階層を1階層掘り下げる	0.75
11	filter_categories	条件でカテゴリーのノードを絞り込む	0.75
12	filter_niches	ニッチを発見する（規模 × 競合 × 成長）	0.75
13	get_category_paths	カテゴリーノードの祖先までの完全なパスを解決	0.75
14	search_local_maps	Google Maps で地域のビジネスを検索	0.75
15	wipo_search	WIPO の世界規模の意匠／商標検索（知的財産のクリアランス）。enableLitigation=true を設定すると、同じ呼び出しで関連する米国の特許訴訟（PACER）案件も結合します	2（enableLitigation により特許が見つかった場合は +12）
16	ai_search	Google SERP による AI 検索（AI Overview + オーガニック検索結果、コンプライアンスに関する免責事項付き）	2
17	keyword_trends	Google Trends によるキーワードトレンド（コンプライアンスに関する免責事項付き）	1.5
18	scrape_url	上級ユーザー向けの回避策：生の Amazon URL と parserName を指定してスクレイピング（標準外のページ）	0.75
19	search_amazon_alexa	Amazon Rufus AI による会話形式の商品候補（シーンベース、キーワード不要）	6
20	get_amazon_alexa_questions	Alexa Listing API：ASIN に紐づく PDP のプリセット質問を抽出し、任意で各質問に回答	発見結果に応じて0／5 + 回答した地域ごとに20（最大45）

競合出品を取得するには、parserName=amzFollowSeller を指定して scrape_url を呼び出し、content に ASIN を指定するか、Amazon の商品 URL を指定してください。返される各項目には、soldBy、hasSoldByLink（リンク付きの販売者名かプレーンテキストか）、およびおすすめ出品の場合は任意で isFeatured が含まれます。

さらに無料のローカル呼び出し： pangolinfo_capabilities は、バックエンドへの往復なしで、ツールカタログ全体、標準的なワークフロー、使用上のヒントを返します（クレジット 0）。これは自己 introspection 用のヘルパーであり、20種類のデータツールには含まれません。

デフォルトのマーケットプレイスは Amazon US（marketplaceId=ATVPDKIKX0DER、zip=90001）です。ツール引数を使って呼び出しごとに上書きできます。

⏱️ 実行に時間がかかるツールとクライアントのツール呼び出しタイムアウト

ライブ AI 生成の完了を待つため、正当に時間がかかるツールが 2 つあります。

ツール	通常の待ち時間	最長の場合
search_amazon_alexa（Rufus）	プロンプトごとに 60～90 秒	複数のプロンプトでは 200 秒超
ai_search	約 30 秒	約 60 秒

ほとんどの MCP クライアントは、ツール呼び出しごとにタイムアウトを設定しており、無応答の状態が 60 秒続く場合もあります。その間に応答がないと呼び出しを中断します。このときクライアントはトランスポートレベルのタイムアウト／切断を報告し、エージェントは**「ツールが利用できない／壊れている」**と誤認します。search_amazon_alexa が利用不可と判断される一般的な原因はこれです。このツールは無応答状態が 60 秒を超えるためです。

これを防ぐ方法は 2 つあります。

1. サーバーが進行状況を示すハートビートを送信します。 ツールの実行中、呼び出しに progressToken が含まれていれば、サーバーは 15 秒ごとに notifications/progress を送信します。仕様に準拠したクライアントはハートビートを受け取るたびにアイドルタイムアウトをリセットするため、60～90 秒かかる生成処理もタイムアウトせずに完了します。最近の MCP クライアントのほとんどは progressToken を自動的に送信するため、特別な操作は不要です。

2. 進行状況通知に対応していないクライアントでは、タイムアウトを延長します。 クライアントが progressToken に対応していない場合や、上限が固定されている場合は、search_amazon_alexa を使う前に MCP のツール呼び出しタイムアウトを 120 秒以上に設定してください。設定方法はクライアントによって異なります（例）：

   • Claude Code／設定ファイルを使うクライアント： クライアント設定で MCP リクエスト／ツールのタイムアウトを延長します。
   • カスタム SDK クライアント： callTool リクエストのオプションで、より長い timeout（可能であれば progressToken も）を渡します。

また、search_amazon_alexa の呼び出しごとにプロンプトは必ず 1 つだけ指定してください。複数のプロンプトを指定すると待ち時間が直線的に増加し、タイムアウトが発生しやすくなります。

---

認証情報の解決順序

サーバーは次の優先順位で API キーを解決します。

1. CLI 引数：--api-key=pgl_xxx --api-base=... --scrape-base=...
2. 環境変数：PANGOLINFO_API_KEY、PANGOLINFO_API_BASE、PANGOLINFO_SCRAPE_BASE
3. ~/.pangolinfo/config.json の設定ファイル：

   {
     "api_key": "pgl_xxxxxxxxxxxx",
     "api_base": "https://extapi.pangolinfo.com",
     "scrape_base": "https://scrapeapi.pangolinfo.com"
   }
   

4. キーが見つからない場合 → 対処方法を示すエラーを出して起動に失敗します。

CLI 引数は環境変数より優先されます。グローバル環境を汚さずにサーバーごとに異なるキーを設定できるので便利です。

---

国際化

ツールの説明とエラーヒントは英語と中国語で利用できます。言語は次の順序で解決されます。--lang=zh|en → PANGOLINFO_LANG=zh|en → OS のロケール（$LANG が zh* で始まる場合は中国語、それ以外は英語）→ ロケール情報がない場合は英語。つまり、中国語ロケールのマシンでは自動的に中国語になり、それ以外では英語になります。言語を明示的に指定するには、次のようにします。

"env": {
  "PANGOLINFO_API_KEY": "pgl_xxxxxxxx",
  "PANGOLINFO_LANG": "zh"
}

起動ログは常に英語（運用者向け）で表示されます。ツールの説明とエラーの hint フィールドには、解決されたロケールが適用されます。

---

インストールの確認

AI クライアントを再起動した後、次のように尋ねてください。

利用可能な pangolinfo MCP ツールをすべて一覧表示してください。

18 個のツールが表示されるはずです。次に、次のように試してください。

mode "summary" で pangolinfo_capabilities を使ってください。

これは無料のローカル呼び出しです。ツールカタログが返されれば、インストールは正しく接続されています。次に、次のような有料の処理を実行してください。

Amazon で「ワイヤレスマウス」を検索し、上位 5 件の結果を返してください。

想定される結果：約 0.75 クレジットが差し引かれ、約 300 KB の構造化された商品データが返されます。

---

開発

npm install
npm run dev        # tsx src/server.ts — hot-reload
npm run build      # esbuild → dist/server.mjs
npm run typecheck  # tsc --noEmit
npm start          # node dist/server.mjs

プロジェクト構成

src/
├── server.ts           MCP stdio entry + tool registration
├── auth.ts             API key resolution (CLI > env > config file)
├── client.ts           HTTP client (Authorization, User-Agent)
├── errors.ts           PangolinfoError + status-code mapping
├── config.ts           Default endpoints / constants
├── i18n.ts             zh/en translation lookup
└── tools/
    ├── _types.ts             Tool / ToolContext type definitions
    ├── index.ts              Tool registry (18 tools + capabilities)
    └── <verb_noun>.ts        One file per tool

新しいツールの追加

1. src/tools/<verb_noun>.ts を作成し、Tool オブジェクトをエクスポートします。search_amazon.ts を参考にしてください。
2. src/tools/index.ts でインポートし、tools 配列に追加します。
3. スキーマには zod を使い、すべてのフィールドに .describe() を指定します。AI はその説明を読み取ります。
4. fetch を直接呼び出さないでください。ctx.client.post(...) を使います。認証情報はすでに注入されています。
5. 失敗時には PangolinfoError をスローします。HTTP クライアントは、2xx 以外のレスポンスに対してすでにこのエラーをスローします。

---

セキュリティとデータの取り扱い

オペレーターとユーザーの安全を重視しています。この MCP サーバーは、設計上、次のとおりです。

• ご自身のキーをご利用ください。 認証には、個人用の PANGOLINFO_API_KEY（https://tool.pangolinfo.com/#/en/system/loading?sourceTag=github_amz で発行）を使用します。キーは AI クライアントの設定または環境からローカルで読み込まれ、TLS 1.2+ を介して https://scrapeapi.pangolinfo.com（ホステッド版では https://mcp.pangolinfo.com）以外に送信されることはありません。
• テレメトリーはありません。 このサーバーはホームに接続せず、使用状況の分析データを収集せず、プロンプトを記録しません。外部への通信は、ツールを通じて明示的に呼び出した Amazon／Google／WIPO Scraper API の実際の呼び出しのみです。
• 個人を特定できる情報は収集しません。 このサーバーは、ユーザーアカウント情報、メールアドレス、IP アドレスによる位置情報、プロンプトの内容を保存しません。ツール呼び出しでは、ユーザー（または AI エージェント）が指定したパラメーターのみを転送します。
• 読み取り専用です。 すべてのツールは厳密に読み取り専用のデータ検索を行います。Amazon への書き込み、注文、レビューの投稿、出品情報の変更、サードパーティープラットフォーム上での副作用を伴う操作は一切できません。
• HTTPS のみの通信です。 stdio 版（ローカル）とホステッド版（https://mcp.pangolinfo.com/mcp）の両方で HTTPS が必須です。HTTP リクエストは拒否されます。
• オープンソースです。 完全なソースコードは、このリポジトリで MIT ライセンスのもと公開されています。サーバーが何をどこに送信するかは、誰でも監査できます。
• 責任ある利用をお願いします。 Pangolinfo API は、公開されている e コマースデータを集約します。返されたデータを、基盤となるプラットフォーム（Amazon、Google など）の利用規約および適用される法令に従って使用する責任は、ユーザーにあります。

セキュリティ上の問題は [email protected] まで非公開でご報告ください。脆弱性について、公開の GitHub Issue を作成しないでください。

---

サポート

• API ドキュメント：https://docs.pangolinfo.com
• Issue：https://github.com/pangolinfo/pangolinfo-mcp/issues
• メール：[email protected]

---

ライセンス

MIT © Pangolinfo