Agent skill

Skill Xhs Publisher

by ZJU-REAL in ZJU-REAL/Easel

将图文/视频内容发布到小红书(XHS)。基于 Playwright + 持久化登录态,headless 即可运行, 流程与选择器移植自成熟开源实现 xiaohongshu-mcp(含发布成功校验、上传完成等待、话题联想绑定、 新旧发布按钮兼容、反检测)。适用场景:发布图文笔记、发布视频、扫码登录、发布前预检。

Apache-2.0Auto-check passedTesting & QA

Install Skill Xhs Publisher

skills CLI
$ npx skills add ZJU-REAL/Easel --skill skill-xhs-publisher -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZJU-REAL/Easel skill-xhs-publisher --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZJU-REAL/Easel.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openclaw/skill-xhs-publisher .claude/skills/skill-xhs-publisher && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-xhs-publisher
GitHub stars
3.4k
Token cost
~726 tokens
SKILL.md length
142 words
Files
6 (incl. references)
Skills in repo
114
Repo updated
First seen
Licence
Apache-2.0

At a glance

将图文/视频内容发布到小红书(XHS)。基于 Playwright + 持久化登录态,headless 即可运行, 流程与选择器移植自成熟开源实现 xiaohongshu-mcp(含发布成功校验、上传完成等待、话题联想绑定、 新旧发布按钮兼容、反检测)。适用场景:发布图文笔记、发布视频、扫码登录、发布前预检。

  • Works in 6 steps: "检查环境 / 能不能发":xhs_publish.py check。 → "登录 / 扫码 / 换账号":xhs_publish.py… → 已提供 标题 + 视频:视频发布流程。 → …
  • Tasks that involve Browser testing
  • SKILL.md covers 运行方式(Playwright,headless 可用), 能力范围, 与 xhs-analyzer 的分工边界 and 风险提示(重要), plus 6 more sections
  • Calls python

What it does

Skill Xhs Publisher is an agent skill from ZJU-REAL/Easel. 将图文/视频内容发布到小红书(XHS)。基于 Playwright + 持久化登录态,headless 即可运行, 流程与选择器移植自成熟开源实现 xiaohongshu-mcp(含发布成功校验、上传完成等待、话题联想绑定、 新旧发布按钮兼容、反检测)。适用场景:发布图文笔记、发布视频、扫码登录、发布前预检。

Its SKILL.md is about 730 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `AGENTS.md`, `EASEL-META.md` and `references/commands.md`).

It sits in Testing & QA, covering Browser testing. It works with Xiaohongshu, Playwright and Model Context Protocol. The repository describes itself as: An open-source AI agent for social media — discover trends, create content, publish everywhere, and learn what works across Xiaohongshu, Douyin, Zhihu, Bilibili, and more.🎨一个开源的… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Browser testing

Example prompts

  • “/skill-xhs-publisher”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. "检查环境 / 能不能发":xhs_publish.py check。
  2. "登录 / 扫码 / 换账号":xhs_publish.py login(有头,扫码)。
  3. 已提供 标题 + 视频:视频发布流程。
  4. 已提供 标题 + 图片:图文发布流程。
  5. 只给网页 URL:先提取内容与图片/视频,产出可发布草稿,等确认。
  6. 信息不全:先补齐,不要直接发布。

What it can do on your machine

Read from SKILL.md and the folder at commit 278f420. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Xhs Publisher loads about 726 tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 44 tokens; SKILL.md has 142 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~726
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZJU-REAL/Easel at commit 278f420, republished under its Apache-2.0 licence (© ZJU-REAL). 142 words, ~726 tokens.

Download SKILL.mdSave it as .claude/skills/skill-xhs-publisher/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
skill-xhs-publisher
description
将图文/视频内容发布到小红书(XHS)。基于 Playwright + 持久化登录态,headless 即可运行, 流程与选择器移植自成熟开源实现 xiaohongshu-mcp(含发布成功校验、上传完成等待、话题联想绑定、 新旧发布按钮兼容、反检测)。适用场景:发布图文笔记、发布视频、扫码登录、发布前预检。
layer
publish

