rednote-skill

Rednote スキル

このスキルを使用すると、Xiaohongshu（Little Red Book）プラットフォームを完全に操作できます。キーワードで投稿を検索して結果を返したり、特定のノートの内容を構造化された Markdown 形式で抽出したり、「いいね」、コメント、収集、ユーザーのフォローなどのエンゲージメント操作を実行したりできます。

設定と準備

要件

• Python 3.7+
• Playwright（pip install playwright でインストール）
• Playwright ドライバー（playwright install でインストール）
• 設定済みのブラウザー環境

必ず最初に実行すること

このスキルを使用する前に、システムがログイン状態を確認します。

python scripts/validate_cookies.py

出力が True の場合、通常どおりアクセスでき、検索操作を実行できます。

出力が False の場合、またはログインボタンが表示されている場合、システムは手動ログイン手順を自動的に実行します。

python scripts/manual_login.py

システムはブラウザーウィンドウにログイン画面を起動します。開いたブラウザーの指示に従って手動でログインを完了し、その後ブラウザーを閉じてください。

使用手順

1. 環境のセットアップ

このスキルを使用する前に、以下を確認してください。

1. 必要な依存関係（Python 3.7+、Playwright）がインストールされている
2. 必要に応じて、システムが手動ログインの過程で Cookie の保存を自動的に処理する
3. 検証ユーティリティを使用して、ログイン状態が自動的に確認される

2. 検索機能の使用

このスキルには、検索および抽出機能がいくつか用意されています。

• キーワードでノートを検索：python scripts/search_note_by_key_word.py <KEYWORD> [--top_n TOP_N]
• ノートの内容を抽出：python scripts/dump_note.py <NOTE_URL>

3. 操作機能の使用

このスキルには、操作機能がいくつか用意されています。

• ノートに「いいね」する：python scripts/like_note.py <NOTE_URL>
• ノートを収集する：python scripts/collect_note.py <NOTE_URL>
• ノートにコメントする：python scripts/comment_note.py <NOTE_URL> <COMMENT_TEXT>
• ユーザーをフォローする：python scripts/follow_user.py <NOTE_URL>
• ノートを公開する：python scripts/publish_note.py --image-urls <IMG1 [IMG2 ...]> --title <TITLE> --content <CONTENT> --tags <TAG1 [TAG2 ...]>
• ログインを検証する：python scripts/validate_cookies.py
• 手動でログインする：python scripts/manual_login.py

4. 一連のワークフロー

1. 操作を開始する前にログイン状態を検証します
2. 特定のノートを探す必要がある場合は、必要な検索機能を実行します
3. 適切な引数を指定して、必要な操作機能を実行します
4. 結果を確認し、正常に完了したことを確認します

機能の説明

このスキルでは、Xiaohongshu プラットフォーム上のコンテンツを検索し、操作するための以下の機能を提供します。

ノートの検索（search_note_by_key_word.py）

目的：指定されたキーワードを使って Xiaohongshu のノートを検索します。

パラメーター：

• keyword（文字列）：検索するキーワード
• --top_n（整数、任意）：返すノートの数（デフォルトは 5）

戻り値：キーワードに一致するノート URL のリスト

動作：ブラウザーを起動し、Xiaohongshu でキーワードを検索して、一致するノート URL を返します。

ノートの内容を抽出（dump_note.py）

目的：特定のノートの内容を抽出し、書式設定された Markdown に変換します。

パラメーター：

• note_url（文字列）：内容を抽出するノートの URL

戻り値：投稿者、タイトル、メディア、説明、タグ、インタラクションデータを含む構造化された Markdown コンテンツ

動作：ブラウザーを起動してノートにアクセスし、内容を抽出して Markdown に書式設定します。

ノートに「いいね」する（like_note.py）

目的：ノートの URL を指定して、Xiaohongshu の特定のノートに「いいね」します。

パラメーター：

• note_url（文字列）：「いいね」するノートの URL

戻り値：「いいね」が成功したかどうかを示す成功メッセージまたはエラーメッセージ

動作：ブラウザーを起動してノート URL に移動し、「いいね」ボタンをクリックしてからブラウザーを閉じます。

ノートをコレクションに追加する（collect_note.py）

目的：特定のノートをユーザーのコレクションに追加（保存）します。

パラメーター：

• note_url（string）：コレクションに追加するノートの URL

戻り値：コレクションへの追加に成功したかどうかを示す成功またはエラーメッセージ

動作：ブラウザーを起動してノートの URL に移動し、コレクションに追加するボタンをクリックしてから、ブラウザーを閉じます。

ノートにコメントする（comment_note.py）

目的：小紅書の特定のノートにコメントを追加します。

パラメーター：

• note_url（string）：コメントするノートの URL
• comment_text（string）：コメントのテキスト

戻り値：コメントの投稿に成功したかどうかを示す成功またはエラーメッセージ

動作：ブラウザーを起動してノートの URL に移動し、コメントのテキストを入力して送信ボタンをクリックしてから、ブラウザーを閉じます。

ユーザーをフォローする（follow_user.py）

目的：ノートの URL にアクセスして、そのノートを作成したユーザーをフォローします。

パラメーター：

• note_url（string）：フォローするユーザーが投稿したノートの URL

戻り値：フォローに成功したかどうかを示す成功またはエラーメッセージ

動作：ブラウザーを起動してノートの URL に移動し、フォローボタンが表示されている場合はクリックしてから、ブラウザーを閉じます。

ログイン状態を確認する（validate_cookies.py）

目的：保存済みの認証トークンが有効で、ユーザーが小紅書にログインしているかどうかを確認します。

パラメーター：なし

戻り値：ログインに成功しているかどうかを示すブール値

動作：ブラウザーを起動し、保存済みの認証情報を使って小紅書のホームページにアクセスし、ログイン状態を確認します。

手動でログインする（manual_login.py）

目的：ログイン画面を開き、有効な認証 Cookie の作成を支援します。

パラメーター：なし

戻り値：Cookie の保存後に返される成功またはエラーメッセージ

動作：ブラウザーを起動して小紅書に移動し、ユーザーが手動でログインできるようにした後、Cookie をストレージファイルに保存します。

ノートを投稿する（publish_note.py）

目的：指定された内容、画像、タグを使って、ユーザーの小紅書アカウントに新しい画像付きテキストノートを投稿します。

パラメーター：

• --image-urls IMG1 [IMG2 ...]：ノートにアップロードする1つ以上の画像ファイルのパス（必須）
• --title TITLE：新しいノートのタイトル（必須）
• --content CONTENT：ノートの本文（必須）
• --tags TAG1 [TAG2 ...]：ノートに付ける1つ以上のタグ（必須）

戻り値：ノートの投稿に成功したかどうかを示す成功またはエラーメッセージ

動作：ブラウザーを起動して小紅書の投稿ページに移動し、ノートのタイトル、本文、タグを入力して指定された画像をアップロードし、投稿ボタンをクリックします。

例

基本的な検索とコンテンツの抽出

# Validate login status
python scripts/validate_cookies.py

# Search for notes about "旅行攻略"
python scripts/search_note_by_key_word.py "旅行攻略" --top_n 3

# Extract content from a specific note
python scripts/dump_note.py "https://www.xiaohongshu.com/explore/some-note-id"

基本的ないいねとコレクションへの追加

# Like a specific note
python scripts/like_note.py "https://www.xiaohongshu.com/explore/some-note-id"

# Collect a specific note
python scripts/collect_note.py "https://www.xiaohongshu.com/explore/some-note-id"

ノートにコメントする

# Add a comment to a specific note
python scripts/comment_note.py "https://www.xiaohongshu.com/explore/some-note-id" "Beautiful content! Thanks for sharing."

ユーザーをフォローする

# Follow a user based on one of their posts
python scripts/follow_user.py "https://www.xiaohongshu.com/explore/some-note-by-user-id"

ノートを投稿する

# Publish a new note with images, title, content, and tags
python scripts/publish_note.py \
  --image-urls "/path/to/img1.jpg" "/path/to/img2.jpg" \
  --title "My New Post" \
  --content "Check out this amazing discovery!" \
  --tags "travel" "food" "lifestyle"

ユーザーセッション全体

# 1. Validate login
python scripts/validate_cookies.py

# 2. Search for interesting content
python scripts/search_note_by_key_word.py "美食推荐" --top_n 5

# 3. Extract detailed content from a note
python scripts/dump_note.py "https://www.xiaohongshu.com/explore/note1"

# 4. Like interesting content
python scripts/like_note.py "https://www.xiaohongshu.com/explore/note1"

# 5. Collect useful content
python scripts/collect_note.py "https://www.xiaohongshu.com/explore/note2"

# 6. Engage with community
python scripts/comment_note.py "https://www.xiaohongshu.com/explore/note3" "Awesome tutorial!"

# 7. Follow good content creators
python scripts/follow_user.py "https://www.xiaohongshu.com/explore/note-by-creator"

実装ガイドライン

ベストプラクティス

1. 最初にログイン状態を確認する：スムーズに操作できるよう、インタラクションを実行する前に validate_cookies.py を使ってログイン状態を自動的に確認します。

2. レート制限：アカウントの制限を避けるため、連続するインタラクションの間に適切な遅延を設けてください。短時間に過剰な回数のインタラクションを行わないでください。

3. エラー処理：関数の戻り値を確認し、次の操作に進む前に処理が成功したことを確認してください。

4. ユーザーの意図：ユーザーの関心や好みに合ったコンテンツのみを対象にしてください。このスキルはユーザーの判断を補助するものです。

5. ブラウザー状態の管理：スクリプトがブラウザーの起動と終了を管理するため、これらの操作に必要なシステムリソースが利用可能であることを確認してください。

統合に関する考慮事項

1. セッション管理：このスキルは、rednote_cookies.json に保存された Cookie を通じてセッション状態を維持します。このファイルが適切に保護されていることを確認してください。

2. ブラウザーの自動化：このスキルは自動化にヘッドレスブラウザーを使用します。互換性のあるブラウザー環境がシステムにセットアップされていることを確認してください。

3. URL 形式：スクリプトは、適切な形式の Xiaohongshu URL を想定しています。関数に渡す前に URL が有効であることを確認してください。

4. コンテンツの適切性：やり取りが適切であり、プラットフォームの利用規約に準拠するよう、このスキルを統合してください。

設定と準備

詳細設定

Cookie の管理

• このスキルは認証データを rednote_cookies.json に保存します
• このファイルは手動ログインの際に自動的に作成されます
• セキュリティのため、この Cookie ファイルを不正アクセスから保護してください

環境変数

• 特定の環境変数は必要ありません
• このスキルは scripts ディレクトリにあるデフォルトの設定ファイルを使用します

前提条件の確認

rednote スキルを使用する前に、以下を確認してください。

1. システムのセットアップ：

   • Python 3.7 以降
   • Playwright がインストールされていること（pip install playwright）
   • ブラウザードライバーがインストールされていること（playwright install）
   • ブラウザーの動作に必要な最小限の空きディスク容量

2. Xiaohongshu へのアクセス：

   • ネットワークから Xiaohongshu.com にアクセスできること
   • Xiaohongshu の利用規約に準拠していること
   • 有効な Xiaohongshu アカウントの認証情報

3. セキュリティのセットアップ：

   • 必要に応じて、システムが自動ログインを実行します
   • ログイン状態は検証スクリプトで確認されます
   • 認証トークンを安全に保存できること

トラブルシューティング

よくある問題

