Xiaohongshu Post (Browser Auto)

Create and publish Xiaohongshu (小红书/RED) notes. Use when: user wants to publish a note to Xiaohongshu, schedule or batch post content, generate Xiaohongshu-s...

Security Scan

The skill appears to do what it claims (post to Xiaohongshu via API, browser automation, or draft output); its optional environment variables and runtime behavior align with the stated purpose, but browser mode can send page HTML to external LLM endpoints (privacy risk) and requires care.

Purpose & Capability

Name/description match the code and instructions: post.py implements official-platform API posting and draft mode; publish_browser.py implements Playwright-driven automation with an LLM-based page analyzer. Required binary (python3) and listed optional env vars (platform credentials, analyzer keys, proxies) are appropriate for these modes.

Instruction Scope

Browser mode explicitly grabs page HTML and sends a sanitized version to an LLM endpoint (DashScope/OpenAI or a configured local analyzer). The SKILL.md warns about sensitive data in pages and offers a local-Ollama fallback; this behavior is necessary for the model-driven automation but creates a privacy/exfiltration risk if you provide an external API key. The code performs HTML sanitization (removes script/style and token-like patterns) but notes it cannot guarantee full removal of sensitive info.

Install Mechanism

There is no formal install spec in registry metadata, but requirements.txt (playwright, openai) and SKILL.md instruct pip install and 'playwright install chromium'. This is a standard dependency flow; Playwright will download browser binaries (Chromium). No downloads from arbitrary/personal URLs are present in the repo.

Credentials

Environment variables are optional and consistent with functionality: XIAOHONGSHU_APP_KEY/SECRET for official API; DASHSCOPE_API_KEY / OPENAI_API_KEY / XHS_ANALYZER_BASE_URL for LLM-driven page analysis; HTTP(S)_PROXY for network proxies. No unrelated credentials are requested.

Persistence & Privilege

always:false and the skill runs only when invoked. It stores browser login state under ~/.openclaw/xhs-browser (per SKILL.md/code), which is local to the user and expected for browser automation. The skill does not request elevated system-wide privileges or modify other skills' configurations.

Assessment

This skill is coherent with its stated purpose, but take care with browser automation: it reads page HTML (which can include login tokens or sensitive data) and will send sanitized HTML to an LLM endpoint if you configure DASHSCOPE_API_KEY/OPENAI_API_KEY or a remote XHS_ANALYZER_BASE_URL. To minimize risk, prefer API mode (set XIAOHONGSHU_APP_KEY/SECRET), or run the analyzer locally (Ollama) by setting XHS_ANALYZER_BASE_URL to a localhost endpoint and not providing external API keys. Review the code if you plan to supply any analyzer API keys, run in an isolated environment, and consider using --draft-only for manual posting if you do not trust external LLM endpoints.

Xiaohongshu Post Skill

Create and publish notes to Xiaohongshu (小红书/RED).

⚠️ 安全与隐私（浏览器模式必读）

浏览器模式会将页面内容发送到 LLM 进行分析。默认使用百炼（DashScope）等外部 API，页面 HTML 可能包含登录态、token、后台数据等敏感信息。

• 若仅需服务号发文：请使用 API 模式（post.py），仅配置 XIAOHONGSHU_APP_KEY/XIAOHONGSHU_APP_SECRET，不要配置 DASHSCOPE_API_KEY/OPENAI_API_KEY。
• 若必须使用浏览器模式：
  • 优先使用 本地模型（Ollama）：XHS_ANALYZER_BASE_URL=http://localhost:11434/v1，不配置 API Key。
  • 或使用自托管/可信端点，并限制 API Key 权限。
  • 若不配置分析器 Key，脚本会回退为需手动操作，页面内容不会外发。

脚本会对 HTML 做脱敏（移除 script/style、常见 token 模式），但无法完全消除敏感信息。请评估后再使用。

When to Use

• "发小红书" / "自动发小红书" / "发一篇小红书笔记"
• "把这段内容发到小红书" / "创建小红书草稿"
• "生成小红书文案" / "小红书标题 + 正文 + 标签"

三种模式

模式	适用	脚本
API 发布	企业号、已认证开放平台	post.py
浏览器自动化	个人账号（无 API 权限）	publish_browser.py
草稿输出	快速生成，手动发布	post.py --draft-only

---

模式一：API 发布（企业号）

Prerequisites

• 小红书企业号或已认证开发者
• 开放平台权限
• 环境变量：XIAOHONGSHU_APP_KEY、XIAOHONGSHU_APP_SECRET

安装配置

1. 注册开发者

   • 访问 open.xiaohongshu.com
   • 完成开发者实名认证（企业或个人）

2. 创建应用

   • 在控制台创建新应用
   • 申请「笔记发布」相关接口权限
   • 获取 App Key 和 App Secret

3. 配置环境变量

   export XIAOHONGSHU_APP_KEY=your_app_key
   export XIAOHONGSHU_APP_SECRET=your_app_secret
   

Commands

# 发布笔记（带图片）
python3 scripts/post.py --title "上海探店 | 这家咖啡馆太绝了" \
  --content "周末和朋友一起来打卡..." \
  --image cover.jpg img2.jpg img3.jpg \
  --tags "探店，咖啡，上海"

