XiaoHongShu 搜索 MCP

当用户希望搜索 XiaoHongShu / RED / RedNote，并通过托管的 whatson.red MCP 端点获取结构化 JSON 结果时，请使用此技能。

前提条件

• 用户需拥有一个 whatson.red 账户，并从 https://www.whatson.red/agents 获取 Agent API 密钥。
• 从环境变量 WHATSON_RED_API_KEY 中读取该 API 密钥。
• 将密钥作为请求头发送：Authorization: Bearer ${WHATSON_RED_API_KEY}。
• MCP 请求采用基于账户的 whatson.red 计费与积分扣减机制。

MCP 端点

请使用可流式传输的 HTTP 端点：

https://www.whatson.red/api/agent/mcp

主工具名称：

search_xiaohongshu_notes

工具参数

• query 字符串，必填：搜索关键词，支持英文、中文或拼音。
• limit 数值，选填：取值范围为 1–100，默认值为 60。当值大于 20 时，将自动获取额外的搜索结果页。
• include_note_details 布尔值，选填：默认为 true。在可用时包含笔记详情数据（note detail payloads）。
• include_blog 布尔值，选填：默认为 false。返回一篇草稿形式的博客/文章载荷（draft blog/article payload），但不会发布该内容。

当用户需要获取多页笔记结果时，建议将 limit 设为 40、60、80 或 100。笔记详情字段仅对实际返回的真实笔记尽力提供，不保证全部覆盖。

预期响应结构

该工具返回结构化内容，包含以下字段：

• query
• translatedQuery
• searchQuery
• notes
• noteDetails
• blog
• blogError
• usage

usage 字段包含本次请求所扣除的积分数量、账户剩余积分，以及该请求是否已通过幂等性（idempotency）机制完成计费。

REST 替代方案

对于非 MCP 调用方，whatson.red 同样提供如下 REST 接口：

POST https://www.whatson.red/api/agent/search

REST 接口支持 API 密钥计费及免账户的 x402 支付方式。x402 仅适用于 REST 接口，不可用于 MCP；MCP 不支持 x402。通过 x402 发起的 REST 搜索，每次原始搜索（raw search）在支持的 USDC 网络上费用为 $0.05 USDC；且 x402 不支持 includeBlog=true 参数。

安全须知

• 请勿向用户索要 Browserless、代理、Cookie 或部署相关密钥；本技能仅调用托管的 whatson.red MCP 端点。
• 请勿尝试通过本技能直接爬取 XiaoHongShu 网站内容。
• 当 include_blog 为 true 时，不得发布任何内容；返回的 blog 载荷仅为草稿，不具备发布效力。