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.