yantongding93-bot/codex-skill-save-xiaohongshu-note

codex-skill-save-xiaohongshu-note は何をしますか？

Xiaohongshu（小红书）のノートを単一または一括でMarkdownにアーカイブします。メタデータ、画像、タグ、再開機能、レポートをサポートします。

機能

• 単一アーカイブ: 指定したノートのURLを入力すると、そのノートのコンテンツ、画像、メタデータをMarkdownファイルとして保存します。
• 一括アーカイブ: 複数のノートURLをリストで指定し、一度にすべてをアーカイブできます。
• メタデータ保持: 各ノートのタイトル、著者、公開日、タグなどのメタデータをMarkdownのフロントマターとして保存します。
• 画像保存: ノート内の画像をダウンロードし、Markdown内でローカルパスを参照する形式で保存します。
• 再開機能: 一括アーカイブ処理が中断された場合、進行状況を記録し、次回実行時に中断位置から再開できます。
• レポート生成: アーカイブ完了後に、成功・失敗したノートのリストや処理時間などの詳細レポートを生成します。

使用方法

前提条件

• Python 3.8 以上
• 以下のPythonパッケージがインストールされていること:

pip install requests beautifulsoup4 markdownify

クイックスタート

1. リポジトリをクローン:

git clone https://github.com/yantongding93-bot/codex-skill-save-xiaohongshu-note.git
cd codex-skill-save-xiaohongshu-note

2. 単一ノートをアーカイブ:

python save_note.py --url "https://www.xiaohongshu.com/explore/example_note_id"

3. 一括アーカイブ（URLリストファイルを使用）:

python save_note.py --batch urls.txt

urls.txt の例:

https://www.xiaohongshu.com/explore/note_id_1
https://www.xiaohongshu.com/explore/note_id_2
https://www.xiaohongshu.com/explore/note_id_3

4. 再開機能を使用:

python save_note.py --batch urls.txt --resume

5. レポートを生成:

python save_note.py --batch urls.txt --report report.md

オプション

オプション	説明
--url	単一ノートのURLを指定
--batch	ノートURLリストのファイルを指定
--output	出力ディレクトリ（デフォルト: ./output）
--resume	以前の進行状況から再開
--report	レポートファイルのパスを指定
--help	ヘルプメッセージを表示

出力形式

各ノートは以下の構造で保存されます:

output/
├── notes/
│   ├── note_title_1/
│   │   ├── note.md
│   │   └── images/
│   │       ├── image_1.jpg
│   │       └── image_2.png
│   └── note_title_2/
│       ├── note.md
│       └── images/
│           └── image_1.jpg
└── progress.json

note.md の例:

---
title: 素敵なレシピ
author: クックちゃん
published: 2023-10-01
tags:
  - レシピ
  - 料理
---

# 素敵なレシピ

今日は簡単で美味しいレシピを紹介します！

![料理の写真](images/image_1.jpg)

材料:
- 材料A
- 材料B

作り方:
1. 材料を準備します。
2. 鍋で炒めます。
3. 完成です！

注意事項

• Xiaohongshuの利用規約を遵守してください。このツールは個人利用または正当な目的にのみ使用してください。
• 大量のノートを短時間にアーカイブすると、レート制限やIPブロックの原因となる可能性があります。適切な間隔を設けて実行してください。
• 画像の著作権に注意し、適切なクレジットを表示してください。

トラブルシューティング

問題: ノートのURLが無効です

• URLが完全で正しいことを確認してください。例えば: https://www.xiaohongshu.com/explore/note_id

問題: 画像がダウンロードされません

• ネットワーク接続を確認し、プロキシ設定が必要な場合は環境変数 HTTP_PROXY と HTTPS_PROXY を設定してください。

問題: 再開機能が動作しません

• output/progress.json ファイルが存在し、破損していないことを確認してください。

貢献

バグ報告や機能リクエストは、GitHub Issues にてお願いします。プルリクエストも歓迎します。

ライセンス

MITライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。