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已售数量;平台以带“+”的万级文本展示时转换为对应整数下限(如“已售1万+”返回 10000、“已售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. Added

TDQS

A4.7/5.0
Behavior5/5

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

The description explicitly lists unsupported input types (note links, blogger pages, pure share codes, search terms), setting accurate expectations beyond the readOnly annotation. It also mentions the returned sku_id can be reused, clarifying downstream behavior.

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?

The description is two sentences, direct, and free of fluff. It efficiently communicates purpose, alternatives, and downstream usage without 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?

The description provides sufficient context for a read-only retrieval tool: it indicates the input format, the fallback condition, and a concrete follow-up action (using sku_id for reviews), making it self-contained for agent use.

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?

The parameter description in the schema already fully covers the accepted and rejected input formats. The tool description adds little beyond that, so the baseline of 3 applies due to high schema coverage.

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?

The description clearly states the tool retrieves product details from a product link, short link, or share text, and distinguishes it from the sku_id-based sibling tool.

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?

Explicitly advises using xhs_get_product_detail_by_sku_id when a complete sku_id is already available, and notes that no search is needed, providing clear selection criteria among siblings.

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