小红书发布助手(xhs-publisher)

你是"小红书发布助手"。目标是在用户确认后,调用 xhs_publish.py 完成图文/视频发布。

运行方式(Playwright,headless 可用)

统一走确定性脚本 ../../shared/scripts/xhs_publish.py(CWD=项目根)。它用 Playwright + 持久化登录态驱动小红书创作者后台,headless 即可发布——替代了旧的 CDP-to-真实Chrome 死栈 (那套需桌面 Chrome,本环境跑不了,已删除)。

依赖说明
playwright + chromium 内核本环境已装(xhs_publish.py check 验证)
已扫码登录login 把二维码抠成 PNG(默认 outputs/_login/xhs-login-qrcode.png,Web UI 可看)→ 扫码 → cookie 持久化到 ~/.easel-browser-profiles/XiaohongshuProfile
干净网络 IP小红书对机房/代理出口报「安全限制·IP存在风险」拦在登录前;需家宽/干净 IP 代理,或在正常网络登录后拷贝登录态目录复用

能力范围

  • 本 SKILL 现做:图文发布、视频发布、扫码登录、发布前预检(plan)。
  • 评论区互动(抓评论 + 回复)已拆分到 skill-xhs-comment-reply(与本 SKILL 共用登录态)。
  • 暂未移植(后续按需):首页/搜索/详情抓取、点赞/收藏/私信——选择器在参考实现里都有, 需要时再移植;"分析爆款规律/数据洞察"走 xhs-analyzer。

与 xhs-analyzer 的分工边界

  • xhs-publisher(本 SKILL) = 发布:发图文/视频。
  • xhs-comment-reply = 评论区互动:抓评论 + 回复粉丝评论。
  • xhs-analyzer = 分析:搜索规律、爆款拆解、关键词矩阵、创作者画像、限流检测。
  • 需要"实际发布"用本 SKILL;需要"回评/维护评论区"用 xhs-comment-reply;需要"分析/爆款规律"用 xhs-analyzer。

风险提示(重要)

小红书自动化发布存在被平台风控、限流、封号的风险。 默认提醒用户优先用测试号、小流量运行, 最终内容人工复核。脚本已内置反检测(--disable-blink-features=AutomationControlled + 逐字符 输入 + zh-CN 语言 + 登录态持久化),但风险不可完全消除,使用者自行评估承担。

输入判断(按顺序)

  1. "检查环境 / 能不能发":xhs_publish.py check。
  2. "登录 / 扫码 / 换账号":xhs_publish.py login(有头,扫码)。
  3. 已提供 标题 + 视频:视频发布流程。
  4. 已提供 标题 + 图片:图文发布流程。
  5. 只给网页 URL:先提取内容与图片/视频,产出可发布草稿,等确认。
  6. 信息不全:先补齐,不要直接发布。

执行流程

check(环境就绪?)
  → 未登录 → login(有头扫码,一次即可)
  → plan(dry-run 预检:标题长度/媒体路径/步骤)— 给用户确认最终标题、正文、图片/视频
  → 发布前人设检查(见下)
  → publish / publish-video --exec(首次建议加 --headed 校验选择器,OK 后 headless 复跑)
  → 成功校验(脚本内置:URL 离开 /publish/publish 才算成功)
  → 发布后留痕(见下)

发布前人设检查(有 Profile 时)

按 AGENTS.md「发布前人设一致性检查」:先用 skill-persona-check 比对待发内容 × 画像,评分喂 python skills/shared/scripts/persona_gate.py check --score 85——低于 80 分时告知分数、偏离点和 修改建议,但不阻断发布;用户已明确要发布就继续执行。

发布后留痕(供监控/归因)

python skills/shared/scripts/persona_gate.py record --topic 露营攻略 --profile 户外达人 \
  --score 85 --verdict pass
python skills/openclaw/skill-publish-log/scripts/log.py record --platform 小红书 \
  --title "周末露营攻略" --profile 户外达人 --persona-score 85 --persona-verdict pass --skill-source skill-xhs-publisher

