Skip to main content
Glama

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

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 积分,失败不扣费。

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "user_id": "<user_id>"
    },
    "name": "xhs_pgy_get_creator_notes_performance"
  }
}

Input Schema

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

Output 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. Changed2 schema fields changed
    • changedOutput schema / properties / points / description
      Previous value: -"本次成功调用的积分消耗与调用完成时的账户积分余额。"New value: +"本次成功调用的积分消耗与账户积分余额。"
    • changedOutput schema / properties / points / properties / balance / description
      Previous value: -"本次接口完成时看到的当前积分余额,可为负数。"New value: +"优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。"
  2. Changed2 schema fields changed
    • changedOutput schema / properties / points / properties / balance / description
      Previous value: -"本次接口完成时看到的当前积分余额。"New value: +"本次接口完成时看到的当前积分余额,可为负数。"
    • removedOutput schema / properties / points / properties / balance / minimum
      Removed value: -0
  3. Changed25 schema fields changed
    • addedOutput schema / properties / collect_median / title
      Added value: +"Collect Median"
    • addedOutput schema / properties / comment_median / title
      Added value: +"Comment Median"
    • changedOutput schema / properties / content_tags / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "ratio": {
      -          "description": "该内容标签占比,0.1 表示 10%",
      -          "maximum": 1,
      -          "minimum": 0,
      -          "type": "number"
      -        },
      -        "tag": {
      -          "description": "笔记内容标签",
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "tag",
      -        "ratio"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "ratio": {
      +          "description": "该内容标签占比,0.1 表示 10%",
      +          "maximum": 1,
      +          "minimum": 0,
      +          "title": "Ratio",
      +          "type": "number"
      +        },
      +        "tag": {
      +          "description": "笔记内容标签",
      +          "title": "Tag",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "tag",
      +        "ratio"
      +      ],
      +      "title": "PgyNoteContentTag",
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / properties / content_tags / title
      Added value: +"Content Tags"
    • addedOutput schema / properties / hundred_like_ratio / title
      Added value: +"Hundred Like Ratio"
    • addedOutput schema / properties / image_3s_view_rate / title
      Added value: +"Image 3S View Rate"
    • addedOutput schema / properties / impression_benchmark_rate / title
      Added value: +"Impression Benchmark Rate"
    • addedOutput schema / properties / impression_median / title
      Added value: +"Impression Median"
    • addedOutput schema / properties / interaction_benchmark_rate / title
      Added value: +"Interaction Benchmark Rate"
    • addedOutput schema / properties / interaction_median / title
      Added value: +"Interaction Median"
    • addedOutput schema / properties / interaction_rate / title
      Added value: +"Interaction Rate"
    • addedOutput schema / properties / like_median / title
      Added value: +"Like Median"
    • addedOutput schema / properties / note_count / title
      Added value: +"Note Count"
    • addedOutput schema / properties / note_scope / title
      Added value: +"Note Scope"
    • changedOutput schema / properties / notes / anyOf
      Previous 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"
      -  }
      -]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",
      +          "title": "Collect Benchmark Rate"
      +        },
      +        "collect_count": {
      +          "anyOf": [
      +            {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "笔记收藏量;未知时为 null",
      +          "title": "Collect Count"
      +        },
      +        "impression_benchmark_rate": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "笔记该指标相较于平台中位数的相对差异;0 表示持平,-0.5 表示低于 50%,1.282 表示高于 128.2%,允许负数和超过 1;不是排名或百分位。保留平台口径,不可用返回计数自行复算;未知时为 null",
      +          "title": "Impression Benchmark Rate"
      +        },
      +        "impression_count": {
      +          "anyOf": [
      +            {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "笔记曝光量;未知时为 null",
      +          "title": "Impression Count"
      +        },
      +        "interaction_benchmark_rate": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "笔记该指标相较于平台中位数的相对差异;0 表示持平,-0.5 表示低于 50%,1.282 表示高于 128.2%,允许负数和超过 1;不是排名或百分位。保留平台口径,不可用返回计数自行复算;未知时为 null",
      +          "title": "Interaction Benchmark Rate"
      +        },
      +        "interaction_count": {
      +          "anyOf": [
      +            {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "蒲公英口径综合互动量;具体构成以上游口径为准;未知时为 null",
      +          "title": "Interaction Count"
      +        },
      +        "like_benchmark_rate": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "笔记该指标相较于平台中位数的相对差异;0 表示持平,-0.5 表示低于 50%,1.282 表示高于 128.2%,允许负数和超过 1;不是排名或百分位。保留平台口径,不可用返回计数自行复算;未知时为 null",
      +          "title": "Like Benchmark Rate"
      +        },
      +        "like_count": {
      +          "anyOf": [
      +            {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "笔记点赞量;未知时为 null",
      +          "title": "Like Count"
      +        },
      +        "note_id": {
      +          "description": "小红书笔记 ID;必须为完整的 24 位小写十六进制 ID",
      +          "pattern": "^[0-9a-f]{24}$",
      +          "title": "Note Id",
      +          "type": "string"
      +        },
      +        "note_type": {
      +          "anyOf": [
      +            {
      +              "enum": [
      +                "image",
      +                "video"
      +              ],
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "笔记类型:image 表示图文,video 表示视频;未知时为 null",
      +          "title": "Note Type"
      +        },
      +        "publish_date": {
      +          "anyOf": [
      +            {
      +              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "发布日期(YYYY-MM-DD);上游未提供时为 null",
      +          "title": "Publish Date"
      +        },
      +        "read_benchmark_rate": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "笔记该指标相较于平台中位数的相对差异;0 表示持平,-0.5 表示低于 50%,1.282 表示高于 128.2%,允许负数和超过 1;不是排名或百分位。保留平台口径,不可用返回计数自行复算;未知时为 null",
      +          "title": "Read Benchmark Rate"
      +        },
      +        "read_count": {
      +          "anyOf": [
      +            {
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "笔记阅读量;未知时为 null",
      +          "title": "Read Count"
      +        },
      +        "thumbnail_url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "笔记缩略图地址;缺失时为 null",
      +          "title": "Thumbnail Url"
      +        },
      +        "title": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "笔记标题;缺失时为 null",
      +          "title": "Title"
      +        }
      +      },
      +      "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"
      +      ],
      +      "title": "PgyNotePerformanceItem",
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / properties / notes / title
      Added value: +"Notes"
    • addedOutput schema / properties / read_benchmark_rate / title
      Added value: +"Read Benchmark Rate"
    • addedOutput schema / properties / read_median / title
      Added value: +"Read Median"
    • addedOutput schema / properties / share_median / title
      Added value: +"Share Median"
    • addedOutput schema / properties / thousand_like_ratio / title
      Added value: +"Thousand Like Ratio"
    • addedOutput schema / properties / user_id / title
      Added value: +"User Id"
    • addedOutput schema / properties / video_full_view_benchmark_rate / title
      Added value: +"Video Full View Benchmark Rate"
    • addedOutput schema / properties / video_full_view_rate / title
      Added value: +"Video Full View Rate"
    • addedOutput schema / properties / video_note_count / title
      Added value: +"Video Note Count"
    • addedOutput schema / title
      Added value: +"PgyCreatorNotesPerformance"
  4. 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"
      +]
  5. 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"
  6. 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"
      +]
  7. Added

TDQS

A4.6/5.0
Behavior4/5

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

Annotations only cover readOnly/openWorld; the description adds substantial behavior the agent could not otherwise know: fixed 30-day window, image+video, all traffic, no custom date or note type, detail capped at 15 notes. It also discloses cost semantics (success deducts 20 credits, failure free) and warns that 0 values for completion rate / 3s read rate are not real zeros when the relevant note type is absent. A minor gap remains: it does not say whether results are cached or how fresh the 30-day window is.

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-loaded with purpose, then usage routing, then caveats, scope limits, and cost — a sensible order with no filler sentences. It is dense and long for a two-parameter tool, but each sentence carries an operational constraint rather than restating the schema.

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?

Output schema exists, so return values need not be re-explained, yet the description still flags the one field family (benchmark_rate) that is easy to misread. Combined with cost, fixed-window scope, and the 15-note cap, an agent has everything needed to call this correctly and interpret results.

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

Parameters4/5

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

With 100% schema coverage the baseline is 3, but the description adds real meaning: it stresses that a complete user_id is required (reinforcing the schema's pattern constraint) and clarifies that note_scope cannot be combined with custom date ranges or note types because scope is fixed. The benchmark_rate caveat (can be negative or exceed 1, not a ranking percentile; summary-level field is a different 0–1 construct) disambiguates field semantics beyond what the schema says.

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?

Opens with a specific verb+resource (获取小红书蒲公英创作者笔记表现) and enumerates the returned metrics (笔记数量、曝光/阅读/互动中位数、互动率、完播率、3秒阅读率、内容标签、明细). It also names the sibling tools it is not (商业概览工具, 创作者档案工具), so an agent can route without opening competing schemas.

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 states when to use it (查询日常或合作笔记表现及最近明细) and names two alternatives with the conditions that select them (商业汇总与成本 → 商业概览; 资料和报价 → 创作者档案). Nothing about tool selection is left to inference.

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