Pangolinfo MCP - 20 个工具完整参考

本页是工具总览 + 常用输入 + 字段依赖速查。每个工具的完整参数语义（含 zod 校验规则）见 Scrape API 文档 — MCP 工具背后调用的是同一组 REST API。

🚀 给 AI 的第一次调用

首次连上 MCP 时，强烈建议 AI 先调一次自省工具：

pangolinfo_capabilities()

它会返回所有 20 个工具的当前 schema + 简介，比文档更新及时。AI 拿到列表后会自动按上下文选工具，不需要你点名。

20 个工具速查

积点是每次成功调用的扣点数，与对应 REST API 完全一致。批量类工具按数量线性扣点。完整定价见各 API 文档的”积点消耗说明”小节。当前共 20 个工具。每个工具卡片含 用途 / 积点 / 参数 / 返回数据 四块；返回数据为关键字段速览，完整 schema 见对应 API 文档。

Amazon 核心数据（8 个）

search_amazon — 关键词搜索结果页

用途　关键词搜索结果页抓取，含自然排名、广告排名与广告位。

积点　1 个/页

参数　keyword、domain（必填）

返回数据　搜索结果页上的商品列表（解析器 amzKeyword），每项含：

字段	类型	说明
`asin`	string	ASIN 码
`title`	string	商品标题
`price`	string	商品价格
`star` / `rating`	string	评分 / 评分数
`rank`	int	自然排名
`sponsored`	string	是否 SP 广告
`spRank`	int	SP 广告排名
`image`	string	图片链接
`badge`	string	徽章
`delivery`	object	发货时间

完整字段（解析器 amzKeyword，共 12 个）见 Scrape API 文档。

get_amazon_product — 商品详情

用途　商品详情页全字段抓取（标题、价格、五点、A+、变体、评论摘要等）。

积点　1 个/页

参数　asin、domain（必填）

返回数据　单个商品的完整详情（解析器 amzProductDetail），核心字段：

字段	类型	说明
`asin` / `parentAsin`	string	ASIN / 父级 ASIN
`title`	string	商品标题（完整原串，已适配新标题的商品含 ” \| ” 分隔，未拆分）
`itemName`	string	商品名称（标题 ” \| ” 前段，≤75 字符；老商品为完整标题）。Amazon 2026-07-27 起标题拆分
`itemHighlights`	string	商品亮点（标题 ” \| ” 后段，材质/用途/卖点等，≤125 字符；老商品为空）
`price` / `strikethroughPrice`	string / object	现价 / 划线价（含 `key`、`value`、可选 `tip` 法务说明）
`star` / `rating`	string	评分 / 评分数
`features`	string[]	五点描述
`productDescription`	object	A+ / 商品描述
`variantDetails`	object	变体详情
`coupon` / `savingsPercentage` / `promotions` / `discountTypes`	string / string / object[] / string[]	优惠券 / 促销直降折扣率(如”38%”) / 多件促销 / 折扣方式（含 DE “Befristetes Angebot”）
`bestSellersRank`	string	热卖排名（BSR）
`attributes` / `productOverview`	object	商品属性 / 产品概述
`videos`	object[]	商品视频（卖家 / 达人 / 买家）
`shippingFee`	string	买家配送料（buybox 运费数字，如 “750”；免运费/无运费信息为 “0”。随收货地址变化）
`delivery`	object	基础配送时间，含 `deliveryTime`、`fastestDelivery`
`aiReviewsSummary`	object	AI 评论总结

以上为核心字段速览，该解析器完整 51 个顶层字段。配送细分时效和高退货提示请使用下面的 get_amazon_delivery_time。

get_amazon_delivery_time — Amazon Delivery Time

用途　返回完整商品详情，并追加与收货地址相关的免运费、付费、最快配送及备货时效。

积点　2 个/次

参数　asin（必填）、site、zipcode（可选；配送结果随地址变化）

返回数据　继承 get_amazon_product 的全部 51 个顶层字段，并追加：

字段	类型	说明
`frequentlyReturnedItem`	string	高退货率提示文本；无提示时为空字符串
`leadTime`	string	备货 / 处理时间；无信息时为空字符串
`delivery.deliveryTimeFree`	string	免运费配送时间
`delivery.deliveryTimePay`	string	付费配送时间
`delivery.deliveryFastest`	string	最快配送选项对应的时间

完整字段和 REST 调用示例见 Amazon Delivery Time API。

get_amazon_reviews — 评论分页抓取

用途　商品评论分页抓取，含星级、日期、Verified 标识与图文/视频。

积点　5 个/页

参数　asin、domain（必填）

