概览
Naver 商品详情应用把商品页上的关键信息整理成统一明细,帮助团队快速建立商品资料、核对品牌店铺信息,并观察价格、评分和销量等页面信号。每条结果对应一个提交的商品链接,即使某个链接没有可用详情,也会保留查询链接和无数据标记,便于后续补采和覆盖检查。
这份数据适合做商品页面快照底表:标题、价格、图片、品牌、店铺、配送和评价概况集中在同一条记录里,既能支持单品资料维护,也能为同类商品的横向比较提供基础。
数据说明
每条记录对应一个 Naver 商品详情页链接,商品信息来自采集时公开可见的页面内容。价格、折扣、评分、评论数和销量保留页面展示文本,不做币种换算或口径推断;创建时间和更新时间以毫秒时间戳记录。商品已下架、页面不可公开访问或链接状态无效时,部分详情可能为空,但查询链接和无数据标记仍可用于识别覆盖情况。页面内容会随商品页变化,结果代表采集时的页面状态。
结果长什么样
每条记录代表一个 Naver 商品详情页的采集结果:
| 查询链接 | 品牌名称 | 商品标题 | 当前价格 | 评分 | 店铺名称 |
|---|---|---|---|---|---|
| https://brand.naver.com/dji/products/13467910320 | DJI | DJI Osmo Mobile 8P 크리에이터 콤보 | 268000 | 4.82 | DJI 공식 브랜드스토어 |
| https://brand.naver.com/dji/products/13467910320?13467910320 | DJI | DJI Osmo Mobile 8P 크리에이터 콤보 | 268000 | 4.82 | DJI 공식 브랜드스토어 |
另有主图链接、图片链接、原价、折扣信息、配送公司、商品编号、评论总数、累计销量、规格信息和无数据标记等字段。
应用场景
- 建商品资料库时,用「查询链接」「商品标题」「品牌名称」「商品编号」建立商品档案,再用「采集时间」和「更新时间」判断记录新旧。
- 做价格与促销观察时,对比「原价」「当前价格」和「折扣信息」,识别不同商品的价格变化和促销展示。
- 做店铺与口碑分析时,结合「店铺名称」「评分」「评论总数」和「配送公司」比较品牌店铺的页面表现。
- 做覆盖检查时,筛选「链接状态」和「是否无数据」,定位下架、不可访问或暂未采集成功的商品。
适用边界
单次最多提交 200 个 Naver 商品详情页链接;每个链接最多返回一条详情记录或无数据标记。
- 适合用于
- 需要批量获取 Naver 商品页的标题、价格、图片、品牌、店铺和销售表现时
- 需要把多个 Naver 商品整理成统一商品详情底表时
- 不要用于
- 需要实时库存、订单或交易明细时;本应用提供的是商品页采集快照
- 需要 Naver 搜索结果、评论正文或店铺级分析时;本应用只提供商品详情
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务部分成功时保留已完成商品结果,并结合无数据标记识别未采集到详情的链接
- 2任务失败或过期时检查商品链接后重新提交;鉴权失败需先配置执行环境凭证
- 3结果为空时先检查链接是否为公开可访问的 Naver 商品详情页,再重试
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| product_items | 商品链接清单 | array<object> | 是 | — | 最多 200 项 | [{"item":"https://brand.naver.com/dji/products/13467910320"}] | 要采集详情的 Naver 商品详情页完整 URL,每项填写一个链接;一次可提交 1 至 200 项。 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| banner_image_url_list | 横幅图片链接 | string | ["https://shop-phinf.pstatic.net/20260521_96/177932373412333d7L_JPEG/56304580264299996_1217931344.jpg", "https://shop-phinf.pstatic.net/20260521_128/1779323734385BLd2S_JPEG/56304580534368328_585529054.jpg"] | 商品详情中的横幅图片链接列表原始文本。 |
| biz_id | 业务商品标识 | string | https://brand.naver.com/dji/products/13467910320 | Naver 商品详情对应的业务标识,通常为商品详情页链接。 |
| brand_name | 品牌名称 | string | DJI | 商品页面展示的品牌名称。 |
| category_name | 商品分类 | string | 짐벌 | 商品页面展示的分类名称。 |
| crawl_time | 采集时间 | string | 2026-09-14T10:00:34 | 商品详情被采集时的时间文本。 |
| created_at | 创建时间 | integer | 1789351234641 | 商品记录创建时间的 Unix 毫秒时间戳。 |
| discount | 折扣信息 | string | 0 | 商品页面展示的折扣文本。 |
| item | 查询链接 | string | https://brand.naver.com/dji/products/13467910320 | 本条结果对应的输入 Naver 商品详情页链接。 |
| job_type | 任务类型 | string | BasicInfo | 详情采集任务返回的任务类型。 |
| main_image_url | 主图链接 | string | https://shop-phinf.pstatic.net/20260521_16/1779323678450AFIJH_JPEG/25466701428756421_367248028.jpg | 商品页面主图链接。 |
| original_price | 原价 | string | 268000 | 商品页面展示的原始价格文本。 |
| pay_reference_key | 支付参考标识 | string | 510448366 | 商品详情中的支付参考标识文本。 |
| platform_code | 平台代码 | string | naver | 商品详情来源平台代码。 |
| price | 当前价格 | string | 268000 | 商品页面展示的当前价格文本。 |
| product_no | 商品编号 | string | 13408803046 | Naver 商品编号。 |
| product_title | 商品标题 | string | DJI Osmo Mobile 8P 크리에이터 콤보 | 商品页面展示的完整标题。 |
| product_url | 商品链接 | string | https://brand.naver.com/dji/products/13467910320?13467910320 | 商品详情页链接。 |
| rating_score | 评分 | string | 4.82 | 商品页面展示的评分文本。 |
| shipping_company_name | 配送公司 | string | CJ대한통운 | 商品页面展示的配送公司名称。 |
| shop_name | 店铺名称 | string | DJI 공식 브랜드스토어 | 商品页面展示的店铺名称。 |
| sku_id | SKU 标识 | string | https://brand.naver.com/dji/products/13467910320 | 详情记录中的 SKU 标识文本。 |
| source_name | 数据来源标识 | string | naver_detail_202609 | 详情记录中的数据来源标识。 |
| spec | 规格信息 | string | {} | 商品规格信息原始文本。 |
| total_review_count | 评论总数 | string | 120 | 商品页面展示的评论总数文本。 |
| total_sales | 累计销量 | string | 11248 | 商品页面展示的累计销量文本。 |
| updated_at | 更新时间 | integer | 1789351234641 | 商品记录更新时间的 Unix 毫秒时间戳。 |
| url_status | 链接状态 | string | 有效 | 商品链接采集结果状态文本。 |
| task_meta | 任务元信息 | string | — | 与本条商品结果关联的任务元信息。 |
记录 Schema
输出按记录逐条返回。记录主键为 item,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"banner_image_url_list": {
"type": "string",
"title": "横幅图片链接",
"description": "商品详情中的横幅图片链接列表原始文本。",
"prefill": "[\"https://shop-phinf.pstatic.net/20260521_96/177932373412333d7L_JPEG/56304580264299996_1217931344.jpg\", \"https://shop-phinf.pstatic.net/20260521_128/1779323734385BLd2S_JPEG/56304580534368328_585529054.jpg\"]"
},
"biz_id": {
"type": "string",
"title": "业务商品标识",
"description": "Naver 商品详情对应的业务标识,通常为商品详情页链接。",
"prefill": "https://brand.naver.com/dji/products/13467910320"
},
"brand_name": {
"type": "string",
"title": "品牌名称",
"description": "商品页面展示的品牌名称。",
"prefill": "DJI"
},
"category_name": {
"type": "string",
"title": "商品分类",
"description": "商品页面展示的分类名称。",
"prefill": "짐벌"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "商品详情被采集时的时间文本。",
"prefill": "2026-09-14T10:00:34"
},
"created_at": {
"type": "integer",
"title": "创建时间",
"description": "商品记录创建时间的 Unix 毫秒时间戳。",
"prefill": 1789351234641
},
"discount": {
"type": "string",
"title": "折扣信息",
"description": "商品页面展示的折扣文本。",
"prefill": "0"
},
"item": {
"type": "string",
"title": "查询链接",
"description": "本条结果对应的输入 Naver 商品详情页链接。",
"prefill": "https://brand.naver.com/dji/products/13467910320"
},
"job_type": {
"type": "string",
"title": "任务类型",
"description": "详情采集任务返回的任务类型。",
"prefill": "BasicInfo"
},
"main_image_url": {
"type": "string",
"title": "主图链接",
"description": "商品页面主图链接。",
"prefill": "https://shop-phinf.pstatic.net/20260521_16/1779323678450AFIJH_JPEG/25466701428756421_367248028.jpg"
},
"original_price": {
"type": "string",
"title": "原价",
"description": "商品页面展示的原始价格文本。",
"prefill": "268000"
},
"pay_reference_key": {
"type": "string",
"title": "支付参考标识",
"description": "商品详情中的支付参考标识文本。",
"prefill": "510448366"
},
"platform_code": {
"type": "string",
"title": "平台代码",
"description": "商品详情来源平台代码。",
"prefill": "naver"
},
"price": {
"type": "string",
"title": "当前价格",
"description": "商品页面展示的当前价格文本。",
"prefill": "268000"
},
"product_no": {
"type": "string",
"title": "商品编号",
"description": "Naver 商品编号。",
"prefill": "13408803046"
},
"product_title": {
"type": "string",
"title": "商品标题",
"description": "商品页面展示的完整标题。",
"prefill": "DJI Osmo Mobile 8P 크리에이터 콤보"
},
"product_url": {
"type": "string",
"title": "商品链接",
"description": "商品详情页链接。",
"prefill": "https://brand.naver.com/dji/products/13467910320?13467910320"
},
"rating_score": {
"type": "string",
"title": "评分",
"description": "商品页面展示的评分文本。",
"prefill": "4.82"
},
"shipping_company_name": {
"type": "string",
"title": "配送公司",
"description": "商品页面展示的配送公司名称。",
"prefill": "CJ대한통운"
},
"shop_name": {
"type": "string",
"title": "店铺名称",
"description": "商品页面展示的店铺名称。",
"prefill": "DJI 공식 브랜드스토어"
},
"sku_id": {
"type": "string",
"title": "SKU 标识",
"description": "详情记录中的 SKU 标识文本。",
"prefill": "https://brand.naver.com/dji/products/13467910320"
},
"source_name": {
"type": "string",
"title": "数据来源标识",
"description": "详情记录中的数据来源标识。",
"prefill": "naver_detail_202609"
},
"spec": {
"type": "string",
"title": "规格信息",
"description": "商品规格信息原始文本。",
"prefill": "{}"
},
"total_review_count": {
"type": "string",
"title": "评论总数",
"description": "商品页面展示的评论总数文本。",
"prefill": "120"
},
"total_sales": {
"type": "string",
"title": "累计销量",
"description": "商品页面展示的累计销量文本。",
"prefill": "11248"
},
"updated_at": {
"type": "integer",
"title": "更新时间",
"description": "商品记录更新时间的 Unix 毫秒时间戳。",
"prefill": 1789351234641
},
"url_status": {
"type": "string",
"title": "链接状态",
"description": "商品链接采集结果状态文本。",
"prefill": "有效"
},
"task_meta": {
"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": {
"mona_kk__naver-product-detail": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/naver-product-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。