seomd-cli 1.0.0

package/src/templates/ecommerce/SEO.md

@@ -0,0 +1,354 @@
+# SEO.md
+
+## {{brand}}
+
+### spec v1.0 | <https://seomd.dev>
+
+#### generated: {{date}}
+
+## FIELD OWNERSHIP
+
+### no prefix     = founder declares (you own this)
+
+### _analysis:    = platform writes back (do not edit manually)
+
+## Site
+
+site:
+  type: ecommerce
+  domain: {{domain}}
+  canonical: https://{{domain}}
+  locale: en-US
+  launched: null              # YYYY-MM-DD
+
+## Identity
+
+identity:
+  brand: "{{brand}}"
+  tagline: null
+  social:
+    twitter: null
+    linkedin: null
+    github: null
+  schema_org_type: Organization
+
+## Keywords
+
+keywords:
+
+### FOUNDER DECLARES
+
+  primary: "{{primary_keyword}}"
+  secondary: []               # add your secondary keywords
+  negative:                   # terms that dilute your intent signal
+    - "free"
+    - "tutorial"
+    - "how to"
+  competitor_terms:
+{{competitor_terms}}
+  category_terms:             # unbranded category queries
+    - "best {{primary_keyword}}"
+    - "top {{primary_keyword}} tools"
+  long_tail: []               # add long-tail variations
+  seasonal: null              # add seasonal terms if applicable
+
+### PLATFORM WRITES BACK
+
+  _analysis:
+    source: null
+    primary_search_volume: null
+    primary_intent_type: null
+    primary_trend: null
+    recommended_secondary: []
+    negative_additions_suggested: []
+    last_analyzed: null
+    next_analysis: null
+
+## Intent
+
+intent:
+
+### FOUNDER DECLARES
+
+#### Add queries your buyers actually type into AI engines
+
+#### Tip: think about what someone asks ChatGPT or Perplexity
+
+#### when they are looking for a solution like yours
+
+  informational:
+    priority: low
+    queries:
+      - "what is {{primary_keyword}}"
+      - "how does {{primary_keyword}} work"
+
+  comparison:
+    priority: high
+    queries:
+{{competitors_comparison_queries}}
+      - "best {{primary_keyword}} for startups"
+
+  transactional:
+    priority: critical
+    queries:
+      - "is {{brand_lower}} worth it"
+      - "should I use {{brand_lower}}"
+      - "{{brand_lower}} pricing"
+
+  reputational:
+    priority: high
+    queries:
+      - "{{brand_lower}} reviews"
+      - "is {{brand_lower}} legit"
+      - "{{brand_lower}} problems"
+
+  category:
+    priority: high
+    queries:
+      - "best {{primary_keyword}}"
+      - "top {{primary_keyword}} 2026"
+
+### PLATFORM WRITES BACK
+
+  _analysis:
+    source: null
+    last_analyzed: null
+    next_analysis: null
+    informational:
+      citation_rate: null
+      top_cited_competitor: null
+      gap_score: null
+      trend: null
+    comparison:
+      citation_rate: null
+      top_cited_competitor: null
+      gap_score: null
+      trend: null
+    transactional:
+      citation_rate: null
+      top_cited_competitor: null
+      gap_score: null
+      trend: null
+    reputational:
+      citation_rate: null
+      top_cited_competitor: null
+      gap_score: null
+      trend: null
+    category:
+      citation_rate: null
+      top_cited_competitor: null
+      gap_score: null
+      trend: null
+
+## Pages
+
+pages:
+  site_type: ecommerce
+
+### FOUNDER DECLARES
+
+#### status: live | draft | planned
+
+  required:
+    - id: homepage
+      url: /
+      primary_keyword: null
+      status: planned
+      priority: 1
+
+    - id: category
+      url: /[category]
+      primary_keyword: null
+      status: planned
+      priority: 2
+
+    - id: product
+      url: /products/[slug]
+      primary_keyword: null
+      status: planned
+      priority: 3
+
+    - id: collection
+      url: /collections/[slug]
+      primary_keyword: null
+      status: planned
+      priority: 4
+
+    - id: reviews
+      url: /reviews
+      primary_keyword: null
+      status: planned
+      priority: 5
+
+    - id: cart
+      url: /cart
+      primary_keyword: null
+      status: planned
+      priority: 6
+
+    - id: checkout
+      url: /checkout
+      primary_keyword: null
+      status: planned
+      priority: 7
+
+### PLATFORM WRITES BACK
+
+  _analysis:
+    source: null
+    last_analyzed: null
+    pages: []
+    missing_pages: []
+    build_order_recommendation: []
+
+## Copy
+
+copy:
+
+### FOUNDER DECLARES
+
+  h1_contains_primary_keyword: true
+  meta_description_length: 150-160
+  meta_description_includes_cta: true
+  min_word_count:
+    homepage: 800
+    feature_page: 600
+    blog_post: 1200
+    comparison_page: 1500
+  reading_level: 8             # grade level target
+
+## Structure
+
+structure:
+
+### FOUNDER DECLARES
+
+  answer_first: true           # direct answer in first 50 words
+  faq_section_required: true   # on all key pages
+  faq_minimum_questions: 6
+  statistics_per_page: 2       # minimum data points with sources
+  citations_required: true     # link to primary sources
+  short_paragraphs: true       # max 3 sentences
+  heading_hierarchy: strict    # H1 > H2 > H3, no skipping
+
+## Authority
+
+authority:
+
+### FOUNDER DECLARES
+
+  cite_sources: true
+  expert_quotes: false         # set true when you have quotes
+  eeat_signals:
+    experience: null           # describe your experience signal
+    expertise: null            # describe your expertise signal
+    authority: null            # describe your authority signal
+    trust: null                # describe your trust signal
+
+## Schema
+
+schema:
+
+### FOUNDER DECLARES
+
+  types:
+    - Product
+    - Organization
+    - FAQPage
+    - BreadcrumbList
+  faq_schema: true
+  breadcrumb_schema: true
+  organization_schema: true
+
+## Crawl
+
+crawl:
+
+### FOUNDER DECLARES
+
+  sitemap: /sitemap.xml
+  robots_txt: /robots.txt
+  allow_ai_bots: true
+  allowed_bots:
+    - Googlebot
+    - Bingbot
+    - PerplexityBot
+    - ChatGPT-User
+    - GPTBot
+    - ClaudeBot
+    - anthropic-ai
+    - cohere-ai
+  disallow:
+    - /admin
+    - /checkout
+    - /user/*
+    - /api/*
+
+## Performance
+
+performance:
+
+### FOUNDER DECLARES
+
+  lcp: 2.5s
+  cls: 0.1
+  fid: 100ms
+  page_size: 500kb
+  ttfb: 800ms
+
+## AEO
+
+aeo:
+
+### FOUNDER DECLARES
+
+### AI Engine Optimization rules
+
+  answer_first_format: true
+  faq_on_all_key_pages: true
+  structured_data_priority: high
+  content_freshness_target: 30d  # update key pages within 30 days
+  competitors_to_monitor:
+{{competitors_to_monitor}}
+
+### PLATFORM WRITES BACK
+
+  _analysis:
+    source: null
+    overall_citation_rate: null
+    overall_gap_score: null
+    engines_tracked:
+      - chatgpt
+      - perplexity
+      - claude
+      - gemini
+      - grok
+    last_analyzed: null
+    next_analysis: null
+
+## Monitoring
+
+monitoring:
+
+### FOUNDER DECLARES
+
+  sync_schedule: monthly       # monthly | weekly | on_demand
+  auto_commit: false           # platform commits directly to repo
+  pr_mode: true                # open PR instead of direct commit
+  branch: main
+  alert_on_gap_score_above: 80 # alert when gap score exceeds threshold
+  alert_on_citation_drop: true # alert if citation rate drops
+
+## Platform Connection
+
+### Connect at <https://seomd.dev/connect>
+
+### Add SEOMD_API_KEY to your .env file
+
+### Never commit your API key to version control
+
+platform:
+  provider: null               # foxcite | manual | ahrefs | semrush
+  project_id: null
+
+### api_key: loaded from SEOMD_API_KEY environment variable

package/src/templates/local/SEO.REVERSE.md

@@ -0,0 +1,222 @@
+# SEO.REVERSE.md
+
+## {{brand}}
+
+### spec v1.0 | https://seomd.dev
+
+#### generated: {{date}}
+
+## This file is generated by the {{brand}} platform.
+### Do not edit manually — run `npx seomd analyze` to update.
+### Run `npx seomd sync` to pull latest intelligence.
+
+## Each page section contains a full reverse engineer analysis:
+
+###   why_page_won             — what the top cited competitor does right
+###   citation_hooks           — specific patterns to replicate
+###   gaps_for_brand           — where your page falls short
+###   remediation_playbook     — step by step fixes with effort/impact
+###   fastest_win              — highest ROI action to take now
+###   suggested_content_outline — ready to use outline for your writer/AI
+
+domain: {{domain}}
+brand: "{{brand}}"
+primary_competitor: {{primary_competitor}}
+last_analyzed: null
+next_analysis: null
+source: null
+
+## Pages
+### Run `npx seomd analyze` to populate these sections
+
+pages:
+
+  ### Homepage
+
+  - id: homepage
+    url: /
+    status: planned
+    citation_rate: null
+    gap_score: null
+    top_cited_competitor: null
+
+    why_page_won: []
+    citation_hooks: []
+
+    gaps_for_{{brand_lower_snake}}: []
+
+    remediation_playbook: []
+
+    fastest_win:
+      action: null
+      estimated_gap_score_improvement: null
+      effort: null
+
+    suggested_content_outline: []
+
+  ### Services
+
+  - id: services
+    url: /services
+    status: planned
+    citation_rate: null
+    gap_score: null
+    top_cited_competitor: null
+
+    why_page_won: []
+    citation_hooks: []
+
+    gaps_for_{{brand_lower_snake}}: []
+
+    remediation_playbook: []
+
+    fastest_win:
+      action: null
+      estimated_gap_score_improvement: null
+      effort: null
+
+    suggested_content_outline: []
+
+  ### Location
+
+  - id: location
+    url: /[city]
+    status: planned
+    citation_rate: null
+    gap_score: null
+    top_cited_competitor: null
+
+    why_page_won: []
+    citation_hooks: []
+
+    gaps_for_{{brand_lower_snake}}: []
+
+    remediation_playbook: []
+
+    fastest_win:
+      action: null
+      estimated_gap_score_improvement: null
+      effort: null
+
+    suggested_content_outline: []
+
+  ### About
+
+  - id: about
+    url: /about
+    status: planned
+    citation_rate: null
+    gap_score: null
+    top_cited_competitor: null
+
+    why_page_won: []
+    citation_hooks: []
+
+    gaps_for_{{brand_lower_snake}}: []
+
+    remediation_playbook: []
+
+    fastest_win:
+      action: null
+      estimated_gap_score_improvement: null
+      effort: null
+
+    suggested_content_outline: []
+
+  ### Reviews
+
+  - id: reviews
+    url: /reviews
+    status: planned
+    citation_rate: null
+    gap_score: null
+    top_cited_competitor: null
+
+    why_page_won: []
+    citation_hooks: []
+
+    gaps_for_{{brand_lower_snake}}: []
+
+    remediation_playbook: []
+
+    fastest_win:
+      action: null
+      estimated_gap_score_improvement: null
+      effort: null
+
+    suggested_content_outline: []
+
+  ### FAQ
+
+  - id: faq
+    url: /faq
+    status: planned
+    citation_rate: null
+    gap_score: null
+    top_cited_competitor: null
+
+    why_page_won: []
+    citation_hooks: []
+
+    gaps_for_{{brand_lower_snake}}: []
+
+    remediation_playbook: []
+
+    fastest_win:
+      action: null
+      estimated_gap_score_improvement: null
+      effort: null
+
+    suggested_content_outline: []
+
+  ### Contact
+
+  - id: contact
+    url: /contact
+    status: planned
+    citation_rate: null
+    gap_score: null
+    top_cited_competitor: null
+
+    why_page_won: []
+    citation_hooks: []
+
+    gaps_for_{{brand_lower_snake}}: []
+
+    remediation_playbook: []
+
+    fastest_win:
+      action: null
+      estimated_gap_score_improvement: null
+      effort: null
+
+    suggested_content_outline: []
+
+  ### Service-area
+
+  - id: service-area
+    url: /service-area
+    status: planned
+    citation_rate: null
+    gap_score: null
+    top_cited_competitor: null
+
+    why_page_won: []
+    citation_hooks: []
+
+    gaps_for_{{brand_lower_snake}}: []
+
+    remediation_playbook: []
+
+    fastest_win:
+      action: null
+      estimated_gap_score_improvement: null
+      effort: null
+
+    suggested_content_outline: []
+
+## Competitor Profiles
+### Platform populated — competitor citation patterns
+
+competitors:
+{{reverse_competitors}}