Xhs Mcp Agent
What is Xhs Mcp Agent
xhs_mcp_agent is a microservice that encapsulates the Xiaohongshu API into a RESTful API server, allowing for easy interaction with Xiaohongshu operations.
Use cases
Use cases include creating and managing Xiaohongshu client instances, retrieving notes by ID, searching for notes and users by keywords, and accessing user information and feeds.
How to use
To use xhs_mcp_agent, you can deploy it using Docker or run it directly with Python. For Docker, build and start the container with ‘docker-compose up -d’. For direct execution, install the required Python packages and run ‘python xhs_api.py’.
Key features
Key features include a RESTful API for Xiaohongshu operations, support for multiple clients, Docker containerization for easy deployment, and scalability.
Where to use
xhs_mcp_agent can be used in applications that require integration with Xiaohongshu, such as social media analytics, content management systems, or any service that interacts with Xiaohongshu data.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Xhs Mcp Agent
xhs_mcp_agent is a microservice that encapsulates the Xiaohongshu API into a RESTful API server, allowing for easy interaction with Xiaohongshu operations.
Use cases
Use cases include creating and managing Xiaohongshu client instances, retrieving notes by ID, searching for notes and users by keywords, and accessing user information and feeds.
How to use
To use xhs_mcp_agent, you can deploy it using Docker or run it directly with Python. For Docker, build and start the container with ‘docker-compose up -d’. For direct execution, install the required Python packages and run ‘python xhs_api.py’.
Key features
Key features include a RESTful API for Xiaohongshu operations, support for multiple clients, Docker containerization for easy deployment, and scalability.
Where to use
xhs_mcp_agent can be used in applications that require integration with Xiaohongshu, such as social media analytics, content management systems, or any service that interacts with Xiaohongshu data.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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
安装和运行
- 构建并启动 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"}'
许可证
本项目仅用于教育目的。使用风险自负。
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
