Skip to main content
Glama

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

xhs_pgy_get_creator_commercial_overview

Read-only

根据完整 user_id 获取小红书蒲公英创作者商业概览:笔记规模和中位数、服务表现、平台标签、增长、预估成本及对比值。 查询指定日常/合作口径的商业汇总与成本参考时使用,不返回逐篇明细。逐篇表现使用创作者笔记表现工具,也可选择日常或合作口径。资料与报价使用创作者档案工具,粉丝构成使用粉丝画像工具。 查看日常内容表现选 daily(默认,不是按天汇总);查看商单、品牌合作笔记或外溢进店的汇总表现选 cooperation。输出回显口径,不能混用;不是对全部字段统一筛选,note_count 不能解释为所选口径的笔记数。两种口径的成本估计依据不同,均不代表实际成交成本或ROI。 不支持指定日期,统计截止日期未提供;进店不等于订单或成交,不据此推断调用方自己的投放成绩。 成功直接返回业务字段和 points;成功调用扣减 20 积分,失败不扣费。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
user_idYes小红书用户 ID。已有完整 user_id 时原样使用,否则从用户搜索、用户信息或笔记作者信息获取;不要传昵称、小红书号、主页链接或笔记 ID。
note_scopeNo笔记统计口径:查看日常内容表现选 daily(默认),不是按天汇总;查看商单、品牌合作笔记或外溢进店表现选 cooperation;输出回显实际口径,不能混用;不表示所有字段均按此口径拆分,note_count 等字段按各自说明解读daily

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
pointsYes本次成功调用的积分消耗与调用完成时的账户积分余额。
user_idYes小红书用户 ID。已有完整 user_id 时原样使用,否则从用户搜索、用户信息或笔记作者信息获取;不要传昵称、小红书号、主页链接或笔记 ID。
data_dateYes平台标注的数据日期(YYYY-MM-DD);不代表查询时间或各指标统计截止日期;未知时为 null
note_countYes平台 30 天窗口内发布笔记数;不能因 note_scope=daily/cooperation 就解释为日常/合作笔记数量,不作为所选口径中位数的样本数量;不代表全部历史,截止日期未提供;未知时为 null
note_scopeYes笔记统计口径:查看日常内容表现选 daily(默认),不是按天汇总;查看商单、品牌合作笔记或外溢进店表现选 cooperation;输出回显实际口径,不能混用;不表示所有字段均按此口径拆分,note_count 等字段按各自说明解读
read_medianYes平台 30 天窗口内所选口径笔记的阅读量中位数,不是累计阅读量;截止日期未提供,不用其他接口明细复算;未知时为 null
content_tagsYes平台 30 天窗口发布笔记的 TOP2 内容类目及笔记数量占比;不代表完整分布,不归一化或补其他,不保证与笔记表现接口同口径;未知时为 null,明确为空时为 []
response_rateYes历史邀约合作消息在 48 小时内回复的比例,0.852 表示 85.2%;48 小时是回复时限,不是统计周期;累计周期和完整分母未提供,不用邀约数推算回复次数;邀约数不足 3 时不用于评价回复表现,不视为合作接受率;未知时为 null
active_days_7dYes平台 7 天统计窗口内登录小红书 App 的天数;截止日期未提供,不按查询日期或 data_date 推算起止日期,不等同发布笔记天数;未知时为 null
industry_labelsYes平台 30 天窗口内 TOP2 合作品牌行业;原样保留,不代表全部行业或具体品牌合作清单,不保证与创作者档案同口径;未知时为 null,明确为空时为 []
commercial_labelYes平台给出的商业标签原文,仅作平台评价展示,不作为独立评价结论;未知时为 null
invitation_countYes平台返回的邀约数量;统计周期、邀约方向及状态范围未明确,不等于成交或成功合作数量;未知时为 null
impression_medianYes平台 30 天窗口内所选口径笔记的曝光量中位数,不是累计曝光量;截止日期未提供,不用其他接口明细复算;未知时为 null
interaction_medianYes平台 30 天窗口内所选口径笔记的互动量中位数,不是累计互动量;截止日期未提供,互动构成按平台口径,不用其他接口明细复算;未知时为 null
estimated_video_cpmYes平台预估视频 CPM,单位人民币元/千次曝光;daily 根据报价与相关笔记中位数预估,cooperation 根据近30天合作笔记价格和表现估计;不按本响应的中位数自行复算,不是实际成交成本或效果承诺;无法预估、未知或零值时为 null
read_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应平台 30 天窗口的所选口径笔记中位数,不保证与笔记表现接口同口径
estimated_picture_cpmYes平台预估图文 CPM,单位人民币元/千次曝光;daily 根据报价与相关笔记中位数预估,cooperation 根据近30天合作笔记价格和表现估计;不按本响应的中位数自行复算,不是实际成交成本或效果承诺;无法预估、未知或零值时为 null
follower_growth_rate_30dYes平台 30 天统计窗口的粉丝增长率,0.1 表示 10%;不是构成占比,不限于 0–1。截止日期和计算基数未提供,不按查询日期或 data_date 推算窗口,不与其他周期增长率混用;未知时为 null
estimated_video_read_costYes平台预估视频阅读单价,单位人民币元/次阅读;daily 根据报价与相关笔记中位数预估,cooperation 根据近30天合作笔记价格和表现估计;不按本响应的中位数自行复算,不是实际成交成本或效果承诺;无法预估、未知或零值时为 null
impression_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应平台 30 天窗口的所选口径笔记曝光中位数,不保证与笔记表现接口同口径
interaction_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应平台 30 天窗口的所选口径笔记中位数,不保证与笔记表现接口同口径
estimated_picture_read_costYes平台预估图文阅读单价,单位人民币元/次阅读;daily 根据报价与相关笔记中位数预估,cooperation 根据近30天合作笔记价格和表现估计;不按本响应的中位数自行复算,不是实际成交成本或效果承诺;无法预估、未知或零值时为 null
outbound_store_visit_medianYes平台30天合作笔记范围内的外溢进店量中位数;不是累计人数、订单数或成交额,窗口截止日未明确;daily 或未知时为 null
commercial_label_descriptionYes平台商业标签说明原文;涉及排名或比较的文字仅代表平台说法,不提取为独立排名或百分位数值;未知时为 null
estimated_video_interaction_costYes平台预估视频互动单价,单位人民币元/次互动;daily 根据报价与相关笔记中位数预估,cooperation 根据近30天合作笔记价格和表现估计;不按本响应的中位数自行复算,不是实际成交成本或效果承诺;无法预估、未知或零值时为 null
estimated_video_store_visit_costYes平台预估视频外溢进店单价,人民币元/进店;依据近30天跨域合作笔记价格及进店UV估计,不是成交成本或ROI;daily、不可预估、零值或未知时为 null
estimated_picture_interaction_costYes平台预估图文互动单价,单位人民币元/次互动;daily 根据报价与相关笔记中位数预估,cooperation 根据近30天合作笔记价格和表现估计;不按本响应的中位数自行复算,不是实际成交成本或效果承诺;无法预估、未知或零值时为 null
estimated_picture_store_visit_costYes平台预估图文外溢进店单价,人民币元/进店;依据近30天跨域合作笔记价格及进店UV估计,不是成交成本或ROI;daily、不可预估、零值或未知时为 null
estimated_video_cpm_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应预估视频 CPM,不是实际成本或 ROI;相应预估成本不可用时为 null
follower_growth_benchmark_rate_30dYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应平台 30 天粉丝增长指标,窗口截止日期未提供;不是实际粉丝增长率
outbound_store_visit_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应合作笔记外溢进店中位数;daily 时为 null
estimated_picture_cpm_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应预估图文 CPM,不是实际成本或 ROI;相应预估成本不可用时为 null
estimated_video_read_cost_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应预估视频阅读单价,不是实际成本或 ROI;相应预估成本不可用时为 null
estimated_picture_read_cost_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应预估图文阅读单价,不是实际成本或 ROI;相应预估成本不可用时为 null
estimated_video_interaction_cost_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应预估视频互动单价,不是实际成本或 ROI;相应预估成本不可用时为 null
estimated_video_store_visit_cost_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应预估视频进店单价,不是实际成本或ROI;daily 或对应成本不可用时为 null
estimated_picture_interaction_cost_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应预估图文互动单价,不是实际成本或 ROI;相应预估成本不可用时为 null
estimated_picture_store_visit_cost_benchmark_rateYes平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null;对应预估图文进店单价,不是实际成本或ROI;daily 或对应成本不可用时为 null

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.4/5.0
Behavior5/5

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

