Pangolinfo MCP

🛒 Pangolinfo MCP 服務器

通過 Model Context Protocol 為 AI 助手提供 18 款亞馬遜電商與知識產權數據工具。

🔗 官方網站：www.pangolinfo.com

將你常用的 AI 客戶端（Claude Code、Cursor、Cline、Windsurf、Codex、Hermes、OpenClaw）接入 Pangolinfo 的亞馬遜抓取 API，讓 AI 從自然語言指令出發，運行即時廣告追蹤、Sponsored Products 分析、VOC 情感分析、關鍵詞監控和競品產品審計 —— 以及關鍵詞研究、Listing 分析、評論挖掘、細分市場發現、類目導航、AI 搜索查詢、關鍵詞趨勢檢查與 WIPO 商標清查等能力。

⚠️ 0.7.0 重大變更 —— pacer_search 已停用，合併進 wipo_search

獨立的 pacer_search 工具已被移除。現在通過向 wipo_search 傳入 enableLitigation=true 即可查詢美國專利訴訟（PACER）信息 —— 它在一次調用中查找專利並關聯相關的美國訴訟案件。仍固定使用 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（本地） · streamable HTTP（託管 —— 見下文）
運行時	Node.js 18+
許可證	MIT
獲取 API Key	https://tool.pangolinfo.com/#/en/system/loading?sourceTag=github_amz

---

📦 安裝

推薦：一行安裝器（覆蓋 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。

安裝器完成後，請重啟你的 AI 客戶端，以使其加載新的 mcpServers 條目。

手動安裝（只需下載一個文件）

發佈產物是一個自包含的單一 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 Key

1. 在 https://tool.pangolinfo.com/#/en/system/loading?sourceTag=github_amz 註冊賬號
2. 從控制檯複製你的 pgl_xxxxxxxx 密鑰
3. 如有需要，充值額度（每次亞馬遜抓取調用消耗 0.75 credits；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）—— 無需本地安裝

不想安裝任何東西？將 AI 客戶端指向託管的端點，而不是本地 server.mjs。這是 streamable HTTP 傳輸方式（MCP 規範），支持多租戶 —— 每次請求都攜帶你自己的密鑰。

端點	https://mcp.pangolinfo.com/mcp
傳輸方式	Streamable HTTP（POST + SSE）
認證方式	你的 pgl_xxxxxxxx 密鑰，通過 Bearer 請求頭或 URL 查詢參數傳遞