返回数据　totalReviews 为商品评论总数（string，无信息时为空字符串）；results[] 为评论列表，每条评论含：

字段	类型	说明
`reviewId`	string	评论 ID
`title` / `content`	string	标题 / 正文
`star`	string	星级（如 “5.0 out of 5 stars”）
`date` / `country`	string	日期 / 国家
`author` / `authorId` / `authorLink`	string	作者 / 作者 ID / 主页
`purchased`	boolean	是否 Verified Purchase
`vineVoice`	boolean	是否 Vine 评论
`imgs` / `videos`	string[]	评论图片 / 视频
`helpful`	string	有用票数

完整返回结构见 Amazon Review API 文档。

list_seller_products — 卖家在售商品

用途　卖家主页 + 在售商品列表。

积点　1 个/次

参数　seller_id、domain（必填）

返回数据　该卖家在售商品列表（解析器 amzProductOfSeller），每项含：

字段	类型	说明
`asin`	string	ASIN 码
`title`	string	商品标题
`price`	string	商品价格
`star` / `rating`	string	评分 / 评分数
`image`	string	图片链接

完整字段（解析器 amzProductOfSeller，共 6 个）见 Scrape API 文档。

list_bestsellers — Best Sellers 榜单

用途　站内 Best Sellers 热销榜单。

积点　1 个/次

参数　url（必填）

返回数据　热销榜商品列表（解析器 amzBestSellers），每项含：

字段	类型	说明
`rank`	string	榜单排名
`asin`	string	ASIN 码
`title`	string	商品标题
`price`	string	商品价格
`star` / `rating`	string	评分 / 评分数
`image`	string	图片链接

完整字段（解析器 amzBestSellers，共 7 个）见 Scrape API 文档。

list_new_releases — New Releases 新品榜

用途　站内 New Releases 新品榜单。

积点　1 个/次

参数　url（必填）

返回数据　新品榜商品列表（解析器 amzNewReleases），每项含：

字段	类型	说明
`rank`	string	榜单排名
`asin`	string	ASIN 码
`title`	string	商品标题
`price`	string	商品价格
`star` / `rating`	string	评分 / 评分数
`image`	string	图片链接

完整字段（解析器 amzNewReleases，共 7 个）见 Scrape API 文档。

scrape_url — 任意页面兜底抓取

Amazon 类目与 Niche 市场分析（6 个）

get_category_children — 品类树

用途　拉取站点完整品类树，用于定位 node_id。

积点　2 个/次

参数　domain（必填）

返回数据　子类目节点列表，含层级路径与中英文名称：

字段	类型	说明
`browseNodeId`	string	类目节点 ID
`browseNodeName` / `browseNodeNameCn`	string	英文 / 中文类目名
`browseNodeNamePath` / `browseNodeNamePathCn`	string	英文 / 中文完整路径
`parentBrowseNodeId`	string	父节点 ID
`productType`	string	产品类型
`sellable` / `hasChild`	int	是否可销售 / 是否有子节点

完整字段（共 13 个，含 browseNodeIdPath、parentBrowseNodeNamePath 等）见 Category Tree API 文档。

search_categories — 模糊搜品类

用途　按关键词模糊搜品类（不知道 node_id 时用）。

积点　2 个/次

参数　keyword、domain（必填）

返回数据　匹配的类目列表，含完整层级路径：

字段	类型	说明
`browseNodeId`	string	类目节点 ID
`browseNodeName` / `browseNodeNameCn`	string	英文 / 中文类目名
`browseNodeNamePath` / `browseNodeNamePathCn`	string	英文 / 中文完整路径
`productType` / `itemType`	string	产品类型 / 细分类型
`sellable` / `hasChild`	int	是否可销售 / 是否有子节点

完整字段（共 13 个，含 browseNodeIdPath、parentBrowseNodeNamePath 等）见 Search Categories API 文档。

get_category_paths — 批量面包屑路径

用途　批量取品类的完整面包屑路径。

积点　2 个/次

参数　node_ids[]（必填）

返回数据　类目 ID → 完整路径映射：

字段	类型	说明
`categoryId`	string	类目 ID
`categoryName` / `categoryNameCn`	string	英文 / 中文类目名
`browseNodeNamePaths`	string[]	英文路径数组
`browseNodeNamePathCns`	string[]	中文路径数组

完整返回结构见 Batch Category Paths API 文档。

list_category_products — 类目商品列表

用途　列出指定类目下的商品列表。

积点　1 个/次

参数　url（必填）

返回数据　该类目下的商品列表（解析器 amzProductOfCategory），每项含：

