Puppeteer+ MarTech

Puppeteer+ MarTech

Puppeteer の機能を拡張し、デジタルマーケティングと SEO 分析に特化した機能を提供する Model Context Protocol（MCP）サーバーです。このサーバーを使うと、Claude などの LLM アプリケーションで、ウェブサイトの包括的なマーケティングテクノロジー監査を実施できます。

インストールと使用方法

クイックインストール

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 と Experience Platform Web SDK（Alloy）のビーコンを、XDM スキーマとともに解析します
• 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（string、必須）：移動先の URL
• launchOptions（object、任意）：ブラウザーの動作をカスタマイズする PuppeteerJS LaunchOptions
• allowDangerous（boolean、任意）：セキュリティを低下させる危険な LaunchOptions を許可します

戻り値： ナビゲーションが成功したことを示す確認メッセージです。

puppeteer_screenshot

現在のページまたは特定の要素のスクリーンショットを撮影します。

パラメーター：

• name（string、必須）：スクリーンショットの名前
• selector（string、任意）：スクリーンショットを撮影する要素の CSS セレクター
• width（number、任意）：幅（ピクセル単位。デフォルト：800）
• height（number、任意）：高さ（ピクセル単位。デフォルト：600）

戻り値： 撮影したスクリーンショットと成功メッセージです。

拡張マーケティングテクノロジー分析ツール

scan-marketing-stack

強化された Omnibug ベースのプロバイダーシステムを使用して、Web ページ上のすべてのマーケティングテクノロジーを包括的に検出、分析します。

パラメーター：

• url（string、必須）：分析する Web ページの URL
• waitTime（number、任意）：遅延ピクセルが発火するまで追加で待機する時間（ミリ秒）

戻り値： 検出されたすべてのマーケティングテクノロジーの完全な分析情報。以下を含みます。

• 検出されたすべてのテクノロジーのカテゴリ別リスト（アナリティクス、広告、タグマネージャーなど）
• 各テクノロジーの検出方法（グローバル変数、ネットワークリクエスト）
• テクノロジー固有のプロパティ（アカウント ID、コンテナ ID など）
• 利用可能な場合はデータレイヤー情報
• ネットワークリクエストの統計情報

visualize-marketing-tech

マーケティングテクノロジーを視覚的に強調表示した詳細なスクリーンショットを撮影します。検出機能も改善されています。

パラメーター：

• url（string、必須）：スクリーンショットを撮影する Web ページの URL
• highlightMode（string、任意）：検出されたマーケティングテクノロジーの強調表示方法（"basic"、"detailed"、または "none"）

戻り値： マーケティングテクノロジーを視覚的に強調表示し、ラベルを付けたスクリーンショットです。"detailed" モードでは、各テクノロジーの詳細情報がスクリーンショット上に直接表示されます。

従来のマーケティングテクノロジー分析ツール

find-marketing-technologies

Web ページ上のすべてのマーケティングテクノロジーの概要を提供します。

パラメーター：

• url（string、必須）：分析する Web ページの URL
• waitTime（number、任意）：遅延ピクセルが発火するまで追加で待機する時間（ミリ秒）

戻り値： 検出されたすべてのマーケティングテクノロジーの概要。以下を含みます。

• ベンダーとカテゴリの情報を含むテクノロジーの一覧
• トラッキングリクエストの総数
• マーケティング関連リクエストの数

analyze-analytics-platforms

GA4、Universal Analytics、Adobe Analytics などのアナリティクスプラットフォームを詳しく分析します。

パラメーター：

• url（string、必須）：分析する Web ページの URL
• waitTime（number、任意）：追加で待機する時間（ミリ秒）

戻り値： アナリティクスツールの詳細な分析情報。以下を含みます。

• 検出されたアナリティクス固有のテクノロジー
• アナリティクス関連のトラッキング ID（GA4、UA など）
• 利用可能な場合はデータレイヤーのサンプル
• アナリティクス関連のネットワークリクエスト

detect-ad-pixels

Facebook、TikTok などの広告プラットフォームに焦点を当てます。

パラメーター：

• url（string、必須）：分析する Web ページの URL
• waitTime（number、任意）：追加で待機する時間（ミリ秒）

戻り値： 広告ピクセルの詳細な分析情報。以下を含みます。

• 検出された広告固有のテクノロジー
• ピクセル ID（Facebook、TikTok など）
• 広告関連のネットワークリクエスト

identify-tag-managers

