Back to search
comeonzhj-Auto-Redbook-Skills
MarketplaceWorks with Claude CodeGitHub
小红书笔记自动创作插件:撰写内容、生成图片卡片、一键发布
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/comeonzhj-auto-redbook-skills)HTML
<a href="/listings/comeonzhj-auto-redbook-skills"><img src="/api/listings/comeonzhj-auto-redbook-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 23 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
- "name": "comeonzhj-Auto-Redbook-Skills",
- "owner": {
- "name": "ZhangJia"
- },
- "description": "小红书笔记自动创作插件:撰写内容、生成图片卡片、一键发布",
- "plugins": [
- {
- "name": "auto-redbook-skills",
- "source": "./",
- "description": "小红书笔记自动创作技能。支持 8 种排版主题和 4 种智能分页模式。",
- "category": "content",
- "keywords": [
- "xiaohongshu",
- "小红书",
- "redbook",
- "social-media",
- "content-creation"
- ]
- }
- ]
- }
README.md · README · 259 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ## 📕 Auto-Redbook-Skills(已重构版)
- ### ⚠️ 使用此工具前情确保已悉知官方 3 月 10 日发布的公告
- 公告地址:[关于打击AI托管运营账号的治理公告](http://xhslink.com/o/7WxTddvbmTu)
- ### 方式一:Claude Code Plugin 安装(推荐)
- ```bash
- # 添加本仓库为 marketplace
- /plugin marketplace add comeonzhj/Auto-Redbook-Skills
- # 安装插件
- /plugin install auto-redbook-skills@comeonzhj-Auto-Redbook-Skills
- ```
- 安装后运行 `/reload-plugins` 即可使用。
- ### 方式二:一句话安装
- 跟你的 Agent 说:
- > 拉取下面的项目,安装其中的技能:https://github.com/comeonzhj/Auto-Redbook-Skills
- ### 方式三:手动安装
- 详见下方[使用方式总览](#-使用方式总览)。
- ---
- > 自动撰写小红书笔记、生成多主题卡片、可选自动发布的 Skills
- > 当前版本对渲染脚本和样式系统做了**一次完整重构**,感谢 Cursor 的辅助开发 🙌
- ---
- ## ✨ 本次重构亮点
- - **🎨 8 套主题皮肤**:默认简约灰 + Playful Geometric / Neo-Brutalism / Botanical / Professional / Retro / Terminal / Sketch
- - **📐 4 种分页模式**:
- - `separator`:按 `---` 分隔手动分页
- - `auto-fit`:固定尺寸,自动整体缩放内容,避免溢出/大面积留白
- - `auto-split`:根据渲染后高度自动拆分为多张卡片
- - `dynamic`:根据内容动态调整图片高度
- - **🧱 统一卡片结构**:外层浅灰背景(`card-container`)+ 内层主题背景(`card-inner`)+ 纯排版层(`card-content`)
- - **🧠 封面与正文一体化**:封面背景、标题渐变和正文卡片背景都按主题自动匹配
- ---
- ## 🖼 主题效果示例
- > 所有示例均为 1080×1440px,小红书推荐 3:4 比例
- > 更多示例去 [demo](/demos) 中查看
- |||
- |---|---|
- |||
- |||
- ### Auto-fit 模式示例(自动缩放)
- 
- ---
- ## 🚀 使用方式总览
- ### 1. 克隆项目
- ```bash
- git clone https://github.com/comeonzhj/Auto-Redbook-Skills.git
- cd Auto-Redbook-Skills
- ```
- 可以将本项目放到支持 Skills 的客户端目录,例如:
- - Claude:`~/.claude/skills/`
- - Alma:`~/.config/Alma/skills/`
- - TRAE:`/your-path/.trae/skills/`
- ### 2. 安装依赖
- **Python:**
- ```bash
- pip install -r requirements.txt
- playwright install chromium
- ```
- **Node.js:**
- ```bash
- npm install
- npx playwright install chromium
- ```
- > Node.js 18+ 同时用于图片渲染和内置的小红书 Creator 请求签名。
- ---
- ## 🎨 渲染图片(Python)
- 核心脚本:`scripts/render_xhs.py`
- ```bash
- # 最简单用法(默认主题 + 手动分页)
- python scripts/render_xhs.py demos/content.md
- # 使用自动分页(推荐:内容长短难控)
- python scripts/render_xhs.py demos/content.md -m auto-split
- # 使用固定尺寸自动缩放(auto-fit)
- python scripts/render_xhs.py demos/content_auto_fit.md -m auto-fit
- # 切换主题(例如 Playful Geometric)
- python scripts/render_xhs.py demos/content.md -t playful-geometric -m auto-split
- # 自定义尺寸和像素比
- python scripts/render_xhs.py demos/content.md -t retro -m dynamic --width 1080 --height 1440 --max-height 2160 --dpr 2
- ```
- **主要参数:**
- | 参数 | 简写 | 说明 |
- |------|------|------|
- | `--theme` | `-t` | 主题:`default`、`playful-geometric`、`neo-brutalism`、`botanical`、`professional`、`retro`、`terminal`、`sketch` |
- | `--mode` | `-m` | 分页模式:`separator` / `auto-fit` / `auto-split` / `dynamic` |
- | `--width` | `-w` | 图片宽度(默认 1080) |
- | `--height` | | 图片高度(默认 1440,`dynamic` 为最小高度) |
- | `--max-height` | | `dynamic` 模式最大高度(默认 2160) |
- | `--dpr` | | 设备像素比,控制清晰度(默认 2) |
- > 生成结果会包含:封面 `cover.png` + 正文卡片 `card_1.png`、`card_2.png`...
- ---
- ## 🎨 渲染图片(Node.js)
- 脚本:`scripts/render_xhs.js`,参数与 Python 基本一致:
- ```bash
- # 默认主题 + 手动分页
- node scripts/render_xhs.js demos/content.md
- # 指定主题 + 自动分页
- node scripts/render_xhs.js demos/content.md -t terminal -m auto-split
- ```
- ---
- ## 📤 发布到小红书
- ### 1. 配置 Creator Cookie
- ```bash
- cp env.example.txt .env
- ```
- 编辑 `.env`:
- ```env
- XHS_CREATOR_COOKIE=your_creator_cookie_string_here
- ```
- > 获取方式:浏览器登录[小红书创作服务平台](https://creator.xiaohongshu.com)
- > → F12 → Network → 刷新页面 → 选择发往 `creator.xiaohongshu.com` 的请求
- > → 复制 Request Headers 中的完整 Cookie。
- ### 2. 发布图文笔记(可选)
- ```bash
- python scripts/publish_xhs.py \
- --title "笔记标题" \
- --desc "笔记描述内容" \
- --images cover.png card_1.png card_2.png
- ```
- **可选参数:**
- | 参数 | 说明 |
- |------|------|
- | `--public` | 公开发布(默认仅自己可见) |
- | `--post-time "2026-08-14 10:00:00"` | 按本机时区定时发布,也支持 13 位毫秒时间戳 |
- | `--topics AI 效率工具` | 添加一个或多个话题,不要带 `#` |
- | `--location "上海"` | 添加地点 |
- | `--proxy http://127.0.0.1:7890` | 使用 HTTP/HTTPS 代理 |
- | `--dry-run` | 仅做本地参数验证,不登录、不上传、不发布 |
- 发布脚本已内置 Creator 纯 HTTP 签名、素材上传和发布链路,不依赖浏览器自动化、
- 外部 API 服务或其他项目目录。运行发布命令前请确保已经执行 `pip install -r requirements.txt`
- 和 `npm install`。
- ---
- ## 📁 项目结构(重构后)
- ```bash
- Auto-Redbook-Skills/
- ├── SKILL.md # 技能描述(Agent 使用说明)
- ├── README.md # 项目文档(你现在看到的)
- ├── requirements.txt # Python 依赖
- ├── package.json # Node.js 依赖
- ├── env.example.txt # Cookie 配置示例
- ├── vendor/xhs_publish_runtime/ # 内置 Creator 鉴权、签名与发布运行时
- ├── references/ # 技能参考文档
- │ └── params.md # 完整参数参考(主题/模式/发布参数)
- ├── assets/
- │ ├── cover.html # 封面 HTML 模板
- │ ├── card.html # 正文卡片 HTML 模板
- │ ├── styles.css # 共用容器样式(cover-inner / card-inner 等)
- │ └── example.md # 示例 Markdown
- ├── assets/themes/ # 主题样式(只控制排版 & 内层背景)
- │ ├── default.css
- │ ├── playful-geometric.css
- │ ├── neo-brutalism.css
- │ ├── botanical.css
- │ ├── professional.css
- │ ├── retro.css
- │ ├── terminal.css
- │ └── sketch.css
- ├── demos/ # 各主题示例渲染结果
- │ ├── content.md
- │ ├── content_auto_fit.md
- │ ├── auto-fit/
- │ ├── playful-geometric/
- │ ├── retro/
- │ ├── Sketch/
- │ └── terminal/
- └── scripts/
- ├── render_xhs.py # Python 渲染脚本(8 主题 + 4 分页模式)
- ├── render_xhs_v2.py # Python 渲染脚本 V2(7 渐变色彩风格)
- ├── render_xhs.js # Node.js 渲染脚本
- └── publish_xhs.py # 自包含的小红书 Creator 发布脚本(默认仅自己可见)
- ```
- ---
- ## ⚠️ 注意事项
- 1. **Cookie 安全**:不要把 `.env` 提交到 Git 或共享出去;请使用创作服务平台 Cookie。
- 2. **Cookie 有效期**:过期后发布失败是正常现象,重新抓一次 Cookie 即可。
- 3. **发布频率**:避免短时间内高频发布,以免触发平台风控。
- 4. **图片尺寸**:默认 1080×1440px,符合小红书推荐比例。
- ---
- ## 🙏 致谢
- - [Playwright](https://playwright.dev/) - 浏览器自动化渲染
- - [Marked](https://marked.js.org/) - Markdown 解析
- - ~~[xhs](https://github.com/ReaJason/xhs) - 原小红书 API 客户端(发布实现已停用)~~
- - [Spider_XHS](https://github.com/cv-cat/Spider_XHS) - 当前 Creator 纯 HTTP 登录、签名、上传与发布实现参考(基于提交 `2030f5d` 提取并内置)
- - **Cursor** - 本次重构过程中提供了极大帮助 ❤️
- ---
- ## 📄 License
- MIT License © 2026
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.