字段	类型	说明
`asin`	string	ASIN 码
`title`	string	商品标题
`price`	string	商品价格
`star` / `rating`	string	评分 / 评分数
`image`	string	图片链接

完整字段（解析器 amzProductOfCategory，共 6 个）见 Scrape API 文档。

filter_categories — 品类深度筛选

用途　在品类下按价格 / 评分 / BSR 等商业指标筛 ASIN。

积点　5 个/次

参数　node_id、domain（必填）

返回数据　类目级深度分析指标：

字段	类型	说明
`categoryId`	string	类目 ID
`unitSoldSum`	float	总销量
`glanceViewsSum`	float	总详情页浏览量
`searchVolumeSum`	float	总搜索量
`netShippedGmsSum`	float	总销售额（GMS）
`asinCount`	float	类目内 ASIN 数
`buyBoxPriceAvg`	float	平均黄金购物车价
`searchToPurchaseRatio`	float	搜索到购买转化率
`returnRatio`	float	退货率
`unitSoldTrendDirection`	string	销量趋势方向

以上为核心字段速览，该接口完整约 80 个字段（含各指标的周期计数、分位桶、波动率、同比环比等）见 Category Filter API 文档。

filter_niches — 蓝海市场筛选

用途　一键蓝海词 + 蓝海品类筛选（含竞争度）。

积点　10 个/次

参数　keyword / node_id（必填其一）

返回数据　利基市场深度分析报告：

字段	类型	说明
`nicheId`	string	利基 ID
`nicheTitle`	string	利基标题 / 关键词
`searchVolumeT90` / `searchVolumeT360`	int	90 天 / 360 天搜索量
`minimumAverageUnitsSoldT360` / `maximumAverageUnitsSoldT360`	float	360 天平均销量区间
`avgProductPrice`	float	平均商品价格
`productCount` / `brandCount`	int	商品数 / 品牌数
`avgReviewRating`	float	平均评分
`returnRateT360`	float	360 天退货率

以上为核心字段速览，该接口完整约 197 个字段（含全套 FBA/仓储费用拆解、点击集中度、品牌年龄、上新成功率、同比环比等）见 Niche Filter API 文档。

搜索与 SERP AI（3 个）

ai_search — AI 搜索结果（Overview / AI Mode）

用途　AI 搜索结果。mode='overview' 返回 AI Overview；mode='ai_mode' 返回完整 AI Mode SERP（含答案卡片源）。

积点　2 个/次

参数　query、mode（必填）

返回数据　AI 概述 + 来源结果：

字段	类型	说明
`json`	object	AI 概述与搜索结果完整结构
`ai_overview`	int	是否存在 AI Overview 内容
`results_num`	int	返回结果数量
`url`	string	对应搜索链接
`screenshot`	string	页面截图地址
`taskId`	string	任务 ID

json 内含完整 AI Overview / AI Mode 结构，详见 AI Overview SERP API 与 AI Mode API。

keyword_trends — 关键词趋势

用途　关键词搜索趋势时序曲线，含地理分布与相关词。

积点　1.5 个/次

参数　keyword（必填）

返回数据　趋势四大数据板块（json 内）：

字段	类型	说明
`timelineData`	array	时间序列热度值 + 格式化时间
`keywordsGeoData`	array	各关键词按地理位置的热度分布
`keywordsRankData`	array	相关关键词排名及增长率
`geoMapData`	array	地理位置代码及对应热度值
`url`	string	Google Trends 链接
`taskId`	string	任务 ID

各数据板块的完整字段见 Keyword Trends API 文档。

地图与地点数据（1 个）

search_local_maps — 地图 POI 抓取

用途　地图 POI 抓取（商家名 / 评分 / 地址 / 营业时间）。

积点　1.5 个/次

参数　query、location（必填）

返回数据　商家列表（data.organicResults[]），每项含：

字段	类型	说明
`place_id`	string	地点 ID
`name`	string	商家名称
`rating`	number	评分
`number_of_reviews`	number	评论数
`address`	string	地址
`status`	int	任务状态（-1 失败 / 1 进行中 / 2 成功）
`taskId` / `url`	string	任务 ID / 来源链接

完整返回结构见 Map Data API 文档。

外观专利与诉讼合规（1 个）

wipo_search — 外观专利检索 + 诉讼联动（Design Patent TRO）

用途　WIPO 全球外观设计专利检索（侵权排查）。可选 enableLitigation=true 联动查关联的美国专利诉讼案件 + 完整诉讼时间线，一次调用直出专利 + 诉讼。

积点　2 个/次（开 enableLitigation 且查到专利再 +12）

参数　source（必填）

返回数据　专利检索结果（hits[]），核心字段：

