webflow-mcp:site-audit

サイト監査

Webflow サイトの構造、コンテンツの健全性、品質を包括的に監査し、詳細な分析と複数のエクスポート形式を提供します。

重要な注意事項

すべての操作で、必ず Webflow MCP ツールを使用してください。

• 利用可能なサイトの一覧表示には、Webflow MCP の data_sites_tool をアクション list_sites とともに使用してください
• サイトの詳細情報の取得には、Webflow MCP の data_sites_tool をアクション get_site とともに使用してください
• すべてのページの取得には、Webflow MCP の data_pages_tool をアクション list_pages とともに使用してください
• CMS コレクションの一覧表示には、Webflow MCP の data_cms_tool をアクション get_collection_list とともに使用してください
• 詳細なコレクションスキーマの取得には、Webflow MCP の data_cms_tool をアクション get_collection_details とともに使用してください
• アイテム数のカウントには、Webflow MCP の data_cms_tool をアクション list_collection_items とともに使用してください
• 作業を開始する前にベストプラクティスを取得するには、Webflow MCP の webflow_guide_tool を使用してください
• Webflow の操作に、ほかのツールや方法を使用しないでください
• すべてのツール呼び出しには、必須の context パラメーター（第三者視点で15～25語）を含めてください

手順

フェーズ 1：サイトの選択と調査

1. サイトを取得する：対象サイトを特定します。ユーザーがサイト ID を指定していない場合は、確認してください。
2. サイトの詳細を取得する：Webflow MCP の data_sites_tool をアクション get_site とともに使用して、次の情報を取得します。
   • サイト名と ID
   • 最終公開日
   • 最終更新日
   • タイムゾーン
   • ロケール（プライマリーとセカンダリー）
   • カスタムドメイン
3. ユーザーの希望を確認する：希望する詳細レベルを尋ねてください。
   • クイックサマリー（件数のみ）
   • 標準インベントリ（ページ＋コレクション＋件数）
   • 詳細インベントリ（すべてのフィールドスキーマ、アイテムのサンプル、SEO データを含む）
   • フルエクスポート（すべての情報＋ファイル形式でのエクスポート）

フェーズ 2：ページのインベントリ

4. すべてのページを一覧表示する：Webflow MCP の data_pages_tool をアクション list_pages とともに使用して、すべてのページを取得します。
5. ページを分類する：
   • 静的ページ（collectionId なし）
   • CMS テンプレートページ（collectionId あり）
   • アーカイブ済みページ
   • 下書きページ
6. ページ構造を分析する：
   • 種類別にページ数を集計する
   • SEO メタデータが不足しているページを特定する
   • 孤立したページ（ナビゲーションリンクがないページ）を検出する
   • 重複するスラッグがないか確認する

フェーズ 3：CMS コレクションのインベントリ

7. すべてのコレクションを一覧表示する：Webflow MCP の data_cms_tool をアクション get_collection_list とともに使用します。
8. 各コレクションについて：
   • Webflow MCP の data_cms_tool をアクション get_collection_details とともに使用して、詳細なスキーマを取得する
   • Webflow MCP の data_cms_tool をアクション list_collection_items とともに使用して、アイテム数をカウントする
   • フィールドの種類と必須条件を分析する
   • 必須フィールドと任意フィールドを特定する
   • 参照フィールドと関連性を検出する
9. コレクションを分析する：
   • 空のコレクション（アイテム数 0）
   • 未使用のコレクション（テンプレートページがない）
   • 大規模なコレクション（アイテム数 100 件以上）
   • 必須フィールドが不足しているコレクション

フェーズ 4：分析とインサイト

10. インサイトを生成する：
    • コンテンツの総数（ページ＋アイテム）
    • コンテンツ健全性スコア
    • SEO 対応状況
    • 推奨される改善点
11. 問題を特定する：
    • SEO メタデータの不足
    • 空のコレクション
    • 孤立したページ
    • 下書きコンテンツの割合
12. 関連性を示す：
    • 各ページが使用するコレクション
    • 参照フィールドのつながり
    • コンテンツの依存関係

フェーズ 5：エクスポートと書式設定

13. エクスポート形式を確認する（ユーザーがフルエクスポートを希望する場合）：
    • Markdown（読みやすく、ドキュメント作成に最適）
    • JSON（機械可読で、移行に適しています）
    • CSV（スプレッドシートで扱いやすく、分析に適しています）
    • テキストサマリー（コンソール出力のみ）
