Xiaohongshu API MCP Server

by proerror77

Integrations

  • Offers API documentation through Swagger UI, allowing developers to explore and test available endpoints directly from the browser.

  • Provides RESTful API access to Xiaohongshu platform features, including retrieving notes by ID, searching for notes and users, accessing user information, fetching user notes, and obtaining recommended content feeds by category.

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 容器:
cd xhs_mcp_server docker-compose up -d

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

  1. 通过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

使用示例

  1. 创建客户端:
curl -X POST "http://localhost:8000/clients" \ -H "Content-Type: application/json" \ -d '{"cookie": "your_cookie_here"}'
  1. 通过 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"}'

许可证

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

-
security - not tested
F
license - not found
-
quality - not tested

A microservice that wraps Xiaohongshu (Little Red Book) API into a RESTful API server, enabling users to perform various operations on the platform such as retrieving notes, searching users and content, and accessing user information.

  1. 功能特点
    1. API 端点
      1. 项目结构
        1. 快速开始
          1. 前提条件
          2. 安装和运行
          3. API 文档
        2. 使用示例
          1. 许可证

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              A server allowing interaction with Reddit via the public API, enabling browsing frontpage posts, retrieving subreddit details, and reading post comments through a Model Context Protocol.
              Last updated -
              8
              30
              Python
              MIT License
              • Apple
              • Linux
            • -
              security
              A
              license
              -
              quality
              A server that enables interaction with any API that has a Swagger/OpenAPI specification through Model Context Protocol (MCP), automatically generating tools from API endpoints and supporting multiple authentication methods.
              Last updated -
              11
              TypeScript
              Apache 2.0
            • -
              security
              F
              license
              -
              quality
              A microservice control plane server that fetches API information from Feishu OpenAPI and provides it to Windsurf IDE, enabling seamless API integration and management within your development environment.
              Last updated -
              TypeScript
            • -
              security
              -
              license
              -
              quality
              A Cloudflare Worker that provides a RESTful API interface to Zerodha trading functionalities, enabling users to authenticate, access profile information, manage orders, and view holdings and positions.
              Last updated -
              JavaScript

            View all related MCP servers

            ID: tt9q010e3h