傳遞 API Key 的兩種方式

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 請求體以 POST 方式發送到 /mcp。
• MCP streamable 傳輸通常要求請求的 Accept 頭同時聲明 application/json 和 text/event-stream。本服務器會為你自動補齊缺失的媒體類型，因此簡單的 Accept: application/json、Accept: */*，甚至完全不帶 Accept 頭均可正常工作 —— 你無需手動構造。
• 返回 401 表示密鑰在請求頭和查詢字符串中均未找到 —— 請檢查你的客戶端是否確實發送了它（某些庫在跨域重定向時會丟棄 Authorization 請求頭）。

---

🧰 工具列表（18 款）

完整協作關係圖（哪些工具串聯調用哪些工具）請見 。

#	工具	用途	消耗（credits）
1	search_amazon	亞馬遜關鍵詞搜索 → 結構化商品列表	0.75
2	get_amazon_product	單個 ASIN 的 Listing 詳情（標題 / 要點 / 特性 / aiReviewsSummary）	0.75
3	get_amazon_reviews	某 ASIN 的批量評論（VOC 挖掘）	0.75
4	list_bestsellers	按類目的亞馬遜暢銷榜	0.75
5	list_new_releases	按類目的亞馬遜新品榜	0.75
6	list_seller_products	某個賣家名下的商品目錄	0.75
7	list_category_products	某個類目葉子節點下的全部商品	0.75
8	search_categories	按關鍵詞搜索亞馬遜類目樹	0.75
9	get_category_children	在類目樹中向下鑽取一層	0.75
10	filter_categories	按條件篩選類目節點	0.75
11	filter_niches	細分市場發現（規模 × 競爭 × 增長）	0.75
12	get_category_paths	解析某類目節點的完整祖先路徑	0.75
13	search_local_maps	Google Maps 本地商家搜索	0.75
14	wipo_search	WIPO 全球外觀設計 / 商標檢索（知識產權清查）。設置 enableLitigation=true 可在同一次調用中一併關聯相關的美國專利訴訟（PACER）案件	2（當 enableLitigation 命中專利時 +12）
15	ai_search	通過 Google SERP 進行 AI 搜索（AI Overview + 自然結果，附合規免責聲明）	2
16	keyword_trends	通過 Google Trends 獲取關鍵詞趨勢（附合規免責聲明）	1.5
17	scrape_url	高級用戶逃生通道：抓取任意亞馬遜原始 URL + parserName（非標準頁面）	0.75
18	search_amazon_alexa	亞馬遜 Rufus AI 對話式商品推薦（基於場景，無需關鍵詞）	6

外加一個免費的本地調用： pangolinfo_capabilities 會返回完整的工具目錄、標準工作流和使用技巧，無需後端往返（0 credits）。它是一款自省輔助工具，並不屬於這 18 款數據工具。

默認市場為 Amazon US（marketplaceId=ATVPDKIKX0DER，zip=90001）。可通過工具參數按次覆蓋。

⏱️ 慢工具與客戶端的工具調用超時

有兩款工具因等待即時 AI 生成而確實耗時較長：

工具	典型延遲	最壞情況
search_amazon_alexa（Rufus）	每個 prompt 60–90 秒	多個 prompt 時 >200 秒
ai_search	約 30 秒	約 60 秒

大多數 MCP 客戶端都會強制執行單次工具調用超時 —— 通常是 60 秒靜默 —— 若超時內沒有任何返回，就會中止調用。此時客戶端會報告傳輸層超時/斷連，而 agent 會誤判為**"工具不可用/已損壞"**。這正是 search_amazon_alexa 常被標記為不可用的原因 —— 它總會穩定越過 60 秒靜默紅線。

以下兩點可避免這種情況發生：

1. 服務器會發出進度心跳。 工具運行期間，服務器每 15 秒發送一次 notifications/progress —— 前提是你的客戶端在調用中帶上了 progressToken。符合規範的客戶端會在每次心跳時重置空閒超時，因此整個 60–90 秒的渲染過程始終處於連接活躍狀態。大多數現代 MCP 客戶端會自動發送 progressToken —— 無需任何操作。

2. 對於不響應進度的客戶端，請調高其超時。 如果你的客戶端不支持 progressToken 或有硬性上限，請在使用 search_amazon_alexa 之前將其 MCP 工具調用超時上調至 ≥120 秒。設置位置取決於客戶端（示例）：

   • Claude Code / 基於配置的客戶端： 在客戶端配置中調高 MCP 請求/工具超時。
   • 自定義 SDK 客戶端： 在 callTool 請求選項中傳入更大的 timeout（並且最好附帶 progressToken）。

此外，建議每次 search_amazon_alexa 調用只用一個 prompt —— 多個 prompt 會線性疊加延遲，從而大大增加超時的可能性。

---

🔐 認證解析順序

服務器按以下優先級解析 API Key：

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 → 操作系統區域設置（$LANG 以 zh* 開頭 → 中文，否則英文）→ 完全無區域信號時默認為英文。因此中文區域設置的機器會自動獲得中文；其他所有情況獲得英文。如需強制指定語言：

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

啟動日誌始終為英文（面向運維人員）；工具描述和錯誤 hint 字段則遵循解析後的區域設置。

---

✅ 驗證安裝

重啟 AI 客戶端後，向它提問：

列出所有可用的 pangolinfo MCP 工具。

你應該看到 18 款工具。然後試試：

使用 pangolinfo_capabilities，模式為 "summary"。

這是一次免費的本地調用 —— 如果它返回了工具目錄，說明你的安裝已正確接通。接下來，運行一個付費調用，例如：

在亞馬遜搜索 "wireless mouse" 並返回前 5 個結果。

預期：扣除約 0.75 credits，返回約 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 入口 + 工具註冊
├── auth.ts             API Key 解析（CLI > 環境變量 > 配置文件）
├── client.ts           HTTP 客戶端（Authorization、User-Agent）
├── errors.ts           PangolinfoError + 狀態碼映射
├── config.ts           默認端點 / 常量
├── i18n.ts             zh/en 翻譯查找
└── tools/
    ├── _types.ts             Tool / ToolContext 類型定義
    ├── index.ts              工具註冊表（18 款工具 + capabilities）
    └── <verb_noun>.ts        每款工具一個文件

新增一款工具

1. 創建 src/tools/<verb_noun>.ts，導出一個 Tool 對象 —— 以 search_amazon.ts 為模板。
2. 在 src/tools/index.ts 中導入它並追加到 tools 數組。
3. Schema 使用 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）外，絕不傳輸到任何其他地方。
• 無遙測。 本服務器不回傳數據、不收集使用分析、不記錄你的 prompt。唯一的對外流量是你通過工具顯式調用的實際 Amazon / Google / WIPO 抓取 API 請求。
• 不收集個人身份信息（PII）。 本服務器不持久化任何用戶賬號信息、郵箱、IP 地理位置，也不保存 prompt 內容。工具調用僅轉發你（或 AI agent）提供的參數。
• 只讀。 每款工具都是嚴格只讀的數據查詢。它們都無法寫入亞馬遜、下訂單、發表評論、修改 Listing，或對第三方平臺執行任何有副作用的操作。
• 僅限 HTTPS 傳輸。 stdio 變體（本地）和託管變體（https://mcp.pangolinfo.com/mcp）均要求 HTTPS；HTTP 請求會被拒絕。
• 開源。 完整源碼在本倉庫中，採用 MIT 許可證 —— 任何人都可以審計服務器發送了什麼、發送到哪裡。
• 負責任使用。 Pangolinfo API 聚合的是公開的電商數據。你有責任確保對返回數據的使用符合底層平臺（Amazon、Google 等）的服務條款以及你所在司法轄區的適用法律。

如發現安全問題，請私下報告至 security@pangolinfo.com —— 請不要為漏洞提交公開的 GitHub issue。

---

💬 支持

• API 文檔：https://docs.pangolinfo.com
• 問題反饋：https://github.com/pangolinfo/pangolinfo-mcp/issues
• 電子郵件：support@pangolinfo.com

---

📄 許可證

MIT © Pangolinfo