Skip to main content
Glama
Sign In

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

by com.52choujiang
OverviewDiscussionsAdmin

xhs_get_share_info

Read-only

根据小红书笔记分享短链接或完整分享文案获取分享人、笔记摘要及作者。

需要笔记完整内容时，使用笔记详情工具；分享信息不包含分享时间。

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": {
      "share_text": "<share_text>"
    },
    "name": "xhs_get_share_info"
  }
}

Input Schema

NameRequiredDescriptionDefault
share_textYes小红书笔记分享短链接，或包含该链接的完整分享文案。

Output Schema

NameRequiredDescriptionDefault
pointsYes本次成功调用的积分消耗与账户积分余额。
note_infoYes该链接的笔记摘要及作者；缺失时为 null
share_user_infoYes该链接的分享人；缺失时为 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. Changed3 schema fields changed
    • changedOutput schema / properties / note_info / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "author": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "avatar_url": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "作者头像链接；没有头像链接时为 null"
-              },
-              "name": {
-                "description": "作者名称",
-                "type": "string"
-              },
-              "profile_url": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "作者主页链接；没有主页链接时为 null"
-              },
-              "user_id": {
-                "description": "作者 user_id",
-                "type": "string"
-              }
-            },
-            "required": [
-              "user_id",
-              "name",
-              "avatar_url",
-              "profile_url"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "笔记作者；缺失时为 null"
-      },
-      "cover_image_url": {
-        "description": "笔记封面链接；缺失时为空字符串",
-        "type": "string"
-      },
-      "note_id": {
-        "description": "笔记 ID",
-        "type": "string"
-      },
-      "note_type": {
-        "anyOf": [
-          {
-            "enum": [
-              "image",
-              "video"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "笔记类型；上游类型未识别时为 null"
-      },
-      "summary": {
-        "description": "分享信息中的笔记摘要；缺失时为空字符串",
-        "type": "string"
-      }
-    },
-    "required": [
-      "note_id",
-      "note_type",
-      "summary",
-      "cover_image_url",
-      "author"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "author": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "avatar_url": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "作者头像链接；没有头像链接时为 null",
+                "title": "Avatar Url"
+              },
+              "name": {
+                "description": "作者名称",
+                "title": "Name",
+                "type": "string"
+              },
+              "profile_url": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "作者主页链接；没有主页链接时为 null",
+                "title": "Profile Url"
+              },
+              "user_id": {
+                "description": "作者 user_id",
+                "title": "User Id",
+                "type": "string"
+              }
+            },
+            "required": [
+              "user_id",
+              "name",
+              "avatar_url",
+              "profile_url"
+            ],
+            "title": "BaseAuthorSummary",
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "笔记作者；缺失时为 null"
+      },
+      "cover_image_url": {
+        "description": "笔记封面链接；缺失时为空字符串",
+        "title": "Cover Image Url",
+        "type": "string"
+      },
+      "note_id": {
+        "description": "笔记 ID",
+        "title": "Note Id",
+        "type": "string"
+      },
+      "note_type": {
+        "anyOf": [
+          {
+            "enum": [
+              "image",
+              "video"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "笔记类型；上游类型未识别时为 null",
+        "title": "Note Type"
+      },
+      "summary": {
+        "description": "分享信息中的笔记摘要；缺失时为空字符串",
+        "title": "Summary",
+        "type": "string"
+      }
+    },
+    "required": [
+      "note_id",
+      "note_type",
+      "summary",
+      "cover_image_url",
+      "author"
+    ],
+    "title": "ShareNoteInfo",
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedOutput schema / properties / share_user_info / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avatar_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "分享人头像链接；缺失时为 null"
-      },
-      "name": {
-        "description": "分享人名称",
-        "type": "string"
-      },
-      "profile_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "分享人主页链接；缺失时为 null"
-      },
-      "user_id": {
-        "description": "分享人 user_id",
-        "type": "string"
-      }
-    },
-    "required": [
-      "user_id",
-      "name",
-      "avatar_url",
-      "profile_url"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avatar_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "分享人头像链接；缺失时为 null",
+        "title": "Avatar Url"
+      },
+      "name": {
+        "description": "分享人名称",
+        "title": "Name",
+        "type": "string"
+      },
+      "profile_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "分享人主页链接；缺失时为 null",
+        "title": "Profile Url"
+      },
+      "user_id": {
+        "description": "分享人 user_id",
+        "title": "User Id",
+        "type": "string"
+      }
+    },
+    "required": [
+      "user_id",
+      "name",
+      "avatar_url",
+      "profile_url"
+    ],
+    "title": "ShareUserInfo",
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • addedOutput schema / title
      Added value: +"ShareInfoData"
  4. Added

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint and openWorldHint, so the safety profile is covered. The description adds real value beyond them by disclosing exactly which entities are returned (sharer, summary, author) and, importantly, which field is absent (share time) and that full content is out of scope. It does not mention failure behavior for malformed or non-share text, which is the remaining gap.

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

Conciseness5/5

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

Two short sentences, each doing distinct work: the first defines the operation and its outputs, the second routes to the alternative and flags the missing field. No filler or repetition of the schema.

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

Completeness4/5

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

With an output schema present and a fully documented single parameter, the description covers what an agent needs: input form, returned entities, and the scope boundary. Minor incompleteness remains around error handling for inputs that contain no valid share link.

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

Parameters3/5

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

The single parameter has 100% schema description coverage, so the schema already explains that it accepts a short link or the full share text containing it. The description restates the same meaning with no added syntax, format examples, or length constraints. Baseline 3 applies.

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?

States a specific verb and resource: extract sharer, note summary and author from a Xiaohongshu share short link or full share text. It also distinguishes itself from the note-detail family by naming that alternative, though it does not say which of the several note-detail siblings (by id vs by url, or the pgy variants) to pick.

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

Usage Guidelines4/5

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

Gives an explicit routing rule: when full note content is needed, use the note detail tool instead. It also sets a negative boundary by noting share info does not include share time, which prevents a wrong-expectation call. It stops short of stating prerequisites or what to do if the text contains no valid link.

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