xiaohongshu-post

Create and publish Xiaohongshu (小红书/RED) notes. Use when: user wants to publish a note to Xiaohongshu, schedule or batch post content, generate Xiaohongshu-style titles/body/hashtags, or automate note publishing. Supports API posting (requires open platform credentials), browser automation (personal accounts), or draft generation.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "xiaohongshu-post" with this command: npx skills add antaeus001/xiaohongshu-post-antaeus

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. 注册开发者

  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

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

Leads

Leads - command-line tool for everyday use

Registry SourceRecently Updated
740xueyetianya
General

Bmi Calculator

BMI计算器。BMI计算、理想体重、健康计划、体重追踪、儿童BMI、结果解读。BMI calculator with ideal weight, health plan. BMI、体重、健康。

Registry SourceRecently Updated
1880bytesagain
General

Blood

Blood — a fast health & wellness tool. Log anything, find it later, export when needed.

Registry SourceRecently Updated
300bytesagain
General

Better Genshin Impact

📦BetterGI · 更好的原神 - 自动拾取 | 自动剧情 | 全自动钓鱼(AI) | 全自动七圣召唤 | 自动伐木 | 自动刷本 | 自动采集/挖矿/锄地 | 一条龙 | 全连音游 - UI A better genshin impact, c#, auto-play-game, automatic, g...

Registry SourceRecently Updated
1160bytesagain