Rednote 技能

此技能允许您完全与小红书（Little Red Book）平台交互。您可以按关键字搜索帖子并返回结果，将特定笔记的内容提取为结构化的 Markdown 格式，并执行点赞、评论、收藏、关注用户等互动操作。

配置与准备

要求

• Python 3.7+
• Playwright（使用 pip install playwright 安装）
• Playwright 驱动（使用 playwright install 安装）
• 配置好的浏览器环境

始终先做

使用此技能前，系统将验证您的登录状态：

python scripts/validate_cookies.py

如果输出为 True，则您拥有正常访问权限，可以继续执行搜索操作。

如果输出为 False 或登录按钮可见，系统将自动执行手动登录流程：

python scripts/manual_login.py

系统将在浏览器窗口中启动登录界面。您需要按照打开的浏览器中的提示手动完成登录，完成后关闭浏览器。

使用步骤

1. 环境设置

使用此技能前，请确保：

1. 已安装所需的依赖项（Python 3.7+、Playwright）
2. 需要时，系统将通过手动登录流程自动处理 cookie 保存
3. 登录状态将使用验证工具自动验证

2. 使用搜索功能

该技能提供了多个搜索和提取函数：

• 按关键字搜索笔记：python scripts/search_note_by_key_word.py <KEYWORD> [--top_n TOP_N]
• 提取笔记内容：python scripts/dump_note.py <NOTE_URL>

3. 使用互动功能

该技能提供了多个互动函数：

• 点赞笔记：python scripts/like_note.py <NOTE_URL>
• 收藏笔记：python scripts/collect_note.py <NOTE_URL>
• 评论笔记：python scripts/comment_note.py <NOTE_URL> <COMMENT_TEXT>
• 关注用户：python scripts/follow_user.py <NOTE_URL>
• 发布笔记：python scripts/publish_note.py --image-urls <IMG1 [IMG2 ...]> --title <TITLE> --content <CONTENT> --tags <TAG1 [TAG2 ...]>
• 验证登录：python scripts/validate_cookies.py
• 手动登录：python scripts/manual_login.py

4. 完整工作流程

1. 在开始交互前验证登录状态
2. 如果需要查找特定笔记，执行所需的搜索函数
3. 使用正确的参数执行所需的互动函数
4. 监控结果以确保成功完成

函数说明

此技能提供以下函数用于搜索小红书内容并与其交互：

搜索笔记（search_note_by_key_word.py）

目的：使用提供的关键字搜索小红书笔记。

参数：

• keyword（字符串）：要搜索的关键字
• --top_n（整数，可选）：返回的笔记数量（默认为 5）

返回：匹配关键字的笔记 URL 列表

行为：启动浏览器，在小红书上搜索关键字，返回匹配的笔记 URL。

提取笔记内容（dump_note.py）

目的：提取特定笔记内容并转换为格式化的 Markdown。

参数：

• note_url（字符串）：要提取内容的笔记 URL

返回：结构化的 Markdown 内容，包括作者、标题、媒体、描述、标签和互动数据

行为：启动浏览器，访问笔记，提取内容并格式化为 Markdown。

点赞笔记（like_note.py）

目的：通过笔记 URL 点赞特定笔记。

参数：

• note_url（字符串）：要点赞的笔记 URL

返回：表示点赞是否成功的成功或错误消息

行为：启动浏览器，导航到笔记 URL，点击点赞按钮，然后关闭浏览器。

收藏笔记（collect_note.py）

目的：将特定笔记收藏（保存）到用户的收藏夹。

参数：

• note_url（字符串）：要收藏的笔记 URL

返回：表示收藏是否成功的成功或错误消息

行为：启动浏览器，导航到笔记 URL，点击收藏按钮，然后关闭浏览器。

评论笔记（comment_note.py）

目的：对特定笔记添加评论。

参数：

• note_url（字符串）：要评论的笔记 URL
• comment_text（字符串）：评论的文本内容

返回：表示评论是否发布的成功或错误消息

行为：启动浏览器，导航到笔记 URL，填写评论文本，点击发送按钮，然后关闭浏览器。

关注用户（follow_user.py）

