Xiaohongshu Cli
Operate the `xhs` Xiaohongshu CLI from the terminal for platform workflows tied to Little Red Book.
Overview
xiaohongshu-cli is an agent skill for the Grow phase that helps solo builders use the `xhs` terminal client for Xiaohongshu (Little Red Book) workflows.
Install
npx skills add https://github.com/jackwener/xiaohongshu-cli --skill xiaohongshu-cliWhat is this skill?
- Python-packaged CLI invoked as `xhs` with `--version` for support triage
- Issue templates expect verbose reproduction via `xhs -v <command>` for debugging
- Cross-platform support paths for macOS, Linux, and Windows
- Pip-based install surface (`xiaohongshu-cli`) for indie tooling stacks
Adoption & trust: 907 installs on skills.sh; 2.2k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need to work with Xiaohongshu from the command line but lack structured agent guidance for the `xhs` CLI and debugging flags.
Who is it for?
Indie builders automating or debugging Xiaohongshu tasks via a Python CLI on desktop OSes.
Skip if: Teams not targeting Xiaohongshu, purely in-app UI work, or workflows that require a full SKILL.md the catalog has not yet mirrored.
When should I use this skill?
When automating or debugging Xiaohongshu operations via the `xhs` CLI (confirm triggers in upstream SKILL.md).
What do I get? / Deliverables
Agents run and troubleshoot `xhs` commands with version-aware, reproducible steps instead of guessing API behavior.
- Documented `xhs` command sequences
- Reproducible debug transcripts using `xhs -v`
Recommended Skills
Journey fit
Social and content distribution for a shipped product typically happens in Grow when you publish and maintain presence on channels like Xiaohongshu. A Xiaohongshu-focused CLI maps to content operations—posting, fetching, or automating tasks on that network rather than building core product code.
How it compares
CLI integration skill for one social platform—not a general SEO or multi-channel marketing suite.
Common Questions / FAQ
Who is xiaohongshu-cli for?
Solo and indie builders who distribute or operate content on Xiaohongshu and prefer terminal automation with the `xhs` tool.
When should I use xiaohongshu-cli?
Use it in Grow (content or distribution) when scripting, debugging, or documenting `xhs` CLI usage; not during core product build unless you embed CLI tooling in your repo.
Is xiaohongshu-cli safe to install?
CLI skills may imply network and account access—review the Security Audits panel on this Prism page and read upstream source before granting agent permissions.
SKILL.md
READMESKILL.md - Xiaohongshu Cli
name: Bug Report description: Report a bug or unexpected behavior labels: ["bug"] body: - type: input id: version attributes: label: Version description: "Run `xhs --version` or `pip show xiaohongshu-cli | grep Version`" placeholder: "e.g. 1.0.0" validations: required: true - type: dropdown id: os attributes: label: Operating System options: - macOS - Linux - Windows - Other validations: required: true - type: textarea id: description attributes: label: What happened? description: Describe the bug clearly. validations: required: true - type: textarea id: expected attributes: label: Expected behavior description: What did you expect to happen? validations: required: true - type: textarea id: reproduce attributes: label: Steps to reproduce description: "Commands or steps to reproduce the issue. Use `xhs -v <command>` for debug output." render: bash - type: textarea id: logs attributes: label: Error output / logs description: Paste any error messages or verbose output here. render: text name: Feature Request description: Suggest a new feature or improvement labels: ["enhancement"] body: - type: input id: version attributes: label: Current version description: "Run `xhs --version` or `pip show xiaohongshu-cli | grep Version`" placeholder: "e.g. 1.0.0" validations: required: false - type: textarea id: description attributes: label: Describe the feature description: What would you like to see added or changed? validations: required: true - type: textarea id: use_case attributes: label: Use case description: Why do you need this feature? How would you use it? name: CI on: push: branches: [main] pull_request: branches: [main] workflow_call: jobs: lint-and-test: name: Lint and test (Python ${{ matrix.python-version }}) runs-on: ubuntu-latest strategy: fail-fast: false matrix: python-version: ["3.10", "3.12", "3.13"] steps: - uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v5 with: python-version: ${{ matrix.python-version }} - name: Install uv uses: astral-sh/setup-uv@v6 - name: Install dependencies run: uv sync --extra dev - name: Run ruff run: uv run ruff check . - name: Run tests run: uv run python -m pytest -q --ignore=tests/test_integration.py build: name: Build package runs-on: ubuntu-latest needs: lint-and-test steps: - uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v5 with: python-version: "3.12" - name: Install uv uses: astral-sh/setup-uv@v6 - name: Install dependencies run: uv sync --extra dev - name: Build distribution run: uv build name: Publish to PyPI on: push: tags: - "v*" workflow_dispatch: jobs: verify: uses: ./.github/workflows/ci.yml publish: needs: verify runs-on: ubuntu-latest environment: pypi permissions: id-token: write steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 with: python-version: "3.12" - name: Setup uv uses: astral-sh/setup-uv@v6 - name: Build package run: uv build - name: Publish to PyPI uses: pypa/gh-action-pypi-publish@release/v1 __pycache__/ *.pyc .venv/ dist/ *.egg-info/ .ruff_cache/ .mypy_cache/ .pytest_cache/ .playwright-mcp/ xhs_login_page.png # xiaohongshu-cli [](https://github.com/jackwener/xiaohongshu-cli/actions/workflows/ci.yml) [![PyPI