使用 Playwright MCP 实现小红书全自动发布的完整流程

文章正文
发布时间:2025-09-26 11:14

你是否曾为自动化脚本中的小红书登录验证而头疼?是否曾因登录态频繁失效而不得不手动介入,让所谓的“全自动”名存实亡?

Playwright Model Context Protocol (MCP) 的推出,彻底改变了这一局面。它不再是简单的浏览器控制,而是通过直接连接到你已登录的浏览器会话,实现了真正的“无感知”自动化。这意味着,你只需要手动登录一次小红书,之后的发布、互动等所有操作都可以交给脚本,无需再关心复杂的登录验证流程。

本文将为你带来一份零基础的保姆级教程,手把手教你如何利用 Playwright MCP 实现小红书图文的无人值守自动发布。

一、环境准备与配置:打下坚实基础
1.1 安装 Playwright
确保你的 Python 环境在 3.7 以上,然后安装 Playwright:

pip install playwright
playwright install chromium
1.2 安装配置 MCP 服务器
Playwright MCP 需要一个服务器来协调浏览器和你的自动化脚本:

通过 npm 全局安装

npm install -g @playwright/mcp

或者使用 npx 直接运行

npx @playwright/mcp
1.3 安装浏览器扩展
这是实现会话复用的关键步骤:

下载 Playwright MCP Chrome 扩展(ZIP 文件)
打开 Chrome,进入 chrome://extensions/
开启“开发者模式”
点击“加载已解压的扩展程序”,选择解压后的文件夹
完成安装后,记得在扩展管理界面启用它
二、连接已登录的浏览器会话
2.1 启动浏览器并手动登录
首先,你需要让浏览器以调试模式运行:

Windows

chrome.exe --remote-debugging-port=9222

macOS

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222
然后在打开的浏览器中手动登录小红书账号,完成所有必要的验证步骤。

2.2 编写连接代码
创建一个 Python 文件,写入以下代码来连接已登录的浏览器:

import asyncio
from playwright.async_api import async_playwright

asyncdef connect_to_logged_in_browser():
asyncwith async_playwright() as p:
# 连接到正在运行的浏览器实例
browser = await p.chromium.connect_over_cdp(":9222")

# 获取默认的浏览器上下文 default_context = browser.contexts[0] # 使用现有的页面或创建新页面 if default_context.pages: page = default_context.pages[0] else: page = await default_context.new_page() # 检查是否已登录 await page.goto('https://www.xiaohongshu.com') try: # 等待用户头像或其他登录后可见元素出现 await page.wait_for_selector('[data-testid="user-avatar"]', timeout=5000) print("✅ 检测到已登录状态") return page except: print("❌ 未检测到登录状态,请先手动登录") returnNone 测试连接

asyncdef test_connection():
page = await connect_to_logged_in_browser()
if page:
await page.screenshot(path='login_status.png')
print("截图已保存,请查看登录状态")
await browser.disconnect()

asyncio.run(test_connection())
三、完整的小红书图文发布脚本
以下是一个完整的自动化发布脚本,包含了异常处理和详细注释:

import asyncio
from playwright.async_api import async_playwright
import random
import os

class XiaohongshuAutoPublisher:
def init(self):
self.browser = None
self.page = None

asyncdef init_browser(self): """初始化浏览器连接""" try: playwright = await async_playwright().start() self.browser = await playwright.chromium.connect_over_cdp( "http://localhost:9222" ) self.context = self.browser.contexts[0] self.page = self.context.pages[0] if self.context.pages elseawait self.context.new_page() # 设置超时时间 self.page.set_default_timeout(30000) returnTrue except Exception as e: print(f"❌ 浏览器连接失败: {e}") returnFalse asyncdef goto_create_page(self): """导航到创作中心""" try: await self.page.goto('https://www.xiaohongshu.com/create', waitUntil='networkidle') # 等待发布界面加载完成 await self.page.wait_for_selector('div[contenteditable="true"]', timeout=15000) print("✅ 成功进入创作中心") returnTrue except Exception as e: print(f"❌ 进入创作中心失败: {e}") await self.page.screenshot(path='error_create_page.png') returnFalse asyncdef upload_images(self, image_paths): """上传图片""" try: # 等待文件上传输入框 await self.page.wait_for_selector('input[type="file"]', timeout=10000) # 获取文件上传句柄 file_input = await self.page.query_selector('input[type="file"]') if isinstance(image_paths, str): image_paths = [image_paths] await file_input.set_input_files(image_paths) print("✅ 图片上传成功") # 等待图片处理完成 await self.page.wait_for_selector('img[src*="upload"]', timeout=30000) await asyncio.sleep(2) # 额外等待确保完全加载 returnTrue except Exception as e: print(f"❌ 图片上传失败: {e}") await self.page.screenshot(path='error_upload.png') returnFalse asyncdef input_content(self, content, tags): """输入正文内容和标签""" try: # 定位正文编辑器 editor = await self.page.wait_for_selector('div[contenteditable="true"]', timeout=10000) # 清空现有内容 await editor.click(clickCount=3) # 三击全选 await self.page.keyboard.press('Backspace') # 输入内容 await editor.type(content) # 添加标签 if tags: tag_text = ' ' + ' '.join([f'#{tag}'for tag in tags]) await editor.type(tag_text) print("✅ 内容输入成功") # 添加随机延迟,模拟人类输入 await asyncio.sleep(random.uniform(1, 3)) returnTrue except Exception as e: print(f"❌ 内容输入失败: {e}") await self.page.screenshot(path='error_content.png') returnFalse asyncdef publish(self): """执行发布操作""" try: # 定位发布按钮 publish_button = await self.page.wait_for_selector('button:has-text("发布")', timeout=10000) await publish_button.click() print("✅ 已点击发布按钮") # 等待发布结果 try: await self.page.wait_for_selector('text=发布成功', timeout=15000) print("🎉 发布成功!") returnTrue except: # 检查是否有错误提示 error_element = await self.page.query_selector('text=/发布失败|错误/') if error_element: error_text = await error_element.inner_text() print(f"❌ 发布失败: {error_text}") else: print("⚠️ 发布状态未知,请手动确认") returnFalse except Exception as e: print(f"❌ 发布操作失败: {e}") await self.page.screenshot(path='error_publish.png') returnFalse asyncdef run(self, content, image_paths, tags=None): """执行完整发布流程""" ifnotawait self.init_browser(): returnFalse try: steps = [ (self.goto_create_page, "进入创作中心"), (lambda: self.upload_images(image_paths), "上传图片"), (lambda: self.input_content(content, tags), "输入内容"), (self.publish, "发布内容") ] for step_func, step_name in steps: print(f"▶️ 正在执行: {step_name}") ifnotawait step_func(): print(f"❌ 流程中断于: {step_name}") returnFalse # 步骤间随机延迟 await asyncio.sleep(random.uniform(1, 2)) returnTrue finally: if self.browser: await self.browser.disconnect() 使用示例

