Pangolinfo-mcp

pangolinfo-mcp

Pangolinfo MCP 服务——通过 Model Context Protocol 为 AI 助手提供 18 种亚马逊电商与 IP 数据工具。

🔗 官方网站：www.pangolinfo.com

将你喜爱的 AI 客户端（Claude Code、Cursor、Cline、Windsurf、Codex、Hermes、OpenClaw）接入 Pangolinfo 的 Amazon Scraper 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 密钥	https://tool.pangolinfo.com/#/en/system/loading?sourceTag=github_amz

---

安装

推荐：一行安装程序（支持 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。

安装程序运行完毕后，重启 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 密钥

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）——无需本地安装

不想安装任何东西？将 AI 客户端指向托管端点，而不是本地的 server.mjs。这是 streamable HTTP 传输方式（MCP 规范），支持多租户——每次请求都需要提供你自己的密钥。

端点	https://mcp.pangolinfo.com/mcp
传输方式	Streamable HTTP（POST + SSE）
认证	你的 pgl_xxxxxxxx 密钥，通过 Bearer 标头 或 URL 查询参数传递

传递 API 密钥的两种方式

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 客户端）：

• 向 /mcp POST 你的 JSON-RPC 请求正文。
• MCP 流式传输通常要求请求在 Accept 标头中声明 两种类型：application/json 和 text/event-stream。此服务会为你补充缺失的媒体类型，因此即使使用普通的 Accept: application/json、Accept: */*，甚至不提供 Accept 标头，也都可以正常工作——你无需手动构造该标头。
• 401 表示在标头和查询字符串中都未找到密钥——请确认客户端确实已发送密钥（某些库会在跨域重定向时丢弃 Authorization 标头）。

---

工具（20）

完整的协调图（哪些工具会串联调用哪些工具）请参阅 MCP-TOOLS-MAP.md。

#	Tool	Purpose	Cost (credits)
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 挖掘）；支持 11 个站点，包括法国（site: "amz_fr" → www.amazon.fr）和日本（amz_jp）	0.75
5	list_bestsellers	按类别查看 Amazon 畅销商品	0.75
6	list_new_releases	按类别查看 Amazon 新品	0.75
7	list_seller_products	获取单个卖家旗下的产品目录	0.75
8	list_category_products	获取某个末级类别中的所有产品	0.75
9	search_categories	按关键词搜索 Amazon 类别树	0.75
10	get_category_children	在类别树中向下钻取一级	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 积分，即可返回完整工具目录、标准工作流和使用技巧。这是用于自我检查的辅助工具，不属于 20 个数据工具之一。

默认站点为 Amazon US（marketplaceId=ATVPDKIKX0DER，zip=90001）。可通过工具参数按调用覆盖。

⏱️ 工具运行缓慢与客户端的工具调用超时

有两个工具会合理地运行较长时间，因为它们需要等待 AI 实时生成：

工具	典型延迟	最长情况
search_amazon_alexa（Rufus）	每条提示词 60–90s	多条提示词时 >200s
ai_search	~30s	~60s

大多数 MCP 客户端都设有单次工具调用超时——通常在静默 60 秒后触发，如果届时没有返回任何内容，就会中止调用。此时客户端会报告传输层超时/断开连接，而 Agent 会误以为**“工具不可用/已损坏”**。search_amazon_alexa 通常会被标记为不可用，原因就在于此——它总会超过静默 60 秒的限制。

以下两点可以避免这种情况：

1. 服务会发送进度心跳。 工具运行期间，如果客户端在调用中包含了 progressToken，服务每 15 秒会发送一次 notifications/progress。符合规范的客户端会在每次收到心跳时重置空闲超时，因此整个 60–90s 的生成过程都能顺利完成。大多数现代 MCP 客户端会自动发送 progressToken，无需额外操作。

2. 对于不支持进度通知的客户端，请调高超时时间。 如果客户端不支持 progressToken 或有固定的超时上限，请在使用 search_amazon_alexa 前，将 MCP 工具调用超时调至 ≥120s。具体设置位置因客户端而异（示例）：

   • Claude Code / 基于配置的客户端： 在客户端配置中调高 MCP 请求/工具超时。
   • 自定义 SDK 客户端： 在 callTool 请求选项中传入更大的 timeout（最好也传入 progressToken）。

此外，尽量让每次 search_amazon_alexa 调用只包含一条提示词——多条提示词会使延迟线性叠加，大幅增加超时的可能性。

---

身份验证解析顺序

服务按以下优先级解析 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 个工具。然后尝试：

使用 pangolinfo_capabilities，模式设为 "summary"。

这是一次免费的本地调用——如果它返回工具目录，说明安装配置正确。接下来，运行一项付费操作，例如：

在 Amazon 上搜索 "wireless mouse"，并返回排名前 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. Schema 使用 zod；为每个字段添加 .describe()——AI 会读取这些描述。
4. 切勿直接调用 fetch，请使用 ctx.client.post(...)。身份验证信息已自动注入。
5. 失败时抛出 PangolinfoError；对于非 2xx 响应，HTTP 客户端已会抛出此错误。

---

安全与数据处理

我们非常重视运营者和用户的安全。此 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 Agent）提供的参数。
• 只读。 所有工具都严格用于只读数据查询。没有任何工具能够写入 Amazon、下订单、发布评论、修改商品信息，或在第三方平台上执行任何会产生副作用的操作。
• 仅使用 HTTPS 传输。 stdio 版本（本地）和托管版本（https://mcp.pangolinfo.com/mcp）均要求使用 HTTPS；HTTP 请求将被拒绝。
• 开源。 完整源代码以 MIT 许可证发布在此仓库中，任何人都可以审查服务发送的内容和目标。
• 负责任地使用。 Pangolinfo API 汇总公开的电子商务数据。你有责任确保使用返回的数据符合相关平台（Amazon、Google 等）的服务条款，以及你所在司法管辖区的适用法律。

请通过 [email protected] 私下报告安全问题；请勿在 GitHub 上公开提交漏洞问题。

---

支持

• API 文档：https://docs.pangolinfo.com
• 问题反馈：https://github.com/pangolinfo/pangolinfo-mcp/issues
• 电子邮件：[email protected]

---

许可证

MIT © Pangolinfo