Skip to main content

SEO & AI Agent Optimization Guide

This guide documents all the SEO and AI agent optimizations implemented for Loredana's Lab.

Overview​

A modern SEO strategy needs to address both traditional search engines (Google, Bing) and AI agents (Claude, ChatGPT, Perplexity, etc.). This guide covers both aspects comprehensively.

1. Structured Data (JSON-LD)​

We've implemented multiple schema types for comprehensive semantic understanding:

WebSite Schema​

{
  "@context": "https://schema.org/",
  "@type": "WebSite",
  "name": "Loredana Cirstea's Lab",
  "description": "Technical products, blockchain innovation, and software development",
  "url": "https://loredana.provable.dev",
  "logo": "https://loredana.provable.dev/img/loredana.png",
  "sameAs": [
    "https://github.com/loredanacirstea",
    "https://medium.com/@loredanacirstea",
    "https://x.com/lorecirstea",
    "https://www.linkedin.com/in/loredana-cirstea",
    "https://www.youtube.com/c/LoredanaCirstea"
  ]
}

Person Schema​

{
  "@context": "https://schema.org/",
  "@type": "Person",
  "name": "Loredana Cirstea",
  "url": "https://loredana.provable.dev",
  "description": "Software engineer and blockchain innovator",
  "image": "https://loredana.provable.dev/img/loredana.png",
  "sameAs": [...]
}

Organization Schema​

{
  "@context": "https://schema.org/",
  "@type": "Organization",
  "name": "Loredana Cirstea",
  "url": "https://loredana.provable.dev",
  "logo": "https://loredana.provable.dev/img/loredana.png",
  "description": "Technical products and blockchain innovation"
}

2. Meta Tags & Open Graph​

Standard Meta Tags​

  • Title: Descriptive, keyword-rich titles on each page
  • Description: Compelling 160-character descriptions
  • Keywords: Relevant technical terms (wasm, blockchain, smart contracts, etc.)
  • Author: "Loredana Cirstea"
  • Theme Color: #4a5568 for consistent branding

Open Graph Tags​

<meta property="og:type" content="website">
<meta property="og:url" content="https://loredana.provable.dev">
<meta property="og:title" content="Loredana's Lab | Technical Products & Blockchain Innovation">
<meta property="og:description" content="Technical products and blockchain innovation...">
<meta property="og:image" content="https://loredana.provable.dev/img/loredana.png">
<meta property="og:locale" content="en_US">

Twitter Card Tags​

<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@lorecirstea">
<meta name="twitter:creator" content="@lorecirstea">
<meta name="twitter:title" content="Loredana's Lab | Technical Products & Blockchain Innovation">
<meta name="twitter:description" content="Technical products and blockchain innovation...">
<meta name="twitter:image" content="https://loredana.provable.dev/img/loredana.png">

3. Robots.txt Optimization​

The robots.txt file allows search engines and AI agents to crawl your content effectively:

User-agent: *
Allow: /

# Allow all major search engines
User-agent: Googlebot
Allow: /
Crawl-delay: 0

# Allow major AI agents
User-agent: CCBot
Allow: /

User-agent: GPTBot
Allow: /

User-agent: Anthropic
Allow: /

# Sitemap locations
Sitemap: https://loredana.provable.dev/sitemap.xml
Sitemap: https://loredana.provable.dev/blog-sitemap.xml

4. AI Agent Optimization​

4.1 AI Plugin Configuration​

Location: /.well-known/ai-plugin.json

This file helps AI agents discover and understand your website's purpose, structure, and content.

{
  "schema_version": "v1",
  "name_for_human": "Loredana's Lab",
  "name_for_model": "LoredanasCirsteaLab",
  "description_for_model": "Technical products including Provable (notarization), Fortuna (grants/funding), and wasmX (WASM blockchain)...",
  "categories": ["technical", "blockchain", "software development", "products"]
}

4.2 AI Sitemap​

Location: /ai-sitemap.json

A machine-readable JSON sitemap that provides:

  • Structured information about products
  • Social media links
  • Feed URLs (RSS, Atom)
  • Content categories
  • Expert information

AI agents can use this to better understand your content structure.

