{
  "schemaVersion": "1.0",
  "item": {
    "slug": "xiaohongshu-skill",
    "name": "小红书skill",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/DeliciousBuding/xiaohongshu-skill",
    "canonicalUrl": "https://clawhub.ai/DeliciousBuding/xiaohongshu-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/xiaohongshu-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xiaohongshu-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "requirements.txt",
      "SKILL.md",
      "scripts/client.py",
      "scripts/comment.py",
      "scripts/explore.py",
      "scripts/feed.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/xiaohongshu-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/xiaohongshu-skill",
    "agentPageUrl": "https://openagent3.xyz/skills/xiaohongshu-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/xiaohongshu-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/xiaohongshu-skill/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "小红书 Skill",
        "body": "基于 Python Playwright 的小红书（rednote）交互工具，通过浏览器自动化从 window.__INITIAL_STATE__（Vue SSR 状态）中提取结构化数据。"
      },
      {
        "title": "前置条件",
        "body": "在 {baseDir} 目录下安装依赖：\n\ncd {baseDir}\npip install -r requirements.txt\nplaywright install chromium\n\nLinux/WSL 环境还需运行：\n\nplaywright install-deps chromium"
      },
      {
        "title": "快速开始",
        "body": "所有命令从 {baseDir} 目录运行。"
      },
      {
        "title": "1. 登录（首次必须）",
        "body": "cd {baseDir}\n\n# 打开浏览器窗口，显示二维码供微信/小红书扫描\npython -m scripts qrcode --headless=false\n\n# 检查登录是否仍然有效\npython -m scripts check-login\n\n在无头环境下，二维码图片保存到 {baseDir}/data/qrcode.png，可通过其他渠道发送扫码。"
      },
      {
        "title": "2. 搜索",
        "body": "cd {baseDir}\n\n# 基础搜索\npython -m scripts search \"关键词\"\n\n# 带筛选条件\npython -m scripts search \"美食\" --sort-by=最新 --note-type=图文 --limit=10\n\n筛选选项：\n\n--sort-by：综合、最新、最多点赞、最多评论、最多收藏\n--note-type：不限、视频、图文\n--publish-time：不限、一天内、一周内、半年内\n--search-scope：不限、已看过、未看过、已关注\n--location：不限、同城、附近"
      },
      {
        "title": "3. 帖子详情",
        "body": "cd {baseDir}\n\n# 使用搜索结果中的 id 和 xsec_token\npython -m scripts feed <feed_id> <xsec_token>\n\n# 加载评论\npython -m scripts feed <feed_id> <xsec_token> --load-comments --max-comments=20"
      },
      {
        "title": "4. 用户主页",
        "body": "cd {baseDir}\npython -m scripts user <user_id> [xsec_token]"
      },
      {
        "title": "数据提取路径",
        "body": "数据类型JavaScript 路径搜索结果window.__INITIAL_STATE__.search.feeds帖子详情window.__INITIAL_STATE__.note.noteDetailMap用户信息window.__INITIAL_STATE__.user.userPageData用户笔记window.__INITIAL_STATE__.user.notes\n\nVue Ref 处理： 始终通过 .value 或 ._value 解包：\n\nconst data = obj.value !== undefined ? obj.value : obj._value;"
      },
      {
        "title": "反爬保护",
        "body": "本 Skill 内置了针对小红书反机器人策略的保护措施：\n\n频率控制：两次导航间自动延迟 3-6 秒，每 5 次连续请求后冷却 10 秒\n验证码检测：自动检测安全验证页面重定向，触发时抛出 CaptchaError 并给出处理建议\n仿人类行为：随机延迟、滚动模式、User-Agent 伪装\n\n触发验证码时的处理：\n\n等待几分钟后重试\n运行 cd {baseDir} && python -m scripts qrcode --headless=false 手动通过验证\n如 Cookie 失效，重新扫码登录"
      },
      {
        "title": "输出格式",
        "body": "所有命令输出 JSON 到标准输出。搜索结果示例：\n\n{\n  \"id\": \"abc123\",\n  \"xsec_token\": \"ABxyz...\",\n  \"title\": \"帖子标题\",\n  \"type\": \"normal\",\n  \"user\": \"用户名\",\n  \"user_id\": \"user123\",\n  \"liked_count\": \"1234\",\n  \"collected_count\": \"567\",\n  \"comment_count\": \"89\"\n}"
      },
      {
        "title": "文件结构",
        "body": "{baseDir}/\n├── SKILL.md              # 本文件（Skill 规范）\n├── README.md             # 项目文档\n├── requirements.txt      # Python 依赖\n├── LICENSE               # MIT 许可证\n├── data/                 # 运行时数据（二维码、调试输出）\n└── scripts/              # 核心模块\n    ├── __init__.py\n    ├── __main__.py       # CLI 入口\n    ├── client.py         # 浏览器客户端封装（频率控制 + 验证码检测）\n    ├── login.py          # 二维码扫码登录流程\n    ├── search.py         # 搜索（支持多种筛选）\n    ├── feed.py           # 帖子详情提取\n    └── user.py           # 用户主页提取"
      },
      {
        "title": "跨平台兼容性",
        "body": "环境无头模式有头模式（扫码登录）备注Windows支持支持主要开发环境WSL2 (Win11)支持通过 WSLg 支持需要 playwright install-depsLinux 服务器支持不适用二维码保存为图片文件"
      },
      {
        "title": "注意事项",
        "body": "Cookie 过期：Cookie 会定期过期，check-login 返回 false 时需重新登录\n频率限制：过度抓取会触发验证码，请依赖内置的频率控制\nxsec_token：Token 与会话绑定，始终使用搜索/用户结果中的最新 Token\n仅供学习：请遵守小红书的使用条款，本工具仅用于学习研究"
      }
    ],
    "body": "小红书 Skill\n\n基于 Python Playwright 的小红书（rednote）交互工具，通过浏览器自动化从 window.__INITIAL_STATE__（Vue SSR 状态）中提取结构化数据。\n\n前置条件\n\n在 {baseDir} 目录下安装依赖：\n\ncd {baseDir}\npip install -r requirements.txt\nplaywright install chromium\n\n\nLinux/WSL 环境还需运行：\n\nplaywright install-deps chromium\n\n快速开始\n\n所有命令从 {baseDir} 目录运行。\n\n1. 登录（首次必须）\ncd {baseDir}\n\n# 打开浏览器窗口，显示二维码供微信/小红书扫描\npython -m scripts qrcode --headless=false\n\n# 检查登录是否仍然有效\npython -m scripts check-login\n\n\n在无头环境下，二维码图片保存到 {baseDir}/data/qrcode.png，可通过其他渠道发送扫码。\n\n2. 搜索\ncd {baseDir}\n\n# 基础搜索\npython -m scripts search \"关键词\"\n\n# 带筛选条件\npython -m scripts search \"美食\" --sort-by=最新 --note-type=图文 --limit=10\n\n\n筛选选项：\n\n--sort-by：综合、最新、最多点赞、最多评论、最多收藏\n--note-type：不限、视频、图文\n--publish-time：不限、一天内、一周内、半年内\n--search-scope：不限、已看过、未看过、已关注\n--location：不限、同城、附近\n3. 帖子详情\ncd {baseDir}\n\n# 使用搜索结果中的 id 和 xsec_token\npython -m scripts feed <feed_id> <xsec_token>\n\n# 加载评论\npython -m scripts feed <feed_id> <xsec_token> --load-comments --max-comments=20\n\n4. 用户主页\ncd {baseDir}\npython -m scripts user <user_id> [xsec_token]\n\n数据提取路径\n数据类型\tJavaScript 路径\n搜索结果\twindow.__INITIAL_STATE__.search.feeds\n帖子详情\twindow.__INITIAL_STATE__.note.noteDetailMap\n用户信息\twindow.__INITIAL_STATE__.user.userPageData\n用户笔记\twindow.__INITIAL_STATE__.user.notes\n\nVue Ref 处理： 始终通过 .value 或 ._value 解包：\n\nconst data = obj.value !== undefined ? obj.value : obj._value;\n\n反爬保护\n\n本 Skill 内置了针对小红书反机器人策略的保护措施：\n\n频率控制：两次导航间自动延迟 3-6 秒，每 5 次连续请求后冷却 10 秒\n验证码检测：自动检测安全验证页面重定向，触发时抛出 CaptchaError 并给出处理建议\n仿人类行为：随机延迟、滚动模式、User-Agent 伪装\n\n触发验证码时的处理：\n\n等待几分钟后重试\n运行 cd {baseDir} && python -m scripts qrcode --headless=false 手动通过验证\n如 Cookie 失效，重新扫码登录\n输出格式\n\n所有命令输出 JSON 到标准输出。搜索结果示例：\n\n{\n  \"id\": \"abc123\",\n  \"xsec_token\": \"ABxyz...\",\n  \"title\": \"帖子标题\",\n  \"type\": \"normal\",\n  \"user\": \"用户名\",\n  \"user_id\": \"user123\",\n  \"liked_count\": \"1234\",\n  \"collected_count\": \"567\",\n  \"comment_count\": \"89\"\n}\n\n文件结构\n{baseDir}/\n├── SKILL.md              # 本文件（Skill 规范）\n├── README.md             # 项目文档\n├── requirements.txt      # Python 依赖\n├── LICENSE               # MIT 许可证\n├── data/                 # 运行时数据（二维码、调试输出）\n└── scripts/              # 核心模块\n    ├── __init__.py\n    ├── __main__.py       # CLI 入口\n    ├── client.py         # 浏览器客户端封装（频率控制 + 验证码检测）\n    ├── login.py          # 二维码扫码登录流程\n    ├── search.py         # 搜索（支持多种筛选）\n    ├── feed.py           # 帖子详情提取\n    └── user.py           # 用户主页提取\n\n跨平台兼容性\n环境\t无头模式\t有头模式（扫码登录）\t备注\nWindows\t支持\t支持\t主要开发环境\nWSL2 (Win11)\t支持\t通过 WSLg 支持\t需要 playwright install-deps\nLinux 服务器\t支持\t不适用\t二维码保存为图片文件\n注意事项\nCookie 过期：Cookie 会定期过期，check-login 返回 false 时需重新登录\n频率限制：过度抓取会触发验证码，请依赖内置的频率控制\nxsec_token：Token 与会话绑定，始终使用搜索/用户结果中的最新 Token\n仅供学习：请遵守小红书的使用条款，本工具仅用于学习研究"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/DeliciousBuding/xiaohongshu-skill",
    "publisherUrl": "https://clawhub.ai/DeliciousBuding/xiaohongshu-skill",
    "owner": "DeliciousBuding",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/xiaohongshu-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/xiaohongshu-skill",
    "agentUrl": "https://openagent3.xyz/skills/xiaohongshu-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/xiaohongshu-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/xiaohongshu-skill/agent.md"
  }
}