14. 指定された形式でレポートを生成します。
15. 実行可能なインサイトを提供する：調査結果に基づいて次のステップを提案します。

例

ユーザーのプロンプト：

Give me a complete inventory of my site.

ステップ 1：初期レポート（標準インベントリ）

📊 Site Audit: MCP Demo#1

**Site Details:**
- Site ID: 6924868ede9d3fbbc3195eb0
- Last published: January 9, 2026
- Last updated: January 9, 2026
- Timezone: Asia/Calcutta
- Primary locale: English (en)

---

**Pages (2 total):**

Static Pages (1):
├── Home (/)

CMS Template Pages (1):
└── Blog Posts Template (/post)
    - Collection: Blog Posts

---

**CMS Collections (1):**

Blog Posts (9 items)
├── Slug: post
├── Fields (8):
│   ├── Name (PlainText, required)
│   ├── Slug (PlainText, required)
│   ├── Post Body (RichText)
│   ├── Post Summary (PlainText)
│   ├── Main Image (Image)
│   ├── Thumbnail image (Image)
│   ├── Featured? (Switch)
│   └── Color (Color)

---

**Summary:**
- ✅ 2 pages (1 static, 1 CMS template)
- ✅ 1 CMS collection with 9 published items
- ✅ Site fully published and up-to-date

Would you like a detailed analysis or export in a specific format?

ステップ 2：詳細分析（ユーザーが依頼した場合）

🔍 Detailed Analysis: MCP Demo#1

**Content Health Score: 85/100**

✅ Strengths:
- All collections have items (no empty collections)
- All pages are published (no drafts)
- Site recently published (Jan 9, 2026)
- Consistent field structure in Blog Posts

⚠️ Areas for Improvement:
- No SEO metadata on template page (missing meta description)
- Limited page count (consider adding About, Contact pages)
- No reference fields (could link categories/authors to posts)

💡 Recommendations:
1. Add meta descriptions to all pages for better SEO
2. Consider creating a Categories collection for post organization
3. Add an Authors collection for multi-author blog support
4. Create navigation pages (About, Contact, Privacy Policy)

**Collection Breakdown:**

Blog Posts:
- 9 published items (0 drafts, 0 archived)
- 5 featured posts (56%)
- All required fields populated ✓
- Field usage:
  - Name: 100% (9/9)
  - Slug: 100% (9/9)
  - Post Body: 100% (9/9)
  - Post Summary: 100% (9/9)
  - Main Image: 100% (9/9)
  - Thumbnail: 100% (9/9)
  - Featured: 100% (9/9)
  - Color: 100% (9/9)

**Sample Items:**
1. "Why Webflow is the Best Choice for 2026" (featured)
2. "Top Webflow Features to Look Forward to in 2026"
3. "Webflow vs. Competitors: Who Will Win in 2026?" (featured)

---

Export this inventory? (markdown/json/csv/no)

ステップ 3：エクスポートの選択肢

📥 Export Format Options:

1. **Markdown** - Human-readable documentation
   - Great for README files, wikis, documentation
   - Preserves structure and formatting

2. **JSON** - Machine-readable structured data
   - Perfect for migrations, integrations
   - Includes all raw API data

3. **CSV** - Spreadsheet-friendly
   - Easy to analyze in Excel/Google Sheets
   - Separate files for pages and collections

Which format would you like? (1/2/3)

ガイドライン

フェーズ 1：重要な要件

サイト情報：

• data_sites_tool のアクション get_site を使って、サイトの詳細情報を必ずすべて取得します
• 最終公開日と最終更新日を含めます
• タイムゾーンとロケールの情報を表示します
• 設定されている場合は、カスタムドメインを表示します

ユーザーオプション： 詳細レベルを複数用意します：

• 簡易：件数のみ
• 標準：ページ＋コレクション＋基本情報
• 詳細：完全なスキーマ＋分析＋インサイト
• エクスポート：すべての情報＋ファイル出力

フェーズ 2：ページ分析

ページの分類：

• 静的ページと CMS テンプレートページを分けます
• アーカイブ済みページと下書きページを個別に示します
• 参照用にページのスラッグ／URLを表示します
• SEO メタデータが欠けているページを特定します

ページの健全性チェック：

