Rednote (Xiaohongshu)

🚀 紅筆記 MCP 服務

紅筆記 MCP 服務為小紅書內容訪問提供支持，藉助該服務可通過關鍵詞搜索筆記，還能使用其提供的 MCP 服務接口，並且能自動保存登錄信息，同時兼容 Playwright 環境。

  

🚀 快速開始

使用前請確保安裝了 Playwright 環境，可通過以下命令進行安裝：

npx playwright install

📦 通過 Smithery 安裝

要自動為 Claude Desktop 安裝 rednote-mcp，請訪問 Smithery 並運行以下命令：

npx -y @smithery/cli install @JonaFly/rednote-mcp --client claude

📦 通過 npm 全局安裝

# 全局安裝
npm install -g rednote-mcp

# 初始化登錄，會自動將 cookie 保存到 ~/.mcp/rednote/cookies.json 文件中
rednote-mcp init

📦 從源碼安裝

# 克隆項目
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp

# 安裝依賴
npm install

# 全局安裝（可選，為了方便命令行調用）
npm install -g .

# 或者直接運行初始化登錄
npm run dev -- init

✨ 主要特性

• 🔍 支持通過關鍵詞搜索筆記。
• 🚪 提供 MCP 服務接口。
• 💾 自動保存 cookie 到指定文件。
• 🛠️ 兼容 Playwright 環境。

💻 使用示例

初始化登錄

安裝完成後，運行以下命令初始化登錄：

rednote-mcp init

這將啟動瀏覽器窗口，指導您完成登錄流程，並自動保存登錄信息到 ~/.mcp/rednote/cookies.json 文件中。

配置 MCP 服務

要配置 MCP 服務，請按照以下步驟操作：

1. 打開終端或命令提示符。
2. 運行以下命令啟動服務：

rednote-mcp serve

📚 詳細文檔

開發指南

環境要求

• Node.js（推薦使用最新穩定版本）
• npm（隨 Node.js 自動安裝）

開發流程

1. 克隆項目倉庫。
2. 安裝依賴：

npm install

3. 運行開發服務器：

npm run dev

注意事項

⚠️ 重要提示

1. 首次使用時必須運行 init 命令完成初始化。
2. 請妥善保管 cookie 文件，避免洩露登錄信息。
3. 確保 Node.js 和 npm 環境已正確安裝。

貢獻指南

1. 叉倉庫。
2. 創建功能分支（例如：git checkout -b feature/AmazingFeature）。
3. 提交更改（如 git commit -m 'Add some AmazingFeature'）。
4. 推送到分支（如 git push origin feature/AmazingFeature）。
5. 提交 Pull Request。

📄 許可證

本項目採用 MIT License，具體內容請參見 LICENSE 文件。