xhs-note

Extract Xiaohongshu post content and save it as a Markdown note.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/Wanger-SJTU/claw_skills --skill xhs-note
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xhs-note
Source: https://github.com/Wanger-SJTU/claw_skills/tree/main/xhs-note
Command: npx skills add https://github.com/Wanger-SJTU/claw_skills --skill xhs-note

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Automates capturing Xiaohongshu post content (text and images) and saving it as a clean Markdown file, reducing manual copy-paste and post-formatting work.

Core Features & Use Cases

  • Automated post-to-Markdown conversion: fetches post data, converts it into a structured Markdown note with title, content, images, author, date, and engagement metrics.
  • Flexible URL support: works with multiple Xiaohongshu URL formats (explore, discovery, search_result, and short links) and can resolve redirects.
  • Local storage with metadata: saves the Markdown file in a user-specified directory with a date-based filename for easy organization.

Quick Start

Run the script with a Xiaohongshu post URL and an optional output directory to generate a Markdown note locally.

Frequently Asked Questions about xhs-note

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

FAQPage Schema
How do I save a Xiaohongshu post as a Markdown note?▼

To save a Xiaohongshu post as a Markdown note, provide the post URL and an output directory to the script. It extracts text, images, author, date, and engagement metrics, saving them locally in a structured Markdown file.

Do I need cookies to scrape Xiaohongshu post content?▼

Yes, you need cookies to scrape Xiaohongshu post content. The script requires a ~/cookies.json file for authentication to successfully access and parse the post's __INITIAL_STATE__ data.

What Xiaohongshu URL formats are supported for web scraping?▼

Supported Xiaohongshu URL formats for web scraping include explore, discovery, search_result, and short links. The script can automatically resolve redirects from these formats to extract the target post data.

Does Xiaohongshu note generation require a specific Python environment?▼

Xiaohongshu note generation requires Python 3 installed in your environment. Along with the Python 3 runtime, you need to ensure the ~/cookies.json authentication file is configured correctly before running the script.

What metadata is included when converting Xiaohongshu posts to Markdown?▼

When converting Xiaohongshu posts to Markdown, the extracted metadata includes the post title, author, publication date, images, and engagement metrics. This data is parsed directly from the page's __INITIAL_STATE__ object.

How are extracted Xiaohongshu Markdown notes organized locally?▼

Extracted Xiaohongshu Markdown notes are organized locally by saving them in a user-specified output directory. The script automatically generates a date-based filename for each note to ensure easy chronological organization.