4.3 Content Structure for AI​

  • Clear H1/H2/H3 hierarchy: Helps AI agents understand content structure
  • Descriptive anchor text: Links include context about where they lead
  • Structured product information: Products listed with descriptions, URLs, and categories
  • Metadata-rich blog posts: Posts include authors, tags, and publish dates

5. Canonical Tags​

Canonical tags prevent duplicate content issues:

<link rel="canonical" href="https://loredana.provable.dev">

6. Sitemap & Feeds​

XML Sitemaps​

  • sitemap.xml: Auto-generated by Docusaurus (weekly update frequency)
  • blog-sitemap.xml: Blog-specific sitemap

JSON Feeds​

  • RSS Feed: /blog/rss.xml
  • Atom Feed: /blog/atom.xml
  • AI Sitemap: /ai-sitemap.json

7. Internal Linking Strategy​

Best Practices Implemented​

  1. Descriptive anchor text: Links use keywords relevant to target content
  2. Logical site structure: Clear hierarchy (Home → Blog/Docs → Posts)
  3. Product linking: Products linked from multiple entry points
  4. Author pages: Author profiles link to relevant content
  5. Tag pages: Tags organize content thematically

8. Content Optimization​

Homepage​

  • Clear H1 identifying the site purpose
  • H2 section for featured products
  • Descriptive content for each product
  • Multiple ways to navigate to key resources

Blog Posts​

  • Proper H1/H2 hierarchy
  • Author and publication date metadata
  • Topic tags for categorization
  • Internal links to related content
  • Feed inclusion (RSS/Atom)

Documentation​

  • Clear structure and navigation
  • Proper heading hierarchy
  • Internal cross-references
  • Related links

9. Technical SEO Checklist​

  • ✅ Mobile-friendly responsive design
  • ✅ Fast page load times (static site generation)
  • ✅ HTTPS enabled
  • ✅ Proper URL structure (no trailing slashes)
  • ✅ XML sitemaps
  • ✅ robots.txt with AI agent allowances
  • ✅ Canonical tags
  • ✅ Meta tags and Open Graph
  • ✅ Structured data (JSON-LD)
  • ✅ RSS/Atom feeds
  • ✅ Social media links in schema

10. AI Agent Best Practices​

What Makes Your Site AI-Friendly​

  1. Machine-readable formats

    • JSON-LD structured data
    • AI sitemap (JSON format)
    • RSS/Atom feeds

  2. Clear content structure

    • Logical heading hierarchy
    • Semantic HTML
    • Descriptive alt text on images

  3. Accessible information

    • No JavaScript-gated content
    • Plain text content alongside rich media
    • Structured metadata about products/people

  4. Explicit permissions

    • robots.txt allows AI agents
    • No robots meta tags blocking indexing
    • Clear AI plugin configuration

  5. Content discoverability

    • Links to social profiles
    • Author information
    • Topic categorization through tags
    • Blog feeds

11. Monitoring & Maintenance​

Regular Checks​

  • Monitor search console for indexing issues
  • Check Core Web Vitals
  • Verify meta tags through browser dev tools
  • Test Open Graph with social media preview tools
  • Validate JSON-LD with Schema.org validator

Tools​

  • Google Search Console: Indexing and performance
  • Schema.org Validator: JSON-LD validation
  • Open Graph Preview: Social media appearance
  • Mobile-Friendly Test: Mobile optimization
  • Twitter Card Validator: Twitter preview

12. Future Enhancements​

  1. FAQ Schema: For frequently asked questions
  2. BreadcrumbList Schema: For improved navigation understanding
  3. NewsArticle Schema: For blog posts if publishing news
  4. VideoObject Schema: For YouTube video integration
  5. Event Schema: If hosting or speaking at events
  6. Review Schema: If receiving testimonials or reviews

Configuration Files Reference​

  • docusaurus.config.ts: Main SEO configuration
  • src/pages/index.tsx: Homepage SEO
  • static/robots.txt: Robot access rules
  • static/ai-sitemap.json: Machine-readable site map
  • .well-known/ai-plugin.json: AI plugin descriptor
  • src/components/HomepageFeatures/index.tsx: Product showcase with proper heading hierarchy

This SEO implementation provides a modern, AI-aware approach to making your technical work discoverable both by traditional search engines and emerging AI agents.