Easy Xiaohongshu

根据主题生成小红书图文内容，并在本地 `xiaohongshu-mcp` 可用时辅助发布图文笔记。

Security Scan

The skill appears to do what it says (generate Xiaohongshu content via Z3i0 and optionally publish via a local MCP service); its code, config, and runtime behavior are consistent with that purpose, though there are a few operational privacy/ops risks you should review before installing.

Purpose & Capability

Name/description (generate Xiaohongshu posts + optional MCP publish) match the code and SKILL.md. The code calls the declared external image/text service (z.3i0.cn) and expects a local MCP endpoint for publishing. No unrelated credentials or strange external hosts are required.

Instruction Scope

SKILL.md and the scripts focus on prompt optimization, content/image generation (via the Z3i0/Gemini-style API) and optional local publishing through xiaohongshu-mcp. The install script only checks Python, installs requirements, writes a local config, and checks the MCP endpoint. It does not ask the agent to read unrelated system files or contact unexpected remote endpoints.

Install Mechanism

There is no registry install that downloads arbitrary archives. The package is code+scripts included in the skill bundle and an install.sh that installs Python deps via pip (requirements.txt contains only requests). No remote downloads from unknown personal servers are performed by the provided scripts.

Credentials

The skill needs an API key for z.3i0.cn (documented in SKILL.md and config). It also supports environment overrides (EASY_XHS_CONFIG, XHS_MCP_URL). These are proportionate to the stated functionality. Note: the install script writes the API key in plaintext to config/local-config.json; that file can be accidentally committed if not excluded.

Persistence & Privilege

The skill is not set to always:true and does not request elevated agent privileges. However the repository includes auto-sync.sh and setup-auto-sync.sh (present but not fully inspected here). auto-sync.sh will 'git add -A' and commit changes in the skill directory — this could inadvertently include plaintext API keys or other secrets if run or if setup-auto-sync.sh wires it into a cron/automation. Review those scripts before running them.

Assessment

This skill is internally coherent for generating content and publishing via a local MCP service, but take simple precautions before installing or running it: - Inspect install.sh, setup-auto-sync.sh, and auto-sync.sh before running. auto-sync.sh will git add & commit everything in the skill directory — it can accidentally commit your API key or other secrets if you run it or if setup-auto-sync.sh enables periodic sync. - The API key for z.3i0.cn is stored in config/local-config.json (plaintext) by the installer. Consider using environment-only configuration (EASY_XHS_CONFIG) or ensure config/local-config.json is in your .gitignore and not pushed to any remote. - The skill contacts z.3i0.cn for generation and assumes a local MCP service at http://localhost:18060/mcp for publishing. If you don’t run a local MCP service, publishing won’t work — it will not contact official Xiaohongshu endpoints directly. - Pip installs only the requests package per requirements.txt, but run pip in an isolated venv if you prefer. - Be aware of per-image costs on the z.3i0.cn service (documented in SKILL.md). Monitor usage and billing on that account. If you want stronger assurance, request the contents of setup-auto-sync.sh and publish-related scripts (publish_to_xhs.py) to confirm they don’t perform unexpected network calls, push commits, or create background services.

Easy-xiaohongshu - 小红书 AI 图文自动发布

✨ 从创意到发布，全自动完成 — 提示词优化 → 图文生成 → 一键发布

---

核心能力

能力	描述
🤖 智能提示词优化	根据账号定位自动匹配最佳风格（13 种预设）
📝 图文生成	文案 + 排版 + AI 成品图，一站式完成
📱 自动发布	通过 MCP 服务一键发布到小红书
📋 发布文案生成	自动生成标题 + 正文 + 标签

---

快速开始

Step 1：获取 API Key

1. 在 z.3i0.cn 注册账号
2. 在钱包管理中按需充值（生图有成本，最低 0.2 元/张）
3. 在令牌管理中点击【添加令牌】
4. 输入名称等信息后保存
5. 复制生成的 API Key

Step 2：安装技能

cd ~/clawd/skills/Easy-xiaohongshu
bash install.sh

安装脚本会：

• ✅ 检查 Python 环境
• ✅ 安装依赖
• ✅ 引导 API Key 配置
• ✅ 检查 MCP 服务状态

