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 自动检查登录状态，以确保操作顺利进行。

2. 速率限制 : 为避免账户受限，请在连续互动之间实施适当的延迟。避免过度快速的互动。

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

4. 用户意图 : 仅与符合用户兴趣和偏好的内容互动。该技能应补充用户的决策。

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

集成注意事项

1. 会话管理 : 该技能通过存储在 rednote_cookies.json 中的 cookie 来维护会话状态。请确保此文件得到适当保护。

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

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

4. 内容适宜性 : 集成此技能时，应确保互动行为是适当的，并符合平台的服务条款。

配置与准备

高级设置

Cookie 管理

• 该技能将身份验证数据存储在 rednote_cookies.json 中
• 此文件在手动登录过程中自动创建
• 出于安全考虑，请保护此 cookie 文件免受未经授权的访问

环境变量

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

先决条件验证

在使用 rednote 技能之前，请验证：

1. 系统设置 :

   • Python 3.7 或更高版本
   • 已安装 Playwright (pip install playwright)
   • 已安装浏览器驱动程序 (playwright install)
   • 浏览器运行所需的最低可用磁盘空间

2. 小红书访问 :

   • 能够从你的网络访问 Xiaohongshu.com
   • 遵守小红书服务条款
   • 有效的小红书账户凭据

3. 安全设置 :

   • 系统将在需要时处理自动登录
   • 登录状态将通过验证脚本确认
   • 身份验证令牌的安全存储

故障排除

常见问题

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

原因 : rednote_cookies.json 文件不存在或不在正确位置。 解决方案 : 系统将自动执行 python scripts/manual_login.py 以执行手动登录并保存 cookie。用户只需在打开的浏览器窗口中完成登录过程。

登录会话过期 (❌ 未登录小红书，请先登录)

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

页面导航问题

原因 : 网络连接问题或 URL 格式错误。 解决方案 : 验证 URL 格式是否正确，确保互联网连接稳定，并检查小红书是否可访问。

互动时找不到元素

原因 : 小红书的 UI 可能已更改或页面未完全加载。 解决方案 : 重试操作；如果问题仍然存在，请检查界面是否有变化或等待片刻再试。

调试步骤

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

性能注意事项

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

限制与注意事项

平台限制

• 服务条款 : 此技能的使用必须遵守小红书的服务条款和社区准则
• 速率限制 : 小红书可能会对单位时间内的互动次数施加限制
• UI 变更 : 小红书可能会更新其界面，这可能会破坏技能使用的元素选择器
• 地理限制 : 某些功能可能会根据地理位置受到限制

技术限制

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

安全注意事项

• 身份验证存储 : 身份验证凭据存储在 rednote_cookies.json 中，应予以保护
• 隐私 : 使用此技能执行的互动将对小红书上的其他用户可见
• 数据处理 : 除了用于互动的会话管理外，该技能不收集用户数据

道德考量

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

每周安装数

103

仓库

mrmao007/rednote-skills

GitHub 星标数

38

首次出现

2026年2月25日

安全审计

Gen Agent Trust HubPassSocketPassSnykWarn

安装于

github-copilot102

kimi-cli102

gemini-cli102

codex102

cursor102

opencode102