Pangolinfo MCP

🐜 pangolinfo-mcp

Pangolinfo MCP サーバー — Model Context Protocol 経由で AI アシスタントに提供する Amazon Eコマース & IPデータ向けの18種のツール。

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

お使いの AI クライアント（Claude Code、Cursor、Cline、Windsurf、Codex、Hermes、OpenClaw）を Pangolinfo の Amazon スクレイプ API に接続するだけで、AI が リアルタイム広告トラッキング、スポンサープロダクト分析、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 インターフェースからサードパーティのブランド名を排除するため、ツール名が変更されました。 ツールのパラメータ、戻り値の形式、価格は変更されていません。

🚀 インストール

推奨: ワンラインインストーラー（7 種の AI クライアント対応）

Pangolinfo インストーラーはお使いの 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 スクレイプ呼び出しは 1 回あたり 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" }
    }
  }
}

JSON を手動編集する代わりに claude mcp add --scope user pangolinfo node /abs/path/to/dist/server.mjs の使用をおすすめします — 同じエントリを書き込みます。

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 クライアントを接続します。これは streamable HTTP トランスポート（MCP 仕様）で、マルチテナント方式です — リクエストごとに自分のキーを持ち込みます。

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 の streamable トランスポートは通常、リクエストの Accept ヘッダーに application/json と text/event-stream の両方を要求します。 このサーバーは不足しているメディアタイプを自動的に補完するため、単純な Accept: application/json、Accept: */*、あるいは Accept ヘッダーが欠落していても動作します — 手動で作り込む必要はありません。
• 401 は、キーがヘッダーまたはクエリ文字列のいずれにも見つからなかったことを意味します — クライアントが実際に送信したか確認してください（一部のライブラリはクロスオリジンリダイレクトで Authorization ヘッダーを落とします）。

🧰 ツール（18 種）

ツール同士の連携グラフ（どのツールがどのツールへ連鎖するか）の全体像は を参照してください。

さらに無料のローカル呼び出し: pangolinfo_capabilities は、バックエンドへのラウンドトリップなし（0 クレジット）で、完全なツールカタログ、正規のワークフロー、使用のヒントを返します。これは自己イントロスペクション用のヘルパーであり、18 種のデータツールには含まれません。

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

⏱️ 低速なツールとクライアントのツール呼び出しタイムアウト

2 つのツールは、ライブの AI 生成を待つため、正当に実行時間が長くなります:

ほとんどの 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 クライアントを再起動したら、次のように尋ねてください:

List all available pangolinfo MCP tools.

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

Use pangolinfo_capabilities with mode "summary".

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

Search Amazon for "wireless mouse" and return the top 5 results.

期待される結果: 約 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 スクレイプ API 呼び出しのみです。
• PII 収集なし。 ユーザーアカウント情報、メール、IP 地理位置情報、プロンプト内容はこのサーバーに保存されません。ツール呼び出しは、あなた（または AI エージェント）が指定したパラメータのみを転送します。
• 読み取り専用。 すべてのツールは厳密に読み取り専用のデータルックアップです。いずれも Amazon への書き込み、注文、レビュー投稿、リスティング変更、その他サードパーティプラットフォーム上での副作用のある操作はできません。
• HTTPS のみのトランスポート。 stdio 版（ローカル）とホスト版（https://mcp.pangolinfo.com/mcp）はどちらも HTTPS を要求します; HTTP リクエストは拒否されます。
• オープンソース。 完全なソースはこのリポジトリに MIT ライセンスの下で存在します — サーバーが何をどこへ送信するかを誰でも監査できます。
• 責任ある利用。 Pangolinfo API は公開 Eコマースデータを集約します。返されたデータを、基盤となるプラットフォーム（Amazon、Google など）の利用規約と、お住まいの地域の適用法に準拠して使用する責任はあなたにあります。

セキュリティ問題は security@pangolinfo.com に非公開で報告してください — 脆弱性について公開 GitHub issue を立てないでください。

💬 サポート

• API ドキュメント: https://docs.pangolinfo.com
• issues: https://github.com/pangolinfo/pangolinfo-mcp/issues
• メール: support@pangolinfo.com

📄 ライセンス

MIT © Pangolinfo