AI导哈

Web自动化工具

Playwright MCP Actor是一款连接AI系统与浏览器的Web自动化工具，支持数据提取、表单填写、截图等功能，无需编码即可使用。

  • by anuj123upadhyay
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 anuj123upadhyay/playwright-mcp-actor

使用说明

🎭 剧作家MCP演员

在几秒钟内将任何AI代理转换为强大的web自动化工具。

🚀 免费试用 • 📖 文档 • 💬 支持

🎯 这是什么？

剧作家MCP演员 通过以下方式将AI系统（Claude、ChatGPT、自定义LLM）直接连接到web浏览器 模型上下文协议.

将其视为赋予您的AI助手以下能力：

  • 🔍 搜索 任何网站和提取数据
  • 📝 填写表格 并提交信息
  • 🖼️ 截图 网页
  • 🤖 自动化 重复的浏览器任务
  • 📊 出口 数据转换为JSON、CSV或Excel

无需编码 对于大多数用例。描述一下你想要什么。

⚡ 为什么选择这个演员？

功能 剧作家MCP 其他刮刀
人工智能集成 ✅ 原生MCP支持 ❌ 手动编码
反检测 ✅ 12+隐形功能 ⚠️ 基本或无
重试逻辑 ✅ 带回退功能的自动重试 ❌ 立即失败
模板 ✅ 5随时可用❌ 从头开始
多格式导出 ✅ JSON/CSV/Excel ⚠️ 仅JSON
指定代理 ✅ 内置支持 ⚠️ 手动设置

💰 定价估算

用例 操作 估计。成本 时间
谷歌搜索（10个结果） ~5 ~0.01 10s
亚马逊产品搜索 ~8 ~0.02美元 15秒
LinkedIn个人资料报废 ~6 ~0.02 12秒
表格提交 ~10 ~0.02 20s
全屏截图 ~3 ~0.01 8s

基于Apify的基于使用量的定价。实际成本可能会有所不同。

🚀 快速入门（3分钟）

选项1：使用模板（最简单）

{
  "template": "google_search",
  "template_params": {
    "search_query": "best coffee shops in NYC",
    "max_results": 10
  },
  "export_format": "csv"
}

可用模板：

模板 用例 示例参数
amazon_product_search 产品研究、价格监控 {"product_name": "laptop", "max_results": 20}
google_search SEO研究、SERP分析 {"search_query": "keyword", "max_results": 50}
linkedin_profile 潜在客户开发、招聘 {"profile_url": "https://linkedin.com/in/username"}
twitter_scrape 社会监测、情绪分析 {"username": "elonmusk", "max_tweets": 100}
google_maps_business 本地业务数据，潜在客户 {"search_query": "restaurants in LA", "max_results": 50}

选项2：自定义操作（高级）

{
  "browser_type": "chromium",
  "headless": true,
  "stealth_mode": true,
  "max_retries": 3,
  "delay_between_actions": 500,
  "actions": [
    {
      "type": "navigate",
      "value": "https://example.com"
    },
    {
      "type": "fill",
      "selector": "#search",
      "value": "your query"
    },
    {
      "type": "click",
      "selector": "button[type='submit']"
    },
    {
      "type": "wait_for_element",
      "selector": ".results",
      "timeout": 10000
    },
    {
      "type": "extract_text",
      "selector": ".results"
    },
    {
      "type": "screenshot"
    }
  ],
  "export_format": "json"
}

选项3：API集成

curl -X POST "https://api.apify.com/v2/acts/aluminum_jam~playwright-mcp-actor/runs" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "amazon_product_search",
    "template_params": {"product_name": "wireless headphones", "max_results": 10}
  }'

📋 输入配置

核心设置

字段 类型 默认值 描述
browser_type 字符串 chromium 浏览器： chromium, firefox, webkit
headless 布尔值 true 在没有可见浏览器的情况下运行
stealth_mode 布尔值 false 启用反检测（12种以上技术）
proxy object - 代理配置（Apify或自定义）

可靠性设置

字段 类型 默认值 描述
max_retries 整数 2 重试失败的操作（指数回退）
continue_on_error 布尔值 false 如果操作失败，请继续
delay_between_actions 整数 0 动作之间的毫秒数
max_actions_per_run 整数 100 限制每次运行的操作
page_load_timeout 整数 30000 最大页面加载时间（ms）

输出设置

字段 类型 默认值 描述
export_format 字符串 json 输出格式： json, csv, excel
viewport_width 整数 1920 浏览器视口宽度
viewport_height 整数 1080 浏览器视口高度

🎬 可用操作（20+）

导航

操作 描述 必填字段
navigate 转到URL value （URL）
go_back 浏览器返回 -
go_forward 浏览器前进 -
reload 刷新页面 -
get_url 获取当前URL -
get_title 获取页面标题 -

交互

操作 描述 必填字段
click 点击元素 selector
fill 填写输入字段 selector, value
type 键入文本 selector, value
select 选择下拉菜单 selector, value
check 选中复选框 selector
uncheck 取消选中复选框 selector
hover 将鼠标悬停在元素上 selector
focus 焦点元素 selector
press_key 按键盘键 selector, value

