Xiaohongshu API MCP Server

# 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 | 易于部署和扩展 ## 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 ### 安装和运行 1. 构建并启动 Docker 容器: ```bash cd xhs_mcp_server docker-compose up -d ``` 服务将在 `http://localhost:8000` 运行。 2. 通过Python直接运行: ```bash 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` ## 使用示例 1. 创建客户端: ```bash curl -X POST "http://localhost:8000/clients" \ -H "Content-Type: application/json" \ -d '{"cookie": "your_cookie_here"}' ``` 2. 通过 ID 获取笔记: ```bash 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"}' ``` ## 许可证 本项目仅用于教育目的。使用风险自负。