{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/xiaohongshu-downloader",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xiaohongshu-downloader",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "reference/summary-prompt.md",
      "scripts/download_xiaohongshu.py",
      "scripts/parallel_transcribe.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/xiaohongshu-downloader",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Xiaohongshu Video Downloader & Summarizer",
        "body": "Download videos from Xiaohongshu (小红书/RedNote) and optionally generate a full resource pack: video + audio + subtitles + transcript + AI summary."
      },
      {
        "title": "Workflow",
        "body": "Follow these 6 steps in order:"
      },
      {
        "title": "Step 1: Check Dependencies",
        "body": "Verify required tools are installed:\n\nyt-dlp --version\nffmpeg -version\n\nBoth must be available. If missing, instruct the user to install:\n\nbrew install yt-dlp (macOS) or pip install yt-dlp\nbrew install ffmpeg (macOS)"
      },
      {
        "title": "Step 2: Get Video Information",
        "body": "/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py \"URL\" --list-formats\n\nThis shows available formats and verifies the URL works with cookie authentication."
      },
      {
        "title": "Step 3: Download Video + Extract Audio",
        "body": "For basic download (video only, backward compatible with v1.0):\n\n/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py \"URL\"\n\nFor full resource pack (video + audio + subtitles + transcript):\n\n/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py \"URL\" --full\n\nFor full resource pack + AI summary preparation:\n\n/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py \"URL\" --summary\n\nThe --full flag creates a folder ~/Downloads/<video title>/ containing:\n\nvideo.mp4 — original video\naudio.mp3 — extracted audio\nsubtitle.vtt — WebVTT subtitles (via 3-tier strategy)\ntranscript.txt — plain text transcription\n\nThe --summary flag implies --full and additionally saves .meta.json for AI summary generation."
      },
      {
        "title": "Step 4: Subtitle Acquisition (Automatic — 3-Tier Strategy)",
        "body": "The script automatically tries these strategies in order:\n\nManual subtitles — yt-dlp --write-subs --sub-lang zh,en,zh-Hans,zh-CN\nAuto-generated subtitles — yt-dlp --write-auto-subs\nWhisper local transcription — Falls back to parallel_transcribe.py using faster-whisper"
      },
      {
        "title": "Step 5: Generate Transcript (Automatic)",
        "body": "The script automatically strips timestamps from VTT to produce transcript.txt."
      },
      {
        "title": "Step 6: AI Summary (Claude generates summary.md)",
        "body": "If the user requested a summary (via --summary flag or by asking to \"summarize\"):\n\nRead the transcript file:\n~/Downloads/<video title>/transcript.txt\n\n\n\nRead the metadata file:\n~/Downloads/<video title>/.meta.json\n\n\n\nRead the summary prompt template:\nreference/summary-prompt.md\n\n\n\nReplace the template placeholders with actual values:\n\n{{TITLE}} — from .meta.json\n{{URL}} — from .meta.json\n{{DURATION}} — from .meta.json\n{{PLATFORM}} — \"Xiaohongshu (小红书)\"\n{{TRANSCRIPT}} — contents of transcript.txt\n\n\n\nGenerate the summary following the template structure.\n\n\nSave the result to:\n~/Downloads/<video title>/summary.md"
      },
      {
        "title": "Options Reference",
        "body": "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"
      },
      {
        "title": "Basic mode (default)",
        "body": "~/Downloads/\n└── <title> [<id>].mp4"
      },
      {
        "title": "Full resource pack mode (--full or --summary)",
        "body": "~/Downloads/<video title>/\n├── video.mp4          # Original video\n├── audio.mp3          # Extracted audio\n├── subtitle.vtt       # WebVTT subtitles\n├── transcript.txt     # Plain text transcript\n├── .meta.json         # Video metadata (--summary only)\n└── summary.md         # AI-generated summary (--summary only, written by Claude)"
      },
      {
        "title": "Supported URL Formats",
        "body": "FormatExampleExplore linkhttps://www.xiaohongshu.com/explore/676a35670000000013002578Discovery linkhttps://www.xiaohongshu.com/discovery/item/676a35670000000013002578?xsec_token=TOKENShort linkhttp://xhslink.com/a/xxxxx"
      },
      {
        "title": "Troubleshooting",
        "body": "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"
      },
      {
        "title": "Important Notes",
        "body": "Always use the full share URL (with xsec_token) for best results\nLog into xiaohongshu.com in your browser before downloading\nMaximum video quality is typically 1080p (platform limitation)\nWhisper transcription requires uv for automatic dependency management, or faster-whisper installed manually\nRespect copyright and Xiaohongshu's terms of service"
      }
    ],
    "body": "Xiaohongshu Video Downloader & Summarizer\n\nDownload videos from Xiaohongshu (小红书/RedNote) and optionally generate a full resource pack: video + audio + subtitles + transcript + AI summary.\n\nWorkflow\n\nFollow these 6 steps in order:\n\nStep 1: Check Dependencies\n\nVerify required tools are installed:\n\nyt-dlp --version\nffmpeg -version\n\n\nBoth must be available. If missing, instruct the user to install:\n\nbrew install yt-dlp (macOS) or pip install yt-dlp\nbrew install ffmpeg (macOS)\nStep 2: Get Video Information\n/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py \"URL\" --list-formats\n\n\nThis shows available formats and verifies the URL works with cookie authentication.\n\nStep 3: Download Video + Extract Audio\n\nFor basic download (video only, backward compatible with v1.0):\n\n/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py \"URL\"\n\n\nFor full resource pack (video + audio + subtitles + transcript):\n\n/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py \"URL\" --full\n\n\nFor full resource pack + AI summary preparation:\n\n/opt/homebrew/Caskroom/miniconda/base/envs/myenv/bin/python scripts/download_xiaohongshu.py \"URL\" --summary\n\n\nThe --full flag creates a folder ~/Downloads/<video title>/ containing:\n\nvideo.mp4 — original video\naudio.mp3 — extracted audio\nsubtitle.vtt — WebVTT subtitles (via 3-tier strategy)\ntranscript.txt — plain text transcription\n\nThe --summary flag implies --full and additionally saves .meta.json for AI summary generation.\n\nStep 4: Subtitle Acquisition (Automatic — 3-Tier Strategy)\n\nThe script automatically tries these strategies in order:\n\nManual subtitles — yt-dlp --write-subs --sub-lang zh,en,zh-Hans,zh-CN\nAuto-generated subtitles — yt-dlp --write-auto-subs\nWhisper local transcription — Falls back to parallel_transcribe.py using faster-whisper\nStep 5: Generate Transcript (Automatic)\n\nThe script automatically strips timestamps from VTT to produce transcript.txt.\n\nStep 6: AI Summary (Claude generates summary.md)\n\nIf the user requested a summary (via --summary flag or by asking to \"summarize\"):\n\nRead the transcript file:\n\n~/Downloads/<video title>/transcript.txt\n\n\nRead the metadata file:\n\n~/Downloads/<video title>/.meta.json\n\n\nRead the summary prompt template:\n\nreference/summary-prompt.md\n\n\nReplace the template placeholders with actual values:\n\n{{TITLE}} — from .meta.json\n{{URL}} — from .meta.json\n{{DURATION}} — from .meta.json\n{{PLATFORM}} — \"Xiaohongshu (小红书)\"\n{{TRANSCRIPT}} — contents of transcript.txt\n\nGenerate the summary following the template structure.\n\nSave the result to:\n\n~/Downloads/<video title>/summary.md\n\nOptions Reference\nOption\tDescription\tDefault\n-o, --output\tOutput directory\t~/Downloads\n-q, --quality\tVideo quality (best, 1080p, 720p, 480p)\tbest\n--browser\tBrowser for cookies (chrome, firefox, safari, none)\tchrome\n-a, --audio-only\tDownload audio only as MP3\tfalse\n--list-formats\tList available formats\tfalse\n--full\tFull resource pack mode\tfalse\n--summary\tAI summary mode (implies --full)\tfalse\nOutput Structure\nBasic mode (default)\n~/Downloads/\n└── <title> [<id>].mp4\n\nFull resource pack mode (--full or --summary)\n~/Downloads/<video title>/\n├── video.mp4          # Original video\n├── audio.mp3          # Extracted audio\n├── subtitle.vtt       # WebVTT subtitles\n├── transcript.txt     # Plain text transcript\n├── .meta.json         # Video metadata (--summary only)\n└── summary.md         # AI-generated summary (--summary only, written by Claude)\n\nSupported URL Formats\nFormat\tExample\nExplore link\thttps://www.xiaohongshu.com/explore/676a35670000000013002578\nDiscovery link\thttps://www.xiaohongshu.com/discovery/item/676a35670000000013002578?xsec_token=TOKEN\nShort link\thttp://xhslink.com/a/xxxxx\nTroubleshooting\nProblem\tSolution\nNo video formats found\tLog into xiaohongshu.com in browser first, use --browser chrome\nUnable to extract initial state\tCAPTCHA triggered — open URL in browser, solve it, retry\nLink expired\tCopy fresh share link (tokens expire)\nNo subtitles found\tScript will fall back to Whisper transcription automatically\nWhisper not available\tInstall uv (brew install uv) for automatic dependency management\nImportant Notes\nAlways use the full share URL (with xsec_token) for best results\nLog into xiaohongshu.com in your browser before downloading\nMaximum video quality is typically 1080p (platform limitation)\nWhisper transcription requires uv for automatic dependency management, or faster-whisper installed manually\nRespect copyright and Xiaohongshu's terms of service"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/smile7up/xiaohongshu-downloader",
    "publisherUrl": "https://clawhub.ai/smile7up/xiaohongshu-downloader",
    "owner": "smile7up",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}