字段	类型	说明
`total`	int	总匹配专利数
`IRN`	string	国际注册号 / 专利号
`SOURCE`	string	数据来源（USID / CNID / JPID / EMID / HAGUE…）
`STATUS`	string	法律状态（ACT 已启用 / PEND 待生效 / DEL 已停用）
`RD`	string	注册日期
`HOL`	string[]	权利人 / 持有人
`PROD` / `PROD_EN` / `PROD_ZH`	string[]	产品 / 外观设计说明（含本地化）
`LCS`	string[]	洛迦诺外观设计分类
`IMG_DATA`	object[]	专利图片（filename + url）

诉讼联动字段（enableLitigation=true，来自 PACER）：

字段	类型	说明
`litigationStatus`	string	诉讼查询状态（success / skipped / failed）
`caseTotal`	int	关联诉讼案件数
`cases[].caseName`	string	案件名称
`cases[].court`	string	受理法院
`cases[].status`	string	案件状态（active / terminated）
`cases[].dateFiled` / `dateTerminated`	string	立案 / 结案日期
`cases[].patentNumbers`	string[]	涉及专利号
`cases[].entries[]`	array	docket 诉讼时间线（最多 50 条）

专利 hits[] 与诉讼 cases[] / entries[] 的完整字段见 Design Patent TRO API 文档。

MCP 自省（1 个）

pangolinfo_capabilities — 工具自省

常用输入与字段依赖

输入	用途
ASIN	商品详情、评论、商品审计
Marketplace / domain	指定 Amazon 站点
关键词	Amazon 搜索、趋势分析、类目发现
Seller ID	卖家店铺和商品目录分析
类目 node ID	类目树、类目筛选、niche 分析
商品名或品牌名	搜索、竞品查找、市场探索
专利 / 外观来源	IP 初筛和外观专利工作流

某些工具的入参需要先从其他工具拿到，不能凭空捏造。把依赖说清楚后 AI 自己会串：

想做的事	需要的字段	通常从哪里拿
查看商品详情或评论	ASIN	Amazon 搜索结果、商品 URL、历史商品列表
查看卖家商品	Seller ID	商品详情页中的卖家信息
做类目筛选或类目路径分析	Node ID	类目树或类目搜索
做 niche 机会筛选	关键词或 Node ID	用户输入关键词，或先通过类目搜索定位
做专利风险初筛	专利号、外观来源或关键词	用户提供，或从商品标题、品牌名、外观描述提炼

输入建议

如果只有商品链接，可以让 AI 先从链接中识别 ASIN、站点和可能的解析方式。
如果只有中文品类或产品想法，建议同时给出英文关键词，减少站点搜索误差。
如果目标是市场研究，不要只给一个 ASIN；最好同时给关键词、目标站点和希望比较的维度。
如果目标是 IP 初筛，应明确国家/地区、产品外观关键词、品牌名或已有专利线索。

示例问题

帮我分析 ASIN B0B4NLGCH5：商品详情、评论、卖家商品和类目位置。

帮我找 Amazon US 上 pet grooming 相关的 niche 机会，并总结最明显的信号。

帮我检查这个产品外观是否有相关专利风险信号。

下一步

没接入完？回到客户端适配
需要使用示例？看 Amazon Insight MCP 工作流程
工具不显示 / 报错？看常见问题
需要完整 API schema？查 Scrape API 文档

MCP for Agent

Amazon Insight MCP

VOC Insight MCP

Tool 参考

🚀 给 AI 的第一次调用

20 个工具速查

Amazon 核心数据（8 个）

Amazon 类目与 Niche 市场分析（6 个）

搜索与 SERP AI（3 个）

地图与地点数据（1 个）

外观专利与诉讼合规（1 个）

MCP 自省（1 个）

常用输入与字段依赖

输入建议

示例问题

下一步

MCP for Agent

Amazon Insight MCP

VOC Insight MCP

​🚀 给 AI 的第一次调用

​20 个工具速查

​Amazon 核心数据（8 个）

​Amazon 类目与 Niche 市场分析（6 个）

​搜索与 SERP AI（3 个）

​地图与地点数据（1 个）

​外观专利与诉讼合规（1 个）

​MCP 自省（1 个）

​常用输入与字段依赖

​输入建议

​示例问题

​下一步

🚀 给 AI 的第一次调用

20 个工具速查

Amazon 核心数据（8 个）

Amazon 类目与 Niche 市场分析（6 个）

搜索与 SERP AI（3 个）

地图与地点数据（1 个）

外观专利与诉讼合规（1 个）

MCP 自省（1 个）

常用输入与字段依赖

输入建议

示例问题

下一步