logo

eBay 商品详情

给一批 eBay 商品标识,返回商品标题、价格、图片、卖家和规格等详情

概览

eBay 商品详情应用把一批商品标识对应的页面信息整理成统一明细,帮助选品、商品资料维护和跨站点市场观察。每个商品都保留标题、链接、图片、价格、卖家和规格等信息,没有详情的商品也会留下无数据标记。

数据说明

每条记录对应一个输入商品标识,覆盖 US、AU、CA、UK 四类 eBay 站点。标题、价格、评分、图片、卖家与规格来自采集时的页面展示;价格保留原有币种和格式,不做跨站换算。图片、属性和参数保留原始文本,跨站比较请先按站点分组。页面不可见、商品已下架或站点不匹配时,详情字段可能为空,但仍会返回查询商品和无数据标记。

结果长什么样

每条记录代表一个 eBay 商品的页面详情:

查询商品商品标题价格文本卖家名称站点国家
114452409636-USInsta360 ONE X 5.7K Action Camera - Black$420.93HD Toys StoreUS
18038046913-USJBL Quantum 100 Wired Over-Ear Gaming Headphones - Black$28.50alf_33651US

另有商品链接、商品 SKU、ePID、图片链接、商品属性、评分文本、卖家好评信息、商品参数和无数据标记。

应用场景

  • 建商品资料库时,用「查询商品」「商品标题」「商品链接」「商品 SKU」建档,再用「采集时间」判断新旧。
  • 做价格盘点时,按「站点国家」分组查看「价格文本」,结合「卖家名称」和「卖家好评信息」比较报价。
  • 做内容分析时,从「商品属性」「商品参数」和「商品数据」提取规格、颜色、材质和图片资源。
  • 做覆盖检查时,筛选「是否无数据」和「链接状态码」,定位站点不匹配或需要补采的商品。

适用边界

单次最多提交 200 个 eBay 商品标识;每个商品返回一条详情或无数据标记;支持 US、AU、CA、UK 站点。

  • 适合用于
  • 需要批量获取 eBay 商品标题、价格、图片、规格和卖家信息时
  • 需要把多个 eBay 站点商品整理成统一详情底表时
  • 不要用于
  • 需要实时成交价、库存或订单状态时——这里返回的是采集时的商品页面快照
  • 需要 eBay 搜索结果、评论或销量明细时——本应用只提供商品详情

失败处理

作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1任务处于部分成功时保留已完成商品结果,并通过无数据标记识别没有详情的商品
  2. 2任务失败或过期时可修正商品标识后重新提交;鉴权失败需先配置执行环境凭证
  3. 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商品详情被采集时的时间文本
epidePIDstringeBay 商品目录中的产品标识
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商品 SKUstring详情记录中的商品 SKU 或输入商品标识
status_code商品状态码string商品详情采集结果中的状态码文本
task_item查询商品string本条结果对应的输入商品标识
no_data是否无数据boolean该商品是否未采集到可用详情数据
this_product_param商品参数string当前商品参数内容的原始文本
url_status_code链接状态码string商品链接采集结果中的状态码文本

记录 Schema

输出按记录逐条返回。记录主键为 task_item,去重、增量、关联以它为准。

output.schema
{
  "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 配置
{
  "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)。

价格

提交一次商品详情任务

每提交一次任务计费一次,与返回条数无关。

¥0.001/
返回一条商品详情

按实际成功返回的数据条数计费,任务失败不计费。

¥0.01/

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
请先填写必填参数
¥0.01 / 条起