Skip to main content
Glama
Sign In

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

by com.52choujiang
OverviewDiscussionsAdmin

xhs_pgy_get_creator_metrics_trend

Read-only

根据完整 user_id 获取小红书蒲公英创作者曝光、阅读、互动中位数及预估成本的日期趋势和概览。 观察指标随时间变化时使用；中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，不支持自选日期。合作口径包含进店指标，日常口径的进店字段为 null；输出回显口径，不能混用。 返回指标不是每日新增量或累计总量，不可跨日期求和；可能缺少日期，不补零。 成本估算口径见字段说明，不代表实际成交成本；按图文/视频拆分的成本及商业汇总使用商业概览工具，逐篇表现使用笔记表现工具。 成功直接返回业务字段和 points；成功调用扣减 20 积分，失败不扣费。

Input Schema

NameRequiredDescriptionDefault
user_idYes小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
note_scopeNo笔记统计口径：日常笔记趋势选 daily（默认，不是按天汇总）；合作笔记或进店趋势选 cooperation。输出回显口径，不可混用；成本估算依据见各字段说明daily

Output Schema

NameRequiredDescriptionDefault
itemsYes平台返回的日期序列；中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，成本口径见各字段说明；可能缺少日期，不补零、不插值；未知时为 null，明确为空时为 []
pointsYes本次成功调用的积分消耗与账户积分余额。
summaryYes平台提供的概览指标及其日期，不是趋势各点之和；缺失时为 null
user_idYes小红书用户 ID。已有完整 user_id 时原样使用，否则从用户搜索、用户信息或笔记作者信息获取；不要传昵称、小红书号、主页链接或笔记 ID。
note_scopeYes笔记统计口径：日常笔记趋势选 daily（默认，不是按天汇总）；合作笔记或进店趋势选 cooperation。输出回显口径，不可混用；成本估算依据见各字段说明

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. Changed6 schema fields changed
    • changedOutput schema / properties / items / anyOf
      Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "date": {
-          "description": "平台指标日期（YYYY-MM-DD），不是查询日期；历史点的具体滚动窗口未明确",
-          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-          "type": "string"
-        },
-        "estimated_cpm": {
-          "anyOf": [
-            {
-              "exclusiveMinimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "该日期对应的预估千次曝光成本，单位元/千次曝光；daily 结合报价及近30日日常和合作笔记的自然流量曝光中位数估算，cooperation 结合近30日合作笔记价格和曝光量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
-        },
-        "estimated_interaction_cost": {
-          "anyOf": [
-            {
-              "exclusiveMinimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "该日期对应的预估单次互动成本，单位元/互动；daily 结合报价及近30日日常和合作笔记的互动中位数估算，cooperation 结合近30日合作笔记价格和互动量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
-        },
-        "estimated_read_cost": {
-          "anyOf": [
-            {
-              "exclusiveMinimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "该日期对应的预估单次阅读成本，单位元/阅读；daily 结合报价及近30日日常和合作笔记的自然流量阅读中位数估算，cooperation 结合近30日合作笔记价格和阅读量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
-        },
-        "estimated_store_visit_cost": {
-          "anyOf": [
-            {
-              "exclusiveMinimum": 0,
-              "type": "number"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "该日期对应的预估进店成本，单位元/进店；结合近30日跨域（小红星/小红盟等）合作笔记价格与跨域进店UV计算，仅供参考，不是实际成交成本或ROI；仅 cooperation 返回，daily、零值或缺失时为 null；进店中位数为0时仍可能有有效成本"
-        },
-        "impression_median": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "该日期对应的笔记曝光量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
-        },
-        "interaction_median": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "该日期对应的笔记互动量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
-        },
-        "outbound_store_visit_median": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "该日期对应的合作笔记外溢进店量中位数，不是进店总人数、订单或成交量；仅 cooperation 返回，真实0保留，daily 或未知时为 null；不能与进店成本反算价格或人数"
-        },
-        "read_median": {
-          "anyOf": [
-            {
-              "minimum": 0,
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "该日期对应的笔记阅读量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
-        }
-      },
-      "required": [
-        "date",
-        "impression_median",
-        "read_median",
-        "interaction_median",
-        "estimated_cpm",
-        "estimated_interaction_cost",
-        "estimated_read_cost",
-        "outbound_store_visit_median",
-        "estimated_store_visit_cost"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "date": {
+          "description": "平台指标日期（YYYY-MM-DD），不是查询日期；历史点的具体滚动窗口未明确",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+          "title": "Date",
+          "type": "string"
+        },
+        "estimated_cpm": {
+          "anyOf": [
+            {
+              "exclusiveMinimum": 0,
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "该日期对应的预估千次曝光成本，单位元/千次曝光；daily 结合报价及近30日日常和合作笔记的自然流量曝光中位数估算，cooperation 结合近30日合作笔记价格和曝光量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费",
+          "title": "Estimated Cpm"
+        },
+        "estimated_interaction_cost": {
+          "anyOf": [
+            {
+              "exclusiveMinimum": 0,
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "该日期对应的预估单次互动成本，单位元/互动；daily 结合报价及近30日日常和合作笔记的互动中位数估算，cooperation 结合近30日合作笔记价格和互动量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费",
+          "title": "Estimated Interaction Cost"
+        },
+        "estimated_read_cost": {
+          "anyOf": [
+            {
+              "exclusiveMinimum": 0,
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "该日期对应的预估单次阅读成本，单位元/阅读；daily 结合报价及近30日日常和合作笔记的自然流量阅读中位数估算，cooperation 结合近30日合作笔记价格和阅读量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费",
+          "title": "Estimated Read Cost"
+        },
+        "estimated_store_visit_cost": {
+          "anyOf": [
+            {
+              "exclusiveMinimum": 0,
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "该日期对应的预估进店成本，单位元/进店；结合近30日跨域（小红星/小红盟等）合作笔记价格与跨域进店UV计算，仅供参考，不是实际成交成本或ROI；仅 cooperation 返回，daily、零值或缺失时为 null；进店中位数为0时仍可能有有效成本",
+          "title": "Estimated Store Visit Cost"
+        },
+        "impression_median": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "该日期对应的笔记曝光量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null",
+          "title": "Impression Median"
+        },
+        "interaction_median": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "该日期对应的笔记互动量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null",
+          "title": "Interaction Median"
+        },
+        "outbound_store_visit_median": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "该日期对应的合作笔记外溢进店量中位数，不是进店总人数、订单或成交量；仅 cooperation 返回，真实0保留，daily 或未知时为 null；不能与进店成本反算价格或人数",
+          "title": "Outbound Store Visit Median"
+        },
+        "read_median": {
+          "anyOf": [
+            {
+              "minimum": 0,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "该日期对应的笔记阅读量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null",
+          "title": "Read Median"
+        }
+      },
+      "required": [
+        "date",
+        "impression_median",
+        "read_median",
+        "interaction_median",
+        "estimated_cpm",
+        "estimated_interaction_cost",
+        "estimated_read_cost",
+        "outbound_store_visit_median",
+        "estimated_store_visit_cost"
+      ],
+      "title": "PgyCreatorMetricsTrendItem",
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]
    • addedOutput schema / properties / items / title
      Added value: +"Items"
    • addedOutput schema / properties / note_scope / title
      Added value: +"Note Scope"
    • changedOutput schema / properties / summary / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "date": {
-        "description": "平台指标日期（YYYY-MM-DD），不是查询日期；历史点的具体滚动窗口未明确",
-        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-        "type": "string"
-      },
-      "estimated_cpm": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "该日期对应的预估千次曝光成本，单位元/千次曝光；daily 结合报价及近30日日常和合作笔记的自然流量曝光中位数估算，cooperation 结合近30日合作笔记价格和曝光量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
-      },
-      "estimated_interaction_cost": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "该日期对应的预估单次互动成本，单位元/互动；daily 结合报价及近30日日常和合作笔记的互动中位数估算，cooperation 结合近30日合作笔记价格和互动量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
-      },
-      "estimated_read_cost": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "该日期对应的预估单次阅读成本，单位元/阅读；daily 结合报价及近30日日常和合作笔记的自然流量阅读中位数估算，cooperation 结合近30日合作笔记价格和阅读量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费"
-      },
-      "estimated_store_visit_cost": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "该日期对应的预估进店成本，单位元/进店；结合近30日跨域（小红星/小红盟等）合作笔记价格与跨域进店UV计算，仅供参考，不是实际成交成本或ROI；仅 cooperation 返回，daily、零值或缺失时为 null；进店中位数为0时仍可能有有效成本"
-      },
-      "impression_median": {
-        "anyOf": [
-          {
-            "minimum": 0,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "该日期对应的笔记曝光量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
-      },
-      "interaction_median": {
-        "anyOf": [
-          {
-            "minimum": 0,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "该日期对应的笔记互动量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
-      },
-      "outbound_store_visit_median": {
-        "anyOf": [
-          {
-            "minimum": 0,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "该日期对应的合作笔记外溢进店量中位数，不是进店总人数、订单或成交量；仅 cooperation 返回，真实0保留，daily 或未知时为 null；不能与进店成本反算价格或人数"
-      },
-      "read_median": {
-        "anyOf": [
-          {
-            "minimum": 0,
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "该日期对应的笔记阅读量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null"
-      }
-    },
-    "required": [
-      "date",
-      "impression_median",
-      "read_median",
-      "interaction_median",
-      "estimated_cpm",
-      "estimated_interaction_cost",
-      "estimated_read_cost",
-      "outbound_store_visit_median",
-      "estimated_store_visit_cost"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "date": {
+        "description": "平台指标日期（YYYY-MM-DD），不是查询日期；历史点的具体滚动窗口未明确",
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+        "title": "Date",
+        "type": "string"
+      },
+      "estimated_cpm": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "该日期对应的预估千次曝光成本，单位元/千次曝光；daily 结合报价及近30日日常和合作笔记的自然流量曝光中位数估算，cooperation 结合近30日合作笔记价格和曝光量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费",
+        "title": "Estimated Cpm"
+      },
+      "estimated_interaction_cost": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "该日期对应的预估单次互动成本，单位元/互动；daily 结合报价及近30日日常和合作笔记的互动中位数估算，cooperation 结合近30日合作笔记价格和互动量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费",
+        "title": "Estimated Interaction Cost"
+      },
+      "estimated_read_cost": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "该日期对应的预估单次阅读成本，单位元/阅读；daily 结合报价及近30日日常和合作笔记的自然流量阅读中位数估算，cooperation 结合近30日合作笔记价格和阅读量估算；不按本响应中位数反算报价，仅供参考，不是实际成交成本；零值或缺失时为 null，不表示免费",
+        "title": "Estimated Read Cost"
+      },
+      "estimated_store_visit_cost": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "该日期对应的预估进店成本，单位元/进店；结合近30日跨域（小红星/小红盟等）合作笔记价格与跨域进店UV计算，仅供参考，不是实际成交成本或ROI；仅 cooperation 返回，daily、零值或缺失时为 null；进店中位数为0时仍可能有有效成本",
+        "title": "Estimated Store Visit Cost"
+      },
+      "impression_median": {
+        "anyOf": [
+          {
+            "minimum": 0,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "该日期对应的笔记曝光量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null",
+        "title": "Impression Median"
+      },
+      "interaction_median": {
+        "anyOf": [
+          {
+            "minimum": 0,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "该日期对应的笔记互动量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null",
+        "title": "Interaction Median"
+      },
+      "outbound_store_visit_median": {
+        "anyOf": [
+          {
+            "minimum": 0,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "该日期对应的合作笔记外溢进店量中位数，不是进店总人数、订单或成交量；仅 cooperation 返回，真实0保留，daily 或未知时为 null；不能与进店成本反算价格或人数",
+        "title": "Outbound Store Visit Median"
+      },
+      "read_median": {
+        "anyOf": [
+          {
+            "minimum": 0,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "该日期对应的笔记阅读量中位数；不是当日新增或累计总量，不可跨日期求和；未知时为 null",
+        "title": "Read Median"
+      }
+    },
+    "required": [
+      "date",
+      "impression_median",
+      "read_median",
+      "interaction_median",
+      "estimated_cpm",
+      "estimated_interaction_cost",
+      "estimated_read_cost",
+      "outbound_store_visit_median",
+      "estimated_store_visit_cost"
+    ],
+    "title": "PgyCreatorMetricsTrendItem",
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • addedOutput schema / properties / user_id / title
      Added value: +"User Id"
    • addedOutput schema / title
      Added value: +"PgyCreatorMetricsTrend"
  4. Added

TDQS

A4.6/5.0
Behavior4/5

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

The annotations only declare readOnlyHint and openWorldHint, so most of the behavioral burden falls on the description, and the description carries it well: 20 credits are deducted on success and nothing on failure, the date window is fixed to the last 30 days, the traffic scope is fixed, output echoes the note_scope and the two scopes must not be mixed, and success returns business fields plus points. It also warns that the values are neither daily increments nor cumulative totals and must not be summed across dates, that missing dates are not zero-filled, and that cost is an estimate rather than the actual settled cost. The one gap is pagination or response shape, though an explicit statement that the tool cannot page would make the picture complete.

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?

The description leads with the core purpose and then layers caveats in a logical order: scope, metric semantics, cost disclaimer, alternatives, cost/pricing. It is dense but nearly every sentence carries non-obvious constraints, though '输出回显口径，不能混用' largely repeats what the schema already says about note_scope.

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?

For a two-parameter analytical tool, this is complete: pricing behavior, fixed window, scope semantics, sum-avoidance and missing-date warnings, cost caveats, sibling routing, and a note that success returns business fields plus points, with an output schema covering return structure. An agent could call this correctly and interpret the results without further questions.

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?

Schema coverage is 100%, so the baseline is 3, and the description adds real meaning on top: note_scope selects daily versus cooperation notes, the daily scope is not a per-day aggregation, the cooperation scope includes in-store metrics while the daily scope returns null for those fields, and the cost estimate basis is documented per field. The only shortfall is that user_id itself is left entirely to the schema.

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

Purpose5/5

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

The description names a specific verb and resource: fetch Xiaohongshu Pugongying creator exposure, read, engagement median values and estimated cost as a date trend plus overview, keyed on a full user_id. It explicitly separates itself from the commercial overview tool (cost broken out by image-note/video-note plus commercial summary) and the note performance tool (per-note performance).

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?

It states when to use the tool (when observing how metrics change over time) and when not to (no custom date selection). It names the alternative tools and the conditions that select them: qualified-commercial totals go to the commercial overview tool, and per-note detail goes to the note performance tool.

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