Xiaohongshu API MCP Server | 小红书 API 微服务

Xiaohongshu API MCP Server | 小红书 API 微服务

これは、小红书 API を RESTful API サーバーとしてラップするマイクロサービスです。Docker を使用してデプロイできます。

機能の特徴

• 小红书の操作用 RESTful API
• 複数のクライアントをサポート
• Docker によるコンテナ化
• 簡単にデプロイおよび拡張できます

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 で実行されます。

2. 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"}'

2. 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"}'

ライセンス

本プロジェクトは教育目的でのみ使用してください。ご自身の責任でご利用ください。