{"id":"1d294b07-363b-41b1-b082-387caa176e99","entityType":"agent","slug":"clawhub-wscats-xhs-cn","name":"小红书","canonicalUrl":"https://www.xpersona.co/agent/clawhub-wscats-xhs-cn","canonicalPath":"/agent/clawhub-wscats-xhs-cn","generatedAt":"2026-10-09T18:16:37.541Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T02:53:12.763Z","emptyReason":null},"description":"小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。 当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。 Skill: 小红书 Owner: wscats Summary: 小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。 当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。 Tags: latest:1.0.10 Version history: v1.0.10 | 2026-05-02T07:11:03.669Z | auto Version 1.0.10 - 增强客户端安全措施：新增自动检测，默认拒绝所有不安全或未授权的 publish 操作。 - SKILL.md 文档重写，明确所有客户端内置护栏，以及上游组件独立、非本仓库维护的提醒。 - 快速参考与市场调研、内容发布流程重构，突出强制逐步授权和机械性安全检查细节。 - 简化注意事项，删除/合并部分重复的人工安全警告，统一以客户端强制规约为准。 v1.0.7 | 2026-05-02T06:","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 7.6K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s17bw1sf2hsjw09jmyh7nhzshn83h2gf:xhs-cn","sourceUrl":"https://clawhub.ai/wscats/xhs-cn","homepage":"https://clawhub.ai/wscats/skills/xhs-cn","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/wscats/xhs-cn","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/wscats/skills/xhs-cn","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":73,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。 当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。 Skill: 小红书 Owner: wscats Summary: 小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:53:12.763Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:53:12.763Z","emptyReason":null},"stars":null,"forks":null,"downloads":7583,"packageName":null,"latestVersion":"1.0.10","tractionLabel":"7.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:53:12.762Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T02:53:12.763Z","lastCrawledAt":"2026-10-09T02:53:12.762Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T02:53:12.762Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.10","createdAt":"2026-05-02T07:11:03.669Z","changelog":"Version 1.0.10 - 增强客户端安全措施：新增自动检测，默认拒绝所有不安全或未授权的 `publish` 操作。 - SKILL.md 文档重写，明确所有客户端内置护栏，以及上游组件独立、非本仓库维护的提醒。 - 快速参考与市场调研、内容发布流程重构，突出强制逐步授权和机械性安全检查细节。 - 简化注意事项，删除/合并部分重复的人工安全警告，统一以客户端强制规约为准。","fileCount":6,"zipByteSize":12690},{"version":"1.0.7","createdAt":"2026-05-02T06:54:00.466Z","changelog":"Version 1.0.7 - 增加了“安装前知情同意（Informed Consent）”区块，首次使用前强调信任模型和安全边界。 - 明确告知用户自动化发布的敏感性，并建议仅用专用账号、本地部署且逐次授权操作。 - 现将 MCP 服务器的第三方来源、安全要求及会话托管风险写入顶部说明。 - 其余使用方法、指令与安全指引未更动。","fileCount":5,"zipByteSize":12852},{"version":"1.0.6","createdAt":"2026-05-02T06:41:27.403Z","changelog":"**重大更新：完善发布安全机制，防止误发，强化账号与隐私保护** - 发布流程新增“发布预览+逐次书面授权”环节，禁止模糊或静默同意，防止自动化脚本误发内容。 - 强调 `publish` 命令具公开不可撤回风险，建议使用专用账号，严禁主账号托管。 - 明确本地服务器仅允许 localhost 监听，安全性提升，杜绝误设暴露。 - 补充敏感操作须逐次获授权的硬性原则，禁止在无人值守环境调用发帖功能。 - 修订发布相关文档，区分 Skill 发布与小红书内容发布，注记脚本仅供开发者使用。 （此次更新无接口参数变更，兼容原有命令用法）","fileCount":5,"zipByteSize":11458},{"version":"1.0.5","createdAt":"2026-04-05T00:36:07.179Z","changelog":"- All documentation rewritten from English to Chinese for improved localization. - Usage instructions and workflows updated to use Chinese terminology, examples, and step-by-step guides. - Clarified command references and best practices in a fully localized format. - Updated descriptions to better reflect the skill’s use case and activation cues for Chinese-speaking users.","fileCount":5,"zipByteSize":7049},{"version":"1.0.4","createdAt":"2026-04-04T06:13:51.261Z","changelog":"- Added scripts/publish.sh to the repository. - No other functional or documentation changes.","fileCount":5,"zipByteSize":6853},{"version":"1.0.3","createdAt":"2026-04-04T06:11:42.965Z","changelog":"Version 1.0.3 of the xhs-cn skill is a major simplification and refactor: - Migrated to a lightweight wrapper model: skill now operates via a bundled Python client (scripts/xhs_client.py) that communicates with a required, separately-run local MCP server for Xiaohongshu automation. - Entire in-package Python SDK, examples, and most config files were removed; legacy code for direct automation is no longer included. - Documentation now focuses on command line workflows using the provided client script, with quick references for searching, publishing, and retrieval tasks. - Clear separation: all automation now handled through the external MCP server; setup instructions moved to SETUP.md.","fileCount":4,"zipByteSize":5626},{"version":"1.0.2","createdAt":"2026-03-21T10:18:50.528Z","changelog":"**Version 1.0.2 Changelog** - Added detailed skill manifest fields, including: `version`, `source`, `homepage`, `env_vars`, `local_files`, and `permissions` in SKILL.md. - Now lists and describes all optional environment variables for authentication and proxy/browser configuration. - Documents the handling and sensitivity of local files, especially `cookies.json` and `.env`. - Specifies permissions and operational scope of the skill. - README/guide content remains comprehensive and unchanged in feature scope.","fileCount":11,"zipByteSize":34589},{"version":"1.0.1","createdAt":"2026-03-20T15:56:19.101Z","changelog":"xhs-cn 1.0.1 introduces Python自动化操作与Playwright全链路真实小红书运营自动化。 - 新增 Playwright+异步API，支持二维码扫码自动登录、内容创作自动发布、互动评论等真实操作 - 新增 `examples/login_and_publish.py`、核心代码目录 `xiaohongshu/`，实现扫码登录/图文/视频发布、笔记搜索、点赞、评论等功能 - 配置/结构文档全面更新，详细说明业务能力、API、自动化流程及快速上手 - 支持 Cookie 持久化与自动复用，极大提升自动化体验 - 代码与文档均已模块化，支持二次开发与集成","fileCount":11,"zipByteSize":32542}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17bw1sf2hsjw09jmyh7nhzshn83h2gf:xhs-cn","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-wscats-xhs-cn/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-wscats-xhs-cn/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-wscats-xhs-cn/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-wscats-xhs-cn/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-wscats-xhs-cn/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-wscats-xhs-cn/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T18:16:37.538Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-wscats-xhs-cn/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-wscats-xhs-cn/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-wscats-xhs-cn/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-wscats-xhs-cn/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T02:53:12.763Z","emptyReason":null},"readme":"Skill: 小红书\n\nOwner: wscats\n\nSummary: 小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。 当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。\n\nTags: latest:1.0.10\n\nVersion history:\n\nv1.0.10 | 2026-05-02T07:11:03.669Z | auto\n\nVersion 1.0.10\n\n- 增强客户端安全措施：新增自动检测，默认拒绝所有不安全或未授权的 `publish` 操作。\n- SKILL.md 文档重写，明确所有客户端内置护栏，以及上游组件独立、非本仓库维护的提醒。\n- 快速参考与市场调研、内容发布流程重构，突出强制逐步授权和机械性安全检查细节。\n- 简化注意事项，删除/合并部分重复的人工安全警告，统一以客户端强制规约为准。\n\nv1.0.7 | 2026-05-02T06:54:00.466Z | auto\n\nVersion 1.0.7\n\n- 增加了“安装前知情同意（Informed Consent）”区块，首次使用前强调信任模型和安全边界。\n- 明确告知用户自动化发布的敏感性，并建议仅用专用账号、本地部署且逐次授权操作。\n- 现将 MCP 服务器的第三方来源、安全要求及会话托管风险写入顶部说明。\n- 其余使用方法、指令与安全指引未更动。\n\nv1.0.6 | 2026-05-02T06:41:27.403Z | auto\n\n**重大更新：完善发布安全机制，防止误发，强化账号与隐私保护**\n\n- 发布流程新增“发布预览+逐次书面授权”环节，禁止模糊或静默同意，防止自动化脚本误发内容。\n- 强调 `publish` 命令具公开不可撤回风险，建议使用专用账号，严禁主账号托管。\n- 明确本地服务器仅允许 localhost 监听，安全性提升，杜绝误设暴露。\n- 补充敏感操作须逐次获授权的硬性原则，禁止在无人值守环境调用发帖功能。\n- 修订发布相关文档，区分 Skill 发布与小红书内容发布，注记脚本仅供开发者使用。\n\n（此次更新无接口参数变更，兼容原有命令用法）\n\nv1.0.5 | 2026-04-05T00:36:07.179Z | auto\n\n- All documentation rewritten from English to Chinese for improved localization.\n- Usage instructions and workflows updated to use Chinese terminology, examples, and step-by-step guides.\n- Clarified command references and best practices in a fully localized format.\n- Updated descriptions to better reflect the skill’s use case and activation cues for Chinese-speaking users.\n\nv1.0.4 | 2026-04-04T06:13:51.261Z | auto\n\n- Added scripts/publish.sh to the repository.\n- No other functional or documentation changes.\n\nv1.0.3 | 2026-04-04T06:11:42.965Z | auto\n\nVersion 1.0.3 of the xhs-cn skill is a major simplification and refactor:\n\n- Migrated to a lightweight wrapper model: skill now operates via a bundled Python client (scripts/xhs_client.py) that communicates with a required, separately-run local MCP server for Xiaohongshu automation.\n- Entire in-package Python SDK, examples, and most config files were removed; legacy code for direct automation is no longer included.\n- Documentation now focuses on command line workflows using the provided client script, with quick references for searching, publishing, and retrieval tasks.\n- Clear separation: all automation now handled through the external MCP server; setup instructions moved to SETUP.md.\n\nv1.0.2 | 2026-03-21T10:18:50.528Z | auto\n\n**Version 1.0.2 Changelog**\n\n- Added detailed skill manifest fields, including: `version`, `source`, `homepage`, `env_vars`, `local_files`, and `permissions` in SKILL.md.\n- Now lists and describes all optional environment variables for authentication and proxy/browser configuration.\n- Documents the handling and sensitivity of local files, especially `cookies.json` and `.env`.\n- Specifies permissions and operational scope of the skill.\n- README/guide content remains comprehensive and unchanged in feature scope.\n\nv1.0.1 | 2026-03-20T15:56:19.101Z | auto\n\nxhs-cn 1.0.1 introduces Python自动化操作与Playwright全链路真实小红书运营自动化。\n\n- 新增 Playwright+异步API，支持二维码扫码自动登录、内容创作自动发布、互动评论等真实操作\n- 新增 `examples/login_and_publish.py`、核心代码目录 `xiaohongshu/`，实现扫码登录/图文/视频发布、笔记搜索、点赞、评论等功能\n- 配置/结构文档全面更新，详细说明业务能力、API、自动化流程及快速上手\n- 支持 Cookie 持久化与自动复用，极大提升自动化体验\n- 代码与文档均已模块化，支持二次开发与集成\n\nv1.0.9 | 2026-03-19T15:51:32.556Z | auto\n\n- 简化并精炼了技能描述文本，去除多余修饰，使介绍内容更加简洁直接。\n- 删除了部分重复和啰嗦的说明，无更动功能和使用方式。\n- 保持所有示例场景和功能模块不变，整体内容结构一致。\n- 技能核心能力与原有版本保持一致，仅描述方式更加精炼。\n\nv1.0.8 | 2026-03-19T15:50:26.119Z | auto\n\nxiaohongshu 1.0.8 更新日志\n\n- 新增SKILL.md，系统化介绍技能的功能、用法与应用场景。\n- 明确罗列全链路运营能力，从内容创作、笔记发布、搜索与分析、评论互动到运营数据分析。\n- 丰富使用示例，覆盖多风格生成、发布时间、竞品分析、引导互动等多种实际需求。\n- 补充进阶用法与组合能力说明，提升实际使用效率。\n- 增加注意事项，提醒用户内容合规与数据分析范围。\n\nArchive index:\n\nArchive v1.0.10: 6 files, 12690 bytes\n\nFiles: scripts/publish.sh (4199b), scripts/xhs_client.py (14645b), SETUP.md (3400b), skill-card.md (2632b), SKILL.md (4288b), _meta.json (126b)\n\nFile v1.0.10:SKILL.md\n\n---\nname: xiaohongshu\ndescription: >\n  小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。\n  当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。\n---\n\n# 小红书 MCP\n\n本 Skill 是一个薄的 Python 客户端，通过 HTTP 调用用户**自行独立安装、启动并保管**的第三方本地组件 [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)。本 Skill 不分发、不捆绑、不自动拉取任何第三方二进制。首次安装请参阅 [SETUP.md](SETUP.md)。\n\n## 客户端侧自动护栏（客户端拒绝执行的条件）\n\n以下检查由 `scripts/xhs_client.py` **自动执行**，任何一项不满足都会直接拒绝发起调用：\n\n| 检查 | 触发条件 | 客户端行为 |\n| ---- | -------- | ---------- |\n| Loopback 端点 | 目标地址不解析到 127.0.0.1/localhost/::1 | 进程启动即拒绝（退出码 1） |\n| 非交互发布 | stdin 非 TTY 且未传 `--yes` | 拒绝 `publish`，返回 error |\n| 交互发布确认 | TTY 下用户未输入 `PUBLISH` 字面量 | 取消 `publish` |\n| 专用账号声明 | `XHS_DEDICATED_ACCOUNT` 未显式置 `yes` | 拒绝 `publish` |\n| 上游版本可见性 | `XHS_UPSTREAM_PINNED_VERSION` 未设置 | `status` 输出中性提醒 |\n\n这些不是建议，是**运行时机械拒绝**。用户或代理无需依赖额外自律。\n\n## 快速参考\n\n```bash\npython scripts/xhs_client.py status\npython scripts/xhs_client.py search \"美食推荐\"\npython scripts/xhs_client.py search \"美食\" --sort \"最多点赞\" --type \"图文\" --time \"一周内\"\npython scripts/xhs_client.py detail <feed_id> <xsec_token> --comments\npython scripts/xhs_client.py feeds\npython scripts/xhs_client.py publish \"标题\" \"正文\" \"图1,图2\" --tags \"标签1,标签2\"\n```\n\n所有命令支持 `--json` 输出原始 JSON。\n\n## 工作流：市场调研（只读）\n\n```\n进度：\n- [ ] 第 1 步：验证连接\n- [ ] 第 2 步：搜索关键词\n- [ ] 第 3 步：获取笔记详情\n- [ ] 第 4 步：分析结果\n```\n\n**第 1 步**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n**第 2 步**\n\n```bash\npython scripts/xhs_client.py search \"户外电源\" --sort \"最多点赞\" --json\n```\n\n筛选：`--sort`（综合/最新/最多点赞/最多评论/最多收藏）、`--type`（不限/视频/图文）、`--time`（不限/一天内/一周内/半年内）。\n\n**第 3 步**\n\n```bash\npython scripts/xhs_client.py detail \"<feed_id>\" \"<xsec_token>\" --comments --json\n```\n\n**第 4 步**\n\n查看笔记内容、互动数据（点赞、收藏、评论）与评论情感倾向。\n\n## 工作流：发布内容\n\n```\n进度：\n- [ ] 第 1 步：验证连接\n- [ ] 第 2 步：准备素材\n- [ ] 第 3 步：向用户展示预览并获取逐次授权\n- [ ] 第 4 步：发起发布（受客户端护栏保护）\n- [ ] 第 5 步：验证上线\n```\n\n**第 1 步**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n**第 2 步**\n\n准备标题（建议 ≤ 20 字）、正文、可公开访问的图片 URL、可选标签。\n\n**第 3 步 — 代理必须执行的强制预览**\n\n调用 `publish` 前，代理必须向用户打印结构化预览并等待用户在对话中回复明确授权词：\n\n```\n📋 发布预览\n────────────\n账号：<status 返回的账号>\n标题：<title>\n正文：<content 全文>\n图片：<逐行 URL>\n标签：<tags>\n────────────\n请回复“确认发布”以继续；任何其他回复视为取消。\n```\n\n模糊回复、沉默、或\"以后都可以发\"等概括授权**一律视为未授权**。\n\n**第 4 步 — 发起发布**\n\n仅在收到用户授权后执行：\n\n```bash\npython scripts/xhs_client.py publish \"标题\" \"正文\" \"https://img1.jpg,https://img2.jpg\" --tags \"标签1,标签2\"\n```\n\n客户端会再对第 3 步的授权做机械验证（TTY 二次确认或 `--yes` + 专用账号声明）。\n\n**第 5 步**\n\n```bash\npython scripts/xhs_client.py search \"标题\" --sort \"最新\"\n```\n\n## 注意事项\n\n- **频率控制**：请适当控制请求间隔。\n- **维护脚本**：`scripts/publish.sh` 仅用于把本 Skill 包发布到 ClawHub 市场，与\"在小红书发布笔记\"无关，终端用户无需运行。\n\nFile v1.0.10:_meta.json\n\n{\n  \"ownerId\": \"kn78mv1912530wvdbf2vjcd3r982v66j\",\n  \"slug\": \"xhs-cn\",\n  \"version\": \"1.0.10\",\n  \"publishedAt\": 1777705863669\n}\n\nFile v1.0.10:SETUP.md\n\n# 服务器安装（仅首次需要）\n\n本 Skill 的运行依赖一个**独立的第三方本地组件** [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)。本 Skill 自身**不包含、不分发、不打包**该组件的任何二进制或源代码，也**不会自动下载**它。是否安装、安装哪个版本、授予哪种账号权限，**完全由用户本人在安装本 Skill 之前独立决定**。\n\n## 安装前检查清单（Preflight Checklist）\n\n在继续之前，请逐项勾选以下条件。**如有任何一项无法满足，请停止安装本 Skill**：\n\n- [ ] 我已独立审核并信任第三方组件 `xpzouying/xiaohongshu-mcp`。\n- [ ] 我会使用一个**独立注册的专用账号**，不会使用我的主账号或企业账号。\n- [ ] 我会将该组件仅运行在受我本人物理控制的个人电脑上。\n- [ ] 我会使用该组件的默认 loopback 配置，不会修改其网络绑定。\n- [ ] 我理解并接受：该组件运行期间可代表上述专用账号发布公开内容，误操作不可撤回。\n- [ ] 任务完成后，我会停止该组件进程，并在官方 App 中手动吊销对应的登录设备。\n\n> ℹ️ 本 Skill 随附的 Python 客户端 `scripts/xhs_client.py` 在客户端一侧已内置多道自动拒绝机制：\n> 非 loopback 端点、非交互环境下的发布、未声明专用账号的发布，都会被**直接拒绝执行**，\n> 详见 `xhs_client.py` 顶部注释。\n\n## 第 0 步：安装 Python 依赖\n\n```bash\npip install requests\n```\n\n## 第 1 步：获取第三方 MCP 组件（推荐从源码编译）\n\n为避免供应链风险，**推荐**直接从官方仓库克隆并锁定到一个你已审核的具体版本 tag，然后用 Go 工具链自行编译：\n\n```bash\ngit clone https://github.com/xpzouying/xiaohongshu-mcp.git\ncd xiaohongshu-mcp\ngit checkout <YOUR_REVIEWED_TAG>     # 必须是一个你已人工审核过的具体 tag，禁止使用 main/latest\ngo build -o xiaohongshu-mcp ./cmd/mcp\ngo build -o xiaohongshu-login ./cmd/login\n```\n\n如必须使用预编译产物，请从 [官方 Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases) 下载指定 tag 的文件，并核对其 SHA256 与你从源码独立计算的哈希一致后再使用。\n\n完成后，将你确认使用的版本号写入环境变量，供本 Skill 的客户端进行一致性提示：\n\n```bash\nexport XHS_UPSTREAM_PINNED_VERSION=\"<YOUR_REVIEWED_TAG>\"\n```\n\n## 第 2 步：登录\n\n完成登录后，客户端会声明你正在使用的是**专用账号**；本 Skill 的 `publish` 命令要求用户显式设置该声明后才会放行：\n\n```bash\nexport XHS_DEDICATED_ACCOUNT=yes     # 只有在你用的是独立的专用账号时才设置\n./xiaohongshu-login-<your-platform>  # 扫码登录\n```\n\n## 第 3 步：启动 MCP 组件（保持默认 loopback 绑定）\n\n按照第三方组件文档的**默认**方式启动即可（其默认就绑定在本机回环接口）。本 Skill 的客户端会验证端点必须是 loopback，否则**直接拒绝发起任何请求**。\n\n```bash\n./xiaohongshu-mcp-<your-platform>\n```\n\n## 第 4 步：验证\n\n```bash\npython scripts/xhs_client.py status\n```\n\n## 使用结束后\n\n```bash\npkill -f xiaohongshu-mcp\nunset XHS_DEDICATED_ACCOUNT XHS_UPSTREAM_PINNED_VERSION\n```\n\n并在小红书官方 App 的「登录设备管理」中主动下线对应设备。\n\nFile v1.0.10:skill-card.md\n\n## Description:\n\n小红书 helps agents search Xiaohongshu notes, inspect details and comments, browse recommended feeds, and publish image-text posts through a user-managed local MCP component.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[wscats](https://clawhub.ai/user/wscats)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers, creators, and operators use this skill to research Xiaohongshu content, review note details and comments, browse feeds, and prepare authorized image-text posts. Publishing requires a user-managed local MCP service and explicit per-post authorization.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: A non-local MCP endpoint override could send Xiaohongshu tokens or draft post content to a remote server.\n\nMitigation: Keep the endpoint on loopback by default, and do not set XHS_ALLOW_REMOTE=yes or XHS_MCP_BASE_URL to a non-loopback address unless the server is fully trusted.\n\nRisk: The required third-party local MCP component can act through the configured Xiaohongshu account, including publishing public content.\n\nMitigation: Audit and pin the upstream component version, use a dedicated Xiaohongshu account, review each post before publishing, stop the component after use, and revoke the login device in the official app.\n\nRisk: The maintainer publish script is unrelated to end-user Xiaohongshu posting and mutates ClawHub distribution state.\n\nMitigation: Normal users should not run scripts/publish.sh; reserve it for maintainers with the required ClawHub credentials and explicit publish confirmation.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/wscats/skills/xhs-cn)\n- [SETUP.md](SETUP.md)\n- [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)\n- [xiaohongshu-mcp Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON, Shell commands, Guidance]\n\n**Output Format:** [Markdown guidance with shell commands and optional JSON command output]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Commands interact with a user-managed local MCP service; publish operations require explicit authorization and a dedicated-account attestation.]\n\n## Skill Version(s):\n\n1.0.10 (source: server release evidence, released 2026-05-02)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.7: 5 files, 12852 bytes\n\nFiles: scripts/publish.sh (4199b), scripts/xhs_client.py (13500b), SETUP.md (5711b), SKILL.md (6610b), _meta.json (125b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: xiaohongshu\ndescription: >\n  小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。\n  当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。\n---\n\n# 小红书 MCP\n\n> ## 🔐 安装前知情同意（Informed Consent）\n>\n> 本 Skill 是一个**可代表用户向公开社交平台发布内容**的自动化工具。在安装或启用它之前，\n> 请确认你已理解并接受以下**固有信任模型**——这些并非缺陷，而是 Skill 的本职功能：\n>\n> 1. **公开发布能力**：`publish` 命令会使用**当前登录的小红书账号**向**公开平台**发送图文，\n>    一经成功即**无法由本工具撤回**，误发可能造成账号限流或声誉损失。\n> 2. **会话委托**：MCP 服务器运行期间持有你的小红书登录会话，其进程内的任何调用方\n>    （包括 AI 代理）都具备\"以你的名义发帖/浏览\"的等价权限。\n> 3. **第三方上游**：运行时二进制来自第三方仓库 [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)，\n>    不由本 Skill 维护者发布，你需要自行审核其安全性（详见 [SETUP.md](SETUP.md)）。\n>\n> **因此，强烈建议你在以下条件全部满足后再使用本 Skill**：\n> - ✅ 使用**专用小红书账号**登录，而非主账号；\n> - ✅ MCP 服务器仅绑定 **127.0.0.1**（loopback），不对外暴露；\n> - ✅ 每一次 `publish` 都由**真实用户**在看到预览后逐次授权，**禁止无人值守批量发帖**；\n> - ✅ 自动化结束后**主动停止服务器并在小红书 App 中下线设备**。\n>\n> 若以上任一条件无法满足，请**不要安装本 Skill**。\n\n## 简介\n\n通过内置的 Python 客户端与本地 [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) 服务器通信，自动化小红书操作。\n\n**前置条件**：`pip install requests` 并确保 MCP 服务器正在运行。首次安装请参阅 [SETUP.md](SETUP.md)。\n\n## 快速参考\n\n```bash\npython scripts/xhs_client.py status\npython scripts/xhs_client.py search \"美食推荐\"\npython scripts/xhs_client.py search \"美食\" --sort \"最多点赞\" --type \"图文\" --time \"一周内\"\npython scripts/xhs_client.py detail <feed_id> <xsec_token> --comments\npython scripts/xhs_client.py feeds\npython scripts/xhs_client.py publish \"标题\" \"正文内容\" \"图片链接1,图片链接2\" --tags \"标签1,标签2\"\n```\n\n所有命令均支持 `--json` 参数以输出原始 JSON 数据。\n\n## 工作流：市场调研\n\n```\n进度：\n- [ ] 第 1 步：验证服务器连接\n- [ ] 第 2 步：搜索目标关键词\n- [ ] 第 3 步：获取笔记详情\n- [ ] 第 4 步：分析调研结果\n```\n\n**第 1 步：验证服务器连接**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n如果未连接，请参阅 [SETUP.md](SETUP.md)。在状态显示已登录之前，请勿继续后续步骤。\n\n**第 2 步：搜索目标关键词**\n\n```bash\npython scripts/xhs_client.py search \"户外电源\" --sort \"最多点赞\" --json\n```\n\n筛选参数：`--sort`（综合/最新/最多点赞/最多评论/最多收藏）、`--type`（不限/视频/图文）、`--time`（不限/一天内/一周内/半年内）。\n\n**第 3 步：获取笔记详情**\n\n使用搜索结果中的 `feed_id` 和 `xsec_token`：\n\n```bash\npython scripts/xhs_client.py detail \"<feed_id>\" \"<xsec_token>\" --comments --json\n```\n\n**第 4 步：分析调研结果**\n\n查看笔记内容、互动数据（点赞、收藏、评论）以及评论区情感倾向。\n\n## 工作流：发布内容\n\n```\n进度：\n- [ ] 第 1 步：验证服务器连接\n- [ ] 第 2 步：准备图片和文案\n- [ ] 第 3 步：向用户展示发布预览并获得明确授权\n- [ ] 第 4 步：发布笔记\n- [ ] 第 5 步：验证发布结果\n```\n\n> ⚠️ **安全边界（必须遵守）**：\n> - `publish` 命令会立即以**当前登录账号**的身份向**公开平台**发布内容，无法静默撤回。\n> - 代理（AI/自动化脚本）**禁止**在未经用户明确、逐次书面授权的情况下执行 `publish`。\n> - 即使用户在早先的对话中说过\"可以发布\"，每次具体发布前仍需针对本次标题/正文/图片/标签再次确认。\n> - 建议使用**专用的小红书账号**（而非主账号）配合本工具，降低误发风险。\n\n**第 1 步：验证服务器连接**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n**第 2 步：准备图片和文案**\n\n确保图片链接可公开访问。准备标题（建议不超过 20 个字符）、正文内容和可选标签。\n\n**第 3 步：向用户展示发布预览并获得明确授权**\n\n在调用 `publish` 之前，代理必须向用户输出如下结构化预览，并等待用户回复明确的授权词（例如「确认发布」/「publish」），不得以沉默或模糊答复视为同意：\n\n```\n📋 发布预览\n────────────\n账号：   <登录账号，来自 status>\n标题：   <title>\n正文：   <content 完整内容>\n图片：   <每张图片 URL，逐行列出>\n标签：   <tags>\n────────────\n请回复\"确认发布\"以继续，或回复任何其他内容以取消。\n```\n\n**第 4 步：发布笔记**\n\n仅在收到用户明确授权后执行：\n\n```bash\npython scripts/xhs_client.py publish \"标题\" \"正文内容\" \"https://img1.jpg,https://img2.jpg\" --tags \"标签1,标签2\"\n```\n\n**第 5 步：验证发布结果**\n\n搜索已发布的笔记以确认上线：\n\n```bash\npython scripts/xhs_client.py search \"标题\" --sort \"最新\"\n```\n\n## 注意事项\n\n- **会话失效**：MCP 服务器运行期间，请勿在其他任何网页浏览器中登录同一小红书账号。\n- **服务器必须运行**：所有命令都需要 MCP 服务器在 `http://localhost:18060` 上运行，且**只应绑定在 localhost**，请勿将该端口暴露到公网或局域网。\n- **频率限制**：请适当控制请求间隔，避免触发反自动化机制。\n- **账号建议**：建议使用专用小红书账号运行本工具，不要使用主账号，以限制自动化操作的影响范围。\n- **发布授权**：本 Skill 的 `publish` 命令为**敏感操作**，代理在执行前必须获取用户的逐次明确授权，禁止在批处理/定时任务中无监督调用。\n\n> 注意：仓库内的 `scripts/publish.sh` 仅用于将本 Skill 包**发布到 ClawHub 插件市场**，与\"在小红书发布笔记\"完全无关，终端用户无需也不应运行它。详见该脚本顶部注释。\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn78mv1912530wvdbf2vjcd3r982v66j\",\n  \"slug\": \"xhs-cn\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1777704840466\n}\n\nFile v1.0.7:SETUP.md\n\n# 服务器安装（仅首次需要）\n\n本 Skill 需要在本地运行 [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) 服务器。\n\n> ## 🔐 你即将授予什么（Trust Model）\n>\n> 完成本 SETUP 后，你的机器上将存在以下**持久化信任关系**，请在继续之前确认你接受：\n>\n> | 主体 | 将持有的权限 | 作用范围 |\n> | ---- | ------------ | -------- |\n> | 本地 `xiaohongshu-mcp` 进程 | 登录态 Cookie / 浏览器会话 | 可代表你的账号**浏览、发帖、评论** |\n> | 任何能访问 `127.0.0.1:18060` 的本机程序 | 上述进程的全部 API | **=** 等价于你本人操作小红书 |\n> | 调用本 Skill 的 AI 代理 | 通过 `xhs_client.py` 间接调用上述 API | 受 SKILL.md 中的授权流程约束 |\n>\n> 这意味着 MCP 服务器**本质上是你小红书账号的\"本地代理人\"**。它一旦启动，就对账号具备\n> 发布级权限，直到你主动停止进程 **并** 在小红书 App 中吊销该登录会话为止。\n>\n> 为将此信任关系的爆炸半径控制到最小，**必须**：\n>\n> - ✅ 使用**专用小红书账号**（非主账号）登录；\n> - ✅ 服务器只绑定 **127.0.0.1**，不使用 `-host 0.0.0.0`、端口转发、ngrok 等任何公网暴露手段；\n> - ✅ **按需启动、用完即停**，不要常驻后台；\n> - ✅ 停止服务器后，在小红书 App 的「设置 → 账号与安全 → 登录设备管理」中**手动下线**该会话，彻底吊销凭证；\n> - ✅ 所在机器自身受可信用户控制（不要在共享机器 / 未锁屏的办公电脑上长时间运行）。\n>\n> 若你无法满足上述任一条件，请**停止安装**。\n\n> ⚠️ **供应链安全须知（请先阅读）**\n>\n> `xiaohongshu-mcp` 是**第三方上游项目**，并非本 Skill 维护者发布。在安装前请自行完成以下尽职调查：\n>\n> 1. 访问 [上游仓库](https://github.com/xpzouying/xiaohongshu-mcp) 并审查其源代码、Issue 与近期提交。\n> 2. **锁定一个具体的发行版本**（例如 `v1.2.3`），避免使用 `latest` 或浮动引用——这样未来上游被接管或恶意更新时，你的环境不会被自动污染。\n> 3. **校验下载产物的完整性**：对比 Release 页面上的 SHA256（如上游未提供校验和，请在 Issue 中要求，或选择自行从源码编译）。\n> 4. **优先从源码构建**：如对预编译二进制不放心，可 `git clone` 指定 tag 后使用 Go 工具链在本地编译，这样可完全杜绝预编译产物被替换的风险。\n> 5. 推荐使用**专用的小红书账号**（而不是你的主账号）登录本工具，以将潜在风险范围降至最低。\n\n## 第 0 步：安装 Python 依赖\n\n```bash\npip install requests\n```\n\n## 第 1 步：获取 MCP 二进制文件\n\n### 方式 A：下载官方预编译产物（需校验）\n\n从 [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases) 选择一个**具体版本 tag**（示例中以 `vX.Y.Z` 代指，请替换为你审核过的版本号）：\n\n| 平台 | MCP 服务器 | 登录工具 |\n| ---- | ---------- | -------- |\n| macOS (Apple Silicon) | `xiaohongshu-mcp-darwin-arm64` | `xiaohongshu-login-darwin-arm64` |\n| macOS (Intel) | `xiaohongshu-mcp-darwin-amd64` | `xiaohongshu-login-darwin-amd64` |\n| Windows | `xiaohongshu-mcp-windows-amd64.exe` | `xiaohongshu-login-windows-amd64.exe` |\n| Linux | `xiaohongshu-mcp-linux-amd64` | `xiaohongshu-login-linux-amd64` |\n\n**下载后务必校验 SHA256**（示例为 macOS arm64）：\n\n```bash\n# 将下方 <EXPECTED_SHA256> 替换为 Release 页面公布/你自行审核得到的值\nshasum -a 256 xiaohongshu-mcp-darwin-arm64\n# 核对输出与 <EXPECTED_SHA256> 完全一致后再继续\n```\n\n授予执行权限（macOS/Linux）：\n\n```bash\nchmod +x xiaohongshu-mcp-* xiaohongshu-login-*\n```\n\n### 方式 B（推荐）：从源码自行编译\n\n```bash\ngit clone https://github.com/xpzouying/xiaohongshu-mcp.git\ncd xiaohongshu-mcp\ngit checkout vX.Y.Z          # 切到你审核过的具体版本 tag\ngo build -o xiaohongshu-mcp ./cmd/mcp\ngo build -o xiaohongshu-login ./cmd/login\n```\n\n从源码构建可彻底避免预编译产物被篡改的风险。\n\n## 第 2 步：登录（使用专用账号）\n\n> 🔐 **账号安全提示**：\n> - 强烈建议**新注册或使用一个专用的小红书账号**进行登录，不要使用你的主账号。\n> - 登录后产生的**会话凭证**将保存在本机，MCP 服务器运行期间可代表该账号执行发布、浏览等动作——这已超出只读范围，请谨慎授权。\n> - 请勿在其他任何网页浏览器中登录同一账号，否则会导致会话失效。\n> - 不再需要自动化时，请**主动停止 MCP 服务器并在小红书 App 中手动登出**以吊销会话。\n\n运行登录工具，使用小红书 App 扫描二维码登录：\n\n```bash\n./xiaohongshu-login-darwin-arm64\n```\n\n## 第 3 步：启动 MCP 服务器（仅绑定 localhost）\n\n```bash\n# 无头模式（推荐）\n./xiaohongshu-mcp-darwin-arm64\n\n# 显示浏览器窗口（用于调试）\n./xiaohongshu-mcp-darwin-arm64 -headless=false\n```\n\n服务器默认运行在 `http://localhost:18060`。\n\n> ⚠️ **网络边界**：该服务器**只应监听 127.0.0.1**，请勿使用 `-host 0.0.0.0` 或端口转发等方式将其暴露到局域网/公网，否则任何同网段设备都可使用你的账号发布内容。\n\n使用以下命令验证：\n\n```bash\npython scripts/xhs_client.py status\n```\n\n自动化工作结束后：\n\n```bash\n# 停止服务器（Ctrl+C 或）\npkill -f xiaohongshu-mcp\n```\n\n并在小红书 App 的「设置 → 账号与安全 → 登录设备管理」中主动下线对应会话。\n\nArchive v1.0.6: 5 files, 11458 bytes\n\nFiles: scripts/publish.sh (4199b), scripts/xhs_client.py (13500b), SETUP.md (4170b), SKILL.md (5104b), _meta.json (125b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: xiaohongshu\ndescription: >\n  小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。\n  当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。\n---\n\n# 小红书 MCP\n\n通过内置的 Python 客户端与本地 [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) 服务器通信，自动化小红书操作。\n\n**前置条件**：`pip install requests` 并确保 MCP 服务器正在运行。首次安装请参阅 [SETUP.md](SETUP.md)。\n\n## 快速参考\n\n```bash\npython scripts/xhs_client.py status\npython scripts/xhs_client.py search \"美食推荐\"\npython scripts/xhs_client.py search \"美食\" --sort \"最多点赞\" --type \"图文\" --time \"一周内\"\npython scripts/xhs_client.py detail <feed_id> <xsec_token> --comments\npython scripts/xhs_client.py feeds\npython scripts/xhs_client.py publish \"标题\" \"正文内容\" \"图片链接1,图片链接2\" --tags \"标签1,标签2\"\n```\n\n所有命令均支持 `--json` 参数以输出原始 JSON 数据。\n\n## 工作流：市场调研\n\n```\n进度：\n- [ ] 第 1 步：验证服务器连接\n- [ ] 第 2 步：搜索目标关键词\n- [ ] 第 3 步：获取笔记详情\n- [ ] 第 4 步：分析调研结果\n```\n\n**第 1 步：验证服务器连接**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n如果未连接，请参阅 [SETUP.md](SETUP.md)。在状态显示已登录之前，请勿继续后续步骤。\n\n**第 2 步：搜索目标关键词**\n\n```bash\npython scripts/xhs_client.py search \"户外电源\" --sort \"最多点赞\" --json\n```\n\n筛选参数：`--sort`（综合/最新/最多点赞/最多评论/最多收藏）、`--type`（不限/视频/图文）、`--time`（不限/一天内/一周内/半年内）。\n\n**第 3 步：获取笔记详情**\n\n使用搜索结果中的 `feed_id` 和 `xsec_token`：\n\n```bash\npython scripts/xhs_client.py detail \"<feed_id>\" \"<xsec_token>\" --comments --json\n```\n\n**第 4 步：分析调研结果**\n\n查看笔记内容、互动数据（点赞、收藏、评论）以及评论区情感倾向。\n\n## 工作流：发布内容\n\n```\n进度：\n- [ ] 第 1 步：验证服务器连接\n- [ ] 第 2 步：准备图片和文案\n- [ ] 第 3 步：向用户展示发布预览并获得明确授权\n- [ ] 第 4 步：发布笔记\n- [ ] 第 5 步：验证发布结果\n```\n\n> ⚠️ **安全边界（必须遵守）**：\n> - `publish` 命令会立即以**当前登录账号**的身份向**公开平台**发布内容，无法静默撤回。\n> - 代理（AI/自动化脚本）**禁止**在未经用户明确、逐次书面授权的情况下执行 `publish`。\n> - 即使用户在早先的对话中说过\"可以发布\"，每次具体发布前仍需针对本次标题/正文/图片/标签再次确认。\n> - 建议使用**专用的小红书账号**（而非主账号）配合本工具，降低误发风险。\n\n**第 1 步：验证服务器连接**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n**第 2 步：准备图片和文案**\n\n确保图片链接可公开访问。准备标题（建议不超过 20 个字符）、正文内容和可选标签。\n\n**第 3 步：向用户展示发布预览并获得明确授权**\n\n在调用 `publish` 之前，代理必须向用户输出如下结构化预览，并等待用户回复明确的授权词（例如「确认发布」/「publish」），不得以沉默或模糊答复视为同意：\n\n```\n📋 发布预览\n────────────\n账号：   <登录账号，来自 status>\n标题：   <title>\n正文：   <content 完整内容>\n图片：   <每张图片 URL，逐行列出>\n标签：   <tags>\n────────────\n请回复\"确认发布\"以继续，或回复任何其他内容以取消。\n```\n\n**第 4 步：发布笔记**\n\n仅在收到用户明确授权后执行：\n\n```bash\npython scripts/xhs_client.py publish \"标题\" \"正文内容\" \"https://img1.jpg,https://img2.jpg\" --tags \"标签1,标签2\"\n```\n\n**第 5 步：验证发布结果**\n\n搜索已发布的笔记以确认上线：\n\n```bash\npython scripts/xhs_client.py search \"标题\" --sort \"最新\"\n```\n\n## 注意事项\n\n- **会话失效**：MCP 服务器运行期间，请勿在其他任何网页浏览器中登录同一小红书账号。\n- **服务器必须运行**：所有命令都需要 MCP 服务器在 `http://localhost:18060` 上运行，且**只应绑定在 localhost**，请勿将该端口暴露到公网或局域网。\n- **频率限制**：请适当控制请求间隔，避免触发反自动化机制。\n- **账号建议**：建议使用专用小红书账号运行本工具，不要使用主账号，以限制自动化操作的影响范围。\n- **发布授权**：本 Skill 的 `publish` 命令为**敏感操作**，代理在执行前必须获取用户的逐次明确授权，禁止在批处理/定时任务中无监督调用。\n\n> 注意：仓库内的 `scripts/publish.sh` 仅用于将本 Skill 包**发布到 ClawHub 插件市场**，与\"在小红书发布笔记\"完全无关，终端用户无需也不应运行它。详见该脚本顶部注释。\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn78mv1912530wvdbf2vjcd3r982v66j\",\n  \"slug\": \"xhs-cn\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1777704087403\n}\n\nFile v1.0.6:SETUP.md\n\n# 服务器安装（仅首次需要）\n\n本 Skill 需要在本地运行 [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) 服务器。\n\n> ⚠️ **供应链安全须知（请先阅读）**\n>\n> `xiaohongshu-mcp` 是**第三方上游项目**，并非本 Skill 维护者发布。在安装前请自行完成以下尽职调查：\n>\n> 1. 访问 [上游仓库](https://github.com/xpzouying/xiaohongshu-mcp) 并审查其源代码、Issue 与近期提交。\n> 2. **锁定一个具体的发行版本**（例如 `v1.2.3`），避免使用 `latest` 或浮动引用——这样未来上游被接管或恶意更新时，你的环境不会被自动污染。\n> 3. **校验下载产物的完整性**：对比 Release 页面上的 SHA256（如上游未提供校验和，请在 Issue 中要求，或选择自行从源码编译）。\n> 4. **优先从源码构建**：如对预编译二进制不放心，可 `git clone` 指定 tag 后使用 Go 工具链在本地编译，这样可完全杜绝预编译产物被替换的风险。\n> 5. 推荐使用**专用的小红书账号**（而不是你的主账号）登录本工具，以将潜在风险范围降至最低。\n\n## 第 0 步：安装 Python 依赖\n\n```bash\npip install requests\n```\n\n## 第 1 步：获取 MCP 二进制文件\n\n### 方式 A：下载官方预编译产物（需校验）\n\n从 [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases) 选择一个**具体版本 tag**（示例中以 `vX.Y.Z` 代指，请替换为你审核过的版本号）：\n\n| 平台 | MCP 服务器 | 登录工具 |\n| ---- | ---------- | -------- |\n| macOS (Apple Silicon) | `xiaohongshu-mcp-darwin-arm64` | `xiaohongshu-login-darwin-arm64` |\n| macOS (Intel) | `xiaohongshu-mcp-darwin-amd64` | `xiaohongshu-login-darwin-amd64` |\n| Windows | `xiaohongshu-mcp-windows-amd64.exe` | `xiaohongshu-login-windows-amd64.exe` |\n| Linux | `xiaohongshu-mcp-linux-amd64` | `xiaohongshu-login-linux-amd64` |\n\n**下载后务必校验 SHA256**（示例为 macOS arm64）：\n\n```bash\n# 将下方 <EXPECTED_SHA256> 替换为 Release 页面公布/你自行审核得到的值\nshasum -a 256 xiaohongshu-mcp-darwin-arm64\n# 核对输出与 <EXPECTED_SHA256> 完全一致后再继续\n```\n\n授予执行权限（macOS/Linux）：\n\n```bash\nchmod +x xiaohongshu-mcp-* xiaohongshu-login-*\n```\n\n### 方式 B（推荐）：从源码自行编译\n\n```bash\ngit clone https://github.com/xpzouying/xiaohongshu-mcp.git\ncd xiaohongshu-mcp\ngit checkout vX.Y.Z          # 切到你审核过的具体版本 tag\ngo build -o xiaohongshu-mcp ./cmd/mcp\ngo build -o xiaohongshu-login ./cmd/login\n```\n\n从源码构建可彻底避免预编译产物被篡改的风险。\n\n## 第 2 步：登录（使用专用账号）\n\n> 🔐 **账号安全提示**：\n> - 强烈建议**新注册或使用一个专用的小红书账号**进行登录，不要使用你的主账号。\n> - 登录后产生的**会话凭证**将保存在本机，MCP 服务器运行期间可代表该账号执行发布、浏览等动作——这已超出只读范围，请谨慎授权。\n> - 请勿在其他任何网页浏览器中登录同一账号，否则会导致会话失效。\n> - 不再需要自动化时，请**主动停止 MCP 服务器并在小红书 App 中手动登出**以吊销会话。\n\n运行登录工具，使用小红书 App 扫描二维码登录：\n\n```bash\n./xiaohongshu-login-darwin-arm64\n```\n\n## 第 3 步：启动 MCP 服务器（仅绑定 localhost）\n\n```bash\n# 无头模式（推荐）\n./xiaohongshu-mcp-darwin-arm64\n\n# 显示浏览器窗口（用于调试）\n./xiaohongshu-mcp-darwin-arm64 -headless=false\n```\n\n服务器默认运行在 `http://localhost:18060`。\n\n> ⚠️ **网络边界**：该服务器**只应监听 127.0.0.1**，请勿使用 `-host 0.0.0.0` 或端口转发等方式将其暴露到局域网/公网，否则任何同网段设备都可使用你的账号发布内容。\n\n使用以下命令验证：\n\n```bash\npython scripts/xhs_client.py status\n```\n\n自动化工作结束后：\n\n```bash\n# 停止服务器（Ctrl+C 或）\npkill -f xiaohongshu-mcp\n```\n\n并在小红书 App 的「设置 → 账号与安全 → 登录设备管理」中主动下线对应会话。\n\nArchive v1.0.5: 5 files, 7049 bytes\n\nFiles: scripts/publish.sh (2566b), scripts/xhs_client.py (9831b), SETUP.md (1449b), SKILL.md (3213b), _meta.json (125b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: xiaohongshu\ndescription: >\n  小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。\n  当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。\n---\n\n# 小红书 MCP\n\n通过内置的 Python 客户端与本地 [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) 服务器通信，自动化小红书操作。\n\n**前置条件**：`pip install requests` 并确保 MCP 服务器正在运行。首次安装请参阅 [SETUP.md](SETUP.md)。\n\n## 快速参考\n\n```bash\npython scripts/xhs_client.py status\npython scripts/xhs_client.py search \"美食推荐\"\npython scripts/xhs_client.py search \"美食\" --sort \"最多点赞\" --type \"图文\" --time \"一周内\"\npython scripts/xhs_client.py detail <feed_id> <xsec_token> --comments\npython scripts/xhs_client.py feeds\npython scripts/xhs_client.py publish \"标题\" \"正文内容\" \"图片链接1,图片链接2\" --tags \"标签1,标签2\"\n```\n\n所有命令均支持 `--json` 参数以输出原始 JSON 数据。\n\n## 工作流：市场调研\n\n```\n进度：\n- [ ] 第 1 步：验证服务器连接\n- [ ] 第 2 步：搜索目标关键词\n- [ ] 第 3 步：获取笔记详情\n- [ ] 第 4 步：分析调研结果\n```\n\n**第 1 步：验证服务器连接**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n如果未连接，请参阅 [SETUP.md](SETUP.md)。在状态显示已登录之前，请勿继续后续步骤。\n\n**第 2 步：搜索目标关键词**\n\n```bash\npython scripts/xhs_client.py search \"户外电源\" --sort \"最多点赞\" --json\n```\n\n筛选参数：`--sort`（综合/最新/最多点赞/最多评论/最多收藏）、`--type`（不限/视频/图文）、`--time`（不限/一天内/一周内/半年内）。\n\n**第 3 步：获取笔记详情**\n\n使用搜索结果中的 `feed_id` 和 `xsec_token`：\n\n```bash\npython scripts/xhs_client.py detail \"<feed_id>\" \"<xsec_token>\" --comments --json\n```\n\n**第 4 步：分析调研结果**\n\n查看笔记内容、互动数据（点赞、收藏、评论）以及评论区情感倾向。\n\n## 工作流：发布内容\n\n```\n进度：\n- [ ] 第 1 步：验证服务器连接\n- [ ] 第 2 步：准备图片和文案\n- [ ] 第 3 步：发布笔记\n- [ ] 第 4 步：验证发布结果\n```\n\n**第 1 步：验证服务器连接**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n**第 2 步：准备图片和文案**\n\n确保图片链接可公开访问。准备标题（建议不超过 20 个字符）、正文内容和可选标签。\n\n**第 3 步：发布笔记**\n\n```bash\npython scripts/xhs_client.py publish \"标题\" \"正文内容\" \"https://img1.jpg,https://img2.jpg\" --tags \"标签1,标签2\"\n```\n\n**第 4 步：验证发布结果**\n\n搜索已发布的笔记以确认上线：\n\n```bash\npython scripts/xhs_client.py search \"标题\" --sort \"最新\"\n```\n\n## 注意事项\n\n- **会话失效**：MCP 服务器运行期间，请勿在其他任何网页浏览器中登录同一小红书账号。\n- **服务器必须运行**：所有命令都需要 MCP 服务器在 `http://localhost:18060` 上运行。\n- **频率限制**：请适当控制请求间隔，避免触发反自动化机制。\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn78mv1912530wvdbf2vjcd3r982v66j\",\n  \"slug\": \"xhs-cn\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1775349367179\n}\n\nFile v1.0.5:SETUP.md\n\n# 服务器安装（仅首次需要）\n\n本 Skill 需要在本地运行 [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) 服务器。\n\n## 第 0 步：安装 Python 依赖\n\n```bash\npip install requests\n```\n\n## 第 1 步：下载二进制文件\n\n从 [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases) 下载：\n\n| 平台 | MCP 服务器 | 登录工具 |\n| ---- | ---------- | -------- |\n| macOS (Apple Silicon) | `xiaohongshu-mcp-darwin-arm64` | `xiaohongshu-login-darwin-arm64` |\n| macOS (Intel) | `xiaohongshu-mcp-darwin-amd64` | `xiaohongshu-login-darwin-amd64` |\n| Windows | `xiaohongshu-mcp-windows-amd64.exe` | `xiaohongshu-login-windows-amd64.exe` |\n| Linux | `xiaohongshu-mcp-linux-amd64` | `xiaohongshu-login-linux-amd64` |\n\n授予执行权限（macOS/Linux）：\n\n```bash\nchmod +x xiaohongshu-mcp-* xiaohongshu-login-*\n```\n\n## 第 2 步：登录\n\n运行登录工具，使用小红书 App 扫描二维码登录。\n\n```bash\n./xiaohongshu-login-darwin-arm64\n```\n\n> **重要提示**：请勿在其他任何网页浏览器中登录同一账号，否则会导致会话失效。\n\n## 第 3 步：启动 MCP 服务器\n\n```bash\n# 无头模式（推荐）\n./xiaohongshu-mcp-darwin-arm64\n\n# 显示浏览器窗口（用于调试）\n./xiaohongshu-mcp-darwin-arm64 -headless=false\n```\n\n服务器运行在 `http://localhost:18060`。使用以下命令验证：\n\n```bash\npython scripts/xhs_client.py status\n```\n\nArchive v1.0.4: 5 files, 6853 bytes\n\nFiles: scripts/publish.sh (2566b), scripts/xhs_client.py (9831b), SETUP.md (1416b), SKILL.md (3207b), _meta.json (125b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: xiaohongshu\ndescription: >\n  Operates Xiaohongshu (RedNote/小红书) via a local MCP server and bundled Python client.\n  Capabilities: search notes by keyword, get note details with comments, browse recommended feeds, publish image/text notes.\n  Use when user mentions xiaohongshu, 小红书, RedNote, or needs social media content research/publishing on this platform.\n---\n\n# Xiaohongshu MCP\n\nAutomate Xiaohongshu (小红书) operations via a bundled Python client that talks to the local [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) server.\n\n**Prerequisites**: `pip install requests` and a running MCP server. See [SETUP.md](SETUP.md) for first-time setup.\n\n## Quick Reference\n\n```bash\npython scripts/xhs_client.py status\npython scripts/xhs_client.py search \"美食推荐\"\npython scripts/xhs_client.py search \"美食\" --sort \"最多点赞\" --type \"图文\" --time \"一周内\"\npython scripts/xhs_client.py detail <feed_id> <xsec_token> --comments\npython scripts/xhs_client.py feeds\npython scripts/xhs_client.py publish \"Title\" \"Content\" \"img_url1,img_url2\" --tags \"tag1,tag2\"\n```\n\nAll commands support `--json` for raw JSON output.\n\n## Workflow: Market Research\n\n```\nProgress:\n- [ ] Step 1: Verify server connection\n- [ ] Step 2: Search for target keyword\n- [ ] Step 3: Retrieve note details\n- [ ] Step 4: Analyze findings\n```\n\n**Step 1: Verify server connection**\n\n```bash\npython scripts/xhs_client.py status\n```\n\nIf not connected, follow [SETUP.md](SETUP.md). Do not proceed until status shows logged in.\n\n**Step 2: Search for target keyword**\n\n```bash\npython scripts/xhs_client.py search \"户外电源\" --sort \"最多点赞\" --json\n```\n\nFilters: `--sort` (综合/最新/最多点赞/最多评论/最多收藏), `--type` (不限/视频/图文), `--time` (不限/一天内/一周内/半年内).\n\n**Step 3: Retrieve note details**\n\nUse `feed_id` and `xsec_token` from search results:\n\n```bash\npython scripts/xhs_client.py detail \"<feed_id>\" \"<xsec_token>\" --comments --json\n```\n\n**Step 4: Analyze findings**\n\nReview content, engagement metrics (likes, collects, comments), and comment sentiment.\n\n## Workflow: Publish Content\n\n```\nProgress:\n- [ ] Step 1: Verify server connection\n- [ ] Step 2: Prepare images and content\n- [ ] Step 3: Publish note\n- [ ] Step 4: Verify publication\n```\n\n**Step 1: Verify server connection**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n**Step 2: Prepare images and content**\n\nEnsure image URLs are publicly accessible. Prepare title (≤20 chars recommended), content, and optional tags.\n\n**Step 3: Publish note**\n\n```bash\npython scripts/xhs_client.py publish \"Title\" \"Content body\" \"https://img1.jpg,https://img2.jpg\" --tags \"tag1,tag2\"\n```\n\n**Step 4: Verify publication**\n\nSearch for the published note to confirm it is live:\n\n```bash\npython scripts/xhs_client.py search \"Title\" --sort \"最新\"\n```\n\n## Important Notes\n\n- **Session invalidation**: Do not log into the same Xiaohongshu account on any other web browser while the server is running.\n- **Server must be running**: All commands require the MCP server at `http://localhost:18060`.\n- **Rate limiting**: Space out requests to avoid triggering anti-automation measures.\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn78mv1912530wvdbf2vjcd3r982v66j\",\n  \"slug\": \"xhs-cn\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1775283231261\n}\n\nFile v1.0.4:SETUP.md\n\n# Server Setup (First-Time Only)\n\nThis skill requires the [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) server running locally.\n\n## Step 0: Install Python Dependency\n\n```bash\npip install requests\n```\n\n## Step 1: Download Binaries\n\nDownload from [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases):\n\n| Platform | MCP Server | Login Tool |\n| -------- | ---------- | ---------- |\n| macOS (Apple Silicon) | `xiaohongshu-mcp-darwin-arm64` | `xiaohongshu-login-darwin-arm64` |\n| macOS (Intel) | `xiaohongshu-mcp-darwin-amd64` | `xiaohongshu-login-darwin-amd64` |\n| Windows | `xiaohongshu-mcp-windows-amd64.exe` | `xiaohongshu-login-windows-amd64.exe` |\n| Linux | `xiaohongshu-mcp-linux-amd64` | `xiaohongshu-login-linux-amd64` |\n\nGrant execute permission (macOS/Linux):\n\n```bash\nchmod +x xiaohongshu-mcp-* xiaohongshu-login-*\n```\n\n## Step 2: Login\n\nRun the login tool. Scan the QR code with the Xiaohongshu mobile app.\n\n```bash\n./xiaohongshu-login-darwin-arm64\n```\n\n> **Important**: Do not log into the same account on any other web browser — this invalidates the session.\n\n## Step 3: Start the MCP Server\n\n```bash\n# Headless mode (recommended)\n./xiaohongshu-mcp-darwin-arm64\n\n# With visible browser (for debugging)\n./xiaohongshu-mcp-darwin-arm64 -headless=false\n```\n\nServer runs at `http://localhost:18060`. Verify with:\n\n```bash\npython scripts/xhs_client.py status\n```\n\nArchive v1.0.3: 4 files, 5626 bytes\n\nFiles: scripts/xhs_client.py (9831b), SETUP.md (1416b), SKILL.md (3207b), _meta.json (125b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: xiaohongshu\ndescription: >\n  Operates Xiaohongshu (RedNote/小红书) via a local MCP server and bundled Python client.\n  Capabilities: search notes by keyword, get note details with comments, browse recommended feeds, publish image/text notes.\n  Use when user mentions xiaohongshu, 小红书, RedNote, or needs social media content research/publishing on this platform.\n---\n\n# Xiaohongshu MCP\n\nAutomate Xiaohongshu (小红书) operations via a bundled Python client that talks to the local [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) server.\n\n**Prerequisites**: `pip install requests` and a running MCP server. See [SETUP.md](SETUP.md) for first-time setup.\n\n## Quick Reference\n\n```bash\npython scripts/xhs_client.py status\npython scripts/xhs_client.py search \"美食推荐\"\npython scripts/xhs_client.py search \"美食\" --sort \"最多点赞\" --type \"图文\" --time \"一周内\"\npython scripts/xhs_client.py detail <feed_id> <xsec_token> --comments\npython scripts/xhs_client.py feeds\npython scripts/xhs_client.py publish \"Title\" \"Content\" \"img_url1,img_url2\" --tags \"tag1,tag2\"\n```\n\nAll commands support `--json` for raw JSON output.\n\n## Workflow: Market Research\n\n```\nProgress:\n- [ ] Step 1: Verify server connection\n- [ ] Step 2: Search for target keyword\n- [ ] Step 3: Retrieve note details\n- [ ] Step 4: Analyze findings\n```\n\n**Step 1: Verify server connection**\n\n```bash\npython scripts/xhs_client.py status\n```\n\nIf not connected, follow [SETUP.md](SETUP.md). Do not proceed until status shows logged in.\n\n**Step 2: Search for target keyword**\n\n```bash\npython scripts/xhs_client.py search \"户外电源\" --sort \"最多点赞\" --json\n```\n\nFilters: `--sort` (综合/最新/最多点赞/最多评论/最多收藏), `--type` (不限/视频/图文), `--time` (不限/一天内/一周内/半年内).\n\n**Step 3: Retrieve note details**\n\nUse `feed_id` and `xsec_token` from search results:\n\n```bash\npython scripts/xhs_client.py detail \"<feed_id>\" \"<xsec_token>\" --comments --json\n```\n\n**Step 4: Analyze findings**\n\nReview content, engagement metrics (likes, collects, comments), and comment sentiment.\n\n## Workflow: Publish Content\n\n```\nProgress:\n- [ ] Step 1: Verify server connection\n- [ ] Step 2: Prepare images and content\n- [ ] Step 3: Publish note\n- [ ] Step 4: Verify publication\n```\n\n**Step 1: Verify server connection**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n**Step 2: Prepare images and content**\n\nEnsure image URLs are publicly accessible. Prepare title (≤20 chars recommended), content, and optional tags.\n\n**Step 3: Publish note**\n\n```bash\npython scripts/xhs_client.py publish \"Title\" \"Content body\" \"https://img1.jpg,https://img2.jpg\" --tags \"tag1,tag2\"\n```\n\n**Step 4: Verify publication**\n\nSearch for the published note to confirm it is live:\n\n```bash\npython scripts/xhs_client.py search \"Title\" --sort \"最新\"\n```\n\n## Important Notes\n\n- **Session invalidation**: Do not log into the same Xiaohongshu account on any other web browser while the server is running.\n- **Server must be running**: All commands require the MCP server at `http://localhost:18060`.\n- **Rate limiting**: Space out requests to avoid triggering anti-automation measures.\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn78mv1912530wvdbf2vjcd3r982v66j\",\n  \"slug\": \"xhs-cn\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1775283102965\n}\n\nFile v1.0.3:SETUP.md\n\n# Server Setup (First-Time Only)\n\nThis skill requires the [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) server running locally.\n\n## Step 0: Install Python Dependency\n\n```bash\npip install requests\n```\n\n## Step 1: Download Binaries\n\nDownload from [GitHub Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases):\n\n| Platform | MCP Server | Login Tool |\n| -------- | ---------- | ---------- |\n| macOS (Apple Silicon) | `xiaohongshu-mcp-darwin-arm64` | `xiaohongshu-login-darwin-arm64` |\n| macOS (Intel) | `xiaohongshu-mcp-darwin-amd64` | `xiaohongshu-login-darwin-amd64` |\n| Windows | `xiaohongshu-mcp-windows-amd64.exe` | `xiaohongshu-login-windows-amd64.exe` |\n| Linux | `xiaohongshu-mcp-linux-amd64` | `xiaohongshu-login-linux-amd64` |\n\nGrant execute permission (macOS/Linux):\n\n```bash\nchmod +x xiaohongshu-mcp-* xiaohongshu-login-*\n```\n\n## Step 2: Login\n\nRun the login tool. Scan the QR code with the Xiaohongshu mobile app.\n\n```bash\n./xiaohongshu-login-darwin-arm64\n```\n\n> **Important**: Do not log into the same account on any other web browser — this invalidates the session.\n\n## Step 3: Start the MCP Server\n\n```bash\n# Headless mode (recommended)\n./xiaohongshu-mcp-darwin-arm64\n\n# With visible browser (for debugging)\n./xiaohongshu-mcp-darwin-arm64 -headless=false\n```\n\nServer runs at `http://localhost:18060`. Verify with:\n\n```bash\npython scripts/xhs_client.py status\n```\n\nArchive v1.0.2: 11 files, 34589 bytes\n\nFiles: examples/demo.py (4032b), examples/login_and_publish.py (8699b), pyproject.toml (734b), README.md (9978b), SKILL.md (15376b), xiaohongshu/__init__.py (323b), xiaohongshu/api.py (6342b), xiaohongshu/client.py (63086b), xiaohongshu/config.py (3411b), xiaohongshu/models.py (4044b), _meta.json (125b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: xiaohongshu\nlicense: MIT\nversion: 0.1.0\nsource: https://github.com/PalmPalm7/xiaohongshu-mcp-skill\nhomepage: https://github.com/PalmPalm7/xiaohongshu-mcp-skill\ndescription: |\n  小红书全链路运营技能，提供从内容创作、笔记发布、搜索浏览、互动评论到数据分析的一站式运营支持。\n  支持二维码登录、Cookie 持久化、创作者中心图文/视频 Tab 自动切换及 TipTap 富文本编辑器自动填充。\nenv_vars:\n  optional:\n    - name: XHS_COOKIE\n      description: \"Xiaohongshu cookie string for authentication (alternative to QR login)\"\n      sensitive: true\n    - name: PROXY_SERVER\n      description: \"HTTP proxy server address (e.g. http://proxy:8080)\"\n    - name: PROXY_USERNAME\n      description: \"Proxy authentication username\"\n      sensitive: true\n    - name: PROXY_PASSWORD\n      description: \"Proxy authentication password\"\n      sensitive: true\n    - name: BROWSER_TYPE\n      description: \"Browser engine: chromium | firefox | webkit (default: chromium)\"\n    - name: HEADLESS\n      description: \"Run browser in headless mode: true | false (default: true)\"\n    - name: COOKIE_FILE\n      description: \"Path to save/load browser cookies (default: ./cookies.json)\"\n    - name: SCREENSHOT_DIR\n      description: \"Directory for screenshots (default: ./screenshots)\"\n    - name: DOWNLOAD_DIR\n      description: \"Directory for downloaded files (default: ./downloads)\"\n    - name: MIN_REQUEST_DELAY\n      description: \"Minimum delay between requests in seconds (default: 2)\"\n    - name: MAX_REQUEST_DELAY\n      description: \"Maximum delay between requests in seconds (default: 5)\"\nlocal_files:\n  - path: cookies.json\n    description: \"Persisted browser cookies (auto-saved after QR login). Contains session credentials — treat as highly sensitive.\"\n    sensitive: true\n  - path: screenshots/\n    description: \"Auto-captured screenshots of each automation step\"\n  - path: .env\n    description: \"Environment variable overrides (may contain cookie/proxy credentials)\"\n    sensitive: true\npermissions:\n  - \"Launches a non-headless Chromium browser (headless=False for QR login)\"\n  - \"Reads/writes local files: cookies.json, .env, screenshots/, downloads/\"\n  - \"Performs actions on your Xiaohongshu account: publish, like, comment, follow\"\n  - \"Optional: routes traffic through configured proxy (PROXY_SERVER)\"\n---\n# 🌟 xiaohongshu — 小红书全链路运营 Skill\n\n## 技能概述\n\n`xiaohongshu` 是一个小红书全链路运营 AI 技能，包含两大核心能力：\n\n1. **Prompt-based 内容运营** — 通过自然语言对话，获取专业级的内容创作、发布策略、运营分析建议\n2. **Python 自动化操作** — 基于 Playwright 浏览器自动化，实际执行登录、搜索、发布、互动等平台操作\n\n覆盖小红书平台的 **账号登录 → 内容创作 → 笔记发布 → 搜索浏览 → 互动评论 → 数据分析** 全链路运营场景。\n\n---\n\n## 核心能力\n\n### Prompt-based 能力（自然语言交互）\n\n| 模块 | 能力说明 |\n|------|---------  |\n| 📝 内容创作 | 生成爆款标题、正文、标签，支持多种风格和品类 |\n| 📤 发布策略 | 提供发布策略建议、最佳时间推荐、封面优化建议 |\n| 🔍 搜索分析 | 关键词分析、热门话题追踪、竞品笔记研究、SEO优化 |\n| 💬 互动运营 | 智能评论回复、互动话术生成、粉丝维护策略 |\n| 📊 数据分析 | 数据复盘、内容表现诊断、增长策略建议 |\n\n### Python 自动化能力（实际操作）\n\n| 模块 | 能力说明 | API 函数 |\n|------|---------|----------|\n| 🔐 二维码登录 | 通过扫描二维码完成小红书登录，支持 Cookie 持久化与自动复用 | `login_by_qrcode()` |\n| ✅ 登录检测 | 检查当前是否已登录，自动加载已保存的 Cookie | `check_login()` |\n| 🔍 搜索笔记 | 按关键词搜索，支持排序和类型筛选 | `search_notes()` |\n| 📄 获取详情 | 获取笔记完整信息（标题、正文、图片、视频、标签、数据） | `get_note_detail()` |\n| 📤 发布图文 | 自动切换到「上传图文」tab，上传图片并填写标题/正文/标签发布 | `publish_image_note()` |\n| 🎬 发布视频 | 上传视频并发布笔记 | `publish_video_note()` |\n| ❤️ 点赞 | 对笔记进行点赞操作 | `like_note()` |\n| ⭐ 收藏 | 对笔记进行收藏/取消收藏 | `collect_note()` |\n| 💬 评论 | 在笔记下发布评论 | `comment_note()` |\n| 👥 关注 | 关注指定用户 | `follow_user()` |\n| 💬 获取评论 | 获取笔记的评论列表 | `get_note_comments()` |\n| 👤 用户信息 | 获取用户主页信息 | `get_user_profile()` |\n\n---\n\n## 自动化发布流程\n\n二维码登录 + 图文发布的完整自动化流程如下：\n\n```\n🚀 启动浏览器 (headless=False)\n    │\n    ▼\n🍪 加载 cookies.json（若存在）\n    │\n    ▼\n🔐 检查登录状态 ──── 未登录 ──→ 📱 显示二维码（手机扫码，最长120秒）\n    │                                      │\n  已登录                               扫码成功 → 保存 Cookie\n    │                                      │\n    ▼◄─────────────────────────────────────┘\n📸 生成/准备待发布图片\n    │\n    ▼\n🌐 打开创作者中心 (creator.xiaohongshu.com/publish/publish)\n    │\n    ▼\n🔄 自动切换到「上传图文」Tab（默认页面是「上传视频」Tab）\n    │\n    ▼\n📤 通过 file input 上传图片（自动识别 accept='.jpg,.jpeg,.png,.webp' 的输入框）\n    │\n    ▼\n✏️ 填写标题（定位 placeholder=\"填写标题\" 的 input）\n    │\n    ▼\n📝 填写正文（通过 TipTap/ProseMirror contenteditable 编辑器）\n    │\n    ▼\n🏷️ 添加标签（可选）\n    │\n    ▼\n🚀 点击「发布」按钮\n    │\n    ▼\n✅ 发布成功！\n```\n\n### 关键技术细节\n\n- **Tab 切换**：创作者中心默认选中「上传视频」tab，`publish_image_note()` 会通过 JavaScript 自动 `scrollIntoView` + `click` 切换到「上传图文」tab\n- **File Input 识别**：优先查找 `accept` 属性包含图片格式（`.jpg,.jpeg,.png,.webp`）的 file input，避免误用视频上传入口\n- **富文本编辑器**：正文区域使用 TipTap/ProseMirror 的 `contenteditable` div，通过 `focus` + `insertText` 方式填充内容\n- **Cookie 持久化**：登录后自动保存到 `cookies.json`，下次启动自动加载，免去重复扫码\n\n---\n\n## 安装与配置\n\n### 1. 安装依赖\n\n```bash\n# Clone the repository\ngit clone https://github.com/your-repo/xiaohongshu.git\ncd xiaohongshu\n\n# Create virtual environment (recommended)\npython -m venv .venv\nsource .venv/bin/activate  # macOS/Linux\n# or: .venv\\Scripts\\activate  # Windows\n\n# Install the package\npip install -e .\n\n# Install Playwright browser\nplaywright install chromium\n```\n\n### 2. 配置\n\n```bash\n# Copy the example config\ncp .env.example .env\n\n# Edit .env (optional: cookie will be auto-saved after QR login)\n```\n\n> 💡 **推荐使用二维码登录**：无需手动获取 Cookie，运行 `login_and_publish.py` 即可通过手机扫码自动登录并保存 Cookie。\n\n---\n\n## 使用方法\n\n### 方式一：自然语言交互（Prompt-based）\n\n直接通过对话即可使用，以下是各场景的使用示例：\n\n#### 📝 内容创作\n\n```\n帮我写一篇关于\"春季穿搭\"的小红书笔记，风格要清新自然，适合20-25岁女性用户\n```\n\n```\n我写了一篇关于自制咖啡的笔记，帮我生成5个吸引眼球的标题，要求有emoji\n```\n\n```\n帮我把以下内容改写成3个不同风格的小红书笔记版本（种草风、测评风、教程风）：[你的内容]\n```\n\n#### 📤 发布策略\n\n```\n我的账号主要做美食类内容，粉丝以上班族为主，帮我制定一周的最佳发布时间表\n```\n\n```\n帮我制定一个为期一个月的小红书发布计划，我的赛道是家居好物，目前粉丝500\n```\n\n#### 🔍 搜索分析\n\n```\n分析\"平价护肤\"这个关键词在小红书上的热度和竞争情况，给出长尾关键词建议\n```\n\n```\n帮我分析小红书上做\"极简生活\"赛道的头部博主，总结他们的内容策略\n```\n\n#### 💬 互动评论\n\n```\n有粉丝在我的美食笔记下问\"这个酱料在哪里买的\"，帮我生成一个亲切又有互动感的回复\n```\n\n```\n帮我生成一套小红书私信回复模板，包括：新关注感谢、合作咨询回复、产品问询回复\n```\n\n#### 📊 运营分析\n\n```\n我最近一篇笔记获得了2000赞、500收藏、100评论、5万阅读，帮我分析数据表现和优化方向\n```\n\n```\n我的小红书账号做了3个月，粉丝增长缓慢（800粉），主要做穿搭，帮我诊断并改进\n```\n\n#### 🎯 综合运营\n\n```\n我要发一篇关于\"夏日防晒\"的小红书笔记，请帮我：\n1. 写出正文内容（种草风格）\n2. 生成5个爆款标题\n3. 推荐相关热门标签\n4. 建议最佳发布时间\n5. 写一段互动引导语\n```\n\n---\n\n### 方式二：二维码登录 + 自动发布（一键完成）\n\n```bash\n# Run the login-and-publish example\n.venv/bin/python examples/login_and_publish.py\n```\n\n首次运行会弹出浏览器窗口显示小红书登录二维码，用手机扫码即可。登录成功后：\n- Cookie 自动保存到 `cookies.json`\n- 生成测试图片并自动发布到创作者中心\n- 后续运行自动复用 Cookie，无需再次扫码\n\n---\n\n### 方式三：Python API 调用（自动化操作）\n\n#### 异步 API（推荐）\n\n```python\nimport asyncio\nfrom pathlib import Path\nfrom xiaohongshu.client import XHSClient\nfrom xiaohongshu.config import XHSConfig, BrowserConfig, StorageConfig\n\nasync def main():\n    config = XHSConfig(\n        cookie=\"\",\n        browser=BrowserConfig(browser_type=\"chromium\", headless=False),\n        storage=StorageConfig(\n            cookie_file=Path(\"./cookies.json\"),\n            screenshot_dir=Path(\"./screenshots\"),\n        ),\n    )\n\n    async with XHSClient(config) as client:\n        # 🔐 QR code login (auto-skipped if cookie is valid)\n        is_logged_in = await client.check_login()\n        if not is_logged_in:\n            await client.login_by_qrcode(timeout=120)\n\n        # 🔍 Search notes\n        results = await client.search_notes(\"春季穿搭\", limit=10)\n        for note in results.notes:\n            print(f\"{note.title} - ❤️ {note.liked_count}\")\n\n        # 📄 Get note details\n        note = await client.get_note_detail(\"note_id_here\")\n        print(f\"Title: {note.title}\")\n        print(f\"Content: {note.content}\")\n\n        # 📤 Publish an image note\n        result = await client.publish_image_note(\n            title=\"我的穿搭分享 🌸\",\n            content=\"今天分享一套春日穿搭～\",\n            image_paths=[\"./outfit1.jpg\", \"./outfit2.jpg\"],\n            tags=[\"春季穿搭\", \"OOTD\"],\n        )\n        print(f\"Published: {result.success}\")\n\n        # 🎬 Publish a video note\n        result = await client.publish_video_note(\n            title=\"一分钟学会拉花 ☕\",\n            content=\"超简单的咖啡拉花教程...\",\n            video_path=\"./latte_art.mp4\",\n            tags=[\"咖啡\", \"拉花教程\"],\n        )\n\n        # ❤️ Like a note\n        await client.like_note(\"note_id_here\")\n\n        # ⭐ Collect a note\n        await client.collect_note(\"note_id_here\")\n\n        # 💬 Comment on a note\n        await client.comment_note(\"note_id_here\", \"太好看了！\")\n\n        # 👥 Follow a user\n        await client.follow_user(\"user_id_here\")\n\nasyncio.run(main())\n```\n\n#### 同步 API（更简洁）\n\n```python\nfrom xiaohongshu.api import search, like, comment, publish_image\n\nresults = search(\"春季穿搭\", limit=5)\nlike(\"note_id\")\ncomment(\"note_id\", \"太赞了！\")\npublish_image(\"标题\", \"内容\", [\"img.jpg\"], tags=[\"标签\"])\n```\n\n---\n\n## 项目结构\n\n```\nxiaohongshu/\n├── SKILL.md                   # Skill 定义文件（name/license/description + 完整使用指南）\n├── README.md                  # 项目说明文档\n├── pyproject.toml             # Python 项目配置与依赖\n├── .env.example               # 环境变量配置模板\n├── .gitattributes             # Git 属性配置\n├── .gitignore                 # Git 忽略规则\n├── xiaohongshu/               # Python 核心包\n│   ├── __init__.py            # 包入口与导出\n│   ├── client.py              # XHSClient 浏览器自动化客户端（核心）\n│   ├── api.py                 # 同步 API 便捷函数\n│   ├── config.py              # 配置管理（环境变量加载）\n│   └── models.py              # Pydantic 数据模型定义\n├── examples/\n│   ├── demo.py                # 基础使用示例\n│   └── login_and_publish.py   # 二维码登录 + 自动发布完整示例\n├── cookies.json               # 登录后自动保存的 Cookie（git ignored）\n├── screenshots/               # 每步操作的截图（git ignored）\n└── test_images/               # 自动生成的测试图片（git ignored）\n```\n\n---\n\n## ⚠️ 安全与隐私\n\n> **重要：** 使用本技能前请仔细阅读以下安全提示。\n\n### 🔑 凭据安全\n\n| 敏感文件/变量 | 说明 | 处理建议 |\n|---------------|------|----------|\n| `cookies.json` | 登录后自动保存的会话 Cookie，**等同于账号登录凭据** | 已加入 `.gitignore`，绝不提交到任何仓库 |\n| `.env` 中的 `XHS_COOKIE` | 手动配置的 Cookie 字符串 | 同上，绝不提交 |\n| `.env` 中的 `PROXY_USERNAME` / `PROXY_PASSWORD` | 代理认证凭据 | 仅在信任的代理服务器上使用 |\n\n### 🛡️ 安全建议\n\n1. **先用测试账号**：首次使用建议在一次性/测试账号上验证行为，避免在主账号上产生意外操作\n2. **隔离环境**：在独立的虚拟环境（`python -m venv`）中运行，避免污染系统 Python\n3. **代理风险**：如果配置了 `PROXY_SERVER`，所有流量（包括 Cookie）都会经过该代理，仅使用可信代理\n4. **检查代码**：建议使用前审查 `client.py` 源码，确认自动化行为符合预期\n5. **headless 模式**：二维码登录需要 `headless=False`（显示浏览器界面），确认在安全的桌面环境中运行\n\n### 📋 权限声明\n\n本技能运行时会执行以下操作（均在用户明确调用后触发）：\n\n- 启动 Chromium 浏览器（QR 登录时为非 headless 模式）\n- 读写本地文件：`cookies.json`、`screenshots/`、`downloads/`\n- 在您的小红书账号上执行操作：发布笔记、点赞、评论、收藏、关注\n- 可选：通过配置的代理服务器路由网络流量\n\n### ⚖️ 合规声明\n\n- 请遵守 [小红书社区规范](https://www.xiaohongshu.com/agreement) 和使用条款\n- 本项目仅供学习交流，不鼓励任何违反平台规则的操作\n- 使用自动化工具产生的任何后果由用户自行承担\n\n---\n\n## 其他注意事项\n\n- **二维码有效期**：QR 码约 60 秒过期，超时后会自动刷新（最多等待 120 秒）\n- **频率控制**：默认操作间隔 2-5 秒随机延时，模拟人工操作节奏\n- **截图记录**：每步关键操作会自动截图到 `screenshots/`，方便调试\n\nFile v1.0.2:README.md\n\n# 🌟 xiaohongshu — 小红书全链路运营 Skill\n\n<p align=\"center\">\n  <strong>小红书全链路运营 AI 助手 | Prompt-based + Python 自动化</strong>\n</p>\n\n<p align=\"center\">\n  二维码登录 · 内容创作 · 笔记发布 · 搜索浏览 · 互动评论 · 数据分析\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/PalmPalm7/xiaohongshu-mcp-skill\">Source</a> ·\n  <a href=\"./SKILL.md\">SKILL.md</a> ·\n  <a href=\"#-安全与隐私\">Security</a> ·\n  License: MIT\n</p>\n\n---\n\n## 📖 简介\n\n`xiaohongshu` 是一个小红书全链路运营 AI 技能，提供两大核心能力：\n\n- **🗣️ Prompt-based**：通过自然语言对话获取内容创作、发布策略、运营分析等专业建议\n- **🐍 Python 自动化**：基于 [Playwright](https://playwright.dev/python/) 浏览器自动化，实际执行登录、搜索、发布、互动等操作\n\n**灵感参考：**\n- [xiaohongshu-all-in-one](https://clawhub.ai/richardx0319/xiaohongshu-all-in-one) — 小红书全能助手\n- [xiaohongshu-search-summarizer](https://clawhub.ai/piekill/xiaohongshu-search-summarizer) — 小红书搜索总结工具\n- [xiaohongshu-mcp-skill](https://clawhub.ai/PalmPalm7/xiaohongshu-mcp-skill) — 小红书 MCP Skill\n\n---\n\n## ✨ 功能特性\n\n### 🗣️ Prompt-based 运营支持\n\n| 模块 | 能力 |\n|------|-----|\n| 📝 内容创作 | 爆款标题、正文撰写、标签推荐、多风格改写 |\n| 📤 发布策略 | 最佳发布时间、封面建议、月度内容日历 |\n| 🔍 搜索分析 | 关键词热度、SEO优化、竞品分析 |\n| 💬 互动运营 | 评论回复、互动引导、负面应对、私信模板 |\n| 📊 数据分析 | 数据复盘、增长诊断、爆款分析 |\n| 🎯 综合运营 | 账号定位、品牌合作、矩阵规划 |\n\n### 🐍 Python 自动化操作\n\n| 操作 | 函数 | 说明 |\n|------|------|------|\n| 🔐 二维码登录 | `login_by_qrcode()` | 手机扫码登录，Cookie 自动持久化 |\n| ✅ 登录检测 | `check_login()` | 自动加载已保存 Cookie，检测登录状态 |\n| 🔍 搜索 | `search_notes()` | 关键词搜索，支持排序/筛选 |\n| 📄 详情 | `get_note_detail()` | 获取笔记完整数据 |\n| 📤 发图文 | `publish_image_note()` | 自动切换「上传图文」Tab，上传图片发布笔记 |\n| 🎬 发视频 | `publish_video_note()` | 上传视频发布笔记 |\n| ❤️ 点赞 | `like_note()` | 点赞笔记 |\n| ⭐ 收藏 | `collect_note()` | 收藏笔记 |\n| 💬 评论 | `comment_note()` | 发布评论 |\n| 👥 关注 | `follow_user()` | 关注用户 |\n| 💬 获取评论 | `get_note_comments()` | 获取评论列表 |\n| 👤 用户信息 | `get_user_profile()` | 获取用户资料 |\n\n### 🔄 自动化发布流程\n\n```\n🚀 启动浏览器 → 🍪 加载Cookie → 🔐 检测登录\n    │                                  │\n    │                        未登录 → 📱 扫码登录 → 保存Cookie\n    │                                  │\n    ▼◄─────────────────────────────────┘\n📸 准备图片 → 🌐 打开创作者中心 → 🔄 切换「上传图文」Tab\n    │\n    ▼\n📤 上传图片 → ✏️ 填写标题 → 📝 填写正文 → 🚀 点击发布 → ✅ 完成！\n```\n\n**关键技术点：**\n- 创作者中心默认选中「上传视频」Tab，自动通过 JS `scrollIntoView` + `click` 切换到「上传图文」\n- 优先匹配 `accept='.jpg,.jpeg,.png,.webp'` 的 file input，避免误用视频上传入口\n- 正文区域使用 TipTap/ProseMirror `contenteditable` 编辑器，通过 `focus` + `insertText` 填充\n\n---\n\n## 🚀 快速开始\n\n### 安装\n\n```bash\n# Clone the repository\ngit clone https://github.com/your-repo/xiaohongshu.git\ncd xiaohongshu\n\n# Create virtual environment (recommended)\npython -m venv .venv\nsource .venv/bin/activate  # macOS/Linux\n\n# Install the package\npip install -e .\n\n# Install browser (required for automation)\nplaywright install chromium\n```\n\n### 二维码登录 + 自动发布（一键完成）\n\n```bash\n.venv/bin/python examples/login_and_publish.py\n```\n\n首次运行会弹出浏览器窗口显示小红书登录二维码，用手机扫码即可。登录成功后：\n- 🍪 Cookie 自动保存到 `cookies.json`，后续免扫码\n- 📸 自动生成测试图片并发布到创作者中心\n- 📸 每步操作截图保存到 `screenshots/`\n\n### 配置（可选）\n\n```bash\ncp .env.example .env\n# 编辑 .env 填写 cookie（如果不用二维码登录的话）\n```\n\n> 💡 **推荐使用二维码登录**，无需手动获取 Cookie。\n\n### 使用示例\n\n#### Prompt-based（自然语言）\n\n```\n帮我写一篇关于\"咖啡店探店\"的小红书笔记，包含标题、正文、标签和互动引导语\n```\n\n#### Python API\n\n```python\nimport asyncio\nfrom pathlib import Path\nfrom xiaohongshu.client import XHSClient\nfrom xiaohongshu.config import XHSConfig, BrowserConfig, StorageConfig\n\nasync def main():\n    config = XHSConfig(\n        cookie=\"\",\n        browser=BrowserConfig(browser_type=\"chromium\", headless=False),\n        storage=StorageConfig(cookie_file=Path(\"./cookies.json\")),\n    )\n\n    async with XHSClient(config) as client:\n        # 🔐 QR login (auto-skipped if cookie valid)\n        if not await client.check_login():\n            await client.login_by_qrcode(timeout=120)\n\n        # 🔍 Search\n        results = await client.search_notes(\"春季穿搭\", limit=5)\n        for note in results.notes:\n            print(f\"{note.title} - ❤️ {note.liked_count}\")\n\n        # 📤 Publish\n        await client.publish_image_note(\n            title=\"春日穿搭分享 🌸\",\n            content=\"今天的OOTD～\",\n            image_paths=[\"outfit.jpg\"],\n            tags=[\"穿搭\", \"OOTD\"],\n        )\n\n        # ❤️ Interact\n        await client.like_note(\"note_id\")\n        await client.comment_note(\"note_id\", \"好好看！\")\n        await client.follow_user(\"user_id\")\n\nasyncio.run(main())\n```\n\n#### 同步 API（更简洁）\n\n```python\nfrom xiaohongshu.api import search, like, comment, publish_image\n\nresults = search(\"春季穿搭\", limit=5)\nlike(\"note_id\")\ncomment(\"note_id\", \"太赞了！\")\npublish_image(\"标题\", \"内容\", [\"img.jpg\"], tags=[\"标签\"])\n```\n\n> 📌 完整使用指南请参阅 [SKILL.md](./SKILL.md)\n\n---\n\n## 📁 项目结构\n\n```\nxiaohongshu/\n├── SKILL.md                   # Skill 定义文件（name/license/description + 完整使用指南）\n├── README.md                  # 项目说明文档\n├── pyproject.toml             # Python 项目配置与依赖\n├── .env.example               # 环境变量配置模板\n├── .gitattributes             # Git 属性配置\n├── .gitignore                 # Git 忽略规则\n├── xiaohongshu/               # Python 核心包\n│   ├── __init__.py            # 包入口与导出\n│   ├── client.py              # XHSClient 浏览器自动化客户端（核心）\n│   ├── api.py                 # 同步 API 便捷函数\n│   ├── config.py              # 配置管理（环境变量加载）\n│   └── models.py              # Pydantic 数据模型定义\n├── examples/\n│   ├── demo.py                # 基础使用示例\n│   └── login_and_publish.py   # 二维码登录 + 自动发布完整示例\n├── cookies.json               # 登录后自动保存的 Cookie（git ignored）\n├── screenshots/               # 每步操作的截图（git ignored）\n└── test_images/               # 自动生成的测试图片（git ignored）\n```\n\n---\n\n## 🏗️ 技术栈\n\n| 技术 | 用途 |\n|------|------|\n| [Python 3.10+](https://python.org) | 编程语言 |\n| [Playwright](https://playwright.dev/python/) | 浏览器自动化引擎 |\n| [Pydantic](https://docs.pydantic.dev/) | 数据模型与验证 |\n| [Pillow](https://pillow.readthedocs.io/) | 测试图片生成 |\n| [httpx](https://www.python-httpx.org/) | HTTP 客户端 |\n| [Loguru](https://github.com/Delgan/loguru) | 日志管理 |\n| [python-dotenv](https://github.com/theskumar/python-dotenv) | 环境变量管理 |\n\n---\n\n## ⚠️ 安全与隐私\n\n> ⚠️ **使用前必读** — 本技能会操作您的小红书账号，请务必了解以下安全事项。\n\n### 敏感文件\n\n| 文件/变量 | 风险等级 | 说明 |\n|-----------|---------|------|\n| `cookies.json` | 🔴 高 | 等同于登录凭据，已加入 `.gitignore`，**绝不提交到仓库** |\n| `.env` (`XHS_COOKIE`) | 🔴 高 | Cookie 明文，同上 |\n| `.env` (`PROXY_USERNAME/PASSWORD`) | 🟡 中 | 代理凭据，仅使用可信代理 |\n\n### 安全建议\n\n- 🧪 **首次使用建议在测试账号上验证**，避免在主账号上产生意外操作\n- 🔒 在隔离的虚拟环境中运行（`python -m venv .venv`）\n- 🌐 配置代理时，所有流量（含 Cookie）会经过代理 — 仅信任的代理\n- 🔍 使用前建议审查 [`client.py`](./xiaohongshu/client.py) 源码\n- 📋 请遵守 [小红书社区规范](https://www.xiaohongshu.com/agreement)，本项目仅供学习交流\n\n> 📌 完整的环境变量清单和权限声明请参阅 [SKILL.md](./SKILL.md#-安全与隐私)\n\n---\n\n## 其他注意事项\n\n- **二维码有效期**：QR 码约 60 秒过期，超时后自动刷新（最多等待 120 秒）\n- **频率控制**：默认操作间隔 2-5 秒随机延时，模拟人工操作节奏\n- **截图记录**：每步关键操作自动截图到 `screenshots/`，方便调试\n\n---\n\n## 🔗 相关资源\n\n- [小红书创作者中心](https://creator.xiaohongshu.com/)\n- [小红书社区规范](https://www.xiaohongshu.com/agreement)\n- [xiaohongshu-all-in-one](https://clawhub.ai/richardx0319/xiaohongshu-all-in-one)\n- [xiaohongshu-search-summarizer](https://clawhub.ai/piekill/xiaohongshu-search-summarizer)\n- [xiaohongshu-mcp-skill](https://clawhub.ai/PalmPalm7/xiaohongshu-mcp-skill)\n\n---\n\n## 📄 License\n\nMIT License — 详见 [SKILL.md](./SKILL.md)\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn78mv1912530wvdbf2vjcd3r982v66j\",\n  \"slug\": \"xhs-cn\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1774088330528\n}\n\nFile v1.0.2:pyproject.toml\n\n[project]\nname = \"xiaohongshu-skill\"\nversion = \"1.0.0\"\ndescription = \"Xiaohongshu (Little Red Book) full-pipeline operations skill - search, publish, interact, and analyze.\"\nreadme = \"README.md\"\nlicense = {text = \"MIT\"}\nrequires-python = \">=3.10\"\n\ndependencies = [\n    \"playwright>=1.40.0\",\n    \"httpx>=0.25.0\",\n    \"Pillow>=10.0.0\",\n    \"pydantic>=2.0.0\",\n    \"python-dotenv>=1.0.0\",\n    \"loguru>=0.7.0\",\n]\n\n[project.optional-dependencies]\ndev = [\n    \"pytest>=7.0.0\",\n    \"pytest-asyncio>=0.23.0\",\n    \"ruff>=0.1.0\",\n]\n\n[build-system]\nrequires = [\"setuptools>=68.0\", \"wheel\"]\nbuild-backend = \"setuptools.build_meta\"\n\n[tool.setuptools.packages.find]\ninclude = [\"xiaohongshu*\"]\n\n[tool.ruff]\nline-length = 120\ntarget-version = \"py310\"\n\nArchive v1.0.1: 11 files, 32542 bytes\n\nFiles: examples/demo.py (4032b), examples/login_and_publish.py (8699b), pyproject.toml (734b), README.md (8951b), SKILL.md (11578b), xiaohongshu/__init__.py (323b), xiaohongshu/api.py (6342b), xiaohongshu/client.py (63086b), xiaohongshu/config.py (3411b), xiaohongshu/models.py (4044b), _meta.json (125b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: xiaohongshu\nlicense: MIT\ndescription: |\n  小红书全链路运营技能，提供从内容创作、笔记发布、搜索浏览、互动评论到数据分析的一站式运营支持。\n---\n\n# 🌟 xiaohongshu — 小红书全链路运营 Skill\n\n## 技能概述\n\n`xiaohongshu` 是一个小红书全链路运营 AI 技能，包含两大核心能力：\n\n1. **Prompt-based 内容运营** — 通过自然语言对话，获取专业级的内容创作、发布策略、运营分析建议\n2. **Python 自动化操作** — 基于 Playwright 浏览器自动化，实际执行登录、搜索、发布、互动等平台操作\n\n覆盖小红书平台的 **账号登录 → 内容创作 → 笔记发布 → 搜索浏览 → 互动评论 → 数据分析** 全链路运营场景。\n\n---\n\n## 核心能力\n\n### Prompt-based 能力（自然语言交互）\n\n| 模块 | 能力说明 |\n|------|---------  |\n| 📝 内容创作 | 生成爆款标题、正文、标签，支持多种风格和品类 |\n| 📤 发布策略 | 提供发布策略建议、最佳时间推荐、封面优化建议 |\n| 🔍 搜索分析 | 关键词分析、热门话题追踪、竞品笔记研究、SEO优化 |\n| 💬 互动运营 | 智能评论回复、互动话术生成、粉丝维护策略 |\n| 📊 数据分析 | 数据复盘、内容表现诊断、增长策略建议 |\n\n### Python 自动化能力（实际操作）\n\n| 模块 | 能力说明 | API 函数 |\n|------|---------|----------|\n| 🔐 二维码登录 | 通过扫描二维码完成小红书登录，支持 Cookie 持久化与自动复用 | `login_by_qrcode()` |\n| ✅ 登录检测 | 检查当前是否已登录，自动加载已保存的 Cookie | `check_login()` |\n| 🔍 搜索笔记 | 按关键词搜索，支持排序和类型筛选 | `search_notes()` |\n| 📄 获取详情 | 获取笔记完整信息（标题、正文、图片、视频、标签、数据） | `get_note_detail()` |\n| 📤 发布图文 | 自动切换到「上传图文」tab，上传图片并填写标题/正文/标签发布 | `publish_image_note()` |\n| 🎬 发布视频 | 上传视频并发布笔记 | `publish_video_note()` |\n| ❤️ 点赞 | 对笔记进行点赞操作 | `like_note()` |\n| ⭐ 收藏 | 对笔记进行收藏/取消收藏 | `collect_note()` |\n| 💬 评论 | 在笔记下发布评论 | `comment_note()` |\n| 👥 关注 | 关注指定用户 | `follow_user()` |\n| 💬 获取评论 | 获取笔记的评论列表 | `get_note_comments()` |\n| 👤 用户信息 | 获取用户主页信息 | `get_user_profile()` |\n\n---\n\n## 自动化发布流程\n\n二维码登录 + 图文发布的完整自动化流程如下：\n\n```\n🚀 启动浏览器 (headless=False)\n    │\n    ▼\n🍪 加载 cookies.json（若存在）\n    │\n    ▼\n🔐 检查登录状态 ──── 未登录 ──→ 📱 显示二维码（手机扫码，最长120秒）\n    │                                      │\n  已登录                               扫码成功 → 保存 Cookie\n    │                                      │\n    ▼◄─────────────────────────────────────┘\n📸 生成/准备待发布图片\n    │\n    ▼\n🌐 打开创作者中心 (creator.xiaohongshu.com/publish/publish)\n    │\n    ▼\n🔄 自动切换到「上传图文」Tab（默认页面是「上传视频」Tab）\n    │\n    ▼\n📤 通过 file input 上传图片（自动识别 accept='.jpg,.jpeg,.png,.webp' 的输入框）\n    │\n    ▼\n✏️ 填写标题（定位 placeholder=\"填写标题\" 的 input）\n    │\n    ▼\n📝 填写正文（通过 TipTap/ProseMirror contenteditable 编辑器）\n    │\n    ▼\n🏷️ 添加标签（可选）\n    │\n    ▼\n🚀 点击「发布」按钮\n    │\n    ▼\n✅ 发布成功！\n```\n\n### 关键技术细节\n\n- **Tab 切换**：创作者中心默认选中「上传视频」tab，`publish_image_note()` 会通过 JavaScript 自动 `scrollIntoView` + `click` 切换到「上传图文」tab\n- **File Input 识别**：优先查找 `accept` 属性包含图片格式（`.jpg,.jpeg,.png,.webp`）的 file input，避免误用视频上传入口\n- **富文本编辑器**：正文区域使用 TipTap/ProseMirror 的 `contenteditable` div，通过 `focus` + `insertText` 方式填充内容\n- **Cookie 持久化**：登录后自动保存到 `cookies.json`，下次启动自动加载，免去重复扫码\n\n---\n\n## 安装与配置\n\n### 1. 安装依赖\n\n```bash\n# Clone the repository\ngit clone https://github.com/your-repo/xiaohongshu.git\ncd xiaohongshu\n\n# Create virtual environment (recommended)\npython -m venv .venv\nsource .venv/bin/activate  # macOS/Linux\n# or: .venv\\Scripts\\activate  # Windows\n\n# Install the package\npip install -e .\n\n# Install Playwright browser\nplaywright install chromium\n```\n\n### 2. 配置\n\n```bash\n# Copy the example config\ncp .env.example .env\n\n# Edit .env (optional: cookie will be auto-saved after QR login)\n```\n\n> 💡 **推荐使用二维码登录**：无需手动获取 Cookie，运行 `login_and_publish.py` 即可通过手机扫码自动登录并保存 Cookie。\n\n---\n\n## 使用方法\n\n### 方式一：自然语言交互（Prompt-based）\n\n直接通过对话即可使用，以下是各场景的使用示例：\n\n#### 📝 内容创作\n\n```\n帮我写一篇关于\"春季穿搭\"的小红书笔记，风格要清新自然，适合20-25岁女性用户\n```\n\n```\n我写了一篇关于自制咖啡的笔记，帮我生成5个吸引眼球的标题，要求有emoji\n```\n\n```\n帮我把以下内容改写成3个不同风格的小红书笔记版本（种草风、测评风、教程风）：[你的内容]\n```\n\n#### 📤 发布策略\n\n```\n我的账号主要做美食类内容，粉丝以上班族为主，帮我制定一周的最佳发布时间表\n```\n\n```\n帮我制定一个为期一个月的小红书发布计划，我的赛道是家居好物，目前粉丝500\n```\n\n#### 🔍 搜索分析\n\n```\n分析\"平价护肤\"这个关键词在小红书上的热度和竞争情况，给出长尾关键词建议\n```\n\n```\n帮我分析小红书上做\"极简生活\"赛道的头部博主，总结他们的内容策略\n```\n\n#### 💬 互动评论\n\n```\n有粉丝在我的美食笔记下问\"这个酱料在哪里买的\"，帮我生成一个亲切又有互动感的回复\n```\n\n```\n帮我生成一套小红书私信回复模板，包括：新关注感谢、合作咨询回复、产品问询回复\n```\n\n#### 📊 运营分析\n\n```\n我最近一篇笔记获得了2000赞、500收藏、100评论、5万阅读，帮我分析数据表现和优化方向\n```\n\n```\n我的小红书账号做了3个月，粉丝增长缓慢（800粉），主要做穿搭，帮我诊断并改进\n```\n\n#### 🎯 综合运营\n\n```\n我要发一篇关于\"夏日防晒\"的小红书笔记，请帮我：\n1. 写出正文内容（种草风格）\n2. 生成5个爆款标题\n3. 推荐相关热门标签\n4. 建议最佳发布时间\n5. 写一段互动引导语\n```\n\n---\n\n### 方式二：二维码登录 + 自动发布（一键完成）\n\n```bash\n# Run the login-and-publish example\n.venv/bin/python examples/login_and_publish.py\n```\n\n首次运行会弹出浏览器窗口显示小红书登录二维码，用手机扫码即可。登录成功后：\n- Cookie 自动保存到 `cookies.json`\n- 生成测试图片并自动发布到创作者中心\n- 后续运行自动复用 Cookie，无需再次扫码\n\n---\n\n### 方式三：Python API 调用（自动化操作）\n\n#### 异步 API（推荐）\n\n```python\nimport asyncio\nfrom pathlib import Path\nfrom xiaohongshu.client import XHSClient\nfrom xiaohongshu.config import XHSConfig, BrowserConfig, StorageConfig\n\nasync def main():\n    config = XHSConfig(\n        cookie=\"\",\n        browser=BrowserConfig(browser_type=\"chromium\", headless=False),\n        storage=StorageConfig(\n            cookie_file=Path(\"./cookies.json\"),\n            screenshot_dir=Path(\"./screenshots\"),\n        ),\n    )\n\n    async with XHSClient(config) as client:\n        # 🔐 QR code login (auto-skipped if cookie is valid)\n        is_logged_in = await client.check_login()\n        if not is_logged_in:\n            await client.login_by_qrcode(timeout=120)\n\n        # 🔍 Search notes\n        results = await client.search_notes(\"春季穿搭\", limit=10)\n        for note in results.notes:\n            print(f\"{note.title} - ❤️ {note.liked_count}\")\n\n        # 📄 Get note details\n        note = await client.get_note_detail(\"note_id_here\")\n        print(f\"Title: {note.title}\")\n        print(f\"Content: {note.content}\")\n\n        # 📤 Publish an image note\n        result = await client.publish_image_note(\n            title=\"我的穿搭分享 🌸\",\n            content=\"今天分享一套春日穿搭～\",\n            image_paths=[\"./outfit1.jpg\", \"./outfit2.jpg\"],\n            tags=[\"春季穿搭\", \"OOTD\"],\n        )\n        print(f\"Published: {result.success}\")\n\n        # 🎬 Publish a video note\n        result = await client.publish_video_note(\n            title=\"一分钟学会拉花 ☕\",\n            content=\"超简单的咖啡拉花教程...\",\n            video_path=\"./latte_art.mp4\",\n            tags=[\"咖啡\", \"拉花教程\"],\n        )\n\n        # ❤️ Like a note\n        await client.like_note(\"note_id_here\")\n\n        # ⭐ Collect a note\n        await client.collect_note(\"note_id_here\")\n\n        # 💬 Comment on a note\n        await client.comment_note(\"note_id_here\", \"太好看了！\")\n\n        # 👥 Follow a user\n        await client.follow_user(\"user_id_here\")\n\nasyncio.run(main())\n```\n\n#### 同步 API（更简洁）\n\n```python\nfrom xiaohongshu.api import search, like, comment, publish_image\n\nresults = search(\"春季穿搭\", limit=5)\nlike(\"note_id\")\ncomment(\"note_id\", \"太赞了！\")\npublish_image(\"标题\", \"内容\", [\"img.jpg\"], tags=[\"标签\"])\n```\n\n---\n\n## 项目结构\n\n```\nxiaohongshu/\n├── SKILL.md                   # Skill 定义文件（name/license/description + 完整使用指南）\n├── README.md                  # 项目说明文档\n├── pyproject.toml             # Python 项目配置与依赖\n├── .env.example               # 环境变量配置模板\n├── .gitattributes             # Git 属性配置\n├── .gitignore                 # Git 忽略规则\n├── xiaohongshu/               # Python 核心包\n│   ├── __init__.py            # 包入口与导出\n│   ├── client.py              # XHSClient 浏览器自动化客户端（核心）\n│   ├── api.py                 # 同步 API 便捷函数\n│   ├── config.py              # 配置管理（环境变量加载）\n│   └── models.py              # Pydantic 数据模型定义\n├── examples/\n│   ├── demo.py                # 基础使用示例\n│   └── login_and_publish.py   # 二维码登录 + 自动发布完整示例\n├── cookies.json               # 登录后自动保存的 Cookie（git ignored）\n├── screenshots/               # 每步操作的截图（git ignored）\n└── test_images/               # 自动生成的测试图片（git ignored）\n```\n\n---\n\n## 注意事项\n\n- **Cookie 安全**：`cookies.json` 已加入 `.gitignore`，请勿提交到公开仓库\n- **二维码有效期**：QR 码约 60 秒过期，超时后会自动刷新（最多等待 120 秒）\n- **频率控制**：默认操作间隔 2-5 秒随机延时，模拟人工操作节奏\n- **截图记录**：每步关键操作会自动截图到 `screenshots/`，方便调试\n- **合规使用**：请遵守小红书社区规范和使用条款\n- **仅供学习**：本项目仅供学习交流，不鼓励任何违规操作\n\nFile v1.0.1:README.md\n\n# 🌟 xiaohongshu — 小红书全链路运营 Skill\n\n<p align=\"center\">\n  <strong>小红书全链路运营 AI 助手 | Prompt-based + Python 自动化</strong>\n</p>\n\n<p align=\"center\">\n  二维码登录 · 内容创作 · 笔记发布 · 搜索浏览 · 互动评论 · 数据分析\n</p>\n\n---\n\n## 📖 简介\n\n`xiaohongshu` 是一个小红书全链路运营 AI 技能，提供两大核心能力：\n\n- **🗣️ Prompt-based**：通过自然语言对话获取内容创作、发布策略、运营分析等专业建议\n- **🐍 Python 自动化**：基于 [Playwright](https://playwright.dev/python/) 浏览器自动化，实际执行登录、搜索、发布、互动等操作\n\n**灵感参考：**\n- [xiaohongshu-all-in-one](https://clawhub.ai/richardx0319/xiaohongshu-all-in-one) — 小红书全能助手\n- [xiaohongshu-search-summarizer](https://clawhub.ai/piekill/xiaohongshu-search-summarizer) — 小红书搜索总结工具\n- [xiaohongshu-mcp-skill](https://clawhub.ai/PalmPalm7/xiaohongshu-mcp-skill) — 小红书 MCP Skill\n\n---\n\n## ✨ 功能特性\n\n### 🗣️ Prompt-based 运营支持\n\n| 模块 | 能力 |\n|------|-----|\n| 📝 内容创作 | 爆款标题、正文撰写、标签推荐、多风格改写 |\n| 📤 发布策略 | 最佳发布时间、封面建议、月度内容日历 |\n| 🔍 搜索分析 | 关键词热度、SEO优化、竞品分析 |\n| 💬 互动运营 | 评论回复、互动引导、负面应对、私信模板 |\n| 📊 数据分析 | 数据复盘、增长诊断、爆款分析 |\n| 🎯 综合运营 | 账号定位、品牌合作、矩阵规划 |\n\n### 🐍 Python 自动化操作\n\n| 操作 | 函数 | 说明 |\n|------|------|------|\n| 🔐 二维码登录 | `login_by_qrcode()` | 手机扫码登录，Cookie 自动持久化 |\n| ✅ 登录检测 | `check_login()` | 自动加载已保存 Cookie，检测登录状态 |\n| 🔍 搜索 | `search_notes()` | 关键词搜索，支持排序/筛选 |\n| 📄 详情 | `get_note_detail()` | 获取笔记完整数据 |\n| 📤 发图文 | `publish_image_note()` | 自动切换「上传图文」Tab，上传图片发布笔记 |\n| 🎬 发视频 | `publish_video_note()` | 上传视频发布笔记 |\n| ❤️ 点赞 | `like_note()` | 点赞笔记 |\n| ⭐ 收藏 | `collect_note()` | 收藏笔记 |\n| 💬 评论 | `comment_note()` | 发布评论 |\n| 👥 关注 | `follow_user()` | 关注用户 |\n| 💬 获取评论 | `get_note_comments()` | 获取评论列表 |\n| 👤 用户信息 | `get_user_profile()` | 获取用户资料 |\n\n### 🔄 自动化发布流程\n\n```\n🚀 启动浏览器 → 🍪 加载Cookie → 🔐 检测登录\n    │                                  │\n    │                        未登录 → 📱 扫码登录 → 保存Cookie\n    │                                  │\n    ▼◄─────────────────────────────────┘\n📸 准备图片 → 🌐 打开创作者中心 → 🔄 切换「上传图文」Tab\n    │\n    ▼\n📤 上传图片 → ✏️ 填写标题 → 📝 填写正文 → 🚀 点击发布 → ✅ 完成！\n```\n\n**关键技术点：**\n- 创作者中心默认选中「上传视频」Tab，自动通过 JS `scrollIntoView` + `click` 切换到「上传图文」\n- 优先匹配 `accept='.jpg,.jpeg,.png,.webp'` 的 file input，避免误用视频上传入口\n- 正文区域使用 TipTap/ProseMirror `contenteditable` 编辑器，通过 `focus` + `insertText` 填充\n\n---\n\n## 🚀 快速开始\n\n### 安装\n\n```bash\n# Clone the repository\ngit clone https://github.com/your-repo/xiaohongshu.git\ncd xiaohongshu\n\n# Create virtual environment (recommended)\npython -m venv .venv\nsource .venv/bin/activate  # macOS/Linux\n\n# Install the package\npip install -e .\n\n# Install browser (required for automation)\nplaywright install chromium\n```\n\n### 二维码登录 + 自动发布（一键完成）\n\n```bash\n.venv/bin/python examples/login_and_publish.py\n```\n\n首次运行会弹出浏览器窗口显示小红书登录二维码，用手机扫码即可。登录成功后：\n- 🍪 Cookie 自动保存到 `cookies.json`，后续免扫码\n- 📸 自动生成测试图片并发布到创作者中心\n- 📸 每步操作截图保存到 `screenshots/`\n\n### 配置（可选）\n\n```bash\ncp .env.example .env\n# 编辑 .env 填写 cookie（如果不用二维码登录的话）\n```\n\n> 💡 **推荐使用二维码登录**，无需手动获取 Cookie。\n\n### 使用示例\n\n#### Prompt-based（自然语言）\n\n```\n帮我写一篇关于\"咖啡店探店\"的小红书笔记，包含标题、正文、标签和互动引导语\n```\n\n#### Python API\n\n```python\nimport asyncio\nfrom pathlib import Path\nfrom xiaohongshu.client import XHSClient\nfrom xiaohongshu.config import XHSConfig, BrowserConfig, StorageConfig\n\nasync def main():\n    config = XHSConfig(\n        cookie=\"\",\n        browser=BrowserConfig(browser_type=\"chromium\", headless=False),\n        storage=StorageConfig(cookie_file=Path(\"./cookies.json\")),\n    )\n\n    async with XHSClient(config) as client:\n        # 🔐 QR login (auto-skipped if cookie valid)\n        if not await client.check_login():\n            await client.login_by_qrcode(timeout=120)\n\n        # 🔍 Search\n        results = await client.search_notes(\"春季穿搭\", limit=5)\n        for note in results.notes:\n            print(f\"{note.title} - ❤️ {note.liked_count}\")\n\n        # 📤 Publish\n        await client.publish_image_note(\n            title=\"春日穿搭分享 🌸\",\n            content=\"今天的OOTD～\",\n            image_paths=[\"outfit.jpg\"],\n            tags=[\"穿搭\", \"OOTD\"],\n        )\n\n        # ❤️ Interact\n        await client.like_note(\"note_id\")\n        await client.comment_note(\"note_id\", \"好好看！\")\n        await client.follow_user(\"user_id\")\n\nasyncio.run(main())\n```\n\n#### 同步 API（更简洁）\n\n```python\nfrom xiaohongshu.api import search, like, comment, publish_image\n\nresults = search(\"春季穿搭\", limit=5)\nlike(\"note_id\")\ncomment(\"note_id\", \"太赞了！\")\npublish_image(\"标题\", \"内容\", [\"img.jpg\"], tags=[\"标签\"])\n```\n\n> 📌 完整使用指南请参阅 [SKILL.md](./SKILL.md)\n\n---\n\n## 📁 项目结构\n\n```\nxiaohongshu/\n├── SKILL.md                   # Skill 定义文件（name/license/description + 完整使用指南）\n├── README.md                  # 项目说明文档\n├── pyproject.toml             # Python 项目配置与依赖\n├── .env.example               # 环境变量配置模板\n├── .gitattributes             # Git 属性配置\n├── .gitignore                 # Git 忽略规则\n├── xiaohongshu/               # Python 核心包\n│   ├── __init__.py            # 包入口与导出\n│   ├── client.py              # XHSClient 浏览器自动化客户端（核心）\n│   ├── api.py                 # 同步 API 便捷函数\n│   ├── config.py              # 配置管理（环境变量加载）\n│   └── models.py              # Pydantic 数据模型定义\n├── examples/\n│   ├── demo.py                # 基础使用示例\n│   └── login_and_publish.py   # 二维码登录 + 自动发布完整示例\n├── cookies.json               # 登录后自动保存的 Cookie（git ignored）\n├── screenshots/               # 每步操作的截图（git ignored）\n└── test_images/               # 自动生成的测试图片（git ignored）\n```\n\n---\n\n## 🏗️ 技术栈\n\n| 技术 | 用途 |\n|------|------|\n| [Python 3.10+](https://python.org) | 编程语言 |\n| [Playwright](https://playwright.dev/python/) | 浏览器自动化引擎 |\n| [Pydantic](https://docs.pydantic.dev/) | 数据模型与验证 |\n| [Pillow](https://pillow.readthedocs.io/) | 测试图片生成 |\n| [httpx](https://www.python-httpx.org/) | HTTP 客户端 |\n| [Loguru](https://github.com/Delgan/loguru) | 日志管理 |\n| [python-dotenv](https://github.com/theskumar/python-dotenv) | 环境变量管理 |\n\n---\n\n## ⚠️ 注意事项\n\n- **Cookie 安全**：`cookies.json` 已加入 `.gitignore`，请勿提交到公开仓库\n- **二维码有效期**：QR 码约 60 秒过期，超时后自动刷新（最多等待 120 秒）\n- **频率控制**：默认操作间隔 2-5 秒随机延时，模拟人工操作节奏\n- **截图记录**：每步关键操作自动截图到 `screenshots/`，方便调试\n- **合规使用**：请遵守小红书社区规范和使用条款\n- **仅供学习**：本项目仅供学习交流，不鼓励违规操作\n\n---\n\n## 🔗 相关资源\n\n- [小红书创作者中心](https://creator.xiaohongshu.com/)\n- [小红书社区规范](https://www.xiaohongshu.com/agreement)\n- [xiaohongshu-all-in-one](https://clawhub.ai/richardx0319/xiaohongshu-all-in-one)\n- [xiaohongshu-search-summarizer](https://clawhub.ai/piekill/xiaohongshu-search-summarizer)\n- [xiaohongshu-mcp-skill](https://clawhub.ai/PalmPalm7/xiaohongshu-mcp-skill)\n\n---\n\n## 📄 License\n\nMIT License — 详见 [SKILL.md](./SKILL.md)\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn78mv1912530wvdbf2vjcd3r982v66j\",\n  \"slug\": \"xhs-cn\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1774022179101\n}\n\nFile v1.0.1:pyproject.toml\n\n[project]\nname = \"xiaohongshu-skill\"\nversion = \"1.0.0\"\ndescription = \"Xiaohongshu (Little Red Book) full-pipeline operations skill - search, publish, interact, and analyze.\"\nreadme = \"README.md\"\nlicense = {text = \"MIT\"}\nrequires-python = \">=3.10\"\n\ndependencies = [\n    \"playwright>=1.40.0\",\n    \"httpx>=0.25.0\",\n    \"Pillow>=10.0.0\",\n    \"pydantic>=2.0.0\",\n    \"python-dotenv>=1.0.0\",\n    \"loguru>=0.7.0\",\n]\n\n[project.optional-dependencies]\ndev = [\n    \"pytest>=7.0.0\",\n    \"pytest-asyncio>=0.23.0\",\n    \"ruff>=0.1.0\",\n]\n\n[build-system]\nrequires = [\"setuptools>=68.0\", \"wheel\"]\nbuild-backend = \"setuptools.build_meta\"\n\n[tool.setuptools.packages.find]\ninclude = [\"xiaohongshu*\"]\n\n[tool.ruff]\nline-length = 120\ntarget-version = \"py310\"\n\nArchive v1.0.9: 3 files, 4896 bytes\n\nFiles: README.md (3407b), SKILL.md (5581b), _meta.json (125b)\n\nFile v1.0.9:SKILL.md\n\n---\nname: xiaohongshu\nlicense: MIT\ndescription: |\n  小红书全链路运营技能，提供从内容创作、笔记发布、搜索浏览、互动评论到数据分析的一站式运营支持。\n---\n\n# 🌟 xiaohongshu — 小红书全链路运营 Skill\n\n## 技能概述\n\n`xiaohongshu` 是一个基于自然语言提示（Prompt-based）的 AI 运营技能，覆盖小红书平台的 **内容创作 → 笔记发布 → 搜索浏览 → 互动评论 → 数据分析** 全链路运营场景。\n\n用户无需编写代码或调用 API，只需用自然语言描述需求，即可获得专业级的小红书运营支持。\n\n---\n\n## 核心能力\n\n| 模块 | 能力说明 |\n|------|---------|\n| 📝 内容创作 | 生成爆款标题、正文、标签，支持多种风格和品类 |\n| 📤 笔记发布 | 提供发布策略建议、最佳时间推荐、封面优化建议 |\n| 🔍 搜索浏览 | 关键词分析、热门话题追踪、竞品笔记研究 |\n| 💬 互动评论 | 智能评论回复、互动话术生成、粉丝维护策略 |\n| 📊 运营分析 | 数据复盘、内容表现诊断、增长策略建议 |\n\n---\n\n## 使用方法\n\n本技能为 **Prompt-based skill**，通过自然语言与 AI 对话即可使用。以下是各场景的使用示例：\n\n### 1. 📝 内容创作\n\n**生成爆款笔记：**\n```\n帮我写一篇关于\"春季穿搭\"的小红书笔记，风格要清新自然，适合20-25岁女性用户\n```\n\n**优化标题：**\n```\n我写了一篇关于自制咖啡的笔记，帮我生成5个吸引眼球的标题，要求有emoji\n```\n\n**生成标签/话题：**\n```\n我要发一篇关于\"居家健身\"的笔记，帮我推荐相关的热门标签和话题\n```\n\n**生成多风格版本：**\n```\n帮我把以下内容改写成3个不同风格的小红书笔记版本（种草风、测评风、教程风）：[粘贴你的内容]\n```\n\n### 2. 📤 笔记发布策略\n\n**发布时间建议：**\n```\n我的账号主要做美食类内容，粉丝以上班族为主，帮我制定一周的最佳发布时间表\n```\n\n**封面优化建议：**\n```\n我要发布一篇护肤品测评笔记，帮我分析什么样的封面图更容易获得高点击率\n```\n\n**发布计划制定：**\n```\n帮我制定一个为期一个月的小红书发布计划，我的赛道是家居好物，目前粉丝500\n```\n\n### 3. 🔍 搜索与浏览分析\n\n**关键词分析：**\n```\n分析\"平价护肤\"这个关键词在小红书上的热度和竞争情况，给出长尾关键词建议\n```\n\n**热门话题追踪：**\n```\n最近小红书上有哪些热门的穿搭趋势？帮我分析可以蹭的热点话题\n```\n\n**竞品分析：**\n```\n帮我分析小红书上做\"极简生活\"赛道的头部博主，总结他们的内容策略\n```\n\n**搜索优化（SEO）：**\n```\n我的笔记标题是\"我的通勤包分享\"，帮我优化标题和正文关键词，提升搜索排名\n```\n\n### 4. 💬 互动评论\n\n**评论回复生成：**\n```\n有粉丝在我的美食笔记下问\"这个酱料在哪里买的\"，帮我生成一个亲切又有互动感的回复\n```\n\n**引导互动话术：**\n```\n帮我写一段放在笔记末尾的互动引导语，鼓励粉丝评论和收藏，主题是旅行攻略\n```\n\n**负面评论应对：**\n```\n有人在评论区说\"这个产品根本没用\"，帮我生成一个得体的回复，既能化解负面情绪又能维护品牌形象\n```\n\n**粉丝私信回复模板：**\n```\n帮我生成一套小红书私信回复模板，包括：新关注感谢、合作咨询回复、产品问询回复\n```\n\n### 5. 📊 运营数据分析\n\n**笔记数据复盘：**\n```\n我最近一篇笔记获得了2000赞、500收藏、100评论、5万阅读，帮我分析这个数据表现如何，有哪些可以优化的地方\n```\n\n**账号诊断：**\n```\n我的小红书账号做了3个月，粉丝增长缓慢（目前800粉），主要做穿搭内容，帮我诊断可能的问题并给出改进建议\n```\n\n**增长策略：**\n```\n帮我制定一个从0到1万粉丝的小红书增长计划，我的赛道是健康饮食\n```\n\n**爆款内容分析：**\n```\n帮我总结小红书上爆款笔记的共同特征，我想了解什么样的内容更容易火\n```\n\n### 6. 🎯 综合运营\n\n**账号定位：**\n```\n我想开始做小红书，对美妆和穿搭都感兴趣，帮我分析应该选择哪个赛道，并给出账号定位建议\n```\n\n**品牌合作准备：**\n```\n我有3000粉丝，想开始接品牌合作，帮我准备一份媒体合作简介（media kit）的内容框架\n```\n\n**矩阵运营建议：**\n```\n我想做小红书账号矩阵，主账号是美妆测评，帮我规划2-3个子账号的定位和内容策略\n```\n\n---\n\n## 进阶用法\n\n### 组合使用多个能力\n\n你可以在一次对话中组合使用多个能力，例如：\n\n```\n我要发一篇关于\"夏日防晒\"的小红书笔记，请帮我：\n1. 写出正文内容（种草风格）\n2. 生成5个爆款标题\n3. 推荐相关热门标签\n4. 建议最佳发布时间\n5. 写一段互动引导语\n```\n\n### 指定输出格式\n\n```\n用表格形式帮我对比分析5个防晒霜产品的小红书种草文案要点\n```\n\n### 持续优化\n\n```\n根据我上一篇笔记的数据反馈，帮我调整下一篇笔记的内容方向和写作策略\n```\n\n---\n\n## 注意事项\n\n- 本技能提供的是运营建议和内容辅助，不直接操作小红书平台\n- 生成的内容建议根据自身品牌调性和实际情况进行调整\n- 数据分析基于用户提供的数据，分析结果仅供参考\n- 请遵守小红书社区规范，避免违规内容\n- 建议结合实际运营经验灵活运用 AI 建议\n\nFile v1.0.9:README.md\n\n# 🌟 xiaohongshu — 小红书全链路运营 Skill\n\n<p align=\"center\">\n  <strong>小红书全链路运营 AI 助手 | Prompt-based Skill</strong>\n</p>\n\n<p align=\"center\">\n  内容创作 · 笔记发布 · 搜索浏览 · 互动评论 · 数据分析\n</p>\n\n---\n\n## 📖 简介\n\n`xiaohongshu` 是一个基于自然语言提示（Prompt-based）的 AI 技能，为小红书运营者提供从内容创作到数据分析的全链路支持。无需编写代码，只需用日常对话即可获得专业级运营辅助。\n\n**灵感参考：**\n- [xiaohongshu-all-in-one](https://clawhub.ai/richardx0319/xiaohongshu-all-in-one) — 小红书全能助手\n- [xiaohongshu-search-summarizer](https://clawhub.ai/piekill/xiaohongshu-search-summarizer) — 小红书搜索总结工具\n\n---\n\n## ✨ 功能特性\n\n### 📝 内容创作\n- 爆款标题生成（支持多种风格）\n- 笔记正文撰写（种草 / 测评 / 教程 / 日常分享等）\n- 热门标签与话题推荐\n- 多版本内容改写\n- 封面文案建议\n\n### 📤 笔记发布\n- 最佳发布时间推荐\n- 封面图风格建议\n- 发布频率与节奏规划\n- 月度/周度内容日历制定\n\n### 🔍 搜索浏览\n- 关键词热度与竞争分析\n- 长尾关键词挖掘\n- 热门话题与趋势追踪\n- 竞品博主内容策略分析\n- 笔记 SEO 优化建议\n\n### 💬 互动评论\n- 智能评论回复生成\n- 互动引导话术设计\n- 负面评论应对策略\n- 粉丝私信回复模板\n- 社群运营话术\n\n### 📊 运营分析\n- 笔记数据表现诊断\n- 账号增长瓶颈分析\n- 爆款内容特征总结\n- 增长策略制定\n- ROI 与投放效果分析\n\n### 🎯 综合运营\n- 账号定位与赛道选择\n- 品牌合作准备（Media Kit）\n- 矩阵账号规划\n- 变现路径设计\n\n---\n\n## 🚀 快速开始\n\n### 使用方式\n\n本技能为 **Prompt-based skill**，直接通过自然语言对话使用即可。\n\n#### 示例 1：一键生成完整笔记\n\n```\n帮我写一篇关于\"咖啡店探店\"的小红书笔记，要求：\n- 风格：文艺清新\n- 目标人群：20-30岁都市白领\n- 包含：标题、正文、标签、互动引导语\n```\n\n#### 示例 2：运营策略咨询\n\n```\n我的小红书账号做了2个月，粉丝300，做的是家居好物赛道。\n请帮我分析账号现状，并制定下个月的运营计划。\n```\n\n#### 示例 3：数据复盘分析\n\n```\n我最近5篇笔记的数据如下：\n1. 阅读3000/点赞200/收藏50/评论10\n2. 阅读8000/点赞1000/收藏300/评论80\n3. 阅读1500/点赞80/收藏20/评论5\n4. 阅读5000/点赞500/收藏150/评论30\n5. 阅读2000/点赞100/收藏40/评论8\n\n帮我分析哪篇表现最好，为什么，以及后续内容方向建议。\n```\n\n> 📌 更多使用方法和完整示例请参阅 [SKILL.md](./SKILL.md)\n\n---\n\n## 📁 项目结构\n\n```\nxiaohongshu/\n├── SKILL.md          # 技能定义文件（name、license、description + 完整使用指南）\n├── README.md         # 项目说明文档\n└── .gitattributes    # Git 属性配置\n```\n\n---\n\n## 🔗 相关资源\n\n- [小红书创作者中心](https://creator.xiaohongshu.com/)\n- [小红书社区规范](https://www.xiaohongshu.com/agreement)\n- [xiaohongshu-all-in-one](https://clawhub.ai/richardx0319/xiaohongshu-all-in-one)\n- [xiaohongshu-search-summarizer](https://clawhub.ai/piekill/xiaohongshu-search-summarizer)\n\n---\n\n## 📄 License\n\nMIT License — 详见 [SKILL.md](./SKILL.md)\n\nFile v1.0.9:_meta.json\n\n{\n  \"ownerId\": \"kn78mv1912530wvdbf2vjcd3r982v66j\",\n  \"slug\": \"xhs-cn\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1773935492556\n}\n\nArchive v1.0.8: 3 files, 4946 bytes\n\nFiles: README.md (3407b), SKILL.md (5697b), _meta.json (125b)\n\nFile v1.0.8:SKILL.md\n\n---\nname: xiaohongshu\nlicense: MIT\ndescription: |\n  小红书全链路运营技能 —— 提供从内容创作、笔记发布、搜索浏览、互动评论到数据分析的一站式运营支持。\n  支持自然语言交互，用户只需用日常对话即可完成小红书平台的全流程运营任务。\n---\n\n# 🌟 xiaohongshu — 小红书全链路运营 Skill\n\n## 技能概述\n\n`xiaohongshu` 是一个基于自然语言提示（Prompt-based）的 AI 运营技能，覆盖小红书平台的 **内容创作 → 笔记发布 → 搜索浏览 → 互动评论 → 数据分析** 全链路运营场景。\n\n用户无需编写代码或调用 API，只需用自然语言描述需求，即可获得专业级的小红书运营支持。\n\n---\n\n## 核心能力\n\n| 模块 | 能力说明 |\n|------|---------|\n| 📝 内容创作 | 生成爆款标题、正文、标签，支持多种风格和品类 |\n| 📤 笔记发布 | 提供发布策略建议、最佳时间推荐、封面优化建议 |\n| 🔍 搜索浏览 | 关键词分析、热门话题追踪、竞品笔记研究 |\n| 💬 互动评论 | 智能评论回复、互动话术生成、粉丝维护策略 |\n| 📊 运营分析 | 数据复盘、内容表现诊断、增长策略建议 |\n\n---\n\n## 使用方法\n\n本技能为 **Prompt-based skill**，通过自然语言与 AI 对话即可使用。以下是各场景的使用示例：\n\n### 1. 📝 内容创作\n\n**生成爆款笔记：**\n```\n帮我写一篇关于\"春季穿搭\"的小红书笔记，风格要清新自然，适合20-25岁女性用户\n```\n\n**优化标题：**\n```\n我写了一篇关于自制咖啡的笔记，帮我生成5个吸引眼球的标题，要求有emoji\n```\n\n**生成标签/话题：**\n```\n我要发一篇关于\"居家健身\"的笔记，帮我推荐相关的热门标签和话题\n```\n\n**生成多风格版本：**\n```\n帮我把以下内容改写成3个不同风格的小红书笔记版本（种草风、测评风、教程风）：[粘贴你的内容]\n```\n\n### 2. 📤 笔记发布策略\n\n**发布时间建议：**\n```\n我的账号主要做美食类内容，粉丝以上班族为主，帮我制定一周的最佳发布时间表\n```\n\n**封面优化建议：**\n```\n我要发布一篇护肤品测评笔记，帮我分析什么样的封面图更容易获得高点击率\n```\n\n**发布计划制定：**\n```\n帮我制定一个为期一个月的小红书发布计划，我的赛道是家居好物，目前粉丝500\n```\n\n### 3. 🔍 搜索与浏览分析\n\n**关键词分析：**\n```\n分析\"平价护肤\"这个关键词在小红书上的热度和竞争情况，给出长尾关键词建议\n```\n\n**热门话题追踪：**\n```\n最近小红书上有哪些热门的穿搭趋势？帮我分析可以蹭的热点话题\n```\n\n**竞品分析：**\n```\n帮我分析小红书上做\"极简生活\"赛道的头部博主，总结他们的内容策略\n```\n\n**搜索优化（SEO）：**\n```\n我的笔记标题是\"我的通勤包分享\"，帮我优化标题和正文关键词，提升搜索排名\n```\n\n### 4. 💬 互动评论\n\n**评论回复生成：**\n```\n有粉丝在我的美食笔记下问\"这个酱料在哪里买的\"，帮我生成一个亲切又有互动感的回复\n```\n\n**引导互动话术：**\n```\n帮我写一段放在笔记末尾的互动引导语，鼓励粉丝评论和收藏，主题是旅行攻略\n```\n\n**负面评论应对：**\n```\n有人在评论区说\"这个产品根本没用\"，帮我生成一个得体的回复，既能化解负面情绪又能维护品牌形象\n```\n\n**粉丝私信回复模板：**\n```\n帮我生成一套小红书私信回复模板，包括：新关注感谢、合作咨询回复、产品问询回复\n```\n\n### 5. 📊 运营数据分析\n\n**笔记数据复盘：**\n```\n我最近一篇笔记获得了2000赞、500收藏、100评论、5万阅读，帮我分析这个数据表现如何，有哪些可以优化的地方\n```\n\n**账号诊断：**\n```\n我的小红书账号做了3个月，粉丝增长缓慢（目前800粉），主要做穿搭内容，帮我诊断可能的问题并给出改进建议\n```\n\n**增长策略：**\n```\n帮我制定一个从0到1万粉丝的小红书增长计划，我的赛道是健康饮食\n```\n\n**爆款内容分析：**\n```\n帮我总结小红书上爆款笔记的共同特征，我想了解什么样的内容更容易火\n```\n\n### 6. 🎯 综合运营\n\n**账号定位：**\n```\n我想开始做小红书，对美妆和穿搭都感兴趣，帮我分析应该选择哪个赛道，并给出账号定位建议\n```\n\n**品牌合作准备：**\n```\n我有3000粉丝，想开始接品牌合作，帮我准备一份媒体合作简介（media kit）的内容框架\n```\n\n**矩阵运营建议：**\n```\n我想做小红书账号矩阵，主账号是美妆测评，帮我规划2-3个子账号的定位和内容策略\n```\n\n---\n\n## 进阶用法\n\n### 组合使用多个能力\n\n你可以在一次对话中组合使用多个能力，例如：\n\n```\n我要发一篇关于\"夏日防晒\"的小红书笔记，请帮我：\n1. 写出正文内容（种草风格）\n2. 生成5个爆款标题\n3. 推荐相关热门标签\n4. 建议最佳发布时间\n5. 写一段互动引导语\n```\n\n### 指定输出格式\n\n```\n用表格形式帮我对比分析5个防晒霜产品的小红书种草文案要点\n```\n\n### 持续优化\n\n```\n根据我上一篇笔记的数据反馈，帮我调整下一篇笔记的内容方向和写作策略\n```\n\n---\n\n## 注意事项\n\n- 本技能提供的是运营建议和内容辅助，不直接操作小红书平台\n- 生成的内容建议根据自身品牌调性和实际情况进行调整\n- 数据分析基于用户提供的数据，分析结果仅供参考\n- 请遵守小红书社区规范，避免违规内容\n- 建议结合实际运营经验灵活运用 AI 建议\n\nFile v1.0.8:README.md\n\n# 🌟 xiaohongshu — 小红书全链路运营 Skill\n\n<p align=\"center\">\n  <strong>小红书全链路运营 AI 助手 | Prompt-based Skill</strong>\n</p>\n\n<p align=\"center\">\n  内容创作 · 笔记发布 · 搜索浏览 · 互动评论 · 数据分析\n</p>\n\n---\n\n## 📖 简介\n\n`xiaohongshu` 是一个基于自然语言提示（Prompt-based）的 AI 技能，为小红书运营者提供从内容创作到数据分析的全链路支持。无需编写代码，只需用日常对话即可获得专业级运营辅助。\n\n**灵感参考：**\n- [xiaohongshu-all-in-one](https://clawhub.ai/richardx0319/xiaohongshu-all-in-one) — 小红书全能助手\n- [xiaohongshu-search-summarizer](https://clawhub.ai/piekill/xiaohongshu-search-summarizer) — 小红书搜索总结工具\n\n---\n\n## ✨ 功能特性\n\n### 📝 内容创作\n- 爆款标题生成（支持多种风格）\n- 笔记正文撰写（种草 / 测评 / 教程 / 日常分享等）\n- 热门标签与话题推荐\n- 多版本内容改写\n- 封面文案建议\n\n### 📤 笔记发布\n- 最佳发布时间推荐\n- 封面图风格建议\n- 发布频率与节奏规划\n- 月度/周度内容日历制定\n\n### 🔍 搜索浏览\n- 关键词热度与竞争分析\n- 长尾关键词挖掘\n- 热门话题与趋势追踪\n- 竞品博主内容策略分析\n- 笔记 SEO 优化建议\n\n### 💬 互动评论\n- 智能评论回复生成\n- 互动引导话术设计\n- 负面评论应对策略\n- 粉丝私信回复模板\n- 社群运营话术\n\n### 📊 运营分析\n- 笔记数据表现诊断\n- 账号增长瓶颈分析\n- 爆款内容特征总结\n- 增长策略制定\n- ROI 与投放效果分析\n\n### 🎯 综合运营\n- 账号定位与赛道选择\n- 品牌合作准备（Media Kit）\n- 矩阵账号规划\n- 变现路径设计\n\n---\n\n## 🚀 快速开始\n\n### 使用方式\n\n本技能为 **Prompt-based skill**，直接通过自然语言对话使用即可。\n\n#### 示例 1：一键生成完整笔记\n\n```\n帮我写一篇关于\"咖啡店探店\"的小红书笔记，要求：\n- 风格：文艺清新\n- 目标人群：20-30岁都市白领\n- 包含：标题、正文、标签、互动引导语\n```\n\n#### 示例 2：运营策略咨询\n\n```\n我的小红书账号做了2个月，粉丝300，做的是家居好物赛道。\n请帮我分析账号现状，并制定下个月的运营计划。\n```\n\n#### 示例 3：数据复盘分析\n\n```\n我最近5篇笔记的数据如下：\n1. 阅读3000/点赞200/收藏50/评论10\n2. 阅读8000/点赞1000/收藏300/评论80\n3. 阅读1500/点赞80/收藏20/评论5\n4. 阅读5000/点赞500/收藏150/评论30\n5. 阅读2000/点赞100/收藏40/评论8\n\n帮我分析哪篇表现最好，为什么，以及后续内容方向建议。\n```\n\n> 📌 更多使用方法和完整示例请参阅 [SKILL.md](./SKILL.md)\n\n---\n\n## 📁 项目结构\n\n```\nxiaohongshu/\n├── SKILL.md          # 技能定义文件（name、license、description + 完整使用指南）\n├── README.md         # 项目说明文档\n└── .gitattributes    # Git 属性配置\n```\n\n---\n\n## 🔗 相关资源\n\n- [小红书创作者中心](https://creator.xiaohongshu.com/)\n- [小红书社区规范](https://www.xiaohongshu.com/agreement)\n- [xiaohongshu-all-in-one](https://clawhub.ai/richardx0319/xiaohongshu-all-in-one)\n- [xiaohongshu-search-summarizer](https://clawhub.ai/piekill/xiaohongshu-search-summarizer)\n\n---\n\n## 📄 License\n\nMIT License — 详见 [SKILL.md](./SKILL.md)\n\nFile v1.0.8:_meta.json\n\n{\n  \"ownerId\": \"kn78mv1912530wvdbf2vjcd3r982v66j\",\n  \"slug\": \"xhs-cn\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1773935426119\n}","readmeExcerpt":"Skill: 小红书 Owner: wscats Summary: 小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。 当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。 Tags: latest:1.0.10 Version history: v1.0.10 | 2026-05-02T07:11:03.669Z | auto Version 1.0.10 - 增强客户端安全措施：新增自动检测，默认拒绝所有不安全或未授权的 publish 操作。 - SKILL.md 文档重写，明确所有客户端内置护栏，以及上游组件独立、非本仓库维护的提醒。 - 快速参考与市场调研、内容发布流程重构，突出强制逐步授权和机械性安全检查细节。 - 简化注意事项，删除/合并部分重复的人工安全警告，统一以客户端强制规约为准。 v1.0.7 | 2026-05-02T06:","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python scripts/xhs_client.py status\npython scripts/xhs_client.py search \"美食推荐\"\npython scripts/xhs_client.py search \"美食\" --sort \"最多点赞\" --type \"图文\" --time \"一周内\"\npython scripts/xhs_client.py detail <feed_id> <xsec_token> --comments\npython scripts/xhs_client.py feeds\npython scripts/xhs_client.py publish \"标题\" \"正文\" \"图1,图2\" --tags \"标签1,标签2\""},{"language":"text","snippet":"进度：\n- [ ] 第 1 步：验证连接\n- [ ] 第 2 步：搜索关键词\n- [ ] 第 3 步：获取笔记详情\n- [ ] 第 4 步：分析结果"},{"language":"bash","snippet":"python scripts/xhs_client.py status"},{"language":"bash","snippet":"python scripts/xhs_client.py search \"户外电源\" --sort \"最多点赞\" --json"},{"language":"bash","snippet":"python scripts/xhs_client.py detail \"<feed_id>\" \"<xsec_token>\" --comments --json"},{"language":"text","snippet":"进度：\n- [ ] 第 1 步：验证连接\n- [ ] 第 2 步：准备素材\n- [ ] 第 3 步：向用户展示预览并获取逐次授权\n- [ ] 第 4 步：发起发布（受客户端护栏保护）\n- [ ] 第 5 步：验证上线"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: xiaohongshu\ndescription: >\n  小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。\n  当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。\n---\n\n# 小红书 MCP\n\n本 Skill 是一个薄的 Python 客户端，通过 HTTP 调用用户**自行独立安装、启动并保管**的第三方本地组件 [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)。本 Skill 不分发、不捆绑、不自动拉取任何第三方二进制。首次安装请参阅 [SETUP.md](SETUP.md)。\n\n## 客户端侧自动护栏（客户端拒绝执行的条件）\n\n以下检查由 `scripts/xhs_client.py` **自动执行**，任何一项不满足都会直接拒绝发起调用：\n\n| 检查 | 触发条件 | 客户端行为 |\n| ---- | -------- | ---------- |\n| Loopback 端点 | 目标地址不解析到 127.0.0.1/localhost/::1 | 进程启动即拒绝（退出码 1） |\n| 非交互发布 | stdin 非 TTY 且未传 `--yes` | 拒绝 `publish`，返回 error |\n| 交互发布确认 | TTY 下用户未输入 `PUBLISH` 字面量 | 取消 `publish` |\n| 专用账号声明 | `XHS_DEDICATED_ACCOUNT` 未显式置 `yes` | 拒绝 `publish` |\n| 上游版本可见性 | `XHS_UPSTREAM_PINNED_VERSION` 未设置 | `status` 输出中性提醒 |\n\n这些不是建议，是**运行时机械拒绝**。用户或代理无需依赖额外自律。\n\n## 快速参考\n\n```bash\npython scripts/xhs_client.py status\npython scripts/xhs_client.py search \"美食推荐\"\npython scripts/xhs_client.py search \"美食\" --sort \"最多点赞\" --type \"图文\" --time \"一周内\"\npython scripts/xhs_client.py detail <feed_id> <xsec_token> --comments\npython scripts/xhs_client.py feeds\npython scripts/xhs_client.py publish \"标题\" \"正文\" \"图1,图2\" --tags \"标签1,标签2\"\n```\n\n所有命令支持 `--json` 输出原始 JSON。\n\n## 工作流：市场调研（只读）\n\n```\n进度：\n- [ ] 第 1 步：验证连接\n- [ ] 第 2 步：搜索关键词\n- [ ] 第 3 步：获取笔记详情\n- [ ] 第 4 步：分析结果\n```\n\n**第 1 步**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n**第 2 步**\n\n```bash\npython scripts/xhs_client.py search \"户外电源\" --sort \"最多点赞\" --json\n```\n\n筛选：`--sort`（综合/最新/最多点赞/最多评论/最多收藏）、`--type`（不限/视频/图文）、`--time`（不限/一天内/一周内/半年内）。\n\n**第 3 步**\n\n```bash\npython scripts/xhs_client.py detail \"<feed_id>\" \"<xsec_token>\" --comments --json\n```\n\n**第 4 步**\n\n查看笔记内容、互动数据（点赞、收藏、评论）与评论情感倾向。\n\n## 工作流：发布内容\n\n```\n进度：\n- [ ] 第 1 步：验证连接\n- [ ] 第 2 步：准备素材\n- [ ] 第 3 步：向用户展示预览并获取逐次授权\n- [ ] 第 4 步：发起发布（受客户端护栏保护）\n- [ ] 第 5 步：验证上线\n```\n\n**第 1 步**\n\n```bash\npython scripts/xhs_client.py status\n```\n\n**第 2 步**\n\n准备标题（建议 ≤ 20 字）、正文、可公开访问的图片 URL、可选标签。\n\n**第 3 步 — 代理必须执行的强制预览**\n\n调用 `publish` 前，代理必须向用户打印结构化预览并等待用户在对话中回复明确授权词：\n\n```\n📋 发布预览\n────────────\n账号：<status 返回的账号>\n标题：<title>\n正文：<content 全文>\n图片：<逐行 URL>\n标签：<tags>\n────────────\n请回复“确认发布”以继续；任何其他回复视为取消。\n```\n\n模糊回复、沉默、或\"以后都可以发\"等概括授权**一律视为未授权**。\n\n**第 4 步 — 发起发布**\n\n仅在收到用户授权后执行：\n\n```bash\npython scripts/xhs_client.py publish \"标题\" \"正文\" \"https://img1.jpg,https://img2.jpg\" --tags \"标签1,标签2\"\n```\n\n客户端会再对第 3 步的授权做机械验证（TTY 二次确认或 `--yes` + 专用账号声明）。\n\n**第 5 步**\n\n```bash\npython scripts/xhs_client.py search \"标题\" --sort \"最新\"\n```\n\n## 注意事项\n\n- **频率控制**：请适当控制请求间隔。\n- **维护脚本**：`scripts/publish.sh` 仅用于把本 Skill 包发布到 ClawHub 市场，与\"在小红书发布笔记\"无关，终端用户无需运行。"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn78mv1912530wvdbf2vjcd3r982v66j\",\n  \"slug\": \"xhs-cn\",\n  \"version\": \"1.0.10\",\n  \"publishedAt\": 1777705863669\n}"},{"path":"SETUP.md","content":"# 服务器安装（仅首次需要）\n\n本 Skill 的运行依赖一个**独立的第三方本地组件** [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)。本 Skill 自身**不包含、不分发、不打包**该组件的任何二进制或源代码，也**不会自动下载**它。是否安装、安装哪个版本、授予哪种账号权限，**完全由用户本人在安装本 Skill 之前独立决定**。\n\n## 安装前检查清单（Preflight Checklist）\n\n在继续之前，请逐项勾选以下条件。**如有任何一项无法满足，请停止安装本 Skill**：\n\n- [ ] 我已独立审核并信任第三方组件 `xpzouying/xiaohongshu-mcp`。\n- [ ] 我会使用一个**独立注册的专用账号**，不会使用我的主账号或企业账号。\n- [ ] 我会将该组件仅运行在受我本人物理控制的个人电脑上。\n- [ ] 我会使用该组件的默认 loopback 配置，不会修改其网络绑定。\n- [ ] 我理解并接受：该组件运行期间可代表上述专用账号发布公开内容，误操作不可撤回。\n- [ ] 任务完成后，我会停止该组件进程，并在官方 App 中手动吊销对应的登录设备。\n\n> ℹ️ 本 Skill 随附的 Python 客户端 `scripts/xhs_client.py` 在客户端一侧已内置多道自动拒绝机制：\n> 非 loopback 端点、非交互环境下的发布、未声明专用账号的发布，都会被**直接拒绝执行**，\n> 详见 `xhs_client.py` 顶部注释。\n\n## 第 0 步：安装 Python 依赖\n\n```bash\npip install requests\n```\n\n## 第 1 步：获取第三方 MCP 组件（推荐从源码编译）\n\n为避免供应链风险，**推荐**直接从官方仓库克隆并锁定到一个你已审核的具体版本 tag，然后用 Go 工具链自行编译：\n\n```bash\ngit clone https://github.com/xpzouying/xiaohongshu-mcp.git\ncd xiaohongshu-mcp\ngit checkout <YOUR_REVIEWED_TAG>     # 必须是一个你已人工审核过的具体 tag，禁止使用 main/latest\ngo build -o xiaohongshu-mcp ./cmd/mcp\ngo build -o xiaohongshu-login ./cmd/login\n```\n\n如必须使用预编译产物，请从 [官方 Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases) 下载指定 tag 的文件，并核对其 SHA256 与你从源码独立计算的哈希一致后再使用。\n\n完成后，将你确认使用的版本号写入环境变量，供本 Skill 的客户端进行一致性提示：\n\n```bash\nexport XHS_UPSTREAM_PINNED_VERSION=\"<YOUR_REVIEWED_TAG>\"\n```\n\n## 第 2 步：登录\n\n完成登录后，客户端会声明你正在使用的是**专用账号**；本 Skill 的 `publish` 命令要求用户显式设置该声明后才会放行：\n\n```bash\nexport XHS_DEDICATED_ACCOUNT=yes     # 只有在你用的是独立的专用账号时才设置\n./xiaohongshu-login-<your-platform>  # 扫码登录\n```\n\n## 第 3 步：启动 MCP 组件（保持默认 loopback 绑定）\n\n按照第三方组件文档的**默认**方式启动即可（其默认就绑定在本机回环接口）。本 Skill 的客户端会验证端点必须是 loopback，否则**直接拒绝发起任何请求**。\n\n```bash\n./xiaohongshu-mcp-<your-platform>\n```\n\n## 第 4 步：验证\n\n```bash\npython scripts/xhs_client.py status\n```\n\n## 使用结束后\n\n```bash\npkill -f xiaohongshu-mcp\nunset XHS_DEDICATED_ACCOUNT XHS_UPSTREAM_PINNED_VERSION\n```\n\n并在小红书官方 App 的「登录设备管理」中主动下线对应设备。"},{"path":"skill-card.md","content":"## Description:\n\n小红书 helps agents search Xiaohongshu notes, inspect details and comments, browse recommended feeds, and publish image-text posts through a user-managed local MCP component.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[wscats](https://clawhub.ai/user/wscats)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers, creators, and operators use this skill to research Xiaohongshu content, review note details and comments, browse feeds, and prepare authorized image-text posts. Publishing requires a user-managed local MCP service and explicit per-post authorization.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: A non-local MCP endpoint override could send Xiaohongshu tokens or draft post content to a remote server.\n\nMitigation: Keep the endpoint on loopback by default, and do not set XHS_ALLOW_REMOTE=yes or XHS_MCP_BASE_URL to a non-loopback address unless the server is fully trusted.\n\nRisk: The required third-party local MCP component can act through the configured Xiaohongshu account, including publishing public content.\n\nMitigation: Audit and pin the upstream component version, use a dedicated Xiaohongshu account, review each post before publishing, stop the component after use, and revoke the login device in the official app.\n\nRisk: The maintainer publish script is unrelated to end-user Xiaohongshu posting and mutates ClawHub distribution state.\n\nMitigation: Normal users should not run scripts/publish.sh; reserve it for maintainers with the required ClawHub credentials and explicit publish confirmation.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/wscats/skills/xhs-cn)\n- [SETUP.md](SETUP.md)\n- [xpzouying/xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)\n- [xiaohongshu-mcp Releases](https://github.com/xpzouying/xiaohongshu-mcp/releases)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON, Shell commands, Guidance]\n\n**Output Format:** [Markdown guidance with shell commands and optional JSON command output]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Commands interact with a user-managed local MCP service; publish operations require explicit authorization and a dedicated-account attestation.]\n\n## Skill Version(s):\n\n1.0.10 (source: server release evidence, released 2026-05-02)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。 当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。 Skill: 小红书 Owner: wscats Summary: 小红书自动化运营工具-支持：搜索笔记、查看笔记详情及评论、浏览推荐流、发布图文笔记。 当用户提及 xiaohongshu、小红书、RedNote，或需要在该平台进行内容调研/发布时使用。 Tags: latest:1.0.10 Version history: v1.0.10 | 2026-05-02T07:11:03.669Z | auto Version 1.0.10 - 增强客户端安全措施：新增自动检测，默认拒绝所有不安全或未授权的 publish 操作。 - SKILL.md 文档重写，明确所有客户端内置护栏，以及上游组件独立、非本仓库维护的提醒。 - 快速参考与市场调研、内容发布流程重构，突出强制逐步授权和机械性安全检查细节。 - 简化注意事项，删除/合并部分重复的人工安全警告，统一以客户端强制规约为准。 v1.0.7 | 2026-05-02T06:","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1007,"uniquenessScore":56,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T02:53:12.763Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T02:53:12.763Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:16:37.541Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}