必做约束

  • 发布前必须让用户确认最终标题、正文、图片/视频(先跑 plan 展示)。
  • 图文发布必须有图片,视频发布必须有视频;图片与视频不可混用(二选一)。
  • 标题 ≤ 20 全角字(脚本 calc_title_length 按小红书口径校验,超限直接拦下)。
  • 文件路径必须为绝对路径(脚本会解析并校验存在)。
  • 首次发布或疑似平台改版:先加 --headed 观察,校验通过再 headless 批量。
  • 发布页结构异常时,改 xhs_publish.py 顶部的 SELECTORS 字典(选择器单点集中维护, 每条标注了参考源),不要散改流程。

命令样例

全部命令(check/login/plan/publish/publish-video 参数、代理、首次校验)见 references/commands.md。

© ZJU-REAL, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in skills/openclaw/skill-xhs-publisher of ZJU-REAL/Easel.

  • SKILL.md
  • AGENTS.md
  • EASEL-META.md
  • public/whitedew.jpg
  • references/commands.md
  • todo.md

Open the folder on GitHubat commit 278f420

Compare with similar skills

Skill Xhs Publisher next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Xhs Publisher compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Xhs Publisher this skillZJU-REAL/Easel3.4k—~726Automated safety check: PassApache-2.0
Invisible Playwrightfeder-cr/invisible_dots32k—~573Automated safety check: PassMIT
Playwright E2E Testsonyx-dot-app/onyx32k1 repos~2.8kAutomated safety check: NotesCustom licence
Shogun Screenshotyohey-w/multi-agent-shogun1.4k—~901Automated safety check: NotesMIT
Playwright Debugvoicetreelab/voicetree924—~1.2kAutomated safety check: PassCustom licence
Hands On Testktnyt/cclsp675—~1.7kAutomated safety check: PassMIT

Similar skills

  • Invisible Playwright

    feder-cr/invisible_dots

    Use the Dot's browser identities for any task on a website or search on the web: which identity to use, opening and closing one, and when a plain download is simpler than a browser.

    32k GitHub stars~573 tokensUpdated today
    Testing & QAAuto-check passed
  • Playwright E2E Tests

    onyx-dot-app/onyx

    Write and maintain Playwright end-to-end tests for the Onyx application.

    32k GitHub starsUsed in 1 repo~2.8k tokens
    Testing & QAAuto-check: notes
  • Shogun Screenshot

    yohey-w/multi-agent-shogun

    スクリーンショットの取得・加工を行う。ローカルスクショから最新画像を取得、 PlaywrightでWebページをキャプチャ、画像のトリミング・リサイズ、機微情報を黒塗りマスキング。

    1.4k GitHub stars~901 tokensUpdated 2 mo ago
    Testing & QAAuto-check: notes
  • Playwright Debug

    voicetreelab/voicetree

    This skill should be used when the user asks to "debug the electron app", "connect playwright to VoiceTree", "take screenshots of the running app", "interact with the live UI", "inspect the running…

    924 GitHub stars~1.2k tokensUpdated 3 days ago
    Testing & QAAuto-check passed
  • Hands On Test

    ktnyt/cclsp

    Performs manual hands-on testing of a web application using playwright-cli.

    675 GitHub stars~1.7k tokensUpdated 7 mo ago
    Testing & QAAuto-check passed
  • E2E Verification

    Chorus-AIDLC/Chorus

    A skill your agent uses when manually verifying a Chorus frontend change in a real browser — finding local login credentials, driving the running dev server with the Playwright MCP, logging in…

    1.2k GitHub stars~1.5k tokensUpdated yesterday
    Testing & QAAuto-check: notes

More from ZJU-REAL/Easel

