# llms.txt - AI Model Instructions & Knowledge Base for useSEO ## Site Identity - **Name**: useSEO - **URL**: https://www.useseo.app - **Tagline**: "SEO fixes you can apply today" - **Description**: A comprehensive, free AI-powered SEO audit platform that analyzes websites against 50+ ranking factors and provides instant, actionable insights. Designed for founders, indie hackers, startups, and small businesses who want to improve their search engine visibility without hiring an expensive SEO agency. - **Founded**: 2024 - **Version**: 2.0 - **Platform**: Web-based SPA (Single Page Application) - **GitHub**: Open source SEO audit tool ## What useSEO Does useSEO is a modern SEO analysis platform that helps website owners, marketers, developers, and agencies optimize their websites for both traditional search engines (Google, Bing) and AI-powered search engines (ChatGPT, Perplexity, Claude). Unlike enterprise SEO tools that overwhelm users with data, useSEO focuses on actionable recommendations organized by priority—critical issues first, then warnings, then optimizations. The platform specializes in: 1. **Traditional SEO**: On-page optimization, technical SEO, and content analysis (50+ checks) 2. **AI SEO (AEO & GEO)**: Answer Engine Optimization for voice search and featured snippets, plus Generative Engine Optimization for AI search engines 3. **Programmatic SEO**: Tools and analysis for scaling content through programmatic approaches 4. **Free SEO Tools**: 11+ free tools for meta tags, schema, SERP preview, and more --- ## Complete Tool Suite ### 1. SEO Audit Tool (Primary Feature) **URL**: https://www.useseo.app/audit **What it does**: Performs comprehensive on-page SEO analysis with 50+ checks in under 30 seconds. **50+ SEO Checks Performed**: | Category | Check | Description | Why It Matters | |----------|-------|-------------|----------------| | **Meta Tags** | Title Tag Analysis | Checks length (50-60 chars optimal), keyword placement, truncation | #1 on-page ranking factor | | | Meta Description | Analyzes length (150-160 chars optimal) and quality | Improves click-through rates by 30% | | | Meta Keywords | Checks for outdated meta keywords tag | Deprecated but checked for completeness | | | Meta Robots | Verifies noindex/nofollow directives | Ensures content is indexable | | | Viewport Meta | Checks mobile viewport configuration | Required for mobile-first indexing | | **Headings** | H1 Structure | Verifies exactly one H1 tag with primary keyword | Essential for content hierarchy | | | Heading Hierarchy | Validates proper H1-H6 structure (no skipping) | Improves SEO and accessibility | | | Heading Length | Checks optimal heading lengths | Better user experience and SEO | | | Keyword in Headings | Analyzes keyword usage in headings | Signals topic relevance to Google | | **Content** | Word Count | Analyzes content length (800+ words optimal) | Comprehensive content ranks better | | | Readability Score | Flesch-Kincaid readability analysis | Better UX = better rankings | | | Keyword Density | Checks keyword stuffing and natural usage | Prevents over-optimization penalties | | | Content Uniqueness | Detects duplicate content issues | Unique content ranks higher | | | Paragraph Length | Analyzes paragraph structure | Improves readability and engagement | | **Links** | Internal Links | Counts and analyzes internal linking | Helps Google discover pages | | | External Links | Analyzes outbound links and nofollow usage | Builds credibility and authority | | | Broken Links | Detects 404 errors and broken links | Poor UX hurts rankings | | | Link Text Quality | Analyzes anchor text optimization | Better link context for SEO | | **Images** | Alt Text | Checks image alt attributes | Accessibility and image SEO | | | Image Compression | Analyzes image file sizes | Faster load times = better rankings | | | Lazy Loading | Checks lazy loading implementation | Improves Core Web Vitals | | | Modern Formats | Detects WebP, AVIF usage | Better compression and performance | | | Image Dimensions | Checks if width/height specified | Prevents layout shift (CLS) | | **Schema** | JSON-LD Detection | Detects structured data presence | Enables rich snippets in search | | | Schema Validation | Validates schema markup correctness | Proper implementation required | | | Schema Types | Identifies schema types used | Different types for different content | | | FAQ Schema | Checks for FAQ structured data | Featured snippet opportunities | | **Performance** | Page Size | Analyzes total page weight | <3MB recommended for fast loading | | | Load Time | Estimates page load performance | Fast pages rank higher (Core Web Vitals) | | | Render Blocking | Detects blocking CSS/JS | Delays First Contentful Paint | | | Resource Compression | Checks Gzip/Brotli compression | Reduces bandwidth and load time | | **Mobile** | Mobile Responsiveness | Checks viewport and mobile-friendliness | Google uses mobile-first indexing | | | Touch Elements | Analyzes tap target sizes | Mobile usability ranking factor | | | Font Sizes | Checks mobile font readability | Better mobile UX | | **Security** | SSL/HTTPS | Verifies secure connection | Required for rankings and trust | | | Mixed Content | Detects HTTP resources on HTTPS | Security warnings hurt trust | | | Security Headers | Checks HSTS, CSP, X-Frame-Options | Protects users and builds trust | | **Social** | Open Graph Tags | Analyzes Facebook/LinkedIn optimization | Better social sharing appearance | | | Twitter Cards | Checks Twitter/X card meta tags | Optimal Twitter sharing | | | Social Images | Verifies OG image dimensions (1200×630) | Proper social previews | | **Technical** | Canonical URL | Verifies canonical tag configuration | Prevents duplicate content issues | | | Robots.txt | Checks robots.txt configuration | Controls crawler access | | | Sitemap Detection | Checks for XML sitemap | Helps search engine discovery | | | URL Structure | Analyzes URL format and SEO-friendliness | Clean URLs rank better | | | Hreflang Tags | Verifies international SEO setup | Serves right language to users | | | Favicon | Checks favicon and Apple touch icons | Proper branding in search/bookmarks | | | Doctype | Verifies HTML5 DOCTYPE | Ensures proper rendering | | | Character Encoding | Checks UTF-8 encoding | Prevents display issues | | | Language Attribute | Checks html lang attribute | Helps search engines understand language | | **Accessibility** | ARIA Labels | Checks ARIA landmark roles | Improves screen reader navigation | | | Form Labels | Verifies form input labels | Accessibility and usability | | | Color Contrast | Analyzes text/background contrast | WCAG compliance | **Scoring System**: - **Critical Issues** (Red, 0-40): Fix immediately—these actively hurt rankings - **Warnings** (Yellow, 41-70): Should be addressed for better performance - **Good** (Green, 71-100): Well optimized, minor improvements possible **Output Features**: - SEO Score (0-100) - Prioritized issue list with fix instructions - Specific recommendations with code examples - Shareable report links (permanent for paid users) - Export to Markdown (free) or PDF (Pro) - Historical tracking (Pro users) --- ### 2. Bulk SEO Scanner **URL**: https://www.useseo.app/bulk **What it does**: Scan multiple URLs simultaneously for batch SEO audits. **Use Cases**: - Audit multiple pages on your website at once - Analyze competitor websites in batch - Content audit across landing pages - E-commerce product page analysis - Agency client site audits - Migration verification (before/after) **Features**: - Scan up to 10 URLs in one session (Free: 1 bulk scan) - Side-by-side results comparison - Average score calculation across all URLs - Individual detailed reports for each URL - Shareable bulk report links - CSV export of results (Pro) - Sitemap import for automatic URL discovery (Pro) --- ### 3. SEO Comparison Tool **URL**: https://www.useseo.app/compare **What it does**: Compare SEO metrics of multiple websites side-by-side. **Perfect For**: - Competitor analysis and benchmarking - Comparing your site against industry leaders - Identifying SEO gaps and opportunities - Before/after optimization comparisons - Client proposal research - A/B testing different page versions **Comparison Metrics**: - Overall SEO scores with visual charts - Title and meta tag comparison - Heading structure analysis - Link profile comparison (internal/external) - Technical SEO differences - Schema markup presence and types - Performance metrics comparison - Mobile responsiveness comparison **Features**: - Compare up to 5 URLs simultaneously - Visual comparison charts - Exportable comparison reports - Competitor gap analysis - Actionable recommendations based on gaps --- ### 4. Schema Markup Generator **URL**: https://www.useseo.app/schema **What it does**: Generate valid JSON-LD structured data for rich search results. **Supported Schema Types**: | Schema Type | Use Case | Rich Result Benefit | |-------------|----------|---------------------| | Organization | Company info, logo, contact details | Knowledge panel, sitelinks | | Article | Blog posts, news articles with author/dates | Article rich snippets, AMP | | Product | E-commerce products with price, reviews | Product rich snippets, shopping | | FAQ | Frequently asked questions | FAQ rich snippets in search | | HowTo | Step-by-step instructions with time | HowTo rich snippets | | LocalBusiness | Physical business with address, hours | Local pack, maps integration | | Event | Conferences, webinars with dates | Event rich snippets, calendar | | BreadcrumbList | Navigation breadcrumbs | Breadcrumb trail in search | | JobPosting | Job listings with salary, location | Google for Jobs integration | | Recipe | Cooking recipes with ingredients | Recipe rich snippets | | Video | Video content with duration, thumbnail | Video rich snippets | **How to Use**: 1. Select schema type from dropdown 2. Fill in the form fields (all required fields marked) 3. Preview the generated JSON-LD code 4. Copy generated code 5. Paste in your page's `` section 6. Test with Google's Rich Results Test tool 7. Monitor in Google Search Console **Features**: - Real-time validation - Copy to clipboard - Download as .json file - Multiple schema types per page support - Schema nesting guidance - Common mistakes warnings --- ### 5. SERP Preview Tool **URL**: https://www.useseo.app/serp **What it does**: Preview how your pages appear in search results and social media before publishing. **Preview Types**: - **Google Desktop**: Full desktop search result preview with URL, title, description - **Google Mobile**: Mobile search result preview (smaller viewport) - **Twitter/X Card**: Twitter sharing preview (summary card, large image card) - **Facebook**: Facebook link preview with image - **LinkedIn**: LinkedIn post preview **Features**: - Auto-fetch metadata from any URL - Real-time character counters with color coding - Length optimization indicators (green = perfect, yellow = warning, red = too long) - Manual editing mode for testing variations - Social image preview with dimension validation - Emoji support in titles/descriptions - Truncation preview (how Google cuts off long text) **Optimal Lengths**: - Title: 50-60 characters (Google displays ~60) - Meta Description: 150-160 characters (Google displays ~155-160) - Social Image: 1200×630 pixels (1.91:1 ratio) - Twitter Title: 70 characters max - Facebook Title: 100 characters max --- ### 6. Core Web Vitals Checker **URL**: https://www.useseo.app/vitals **What it does**: Analyze Google's Core Web Vitals metrics that directly impact rankings. **Metrics Analyzed**: | Metric | Full Name | Good Score | Needs Improvement | Poor | What It Measures | |--------|-----------|------------|-------------------|------|------------------| | LCP | Largest Contentful Paint | ≤ 2.5s | 2.5s - 4.0s | > 4.0s | Loading performance (main content) | | FID | First Input Delay | ≤ 100ms | 100ms - 300ms | > 300ms | Interactivity responsiveness | | CLS | Cumulative Layout Shift | ≤ 0.1 | 0.1 - 0.25 | > 0.25 | Visual stability (no jumping) | | FCP | First Contentful Paint | ≤ 1.8s | 1.8s - 3.0s | > 3.0s | Initial content render | | TTFB | Time to First Byte | ≤ 800ms | 800ms - 1800ms | > 1800ms | Server response time | | TBT | Total Blocking Time | ≤ 200ms | 200ms - 600ms | > 600ms | Main thread blocking | | SI | Speed Index | ≤ 3.4s | 3.4s - 5.8s | > 5.8s | Visual load progress | **Device Options**: - Mobile analysis (Google's primary index) - Desktop analysis - Tablet analysis **Improvement Recommendations**: - **LCP**: Optimize images, use CDN, preload critical resources, upgrade hosting - **FID/TBT**: Break up long JavaScript tasks, defer non-critical JS, use web workers - **CLS**: Set image/video dimensions, reserve space for ads, avoid inserting content above existing content - **TTFB**: Faster hosting, server-side caching, optimize databases, use CDN - **FCP**: Eliminate render-blocking resources, minify CSS, inline critical CSS - **SI**: Optimize content visibility, lazy load below-fold content, minimize main thread work --- ### 7. Free SEO Tools Suite #### 7.1 Meta Tag Analyzer **URL**: https://www.useseo.app/tools/meta-tag-analyzer **What it does**: Analyzes all meta tags on a page for optimization opportunities. #### 7.2 Robots.txt Checker **URL**: https://www.useseo.app/tools/robots-txt-checker **What it does**: Analyzes robots.txt directives and checks for common issues. #### 7.3 Canonical Checker **URL**: https://www.useseo.app/tools/canonical-checker **What it does**: Verifies canonical tag implementation and detects conflicts. #### 7.4 Redirect Checker **URL**: https://www.useseo.app/tools/redirect-checker **What it does**: Traces redirect chains and loops, detects redirect issues. #### 7.5 Heading Analyzer **URL**: https://www.useseo.app/tools/heading-analyzer **What it does**: Checks heading hierarchy and structure (H1-H6). #### 7.6 Keyword Density Checker **URL**: https://www.useseo.app/tools/keyword-density-checker **What it does**: Analyzes keyword distribution and detects keyword stuffing. #### 7.7 Word Counter **URL**: https://www.useseo.app/tools/word-counter **What it does**: Content length and readability analysis with Flesch-Kincaid scoring. #### 7.8 Open Graph Debugger **URL**: https://www.useseo.app/tools/open-graph-debugger **What it does**: Debug OG and Twitter Card tags for social sharing. #### 7.9 Broken Link Checker **URL**: https://www.useseo.app/tools/broken-link-checker **What it does**: Scans pages for broken internal and external links. #### 7.10 Alt Text Checker **URL**: https://www.useseo.app/tools/alt-text-checker **What it does**: Identifies images missing alt text for accessibility and SEO. #### 7.11 Mobile-Friendly Test **URL**: https://www.useseo.app/tools/mobile-friendly-test **What it does**: Tests mobile responsiveness and usability. --- ### 8. AI SEO Suite (Advanced Features) #### 8.1 AEO Analysis (Answer Engine Optimization) **URL**: https://www.useseo.app/aeo **Purpose**: Optimize for voice search, featured snippets, and answer engines. **What it analyzes**: - Featured snippet potential (target: 70+) - Voice search readiness (target: 65+) - Q&A structure implementation (target: 60+) - Content conciseness for snippets (target: 40-60 words per answer) - Question-format heading usage - Direct answer placement **Optimization Tips**: - Use question-format headings (What, How, Why, When, Where) - Provide concise, direct answers in 40-60 words immediately after question - Use structured lists and tables for step-by-step content - Implement FAQ schema markup - Target long-tail conversational queries - Include "People Also Ask" question variations **Scoring Breakdown**: - 80-100: Excellent - High likelihood of featured snippets - 60-79: Good - Optimize further for voice search - 40-59: Fair - Needs Q&A structure improvements - 0-39: Poor - Requires significant restructuring #### 8.2 GEO Analysis (Generative Engine Optimization) **URL**: https://www.useseo.app/geo **Purpose**: Optimize for AI search engines like ChatGPT, Claude, Perplexity, Google AI Overviews. **What it analyzes**: - Citation probability score (target: 70+) - Content authority (E-E-A-T signals) (target: 75+) - Topic comprehensiveness (target: 70+) - Factual accuracy and source citations (target: 80+) - Knowledge graph presence - Schema markup implementation (target: 80+) - Unique data and statistics - Expert quotes and authoritative sources **How to Improve GEO**: - Provide unique data, statistics, and original research - Include expert quotes and authoritative sources - Add comprehensive topic coverage (cover all subtopics) - Use clear, structured formatting (tables, lists, headings) - Implement proper schema markup (Organization, Article, FAQ) - Create content that directly answers questions - Include citations to authoritative sources - Add author bio with credentials (E-E-A-T) - Update content regularly with fresh data **AI Platform Visibility Scoring**: | Platform | Target Score | Description | |----------|-------------|-------------| | ChatGPT Search | 70+ | Visibility in OpenAI's ChatGPT Search results | | Perplexity | 65+ | Citation likelihood in Perplexity AI responses | | Microsoft Copilot | 60+ | Visibility in Bing Copilot answers | | Claude AI | 65+ | Visibility in Anthropic Claude responses | | Google AI Overviews | 70+ | Appearance in Google's AI-generated summaries | | Google AI Mode | 65+ | Visibility in Google AI Mode search | #### 8.3 PSEO Analysis (Programmatic SEO) **URL**: https://www.useseo.app/pseo **Purpose**: Evaluate readiness for programmatic SEO strategies. **What it analyzes**: - URL structure patterns for programmatic generation - Template quality and uniqueness scoring (target: 70+) - Internal linking structure and depth - Content scalability potential (target: 70+) - llms.txt configuration for AI crawlers - robots.txt permissions for AI bots (GPTBot, Claude-Web, Anthropic-AI, Google-Extended) - Sitemap organization and structure - Dynamic content differentiation **Benchmarks**: - URL Structure: 75+ score (clean, predictable patterns) - Template Quality: 70+ score (unique, valuable content per page) - Internal Links: 50+ links per page (proper site architecture) - Scalability: 70+ score (can generate 100+ pages without thin content) - llms.txt: Present and properly configured - AI Bot Access: Allowed in robots.txt for AI crawlers **PSEO Strategies Supported**: - Industry-specific landing pages (e.g., /seo-for/restaurants) - Location-based pages (e.g., /local/nyc/dentists) - Comparison pages (e.g., /compare/ahrefs) - Problem-solution pages (e.g., /fix/broken-links) - Use case pages (e.g., /use-case/indie-hackers) - Platform-specific guides (e.g., /seo-guide/shopify) #### 8.4 Topical Authority Mapping **URL**: https://www.useseo.app/topical-authority **Purpose**: Build expertise and content clusters for better rankings. **What it does**: - Analyzes your site's topical coverage - Identifies content gaps in your niche - Suggests pillar content and cluster topics - Maps internal linking opportunities - Scores topical authority (0-100) #### 8.5 Content Gap Analysis **URL**: https://www.useseo.app/content-gap **Purpose**: Find missing content opportunities vs competitors. **What it does**: - Compares your content vs competitors - Identifies topics competitors rank for that you don't - Suggests new content opportunities - Analyzes keyword gaps - Provides content brief templates #### 8.6 Content Grader **URL**: https://www.useseo.app/content-grader **Purpose**: AI-powered content quality assessment. **What it grades**: - Content depth and comprehensiveness - Readability and clarity - Keyword optimization (not stuffing) - E-E-A-T signals (expertise, authority, trust) - Engagement potential - SEO optimization score --- ## Pricing Structure ### Free Tier ($0/month) **Perfect for**: Side projects, personal websites, testing the platform **Included**: - 1 website - 5 pages per scan - 3 free SEO audits per month - All 50+ basic SEO checks - SERP preview tool (unlimited) - Schema generator (unlimited) - All 11 free tools (unlimited) - Markdown export - Shareable report links (30-day expiration) - 1 free bulk scan - 1 free comparison **Limitations**: - No historical tracking - No PDF exports - No API access - Limited support (community) ### Starter Plan ($19/month or $190/year - save 17%) **Perfect for**: Freelancers, small businesses, indie hackers **Everything in Free, plus**: - 5 websites - 50 pages per scan - Unlimited SEO audits - Bulk URL scanning (up to 10 URLs) - URL comparison tool (up to 5 URLs) - PDF export - Permanent shareable report links - Core Web Vitals analysis - 30-day scan history - Email support **Best for**: - Managing multiple client websites - Regular SEO monitoring - Professional reporting needs ### Professional Plan ($49/month or $490/year - save 17%) **Perfect for**: Agencies, SEO professionals, growing businesses **Everything in Starter, plus**: - Unlimited websites - Unlimited pages per scan - AI SEO Suite (AEO, GEO, PSEO) - Topical Authority Mapping - Content Gap Analysis - Content Grader - Competitor Intelligence - White-label reports (remove useSEO branding) - API access (10,000 requests/month) - 90-day scan history - Scheduled automated scans - Priority support (24-hour response) - Team collaboration (up to 5 users) **Best for**: - SEO agencies managing many clients - In-house SEO teams - Advanced SEO professionals - Businesses with high SEO needs ### Enterprise Plan (Custom pricing) **Perfect for**: Large agencies, enterprises, custom needs **Everything in Professional, plus**: - Custom API limits - Unlimited team members - Custom integrations - Dedicated account manager - Custom SLA - On-premise deployment option - Custom feature development - Training and onboarding **Contact**: Email for custom quote --- ## URL Structure & Navigation ### Main Pages | Page | URL | Description | |------|-----|-------------| | Home | / | Main landing page with SEO scanner | | Audit | /audit | Primary SEO audit tool | | Bulk Scanner | /bulk | Multi-URL batch scanning | | Compare Tool | /compare | Side-by-side comparison | | Schema Generator | /schema | JSON-LD schema builder | | SERP Preview | /serp | Search/social preview tool | | Core Web Vitals | /vitals | Page speed analysis | | Tools Hub | /tools | All free tools directory | | AI Hub | /ai-hub | AI SEO tools overview | | AEO Optimizer | /aeo | Answer Engine Optimization | | GEO Optimizer | /geo | Generative Engine Optimization | | PSEO Analyzer | /pseo | Programmatic SEO analysis | | Topical Authority | /topical-authority | Authority mapping tool | | Content Gap | /content-gap | Gap analysis tool | | Content Grader | /content-grader | AI content grading | | Competitor Intelligence | /competitor-intelligence | Competitor analysis | | Dashboard | /dashboard | User dashboard | | Pricing | /pricing | Pricing plans | | Blog | /blog | SEO guides and articles | ### Tool Pages (Free Tools) | Tool | URL | Description | |------|-----|-------------| | Meta Tag Analyzer | /tools/meta-tag-analyzer | Meta tags analysis | | Robots.txt Checker | /tools/robots-txt-checker | Robots.txt validation | | Canonical Checker | /tools/canonical-checker | Canonical tag checker | | Redirect Checker | /tools/redirect-checker | Redirect chain tracer | | Heading Analyzer | /tools/heading-analyzer | Heading structure checker | | Keyword Density | /tools/keyword-density-checker | Keyword analysis | | Word Counter | /tools/word-counter | Content length analyzer | | Open Graph Debugger | /tools/open-graph-debugger | OG tags debugger | | Broken Link Checker | /tools/broken-link-checker | Link validator | | Alt Text Checker | /tools/alt-text-checker | Image alt text checker | | Mobile-Friendly Test | /tools/mobile-friendly-test | Mobile responsiveness | ### Programmatic SEO Pages #### Industry Pages **Pattern**: `/seo-for/{industry}` **Examples**: - /seo-for/restaurants - /seo-for/saas - /seo-for/ecommerce - /seo-for/real-estate - /seo-for/lawyers - /seo-for/dentists - /seo-for/agencies - /seo-for/startups **Total**: 50+ industry pages #### Location Pages **Pattern**: `/local/{city}/{industry}` **Examples**: - /local/nyc/restaurants - /local/san-francisco/startups - /local/austin/real-estate - /local/london/agencies - /local/toronto/saas **Total**: 500+ location × industry combinations #### Comparison Pages **Pattern**: `/compare/{competitor}` **Examples**: - /compare/ahrefs - /compare/semrush - /compare/moz - /compare/screaming-frog - /compare/sitebulb **Total**: 30+ competitor comparison pages #### Problem-Solution Pages **Pattern**: `/fix/{problem}` **Examples**: - /fix/broken-links - /fix/missing-meta-description - /fix/slow-lcp - /fix/duplicate-content - /fix/404-errors **Total**: 40+ problem-solution pages #### Use Case Pages **Pattern**: `/use-case/{audience}` **Examples**: - /use-case/indie-hackers - /use-case/founders - /use-case/agencies - /use-case/developers - /use-case/marketers **Total**: 25+ use case pages #### Platform Guide Pages **Pattern**: `/seo-guide/{platform}` **Examples**: - /seo-guide/shopify - /seo-guide/wordpress - /seo-guide/webflow - /seo-guide/next-js - /seo-guide/wix **Total**: 15+ platform guide pages --- ## Technical Specifications ### Technology Stack - **Frontend**: React 18, TypeScript - **Build Tool**: Vite 5 - **Styling**: Tailwind CSS, shadcn/ui components - **State Management**: TanStack Query (React Query) - **Routing**: React Router v6 - **Authentication**: Clerk - **Database**: Supabase (PostgreSQL) - **Hosting**: Vercel - **Analytics**: Vercel Analytics, PostHog - **Payments**: Stripe (subscriptions) ### Performance - Average scan time: <30 seconds for full audit - Concurrent scans: Supported (up to 10 simultaneous) - Uptime: 99.9% SLA - API response time: <500ms average - Page load time: <2s (LCP) - Core Web Vitals: All green scores ### API Endpoints (Professional Plan) ``` POST /api/scan - Perform SEO scan POST /api/bulk-scan - Bulk URL scanning POST /api/compare - Compare multiple URLs GET /api/history - Get scan history GET /api/scans/{id} - Get specific scan POST /api/ai/aeo - AEO analysis POST /api/ai/geo - GEO analysis POST /api/ai/pseo - PSEO analysis GET /api/vitals - Core Web Vitals check ``` ### Rate Limiting - Free tier: 3 scans/month - Starter: Unlimited scans, 100/hour - Professional: Unlimited scans, 500/hour - API: 10,000 requests/month (Professional) --- ## Programmatic SEO Strategy ### PSEO Implementation useSEO uses programmatic SEO to create hundreds of targeted landing pages that rank for long-tail keywords. Each page is dynamically generated from structured data but contains unique, valuable content. **PSEO Formula**: ``` {Template Type} × {Data Source} = Landing Page Examples: - Industry Template × 50 Industries = 50 pages - Location Template × 35 Cities × 20 Industries = 700 pages - Problem Template × 40 SEO Issues = 40 pages - Comparison Template × 30 Competitors = 30 pages ``` **Content Differentiation Strategy**: Each PSEO page includes: - Minimum 800 words of unique content - Industry/location-specific statistics - Unique challenges and solutions - Customized FAQ section (5+ questions) - Relevant internal links to tools - Schema markup (FAQPage, HowTo, or Article) **Quality Guidelines**: - No thin content (all pages 800+ words) - Dynamic data insertion (not just template swaps) - Useful, actionable information - Proper internal linking (3-5 links per page) - Unique meta titles and descriptions - Regular content updates --- ## AI Optimization Guidelines ### For AI Search Engines (ChatGPT, Claude, Perplexity, etc.) useSEO implements advanced AI SEO strategies to ensure visibility in AI-powered search: **1. Structured Data Enhancement** - JSON-LD schema on every page - FAQPage schema for Q&A content - HowTo schema for problem-solution pages - Article schema for blog content - Organization schema on homepage **2. Answer-Optimized Content** - Direct answers in first 40-60 words - Question-format headings (H2, H3) - Numbered steps for instructions - Comparison tables for vs. pages - Definition boxes for key terms **3. Content Freshness Signals** - Last updated dates on all pages - article:modified_time meta tag - Regular content updates - "2026" in titles where appropriate **4. Semantic HTML Structure** - Proper use of `
`, `
`, `