目的：通过访问笔记 URL 关注创建该笔记的用户。

参数：

• note_url（字符串）：要关注的用户所创建笔记的 URL

返回：表示关注操作是否成功的成功或错误消息

行为：启动浏览器，导航到笔记 URL，如果有可用的关注按钮则点击，然后关闭浏览器。

验证登录状态（validate_cookies.py）

目的：检查保存的认证令牌是否有效以及用户是否已登录小红书。

参数：无

返回：表示登录是否成功的布尔值

行为：启动浏览器，使用存储的凭据访问小红书主页，检查登录状态。

手动登录（manual_login.py）

目的：通过打开登录界面帮助创建有效的认证 cookie。

参数：无

返回：保存 cookie 后的成功或错误消息

行为：启动浏览器，导航到小红书，允许用户手动登录，然后将 cookie 保存到存储文件。

发布笔记（publish_note.py）

用途：向用户的小红书账户发布一条新的图文笔记，包含提供的内容、图片和标签。

参数：

• --image-urls IMG1 [IMG2 ...]：要上传的一张或多张图片文件的路径（必填）
• --title TITLE：新笔记的标题（必填）
• --content CONTENT：新笔记的主要内容文本（必填）
• --tags TAG1 [TAG2 ...]：要附加到笔记上的一个或多个标签（必填）

返回：成功或错误消息，指示笔记是否成功发布

行为：启动浏览器，导航到小红书发布页面，填写笔记标题、内容、标签并上传提供的图片，然后点击发布按钮。

示例

基本搜索与内容提取

# 验证登录状态
python scripts/validate_cookies.py

# 搜索关于“旅行攻略”的笔记
python scripts/search_note_by_key_word.py "旅行攻略" --top_n 3

# 提取特定笔记的内容
python scripts/dump_note.py "https://www.xiaohongshu.com/explore/some-note-id"

基本点赞与收藏

# 点赞特定笔记
python scripts/like_note.py "https://www.xiaohongshu.com/explore/some-note-id"

# 收藏特定笔记
python scripts/collect_note.py "https://www.xiaohongshu.com/explore/some-note-id"

评论笔记

# 对特定笔记添加评论
python scripts/comment_note.py "https://www.xiaohongshu.com/explore/some-note-id" "Beautiful content! Thanks for sharing."

关注用户

# 根据用户的一篇帖子关注该用户
python scripts/follow_user.py "https://www.xiaohongshu.com/explore/some-note-by-user-id"

发布笔记

# 发布包含图片、标题、内容和标签的新笔记
python scripts/publish_note.py \
  --image-urls "/path/to/img1.jpg" "/path/to/img2.jpg" \
  --title "My New Post" \
  --content "Check out this amazing discovery!" \
  --tags "travel" "food" "lifestyle"

完整用户会话

# 1. 验证登录
python scripts/validate_cookies.py

# 2. 搜索感兴趣的内容
python scripts/search_note_by_key_word.py "美食推荐" --top_n 5

# 3. 提取笔记的详细内容
python scripts/dump_note.py "https://www.xiaohongshu.com/explore/note1"

# 4. 点赞感兴趣的内容
python scripts/like_note.py "https://www.xiaohongshu.com/explore/note1"

# 5. 收藏有用的内容
python scripts/collect_note.py "https://www.xiaohongshu.com/explore/note2"

# 6. 与社区互动
python scripts/comment_note.py "https://www.xiaohongshu.com/explore/note3" "Awesome tutorial!"

# 7. 关注优质内容创作者
python scripts/follow_user.py "https://www.xiaohongshu.com/explore/note-by-creator"

实现指南

最佳实践

1. 先验证登录：在执行任何交互操作之前，将自动使用 validate_cookies.py 检查登录状态，以确保操作顺利进行。

1. 速率限制：为避免账户限制，在连续交互之间加入适当的延迟。避免过快的连续操作。

1. 错误处理：检查函数的返回值，确保操作成功后再进行下一步。

1. 用户意图：仅与符合用户兴趣和偏好的内容互动。该技能应辅助用户决策。

1. 浏览器状态管理：脚本管理浏览器的打开和关闭，因此请确保系统有足够的资源用于这些操作。