All 114 skills in this repo
  • Gzh Design

    ZJU-REAL/Easel

    微信公众号文章排版引擎:把 Markdown / Word(.docx) / PDF / 纯文本转成可直接粘贴进公众号编辑器的 HTML,自动章节编号、关键词标记、引言卡、目录、代码块、图片/GIF、作者签名;主题从 references/theme-index.md…

    3.4k GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • 微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。

    3.4k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Card Design

    ZJU-REAL/Easel

    社媒卡片视觉设计系统:提供配色、中文字体层级、满画幅布局、品类骨架和死空白/密度质检,避免模板化 PPT 与廉价 AI 感。

    3.4k GitHub stars~657 tokensUpdated today
    Auto-check passed
  • Ecom Details Image

    ZJU-REAL/Easel

    生成电商商品视觉方案:主图概念、场景图、详情页视觉方向和 AI 生图 Prompt. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Infographic

    ZJU-REAL/Easel

    将数据或文字内容转化为可视化信息图,支持静态(AntV)和动画 GIF 两种模式。当用户需要制作信息图、数据可视化、流程图、对比图、动画图表、GIF 图表、思维导图、SWOT 分析图时调用。本地渲染信息图/GIF 动画;要单张静态图片 URL 用 chart-visualization,要 CSV/JSON→整页报告用 data-report

    3.4k GitHub stars~643 tokensUpdated today
    Auto-check passed
  • Novel Writer

    ZJU-REAL/Easel

    长篇小说/网文连载创作:从世界观、人设和三级大纲写到逐章正文,并用文件化状态维护伏笔、前情和跨章一致性. An agent skill from ZJU-REAL/Easel.

    3.4k GitHub stars~1k tokensUpdated today
    Auto-check passed

Categories

Questions about Skill Xhs Publisher

What does Skill Xhs Publisher do?

将图文/视频内容发布到小红书(XHS)。基于 Playwright + 持久化登录态,headless 即可运行, 流程与选择器移植自成熟开源实现 xiaohongshu-mcp(含发布成功校验、上传完成等待、话题联想绑定、 新旧发布按钮兼容、反检测)。适用场景:发布图文笔记、发布视频、扫码登录、发布前预检。. Skill Xhs Publisher is an agent skill from ZJU-REAL/Easel.

When should I use Skill Xhs Publisher?

Skill Xhs Publisher fits situations like: tasks that involve Browser testing.

How do I install Skill Xhs Publisher in Claude Code?

Run `npx skills add ZJU-REAL/Easel --skill skill-xhs-publisher -a claude-code`. Or copy the skill folder (skills/openclaw/skill-xhs-publisher in ZJU-REAL/Easel) into .claude/skills/skill-xhs-publisher in your project. Claude Code loads it when a task matches its description.

How do I install Skill Xhs Publisher in Codex?

Run `npx skills add ZJU-REAL/Easel --skill skill-xhs-publisher -a codex`. Or copy the skill folder (skills/openclaw/skill-xhs-publisher in ZJU-REAL/Easel) into .agents/skills/skill-xhs-publisher in your project. Codex loads it when a task matches its description.

Can I use Skill Xhs Publisher in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZJU-REAL/Easel --skill skill-xhs-publisher -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-xhs-publisher, .gemini/skills/skill-xhs-publisher, .github/skills/skill-xhs-publisher and .opencode/skills/skill-xhs-publisher in your project.

What does Skill Xhs Publisher need to run?

Going by SKILL.md and its folder, Skill Xhs Publisher needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Skill Xhs Publisher access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Skill Xhs Publisher safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skill Xhs Publisher use?

Skill Xhs Publisher is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Xhs Publisher use?

About 726 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 986 tokens, read only when the agent opens those files.

What are the alternatives to Skill Xhs Publisher?

Skills that share tags, products or a category with Skill Xhs Publisher: Invisible Playwright (feder-cr/invisible_dots, 32k stars), Playwright E2E Tests (onyx-dot-app/onyx, 32k stars), Shogun Screenshot (yohey-w/multi-agent-shogun, 1.4k stars) and Playwright Debug (voicetreelab/voicetree, 924 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Xhs Publisher?

ZJU-REAL (a GitHub organization) maintains it in ZJU-REAL/Easel, which has 3,376 GitHub stars. The repository holds 114 skills in this directory. The repository was last updated on October 9, 2026.

Source: ZJU-REAL/Easel on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.