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 文件。