xiaohongshu-downloader

Xiaohongshu 動画ダウンローダー＆要約ツール

Xiaohongshu（小红书／RedNote）から動画をダウンロードし、必要に応じて動画＋音声＋字幕＋文字起こし＋AI 要約を含むリソース一式を生成します。

ワークフロー

次の6つの手順を順番に実行します。

手順 1：依存関係を確認する

必要なツールがインストールされていることを確認します。

yt-dlp --version
ffmpeg -version

両方とも使用できる必要があります。インストールされていない場合は、ユーザーに次のコマンドでインストールするよう案内してください。

• brew install yt-dlp（macOS）または pip install yt-dlp
• brew install ffmpeg（macOS）

手順 2：動画情報を取得する

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

利用可能な形式を表示し、Cookie 認証を使って URL が機能することを確認します。

手順 3：動画をダウンロードして音声を抽出する

基本ダウンロード（動画のみ、v1.0 との後方互換性あり）の場合：

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

リソース一式（動画＋音声＋字幕＋文字起こし）の場合：

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

リソース一式＋AI 要約の準備の場合：

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

--full フラグを指定すると、次のファイルを含む ~/Downloads/<video title>/ フォルダーが作成されます。

• video.mp4 — 元の動画
• audio.mp3 — 抽出した音声
• subtitle.vtt — WebVTT 字幕（3段階の方法で取得）
• transcript.txt — テキスト形式の文字起こし

--summary フラグは --full を暗黙的に有効にし、さらに AI 要約の生成用に .meta.json を保存します。

手順 4：字幕を取得する（自動 — 3段階の方法）

スクリプトは次の方法を順番に自動で試します。

1. 手動字幕 — yt-dlp --write-subs --sub-lang zh,en,zh-Hans,zh-CN
2. 自動生成字幕 — yt-dlp --write-auto-subs
3. Whisper によるローカル文字起こし — faster-whisper を使用する parallel_transcribe.py にフォールバックします。

手順 5：文字起こしを生成する（自動）

スクリプトは VTT からタイムスタンプを自動的に削除し、transcript.txt を生成します。

手順 6：AI 要約（Claude が summary.md を生成）

ユーザーが要約をリクエストした場合（--summary フラグを指定した場合、または「要約して」と依頼した場合）：

1. 文字起こしファイルを読み込みます。

   ~/Downloads/<video title>/transcript.txt
   

2. メタデータファイルを読み込みます。

   ~/Downloads/<video title>/.meta.json
   

3. 要約プロンプトのテンプレートを読み込みます。

   reference/summary-prompt.md
   

4. テンプレートのプレースホルダーを実際の値に置き換えます。

   • {{TITLE}} — .meta.json から取得
   • {{URL}} — .meta.json から取得
   • {{DURATION}} — .meta.json から取得
   • {{PLATFORM}} — "Xiaohongshu (小红书)"
   • {{TRANSCRIPT}} — transcript.txt の内容

5. テンプレートの構成に従って要約を生成します。

6. 結果を次の場所に保存します。

   ~/Downloads/<video title>/summary.md
   

オプション一覧

オプション	説明	デフォルト
-o, --output	出力ディレクトリ	~/Downloads
-q, --quality	動画の画質（best、1080p、720p、480p）	best
--browser	Cookie 取得に使用するブラウザー（chrome、firefox、safari、none）	chrome
-a, --audio-only	音声のみを MP3 形式でダウンロード	false
--list-formats	利用可能な形式を一覧表示	false
--full	リソース一式モード	false
--summary	AI 要約モード（--full を暗黙的に有効化）	false

出力構成

基本モード（デフォルト）

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

リソース一式モード（--full または --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)

対応 URL 形式

形式	例
Explore リンク	https://www.xiaohongshu.com/explore/676a35670000000013002578
Discovery リンク	https://www.xiaohongshu.com/discovery/item/676a35670000000013002578?xsec_token=TOKEN
短縮リンク	http://xhslink.com/a/xxxxx

トラブルシューティング

問題	解決方法
No video formats found	まずブラウザーで xiaohongshu.com にログインし、--browser chrome を使用してください
Unable to extract initial state	CAPTCHA が表示されています。ブラウザーで URL を開いて認証を完了し、再試行してください
リンクの有効期限切れ	新しい共有リンクをコピーしてください（トークンには有効期限があります）
字幕が見つからない	スクリプトは自動的に Whisper による文字起こしにフォールバックします
Whisper が利用できない	依存関係を自動管理するには、uv をインストールしてください（brew install uv）

重要な注意事項

• 最良の結果を得るには、必ずxsec_tokenを含む完全な共有URLを使用してください
• ダウンロードする前に、ブラウザーでxiaohongshu.comにログインしてください
• 動画の最大画質は通常1080pです（プラットフォームの制限）
• Whisperによる文字起こしには、自動依存関係管理用のuv、または手動でインストールしたfaster-whisperが必要です
• 著作権およびXiaohongshuの利用規約を遵守してください