数据提取

操作 描述 必填字段
extract_text 获取文本内容 selector （可选）
extract_attributes 获取所有属性 selector
get_html 获取HTML内容 selector （可选）
screenshot 截图 -
evaluate 运行JavaScript value （JS代码）

等待

操作 描述 必填字段
wait 等待时间 value （毫秒）
wait_for_element 等待元素 selector
scroll 滚动页面 value （像素，可选）

📤 输出格式

{
  "success": true,
  "stats": {
    "total_actions": 5,
    "successful_actions": 5,
    "failed_actions": 0,
    "retried_actions": 1,
    "total_execution_time_ms": 8450,
    "average_action_time_ms": 1690,
    "screenshots_captured": 1
  },
  "actions": [
    {
      "type": "navigate",
      "success": true,
      "output": "https://example.com",
      "execution_time_ms": 2340,
      "timestamp": "2025-03-28T10:30:00.000Z"
    }
  ],
  "timestamp": "2025-03-28T10:30:08.450Z"
}

🛡️ 防检测功能

当 stealth_mode: true 启用后，参与者将应用 12种反检测技术:

  1. ✅ WebDriver属性删除
  2. ✅ 逼真的浏览器插件模拟
  3. ✅ 语言偏好欺骗
  4. ✅ Chrome运行时对象注入
  5. ✅ 权限API覆盖
  6. ✅ iframe内容窗口保护
  7. ✅ 函数toString覆盖
  8. ✅ WebGL供应商/渲染器欺骗
  9. ✅ 硬件并发屏蔽
  10. ✅ 设备内存欺骗
  11. ✅ 平台字符串覆盖
  12. ✅ 用户代理轮换

最适合： 社交媒体、电子商务、搜索引擎、银行网站

🔗 集成

扎皮尔

  1. 使用“Zapier的Webhooks”
  2. 张贴到 https://api.apify.com/v2/acts/aluminum_jam~playwright-mcp-actor/runs
  3. 添加您的API令牌作为承载身份验证

Make.com（Integromat）

  1. 添加HTTP模块
  2. 配置POST请求以Apify API
  3. 将数据映射到输入模式

谷歌表格

  1. 使用Apify的原生Google表格集成
  2. 自动将结果导出到电子表格
  3. 持续更新时间表

自定义Webhooks

{
  "template": "google_search",
  "template_params": {"search_query": "AI news"},
  "webhooks": [{
    "eventTypes": ["ACTOR.RUN.SUCCEEDED"],
    "requestUrl": "https://your-webhook.com/endpoint"
  }]
}

🆘 故障排除

未找到元素

{
  "type": "wait_for_element",
  "selector": ".target-element",
  "timeout": 30000
}

解决：

  • 增加超时时间
  • 使用 wait_for_element 互动前
  • 尝试不同的选择器（CSS、XPath、文本）
  • 为受保护的站点启用隐藏模式

费率受限/受阻

解决：

  1. 启用 stealth_mode: true
  2. 添加代理： "proxy": {"useApifyProxy": true}
  3. 添加延迟： "delay_between_actions": 1000
  4. 在敏感地点使用住宅代理

操作失败

{
  "max_retries": 3,
  "continue_on_error": true
}

这将重试失败的操作最多3次，即使某些操作失败，也会继续执行。

📊 性能提示

  1. 使用无头模式 -比头部快30%
  2. 最小化屏幕截图 -每增加约1-2s
  3. 批量提取 -使用 evaluate 对于多个元素
  4. 设置合理的超时 -不要等待超过需要的时间
  5. 使用模板 -针对常见用例进行了优化

⚖️ 法律与合规

重要提示： 您负责：

  • 遵守网站服务条款
  • 遵守robots.txt指令
  • 遵循数据保护法（GDPR、CCPA）
  • 使用合理的请求率

最佳实践： ✅ 在抓取之前查看网站ToS ✅ 使用适当的延迟 ✅ 未经同意，不要抓取个人数据 ✅ 遵守费率限制 ✅ 缓存结果以最小化请求

📞 支持与联系

📈 更新日志

v1.1.0（2026年3月）

  • ✅ 添加了具有指数回退的重试逻辑
  • ✅ 增加了操作之间的延迟配置
  • ✅ 添加了continue_on_error选项
  • ✅ 增强隐形模式（12种反探测技术）
  • ✅ 用户代理轮换
  • ✅ 优雅的中止处理
  • ✅ 改进了输入验证
  • ✅ 更好的代理支持（Apify代理编辑器）

v1.0.0（2025年12月）

  • ✅ 初始版本
  • ✅ 20+动作类型
  • ✅ 5个预制模板
  • ✅ CSV/Excel导出
  • ✅ Apify代理集成
  • ✅ 基本隐身模式

⭐ 将此项目放在 GitHub 如果你觉得它有用的话！

制作❤️ Apify社区

🚀 立即开始使用 • 📖 全部文件 • 💬 获得帮助

相关 MCP