Xhs MCP Agent

🚀 小紅書 API 微服務

這是一個將小紅書 API 封裝成 RESTful API 服務器的微服務，支持使用 Docker 進行部署，能讓開發者更便捷地操作小紅書相關功能。

🚀 快速開始

前提條件

• 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

✨ 主要特性

• 🌟 支持多客戶端
• 🌟 提供小紅書操作的 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實現

💻 使用示例

基礎用法

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

📄 許可證

本項目僅用於教育目的。使用風險自負。