Annotations only declare readOnlyHint and openWorldHint; the description adds substantial context beyond them: success deducts 20 points, failure is free, results are returned directly with business fields and points, no date filter is supported and the cutoff date is not provided, store visits do not equal orders/deals, and cost estimates do not represent actual transaction cost or ROI. These are exactly the cautions an agent needs before invoking.

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

Conciseness3/5

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

Purpose is appropriately front-loaded, but the definition is long and the daily/cooperation explanations, caveats and cost notes repeat material already present in the schema parameter descriptions. Several sentences could be trimmed without losing routing information, so it is functional rather than tight.

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?

An output schema exists, so return values need no explanation, and the description still adds the point-cost model and the key semantic caveats. Combined with full schema coverage and clear sibling routing, an agent has what it needs; only the redundancy noted above keeps it from being exhaustive.

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 baseline is 3. The description reinforces the scope semantics (daily is not per-day aggregation; outputs echo the actual scope; note_count cannot be read as the selected scope's note count) but this text largely duplicates the note_scope schema description verbatim, so it adds little the schema does not already carry.

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

Purpose5/5

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

States a specific verb (获取) and resource (蒲公英创作者商业概览) and enumerates exactly what the overview contains: note scale and median, service performance, platform tags, growth, estimated cost and comparison values. It also explicitly names the sibling tools it is not (逐篇表现/创作者笔记表现工具, 资料与报价/创作者档案工具, 粉丝构成/粉丝画像工具), so an agent can route without opening any schema.

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

Usage Guidelines5/5

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

Gives explicit when-to-use (查询指定日常/合作口径的商业汇总与成本参考), explicit when-not (不返回逐篇明细, 不支持指定日期), and names the alternative tools for each excluded need. The daily vs cooperation selection rule is stated as a decision: daily for everyday content performance, cooperation for brand/商单/sponsored notes or store-overflow summaries.

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