Skip to main content
Glama

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

xhs_get_product_detail_by_url

Read-only

根据小红书商品链接、短链接或分享文案获取商品详情,无需先搜索。已有完整 sku_id 时使用 xhs_get_product_detail_by_sku_id;返回的 sku_id 可继续用于商品评价工具。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
urlYes小红书商品详情链接、短链接或包含商品链接的完整分享文案。不支持笔记链接、博主主页链接、纯分享口令或搜索词。

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
priceYes当前 SKU 的商品原价,单位:元;不是商品搜索的展示销售价,也不是最终实付价
titleYes商品标题
pointsYes本次成功调用的积分消耗与调用完成时的账户积分余额。
sku_idYes商品 SKU ID
shop_idYes店铺 ID
shippingYes发货信息
shop_nameYes店铺名称
assurancesYes商品保障服务列表
sales_textYes平台展示的商品销量文本;没有时为空字符串。带“+”的数量表示下限,不是精确销量;结合 sold_count 解读。
shop_scoreYes店铺评分展示值;没有评分时为空字符串
sold_countYes已售数量;平台以带“+”的千级或万级文本展示时转换为对应整数下限(如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000),不是精确销量,须结合 sales_text 解读;缺失或无法解析时为 null,不代表零销量;0 表示明确已售 0。
main_imagesYes商品顶部主图/轮播图列表
coupon_priceYes当前 SKU 展示的券后/成交价格,单位:元;不保证是最终实付价
stock_statusYes库存状态码;具体码值含义未公开定义,不要自行解释为是否在售或是否可购买
detail_imagesYes商品详情图列表
shop_fans_textYes店铺粉丝数展示值;没有粉丝信息时为空字符串
shop_sold_textYes店铺已售展示值;没有已售信息时为空字符串
specificationsYes商品属性/规格参数列表(name/value),不是可选 SKU 规格组
shop_avatar_urlYes店铺头像链接
selected_variantYes当前选中规格;没有规格时为空字符串

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / sold_count / description
      Previous value: -"已售数量;平台以带“+”的万级文本展示时转换为对应整数下限(如“已售1万+”返回 10000、“已售1.2万+”返回 12000),不是精确销量,须结合 sales_text 解读;缺失或无法解析时为 null,不代表零销量;0 表示明确已售 0。"New value: +"已售数量;平台以带“+”的千级或万级文本展示时转换为对应整数下限(如“90.2k+ sold”返回 90200、“已售1.2万+”返回 12000),不是精确销量,须结合 sales_text 解读;缺失或无法解析时为 null,不代表零销量;0 表示明确已售 0。"
  2. Added

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

注解已声明 readOnlyHint=true 和 openWorldHint=true,因此安全行为已有覆盖。描述额外补充了行为上下文:接受短链接和分享文案、无需先搜索、返回的 sku_id 可复用,为调用决策提供了有价值的信息。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

两句话毫无冗余,第一句直述核心功能和输入形式,第二句给出替代方案和后续用途。信息密度高且无浪费。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

工具只有一个参数、有输出 schema 和注解,描述已覆盖输入变体、与 SKU 工具的区分以及返回值复用路径。没有明显缺口,代理在需要调用时不会缺少关键信息。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema 对参数 url 的描述已非常完整,覆盖支持和不支持的链接类型(覆盖率 100%)。描述本身没有在 schema 之外增加新的参数格式细节,按基线给予 3 分。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

描述明确说明工具功能:根据商品链接、短链接或分享文案获取商品详情,动词和资源清晰。还通过指向 xhs_get_product_detail_by_sku_id 的使用场景将自己与同类工具区分开来,避免歧义。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

描述明确给出使用时机:已有完整 sku_id 时改用 xhs_get_product_detail_by_sku_id,无需先搜索,且指出返回的 sku_id 可继续用于商品评价工具。排除了替代方案并给出下游用途,属于显式指引。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources