Puppeteer+ MarTech

Puppeteer+ MarTech

一个模型上下文协议（MCP）服务，通过数字营销和 SEO 分析专用功能扩展 Puppeteer 的功能。该服务支持 Claude 等大模型应用对网站进行全面的营销技术审计。

安装与使用

快速安装

npm install puppeteer-plus-martech

Claude Desktop 集成

将以下内容添加到你的 claude_desktop_config.json：

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

作为 MCP 服务运行

npx puppeteer-plus-martech

致谢

本项目是一项实验性实现，灵感源自并基于 Anthropic 的 @modelcontextprotocol/server-puppeteer。 虽然本项目沿用了相同的基础架构和核心功能，但也在原项目的基础上进行了扩展，加入了专注于数字营销分析和技术检测的专用工具。更多详情请参阅 ACKNOWLEDGMENTS.md。

功能

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

支持的技术

分析与标签管理

• Google Analytics（Universal Analytics 和 GA4）
• Google Tag Manager
• Adobe Analytics
• Adobe Launch/DTM
• Adobe Experience Platform Web SDK（Alloy）
• Adobe Experience Edge
• Adobe Experience Cloud ID Service
• Adobe Target
• Adobe Audience Manager
• Segment
• Hotjar
• Mixpanel
• Amplitude
• Microsoft Clarity
• Tealium IQ
• Matomo/Piwik
• Ensighten
• AT Internet

广告像素

• Facebook Pixel
• Google Ads
• TikTok Pixel
• Pinterest Tag
• LinkedIn Insight Tag
• Twitter/X Pixel
• Microsoft Advertising
• Snapchat Pixel
• Criteo
• RTB House
• Reddit Pixel
• Spotify Pixel
• Outbrain

营销自动化

• HubSpot
• Marketo
• Salesforce Marketing Cloud
• Braze
• Brevo

工具

核心导航与屏幕截图工具

puppeteer_navigate

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

参数：

• url（字符串，必填）：要导航到的 URL
• launchOptions（对象，可选）：用于自定义浏览器行为的 PuppeteerJS LaunchOptions
• allowDangerous（布尔值，可选）：允许使用会降低安全性的危险 LaunchOptions

返回： 导航成功的确认消息。

puppeteer_screenshot

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

参数：

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

返回： 截取的屏幕截图和成功消息。

增强型营销技术分析工具

scan-marketing-stack

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

参数：

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

返回： 对所有检测到的营销技术进行完整分析，包括：

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

visualize-marketing-tech

截取屏幕截图，并在图中直观突出显示营销技术，检测能力也有所增强。

参数：

• url（字符串，必填）：要截取屏幕截图的网页 URL
• highlightMode（字符串，可选）：突出显示检测到的营销技术的方式（“basic”、“detailed” 或 “none”）

返回： 一张在视觉上突出显示并标注营销技术的屏幕截图。“detailed”模式会直接在截图中提供关于每项技术的更多信息。

原始营销技术分析工具

find-marketing-technologies

概述网页上的所有营销技术。

参数：

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

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

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

analyze-analytics-platforms

深入分析 GA4、Universal Analytics、Adobe Analytics 等分析平台。

参数：

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

返回： 对分析工具的详细分析，包括：

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

detect-ad-pixels

重点分析 Facebook、TikTok 等广告平台。

参数：

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

返回： 对广告像素的详细分析，包括：

• 检测到的广告类技术
• 像素 ID（Facebook、TikTok 等）
• 广告相关网络请求

identify-tag-managers

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

参数：

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

返回： 对标签管理器的详细分析，包括：

• 检测到的标签管理器技术
• 标签管理器 ID（GTM 容器 ID 等）
• 数据层示例和事件
• 配置信息（如有）

track-marketing-beacons

详细分析跟踪和营销活动相关的网络请求。

参数：

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

返回： 全面的网络请求分析，包括：

• 请求总数和营销相关请求数
• 按供应商划分的跟踪器细分（Google、Facebook 等）
• 各供应商类别的详细跟踪请求
• 请求时序和模式

parse-analytics-beacons

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

参数：

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

返回： 对分析信标的详细解析，包括：

• Adobe Analytics 变量的完整细分（props、eVars、events 等）
• 解析后的 Adobe Experience Platform Web SDK XDM 架构数据
• 页面加载和交互信标（如果提供了 simulateClick）
• 按信标类型和提供商分类的数据

highlight-marketing-tools

截图并以可视化方式突出显示营销技术。

参数：

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

返回： 以可视化方式突出显示营销技术的截图。不同类型的技术（GTM、GA、Facebook 等）会以不同颜色突出显示，便于识别。

SEO 分析工具

audit-seo

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

参数：

• url（字符串，必填）：要分析的网页 URL

返回： 全面的 SEO 分析，包括：

• URL 结构及 SEO 最佳实践评估
• 页面元数据
• 标题层级结构
• 规范链接
• OpenGraph 和 Twitter 卡片数据

check-page-metadata

针对元标签、标题和描述的专项分析。

参数：

• url（字符串，必填）：要分析的网页 URL

返回： 详细的元数据分析，包括：

• 页面标题和元描述
• 关键词和 robots 指令
• OpenGraph 和 Twitter 卡片数据
• 元标签评估及 SEO 建议
• 内容长度和优化建议

evaluate-page-structure

分析 URL 结构、标题层级和页面组织方式。

参数：

• url（字符串，必填）：要分析的网页 URL

返回： 结构化 SEO 分析，包括：

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

extract-schema-markup

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

参数：

• url（字符串，必填）：要分析的网页 URL

返回： 结构化数据分析，包括：

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

audit-image-alt-text

审核网页图片的 alt 文本，检查其是否符合无障碍访问和 SEO 要求。

参数：

• url（字符串，必填）：要分析的网页 URL

返回： 全面的图片 alt 文本分析，包括：

• 图片 alt 文本合规性摘要
• 检测到的图片总数
• 有/无 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:

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

在本地运行：

node index.js

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

npm run dev

测试服务：

npm test

许可证

MIT