概览
eBay 商品详情应用把一批商品标识对应的页面信息整理成统一明细,帮助选品、商品资料维护和跨站点市场观察。每个商品都保留标题、链接、图片、价格、卖家和规格等信息,没有详情的商品也会留下无数据标记。
数据说明
每条记录对应一个输入商品标识,覆盖 US、AU、CA、UK 四类 eBay 站点。标题、价格、评分、图片、卖家与规格来自采集时的页面展示;价格保留原有币种和格式,不做跨站换算。图片、属性和参数保留原始文本,跨站比较请先按站点分组。页面不可见、商品已下架或站点不匹配时,详情字段可能为空,但仍会返回查询商品和无数据标记。
结果长什么样
每条记录代表一个 eBay 商品的页面详情:
| 查询商品 | 商品标题 | 价格文本 | 卖家名称 | 站点国家 |
|---|---|---|---|---|
| 114452409636-US | Insta360 ONE X 5.7K Action Camera - Black | $420.93 | HD Toys Store | US |
| 18038046913-US | JBL Quantum 100 Wired Over-Ear Gaming Headphones - Black | $28.50 | alf_33651 | US |
另有商品链接、商品 SKU、ePID、图片链接、商品属性、评分文本、卖家好评信息、商品参数和无数据标记。
应用场景
- 建商品资料库时,用「查询商品」「商品标题」「商品链接」「商品 SKU」建档,再用「采集时间」判断新旧。
- 做价格盘点时,按「站点国家」分组查看「价格文本」,结合「卖家名称」和「卖家好评信息」比较报价。
- 做内容分析时,从「商品属性」「商品参数」和「商品数据」提取规格、颜色、材质和图片资源。
- 做覆盖检查时,筛选「是否无数据」和「链接状态码」,定位站点不匹配或需要补采的商品。
适用边界
单次最多提交 200 个 eBay 商品标识;每个商品返回一条详情或无数据标记;支持 US、AU、CA、UK 站点。
- 适合用于
- 需要批量获取 eBay 商品标题、价格、图片、规格和卖家信息时
- 需要把多个 eBay 站点商品整理成统一详情底表时
- 不要用于
- 需要实时成交价、库存或订单状态时——这里返回的是采集时的商品页面快照
- 需要 eBay 搜索结果、评论或销量明细时——本应用只提供商品详情
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务处于部分成功时保留已完成商品结果,并通过无数据标记识别没有详情的商品
- 2任务失败或过期时可修正商品标识后重新提交;鉴权失败需先配置执行环境凭证
- 3结果为空时先检查商品标识和站点后再重试,不要把空结果当作商品一定不存在
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| product_items | 商品清单 | array<object> | 是 | — | 最多 200 项 | [{"item":"114452409636-US"}] | 要采集详情的 eBay 商品标识清单,每项使用商品 ID 加站点后缀的格式,例如 114452409636-US;站点支持 US、AU、CA、UK,一次可提交 1 至 200 项 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| country_code | 站点国家 | string | — | 商品详情对应的 eBay 站点国家或地区代码 |
| crawl_time | 采集时间 | string | — | 商品详情被采集时的时间文本 |
| epid | ePID | string | — | eBay 商品目录中的产品标识 |
| image_urls | 图片链接 | string | — | 商品图片链接列表的原始文本 |
| item_specifics | 商品属性 | string | — | 商品属性信息的原始文本 |
| price_text | 价格文本 | string | — | 商品页面展示的价格文本,保留原始币种和格式 |
| product_data | 商品数据 | string | — | 商品详情结构化内容的原始文本 |
| product_title | 商品标题 | string | — | 商品页面展示的完整标题 |
| product_url | 商品链接 | string | — | 商品详情页链接 |
| rating_score_text | 评分文本 | string | — | 商品页面展示的评分文本 |
| seller_name | 卖家名称 | string | — | 商品页面展示的卖家名称 |
| seller_positive_feedback_text | 卖家好评信息 | string | — | 卖家名称及好评数量等页面展示文本 |
| seller_score_text | 卖家评分 | string | — | 商品页面展示的卖家评分文本 |
| sku_id | 商品 SKU | string | — | 详情记录中的商品 SKU 或输入商品标识 |
| status_code | 商品状态码 | string | — | 商品详情采集结果中的状态码文本 |
| task_item | 查询商品 | string | — | 本条结果对应的输入商品标识 |
| no_data | 是否无数据 | boolean | — | 该商品是否未采集到可用详情数据 |
| this_product_param | 商品参数 | string | — | 当前商品参数内容的原始文本 |
| url_status_code | 链接状态码 | string | — | 商品链接采集结果中的状态码文本 |
记录 Schema
输出按记录逐条返回。记录主键为 task_item,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"country_code": {
"type": "string",
"title": "站点国家",
"description": "商品详情对应的 eBay 站点国家或地区代码"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "商品详情被采集时的时间文本"
},
"epid": {
"type": "string",
"title": "ePID",
"description": "eBay 商品目录中的产品标识"
},
"image_urls": {
"type": "string",
"title": "图片链接",
"description": "商品图片链接列表的原始文本"
},
"item_specifics": {
"type": "string",
"title": "商品属性",
"description": "商品属性信息的原始文本"
},
"price_text": {
"type": "string",
"title": "价格文本",
"description": "商品页面展示的价格文本,保留原始币种和格式"
},
"product_data": {
"type": "string",
"title": "商品数据",
"description": "商品详情结构化内容的原始文本"
},
"product_title": {
"type": "string",
"title": "商品标题",
"description": "商品页面展示的完整标题"
},
"product_url": {
"type": "string",
"title": "商品链接",
"description": "商品详情页链接"
},
"rating_score_text": {
"type": "string",
"title": "评分文本",
"description": "商品页面展示的评分文本"
},
"seller_name": {
"type": "string",
"title": "卖家名称",
"description": "商品页面展示的卖家名称"
},
"seller_positive_feedback_text": {
"type": "string",
"title": "卖家好评信息",
"description": "卖家名称及好评数量等页面展示文本"
},
"seller_score_text": {
"type": "string",
"title": "卖家评分",
"description": "商品页面展示的卖家评分文本"
},
"sku_id": {
"type": "string",
"title": "商品 SKU",
"description": "详情记录中的商品 SKU 或输入商品标识"
},
"status_code": {
"type": "string",
"title": "商品状态码",
"description": "商品详情采集结果中的状态码文本"
},
"task_item": {
"type": "string",
"title": "查询商品",
"description": "本条结果对应的输入商品标识"
},
"no_data": {
"type": "boolean",
"title": "是否无数据",
"description": "该商品是否未采集到可用详情数据"
},
"this_product_param": {
"type": "string",
"title": "商品参数",
"description": "当前商品参数内容的原始文本"
},
"url_status_code": {
"type": "string",
"title": "链接状态码",
"description": "商品链接采集结果中的状态码文本"
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"rookieyao__ebay-product-detail": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=rookieyao/ebay-product-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。