Xhs MCP Agent

🚀 Xiaohongshu API MCP Server

This is a microservice that encapsulates the Xiaohongshu API into a RESTful API server. It can be deployed using Docker.

✨ Features

• Multi-client support
• RESTful API for Xiaohongshu operations
• Docker containerization
• Easy to deploy and scale

📚 Documentation

API Endpoints

The server provides the following endpoints:

• /clients - Create and manage Xiaohongshu client instances
• /clients/{client_id}/note - Get a note by ID
• /clients/{client_id}/note/html - Get a note from HTML by ID
• /clients/{client_id}/search/notes - Search for notes by keyword
• /clients/{client_id}/search/users - Search for users by keyword
• /clients/{client_id}/user/info - Get user information by ID
• /clients/{client_id}/user/notes - Get user notes
• /clients/{client_id}/feed/categories - Get recommended feed categories
• /clients/{client_id}/feed/{feed_type} - Get recommended feed by type
• /health - Health check endpoint

Project Structure

.
├── xhs_mcp_server/     # Main server directory
│   ├── app/           # Application core
│   ├── xhs/          # Xiaohongshu API module
│   ├── Dockerfile    # Docker build file
│   └── requirements.txt # Python dependencies
└── xhs_api.py        # API implementation

🚀 Quick Start

Prerequisites

• Docker
• Docker Compose

Installation and Running

1. Build and start the Docker container:

cd xhs_mcp_server
docker-compose up -d

The service will run at http://localhost:8000.

2. Run directly via Python:

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

API Documentation

After the server is running, you can access the API documentation at the following locations:

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

💻 Usage Examples

Basic Usage

Create a client:

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

Get a note by 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"}'

📄 License

This project is for educational purposes only. Use at your own risk.