Step 3：发送创作主题

我想发一篇主题为【xxxxxx】的小红书，帮我制作内容

Step 4：确认文案

技能会同时生成：

• 📄 图文方案（8 页图文内容）
• 📝 发布文案（标题 + 正文 + 标签）

确认没问题后进入下一步。

Step 5：确认图片

8 张成品图会逐张生成并发给你预览，确认效果后进入下一步。

Step 6：发布到小红书

技能会通过 MCP 服务自动发布。首次使用需要扫码登录，之后无需重复登录。发布前会再次确认。

---

支持的风格预设

账号类型	风格	适合场景
科技博主	极简科技感	AI 工具、数码测评
亲子博主	温馨插画风	育儿经验、亲子互动
美妆博主	高级 ins 风	护肤教程、彩妆分享
健身博主	活力运动风	健身计划、减脂塑形
美食博主	治愈系	家常菜、美食探店
学习博主	清新简约	学习方法、考试经验
旅行博主	电影感	旅行攻略、风景摄影
职场博主	商务简约	职场技能、时间管理
漫画博主	热血漫画风	动漫解析、漫画推荐
摄影博主	胶片质感	摄影教程、作品分享
穿搭博主	时尚杂志风	穿搭分享、OOTD
游戏博主	电竞科技风	游戏攻略、测评
音乐博主	唱片封面风	歌单推荐、音乐分享

---

自动发布（可选）

发布功能需要 xiaohongshu-mcp 服务，参考 xhs-mac-mcp 技能安装。

MCP 配置

在 config/local-config.json 中配置：

{
  "mcp": {
    "url": "http://localhost:18060/mcp",
    "timeout_seconds": 30
  }
}

---

文件结构

Easy-xiaohongshu/
├── SKILL.md                    # 技能说明（本文件）
├── README.md                   # 详细文档
├── install.sh                  # 一键安装脚本
├── requirements.txt            # Python 依赖
├── config/
│   ├── default-config.json     # 默认配置
│   └── local-config.json       # 本地配置（API Key 等）
├── scripts/
│   ├── optimize_prompt.py      # 提示词优化器
│   ├── generate_content.py     # 文案生成器
│   ├── generate_image.py       # 图片生成器
│   └── publish_to_xhs.py       # 小红书发布
├── references/
│   ├── style-presets.json      # 13 种风格预设
│   ├── hashtag-library.json    # 标签库
│   ├── prompt-template.md      # 提示词模板
│   └── caption-template.md     # 文案模板
└── generated_images/           # 生成的图片输出目录

---

依赖

依赖	用途	必需
Python 3.8+	脚本运行	✅
requests	HTTP 请求	✅
Z3i0 API	图像生成	✅
xiaohongshu-mcp	自动发布	发布时必需

---

配置说明

API 配置

建议先复制示例文件：

cp config/local-config.example.json config/local-config.json

在 config/local-config.json 中配置：

{
  "api": {
    "key": "你的 API Key",
    "base_url": "https://z.3i0.cn/v1beta",
    "model": "gemini-3.1-flash-image-preview"
  },
  "user_preferences": {
    "account_type": "漫画博主",
    "content_direction": "动漫解析",
    "target_audience": "二次元爱好者"
  }
}

用户偏好

技能会记住你的账号类型偏好，下次使用时自动应用。如需修改，重新运行 install.sh 或手动编辑 local-config.json。

---

输出内容

文件	描述
generated_content.json	生图原始文本 + page_prompts 结构化提示词
generated_caption.json	发布文案（标题 + 正文 + 标签）
generated_images/*.png	生成的 8 张成品图

---

常见问题

Q: API Key 在哪里获取？

A: 在 z.3i0.cn 注册后，在令牌管理中创建。

Q: 发布失败怎么办？

A: 检查 MCP 服务是否运行，首次发布需要扫码登录。

Q: 可以修改风格预设吗？

A: 可以，编辑 references/style-presets.json。

---

许可证

MIT License

---

更新日志

• 2026-03-23: 添加 install.sh 安装脚本、完善 13 种风格预设、集成提示词优化器