Skip to main content
Glama

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

xhs_get_topic_notes_by_page_id

Read-only

根据 page_id 获取标签页笔记列表,支持 sort_type 排序和 page_token 翻页。

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": {
      "page_id": "<page_id>"
    },
    "name": "xhs_get_topic_notes_by_page_id"
  }
}

Input Schema

NameRequiredDescriptionDefault
page_idYes小红书标签页 page_id。
sort_typeNo标签页笔记排序方式,可选:hot(最热,默认)、time_descending(最新)hot
page_tokenNo分页令牌。首次请求留空;继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌,只绑定当前标签页和排序链路,不能跨 page_id 或排序复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。

Output Schema

NameRequiredDescriptionDefault
itemsYes标签页笔记列表
pointsYes本次成功调用的积分消耗与账户积分余额。
next_page_tokenYes下一页不透明分页令牌;非空表示可尝试请求下一页,为空表示当前没有可继续的下一页令牌。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前标签页和排序链路,不能跨 page_id 或排序复用;items 为空时不要单独据此判断结束;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。
total_note_countYes标签页笔记总数
total_user_countYes标签页涉及用户总数

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. Changed23 schema fields changed
    • addedOutput schema / properties / items / items / properties / author / properties / avatar_url / title
      Added value: +"Avatar Url"
    • addedOutput schema / properties / items / items / properties / author / properties / name / title
      Added value: +"Name"
    • addedOutput schema / properties / items / items / properties / author / properties / profile_url / title
      Added value: +"Profile Url"
    • addedOutput schema / properties / items / items / properties / author / properties / user_id / title
      Added value: +"User Id"
    • addedOutput schema / properties / items / items / properties / author / title
      Added value: +"BaseAuthorSummary"
    • addedOutput schema / properties / items / items / properties / cover_image_url / title
      Added value: +"Cover Image Url"
    • addedOutput schema / properties / items / items / properties / image_items / items / properties / height / title
      Added value: +"Height"
    • addedOutput schema / properties / items / items / properties / image_items / items / properties / image_url / title
      Added value: +"Image Url"
    • addedOutput schema / properties / items / items / properties / image_items / items / properties / width / title
      Added value: +"Width"
    • addedOutput schema / properties / items / items / properties / image_items / items / title
      Added value: +"TopicNoteImageItem"
    • addedOutput schema / properties / items / items / properties / image_items / title
      Added value: +"Image Items"
    • addedOutput schema / properties / items / items / properties / like_count / title
      Added value: +"Like Count"
    • addedOutput schema / properties / items / items / properties / note_id / title
      Added value: +"Note Id"
    • addedOutput schema / properties / items / items / properties / note_type / title
      Added value: +"Note Type"
    • addedOutput schema / properties / items / items / properties / publish_time / title
      Added value: +"Publish Time"
    • addedOutput schema / properties / items / items / properties / title / title
      Added value: +"Title"
    • changedOutput schema / properties / items / items / properties / video / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "duration_ms": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频原始时长,单位毫秒;没有时长时为 null"
      -      },
      -      "height": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频高度,像素;没有时为 null"
      -      },
      -      "video_url": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频链接;没有视频链接时为 null"
      -      },
      -      "width": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频宽度,像素;没有时为 null"
      -      }
      -    },
      -    "required": [
      -      "video_url",
      -      "duration_ms",
      -      "width",
      -      "height"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "duration_ms": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频原始时长,单位毫秒;没有时长时为 null",
      +        "title": "Duration Ms"
      +      },
      +      "height": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频高度,像素;没有时为 null",
      +        "title": "Height"
      +      },
      +      "video_url": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频链接;没有视频链接时为 null",
      +        "title": "Video Url"
      +      },
      +      "width": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频宽度,像素;没有时为 null",
      +        "title": "Width"
      +      }
      +    },
      +    "required": [
      +      "video_url",
      +      "duration_ms",
      +      "width",
      +      "height"
      +    ],
      +    "title": "SearchNoteVideo",
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / properties / items / items / title
      Added value: +"TopicNoteItem"
    • addedOutput schema / properties / items / title
      Added value: +"Items"
    • addedOutput schema / properties / next_page_token / title
      Added value: +"Next Page Token"
    • addedOutput schema / properties / total_note_count / title
      Added value: +"Total Note Count"
    • addedOutput schema / properties / total_user_count / title
      Added value: +"Total User Count"
    • addedOutput schema / title
      Added value: +"TopicNotesResult"
  4. Changed4 schema fields changed
    • addedOutput schema / properties / items / items / properties / image_items / items / properties / height
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "图片高度,像素;没有时为 null"
      +}
    • addedOutput schema / properties / items / items / properties / image_items / items / properties / width
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "图片宽度,像素;没有时为 null"
      +}
    • changedOutput schema / properties / items / items / properties / image_items / items / required
      Previous value: -[
      -  "image_url"
      -]New value: +[
      +  "image_url",
      +  "width",
      +  "height"
      +]
    • changedOutput schema / properties / items / items / properties / video / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "duration_ms": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频原始时长,单位毫秒;没有时长时为 null"
      -      },
      -      "video_url": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频链接;没有视频链接时为 null"
      -      }
      -    },
      -    "required": [
      -      "video_url",
      -      "duration_ms"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "duration_ms": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频原始时长,单位毫秒;没有时长时为 null"
      +      },
      +      "height": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频高度,像素;没有时为 null"
      +      },
      +      "video_url": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频链接;没有视频链接时为 null"
      +      },
      +      "width": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频宽度,像素;没有时为 null"
      +      }
      +    },
      +    "required": [
      +      "video_url",
      +      "duration_ms",
      +      "width",
      +      "height"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  5. Changed1 schema field changed
    • changedOutput schema / properties / items / items / properties / note_id / description
      Previous value: -"note_id 是小红书笔记 ID。必须原样复制笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表返回的完整 note_id;不得截断、缩写、脱敏、补全、格式化、重组,也不得只传前缀。"New value: +"note_id 是小红书笔记 ID。已有完整 note_id 时原样使用;否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制;不得截断、缩写、脱敏、补全、格式化、重组,也不得只传前缀。"
  6. Changed2 schema fields changed
    • addedOutput schema / properties / points
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      +  "properties": {
      +    "balance": {
      +      "description": "本次接口完成时看到的当前积分余额。",
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "cost": {
      +      "description": "本次请求最终确认消耗的积分。",
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "cost",
      +    "balance"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "items",
      -  "next_page_token",
      -  "total_note_count",
      -  "total_user_count"
      -]New value: +[
      +  "items",
      +  "next_page_token",
      +  "total_note_count",
      +  "total_user_count",
      +  "points"
      +]
  7. Changed1 schema field changed
    • changedOutput schema / properties / items / items / properties / note_id / description
      Previous value: -"note_id 是小红书笔记 ID。必须原样复制搜索、详情、评论、标签页笔记列表或用户发帖列表返回的完整 note_id;不得截断、缩写、脱敏、补全、格式化、重组,也不得只传前缀。"New value: +"note_id 是小红书笔记 ID。必须原样复制笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表返回的完整 note_id;不得截断、缩写、脱敏、补全、格式化、重组,也不得只传前缀。"
  8. Changed8 schema fields changed
    • removedOutput schema / properties / items / items / properties / collect_count
      Removed value: -{
      -  "description": "收藏数",
      -  "type": "integer"
      -}
    • changedOutput schema / properties / items / items / properties / image_items / description
      Previous value: -"图片结构化明细;无图片时为空数组"New value: +"图片列表;无图片时为空数组"
    • removedOutput schema / properties / items / items / properties / image_items / items / properties / live_photo
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "additionalProperties": false,
      -      "properties": {
      -        "duration_ms": {
      -          "anyOf": [
      -            {
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Live 图时长,单位毫秒;没有时长时为 null"
      -        },
      -        "video_url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Live 图视频链接;没有视频链接时为 null"
      -        }
      -      },
      -      "required": [
      -        "video_url",
      -        "duration_ms"
      -      ],
      -      "type": "object"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "Live 图视频摘要;普通图片或没有视频摘要时为 null"
      -}
    • changedOutput schema / properties / items / items / properties / image_items / items / required
      Previous value: -[
      -  "image_url",
      -  "live_photo"
      -]New value: +[
      +  "image_url"
      +]
    • changedOutput schema / properties / items / items / properties / note_id / description
      Previous value: -"note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论、标签页笔记或用户发帖列表返回的完整 note_id;不得截断、缩写、脱敏、补全、格式化、重组,也不得只传前缀。"New value: +"note_id 是小红书笔记 ID。必须原样复制搜索、详情、评论、标签页笔记列表或用户发帖列表返回的完整 note_id;不得截断、缩写、脱敏、补全、格式化、重组,也不得只传前缀。"
    • removedOutput schema / properties / items / items / properties / note_url
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL,包括 xsec_token 等 query 参数;例如最终回答、展示、引用、存储、输出或传递;不得修改、截断、脱敏、规范化、重组,也不得用 note_id 重新拼接链接。无法提供可用链接时为 null;note_url 为 null 时不要用 note_id 合成公开链接。"
      -}
    • changedOutput schema / properties / items / items / properties / video / description
      Previous value: -"视频摘要信息;仅视频笔记返回对象,图文为 null"New value: +"视频摘要信息;视频笔记有可用视频摘要时返回对象,图文或无可用视频摘要时为 null"
    • changedOutput schema / properties / items / items / required
      Previous value: -[
      -  "note_url",
      -  "note_id",
      -  "note_type",
      -  "title",
      -  "cover_image_url",
      -  "image_items",
      -  "video",
      -  "like_count",
      -  "collect_count",
      -  "publish_time",
      -  "author"
      -]New value: +[
      +  "note_id",
      +  "note_type",
      +  "title",
      +  "cover_image_url",
      +  "image_items",
      +  "video",
      +  "like_count",
      +  "publish_time",
      +  "author"
      +]
  9. Changed19 schema fields changed
    • removedInput schema / properties / page
      Removed value: -{
      -  "default": 1,
      -  "description": "页码,从 1 开始",
      -  "type": "integer"
      -}
    • changedInput schema / properties / page_id / description
      Previous value: -"小红书话题/标签页 page_id。"New value: +"小红书标签页 page_id。"
    • removedInput schema / properties / page_size
      Removed value: -{
      -  "default": 20,
      -  "description": "每页笔记数量",
      -  "type": "integer"
      -}
    • addedInput schema / properties / page_token
      Added value: +{
      +  "default": "",
      +  "description": "分页令牌。首次请求留空;继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回。page_token 是不透明分页令牌,只绑定当前标签页和排序链路,不能跨 page_id 或排序复用;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。",
      +  "type": "string"
      +}
    • removedInput schema / properties / sort
      Removed value: -{
      -  "default": "hot",
      -  "description": "话题/标签页笔记排序方式,可选:hot(最热,默认)、time(最新)",
      -  "enum": [
      -    "hot",
      -    "time"
      -  ],
      -  "type": "string"
      -}
    • addedInput schema / properties / sort_type
      Added value: +{
      +  "default": "hot",
      +  "description": "标签页笔记排序方式,可选:hot(最热,默认)、time_descending(最新)",
      +  "enum": [
      +    "hot",
      +    "time_descending"
      +  ],
      +  "type": "string"
      +}
    • removedOutput schema / properties / has_more
      Removed value: -{
      -  "description": "是否还有下一页",
      -  "type": "boolean"
      -}
    • changedOutput schema / properties / items / description
      Previous value: -"话题页笔记列表"New value: +"标签页笔记列表"
    • addedOutput schema / properties / items / items / additionalProperties
      Added value: +false
    • addedOutput schema / properties / items / items / properties / image_items
      Added value: +{
      +  "description": "图片结构化明细;无图片时为空数组",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "image_url": {
      +        "description": "图片链接",
      +        "type": "string"
      +      },
      +      "live_photo": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "duration_ms": {
      +                "anyOf": [
      +                  {
      +                    "type": "integer"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "Live 图时长,单位毫秒;没有时长时为 null"
      +              },
      +              "video_url": {
      +                "anyOf": [
      +                  {
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ],
      +                "description": "Live 图视频链接;没有视频链接时为 null"
      +              }
      +            },
      +            "required": [
      +              "video_url",
      +              "duration_ms"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Live 图视频摘要;普通图片或没有视频摘要时为 null"
      +      }
      +    },
      +    "required": [
      +      "image_url",
      +      "live_photo"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / items / items / properties / note_id / description
      Previous value: -"note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id;不得截断、缩写、脱敏、补全、格式化、重组,也不得只传前缀。"New value: +"note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论、标签页笔记或用户发帖列表返回的完整 note_id;不得截断、缩写、脱敏、补全、格式化、重组,也不得只传前缀。"
    • changedOutput schema / properties / items / items / properties / note_url / description
      Previous value: -"可打开笔记内容的完整 URL;没有可用链接时为 null"New value: +"note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL,包括 xsec_token 等 query 参数;例如最终回答、展示、引用、存储、输出或传递;不得修改、截断、脱敏、规范化、重组,也不得用 note_id 重新拼接链接。无法提供可用链接时为 null;note_url 为 null 时不要用 note_id 合成公开链接。"
    • removedOutput schema / properties / items / items / properties / summary
      Removed value: -{
      -  "description": "笔记摘要;不是全文",
      -  "type": "string"
      -}
    • changedOutput schema / properties / items / items / properties / video / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "duration_ms": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频原始时长,单位毫秒;没有时长时为 null"
      -      },
      -      "video_url": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频链接;没有视频链接时为 null"
      -      }
      -    },
      -    "required": [
      -      "video_url",
      -      "duration_ms"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "duration_ms": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频原始时长,单位毫秒;没有时长时为 null"
      +      },
      +      "video_url": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频链接;没有视频链接时为 null"
      +      }
      +    },
      +    "required": [
      +      "video_url",
      +      "duration_ms"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / items / items / required
      Previous value: -[
      -  "note_url",
      -  "note_id",
      -  "note_type",
      -  "title",
      -  "summary",
      -  "cover_image_url",
      -  "like_count",
      -  "collect_count",
      -  "publish_time",
      -  "video",
      -  "author"
      -]New value: +[
      +  "note_url",
      +  "note_id",
      +  "note_type",
      +  "title",
      +  "cover_image_url",
      +  "image_items",
      +  "video",
      +  "like_count",
      +  "collect_count",
      +  "publish_time",
      +  "author"
      +]
    • addedOutput schema / properties / next_page_token
      Added value: +{
      +  "description": "下一页不透明分页令牌;非空表示可尝试请求下一页,为空表示当前没有可继续的下一页令牌。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只绑定当前标签页和排序链路,不能跨 page_id 或排序复用;items 为空时不要单独据此判断结束;不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成,不得用省略号替换中间内容。",
      +  "type": "string"
      +}
    • changedOutput schema / properties / total_note_count / description
      Previous value: -"话题页笔记总数"New value: +"标签页笔记总数"
    • changedOutput schema / properties / total_user_count / description
      Previous value: -"话题页涉及用户总数"New value: +"标签页涉及用户总数"
    • changedOutput schema / required
      Previous value: -[
      -  "items",
      -  "has_more",
      -  "total_note_count",
      -  "total_user_count"
      -]New value: +[
      +  "items",
      +  "next_page_token",
      +  "total_note_count",
      +  "total_user_count"
      +]
  10. Added

TDQS

B3.2/5.0
Behavior3/5

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

The annotations already declare readOnlyHint=true and openWorldHint=true, so the safety profile is covered. The description adds only that sorting and pagination are supported, which the schema states in far more detail, and says nothing about rate limits, result caps, or ordering of the returned list.

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?

A single compact sentence with the core action front-loaded and no wasted wording. It is efficient, though so terse that it forgoes the chance to add routing or behavioral value.

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

Completeness3/5

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

An output schema exists, so return values need no explanation, and the tool is a simple three-parameter read. Still missing is the one thing the agent must decide before calling: when to use page_id versus the topic_url variant, which leaves the definition only minimally complete for sibling selection.

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 the schema already explains page_id, the hot/time_descending enum, and the opaque page_token contract in depth. The description merely name-drops sort_type and page_token without adding meaning beyond the schema, which is the baseline-3 case.

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

Purpose4/5

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

The description gives a specific verb and resource ('获取标签页笔记列表' by page_id), so the agent knows exactly what is returned. It implicitly distinguishes itself from the sibling xhs_get_topic_notes_by_topic_url through the page_id identifier, but never names that alternative explicitly.

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

Usage Guidelines2/5

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

There is no when-to-use guidance, no prerequisite for obtaining a page_id, and no mention of the topic_url sibling as an alternative entry point. The only usable signal is the parameter name itself, which the schema already supplies.

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