@pas7/llm-seo

Deterministic LLM SEO artifacts generator & validator for modern static sites (Next.js/SSG-ready).

Value Proposition

One config in, deterministic artifacts out:

• generate llms.txt and llms-full.txt
• build canonical URLs from manifest items
• support mixed routing per manifest section (prefix, suffix, locale-segment, custom)
• lint policy constraints (restricted claims, duplicates, empty sections)
• check generated files in CI with explicit exit codes

Install

pnpm add @pas7/llm-seo

Quick Start

// llm-seo.config.ts
import type { LlmsSeoConfig } from '@pas7/llm-seo';

export default {
  site: {
    baseUrl: 'https://example.com',
    defaultLocale: 'en',
  },
  brand: {
    name: 'Pas7 Studio',
    tagline: 'Automation and SEO infra for modern products',
    description: 'Deterministic LLM/GEO SEO artifacts for static and hybrid sites.',
    locales: ['en', 'uk'],
  },
  sections: {
    hubs: ['/services', '/blog', '/projects', '/cases', '/contact'],
  },
  manifests: {
    blog: {
      sectionPath: '/blog',
      routeStyle: 'locale-segment',
      items: [
        { slug: '/llm-seo-basics', locales: ['en', 'uk'] },
        { slug: '/canonical-strategy', locales: ['en'] },
      ],
    },
    contactPages: {
      routeStyle: 'suffix',
      items: [{ slug: '/contact', locales: ['en', 'uk'] }],
    },
  },
  contact: {
    email: '[email protected]',
  },
  policy: {
    citationRules: 'Prefer canonical URLs. Avoid query params and tracking tags.',
    restrictedClaims: {
      enable: true,
      forbidden: ['best', '#1', 'guaranteed'],
      whitelist: ['best practices'],
    },
  },
  output: {
    paths: {
      llmsTxt: 'public/llms.txt',
      llmsFullTxt: 'public/llms-full.txt',
      citations: 'public/citations.json',
    },
  },
  format: {
    trailingSlash: 'never',
    lineEndings: 'lf',
    localeStrategy: 'prefix',
  },
} satisfies LlmsSeoConfig;

pnpm llm-seo generate --config llm-seo.config.ts
pnpm llm-seo check --config llm-seo.config.ts --check-live --emit-report .artifacts/llm-seo-report.json --fail-on error
pnpm llm-seo doctor --site https://example.com

CLI

llm-seo generate

llm-seo generate [options]

Options:
  -c, --config <path>   Path to config file
  --dry-run             Print output to stdout, do not write files
  --emit-citations      Emit citations.json
  -v, --verbose         Verbose logs

llm-seo check

llm-seo check [options]

Options:
  -c, --config <path>   Path to config file
  --fail-on <level>     fail threshold: warn|error (default: error)
  --check-live          Live-check machine hint URLs over HTTP
  --timeout-ms <ms>     HTTP timeout per live check request
  --retries <count>     Retry count for failed live checks
  --emit-report <path>  Write JSON report
  -v, --verbose         Verbose logs

llm-seo doctor

llm-seo doctor [options]

Options:
  -s, --site <url>      Site URL to check
  -c, --config <path>   Path to config file
  -v, --verbose         Verbose logs

Exit Codes

• 0 OK
• 1 warnings (only when --fail-on warn)
• 2 errors
• 3 doctor network/availability failure

API (Core)

import {
  createLlmsTxt,
  createLlmsFullTxt,
  createCanonicalUrlsFromManifest,
  createCitationsJson,
  checkGeneratedFiles,
} from '@pas7/llm-seo';

Docs

• docs/format.md
• docs/config.md
• docs/policies.md
• docs/ci.md
• docs/nextjs.md

Next.js

Use helpers from @pas7/llm-seo/adapters/next to normalize manifest items and build scripts. See examples/next-static-export. For hybrid section routing, use:

• createSectionManifest(...)
• fromManifestArray(...)
• fromRouteManifest(...)
• applySectionCanonicalOverrides(...) Works with @pas7/nextjs-sitemap-hreflang in one build pipeline:

llm-seo generate --config llm-seo.config.ts
next build
nextjs-sitemap-hreflang check --fail-on-missing --prefer out
llm-seo check --config llm-seo.config.ts --check-live --emit-report .artifacts/llm-seo-report.json

Hybrid routing example:

• examples/next-static-export-hybrid-routing

Recommended Pipeline

llm-seo generate --config llm-seo.config.ts
next build
nextjs-sitemap-hreflang check --fail-on-missing --prefer out
llm-seo check --config llm-seo.config.ts --check-live --emit-report .artifacts/llm-seo-report.json

JSON Report Contract

--emit-report outputs a stable JSON contract:

• status: ok | warn | error
• issues: normalized check issues
• summary: counts and file stats
• files: output file paths
• canonical: canonical URL summary (total, urls)

Contributing and Security

• CONTRIBUTING.md
• SECURITY.md
• CODE_OF_CONDUCT.md

Support

Need custom SEO automation infra? Contact PAS7 Studio:

• https://pas7.com.ua/
• https://pas7.com.ua/contact

License

MIT