Xhs MCP Agent

🚀 小红书 API マイクロサービス | Xiaohongshu API MCP Server

このマイクロサービスは、小红书 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

💻 使用例

基本的な使用法

クライアントの作成

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

📄 ライセンス

このプロジェクトは教育目的のみで使用されます。自己責任で使用してください。