概览
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>要采集详情的 Naver 商品详情页完整 URL,每项填写一个链接;一次可提交 1 至 200 项。数量最多 200 项示例[{"item":"https://brand.naver.com/dji/products/13467910320"}]
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 横幅图片链接
banner_image_url_liststring商品详情中的横幅图片链接列表原始文本。示例["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_idstringNaver 商品详情对应的业务标识,通常为商品详情页链接。示例https://brand.naver.com/dji/products/13467910320 - 品牌名称
brand_namestring商品页面展示的品牌名称。示例DJI - 商品分类
category_namestring商品页面展示的分类名称。示例짐벌
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"banner_image_url_list": "[\"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": "https://brand.naver.com/dji/products/13467910320",
"brand_name": "DJI",
"category_name": "짐벌",
"crawl_time": "2026-09-14T10:00:34",
"created_at": 1789351234641,
"discount": "0",
"item": "https://brand.naver.com/dji/products/13467910320",
"job_type": "BasicInfo",
"main_image_url": "https://shop-phinf.pstatic.net/20260521_16/1779323678450AFIJH_JPEG/25466701428756421_367248028.jpg",
"original_price": "268000",
"pay_reference_key": "510448366",
"platform_code": "naver",
"price": "268000",
"product_no": "13408803046",
"product_title": "DJI Osmo Mobile 8P 크리에이터 콤보",
"product_url": "https://brand.naver.com/dji/products/13467910320?13467910320",
"rating_score": "4.82",
"shipping_company_name": "CJ대한통운",
"shop_name": "DJI 공식 브랜드스토어",
"sku_id": "https://brand.naver.com/dji/products/13467910320",
"source_name": "naver_detail_202609",
"spec": "{}",
"total_review_count": "120",
"total_sales": "11248",
"updated_at": 1789351234641,
"url_status": "有效",
"task_meta": "<task_meta>"
}调用方式
本 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=mona_kk/naver-product-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。