logo

雅虎日本拍卖商品采集

输入关键词,采集雅虎日本拍卖(Yahoo!オークション)的在售商品列表(标题、当前价格、卖家、出价数、剩余时间、结束时间等)

概览

输入关键词,采集雅虎日本拍卖(Yahoo!オークション)搜索结果中的在售商品列表:商品标题、当前价格、卖家、出价次数、剩余时间、结束时间、发货地、运费、商品状态、图片等 23 个字段。

输入参数

参数必填说明默认
keyword是搜索关键词,支持日文/英文/中文(如 iPhone)-
max_pages否最大采集页数1
max_collected_rows否采集条数上限3

输出字段

字段说明
title商品标题(日文原文)
current_price当前出价价格(日元)
seller / seller_url卖家名称 / 卖家主页链接
bid_count / bid_status出价次数 / 出价状态
time_remaining / end_time距结束剩余时间 / 拍卖结束时间
start_time拍卖开始时间
auction_id拍卖ID(唯一标识)
page_url商品详情页链接
image_url商品主图链接
shipping_from / shipping_fee发货地 / 运费
condition / brand / category商品状态 / 品牌 / 类目
quantity / returns / description数量 / 退货政策 / 商品说明
input_parameter / search_keyword任务输入参数 / 搜索关键词
acquired_date采集日期

使用示例

搜索 iPhone 相关的在售拍卖商品,翻采 1 页,最多返回 3 条:

{
  "keyword": "iPhone",
  "max_pages": 1,
  "max_collected_rows": 3
}

示例输出:

商品标题当前价格出价次数剩余时间商品状态
iPhone 15 Pro 256GB ブラック 中古78,000円123時間中古、目立った傷や汚れなし
iPhone 14 128GB 未使用品62,500円51日2時間新品、未使用

定价

按返回记录条数计费:0.0001 元/条(上游 ¥0.1/1,000 条)。

失败处理

  • 任务数据为异步获取:参数较大或数据量较大时,获取会耗时较长、结果无法及时返回,请耐心等待抓取完成。
  • 任务状态显示「运行中」表示仍在抓取数据,并不是异常,请不要重复提交相同任务。
  • 任务失败属可重试错误,可原样重新提交。

适用边界

单次任务按一个关键词采集雅虎日本拍卖的在售商品列表,最大采集页数默认 1 页、可上调(越大耗时与费用越高),条数上限默认 3 条;商品信息为页面展示的日文原文,价格单位为日元。

  • 适合用于
  • 需要调研某类商品在雅虎日本拍卖的在售数量、价格区间与热度时
  • 做日本市场二手/收藏品选品,需要商品标题、价格、卖家、出价数等明细时
  • 监控特定关键词下拍卖商品的剩余时间与结束时间,寻找临期捡漏机会时
  • 不要用于
  • 需要中文翻译后的商品信息时——本 App 返回页面原始日文内容
  • 需要乐天、Mercari 等其他日本平台数据时——本 App 只覆盖雅虎拍卖单一数据源
  • 需要历史成交记录(已完成拍卖)时——本 App 以当前在售列表为主,历史数据以实际返回为准

失败处理

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

  1. 1任务数据为异步获取:参数较大或数据量较大时,获取会耗时较长、结果无法及时返回,请耐心等待抓取完成
  2. 2任务状态显示「运行中」表示仍在抓取数据,并不是异常,请不要重复提交相同任务
  3. 3任务失败属可重试错误,可原样重新提交

输入参数

调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。

字段名业务名称类型必填默认值枚举 / 约束示例说明
keyword关键词string是——iPhone要在雅虎日本拍卖搜索的商品关键词,如 iPhone、限定版 等,支持日文/英文/中文关键词。一次任务填写一个关键词
max_pages最大采集页数integer否11–100—搜索结果最多翻采的页数,页数越多能采集的商品越多。不填默认 1 页。数值越大耗时和费用越高
max_collected_rows采集条数上限integer否31–20000—本次任务采集的记录条数上限,默认 3 条。数值越大耗时和费用越高

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