• メタディスクリプションがない
• OG タグがない
• スラッグが重複している（エラー条件）
• 孤立したページ（ナビゲーションにリンクされていない）

フェーズ 3：コレクション分析

コレクションの詳細： 各コレクションについて、次の情報を表示します：

• 表示名と単数形の名前
• スラッグ（URL 構造）
• フィールドの合計数
• 必須フィールドと任意フィールドの内訳
• アイテム数（公開済み／下書き／アーカイブ済み）
• 最終更新日

フィールド分析： 種類別に分類します：

• テキストフィールド（PlainText、RichText）
• メディアフィールド（Image、Video、File）
• リレーションシップフィールド（Reference、MultiReference）
• データフィールド（DateTime、Number、Color）
• ブール値フィールド（Switch）
• 選択フィールド（Option）

フィールドの検証：

• 最大長の制約を表示します
• 検証パターンを表示します
• 必須フィールドを明示します
• 参照フィールドの参照先を特定します

フェーズ 4：分析とインサイト

コンテンツ健全性スコア（0～100）： 次の項目に基づいて算出します：

• SEO メタデータの充足度（25 ポイント）
• コンテンツとページの比率（20 ポイント）
• フィールドの利用状況（20 ポイント）
• 最近の更新状況（15 ポイント）
• 構造の品質（20 ポイント）

問題の検出：

• 🔴 重大：必須フィールドがない、スラッグが重複している
• ⚠️ 警告：空のコレクション、SEO 情報がない、下書き
• 💡 提案：ページの追加、リレーションシップの作成、整理

推奨事項： 次の内容に基づいて改善案を提案します：

• 不足しているページタイプ（About、Contact など）
• 十分に活用されていないコレクション
• コレクション間のリレーションシップの不足
• SEO の最適化の機会

フェーズ 5：エクスポート形式

Markdown エクスポート：

# Site Audit: [Site Name]

## Site Information
- ID: [site-id]
- Last Published: [date]

## Pages
### Static Pages
- Home (/)
- About (/about)

### CMS Templates
- Blog Post (/post/[slug])

## Collections
### Blog Posts (47 items)
**Fields:**
- Title (PlainText, required)
- Slug (PlainText, required)
- Content (RichText)
...

JSON エクスポート：

{
  "site": {
    "id": "...",
    "name": "...",
    "lastPublished": "..."
  },
  "pages": [...],
  "collections": [...]
}

CSV エクスポート： 次のファイルを個別に生成します：

• pages.csv：メタデータを含むすべてのページ
• collections.csv：コレクションのメタデータ
• fields.csv：すべてのコレクションの全フィールド
• items.csv：コレクションごとのアイテム数

パフォーマンスの最適化

バッチ処理：

• コレクションが 20 件以上あるサイトでは、進行状況を表示します
• アイテムが 100 件以上あるコレクションでは、件数をページ分割します
• 大規模なサイトでは、推定所要時間を提示します

エラー処理：

• data_pages_tool のアクション list_pages が失敗した場合も、コレクションの処理を続行します
• data_cms_tool のアクション get_collection_details が失敗した場合は、基本的なコレクション情報を表示します
• 部分的な成功を分けて報告します
• 失敗した操作の再試行を提案します

データの効率的な処理：

• 大規模な結果セットではページネーションを使用します
• 必要な場合にのみ詳細なスキーマを取得します
• コレクションごとのアイテムサンプルを 3～5 件に制限します
• 繰り返しの操作に備えてサイト情報をキャッシュします

ベストプラクティス

読み取り専用の操作：

• 読み取り専用のため、確認は不要です
• 何度でも安全に実行できます
• 副作用や変更はありません

明確な整理：

• コンテンツタイプ別（ページ／コレクション）にグループ化します
• 視覚的な階層構造を使用します（├── └──）
• 件数を目立つように表示します
• アイコン（✅ ⚠️ 🔴 💡）で問題を強調します

実行可能な出力：

• 必ず推奨事項で締めくくります
• 詳細な一覧をエクスポートするオプションを提示します
• 調査結果に基づく次のステップを提案します
• ベストプラクティスとの比較を提示します

バージョンの追跡： ユーザーがインベントリを複数回実行した場合：

• 前回の実行結果と比較します
• 変更内容（新しいページ、削除されたコレクションなど）を表示します
• 時間の経過に伴うコンテンツの増加を追跡します
• 重大な変更があった場合に通知します