概览
输入关键词,采集雅虎日本拍卖(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円 | 12 | 3時間 | 中古、目立った傷や汚れなし |
| iPhone 14 128GB 未使用品 | 62,500円 | 5 | 1日2時間 | 新品、未使用 |
定价
按返回记录条数计费:0.0001 元/条(上游 ¥0.1/1,000 条)。
失败处理
- 任务数据为异步获取:参数较大或数据量较大时,获取会耗时较长、结果无法及时返回,请耐心等待抓取完成。
- 任务状态显示「运行中」表示仍在抓取数据,并不是异常,请不要重复提交相同任务。
- 任务失败属可重试错误,可原样重新提交。
适用边界
单次任务按一个关键词采集雅虎日本拍卖的在售商品列表,最大采集页数默认 1 页、可上调(越大耗时与费用越高),条数上限默认 3 条;商品信息为页面展示的日文原文,价格单位为日元。
- 适合用于
- 需要调研某类商品在雅虎日本拍卖的在售数量、价格区间与热度时
- 做日本市场二手/收藏品选品,需要商品标题、价格、卖家、出价数等明细时
- 监控特定关键词下拍卖商品的剩余时间与结束时间,寻找临期捡漏机会时
- 不要用于
- 需要中文翻译后的商品信息时——本 App 返回页面原始日文内容
- 需要乐天、Mercari 等其他日本平台数据时——本 App 只覆盖雅虎拍卖单一数据源
- 需要历史成交记录(已完成拍卖)时——本 App 以当前在售列表为主,历史数据以实际返回为准
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务数据为异步获取:参数较大或数据量较大时,获取会耗时较长、结果无法及时返回,请耐心等待抓取完成
- 2任务状态显示「运行中」表示仍在抓取数据,并不是异常,请不要重复提交相同任务
- 3任务失败属可重试错误,可原样重新提交
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| keyword | 关键词 | string | 是 | — | — | iPhone | 要在雅虎日本拍卖搜索的商品关键词,如 iPhone、限定版 等,支持日文/英文/中文关键词。一次任务填写一个关键词 |
| max_pages | 最大采集页数 | integer | 否 | 1 | 1–100 | — | 搜索结果最多翻采的页数,页数越多能采集的商品越多。不填默认 1 页。数值越大耗时和费用越高 |
| max_collected_rows | 采集条数上限 | integer | 否 | 3 | 1–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 | 拍卖ID | string | — | 雅虎拍卖的商品编号(オークションID),作为记录唯一标识 |
| category | 类目 | string | — | 商品所属的拍卖类目(カテゴリ) |
| condition | 商品状态 | string | — | 商品的状态(新品/中古等,日文原文) |
| bid_count | 出价次数 | string | — | 当前拍卖已收到的入札件数(出价次数) |
| time_remaining | 剩余时间 | string | — | 距离拍卖结束的残り時間(剩余时间) |
| page_url | 商品页链接 | string | — | 拍卖商品详情页链接 |
| bid_status | 出价状态 | string | — | 拍卖的入札状态(出价状态) |
| acquired_date | 采集日期 | string | — | 本条记录的取得日付(采集当天日期) |
记录 Schema
输出按记录逐条返回。记录主键为 auction_id,去重、增量、关联以它为准。
{
"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": {
"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)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
每提交一次任务计费一次,与返回条数无关。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。