Xiaohongshu API MCP Server | 小红书 API 微服务

这是一个将小红书 API 封装成 RESTful API 服务器的微服务。可以使用 Docker 进行部署。

功能特点

RESTful API for Xiaohongshu operations | 小红书操作的 RESTful API
Multiple client support | 支持多客户端
Docker containerization | Docker 容器化
Easy to deploy and scale | 易于部署和扩展

Related MCP server: Xiaohongshu Search & Comment MCP Server

API 端点

服务器提供以下端点：

/clients - 创建和管理小红书客户端实例
/clients/{client_id}/note - 通过 ID 获取笔记
/clients/{client_id}/note/html - 从 HTML 通过 ID 获取笔记
/clients/{client_id}/search/notes - 通过关键词搜索笔记
/clients/{client_id}/search/users - 通过关键词搜索用户
/clients/{client_id}/user/info - 通过 ID 获取用户信息
/clients/{client_id}/user/notes - 获取用户笔记
/clients/{client_id}/feed/categories - 获取推荐流分类
/clients/{client_id}/feed/{feed_type} - 通过类型获取推荐流
/health - 健康检查端点

项目结构

. ├── xhs_mcp_server/ # 主服务器目录 │ ├── app/ # 应用程序核心 │ ├── xhs/ # 小红书API模块 │ ├── Dockerfile # Docker构建文件 │ └── requirements.txt # Python依赖 └── xhs_api.py # API实现

快速开始

前提条件

Docker
Docker Compose

安装和运行

构建并启动 Docker 容器:

cd xhs_mcp_server docker-compose up -d

服务将在 http://localhost:8000 运行。

通过Python直接运行:

pip install -r xhs_mcp_server/requirements.txt python xhs_api.py

API 文档

服务器运行后，您可以在以下位置访问 API 文档：

Swagger UI: http://localhost:8000/docs
ReDoc: http://localhost:8000/redoc

使用示例

创建客户端:

curl -X POST "http://localhost:8000/clients" \ -H "Content-Type: application/json" \ -d '{"cookie": "your_cookie_here"}'

通过 ID 获取笔记:

curl -X POST "http://localhost:8000/clients/client_1/note" \ -H "Content-Type: application/json" \ -d '{"note_id": "your_note_id", "xsec_token": "your_xsec_token"}'