Xiaohongshu Extract

Overview

Extract note metadata (title, desc, type, time, user, engagement, tags, video stream info) from an XHS share or discovery URL using the bundled script.

Quick Start

Run the extractor and print JSON to stdout:

CODEBLOCK0

Write JSON to a file:

CODEBLOCK1

Output only the flattened record:

CODEBLOCK2

Write only the flattened record to a file:

CODEBLOCK3

Emit errors as JSON:

CODEBLOCK4

Emit errors as JSON to a file:

CODEBLOCK5

Workflow

1. 1. Run scripts/xiaohongshu_extract.py with the user-provided URL.
2. If the script fails to find window.__INITIAL_STATE__, ask the user for a direct discovery URL.
3. Use the JSON output to summarize note metadata or to feed downstream analysis.

Output Notes

The script returns a JSON object with:

• - note_id, title, desc, type, time, INLINECODE7
• INLINECODE8 (nickname, userid, avatar)
• INLINECODE9 (liked/collected/comment/share counts, plus normalized *num values)
• INLINECODE10
• INLINECODE11 (videoid, duration, width, height, fps, size, streamurl)
• INLINECODE12 (nested-to-flat field name map)
• INLINECODE13 (flattened record with normalized counts and ISO timestamp)

If the stream list is empty, video fields may be null or empty.

If --flat-only is set, only flat is printed. If --error-json is set, errors are emitted as JSON and may include final_url and status_code when available.

Resources

scripts/

• - scripts/xiaohongshu_extract.py extracts note metadata from XHS share/discovery URLs.