STARWARCLOUD STARWAR.AI
返回市场
Puppeteer增强营销技术MCP

Puppeteer增强营销技术MCP

作者：moonbirdai4 星标更新：2025-05-07
安装使用来源：spider==github.com

项目介绍

Puppeteer+ MarTech

一个扩展了Puppeteer功能的模型上下文协议（MCP）服务器，专门用于数字营销和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的@modelcontextprotocol/server-puppeteer。 虽然它共享相同的基础架构和核心能力，但该项目通过专注于数字营销分析和技术检测的专用工具进行了扩展。详情见ACKNOWLEDGMENTS.md。

功能

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

支持的技术

分析与标签管理

  • Google Analytics（通用分析&GA4）
  • Google Tag Manager
  • Adobe Analytics
  • Adobe Launch/DTM
  • Adobe Experience Platform Web SDK（Alloy）
  • Adobe Experience Edge
  • Adobe Experience Cloud ID服务
  • Adobe Target
  • Adobe Audience Manager
  • Segment
  • Hotjar
  • Mixpanel
  • Amplitude
  • Microsoft Clarity
  • Tealium IQ
  • Matomo/Piwik
  • Ensighten
  • AT Internet

广告像素

  • Facebook像素
  • Google Ads
  • TikTok像素
  • Pinterest标签
  • LinkedIn洞察标签
  • Twitter/X像素
  • Microsoft广告
  • Snapchat像素
  • Criteo
  • RTB House
  • Reddit像素
  • Spotify像素
  • Outbrain

营销自动化

  • HubSpot
  • Marketo
  • Salesforce营销云
  • Braze
  • Brevo

工具

核心导航与截图工具

puppeteer_navigate

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

参数：

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

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

puppeteer_screenshot

拍摄当前页面或特定元素的截图。

参数：

  • name（字符串，必需）：截图的名称
  • selector（字符串，可选）：要截图的元素的CSS选择器
  • width（数字，可选）：宽度（以像素为单位，默认为800）
  • height（数字，可选）：高度（以像素为单位，默认为600）

返回： 捕获的截图和成功消息。

增强的营销技术分析工具

scan-marketing-stack

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

参数：

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

返回： 检测到的所有营销技术的全面分析，包括：

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

visualize-marketing-tech

拍摄带有详细营销技术视觉突出的截图，具有改进的检测能力。

参数：

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

返回： 带有视觉突出和标记的营销技术的截图。"详细"模式直接在截图上提供有关每项技术的更多信息。

原始营销技术分析工具

find-marketing-technologies

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

参数：

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

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

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

analyze-analytics-platforms

深入分析GA4、通用分析、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分析，包括：

  • 结合SEO最佳实践的URL结构
  • 页面元数据
  • 标题结构
  • 规范链接
  • OpenGraph和Twitter卡片数据

check-page-metadata

专注于元标签、标题和描述的分析。

参数：

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

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

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

evaluate-page-structure

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

参数：

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

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

  • 结合SEO建议的URL分析
  • 完整的标题层次结构（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的建议

技术细节

Omnibug集成

该服务器集成了由Omnibug浏览器扩展启发的增强检测能力。集成包括：

  • 用于检测特定营销技术的全面提供商框架
  • 用于识别分析和营销信标的URL模式匹配
  • 从信标请求中提取有意义信息的参数解析
  • 支持广泛的营销技术和供应商

开发

克隆仓库：

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