GTM、Tealium などのタグ管理システムを分析します。

パラメーター：

• url（string、必須）：分析する Web ページの URL
• waitTime（number、任意）：追加で待機する時間（ミリ秒）

戻り値： タグマネージャーの詳細な分析情報。以下を含みます。

• 検出されたタグマネージャーのテクノロジー
• タグマネージャーの ID（GTM コンテナ ID など）
• データレイヤーのサンプルとイベント
• 設定に関する分析情報（利用可能な場合）

track-marketing-beacons

トラッキングやマーケティング活動に関するネットワークリクエストを詳しく分析します。

パラメーター：

• url（string、必須）：分析する Web ページの URL
• waitTime（number、任意）：追加で待機する時間（ミリ秒）
• maxRequests（number、任意）：結果に含めるリクエストの最大数

戻り値： ネットワークリクエストの包括的な分析情報。以下を含みます。

• リクエストの総数とマーケティング関連リクエストの数
• ベンダー別のトラッカーの内訳（Google、Facebook など）
• 各ベンダーカテゴリの詳細なトラッキングリクエスト
• リクエストのタイミングとパターン

parse-analytics-beacons

従来の Adobe Analytics と Adobe Experience Platform Web SDK の両方のビーコンを取得して解析します。

パラメーター：

• url（string、必須）：分析するウェブページの URL
• waitTime（number、任意）：ビーコンが発火するまでの待機時間（ミリ秒）
• simulateClick（string、任意）：インタラクションビーコンを発火させるためにクリックする CSS セレクター（任意）

戻り値： 以下を含む、ビーコンの詳細な解析結果：

• Adobe Analytics 変数（props、eVars、events など）の完全な内訳
• Adobe Experience Platform Web SDK の解析済み XDM スキーマデータ
• ページ読み込み時とインタラクション時の両方のビーコン（simulateClick が指定されている場合）
• ビーコンの種類とプロバイダー別に分類されたデータ

highlight-marketing-tools

マーケティングテクノロジーを視覚的に強調表示したスクリーンショットを撮影します。

パラメーター：

• url（string、必須）：スクリーンショットを撮影するウェブページの URL
• highlightPixels（boolean、任意）：検出されたマーケティングピクセルを強調表示するかどうか

戻り値： マーケティングテクノロジーを視覚的に強調表示したスクリーンショット。各種テクノロジー（GTM、GA、Facebook など）は、識別しやすいように異なる色で強調表示されます。

SEO 分析ツール

audit-seo

メタデータ、構造、URL の分析情報を組み合わせた、包括的な SEO 分析を行います。

パラメーター：

• url（string、必須）：分析するウェブページの URL

戻り値： 以下を含む、包括的な SEO 分析結果：

• SEO のベストプラクティスに基づく評価を含む URL 構造
• ページのメタデータ
• 見出し構造
• canonical リンク
• OpenGraph と Twitter カードのデータ

check-page-metadata

メタタグ、タイトル、説明文に焦点を当てて分析します。

パラメーター：

• url（string、必須）：分析するウェブページの URL

戻り値： 以下を含む、詳細なメタデータ分析結果：

• ページタイトルとメタディスクリプション
• キーワードと robots ディレクティブ
• OpenGraph と Twitter カードのデータ
• SEO に関する推奨事項を含むメタタグの評価
• コンテンツの長さと最適化に関する提案

evaluate-page-structure

URL 構造、見出し階層、ページ構成を分析します。

パラメーター：

• url（string、必須）：分析するウェブページの URL

戻り値： 以下を含む、構造に関する SEO 分析結果：

• SEO に関する推奨事項を含む URL 分析
• 見出し階層の全体（H1～H6）
• コンテンツ構造の統計情報
• 内部リンクの分析
• ナビゲーション要素（パンくずリストなど）
• SEO に関する推奨事項を含む構造の評価

extract-schema-markup

JSON-LD、マイクロデータ、schema.org マークアップを分析します。

パラメーター：

• url（string、必須）：分析するウェブページの URL

戻り値： 以下を含む、構造化データの分析結果：

• JSON-LD 構造化データ
• マイクロデータの実装
• 検出された Schema.org のタイプ
• 推奨事項を含む構造化データの評価

audit-image-alt-text

ウェブページ上の画像の alt テキストを監査し、アクセシビリティと SEO の要件への準拠状況を確認します。

パラメーター：

• url（string、必須）：分析するウェブページの 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