mcpField
X
xhs-note-creator

xhs-note-creator

github.com/comeonzhj营销与增长2.4k1.3k 次安装11 周前更新
代码仓库

关于 xhs-note-creator

xhs-note-creator 是一项小红书笔记创作技能，可根据用户提供的资料或需求撰写内容。它能将内容渲染为可选主题和分页模式的图片卡片，并可选择发布笔记。

主要功能

  1. 01撰写小红书笔记内容
  2. 02渲染封面和正文图片卡片
  3. 03选择多种视觉主题
  4. 04选择分页模式
  5. 05可选发布笔记到小红书

适用场景

  1. 01将提供的资料整理成小红书笔记
  2. 02将 Markdown 制作为主题图片卡片
  3. 03发布前预览笔记
  4. 04向小红书发布图片卡片笔记

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/comeonzhj/auto-redbook-skills --skill xhs-note-creator

安装后在 Claude Code 中输入/xhs-note-creator确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

STYLES.md
.gitignore
README.md
env.example.txt
package-lock.json
package.json
requirements.txt
.claude-plugin/
marketplace.json
plugin.json
assets/
cover.html
card.html
example.md
styles.css
assets/themes/
botanical.css
neo-brutalism.css
default.css
retro.css
playful-geometric.css
sketch.css
professional.css
terminal.css
demos/
.DS_Store
content.md
content_auto_fit.md
references/
params.md
scripts/
publish_xhs.py
render_xhs.js
vendor/xhs_publish_runtime/
__init__.py
vendor/xhs_publish_runtime/apis/
__init__.py
vendor/xhs_publish_runtime/xhs_utils/
__init__.py

详细介绍

来自项目 README

小红书笔记创作技能

根据用户提供的资料或需求，创作小红书笔记内容、生成精美图片卡片，并可选择发布到小红书。

详细参数文档见 references/params.md

工作流程

第一步：撰写小红书笔记内容

根据用户需求和资料，创作符合小红书风格的内容：

标题：不超过 20 字，吸引眼球，可用数字/疑问句/感叹号增强吸引力。

正文：段落清晰，点缀少量 Emoji（每段 1-2 个），短句短段，结尾附 5-10 个 SEO 标签。

第二步：生成渲染用 Markdown 文档

注意：此 Markdown 专为图片渲染设计，禁止直接使用上一步的笔记正文。

文档结构：

---
emoji: "🚀"
title: "封面大标题（≤15字）"
subtitle: "封面副标题（≤15字）"
---

# 正文内容...

---

# 第二张卡片内容...（使用 --- 手动分隔时）

分页策略选择：

  • 内容需精确切分 → 用 --- 手动分隔，配合 -m separator
  • 内容长短不稳定 → 生成普通 Markdown，使用 -m auto-split
第三步：渲染图片卡片
python scripts/render_xhs.py <markdown_file> [options]

默认主题：sketch（手绘素描风格）
默认分页：separator（按 --- 分隔）

常用示例：

# 默认（sketch 主题 + 手动分页）
python scripts/render_xhs.py content.md

# 自动分页（推荐内容长短不定时）
python scripts/render_xhs.py content.md -m auto-split

# 切换主题
python scripts/render_xhs.py content.md -t playful-geometric -m auto-split

# 固定尺寸自动缩放
python scripts/render_xhs.py content.md -m auto-fit

生成结果：cover.png（封面）+ card_1.png、card_2.png...（正文卡片）

可用主题（-t）：sketch、default、playful-geometric、neo-brutalism、botanical、professional、retro、terminal

分页模式（-m）：separator、auto-fit、auto-split、dynamic

完整参数说明见 references/params.md

第四步：发布小红书笔记（可选）

前置条件：安装 Python 与 Node.js 依赖，并配置 .env 中的 XHS_CREATOR_COOKIE。Cookie 必须来自已登录的 https://creator.xiaohongshu.com（详见 references/params.md）。

# 默认仅自己可见（推荐先预览确认）
python scripts/publish_xhs.py --title "笔记标题" --desc "笔记描述" \
  --images cover.png card_1.png card_2.png

# 确认无误后公开发布
python scripts/publish_xhs.py --title "笔记标题" --desc "笔记描述" \
  --images cover.png card_1.png card_2.png --public

默认以「仅自己可见」发布，加 --public 参数才会公开。 发布链路已内置在当前技能中，不依赖外部 API 服务或其他项目目录。

技能资源

脚本
  • scripts/render_xhs.py — 渲染脚本（主推，8 主题 + 4 分页模式）
  • scripts/render_xhs_v2.py — 渲染脚本 V2（备用，7 种渐变色彩风格）
  • scripts/publish_xhs.py — 发布脚本
模板与样式
  • assets/cover.html — 封面 HTML 模板
  • assets/card.html — 正文卡片 HTML 模板
  • assets/styles.css — 公共容器样式
  • assets/themes/ — 各主题 CSS 文件
参考文档
  • references/params.md — 完整参数参考（主题/模式/发布参数）

评论

支持 Markdown