概览
想摸清速卖通韩国站某个品类都有哪些货在卖、卖多少钱、谁卖得好吗?给它一个搜索关键词,它会把这个关键词下的商品列表取回来,每条带商品名称、当前价格、原价、累计销量、评分和商品链接,可以直接导出成表格做分析。
做韩国市场选品时,最费时的往往是"一边翻搜索结果、一边把价格和销量抄进表格"。这份数据把同一个关键词下的商品一次性取回,价格、原价、销量、评分都带着,适合当作价格带分析、热销款筛选和竞品盘点的原始底表。
数据说明
商品清单取自速卖通韩国站的公开搜索结果页,按该页原有的展示顺序返回,不做二次排序或去重。当前价格为列表页展示的售价,带韩元符号;原价为列表页的划线价,部分商品没有;两者之差可以反映折扣力度。累计销量按平台展示的口径给出(如「10,000+ 판매」),是量级而非精确值。评分为商品评分,满分 5 分,暂无评价的商品为空。促销标签是商品卡片上展示的服务或促销标识,例如「AliExpress TOP셀러」(平台热销标识)或优惠提示。数据为取数当时页面展示的快照,价格与销量会随时间变化。
结果长什么样
每条记录是一个商品:
| 商品名称 | 当前价格 | 累计销量 | 商品评分 |
|---|---|---|---|
| 1pc 유리 측정 컵 나무 손잡이 유리 에스프레소 측정 컵 더블 싱글 입 우유 커피 클리어 머그잔 커피 용품 | ₩ 2,250 | 10,000+ 판매 | 4.7 |
| 뚜껑과 밀짚 투명 우유 차 주스 컵 커피 머그잔 홈 바 Drinkware에 대 한 1Pcs 사각형 내열성 커피 유리 컵 | ₩ 3,500 | 10,000+ 판매 | 4.2 |
另有「原价」「商品链接」「促销标签」「商品主图」等字段。
应用场景
- 做价格带分析时,把「当前价格」按区间分档,看这个关键词下的商品扎堆在哪个价位,给自己的定价找参照。
- 做热销款筛选时,用「累计销量」排序,挑出量级领先的款,再顺着「商品链接」去详情页看它的卖点。
- 做折扣力度比较时,用「原价」和「当前价格」算折扣率,看哪些商品在打大促。
- 做上新与竞争监测时,隔几天跑同一个关键词,比对「商品名称」和「当前价格」,看谁新进场、谁调了价。
适用边界
单次任务处理 1 个搜索关键词,采集条数上限默认 3 条、可上调(越大耗时与费用越高);仅覆盖速卖通韩国站公开展示的商品信息。
- 适合用于
- 需要按关键词批量获取速卖通韩国站在售商品及价格、销量信息时
- 需要做韩国市场选品、竞品价格带或热销款摸底时
- 不要用于
- 需要商品详情页的完整参数、规格与逐条评价时——用商品详情或评论类应用
- 需要秒级返回结果时——本应用在后台执行采集,完成时间取决于商品数量
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1部分数据获取是异步返回的:商品较多时,采集会耗时较长、无法立即返回;请耐心等待抓取完成,任务状态显示「运行中」表示仍在采集,并非异常
- 2任务失败属可重试错误,可原样重新提交
- 3返回空结果通常是关键词过于生僻或无可售商品,换更通用的品类词重试
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| keyword | 搜索关键词 | string | 是 | — | — | cup | 要在速卖通韩国站搜索的商品关键词,用品类词或商品词,不要写整句;例如 cup、컵 |
| max_collected_rows | 采集条数上限 | integer | 否 | 3 | 1– | — | 本次任务最多采集多少条商品,不填默认 3 条,数值越大耗时和费用越高 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| product_name | 商品名称 | string | 1pc 유리 측정 컵 나무 손잡이 유리 에스프레소 측정 컵 더블 싱글 입 우유 커피 클리어 머그잔 커피 용품 | 商品在韩国站展示的完整标题 |
| product_url | 商品链接 | string | https://ko.aliexpress.com/item/1005007541372727.html | 商品详情页链接 |
| current_price | 当前价格 | string | ₩ 2,250 | 商品当前售价,含韩元符号 |
| original_price | 原价 | string | ₩ 3,056 | 商品划线原价,含韩元符号,部分商品没有 |
| sales_volume | 累计销量 | string | 10,000+ 판매 | 商品累计销量,按平台展示口径 |
| rating | 商品评分 | string | 4.7 | 商品评分,5 分制,无评价时为空 |
| promo_badge | 促销标签 | string | AliExpress TOP셀러 | 商品卡片上展示的服务或促销标签,如「AliExpress TOP셀러」、优惠提示等 |
| image_url | 商品主图 | string | https://ae-pic-a1.aliexpress-media.com/kf/S312216296fac40b5aaa0b758912df83cd.jpg | 商品列表页展示的主图链接 |
记录 Schema
输出按记录逐条返回。记录主键为 product_url,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"product_name": {
"type": "string",
"title": "商品名称",
"description": "商品在韩国站展示的完整标题",
"prefill": "1pc 유리 측정 컵 나무 손잡이 유리 에스프레소 측정 컵 더블 싱글 입 우유 커피 클리어 머그잔 커피 용품"
},
"product_url": {
"type": "string",
"title": "商品链接",
"description": "商品详情页链接",
"prefill": "https://ko.aliexpress.com/item/1005007541372727.html"
},
"current_price": {
"type": "string",
"title": "当前价格",
"description": "商品当前售价,含韩元符号",
"prefill": "₩ 2,250"
},
"original_price": {
"type": "string",
"title": "原价",
"description": "商品划线原价,含韩元符号,部分商品没有",
"prefill": "₩ 3,056"
},
"sales_volume": {
"type": "string",
"title": "累计销量",
"description": "商品累计销量,按平台展示口径",
"prefill": "10,000+ 판매"
},
"rating": {
"type": "string",
"title": "商品评分",
"description": "商品评分,5 分制,无评价时为空",
"prefill": "4.7"
},
"promo_badge": {
"type": "string",
"title": "促销标签",
"description": "商品卡片上展示的服务或促销标签,如「AliExpress TOP셀러」、优惠提示等",
"prefill": "AliExpress TOP셀러"
},
"image_url": {
"type": "string",
"title": "商品主图",
"description": "商品列表页展示的主图链接",
"prefill": "https://ae-pic-a1.aliexpress-media.com/kf/S312216296fac40b5aaa0b758912df83cd.jpg"
}
},
"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": {
"WW_Yang__aliexpress-kr-product-list": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=WW_Yang/aliexpress-kr-product-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
每提交一次任务计费一次,与返回条数无关。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。