# Send 小红书视频下载器 to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "xiaohongshu-downloader",
    "name": "小红书视频下载器",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/smile7up/xiaohongshu-downloader",
    "canonicalUrl": "https://clawhub.ai/smile7up/xiaohongshu-downloader",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/xiaohongshu-downloader",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xiaohongshu-downloader",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "reference/summary-prompt.md",
      "scripts/download_xiaohongshu.py",
      "scripts/parallel_transcribe.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/xiaohongshu-downloader"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/xiaohongshu-downloader",
    "downloadUrl": "https://openagent3.xyz/downloads/xiaohongshu-downloader",
    "agentUrl": "https://openagent3.xyz/skills/xiaohongshu-downloader/agent",
    "manifestUrl": "https://openagent3.xyz/skills/xiaohongshu-downloader/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/xiaohongshu-downloader/agent.md"
  }
}
```
## Documentation

### Xiaohongshu Video Downloader & Summarizer

Download videos from Xiaohongshu (小红书/RedNote) and optionally generate a full resource pack: video + audio + subtitles + transcript + AI summary.

### Workflow

Follow these 6 steps in order:

### Step 1: Check Dependencies

Verify required tools are installed:

yt-dlp --version
ffmpeg -version

Both must be available. If missing, instruct the user to install:

brew install yt-dlp (macOS) or pip install yt-dlp
brew install ffmpeg (macOS)

### Step 2: Get Video Information

/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py "URL" --list-formats

This shows available formats and verifies the URL works with cookie authentication.

### Step 3: Download Video + Extract Audio

For basic download (video only, backward compatible with v1.0):

/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py "URL"

For full resource pack (video + audio + subtitles + transcript):

/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py "URL" --full

For full resource pack + AI summary preparation:

/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py "URL" --summary

The --full flag creates a folder ~/Downloads/<video title>/ containing:

video.mp4 — original video
audio.mp3 — extracted audio
subtitle.vtt — WebVTT subtitles (via 3-tier strategy)
transcript.txt — plain text transcription

The --summary flag implies --full and additionally saves .meta.json for AI summary generation.

### Step 4: Subtitle Acquisition (Automatic — 3-Tier Strategy)

The script automatically tries these strategies in order:

Manual subtitles — yt-dlp --write-subs --sub-lang zh,en,zh-Hans,zh-CN
Auto-generated subtitles — yt-dlp --write-auto-subs
Whisper local transcription — Falls back to parallel_transcribe.py using faster-whisper

### Step 5: Generate Transcript (Automatic)

The script automatically strips timestamps from VTT to produce transcript.txt.

### Step 6: AI Summary (Claude generates summary.md)

If the user requested a summary (via --summary flag or by asking to "summarize"):

Read the transcript file:
~/Downloads/<video title>/transcript.txt



Read the metadata file:
~/Downloads/<video title>/.meta.json



Read the summary prompt template:
reference/summary-prompt.md



Replace the template placeholders with actual values:

{{TITLE}} — from .meta.json
{{URL}} — from .meta.json
{{DURATION}} — from .meta.json
{{PLATFORM}} — "Xiaohongshu (小红书)"
{{TRANSCRIPT}} — contents of transcript.txt



Generate the summary following the template structure.


Save the result to:
~/Downloads/<video title>/summary.md

### Options Reference

OptionDescriptionDefault-o, --outputOutput directory~/Downloads-q, --qualityVideo quality (best, 1080p, 720p, 480p)best--browserBrowser for cookies (chrome, firefox, safari, none)chrome-a, --audio-onlyDownload audio only as MP3false--list-formatsList available formatsfalse--fullFull resource pack modefalse--summaryAI summary mode (implies --full)false

### Basic mode (default)

~/Downloads/
└── <title> [<id>].mp4

### Full resource pack mode (--full or --summary)

~/Downloads/<video title>/
├── video.mp4          # Original video
├── audio.mp3          # Extracted audio
├── subtitle.vtt       # WebVTT subtitles
├── transcript.txt     # Plain text transcript
├── .meta.json         # Video metadata (--summary only)
└── summary.md         # AI-generated summary (--summary only, written by Claude)

### Supported URL Formats

FormatExampleExplore linkhttps://www.xiaohongshu.com/explore/676a35670000000013002578Discovery linkhttps://www.xiaohongshu.com/discovery/item/676a35670000000013002578?xsec_token=TOKENShort linkhttp://xhslink.com/a/xxxxx

### Troubleshooting

ProblemSolutionNo video formats foundLog into xiaohongshu.com in browser first, use --browser chromeUnable to extract initial stateCAPTCHA triggered — open URL in browser, solve it, retryLink expiredCopy fresh share link (tokens expire)No subtitles foundScript will fall back to Whisper transcription automaticallyWhisper not availableInstall uv (brew install uv) for automatic dependency management

### Important Notes

Always use the full share URL (with xsec_token) for best results
Log into xiaohongshu.com in your browser before downloading
Maximum video quality is typically 1080p (platform limitation)
Whisper transcription requires uv for automatic dependency management, or faster-whisper installed manually
Respect copyright and Xiaohongshu's terms of service
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: smile7up
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/xiaohongshu-downloader)
- [Send to Agent page](https://openagent3.xyz/skills/xiaohongshu-downloader/agent)
- [JSON manifest](https://openagent3.xyz/skills/xiaohongshu-downloader/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/xiaohongshu-downloader/agent.md)
- [Download page](https://openagent3.xyz/downloads/xiaohongshu-downloader)