xhs-cli

Interact with Xiaohongshu via a headless browser command-line interface.

638|64|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/jackwener/xhs-cli --skill xhs-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xhs-cli
Source: https://github.com/jackwener/xhs-cli/tree/main
Command: npx skills add https://github.com/jackwener/xhs-cli --skill xhs-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires camoufox[geoip], playwright, browser-cookie3, qrcode, click, rich, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to interact with Xiaohongshu (小红书) directly from your terminal, automating tasks like searching for content, viewing profiles, and engaging with posts without needing to open a web browser.

Core Features & Use Cases

  • Content Discovery: Search for notes by keyword, browse recommended feeds, and explore topics.
  • User Interaction: View user profiles, their posts, followers, and following lists.
  • Engagement: Like, unlike, favorite, unfavorite, comment on, and delete notes.
  • Content Creation: Publish new image notes directly from the command line.
  • Use Case: A social media manager can quickly check trending topics or gather data on user engagement for Xiaohongshu campaigns without manual browsing.

Quick Start

Use the xhs-cli skill to search for notes about "咖啡".

Frequently Asked Questions about xhs-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search and view Xiaohongshu notes from the command line?

You can search Xiaohongshu notes from the command line using a headless browser interface. It enables searching notes by keyword, browsing recommended feeds, and exploring topics directly from your terminal without manual browsing.

Can I automate Xiaohongshu engagement actions like liking and commenting?

Yes, you can automate Xiaohongshu engagement actions from the terminal. The interface supports liking, unliking, favoriting, unfavoriting, commenting on, and deleting notes to streamline social media management tasks.

How does authentication work for a Xiaohongshu CLI tool?

Authentication for the Xiaohongshu CLI works via browser cookies or QR code login. The system features automatic token caching, allowing subsequent operations to execute without requiring repeated manual logins.

Do I need a headless browser to scrape Xiaohongshu content?

Yes, a headless browser is required to interact with Xiaohongshu content. The skill relies on Playwright and Camoufox dependencies to automate content discovery and user interaction tasks from the terminal.

What is the best way to publish image notes to Xiaohongshu automatically?

The best way to publish image notes automatically is through a command-line interface. This skill supports content creation by allowing you to publish new image notes directly from the terminal.

What are the limitations of managing Xiaohongshu favorites via a CLI?

Managing Xiaohongshu favorites via a CLI is limited to basic actions like favoriting and unfavoriting notes. Complex graphical interactions are restricted because the tool operates through a headless browser environment.