puppeteer-plus-martech-mcp
Puppeteer+ MarTech is an MCP server that extends Puppeteer for digital marketing and SEO analysis. It enhances marketing technology audits and offers advanced analytics and visual debugging tools.
Puppeteer+ MarTech
A Model Context Protocol (MCP) server that extends Puppeteer functionality with specialized capabilities for digital marketing and SEO analysis. This server enables LLM applications like Claude to perform comprehensive marketing technology audits on websites.
Installation & Usage
Quick Installation
npm install puppeteer-plus-martech
Claude Desktop Integration
Add this to your claude_desktop_config.json
:
{
"mcpServers": {
"puppeteer-plus-martech": {
"command": "npx",
"args": [
"-y",
"puppeteer-plus-martech"
]
}
}
}
Running as an MCP Server
npx puppeteer-plus-martech
Acknowledgment
This project is an experimental implementation inspired by and building upon @modelcontextprotocol/server-puppeteer by Anthropic. While it shares the same foundational architecture and core capabilities, this project extends the original with specialized tools focused on digital marketing analytics and technology detection. See for more details.
Features
- Marketing Technology Detection: Identify analytics tools, marketing pixels, tag managers, and advertising technologies
- Network Beacon Analysis: Capture and analyze marketing-related network requests
- Advanced Analytics Parsing: Parse both traditional Adobe Analytics and Experience Platform Web SDK (Alloy) beacons with XDM schemas
- SEO Metadata Analysis: Evaluate page metadata, structured data, and SEO best practices
- Visual Debugging: Generate screenshots with marketing technologies highlighted
- Granular Analysis Tools: Specialized tools for specific aspects of digital marketing and SEO
- Omnibug Integration: Enhanced detection capabilities based on the popular Omnibug browser extension
Supported Technologies
Analytics & Tag Management
- 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
Advertising Pixels
- 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
Marketing Automation
- HubSpot
- Marketo
- Salesforce Marketing Cloud
- Braze
- Brevo
Tools
Core Navigation & Screenshot Tools
puppeteer_navigate
Navigates to a specified URL in the browser.
Parameters:
url
(string, required): URL to navigate tolaunchOptions
(object, optional): PuppeteerJS LaunchOptions to customize browser behaviorallowDangerous
(boolean, optional): Allow dangerous LaunchOptions that reduce security
Returns: Confirmation message that the navigation was successful.
puppeteer_screenshot
Takes a screenshot of the current page or a specific element.
Parameters:
name
(string, required): Name for the screenshotselector
(string, optional): CSS selector for element to screenshotwidth
(number, optional): Width in pixels (default: 800)height
(number, optional): Height in pixels (default: 600)
Returns: The captured screenshot and a success message.
Enhanced Marketing Technology Analysis Tools
scan-marketing-stack
Comprehensive detection and analysis of all marketing technologies on a webpage using the enhanced Omnibug-based provider system.
Parameters:
url
(string, required): The URL of the webpage to analyzewaitTime
(number, optional): Additional time to wait for delayed pixels to fire (in milliseconds)
Returns: Complete analysis of all detected marketing technologies, including:
- Categorized list of all detected technologies (analytics, advertising, tag managers, etc.)
- Detection method for each technology (global variable, network request)
- Technology-specific properties (account IDs, container IDs, etc.)
- Data layer information when available
- Network request statistics
visualize-marketing-tech
Takes a screenshot with detailed marketing technologies visually highlighted, with improved detection capabilities.
Parameters:
url
(string, required): The URL of the webpage to screenshothighlightMode
(string, optional): How to highlight detected marketing technologies ("basic", "detailed", or "none")
Returns: A screenshot with marketing technologies visually highlighted and labeled. The "detailed" mode provides more information about each technology directly on the screenshot.
Original Marketing Technology Analysis Tools
find-marketing-technologies
Provides a high-level overview of all marketing technologies on a webpage.
Parameters:
url
(string, required): The URL of the webpage to analyzewaitTime
(number, optional): Additional time to wait for delayed pixels to fire (in milliseconds)
Returns: Summary of all detected marketing technologies, including:
- List of technologies with vendor and category information
- Total number of tracking requests
- Number of marketing-related requests
analyze-analytics-platforms
Deep dive into analytics platforms like GA4, Universal Analytics, Adobe Analytics, etc.
Parameters:
url
(string, required): The URL of the webpage to analyzewaitTime
(number, optional): Additional time to wait (in milliseconds)
Returns: Detailed analysis of analytics tools, including:
- Analytics-specific technologies detected
- Analytics-related tracking IDs (GA4, UA, etc.)
- Data layer sample if available
- Analytics-related network requests
detect-ad-pixels
Focuses on advertising platforms like Facebook, TikTok, etc.
Parameters:
url
(string, required): The URL of the webpage to analyzewaitTime
(number, optional): Additional time to wait (in milliseconds)
Returns: Detailed analysis of advertising pixels, including:
- Advertising-specific technologies detected
- Pixel IDs (Facebook, TikTok, etc.)
- Advertising-related network requests
identify-tag-managers
Analyzes tag management systems like GTM, Tealium, etc.
Parameters:
url
(string, required): The URL of the webpage to analyzewaitTime
(number, optional): Additional time to wait (in milliseconds)
Returns: Detailed analysis of tag managers, including:
- Tag manager technologies detected
- Tag manager IDs (GTM container ID, etc.)
- Data layer sample and events
- Configuration insights (when available)
track-marketing-beacons
Detailed analysis of network requests for tracking and marketing activities.
Parameters:
url
(string, required): The URL of the webpage to analyzewaitTime
(number, optional): Additional time to wait (in milliseconds)maxRequests
(number, optional): Maximum number of requests to include in results
Returns: Comprehensive network request analysis, including:
- Total requests and marketing-related requests
- Breakdown of trackers by vendor (Google, Facebook, etc.)
- Detailed tracking requests for each vendor category
- Request timing and patterns
parse-analytics-beacons
Capture and parse both traditional Adobe Analytics and Adobe Experience Platform Web SDK beacons.
Parameters:
url
(string, required): The URL of the webpage to analyzewaitTime
(number, optional): Time to wait for beacons to fire (milliseconds)simulateClick
(string, optional): Optional CSS selector to click for interaction beacons
Returns: Detailed parsing of analytics beacons, including:
- Complete breakdown of Adobe Analytics variables (props, eVars, events, etc.)
- Parsed XDM schema data for Adobe Experience Platform Web SDK
- Both page load and interaction beacons (if simulateClick is provided)
- Categorized data by beacon type and provider
highlight-marketing-tools
Takes a screenshot with marketing technologies visually highlighted.
Parameters:
url
(string, required): The URL of the webpage to screenshothighlightPixels
(boolean, optional): Whether to highlight detected marketing pixels
Returns: A screenshot with marketing technologies visually highlighted. Different types of technologies (GTM, GA, Facebook, etc.) are highlighted with different colors for easy identification.
SEO Analysis Tools
audit-seo
Complete SEO analysis combining metadata, structure, and URL insights.
Parameters:
url
(string, required): The URL of the webpage to analyze
Returns: Comprehensive SEO analysis, including:
- URL structure with SEO best practices evaluation
- Page metadata
- Heading structure
- Canonical links
- OpenGraph and Twitter card data
check-page-metadata
Focused analysis of meta tags, titles, and descriptions.
Parameters:
url
(string, required): The URL of the webpage to analyze
Returns: Detailed metadata analysis, including:
- Page title and meta description
- Keywords and robots directives
- OpenGraph and Twitter card data
- Meta tag evaluations with SEO recommendations
- Content length and optimization suggestions
evaluate-page-structure
Analysis of URL structure, headings hierarchy, and page organization.
Parameters:
url
(string, required): The URL of the webpage to analyze
Returns: Structural SEO analysis, including:
- URL analysis with SEO recommendations
- Complete heading hierarchy (H1-H6)
- Content structure statistics
- Internal linking analysis
- Navigation elements (breadcrumbs, etc.)
- Structure evaluations with SEO recommendations
extract-schema-markup
Analysis of JSON-LD, microdata, and schema.org markup.
Parameters:
url
(string, required): The URL of the webpage to analyze
Returns: Structured data analysis, including:
- JSON-LD structured data
- Microdata implementations
- Schema.org types detected
- Structured data evaluations with recommendations
audit-image-alt-text
Audit image alt text on a webpage for accessibility and SEO compliance.
Parameters:
url
(string, required): The URL of the webpage to analyze
Returns: Comprehensive image alt text analysis, including:
- Summary of image alt text compliance
- Total number of images detected
- Images with/without alt text
- Accessibility score (0-100)
- Detailed analysis of each image's alt text
- Specific issues for each image (missing alt, empty alt, etc.)
- Recommendations for improving accessibility and 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
Run locally:
node index.js
Run in development mode with auto-restart:
npm run dev
Test the server:
npm test
License
MIT