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(COOKIE_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  # 上下文管理（如cookies、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. 使用更穩定的選擇器（如data-testid）代替普通CSS選擇器。

性能問題

原因

• 多次操作導致瀏覽器性能下降。

解決方案

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}')

🔧 技術細節

安全注意事項

1. 隱私保護：
   • 禁止採集用戶個人信息。
   • 遵守相關法律法規，避免數據濫用。
2. 平臺規則：
   • 避免頻繁操作，防止賬號被封禁。
   • 使用合理的時間間隔模擬真實用戶行為。
3. 異常處理：

try:
    # 執行高風險操作
except Exception as e:
    logging.error(f'發生錯誤：{e}')
    # 自動退出並報告
    page.close()

總結

通過Playwright框架實現的小紅書MCP工具，能夠有效模擬用戶行為，幫助完成內容發佈、數據採集和互動操作。合理使用該工具，可以顯著提升運營效率，同時需注意遵守平臺規則和法律法規。