mcpField
S
seo-analytics-auditor

seo-analytics-auditor

github.com/travisjneumanMarketing & growth106150 installsUpdated 1d ago
Repository

About seo-analytics-auditor

A practical skill for reviewing SEO, analytics, and Core Web Vitals on websites. It guides source and deployed-HTML checks, with browser audits reserved for user-approved methods.

Key features

  1. 01Audit meta tags and structured data
  2. 02Verify GA4 and Cloudflare analytics
  3. 03Review Core Web Vitals
  4. 04Check Search Console issues
  5. 05Inspect robots.txt and sitemap.xml

Use cases

  1. 01Review a site's SEO metadata
  2. 02Check analytics installation
  3. 03Investigate web performance metrics
  4. 04Troubleshoot crawler and sitemap settings

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/travisjneuman/.claude --skill seo-analytics-auditor

After installing, type/seo-analytics-auditorin Claude Code to confirm it loaded.

Details

From the project README

SEO & Analytics Auditor

Audit SEO, verify analytics, and optimize Core Web Vitals.

When to Use

Use for:

  • Auditing SEO meta tags and structured data
  • Verifying analytics implementations (GA4, Cloudflare)
  • Checking Core Web Vitals (LCP, INP, CLS)
  • Troubleshooting Search Console issues
  • Validating Open Graph and Twitter Card meta tags
  • Reviewing robots.txt and sitemap.xml

Quick Audit Workflow

Local browser automation installs (npx lighthouse, Playwright, headless Chrome) are not allowed on the owner's Mac. Start from reading the source, meta tags, and deployed HTML; run Lighthouse or other browser audits only when the user asks, through an approved lane (such as PageSpeed Insights or the Search Console reports).

# 1. Run Lighthouse audit
npx lighthouse https://yoursite.com --output=html --output-path=./audit.html

# 2. Check Core Web Vitals
npx lighthouse https://yoursite.com --only-categories=performance

# 3. Validate structured data
# Open: https://search.google.com/test/rich-results

SEO Checklist

Meta Tags (Required)
<title>Page Title - Brand (50-60 chars)</title>
<meta name="description" content="Description (150-160 chars)" />
<meta name="robots" content="index, follow" />
<link rel="canonical" href="https://domain.com/page/" />
Open Graph (Social Sharing)
<meta property="og:type" content="website" />
<meta property="og:url" content="https://domain.com/" />
<meta property="og:title" content="Title" />
<meta property="og:description" content="Description" />
<meta property="og:image" content="https://domain.com/og-image.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
Twitter Card
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Title" />
<meta name="twitter:description" content="Description" />
<meta name="twitter:image" content="https://domain.com/og-image.png" />
Schema.org (Structured Data)
<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Person",
    "name": "Name",
    "jobTitle": "Title",
    "url": "https://domain.com"
  }
</script>

Analytics Implementation

Google Analytics 4
<script
  async
  src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"
></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag() {
    dataLayer.push(arguments);
  }
  gtag("js", new Date());
  gtag("config", "G-XXXXXXXXXX", {
    anonymize_ip: true,
    cookie_flags: "SameSite=None;Secure",
  });
</script>
Cloudflare Web Analytics
<script
  defer
  src="https://static.cloudflareinsights.com/beacon.min.js"
  data-cf-beacon='{"token": "YOUR_TOKEN"}'
></script>

Core Web Vitals Targets (2025)

MetricGoodNeeds ImprovementPoor
LCP (Largest Contentful Paint)< 2.5s2.5s - 4s> 4s
INP (Interaction to Next Paint)< 200ms200ms - 500ms> 500ms
CLS (Cumulative Layout Shift)< 0.10.1 - 0.25> 0.25

Testing Tools

ToolURLPurpose
PageSpeed Insightshttps://pagespeed.web.devCore Web Vitals
Rich Results Testhttps://search.google.com/test/rich-resultsSchema.org
OpenGraph.xyzhttps://www.opengraph.xyzSocial preview

Files to Check

  • index.html - Meta tags, analytics scripts, Schema.org
  • robots.txt - Crawler directives, sitemap reference
  • sitemap.xml - URL list, lastmod dates
  • manifest.json - PWA config

Common Issues

IssueFix
Meta description too shortUse 150-160 characters
Missing canonical URLAdd <link rel="canonical">
OG image wrong sizeUse 1200x630 for best display
Schema.org errorsTest with Rich Results Test
Analytics not firingCheck browser console for errors

Integration Checklist

  • Google Search Console verified
  • Sitemap submitted to GSC
  • GA4 property created and linked
  • Core Web Vitals in "Good" range
  • Rich Results test passing
  • Social preview working

See Also

Comments

Markdown supported