集成注意事项

1. 会话管理：该技能通过存储在 rednote_cookies.json 中的 cookie 维护会话状态。请确保该文件得到妥善保护。

1. 浏览器自动化：该技能使用无头浏览器进行自动化。请确保系统已配置兼容的浏览器环境。

1. URL 格式：脚本期望格式正确的小红书 URL。在传递给函数之前请确保 URL 有效。

1. 内容适当性：集成此技能时要确保互动适当且符合平台服务条款。

配置与准备

高级设置

Cookie 管理

• 该技能将认证数据存储在 rednote_cookies.json 中
• 该文件在手动登录过程中自动创建
• 为安全起见，请保护此 cookie 文件防止未经授权访问

环境变量

• 无需特定环境变量
• 该技能使用脚本目录中的默认配置文件

前提条件验证

使用 rednote 技能前，请确认：

1. 系统设置：

- Python 3.7 或更高版本

- 已安装 Playwright（pip install playwright）

- 已安装浏览器驱动（playwright install）

- 浏览器运行所需的最小可用磁盘空间

1. 小红书访问：

- 能从您的网络访问 xiaohongshu.com

- 遵守小红书的服务条款

- 拥有有效的小红书账户凭证

1. 安全设置：

- 系统会在需要时自动处理登录

- 登录状态将通过验证脚本确认

- 认证令牌的安全存储

故障排除

常见问题

登录错误（❌ 未找到 cookies 文件，请先登录小红书并保存 cookies）

原因：rednote_cookies.json 文件不存在或不在正确位置。

解决方案：系统将自动执行 python scripts/manual_login.py 以进行手动登录并保存 cookies。用户只需在打开的浏览器窗口中完成登录过程即可。

登录会话过期（❌ 未登录小红书，请先登录）

原因：认证令牌已过期或无效。

解决方案：系统将重新验证登录状态，并可能再次执行 python scripts/manual_login.py 以刷新令牌。如果收到提示，用户只需在打开的浏览器窗口中完成登录过程。

页面导航问题

原因：网络连接问题或URL格式错误。

解决方案：验证URL格式正确，确保网络连接稳定，并检查小红书是否可访问。

交互过程中未找到元素

原因：小红书界面可能已更改或页面未完全加载。

解决方案：重试操作；如果问题仍然存在，检查界面更改或稍等片刻再试。

调试步骤

1. 验证前提条件：确保所有依赖已安装且可访问
2. 检查登录状态：在操作前运行验证脚本
3. 检查URL格式：确保URL是格式正确的小红书链接
4. 监控浏览器行为：使用非无头模式观察自动化过程
5. 检查存储文件：验证cookies文件存在且可访问

性能考虑

• 浏览器自动化资源消耗较大；确保系统有足够的内存和CPU
• 网络延迟可能影响操作时机；考虑在操作之间添加延迟
• 定期运行验证脚本以确认身份验证稳定

限制与注意事项

平台限制

• 服务条款：使用此技能必须遵守小红书服务条款和社区指南
• 速率限制：小红书可能对每段时间内的交互次数施加限制
• UI变化：小红书可能更新界面，从而破坏该技能使用的元素选择器
• 地域限制：某些功能可能受地理位置限制

技术限制

• 浏览器依赖：该技能依赖浏览器自动化，可能比直接API调用慢
• 稳定性：浏览器自动化可能受网络条件和网站变更影响
• 资源使用：每次交互都会启动浏览器实例，消耗系统资源
• 无头模式兼容性：某些交互在非无头模式下效果更好

安全考虑

• 身份验证存储：身份验证凭据存储在 rednote_cookies.json 中，应确保安全
• 隐私：使用此技能进行的交互将对小红书上的其他用户可见
• 数据处理：该技能不会收集用户数据，仅用于交互的会话管理

伦理考虑

• 真实互动：使用该技能促进用户真正感兴趣的内容的真实参与
• 尊重内容创作者：考虑交互对内容创作者及其受众的影响
• 反垃圾信息伦理：避免将该技能用于类似垃圾信息的行为或可能损害平台生态系统的方式