| name | seo-auditing |
| description | Audit technical SEO — meta tags, structured data, Open Graph, sitemaps, robots.txt, performance, and accessibility signals. |
| user-invocable | true |
SEO Auditing
Check and fix technical SEO issues in a web project.
Audit Checklist
1. Meta Tags
Every page must have:
<head>
<title>Page Title — Site Name</title>
<meta name="description" content="155 chars max, compelling summary" />
<link rel="canonical" href="https://example.com/page" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
</head>
Check for:
2. Open Graph & Social
<meta property="og:title" content="Page Title" />
<meta property="og:description" content="Description for social sharing" />
<meta property="og:image" content="https://example.com/og-image.png" />
<meta property="og:url" content="https://example.com/page" />
<meta property="og:type" content="website" />
<meta name="twitter:card" content="summary_large_image" />
3. Structured Data (JSON-LD)
Add schema markup for rich search results:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Article Title",
"author": { "@type": "Person", "name": "Author Name" },
"datePublished": "2026-04-10",
"image": "https://example.com/image.jpg"
}
</script>
Common types: Article, Product, FAQPage, Organization, BreadcrumbList
Test with: https://search.google.com/test/rich-results
4. Sitemap
/sitemap.xml should:
- List all indexable pages
- Include
<lastmod> dates
- Exclude pages with
noindex
- Be under 50MB / 50,000 URLs per file
- Be referenced in
robots.txt
5. Robots.txt
/robots.txt should:
User-agent: *
Allow: /
Disallow: /api/
Disallow: /admin/
Sitemap: https://example.com/sitemap.xml
- Not block CSS/JS files (search engines need them to render)
- Not block pages you want indexed
6. Performance (Core Web Vitals)
| Metric | Good | Needs Work |
|---|
| LCP (Largest Contentful Paint) | < 2.5s | > 4.0s |
| INP (Interaction to Next Paint) | < 200ms | > 500ms |
| CLS (Cumulative Layout Shift) | < 0.1 | > 0.25 |
Key fixes:
- Compress and lazy-load images
- Preload critical fonts and CSS
- Avoid layout shifts from dynamic content
- Use
next/image or equivalent for automatic optimization
7. Crawlability
8. Accessibility (SEO Signals)
Quick Automated Check
curl -s https://example.com/robots.txt
curl -s https://example.com/sitemap.xml | head -20
curl -s https://example.com | grep -E '<title>|<meta name="description"|<link rel="canonical"'
curl -o /dev/null -s -w "%{http_code}" https://example.com/page
Tips
- Run Lighthouse in Chrome DevTools → check SEO score
- Google Search Console is the source of truth for indexing issues
- Mobile-friendliness is a ranking factor — test on mobile viewports
- Page speed directly affects rankings — optimize Core Web Vitals