XHS MCP Server

小红书数据分析平台 MCP 工具，为 LLM 提供 5 个数据查询能力。

安装

npx xhs-mcp-server

或本地开发：

npm install
npm run build

MCP 客户端配置

Claude Desktop / Cursor

{
  "mcpServers": {
    "xhs": {
      "command": "npx",
      "args": ["-y", "xhs-mcp-server"],
      "env": {
        "XHS_API_URL": "https://your-backend.example.com",
        "XHS_API_KEY": "your-api-key"
      }
    }
  }
}

环境变量

| 变量 | 必填 | 默认值 | 说明 | |------|------|--------|------| | XHS_API_URL | 是 | http://localhost:8181 | 后端服务地址 | | XHS_API_KEY | 是 | - | API 鉴权密钥 |

5 个工具

| 工具 | 用途 | |------|------| | xhs_search | 全局搜索话题/笔记/博主/品牌/SPU | | xhs_rank | 排行榜（笔记/博主/话题/关键词） | | xhs_entity | 精确查询实体详情 | | xhs_related | 下钻查询子资源 | | xhs_drill | 横向对比/追踪/粉丝画像 |