xiaohongshu-auto-posting
Automates the complete Xiaohongshu (XHS / Little Red Book) content operation workflow: pain-point topic collection → style case collection → topic selection → content writing → publishing → performance tracking
Install / Use
npx skills add browser-act/skills --skill xiaohongshu-auto-postingInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Tags
Our assessment of xiaohongshu-auto-posting
xiaohongshu-auto-posting scores 96/100 on our quality scale, 222nd of 2,790 Automation skills we index (top 8%).
Its SKILL.md is 15 KB long, well organised into 30 sections with 11 code examples: a thorough specification that gives an agent plenty to work with.
With 6,001 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so xiaohongshu-auto-posting is actively maintained.
- Our last check on 2026-11-15 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
xiaohongshu-auto-posting compared with similar skills
All 4 of these similar skills score higher than xiaohongshu-auto-posting; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| xiaohongshu-auto-posting (this skill)by browser-act | 96 | 6.0k | 3mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install xiaohongshu-auto-posting?
- Run
npx skills add browser-act/skills --skill xiaohongshu-auto-posting. The install tabs above show the steps for each supported agent. - Which AI agents does xiaohongshu-auto-posting work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is xiaohongshu-auto-posting safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is xiaohongshu-auto-posting still maintained?
- The repository was last updated about 3 months ago, so xiaohongshu-auto-posting is actively maintained.
Skill content
View source on GitHubname: xiaohongshu-auto-posting description: "Automates the complete Xiaohongshu (XHS / Little Red Book) content operation workflow: pain-point topic collection → style case collection → topic selection → content writing → publishing → performance tracking. Use when user mentions xiaohongshu auto posting, xhs auto post, little red book posting, xiaohongshu post, xiaohongshu auto posting, xiaohongshu content operations, xhs content marketing, post to xiaohongshu, publish on xhs, post on xiaohongshu, xiaohongshu promotion, xiaohongshu operations, xiaohongshu automation, xhs automation, track xhs performance, track xiaohongshu performance, xiaohongshu data tracking, xiaohongshu analytics, switch xhs account, update xhs keywords."
Xiaohongshu Auto-Posting (XHS Auto-Posting)
End-to-end Xiaohongshu content operation: topic discovery → style reference → writing → publishing → performance tracking.
Language
All process output to user (progress updates, questions, status notifications) follows the user's language.
Objective
Automate a complete Xiaohongshu content operation cycle for a configured product: discover high-engagement pain-point topics via search, collect writing style references, generate platform-native content aligned with the style fingerprint, publish with user approval, and track post-publish performance metrics.
Prerequisites
- Xiaohongshu creator center (
creator.xiaohongshu.com) already logged in on a configured stealth browser (browser ID stored insession_state.json) workspaces/xhs-posting/workspace (auto-created on first run)
Pre-execution Checks
1. Tool Readiness
If browser-act has been confirmed available in the current session → skip this step.
Invoke browser-act via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.
2. Login Verification
Covered in Phase 0.5 — login check is deferred until session state is loaded (Phase 0.2) and the browser is opened. If the user triggers Phase 6 directly (standalone tracking mode), still complete Phase 0.2 and Phase 0.5 first.
3. Session Lifecycle
Each execution generates a unique session name (xhs-<YYYYMMDD>-<HHMM>) to avoid cross-conversation conflicts. The session is opened once in Phase 0.5 and closed at the end of the workflow. All commands in this Skill reference the session via $SESSION — the actual name is determined at runtime.
Runtime Workspace
All runtime files (config, drafts, publish records, screenshots) are written to the user's working directory (CWD) under workspaces/xhs-posting/. This directory is auto-created on first run.
workspaces/xhs-posting/ ← relative to user CWD
├── session_state.json # account & product config
├── config/
│ └── keywords.json # keyword pool
├── tracking/
│ └── published.json # published note records
├── reports/ # performance reports
└── <YYYY-MM-DD>/ # per-run date directory
├── topics/
├── selected_topics.json
├── style_fingerprint.json
├── drafts/
└── replies/
Quick Start
/xiaohongshu-auto-posting
Standalone triggers (jump directly to the corresponding phase, skipping Phase 0–4):
"track performance"/"see data"/"data collection"→ Phase 6 performance tracking"settings"/"switch account"/"update keywords"→ Phase 0 configuration wizard
Operational Rules
Three rules that apply to every browser-act session. Violating any one causes silent failures or long hangs. Full details in references/phase5-publish.md §0.
Rule 1 — Never pipe browser-act output directly
Redirect state output to a temp file, then grep the file. Piping may background the command when output contains multi-byte characters, making the result unavailable synchronously.
# WRONG
browser-act --session $SESSION state | grep "Publish"
# CORRECT
browser-act --session $SESSION state > /tmp/s.txt 2>&1 && grep "Publish" /tmp/s.txt
Rule 2 — Escape all non-ASCII content before passing to eval --stdin
Non-ASCII literals (Chinese, emoji) in JS source cause encoding errors in the subprocess pipeline. Escape to \uXXXX first:
def to_ascii_js(s):
return ''.join(r'\u{:04x}'.format(ord(c)) if ord(c) > 127 else c for c in s)
js = to_ascii_js(open('tmp/script.js', encoding='utf-8').read())
subprocess.run([..., 'eval', '--stdin'], input=js.encode('ascii'), ...)
Rule 3 — Use click, not eval, for actions that trigger navigation
eval hangs (~30 s timeout) when the callback causes a page redirect. Always use browser-act --session $SESSION click <index> for the publish button, then verify the URL immediately after.
Phase 0 — Initialization
0.1 Tool Check
Run browser-act browser list:
- Command not found → run
uv tool upgrade browser-act-cli || uv tool install browser-act-cli --python 3.12, then continue - Returns normally → continue
0.2 Session State Load
Read workspaces/xhs-posting/session_state.json:
- File does not exist, or
browser_idis empty → proceed to 0.3 First-time Configuration Wizard - File exists and
browser_idis non-empty → load and display current config, ask user to confirm or modify
session_state.json structure:
{
"browser_id": "",
"account": {
"nickname": "",
"profile": ""
},
"product": {
"name": "",
"tagline": "",
"url": "",
"install_cmd": ""
},
"keywords_file": "workspaces/xhs-posting/config/keywords.json",
"posting": {
"daily_limit": 1,
"min_interval_hours": 6,
"last_posted_at": null
}
}
0.3 First-time Configuration Wizard (when file does not exist or browser_id is empty)
Step 1: Browser Selection
Run browser-act browser list, then:
When existing browsers are present: display all browsers (id / name / type / desc / proxy), ask the user which one to use for posting:
Existing browsers:
#1 id=xxx name="xxx" type=stealth desc="xxx" proxy=XX
#2 id=xxx name="xxx" type=chrome desc="xxx"
Select a browser number to use for posting, or enter "new" to create one:
>
When no browsers exist, or user enters "new":
- Load advanced guide:
browser-act get-skills advanced - Ask the user:
- Browser name (custom, e.g. "xhs-poster")
- Proxy requirements (needed? region or custom URL?)
- Create the browser following the advanced guide's Confirmation Gate protocol
- Record the new browser ID, continue to Step 2
Step 2: Product & Keyword Configuration
Ask the user:
- Product name (brand keyword, used in tags and body)
- Product tagline (one-sentence description)
- Product URL (website / GitHub / App Store, etc.)
- Install / usage command (optional; for SaaS products, enter the core operation path)
- Initial keywords (1–5, comma-separated, used for topic search)
Write to workspaces/xhs-posting/session_state.json and workspaces/xhs-posting/config/keywords.json, then continue to Phase 0.4.
0.4 Account Safety Check
- Read
posting.last_posted_atfromsession_state.json - If less than
min_interval_hourshave passed since the last post, notify the user and ask whether to force continue - If today's post count ≥
daily_limit, notify the user
0.5 Browser Launch & Login Verification
Generate a unique session name for this execution:
$SESSION = "xhs-<YYYYMMDD>-<HHMM>" # e.g., xhs-20260611-1430
Open the browser using the stored browser_id:
browser-act --session $SESSION browser open <browser_id> https://creator.xiaohongshu.com/new/home
browser-act --session $SESSION wait stable
Verify login: check that the current URL stays on creator.xiaohongshu.com (not redirected to the login page) and that a user avatar / nickname element is present in state.
- Not logged in → instruct the user to scan the QR code in
--headedmode:
Wait for the user to confirm login, then continue.browser-act --session $SESSION browser open <browser_id> https://creator.xiaohongshu.com/new/home --headed
Phase 1 — Pain-Point Topic Collection
Full execution parameters: references/phase1-topic-collection.md.
Overview:
- Keyword rotation: read the next keyword from
config/keywords.json(sequential mode) - XHS search: search the keyword, sort by hottest, collect metadata for the top 10–15 notes
- Listing Pass: extract shallow fields directly from search results (title, likes, collects, comments, snippet)
- Engagement scoring:
score = likes + collects × 2 + comments × 1.5 - Top 5 Deep: click into the top 5 notes and extract deep fields (key quote, pain description, topic tags)
- Generate report: output
workspaces/xhs-posting/<date>/topics/TOPICS_<kw-slug>.md - Display Top 5 and wait for user selection
Phase 2 — Top Case Collection (Style Reference)
Full execution parameters: references/phase2-case-collection.md.
Overview:
- Use the same search results as Phase 1; no additional request needed
- Collect full text from the top 3 high-engagement notes (title + body + tags)
- Analyze writing style: opening type, paragraph rhythm, emoji density, topic tag strategy
- Generate Style Fingerprint
- Write style fingerprint to
workspaces/xhs-posting/<date>/style_fingerprint.json
Phase 2 runs in parallel with Phase 1 (shared search results, different analysis angle).
Phase 3 — Topic Selection
After displaying the Phase 1 Top 5, ask the user:
Here are the Top 5 topics. Which ones do you want to write?
(enter numbers like "1 3"; "all" for all; "skip" to pass today)
>
On receiving the reply:
- Write the selected topic list to
workspaces/xhs-posting/<date>/selected_topics.json - For each selected topic, confirm the publish strategy (publish now / save as draft)
If the user enters "skip" → end this run without advancing last_index.
Phase 4 — Content Writing
Full writing guidelines: references/phase4-writing.md.
Write one draft per selected topic, show a preview after each draft and wait for user approval before moving to the next.
Writing framework: Pain resonance → Struggle / attempts → Product discovery → Concrete proof → Call to action
Hard requirements:
- Title ≤ 20 characters (must use native setter when writing; see
references/phase5-publish.md §5) - Body ≤ 1000 characters, clear paragraphs
- Topic tags: 3–5, covering keyword + product brand + scene term
- Must include a closing CTA (comment / save / follow)
Pre-Write Gate (confirm all items before writing begins):
key_quoteextracted from Phase 1 deep passpain_descriptionconfirmed from Phase 1tools_triedconfirmed from Phase 1- Product info (name, install command) read from
session_state.json - Style fingerprint (
style_fingerprint.json) read
After writing, generate an HTML preview (see references/phase4-writing.md §7), display it in the conversation, then ask:
Preview above. Ready to publish?
- "ok" / "publish" — proceed to Phase 5 publishing
- "edit: <instruction>" — revise per instruction and re-preview
- "draft" — save as draft, do not publish
Phase 5 — Publishing
Full execution parameters: references/phase5-publish.md.
Overview:
- Image generation: use XHS Creator Center's built-in "Text-to-Image" feature to auto-generate a cover (recommended), or read a user-provided local image
- Image upload (external image): two-step upload —
GET permit → PUT file— to obtainfile_id - Content Verification Gate: title ≤ 20 characters, body non-empty, topic tags present
- Fill Creator Center: navigate → paste content → add topics → set cover
- Publish: click the "Publish" button
- Capture publish URL: extract
note_idfrom the redirect URL or page - Write record: update `workspaces/xhs-posting/<date>/publish
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