asyncdef main():
publisher = XiaohongshuAutoPublisher()

# 发布内容配置 content = """ Playwright MCP 真是太强大了!🤖 刚刚用全自动脚本发布了这篇小红书,完全不需要手动登录和验证。 #技术分享 #自动化 #Playwright #小红书运营 """ image_paths = [ '/path/to/your/image1.jpg', '/path/to/your/image2.jpg' ] tags = ['技术分享', '自动化', 'Playwright'] success = await publisher.run(content, image_paths, tags) if success: print("🎉 自动化发布流程完成!") else: print("❌ 发布流程失败")

if name == "main":
asyncio.run(main())
四、高级技巧与最佳实践
4.1 会话保持与状态管理

保存浏览器状态,避免重复登录

asyncdef save_browser_state():
asyncwith async_playwright() as p:
browser = await p.chromium.launch(headless=False)
context = await browser.new_context()
page = await context.new_page()

# 手动登录过程... # 登录成功后保存状态 await context.storage_state(path='xiaohongshu_auth.json') await browser.close() 使用保存的状态

asyncdef use_saved_state():
asyncwith async_playwright() as p:
browser = await p.chromium.launch()
context = await browser.new_context(storage_state='xiaohongshu_auth.json')
page = await context.new_page()
# 现在应该处于已登录状态
4.2 智能元素定位策略

使用多种选择器策略提高稳定性

asyncdef smart_click(text):
selectors = [
f'button:has-text("{text}")',
f'div:has-text("{text}")',
f'//[contains(text(), "{text}")]',
f'[data-testid="{text.lower()}"]'
]

for selector in selectors: try: element = await self.page.wait_for_selector(selector, timeout=2000) await element.click() returnTrue except: continue print(f"❌ 找不到文本为 {text} 的元素") returnFalse

4.3 完整的错误处理与重试机制
async def robust_operation(operation, max_retries=3):
"""带重试机制的操作执行"""
for attempt in range(max_retries):
try:
returnawait operation()
except Exception as e:
if attempt == max_retries - 1:
raise e
print(f"⚠️ 操作失败,第 {attempt + 1} 次重试: {e}")
await asyncio.sleep(2 ** attempt) # 指数退避

使用示例

asyncdef safe_publish():
await robust_operation(lambda: self.page.click('button:has-text("发布")'))
五、常见问题与解决方案
5.1 连接被拒绝
问题:无法连接到 :9222

解决方案:

确保浏览器以调试模式启动
检查防火墙设置,确保端口可访问
尝试使用不同的端口号
5.2 元素找不到或操作超时
问题:选择器失效或页面加载过慢

解决方案:

使用多种选择器策略组合
增加等待时间和重试机制
添加页面状态检查
5.3 风控检测
问题:操作被限制或账号被暂时封锁

解决方案:

添加随机延迟和人类化操作模式
避免高频次操作
使用多个账号轮换操作
推荐学习
Playwright自动化测试框架与AI智能体应用课程,限时免费,机会难得。扫码报名,参与直播,希望您在这场公开课中收获满满,开启智能自动化测试的新篇章!

image

六、总结
Playwright MCP 为小红书自动化发布带来了革命性的改进:

无需处理复杂登录:直接复用已登录的浏览器会话
更高的稳定性:避免了登录态失效和验证码问题
更接近真人操作:使用真实浏览器实例,降低被风控的风险
灵活的部署选项:既可以在本地运行,也可以部署到服务器
通过本教程,你已经掌握了使用 Playwright MCP 实现小红书全自动发布的完整流程。现在,你可以根据自己的需求扩展这个基础脚本,实现更复杂的自动化场景,如自动回复评论、数据分析、多账号管理等。

记住,技术是用来提高效率的工具,请在遵守平台规则的前提下合理使用自动化技术。祝你自动化之旅顺利!