# 纯文字笔记
python3 scripts/post.py --title "今日穿搭" \
  --content "OOTD | 简约风穿搭分享..." \
  --tags "穿搭，日常"

# JSON 输出（便于脚本集成）
python3 scripts/post.py --title "..." --content "..." --json

参数

• --title：标题（必填，≤20 字）
• --content：正文内容（必填）
• --image：图片路径，可多个（空格分隔）
• --tags：标签，逗号分隔
• --draft-only：仅输出草稿，不调用 API
• --json：JSON 格式输出

限制与注意事项

• 内容审核：发布的笔记需经平台审核，违规内容会被拒绝
• 频率限制：API 有调用次数限制，避免短时间内大量发帖
• 图片要求：JPG/PNG，单张 ≤10MB，建议 3:4 或 1:1 比例
• 标题长度：≤20 字
• 正文长度：≤1000 字

---

模式二：浏览器自动化（个人账号）

适用于个人账号，无需 API 权限。无硬编码：每次打开或跳转页面后，等待 → 获取页面代码 → 由模型分析当前状态及下一步操作。

安装

pip install -r requirements.txt   # playwright + openai
playwright install chromium
export DASHSCOPE_API_KEY=...      # 百炼 API Key（与 OpenClaw 主模型一致）

使用

# 发布笔记（模型驱动：自动登录检测、填表、上传图片）
python3 scripts/publish_browser.py --title "标题" --content "正文" --images img1.jpg,img2.jpg

# 从文件读取正文
python3 scripts/publish_browser.py --title "标题" --content-file note.md --images img1.jpg

# 仅检测（模型分析当前页面状态）
python3 scripts/publish_browser.py --check-only

# 指定模型（默认 bailian/qwen3.5-plus）
python3 scripts/publish_browser.py --title "..." --content-file x.md --images x.jpg --model gpt-4o-mini

# 本地 Ollama（无需 API Key，隐私更安全）
XHS_ANALYZER_BASE_URL=http://localhost:11434/v1 XHS_ANALYZER_MODEL=llama3.2 \
  python3 scripts/publish_browser.py --title "..." --content-file x.md --images x.jpg

流程（模型驱动）

1. 打开 creator.xiaohongshu.com，等待 → 获取页面 HTML → 模型分析
2. 模型返回：state（login_required / logged_in_dashboard / note_editor）和 next_action（wait_for_scan / goto_publish / click_new_note / fill_note / done）
3. 脚本执行对应操作，每次跳转后重复步骤 1
4. 无硬编码特征，模型根据页面内容动态决策

参数

• --title：标题（必填，--check-only 时可不填，≤20 字）
• --content / --content-file：正文，支持 Markdown（≤1000 字）
• --images：图片路径，逗号分隔（1-9 张，建议 3:4 或 1:1）
• --tags：话题标签，逗号分隔（如：#穿搭 #日常）
• --model：分析用 LLM 模型（默认 qwen3.5-plus，百炼）
• --headed / --headless：是否显示浏览器
• --user-data-dir：浏览器配置目录（默认 ~/.openclaw/xhs-browser）
• --step：每步截图并自动继续
• --check-only：仅分析当前页面状态
• --debug：保存截图和 HTML

环境变量

• DASHSCOPE_API_KEY / OPENAI_API_KEY：外部 API Key（不配置则使用本地模型或回退手动）
• XHS_ANALYZER_BASE_URL：分析器端点。本地 Ollama：http://localhost:11434/v1（无需 Key）
• XHS_ANALYZER_MODEL：模型名，默认 qwen3.5-plus；Ollama 用 llama3.2 等

注意

• 小红书后台 UI 可能更新，若选择器失效需调整脚本
• 登录状态保存在 ~/.openclaw/xhs-browser，勿删除
• 图片建议尺寸：900×1200（3:4）或 1080×1080（1:1）

---

模式三：草稿输出（快速生成）

无 API 凭证时，自动生成格式化草稿，可手动复制到小红书 APP 发布。

# 生成草稿（带标签）
python3 scripts/post.py --draft-only \
  --title "周末穿搭分享" \
  --content "今天分享一套超好看的春日穿搭..." \
  --tags "穿搭，春日，OOTD"

# 从文件读取内容
python3 scripts/post.py --draft-only \
  --title "上海探店" \
  --content "$(cat note.md)" \
  --tags "探店，咖啡"

输出示例：

--- 小红书草稿（复制到 APP 发布） ---

标题：周末穿搭分享

正文:
今天分享一套超好看的春日穿搭...

标签：#穿搭 #春日 #OOTD

---

---

Path

From workspace root:

# API 发布
python3 skills/xiaohongshu-post/scripts/post.py --title "..." --content "..." --image x.jpg --tags "标签 1，标签 2"

# 浏览器自动化（个人账号）
python3 skills/xiaohongshu-post/scripts/publish_browser.py --title "..." --content-file x.md --images x.jpg,y.jpg

# 草稿输出
python3 skills/xiaohongshu-post/scripts/post.py --draft-only --title "..." --content "..." --tags "标签 1，标签 2"

Content Format

• 标题 ≤ 20 字
• 正文 ≤ 1000 字，支持换行
• 标签自动转为 #标签 格式
• 图片 1-9 张，JPG/PNG，单张 ≤10MB