Skip to main content
Glama

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

by com.52choujiang
OverviewDiscussionsAdmin

xhs_pgy_get_creator_notes_performance

Read-only

根据完整 user_id 获取小红书蒲公英创作者笔记表现，包括笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和笔记明细。 查询日常或合作笔记表现及最近明细时使用；商业汇总与成本参考使用商业概览工具，资料和报价使用创作者档案工具。 视频完播相关字段仅在 video_note_count 大于 0 时用于表现判断；图文 3 秒阅读率仅在统计范围内有图文笔记时用于表现判断；其他情况下 0 值不表示对应表现为 0%。 固定近30日、图文＋视频、全流量，不支持自选日期或笔记类型；明细最多 15 篇，不是全量列表。仅 notes[] 内的 *_benchmark_rate 是相较于平台中位数的相对差异，允许负数和超过 1，不能当作排名比例；汇总层同名字段仍是平台返回的 0 到 1 对比值，计算方式未公开，不能混用。 成功返回表现字段和 points；成功调用扣减 20 积分，失败不扣费。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
user_idYes小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
note_scopeNo笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径daily

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
notesYes统计范围内最近发布的最多 15 篇笔记表现明细，不是全量列表；未知时为 null，明确为空时为 []
pointsYes本次成功调用的积分消耗与调用完成时的账户积分余额。
user_idYes小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
note_countYes统计范围内笔记数；未知时为 null
note_scopeYes笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径
like_medianYes笔记点赞量中位数；未知时为 null
read_medianYes笔记阅读量中位数；未知时为 null
content_tagsYes笔记内容标签分布；返回标签不保证覆盖全部内容，占比之和不保证为 1；不要自行归一化或补齐其他类别；未知时为 null，明确为空时为 []
share_medianYes笔记分享量中位数；未知时为 null
collect_medianYes笔记收藏量中位数；未知时为 null
comment_medianYes笔记评论量中位数；未知时为 null
interaction_rateYes平台返回的笔记互动率，0.195 表示 19.5%；本响应未提供可确认的计算分母和完整统计口径，不可用返回计数自行复算；未知时为 null
video_note_countYes统计范围内视频笔记数；未知时为 null
impression_medianYes笔记曝光量中位数；未知时为 null
hundred_like_ratioYes获赞不少于 100 的笔记占比，0.1 表示 10%；未知时为 null
image_3s_view_rateYes图文笔记 3 秒阅读率，0.195 表示 19.5%；仅在统计范围内有图文笔记时用于表现判断；否则 0 值不表示 3 秒阅读率为 0%；未知时为 null
interaction_medianYes平台汇总口径的笔记互动量中位数；不保证与 notes[].interaction_count 的统计口径一致，不可直接用返回的笔记明细复算；未知时为 null
read_benchmark_rateYes平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null
thousand_like_ratioYes获赞不少于 1000 的笔记占比，0.1 表示 10%；未知时为 null
video_full_view_rateYes视频完播率，0.195 表示 19.5%；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示完播率为 0%；未知时为 null
impression_benchmark_rateYes平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null
interaction_benchmark_rateYes平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null
video_full_view_benchmark_rateYes平台返回的视频完播指标对比值，范围 0~1；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示表现为 0；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changed
    • addedInput schema / properties / note_scope
      Added value: +{
+  "default": "daily",
+  "description": "笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径",
+  "enum": [
+    "daily",
+    "cooperation"
+  ],
+  "type": "string"
+}
    • changedOutput schema / properties / content_tags / description
      Previous value: -"笔记内容标签分布；未知时为 null，明确为空时为 []"New value: +"笔记内容标签分布；返回标签不保证覆盖全部内容，占比之和不保证为 1；不要自行归一化或补齐其他类别；未知时为 null，明确为空时为 []"
    • addedOutput schema / properties / note_scope
      Added value: +{
+  "description": "笔记统计口径：日常笔记选 daily（默认，不是按天汇总）；商单或品牌合作笔记选 cooperation。固定近30日、图文＋视频、全流量；输出回显口径",
+  "enum": [
+    "daily",
+    "cooperation"
+  ],
+  "type": "string"
+}
    • changedOutput schema / properties / notes / anyOf
      Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "collect_benchmark_rate": {
-          "anyOf": [
-            {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
-        },
-        "collect_count": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记收藏量；未知时为 null"
-        },
-        "impression_benchmark_rate": {
-          "anyOf": [
-            {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
-        },
-        "impression_count": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记曝光量；未知时为 null"
-        },
-        "interaction_benchmark_rate": {
-          "anyOf": [
-            {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
-        },
-        "interaction_count": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "蒲公英口径综合互动量；具体构成以上游口径为准；未知时为 null"
-        },
-        "like_benchmark_rate": {
-          "anyOf": [
-            {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
-        },
-        "like_count": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记点赞量；未知时为 null"
-        },
-        "note_id": {
-          "description": "小红书笔记 ID；必须为完整的 24 位小写十六进制 ID",
-          "pattern": "^[0-9a-f]{24}$",
-          "type": "string"
-        },
-        "note_type": {
-          "anyOf": [
-            {
-              "enum": [
-                "image",
-                "video"
-              ],
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记类型：image 表示图文，video 表示视频；未知时为 null"
-        },
-        "publish_date": {
-          "anyOf": [
-            {
-              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "发布日期（YYYY-MM-DD）；上游未提供时为 null"
-        },
-        "read_benchmark_rate": {
-          "anyOf": [
-            {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
-        },
-        "read_count": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记阅读量；未知时为 null"
-        },
-        "thumbnail_url": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记缩略图地址；缺失时为 null"
-        },
-        "title": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记标题；缺失时为 null"
-        }
-      },
-      "required": [
-        "note_id",
-        "publish_date",
-        "note_type",
-        "thumbnail_url",
-        "title",
-        "impression_count",
-        "impression_benchmark_rate",
-        "read_count",
-        "read_benchmark_rate",
-        "interaction_count",
-        "interaction_benchmark_rate",
-        "collect_count",
-        "like_count",
-        "collect_benchmark_rate",
-        "like_benchmark_rate"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "collect_benchmark_rate": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null"
+        },
+        "collect_count": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记收藏量；未知时为 null"
+        },
+        "impression_benchmark_rate": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null"
+        },
+        "impression_count": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记曝光量；未知时为 null"
+        },
+        "interaction_benchmark_rate": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null"
+        },
+        "interaction_count": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "蒲公英口径综合互动量；具体构成以上游口径为准；未知时为 null"
+        },
+        "like_benchmark_rate": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null"
+        },
+        "like_count": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记点赞量；未知时为 null"
+        },
+        "note_id": {
+          "description": "小红书笔记 ID；必须为完整的 24 位小写十六进制 ID",
+          "pattern": "^[0-9a-f]{24}$",
+          "type": "string"
+        },
+        "note_type": {
+          "anyOf": [
+            {
+              "enum": [
+                "image",
+                "video"
+              ],
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记类型：image 表示图文，video 表示视频；未知时为 null"
+        },
+        "publish_date": {
+          "anyOf": [
+            {
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "发布日期（YYYY-MM-DD）；上游未提供时为 null"
+        },
+        "read_benchmark_rate": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记该指标相较于平台中位数的相对差异；0 表示持平，-0.5 表示低于 50%，1.282 表示高于 128.2%，允许负数和超过 1；不是排名或百分位。保留平台口径，不可用返回计数自行复算；未知时为 null"
+        },
+        "read_count": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记阅读量；未知时为 null"
+        },
+        "thumbnail_url": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记缩略图地址；缺失时为 null"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记标题；缺失时为 null"
+        }
+      },
+      "required": [
+        "note_id",
+        "publish_date",
+        "note_type",
+        "thumbnail_url",
+        "title",
+        "impression_count",
+        "impression_benchmark_rate",
+        "read_count",
+        "read_benchmark_rate",
+        "interaction_count",
+        "interaction_benchmark_rate",
+        "collect_count",
+        "like_count",
+        "collect_benchmark_rate",
+        "like_benchmark_rate"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedOutput schema / properties / notes / description
      Previous value: -"统计范围内的笔记表现明细；未知时为 null，明确为空时为 []"New value: +"统计范围内最近发布的最多 15 篇笔记表现明细，不是全量列表；未知时为 null，明确为空时为 []"
    • changedOutput schema / required
      Previous value: -[
-  "user_id",
-  "note_count",
-  "video_note_count",
-  "hundred_like_ratio",
-  "thousand_like_ratio",
-  "content_tags",
-  "impression_median",
-  "impression_benchmark_rate",
-  "read_median",
-  "read_benchmark_rate",
-  "interaction_median",
-  "interaction_rate",
-  "interaction_benchmark_rate",
-  "like_median",
-  "collect_median",
-  "comment_median",
-  "share_median",
-  "video_full_view_rate",
-  "video_full_view_benchmark_rate",
-  "image_3s_view_rate",
-  "notes",
-  "points"
-]New value: +[
+  "user_id",
+  "note_scope",
+  "note_count",
+  "video_note_count",
+  "hundred_like_ratio",
+  "thousand_like_ratio",
+  "content_tags",
+  "impression_median",
+  "impression_benchmark_rate",
+  "read_median",
+  "read_benchmark_rate",
+  "interaction_median",
+  "interaction_rate",
+  "interaction_benchmark_rate",
+  "like_median",
+  "collect_median",
+  "comment_median",
+  "share_median",
+  "video_full_view_rate",
+  "video_full_view_benchmark_rate",
+  "image_3s_view_rate",
+  "notes",
+  "points"
+]
  2. Changed2 schema fields changed
    • changedOutput schema / properties / interaction_median / description
      Previous value: -"笔记互动量中位数；未知时为 null"New value: +"平台汇总口径的笔记互动量中位数；不保证与 notes[].interaction_count 的统计口径一致，不可直接用返回的笔记明细复算；未知时为 null"
    • changedOutput schema / properties / interaction_rate / description
      Previous value: -"笔记互动率，0.195 表示 19.5%；未知时为 null"New value: +"平台返回的笔记互动率，0.195 表示 19.5%；本响应未提供可确认的计算分母和完整统计口径，不可用返回计数自行复算；未知时为 null"
  3. Changed8 schema fields changed
    • changedOutput schema / properties / image_3s_view_rate / description
      Previous value: -"图文笔记 3 秒阅读率，0.195 表示 19.5%；未知时为 null"New value: +"图文笔记 3 秒阅读率，0.195 表示 19.5%；仅在统计范围内有图文笔记时用于表现判断；否则 0 值不表示 3 秒阅读率为 0%；未知时为 null"
    • changedOutput schema / properties / impression_benchmark_rate / description
      Previous value: -"曝光中位数相对蒲公英上游 BeyondRate 口径的比例；未知时为 null"New value: +"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
    • changedOutput schema / properties / interaction_benchmark_rate / description
      Previous value: -"互动中位数相对蒲公英上游 BeyondRate 口径的比例；未知时为 null"New value: +"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
    • changedOutput schema / properties / notes / anyOf
      Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "collect_benchmark_rate": {
-          "anyOf": [
-            {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "收藏指标相对上游对比口径的比例；未知时为 null"
-        },
-        "collect_count": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记收藏量；未知时为 null"
-        },
-        "impression_benchmark_rate": {
-          "anyOf": [
-            {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "曝光指标相对上游对比口径的比例；未知时为 null"
-        },
-        "impression_count": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记曝光量；未知时为 null"
-        },
-        "interaction_benchmark_rate": {
-          "anyOf": [
-            {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "互动指标相对蒲公英上游 BeyondRate 口径的比例；未知时为 null"
-        },
-        "interaction_count": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "蒲公英口径综合互动量；具体构成以上游口径为准；未知时为 null"
-        },
-        "like_benchmark_rate": {
-          "anyOf": [
-            {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "点赞指标相对上游对比口径的比例；未知时为 null"
-        },
-        "like_count": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记点赞量；未知时为 null"
-        },
-        "note_id": {
-          "description": "笔记 ID",
-          "type": "string"
-        },
-        "note_type": {
-          "anyOf": [
-            {
-              "enum": [
-                "image",
-                "video"
-              ],
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记类型：image 表示图文，video 表示视频；未知时为 null"
-        },
-        "publish_date": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "发布日期（YYYY-MM-DD）；上游未提供时为 null"
-        },
-        "read_benchmark_rate": {
-          "anyOf": [
-            {
-              "maximum": 1,
-              "minimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "阅读指标相对上游对比口径的比例；未知时为 null"
-        },
-        "read_count": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记阅读量；未知时为 null"
-        },
-        "thumbnail_url": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记缩略图地址；缺失时为 null"
-        },
-        "title": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "笔记标题；缺失时为 null"
-        }
-      },
-      "required": [
-        "note_id",
-        "publish_date",
-        "note_type",
-        "thumbnail_url",
-        "title",
-        "impression_count",
-        "impression_benchmark_rate",
-        "read_count",
-        "read_benchmark_rate",
-        "interaction_count",
-        "interaction_benchmark_rate",
-        "collect_count",
-        "like_count",
-        "collect_benchmark_rate",
-        "like_benchmark_rate"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "collect_benchmark_rate": {
+          "anyOf": [
+            {
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
+        },
+        "collect_count": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记收藏量；未知时为 null"
+        },
+        "impression_benchmark_rate": {
+          "anyOf": [
+            {
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
+        },
+        "impression_count": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记曝光量；未知时为 null"
+        },
+        "interaction_benchmark_rate": {
+          "anyOf": [
+            {
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
+        },
+        "interaction_count": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "蒲公英口径综合互动量；具体构成以上游口径为准；未知时为 null"
+        },
+        "like_benchmark_rate": {
+          "anyOf": [
+            {
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
+        },
+        "like_count": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记点赞量；未知时为 null"
+        },
+        "note_id": {
+          "description": "小红书笔记 ID；必须为完整的 24 位小写十六进制 ID",
+          "pattern": "^[0-9a-f]{24}$",
+          "type": "string"
+        },
+        "note_type": {
+          "anyOf": [
+            {
+              "enum": [
+                "image",
+                "video"
+              ],
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记类型：image 表示图文，video 表示视频；未知时为 null"
+        },
+        "publish_date": {
+          "anyOf": [
+            {
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "发布日期（YYYY-MM-DD）；上游未提供时为 null"
+        },
+        "read_benchmark_rate": {
+          "anyOf": [
+            {
+              "maximum": 1,
+              "minimum": 0,
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
+        },
+        "read_count": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记阅读量；未知时为 null"
+        },
+        "thumbnail_url": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记缩略图地址；缺失时为 null"
+        },
+        "title": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "笔记标题；缺失时为 null"
+        }
+      },
+      "required": [
+        "note_id",
+        "publish_date",
+        "note_type",
+        "thumbnail_url",
+        "title",
+        "impression_count",
+        "impression_benchmark_rate",
+        "read_count",
+        "read_benchmark_rate",
+        "interaction_count",
+        "interaction_benchmark_rate",
+        "collect_count",
+        "like_count",
+        "collect_benchmark_rate",
+        "like_benchmark_rate"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedOutput schema / properties / read_benchmark_rate / description
      Previous value: -"阅读中位数相对蒲公英上游 BeyondRate 口径的比例；未知时为 null"New value: +"平台返回的指标对比值，范围 0~1；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
    • addedOutput schema / properties / video_full_view_benchmark_rate
      Added value: +{
+  "anyOf": [
+    {
+      "maximum": 1,
+      "minimum": 0,
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "平台返回的视频完播指标对比值，范围 0~1；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示表现为 0；比较对象和计算方式未公开，不得视为固定阈值、行业排名或百分位；未知时为 null"
+}
    • changedOutput schema / properties / video_full_view_rate / description
      Previous value: -"视频完播率，0.195 表示 19.5%；未知时为 null"New value: +"视频完播率，0.195 表示 19.5%；仅在 video_note_count 大于 0 时用于表现判断；否则 0 值不表示完播率为 0%；未知时为 null"
    • changedOutput schema / required
      Previous value: -[
-  "user_id",
-  "note_count",
-  "video_note_count",
-  "hundred_like_ratio",
-  "thousand_like_ratio",
-  "content_tags",
-  "impression_median",
-  "impression_benchmark_rate",
-  "read_median",
-  "read_benchmark_rate",
-  "interaction_median",
-  "interaction_rate",
-  "interaction_benchmark_rate",
-  "like_median",
-  "collect_median",
-  "comment_median",
-  "share_median",
-  "video_full_view_rate",
-  "image_3s_view_rate",
-  "notes",
-  "points"
-]New value: +[
+  "user_id",
+  "note_count",
+  "video_note_count",
+  "hundred_like_ratio",
+  "thousand_like_ratio",
+  "content_tags",
+  "impression_median",
+  "impression_benchmark_rate",
+  "read_median",
+  "read_benchmark_rate",
+  "interaction_median",
+  "interaction_rate",
+  "interaction_benchmark_rate",
+  "like_median",
+  "collect_median",
+  "comment_median",
+  "share_median",
+  "video_full_view_rate",
+  "video_full_view_benchmark_rate",
+  "image_3s_view_rate",
+  "notes",
+  "points"
+]
  4. Added

TDQS

A4.6/5.0
Behavior5/5

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

Annotations only cover readOnly and openWorld, so the description carries the behavioral load and does so richly: 20-credit cost on success / no charge on failure, fixed 30-day window with no custom date or note-type selection, detail capped at 15 notes (not exhaustive), and an explicit semantic caveat that 0 values for video-completion/3s-read fields are not real zeros. It also warns that notes[] *_benchmark_rate can be negative or >1 and must not be mixed with the summary-level 0-1 fields.

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

Conciseness4/5

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

Front-loads the purpose and the fields returned, then layers usage, caveats, and cost. Some phrases (固定近30日、图文＋视频、全流量) are restated from the schema description, but overall every sentence carries operational meaning and is well signposted.

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?

With an output schema present, return values need no prose, and the description still supplies everything an agent needs to call correctly: required-id sourcing rules, cost, fixed analytical window, detail cap, and field-semantics traps. Nothing material is left to guess.

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 description coverage is 100%, so both user_id (format guidance) and note_scope (enum semantics, default, fixed scope) are already fully documented in the schema. The description adds scope constraints around the call but nothing per-parameter beyond what the schema states, so the baseline 3 applies.

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?

States a specific verb (获取) and resource (蒲公英创作者笔记表现) and enumerates the returned metric families (曝光/阅读/互动中位数、互动率、完播率、图文3秒阅读率、内容标签、笔记明细). It explicitly distinguishes itself from siblings by naming the commercial-overview and creator-profile tools. An agent can identify scope without opening the schema.

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?

Gives explicit when-to-use ('查询日常或合作笔记表现及最近明细时使用') and routes two adjacent needs to named alternatives (商业汇总→商业概览工具, 资料和报价→创作者档案工具). No inference required to pick this over its siblings.

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

All SocialDataX 小红书 Xiaohongshu XHS RedNote MCP toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources