Skip to content

feat(seo): add SEO/GEO optimization for AI search visibility#120

Merged
stwith merged 2 commits intomainfrom
feat/seo-geo-optimization
Mar 13, 2026
Merged

feat(seo): add SEO/GEO optimization for AI search visibility#120
stwith merged 2 commits intomainfrom
feat/seo-geo-optimization

Conversation

@stwith
Copy link
Copy Markdown
Collaborator

@stwith stwith commented Mar 13, 2026

Summary

Add comprehensive SEO and GEO (Generative Engine Optimization) improvements to make ClawPal discoverable by both traditional search engines and AI search engines (ChatGPT, Claude, Perplexity, Gemini).

Changes

index.html

  • Add canonical URL tag
  • Add Open Graph meta tags for social sharing
  • Add Twitter Card meta tags
  • Add SoftwareApplication JSON-LD structured data
  • Improve meta description for better CTR

New Files

  • robots.txt: Allow AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) with content signals
  • llms.txt: AI-friendly content summary following the llms.txt standard
  • sitemap.xml: XML sitemap for search engine indexing

GEO Impact

Before After
AI crawlers blocked (Cloudflare default) AI crawlers allowed
No llms.txt llms.txt with FAQ
No sitemap sitemap.xml
No structured data SoftwareApplication schema
No OG/Twitter cards Full social sharing support

Next Steps (separate PRs)

  • Create og-image.png (1200x630)
  • Add FAQ page with FAQPage schema
  • Submit to Google Search Console

- Add canonical, Open Graph, Twitter Card meta tags
- Add SoftwareApplication JSON-LD schema
- Add robots.txt with AI crawler permissions
- Add llms.txt for AI search engines
- Add sitemap.xml
- Improve meta description for better CTR
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 13, 2026

📊 Test Coverage Report

Metric Base (main) PR (feat/seo-geo-optimization) Delta
Lines 74.34% (6134/8251) 74.34% (6134/8251) ⚪ ±0.00%
Functions 68.88% (704/1022) 68.88% (704/1022) ⚪ ±0.00%
Regions 75.86% (10156/13388) 75.86% (10156/13388) ⚪ ±0.00%

Coverage measured by cargo llvm-cov (clawpal-core + clawpal-cli).

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 13, 2026

📦 PR Build Artifacts

Platform Download Size
Windows-x64 📥 clawpal-Windows-x64 25.7 MB
Linux-x64 📥 clawpal-Linux-x64 103.8 MB
macOS-x64 📥 clawpal-macOS-x64 13.3 MB
macOS-ARM64 📥 clawpal-macOS-ARM64 12.6 MB

🔨 Built from 680f427 · View workflow run
⚠️ Unsigned development builds — for testing only

Copy link
Copy Markdown
Collaborator

@dev01lay2 dev01lay2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR #120 Review — SEO/GEO Optimization

CI: 10/10 green.

Clean, well-structured SEO additions:

  • Meta tags — canonical URL, Open Graph, Twitter Card all correct
  • Structured DataSoftwareApplication schema is valid and comprehensive (correct @type, operatingSystem, offers with price=0)
  • llms.txt — good coverage of features, FAQ format works well for AI search grounding
  • robots.txt — explicit Allow for major AI crawlers, Content-Signal header is a nice forward-looking touch (ai-train=no while allowing ai-input=yes)
  • sitemap.xml — minimal and correct

NBS: og-image.png is referenced in the OG/Twitter meta tags but isn't included in this PR. Make sure to add it before deploying or the social previews will be broken.

LGTM ✅

<!-- Canonical -->
<link rel="canonical" href="https://clawpal.xyz/">

<!-- Open Graph -->
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NBS: og-image.png is referenced here but not included in this PR. Social preview cards will show a broken image until it's added.

Copy link
Copy Markdown
Collaborator

@dev01lay2 dev01lay2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Re-review after 57cf7f8..680f427 (1 new commit)

CI: 10/10 green.

Trivial one-liner: bumps softwareVersion in the structured data JSON-LD from 0.3.0 to 0.3.3 to match the current release. No issues.

LGTM ✅

@stwith stwith merged commit d852a19 into main Mar 13, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants