Redbook Search Comment MCP2.0

🚀 小红书MCPツール使用ガイド

このツールはPlaywrightフレームワークを利用して、小红书プラットフォームでのユーザー行動を模倣し、内容の投稿、データ収集、インタラクション操作を支援します。合理的に使用することで、運用効率を大幅に向上させることができます。

🚀 クイックスタート

環境準備

# 仮想環境の作成とアクティブ化
python -m venv env
source env/bin/activate

依存関係のインストール

pip install -r requirements.txt

ログインフロー

手動ログイン

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=False)
    context = browser.new_context()
    page = context.new_page()
    
    # 小红书のホームページにアクセス
    page.goto('https://www.xiaohongshu.com')
    
    # ログインボタンをクリックして、スキャンコードでログイン
    page.click('#login-btn')
    page.wait_for_timeout(5000)  # スキャンコードの完了を待つ

自動ログイン（Cookieを設定）

# 設定ファイルのパス
COOKIES_PATH = 'cookies.json'

# 保存されたCookieを読み込む
context.add_cookies(json.loads(open(COOKIES_PATH).read()))
page.goto('https://www.xiaohongshu.com')

主要機能の実装

検索機能

def search_note(content):
    page.type('#search-input', content)
    page.press('#search-input', 'Enter')
    page.wait_for_selector('.note-list')  # 検索結果の読み込みを待つ
    return page.querySelectorAll('.note-item')

データ収集

def get_note_info(note_element):
    title = note_element.query_selector('.title').text_content()
    author = note_element.query_selector('.author').text_content()
    content = note_element.query_selector('.content').text_content()
    likes = note_element.query_selector('.likes-count').text_content()
    return {
        'タイトル': title,
        '作者': author,
        '内容': content,
        'いいね数': likes
    }

✨ 主な機能

機能モジュールの概要

核心機能

• ユーザー行動の模倣：Playwrightフレームワークを使用して、小红书プラットフォームでのユーザー操作（登録、ログイン、閲覧、いいねなど）を実現します。
• データ収集：ノート情報、ユーザー情報、コメント内容などのデータを収集し、データベースに保存することができます。
• タスクの自動化：自動投稿、インタラクション（いいね、コメント）、フォローとファン管理など、さまざまな運用タスクを設定して実行できます。

技術アーキテクチャ

    └─ playwright  # ユーザー行動の模倣フレームワーク
       └─ browser  # ブラウザのインスタンス
           ├─ page  # ページ操作
           └─ context  # コンテキスト管理（Cookie、localStorageなど）
                └─ selectors  # 要素選択器の設定

📚 ドキュメント

コード構造

• xiaohongshu_mcp.py：主要な機能を実現する核心ファイルで、ログイン、検索、内容とコメントの取得、コメントの投稿などの機能のコードロジックが含まれています。
• requirements.txt：プロジェクトに必要な依存ライブラリを記録しています。

詳細な使用説明

ログインモジュール

手動ログイン

# Playwrightを初期化してブラウザを起動
playwright = sync_playwright()
browser = playwright.chromium.launch(headless=False)
context = browser.new_context()
page = context.new_page()

# ログインページにアクセス
page.goto('https://www.xiaohongshu.com/login')

# 電話番号を入力
page.type('#phone-input', '13812345678')

# 短信認証コードでログインするボタンをクリック
page.click('#sms-login-btn')
page.wait_for_timeout(3000)

# 受け取った認証コードを入力
verification_code = input('受け取った認証コードを入力してください：')
page.type('#code-input', verification_code)
page.click('#submit-btn')

自動ログイン

# 保存されたCookieを読み込む
context.add_cookies(json.loads(open(COOKIES_PATH).read()))
page.goto('https://www.xiaohongshu.com')

検索モジュール

def search_notes(keyword):
    page.type('#search-input', keyword)
    page.press('#search-input', 'Enter')
    page.wait_for_selector('.note-list')  # 検索結果の読み込みが完了するまで待つ
    return page.querySelectorAll('.note-item')

収集モジュール

def extract_note_info(note_element):
    title = note_element.query_selector('h1').text_content()
    author = note_element.query_selector('.author-name').text_content()
    content = note_element.query_selector('.content').text_content()
    likes_count = note_element.query_selector('.likes-count').text_content()
    comments_count = note_element.query_selector('.comments-count').text_content()
    return {
        'タイトル': title,
        '作者': author,
        '内容': content,
        'いいね数': likes_count,
        'コメント数': comments_count
    }

投稿モジュール

def post_note(content):
    page.goto('https://www.xiaohongshu.com/create/note')
    
    # ノートの内容を入力
    page.type('#content-input', content)
    
    # 投稿を送信
    page.click('#submit-btn')
    page.wait_for_timeout(2000)  # 読み込みが完了するまで待つ

よくある問題と解決策

ログインに失敗する

原因

• 小红书のログインメカニズムが更新され、現在のコードが機能しなくなっています。

解決策

1. Playwrightのバージョンを更新する：

pip install --upgrade playwright

2. 最新の認証コード処理方法を使用する：

page.wait_for_selector('#captcha-input')

ウェブページの要素が見つからない

原因

• ページ構造が変更され、クエリセレクタが機能しなくなっています。

解決策

1. 開発者ツールを確認し、セレクタのパスを更新する。
2. 通常のCSSセレクタの代わりに、より安定したセレクタ（data-testidなど）を使用する。

パフォーマンスの問題

原因

• 複数の操作により、ブラウザのパフォーマンスが低下します。

解決策

1. 適切な待機時間を設定する：

page.wait_for_timeout(2000)  # 適切なタイムアウト時間に調整する

2. playwright devを使用してデバッグし、スクリプトの実行パスを最適化する。

高度な機能

データの保存

例

import sqlite3

def save_note(note_info):
    conn = sqlite3.connect('notes.db')
    cursor = conn.cursor()
    
    # テーブルを作成する（存在しない場合）
    cursor.execute('''CREATE TABLE IF NOT EXISTS notes 
                     (id INTEGER PRIMARY KEY AUTOINCREMENT,
                      title TEXT,
                      author TEXT,
                      content TEXT,
                      likes INTEGER)''')
    
    cursor.execute('INSERT INTO notes VALUES (?, ?, ?, ?)',
                   (note_info['title'], note_info['author'],
                    note_info['content'], note_info['likes']))
    
    conn.commit()

ログの記録

例

import logging

# ログ出力を設定する
logging.basicConfig(level=logging.INFO,
                   format='%(asctime)s - %(levelname)s - %(message)s')

def log_activity(action):
    logging.info(f'操作を実行：{action}')

🔧 技術詳細

データ保存

import sqlite3

def save_note(note_info):
    conn = sqlite3.connect('notes.db')
    cursor = conn.cursor()
    
    # テーブルを作成する（存在しない場合）
    cursor.execute('''CREATE TABLE IF NOT EXISTS notes 
                     (id INTEGER PRIMARY KEY AUTOINCREMENT,
                      title TEXT,
                      author TEXT,
                      content TEXT,
                      likes INTEGER)''')
    
    cursor.execute('INSERT INTO notes VALUES (?, ?, ?, ?)',
                   (note_info['title'], note_info['author'],
                    note_info['content'], note_info['likes']))
    
    conn.commit()

ログ記録

import logging

# ログ出力を設定する
logging.basicConfig(level=logging.INFO,
                   format='%(asctime)s - %(levelname)s - %(message)s')

def log_activity(action):
    logging.info(f'操作を実行：{action}')

📄 ライセンス

本READMEにはライセンス情報が記載されていません。

⚠️ セキュリティ上の注意事項

プライバシー保護

• ユーザーの個人情報の収集を禁止します。
• 関連する法令を遵守し、データの乱用を避けます。

プラットフォームの規則

• 頻繁な操作を避け、アカウントの凍結を防ぎます。
• 適切な時間間隔を使用して、実際のユーザー行動を模倣します。

例外処理

try:
    # 高リスクの操作を実行
except Exception as e:
    logging.error(f'エラーが発生しました：{e}')
    # 自動的に終了し、報告する
    page.close()