ログインエラー（❌ 未找到 cookies 文件，请先登录小红书并保存 cookies）

原因：rednote_cookies.json ファイルが存在しないか、正しい場所にありません。 解決策：システムが python scripts/manual_login.py を自動的に実行し、手動ログインを行って Cookie を保存します。ユーザーは、開いたブラウザーウィンドウでログインを完了するだけです。

ログインセッションの期限切れ（❌ 未登录小红书，请先登录）

原因：認証トークンの有効期限が切れているか、無効です。 解決策：システムがログイン状態を再確認し、トークンを更新するために python scripts/manual_login.py を再度実行する場合があります。画面に表示された場合は、開いたブラウザーウィンドウでログインを完了するだけです。

ページ遷移の問題

原因：ネットワーク接続の問題、または URL 形式の誤りです。 解決策：URL の形式が正しいことを確認し、インターネット接続が安定していること、Xiaohongshu にアクセスできることを確認してください。

操作中に要素が見つからない

原因：Xiaohongshu の UI が変更されたか、ページの読み込みが完了していない可能性があります。 解決策：操作を再試行してください。問題が解決しない場合は、インターフェースに変更がないか確認するか、しばらく待ってからもう一度お試しください。

デバッグ手順

1. 前提条件の確認：すべての要件がインストールされ、アクセス可能であることを確認します
2. ログイン状態の確認：操作の前に検証スクリプトを実行します
3. URL 形式の確認：URL が適切な形式の Xiaohongshu リンクであることを確認します
4. ブラウザーの動作を監視：自動化プロセスを確認するため、ヘッドレスモードを無効にして実行します
5. 保存ファイルの確認：Cookie ファイルが存在し、アクセス可能であることを確認します

パフォーマンスに関する考慮事項

• ブラウザーの自動化は多くのリソースを使用します。システムに十分なメモリと CPU があることを確認してください
• ネットワークの遅延によって操作のタイミングに影響が出る場合があります。操作の間に遅延を追加することを検討してください
• 安定した認証状態を確認するため、検証スクリプトを定期的に実行してください

制限事項と考慮事項

プラットフォームの制限事項

• 利用規約: このスキルは、Xiaohongshu の利用規約およびコミュニティガイドラインに準拠して使用する必要があります
• レート制限: Xiaohongshu では、一定期間内のインタラクション数に制限が設けられる場合があります
• UI の変更: Xiaohongshu がインターフェースを更新すると、このスキルで使用されている要素セレクターが機能しなくなる可能性があります
• 地域制限: 地域によって、一部の機能が制限される場合があります

技術的な制限事項

• ブラウザーへの依存: このスキルはブラウザー自動化に依存しているため、直接 API を呼び出す場合より遅くなることがあります
• 安定性: ブラウザー自動化は、ネットワーク状況やサイトの変更の影響を受けることがあります
• リソース使用量: インタラクションのたびにブラウザーのインスタンスが起動するため、システムリソースを消費します
• ヘッドレスモードとの互換性: 一部のインタラクションは、ヘッドレスモードを使用しないほうが適切に動作することがあります

セキュリティに関する考慮事項

• 認証情報の保存: 認証情報は rednote_cookies.json に保存されるため、適切に保護する必要があります
• プライバシー: このスキルを使って行ったインタラクションは、Xiaohongshu の他のユーザーにも表示されます
• データの取り扱い: このスキルは、インタラクションのためのセッション管理を超えてユーザーデータを収集することはありません

倫理的な考慮事項

• 誠実なエンゲージメント: このスキルは、ユーザーが実際に興味を持つコンテンツとの誠実なエンゲージメントを促進するために使用してください
• コンテンツクリエイターへの配慮: インタラクションがコンテンツクリエイターとその視聴者に与える影響を考慮してください
• スパム防止の倫理: スパムのような行為や、プラットフォームのエコシステムに害を及ぼすおそれのある方法でこのスキルを使用しないでください