Puppeteer Plus Martech MCP

Puppeteer+MarTech

一种模型上下文协议（MCP）服务器，它扩展了Puppeter的功能，具有数字营销和SEO分析的专门功能。该服务器使Claude等LLM应用程序能够对网站进行全面的营销技术审核。

安装与使用

快速安装

npm install puppeteer-plus-martech

Claude桌面集成

将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "puppeteer-plus-martech": {
      "command": "npx",
      "args": [
        "-y",
        "puppeteer-plus-martech"
      ]
    }
  }
}

作为MCP服务器运行

npx puppeteer-plus-martech

致谢

这个项目是一个实验性的实施，灵感来自并建立在 @模型上下文协议/服务器操纵器 通过Anthropic。 虽然它共享相同的基础架构和核心功能，但该项目通过专注于数字营销分析和技术检测的专业工具扩展了原有的基础架构。看 致谢.md 了解更多详情。

特性

• 营销技术检测：识别分析工具、营销像素、标签管理器和广告技术
• 网络信标分析：捕获和分析与营销相关的网络请求
• 高级分析解析：使用XDM模式解析传统的Adobe Analytics和Experience Platform Web SDK（Alloy）信标
• SEO元数据分析：评估页面元数据、结构化数据和SEO最佳实践
• 可视化调试：生成突出显示营销技术的屏幕截图
• 粒度分析工具：针对数字营销和SEO特定方面的专业工具
• Omnibug集成：基于流行的Omnibug浏览器扩展的增强检测功能

支持的技术

分析和标签管理

• 谷歌分析（通用分析和GA4）
• 谷歌标签管理器
• Adobe Analytics
• Adobe启动/DTM
• Adobe体验平台Web SDK（Alloy）
• Adobe体验边缘
• Adobe Experience Cloud ID服务
• Adobe目标
• Adobe受众管理器
• 片段
• Hotjar
• 混音面板
• 振幅
• 微软清晰度
• Tealium智商
• Matomo/Piwik
• 拉直
• AT互联网

广告像素

• 脸书像素
• 谷歌广告
• 尝试像素
• Pinterest标签
• LinkedIn洞察标签
• 推特/X像素
• 微软广告
• Snapchat像素
• Criteo
• RTB住宅
• Reddit像素
• Spotify像素
• 暴雨

营销自动化

• HubSpot
• Marketo
• Salesforce营销云
• Braze
• 布雷沃

工具

核心导航和截图工具

puppeteer_navigation

在浏览器中导航到指定的URL。

参数：

• url （字符串，必填）：要导航到的URL
• launchOptions （对象，可选）：PuppeterJS LaunchOptions用于自定义浏览器行为
• allowDangerous （boolean，可选）：允许降低安全性的危险启动选项

退货： 导航成功的确认消息。

木偶戏

截取当前页面或特定元素的屏幕截图。

参数：

• name （string，必填）：屏幕截图的名称
• selector （string，可选）：用于截图元素的CSS选择器
• width （数字，可选）：宽度（像素）（默认值：800）
• height （数字，可选）：高度（像素）（默认值：600）

退货： 捕获的屏幕截图和成功消息。

增强的营销技术分析工具

扫描营销堆栈

使用增强的基于Omnibug的提供商系统对网页上的所有营销技术进行全面检测和分析。

参数：

• url （string，必填）：要分析的网页的URL
• waitTime （数字，可选）：等待延迟像素触发的额外时间（以毫秒为单位）

退货： 对所有检测到的营销技术进行全面分析，包括：

• 所有检测到的技术（分析、广告、标签管理器等）的分类列表
• 每种技术的检测方法（全局变量、网络请求）
• 特定于技术的属性（帐户ID、容器ID等）
• 数据层信息（如果可用）
• 网络请求统计

可视化营销技术

拍摄一张截图，其中详细的营销技术以视觉方式突出显示，并具有改进的检测功能。

参数：

• url （string，必填）：要截图的网页的URL
• highlightMode （字符串，可选）：如何突出显示检测到的营销技术（“基本”、“详细”或“无”）

退货： 带有营销技术的屏幕截图，以视觉方式突出显示并标记。“详细”模式直接在屏幕截图上提供有关每种技术的更多信息。

原创营销技术分析工具

寻找营销技术

提供网页上所有营销技术的高级概述。

参数：

• url （string，必填）：要分析的网页的URL
• waitTime （数字，可选）：等待延迟像素触发的额外时间（以毫秒为单位）

退货： 所有检测到的营销技术摘要，包括：

• 带有供应商和类别信息的技术列表
• 跟踪请求总数
• 与营销相关的请求数量

分析分析平台

深入研究GA4、通用分析、Adobe分析等分析平台。

参数：

• url （string，必填）：要分析的网页的URL
• waitTime （数字，可选）：额外等待时间（以毫秒为单位）

退货： 分析工具的详细分析，包括：

• 检测到分析特定技术
• 与分析相关的跟踪ID（GA4、UA等）
• 数据层示例（如果可用）
• 分析相关网络请求

检测广告像素

专注于Facebook、TikTok等广告平台。

参数：

• url （string，必填）：要分析的网页的URL
• waitTime （数字，可选）：额外等待时间（以毫秒为单位）

退货： 广告像素的详细分析，包括：

• 检测到广告特定技术
• 像素ID（脸书、TikTok等）
• 与广告相关的网络请求

识别标签管理器

分析GTM、Tealium等标签管理系统。

参数：

• url （string，必填）：要分析的网页的URL
• waitTime （数字，可选）：额外等待时间（以毫秒为单位）

退货： 标签管理器的详细分析，包括：

• 检测到标记管理器技术
• 标签管理器ID（GTM容器ID等）
• 数据层示例和事件
• 配置见解（可用时）

跟踪营销信标

对跟踪和营销活动的网络请求进行详细分析。

参数：

• url （string，必填）：要分析的网页的URL
• waitTime （数字，可选）：额外等待时间（以毫秒为单位）
• maxRequests （number，可选）：结果中包含的最大请求数

退货： 全面的网络请求分析，包括：

• 请求总数和与营销相关的请求
• 按供应商（谷歌、脸书等）分列的跟踪器明细
• 每个供应商类别的详细跟踪请求
• 请求时间和模式

解析分析信标

捕获并解析传统的Adobe Analytics和Adobe Experience Platform Web SDK信标。

参数：

• url （string，必填）：要分析的网页的URL
• waitTime （数字，可选）：等待信标发射的时间（毫秒）
• simulateClick （字符串，可选）：可选CSS选择器，用于点击交互信标

退货： 分析信标的详细解析，包括：

• Adobe Analytics变量（props、eVars、事件等）的完整细分
• Adobe Experience Platform Web SDK的XDM模式数据解析
• 页面加载和交互信标（如果提供simulateClick）
• 按信标类型和提供商对数据进行分类

突出营销工具

对营销技术进行视觉突出显示的截图。

参数：

• url （string，必填）：要截图的网页的URL
• highlightPixels （布尔值，可选）：是否突出显示检测到的营销像素

退货： 以视觉方式突出显示营销技术的屏幕截图。不同类型的技术（GTM、GA、Facebook等）以不同的颜色突出显示，便于识别。

SEO分析工具

审核seo

结合元数据、结构和URL见解进行完整的SEO分析。

参数：

• url （string，必填）：要分析的网页的URL

退货： 全面的SEO分析，包括：

• 带有SEO最佳实践评估的URL结构
• 页面元数据
• 标题结构
• 规范链接
• OpenGraph和推特卡数据

检查页面元数据

对元标签、标题和描述进行重点分析。

参数：

• url （string，必填）：要分析的网页的URL

退货： 详细的元数据分析，包括：

• 页面标题和元描述
• 关键词和机器人指令
• OpenGraph和推特卡数据
• 带有SEO建议的元标签评估
• 内容长度和优化建议

评估页面结构

分析URL结构、标题层次结构和页面组织。

参数：

• url （string，必填）：要分析的网页的URL

退货： 结构化SEO分析，包括：

• 带有SEO建议的URL分析
• 完整的标题层次结构（H1-H6）
• 内容结构统计
• 内部链接分析
• 导航元素（面包屑等）
• 结构评估与SEO建议

提取模式标记

JSON-LD、微数据和schema.org标记分析。

参数：

• url （string，必填）：要分析的网页的URL

退货： 结构化数据分析，包括：

• JSON-LD结构化数据
• 微数据实施
• 检测到Schema.org类型
• 结构化数据评估及建议

审计图像alt文本

审核网页上的图像alt文本，以确保可访问性和SEO合规性。

参数：

• url （string，必填）：要分析的网页的URL

退货： 全面的图像-文本分析，包括：

• 图像与文本兼容性概述
• 检测到的图像总数
• 带/不带alt文本的图像
• 无障碍评分（0-100）
• 对每张图片的alt文本进行详细分析
• 每个图像的具体问题（缺少alt、空alt等）
• 提高可访问性和SEO的建议

## Technology Details

### Omnibug Integration

This server incorporates enhanced detection capabilities inspired by the [Omnibug](https://github.com/MisterPhilip/omnibug) browser extension. The integration includes:

- Comprehensive provider framework for detecting specific marketing technologies
- URL pattern matching for identifying analytics and marketing beacons
- Parameter parsing for extracting meaningful information from beacon requests
- Support for a wide variety of marketing technologies and vendors

## Development

Clone the repository:

git clone https://github.com/MBadkins/puppeteer-plus-martech.git cd puppeteer-plus-martech npm install

在本地运行：

node index.js

在开发模式下自动重启运行：

npm run dev

测试服务器：

npm test

## 许可证

麻省理工学院