xhs-capture

Capture Xiaohongshu notes into Obsidian inbox as structured Markdown files.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/fanlf1/wiki --skill xhs-capture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xhs-capture
Source: https://github.com/fanlf1/wiki/tree/main/tools/hermes/article-capture-bundle-v2/xhs-capture
Command: npx skills add https://github.com/fanlf1/wiki --skill xhs-capture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual work of saving Xiaohongshu notes by turning shared links into structured Markdown files in your Obsidian inbox.

Core Features & Use Cases

  • Link resolution: Handles xhslink.com short links and full Xiaohongshu URLs by resolving the final note ID.
  • Content capture: Extracts title, author, tags, body text, and source information for a clean note record.
  • Fallback handling: Creates a useful placeholder note when the content is blocked by App-only restrictions or IP-based limits.
  • Use case: Save a single reference note or batch-process multiple Xiaohongshu links into dated inbox files for later review.

Quick Start

Give the assistant a Xiaohongshu link and ask it to capture the note into Obsidian inbox.

Frequently Asked Questions about xhs-capture

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

FAQPage Schema
How do I save a Xiaohongshu note into Obsidian as a Markdown file?

To save a Xiaohongshu note into Obsidian, provide the note link to the assistant for content capture. The tool resolves the URL, extracts the title, author, tags, and body text, and writes a structured Markdown file with standardized frontmatter directly into your Obsidian inbox.

Can I capture xhslink.com short links into Obsidian, or do I need the full URL?

You can capture xhslink.com short links into Obsidian without needing the full URL. The link resolution mechanism handles both short links and full Xiaohongshu URLs by automatically resolving the final note ID to extract the required content.

What happens when web scraping a Xiaohongshu note hits an App-only restriction or IP limit?

When web scraping encounters an App-only restriction or IP limit, the tool executes fallback handling. Instead of failing, it creates a useful placeholder note in your Obsidian inbox containing the available source and shorturl fields for later review.

What's the best way to batch capture multiple Xiaohongshu links for content ingestion?

The best way to batch capture multiple Xiaohongshu links is to provide them together for batch processing. The tool resolves each redirect, extracts the metadata and body content, and writes standardized Markdown files into dated inbox folders for later review.

Does the captured Xiaohongshu note include frontmatter and source fields?

Yes, the captured Xiaohongshu note includes standardized frontmatter and source fields. The content capture process extracts the title, author, tags, and body text, writing structured Markdown files with specific source and shorturl fields for accurate record keeping.