你是否曾为自动化脚本中的小红书登录验证而头疼？是否曾因登录态频繁失效而不得不手动介入，让所谓的“全自动”名存实亡？
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("http://localhost: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 pageexcept: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)returnTrueexcept Exception as e:print(f"❌ 浏览器连接失败: {e}")returnFalseasyncdef 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("✅ 成功进入创作中心")returnTrueexcept Exception as e:print(f"❌ 进入创作中心失败: {e}")await self.page.screenshot(path='error_create_page.png')returnFalseasyncdef 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) # 额外等待确保完全加载returnTrueexcept Exception as e:print(f"❌ 图片上传失败: {e}")await self.page.screenshot(path='error_upload.png')returnFalseasyncdef 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))returnTrueexcept Exception as e:print(f"❌ 内容输入失败: {e}")await self.page.screenshot(path='error_content.png')returnFalseasyncdef 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("🎉 发布成功！")returnTrueexcept:# 检查是否有错误提示error_element = await self.page.query_selector('text=/发布失败|错误/')if error_element:error_text = await error_element.inner_text()print(f"❌ 发布失败: {error_text}")else:print("⚠️ 发布状态未知，请手动确认")returnFalseexcept Exception as e:print(f"❌ 发布操作失败: {e}")await self.page.screenshot(path='error_publish.png')returnFalseasyncdef run(self, content, image_paths, tags=None):"""执行完整发布流程"""ifnotawait self.init_browser():returnFalsetry: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))returnTruefinally: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()returnTrueexcept:continueprint(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 连接被拒绝
问题：无法连接到 http://localhost:9222
解决方案：
确保浏览器以调试模式启动
检查防火墙设置，确保端口可访问
尝试使用不同的端口号
5.2 元素找不到或操作超时
问题：选择器失效或页面加载过慢
解决方案：
使用多种选择器策略组合
增加等待时间和重试机制
添加页面状态检查
5.3 风控检测
问题：操作被限制或账号被暂时封锁
解决方案：
添加随机延迟和人类化操作模式
避免高频次操作
使用多个账号轮换操作
推荐学习
Playwright自动化测试框架与AI智能体应用课程，限时免费，机会难得。扫码报名，参与直播，希望您在这场公开课中收获满满，开启智能自动化测试的新篇章！
六、总结
Playwright MCP 为小红书自动化发布带来了革命性的改进：
无需处理复杂登录：直接复用已登录的浏览器会话
更高的稳定性：避免了登录态失效和验证码问题
更接近真人操作：使用真实浏览器实例，降低被风控的风险
灵活的部署选项：既可以在本地运行，也可以部署到服务器
通过本教程，你已经掌握了使用 Playwright MCP 实现小红书全自动发布的完整流程。现在，你可以根据自己的需求扩展这个基础脚本，实现更复杂的自动化场景，如自动回复评论、数据分析、多账号管理等。
记住，技术是用来提高效率的工具，请在遵守平台规则的前提下合理使用自动化技术。祝你自动化之旅顺利！
