# n8n-nodes-rednotes

n8n的自定义节点包，提供小红书平台集成功能，支持内容搜索、用户信息获取、登录管理和笔记交互等操作。

## 功能特性

### 🔍 内容搜索
- 根据关键词搜索小红书笔记
- 支持结果数量限制
- 获取笔记详情信息

### 👤 用户管理
- 获取用户信息
- 获取用户笔记列表
- 用户数据统计

### 🔐 登录管理
- 获取登录二维码
- 检查登录状态
- 手机号验证码登录
- 自动获取和保持登录会话

### 📝 笔记交互
- 点赞/取消点赞笔记
- 收藏/取消收藏笔记
- 发表评论
- 下载笔记图片

## 安装

### 通过n8n界面安装

1. 在n8n中，导航到 **Settings > Community Nodes**
2. 点击 **Install**
3. 输入包名：`n8n-nodes-rednotes`
4. 点击安装

### 通过命令行安装

```bash
cd ~/.n8n
npm install n8n-nodes-rednotes
```

## 配置

### 凭据设置

1. 在n8n工作流中添加Rednote节点
2. 在凭据设置中选择 **Rednote API**
3. 配置以下参数：
   - **Domain**: API服务地址（如：`http://localhost:3000`）
   - **Headless**: 是否使用无头浏览器模式
   - **User Agent**: 自定义用户代理（可选）
   - **Browserless URL**: 远程浏览器服务地址（可选）

## 节点操作

### 登录相关

#### 1. 获取登录二维码 (Get Login QR Code)
- **操作类型**: 获取登录二维码
- **返回**: 二维码文件路径和使用说明

#### 2. 检查登录状态 (Check Login Status)
- **操作类型**: 检查当前登录状态
- **返回**: 登录状态、用户信息和cookies

#### 3. 手机号登录 (Login with Phone)
- **手机号**: 用于登录的手机号码
- **验证码**: 验证码（可选，不填写则只发送验证码）
- **返回**: 登录结果或验证码发送状态

### 内容搜索

#### 1. 搜索内容 (Search Content)
- **关键词**: 搜索关键词
- **结果限制**: 返回结果数量限制
- **返回**: 笔记列表（标题、内容、作者、互动数据等）

#### 2. 获取笔记详情 (Get Content Details)
- **笔记URL**: 小红书笔记的完整URL
- **返回**: 笔记详细信息（标题、内容、标签、图片、互动数据等）

### 用户操作

#### 1. 获取用户信息 (Get User Profile)
- **用户URL**: 小红书用户主页URL
- **返回**: 用户详细信息（用户名、简介、粉丝数、笔记数等）

#### 2. 获取用户笔记 (Get User Notes)
- **用户URL**: 小红书用户主页URL
- **数量限制**: 获取笔记数量限制
- **返回**: 用户笔记列表

### 笔记交互

#### 执行笔记操作 (Perform Note Operations)
- **笔记URL**: 要操作的笔记URL
- **点赞**: 是否点赞笔记
- **收藏**: 是否收藏笔记
- **评论内容**: 评论内容（可选）
- **返回**: 各操作执行结果

### 媒体下载

#### 下载图片 (Download Images)
- **图片URL**: 要下载的图片URL，多个URL用逗号分隔
- **保存目录**: 保存目录（可选，留空保存到临时目录）
- **返回**: 下载结果和文件信息

## 工作流示例

### 示例1：搜索并分析热门笔记
1. **搜索内容** - 使用关键词搜索笔记
2. **获取详情** - 获取感兴趣的笔记详情
3. **数据存储** - 将结果存储到数据库

### 示例2：用户分析工作流
1. **获取用户信息** - 分析特定用户
2. **获取用户笔记** - 获取用户的所有笔记
3. **数据统计** - 分析用户活跃度和内容质量

### 示例3：自动互动工作流
1. **检查登录状态** - 确保账号已登录
2. **搜索内容** - 搜索相关笔记
3. **执行笔记操作** - 批量点赞、收藏或评论

## 技术要求

- **Node.js**: >= 20.15
- **n8n**: 最新版本
- **浏览器**: 支持Chrome/Chromium

## 注意事项

### 使用建议
1. 建议合理控制请求频率，避免触发平台的反爬机制
2. 使用代理可以提高稳定性并避免IP被封
3. 定期检查登录状态，确保会话有效

### 安全提醒
1. 请妥善保管登录凭证和cookies
2. 遵守小红书的服务条款
3. 仅用于合法的自动化场景

## 项目结构

```
n8n-nodes-rednotes/
├── dist/                    # 编译输出
│   ├── credentials/        # 凭证文件
│   │   └── Rednote.credentials.js
│   └── nodes/              # 节点文件
│       └── Rednote/
│           ├── Rednote.node.js
│           └── rednote.svg
├── src/                     # 源代码
│   ├── credentials/        # 凭证源码
│   └── nodes/              # 节点源码
├── package.json            # 项目配置
├── index.js               # 入口文件
├── README.md              # 说明文档
├── LICENSE.md             # 许可证文件
└── gulpfile.js            # 构建配置
```

## 故障排除

### 常见问题

1. **登录失败**
   - 检查网络连接
   - 确保浏览器版本兼容
   - 尝试手动登录后再使用节点

2. **搜索无结果**
   - 确认已正确登录
   - 检查关键词是否正确
   - 调整结果限制参数

3. **操作失败**
   - 检查笔记URL是否正确
   - 确认账号有相应权限
   - 查看详细错误信息

## 免责声明

本项目仅供学习和研究使用，请遵守小红书的服务条款和相关法律法规。使用本项目所产生的任何后果由使用者自行承担。

## 许可证

MIT License - 详见 [LICENSE.md](./LICENSE.md) 文件

## 贡献

欢迎提交Issue和Pull Request来改进项目。

## 联系方式

- **作者**: Peony
- **邮箱**: graywar@qq.com
- **GitHub**: [Catofsuffering](https://github.com/Catofsuffering)