# 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"}'
```

## 许可证

本项目仅用于教育目的。使用风险自负。