概览
输入关键词,采集雅虎日本拍卖(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_parameterstring本条记录对应的任务输入参数 - 搜索关键词
search_keywordstring采集本条记录时使用的搜索关键词 - 商品标题
titlestring拍卖商品的标题(日文原文) - 商品图片链接
image_urlstring拍卖商品的主图链接
调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"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)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
每提交一次任务计费一次,与返回条数无关。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。