字段名业务名称类型示例说明
input_parameter输入参数string—本条记录对应的任务输入参数
search_keyword搜索关键词string—采集本条记录时使用的搜索关键词
title商品标题string—拍卖商品的标题(日文原文)
image_url商品图片链接string—拍卖商品的主图链接
current_price当前价格string—拍卖当前的出价价格(日元)
seller卖家string—拍卖商品的出品者(卖家)名称
seller_url卖家链接string—出品者(卖家)主页链接
shipping_from发货地string—商品的出荷元(发货地,日本都道府县等)
shipping_fee运费string—商品的送料(运费,日元)
description商品说明string—卖家填写的商品说明文本(日文原文)
quantity数量string—拍卖商品的个数
start_time拍卖开始时间string—拍卖的开始日时(日本时间)
end_time拍卖结束时间string—拍卖的结束日时(日本时间)
returns退货政策string—返品(是否接受退货)的说明
brand品牌string—商品的品牌(ブランド)
auction_id拍卖IDstring—雅虎拍卖的商品编号(オークションID),作为记录唯一标识
category类目string—商品所属的拍卖类目(カテゴリ)
condition商品状态string—商品的状态(新品/中古等,日文原文)
bid_count出价次数string—当前拍卖已收到的入札件数(出价次数)
time_remaining剩余时间string—距离拍卖结束的残り時間(剩余时间)
page_url商品页链接string—拍卖商品详情页链接
bid_status出价状态string—拍卖的入札状态(出价状态)
acquired_date采集日期string—本条记录的取得日付(采集当天日期)

记录 Schema

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

output.schema
{
  "type": "object",
  "properties": {
    "input_parameter": {
      "type": "string",
      "title": "输入参数",
      "description": "本条记录对应的任务输入参数"
    },
    "search_keyword": {
      "type": "string",
      "title": "搜索关键词",
      "description": "采集本条记录时使用的搜索关键词"
    },
    "title": {
      "type": "string",
      "title": "商品标题",
      "description": "拍卖商品的标题(日文原文)"
    },
    "image_url": {
      "type": "string",
      "title": "商品图片链接",
      "description": "拍卖商品的主图链接"
    },
    "current_price": {
      "type": "string",
      "title": "当前价格",
      "description": "拍卖当前的出价价格(日元)"
    },
    "seller": {
      "type": "string",
      "title": "卖家",
      "description": "拍卖商品的出品者(卖家)名称"
    },
    "seller_url": {
      "type": "string",
      "title": "卖家链接",
      "description": "出品者(卖家)主页链接"
    },
    "shipping_from": {
      "type": "string",
      "title": "发货地",
      "description": "商品的出荷元(发货地,日本都道府县等)"
    },
    "shipping_fee": {
      "type": "string",
      "title": "运费",
      "description": "商品的送料(运费,日元)"
    },
    "description": {
      "type": "string",
      "title": "商品说明",
      "description": "卖家填写的商品说明文本(日文原文)"
    },
    "quantity": {
      "type": "string",
      "title": "数量",
      "description": "拍卖商品的个数"
    },
    "start_time": {
      "type": "string",
      "title": "拍卖开始时间",
      "description": "拍卖的开始日时(日本时间)"
    },
    "end_time": {
      "type": "string",
      "title": "拍卖结束时间",
      "description": "拍卖的结束日时(日本时间)"
    },
    "returns": {
      "type": "string",
      "title": "退货政策",
      "description": "返品(是否接受退货)的说明"
    },
    "brand": {
      "type": "string",
      "title": "品牌",
      "description": "商品的品牌(ブランド)"
    },
    "auction_id": {
      "type": "string",
      "title": "拍卖ID",
      "description": "雅虎拍卖的商品编号(オークションID),作为记录唯一标识"
    },
    "category": {
      "type": "string",
      "title": "类目",
      "description": "商品所属的拍卖类目(カテゴリ)"
    },
    "condition": {
      "type": "string",
      "title": "商品状态",
      "description": "商品的状态(新品/中古等,日文原文)"
    },
    "bid_count": {
      "type": "string",
      "title": "出价次数",
      "description": "当前拍卖已收到的入札件数(出价次数)"
    },
    "time_remaining": {
      "type": "string",
      "title": "剩余时间",
      "description": "距离拍卖结束的残り時間(剩余时间)"
    },
    "page_url": {
      "type": "string",
      "title": "商品页链接",
      "description": "拍卖商品详情页链接"
    },
    "bid_status": {
      "type": "string",
      "title": "出价状态",
      "description": "拍卖的入札状态(出价状态)"
    },
    "acquired_date": {
      "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": {
    "SpiderByte__yahoo-auction-search": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=SpiderByte/yahoo-auction-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。

如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。

价格

返回一条雅虎日本拍卖商品记录

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

¥0.0005/ 条
提交一次任务

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

¥0.001/ 次

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

立即体验

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

示例
参数按 input.schema 校验后提交
登录后返回,确认参数再提交运行。
¥0.0005 / 条