beckyisj SEO Bootstrapper
Audit a web project's SEO setup and generate everything missing.
Argument: $ARGUMENTS is the project path. If not provided, ask.
Process
1. Scan what's already there
Run these checks in parallel:
# Check for existing SEO files
ls public/sitemap.xml public/robots.txt public/llms.txt 2>/dev/null
ls src/app/sitemap.* src/app/robots.* 2>/dev/null
# Check for meta tags in HTML
grep -l "og:title" *.html public/*.html 2>/dev/null
# Check for JSON-LD
grep -rl "application/ld+json" . 2>/dev/null
# Check framework
cat package.json | grep -E "(next|vite|astro)" 2>/dev/null
2. Ask for essentials (if missing)
- Canonical domain (e.g.,
https://mytool.app) - Site name and tagline
- Description (160 char max for meta description)
- Content type: marketing site, blog, web app, article, or tool?
- Organization info: name, logo URL, social links (for JSON-LD)
3. Generate missing pieces
Use the framework-appropriate approach:
A. sitemap.xml
Static HTML sites — create public/sitemap.xml:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://[domain]/</loc>
<lastmod>2026-04-16</lastmod>
<changefreq>monthly</changefreq>
<priority>1.0</priority>
</url>
<url>
<loc>https://[domain]/articles/</loc>
<lastmod>2026-04-16</lastmod>
<changefreq>weekly</changefreq>
<priority>0.8</priority>
</url>
<!-- Additional pages at 0.7 priority, monthly -->
</urlset>
Next.js App Router — create src/app/sitemap.ts:
import type { MetadataRoute } from 'next';
export default function sitemap(): MetadataRoute.Sitemap {
return [
{
url: 'https://[domain]',
lastModified: new Date(),
changeFrequency: 'monthly',
priority: 1.0,
},
// Additional URLs
];
}
Priority guide:
- Homepage: 1.0
- Index pages (articles, products): 0.8
- Individual content pages: 0.7
- Utility pages (about, contact): 0.5
B. robots.txt
Static sites — create public/robots.txt:
User-agent: *
Allow: /
# AI crawlers
User-agent: GPTBot
Allow: /
User-agent: ClaudeBot
Allow: /
User-agent: Claude-SearchBot
Allow: /
User-agent: PerplexityBot
Allow: /
User-agent: Amazonbot
Allow: /
User-agent: CCBot
Allow: /
Sitemap: https://[domain]/sitemap.xml
Next.js — create src/app/robots.ts:
import type { MetadataRoute } from 'next';
export default function robots(): MetadataRoute.Robots {
return {
rules: [
{ userAgent: '*', allow: '/', disallow: ['/api/'] },
{ userAgent: 'GPTBot', allow: '/' },
{ userAgent: 'ClaudeBot', allow: '/' },
{ userAgent: 'Claude-SearchBot', allow: '/' },
{ userAgent: 'PerplexityBot', allow: '/' },
],
sitemap: 'https://[domain]/sitemap.xml',
};
}
C. llms.txt
Create public/llms.txt (or root for Next.js):
# [Site Name]
> [One-sentence tagline]
## What is [Site Name]?
[2-3 sentence description — what it does, who it's for]
## Key features
- **[Feature 1]**: [Description]
- **[Feature 2]**: [Description]
- **[Feature 3]**: [Description]
## Links
- Homepage: https://[domain]/
- Articles: https://[domain]/articles/
- Contact: https://[domain]/contact/
## About
[1-2 sentences about the creator/company]
Link it from the HTML head:
<link rel="alternate" type="text/plain" href="/llms.txt" title="LLM-friendly content">
D. JSON-LD structured data
Choose the schema based on content type:
Organization (homepage of a product/company):
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "[Name]",
"url": "https://[domain]",
"logo": "https://[domain]/logo.png",
"sameAs": [
"https://x.com/[handle]",
"https://linkedin.com/in/[handle]"
]
}
</script>
WebApplication (a tool or app):
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebApplication",
"name": "[Tool Name]",
"url": "https://[domain]",
"description": "[Description]",
"applicationCategory": "BusinessApplication",
"operatingSystem": "Web",
"offers": {
"@type": "Offer",
"price": "0",
"priceCurrency": "USD"
}
}
</script>
Article (blog posts):
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Article",
"headline": "[Title]",
"description": "[Description]",
"datePublished": "2026-04-16",
"author": { "@type": "Person", "name": "[Author]", "url": "[url]" },
"publisher": {
"@type": "Organization",
"name": "[Publisher]",
"logo": { "@type": "ImageObject", "url": "[logo url]" }
},
"mainEntityOfPage": "https://[domain]/article-url"
},
{
"@type": "BreadcrumbList",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "Home", "item": "https://[domain]/" },
{ "@type": "ListItem", "position": 2, "name": "Articles", "item": "https://[domain]/articles/" }
]
}
]
}
</script>
For Next.js, extract into a <JsonLd> component:
// src/components/JsonLd.tsx
export function JsonLd({ data }: { data: Record<string, unknown> }) {
return (
<script
type="application/ld+json"
dangerouslySetInnerHTML={{ __html: JSON.stringify(data) }}
/>
);
}
E. Meta tags
Ensure every HTML page has:
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>[Specific Page Title] — [Site Name]</title>
<meta name="description" content="[160 char description]">
<meta name="robots" content="index, follow, max-image-preview:large">
<!-- OG -->
<meta property="og:title" content="[Title]">
<meta property="og:description" content="[Description]">
<meta property="og:url" content="https://[domain]/[path]">
<meta property="og:image" content="https://[domain]/og-image.png">
<meta property="og:type" content="website">
<meta property="og:site_name" content="[Site Name]">
<!-- Twitter -->
<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]/og-image.png">
<!-- Canonical -->
<link rel="canonical" href="https://[domain]/[path]">
For Next.js, use the metadata export in layout.tsx:
export const metadata: Metadata = {
metadataBase: new URL('https://[domain]'),
title: { default: '[Site Name]', template: '%s — [Site Name]' },
description: '[Description]',
openGraph: {
title: '[Site Name]',
description: '[Description]',
url: 'https://[domain]',
siteName: '[Site Name]',
images: ['/og-image.png'],
type: 'website',
},
twitter: {
card: 'summary_large_image',
title: '[Site Name]',
description: '[Description]',
images: ['/og-image.png'],
},
alternates: { canonical: 'https://[domain]' },
};
4. Report what was done
Format as a checklist:
## SEO Setup: [Project Name]
### Generated
✓ public/sitemap.xml (12 URLs)
✓ public/robots.txt (with AI crawler allowlist)
✓ public/llms.txt
✓ JSON-LD: Organization schema added to layout
### Already present
✓ OG meta tags
✓ Canonical URL
✓ Twitter cards
### Needs attention
⚠ Missing og-image.png — run /og-image to generate
⚠ Logo URL is a placeholder — update to real logo
5. Remind about verification
After deploying, verify with:
- Google Rich Results Test: https://search.google.com/test/rich-results
- Facebook Sharing Debugger: https://developers.facebook.com/tools/debug/
- LinkedIn Post Inspector: https://www.linkedin.com/post-inspector/
Rules
- Never invent content — if description, tagline, or features are missing, ask
- Always use absolute URLs in sitemap and JSON-LD (not relative paths)
- Explicitly allow AI crawlers (GPTBot, ClaudeBot, Claude-SearchBot, PerplexityBot) — AI search is now a real traffic source, so opt in unless the user says otherwise
- For blogs/articles, use the @graph array to combine Article + BreadcrumbList
- Don't add JSON-LD for content that doesn't exist yet (e.g., don't add Article schema to a homepage)
- Match framework patterns: don't add
public/sitemap.xmlto a Next.js project, usesrc/app/sitemap.ts - Keep llms.txt concise (under 500 words) — it's for AI skim, not humans