@automatelab/ai-seo-mcp 0.1.0

package/dist/tools/check-technical.js

@@ -0,0 +1,209 @@
+// Tool: check_technical
+// Audits a page's HEAD section for technical signals relevant to AI crawlers.
+import { z } from "zod";
+import { politeFetch, ToolFetchError } from "../lib/fetch.js";
+import { parseHead, levenshtein } from "../lib/html.js";
+export const checkTechnicalInputSchema = z.object({
+    url: z.string().url(),
+    respect_robots: z.boolean().optional().default(true),
+});
+export async function checkTechnical(input, hostDelays, robotsCache) {
+    const result = await politeFetch(input.url, {
+        respectRobots: input.respect_robots,
+        hostDelays,
+        robotsCache,
+    });
+    const ct = result.headers["content-type"];
+    const ctStr = Array.isArray(ct) ? ct[0] : (ct ?? "");
+    if (ctStr && !ctStr.includes("html")) {
+        throw new ToolFetchError({
+            type: "non_html_response",
+            url: input.url,
+            content_type: ctStr,
+        });
+    }
+    const xRobotsTag = result.headers["x-robots-tag"];
+    const head = parseHead(result.body, xRobotsTag);
+    const findings = [];
+    // HTTPS
+    const https = input.url.startsWith("https://");
+    // Canonical
+    let canonicalSelfRef = false;
+    let canonicalCrossDomain = false;
+    if (head.canonical) {
+        try {
+            const pageUrl = new URL(result.finalUrl);
+            const canonUrl = new URL(head.canonical, input.url);
+            canonicalSelfRef =
+                canonUrl.hostname === pageUrl.hostname &&
+                    canonUrl.pathname === pageUrl.pathname;
+            canonicalCrossDomain = canonUrl.hostname !== pageUrl.hostname;
+        }
+        catch {
+            // ignore URL parse errors
+        }
+    }
+    if (!head.canonical) {
+        findings.push({
+            severity: "warning",
+            category: "technical",
+            where: "<head>",
+            message: "No canonical link element found.",
+            fix: 'Add <link rel="canonical" href="https://example.com/page"> to <head>.',
+            estimated_impact: "medium",
+        });
+    }
+    else if (canonicalCrossDomain) {
+        findings.push({
+            severity: "warning",
+            category: "technical",
+            where: 'link[rel="canonical"]',
+            message: "Canonical points to a different domain.",
+            fix: "Verify this is intentional (syndicated content). If not, update to the self-referencing canonical.",
+            estimated_impact: "medium",
+        });
+    }
+    // noindex
+    if (head.noindex) {
+        findings.push({
+            severity: "critical",
+            category: "technical",
+            where: head.noindexHeader ? "X-Robots-Tag header" : 'meta[name="robots"]',
+            message: "Page has noindex directive - no AI search engine can index this page.",
+            fix: "Remove the noindex directive if you want this page to appear in AI search results.",
+            estimated_impact: "high",
+        });
+    }
+    // Redirect finding
+    if (result.redirected && result.finalUrl !== input.url) {
+        findings.push({
+            severity: "info",
+            category: "technical",
+            where: "page-level",
+            message: `Page redirects to ${result.finalUrl} - ensure canonical and OG tags reflect the canonical URL.`,
+            fix: "Update og:url and canonical href to the final redirect target URL.",
+        });
+    }
+    // OG tags
+    if (!head.ogTitle) {
+        findings.push({
+            severity: "warning",
+            category: "technical",
+            where: "og:title",
+            message: "og:title is missing.",
+            fix: 'Add <meta property="og:title" content="Page Title">.',
+            estimated_impact: "medium",
+        });
+    }
+    if (!head.ogDescription) {
+        findings.push({
+            severity: "warning",
+            category: "technical",
+            where: "og:description",
+            message: "og:description is missing.",
+            fix: 'Add <meta property="og:description" content="120-160 character description.">.',
+            estimated_impact: "medium",
+        });
+    }
+    if (!head.ogImage) {
+        findings.push({
+            severity: "warning",
+            category: "technical",
+            where: "og:image",
+            message: "og:image is missing.",
+            fix: 'Add <meta property="og:image" content="https://example.com/image.jpg">.',
+            estimated_impact: "medium",
+        });
+    }
+    // Twitter card
+    if (!head.twitterCard) {
+        findings.push({
+            severity: "info",
+            category: "technical",
+            where: "twitter:card",
+            message: "Twitter Card tags are absent.",
+            fix: 'Add <meta name="twitter:card" content="summary_large_image"> and twitter:title, twitter:description.',
+        });
+    }
+    // Meta description length
+    const metaDescLen = head.metaDescription?.length ?? 0;
+    if (!head.metaDescription) {
+        findings.push({
+            severity: "warning",
+            category: "technical",
+            where: 'meta[name="description"]',
+            message: "Meta description is missing.",
+            fix: 'Add <meta name="description" content="120-160 character description.">.',
+            estimated_impact: "medium",
+        });
+    }
+    else if (metaDescLen < 50) {
+        findings.push({
+            severity: "warning",
+            category: "technical",
+            where: 'meta[name="description"]',
+            message: `Meta description is only ${metaDescLen} chars - too short (ideal: 120-160).`,
+            fix: "Expand the meta description to 120-160 characters summarizing the page content.",
+            estimated_impact: "low",
+        });
+    }
+    else if (metaDescLen > 200) {
+        findings.push({
+            severity: "warning",
+            category: "technical",
+            where: 'meta[name="description"]',
+            message: `Meta description is ${metaDescLen} chars - too long (ideal: 120-160).`,
+            fix: "Trim the meta description to under 200 characters.",
+            estimated_impact: "low",
+        });
+    }
+    // Title/OG match
+    const titleOgMatch = !head.title || !head.ogTitle
+        ? true // can't compare if either is missing
+        : levenshtein(head.title, head.ogTitle) <= 10;
+    if (!titleOgMatch) {
+        findings.push({
+            severity: "warning",
+            category: "technical",
+            where: "og:title vs <title>",
+            message: "og:title differs significantly from <title> - may signal content inconsistency.",
+            fix: "Align og:title with <title> or ensure the difference is intentional.",
+            estimated_impact: "low",
+        });
+    }
+    return {
+        url: input.url,
+        https,
+        canonical: {
+            present: !!head.canonical,
+            value: head.canonical,
+            self_referential: canonicalSelfRef,
+            cross_domain: canonicalCrossDomain,
+        },
+        noindex: head.noindex,
+        noindex_header: head.noindexHeader,
+        og_tags: {
+            title: !!head.ogTitle,
+            description: !!head.ogDescription,
+            image: !!head.ogImage,
+            url: !!head.ogUrl,
+            type: !!head.ogType,
+        },
+        twitter_card: {
+            present: !!head.twitterCard,
+            card_type: head.twitterCard,
+        },
+        hreflang: {
+            present: head.hreflangTags.length > 0,
+            count: head.hreflangTags.length,
+            x_default: head.hreflangTags.some((h) => h.lang === "x-default"),
+        },
+        title_og_match: titleOgMatch,
+        meta_description: {
+            present: !!head.metaDescription,
+            length: metaDescLen,
+        },
+        findings,
+    };
+}
+//# sourceMappingURL=check-technical.js.map

package/dist/tools/check-technical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-technical.js","sourceRoot":"","sources":["../../src/tools/check-technical.ts"],"names":[],"mappings":"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"}

package/dist/tools/extract-entities.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { type HostDelayMap } from "../lib/fetch.js";
+import { type ExtractedEntity } from "../lib/entities.js";
+import type { Finding } from "../types.js";
+export declare const extractEntitiesInputSchema: z.ZodEffects<z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    respect_robots: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    respect_robots: boolean;
+    url?: string | undefined;
+    text?: string | undefined;
+}, {
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    text?: string | undefined;
+}>, {
+    respect_robots: boolean;
+    url?: string | undefined;
+    text?: string | undefined;
+}, {
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    text?: string | undefined;
+}>;
+export type ExtractEntitiesInput = z.infer<typeof extractEntitiesInputSchema>;
+export interface ExtractEntitiesResult {
+    entities: ExtractedEntity[];
+    entity_count: number;
+    connected_entity_count: number;
+    citation_density_score: number;
+    findings: Finding[];
+}
+export declare function extractEntities(input: ExtractEntitiesInput, hostDelays?: HostDelayMap, robotsCache?: Map<string, string>): Promise<ExtractEntitiesResult>;
+//# sourceMappingURL=extract-entities.d.ts.map

package/dist/tools/extract-entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-entities.d.ts","sourceRoot":"","sources":["../../src/tools/extract-entities.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;EAQnC,CAAC;AAEL,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,EAC3B,UAAU,CAAC,EAAE,YAAY,EACzB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,qBAAqB,CAAC,CAsDhC"}

package/dist/tools/extract-entities.js

@@ -0,0 +1,69 @@
+// Tool: extract_entities
+// Extracts named entities, linked concepts, and sameAs graph nodes from page content.
+import { z } from "zod";
+import { politeFetch } from "../lib/fetch.js";
+import { parseBody } from "../lib/html.js";
+import { parseJsonLd } from "../lib/schema.js";
+import { extractJsonLdEntities, extractTextEntities, mergeEntities, } from "../lib/entities.js";
+export const extractEntitiesInputSchema = z
+    .object({
+    url: z.string().url().optional(),
+    text: z.string().optional(),
+    respect_robots: z.boolean().optional().default(true),
+})
+    .refine((d) => d.url !== undefined || d.text !== undefined, {
+    message: "One of url or text is required",
+});
+export async function extractEntities(input, hostDelays, robotsCache) {
+    const findings = [];
+    let bodyText = "";
+    let jsonLdBlocks = [];
+    if (input.url) {
+        const result = await politeFetch(input.url, {
+            respectRobots: input.respect_robots,
+            hostDelays,
+            robotsCache,
+        });
+        const pageData = parseBody(result.body, input.url);
+        bodyText = pageData.bodyText;
+        jsonLdBlocks = parseJsonLd(result.body);
+    }
+    else {
+        bodyText = input.text;
+    }
+    const jsonLdEntities = extractJsonLdEntities(jsonLdBlocks);
+    const textEntities = extractTextEntities(bodyText);
+    const entities = mergeEntities(jsonLdEntities, textEntities, bodyText);
+    const entity_count = entities.length;
+    const connected_entity_count = entities.filter((e) => e.same_as.length > 0).length;
+    // Threshold: 15 connected entities = score of 100
+    const citation_density_score = Math.min(100, Math.round((connected_entity_count / 15) * 100));
+    if (entity_count === 0) {
+        findings.push({
+            severity: "warning",
+            category: "authority",
+            where: "page-level",
+            message: "No named entities detected on this page.",
+            fix: "Add JSON-LD schema with named entities (Organization, Person, Product) and sameAs links.",
+            estimated_impact: "medium",
+        });
+    }
+    else if (connected_entity_count < 5) {
+        findings.push({
+            severity: "warning",
+            category: "authority",
+            where: "page-level",
+            message: `Only ${connected_entity_count} entities have sameAs links. Pages with 15+ connected entities have 4.8x higher AI citation probability.`,
+            fix: "Add sameAs links to JSON-LD entity nodes pointing to Wikidata, Wikipedia, LinkedIn, or official brand sites.",
+            estimated_impact: "high",
+        });
+    }
+    return {
+        entities,
+        entity_count,
+        connected_entity_count,
+        citation_density_score,
+        findings,
+    };
+}
+//# sourceMappingURL=extract-entities.js.map

package/dist/tools/extract-entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-entities.js","sourceRoot":"","sources":["../../src/tools/extract-entities.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,sFAAsF;AAEtF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAqB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,GAEd,MAAM,oBAAoB,CAAC;AAG5B,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACrD,CAAC;KACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE;IAC1D,OAAO,EAAE,gCAAgC;CAC1C,CAAC,CAAC;AAYL,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAA2B,EAC3B,UAAyB,EACzB,WAAiC;IAEjC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,YAAY,GAAmC,EAAE,CAAC;IAEtD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE;YAC1C,aAAa,EAAE,KAAK,CAAC,cAAc;YACnC,UAAU;YACV,WAAW;SACZ,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACnD,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAC7B,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,KAAK,CAAC,IAAK,CAAC;IACzB,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,aAAa,CAAC,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAEvE,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;IACrC,MAAM,sBAAsB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IACnF,kDAAkD;IAClD,MAAM,sBAAsB,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,sBAAsB,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAE9F,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,0CAA0C;YACnD,GAAG,EAAE,0FAA0F;YAC/F,gBAAgB,EAAE,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,sBAAsB,GAAG,CAAC,EAAE,CAAC;QACtC,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,QAAQ,sBAAsB,0GAA0G;YACjJ,GAAG,EAAE,8GAA8G;YACnH,gBAAgB,EAAE,MAAM;SACzB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ;QACR,YAAY;QACZ,sBAAsB;QACtB,sBAAsB;QACtB,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/tools/generate-llms-txt.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { type HostDelayMap } from "../lib/fetch.js";
+import type { Finding } from "../types.js";
+export declare const generateLlmsTxtInputSchema: z.ZodObject<{
+    domain: z.ZodString;
+    max_pages: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    include_full: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    site_name: z.ZodOptional<z.ZodString>;
+    site_description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    domain: string;
+    max_pages: number;
+    include_full: boolean;
+    site_name?: string | undefined;
+    site_description?: string | undefined;
+}, {
+    domain: string;
+    max_pages?: number | undefined;
+    include_full?: boolean | undefined;
+    site_name?: string | undefined;
+    site_description?: string | undefined;
+}>;
+export type GenerateLlmsTxtInput = z.infer<typeof generateLlmsTxtInputSchema>;
+export interface LlmsTxtResult {
+    llms_txt: string;
+    llms_full_txt: string | null;
+    pages_indexed: number;
+    validation_issues: Finding[];
+    suggested_path: "/llms.txt";
+}
+export declare function generateLlmsTxtTool(input: GenerateLlmsTxtInput, hostDelays?: HostDelayMap, robotsCache?: Map<string, string>): Promise<LlmsTxtResult>;
+//# sourceMappingURL=generate-llms-txt.d.ts.map

package/dist/tools/generate-llms-txt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-llms-txt.d.ts","sourceRoot":"","sources":["../../src/tools/generate-llms-txt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAWjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;EAMrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,EAAE,CAAC;IAC7B,cAAc,EAAE,WAAW,CAAC;CAC7B;AAaD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,oBAAoB,EAC3B,UAAU,CAAC,EAAE,YAAY,EACzB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,aAAa,CAAC,CA4IxB"}

package/dist/tools/generate-llms-txt.js

@@ -0,0 +1,157 @@
+// Tool: generate_llms_txt
+// Generates a valid llms.txt (and optionally llms-full.txt) for a domain.
+import { z } from "zod";
+import { politeFetch } from "../lib/fetch.js";
+import { parseHead, parseBody } from "../lib/html.js";
+import { XMLParser } from "fast-xml-parser";
+import { checkSitemap } from "./check-sitemap.js";
+import { groupPagesBySection, generateLlmsTxt as buildLlmsTxt, generateLlmsFullTxt, validateLlmsTxtContent, } from "../lib/llms-txt.js";
+export const generateLlmsTxtInputSchema = z.object({
+    domain: z.string().min(3),
+    max_pages: z.number().int().min(1).max(100).optional().default(30),
+    include_full: z.boolean().optional().default(false),
+    site_name: z.string().optional(),
+    site_description: z.string().optional(),
+});
+function normalizeDomain(domain) {
+    if (domain.startsWith("http://") || domain.startsWith("https://")) {
+        try {
+            return new URL(domain).hostname;
+        }
+        catch {
+            return domain;
+        }
+    }
+    return domain.replace(/\/$/, "");
+}
+export async function generateLlmsTxtTool(input, hostDelays, robotsCache) {
+    const hostname = normalizeDomain(input.domain);
+    const baseUrl = `https://${hostname}`;
+    const validation_issues = [];
+    // Discover pages from sitemap
+    let pageUrls = [];
+    try {
+        const sitemapResult = await checkSitemap({ domain: hostname, max_urls_to_check: input.max_pages }, hostDelays, robotsCache);
+        if (sitemapResult.status === "found" && sitemapResult.sitemap_url) {
+            // Re-fetch the sitemap to get priority-sorted URLs
+            try {
+                const sRes = await politeFetch(sitemapResult.sitemap_url, {
+                    respectRobots: false,
+                    hostDelays,
+                    robotsCache,
+                });
+                const parser = new XMLParser({ ignoreAttributes: false });
+                const parsed = parser.parse(sRes.body);
+                const urlset = parsed["urlset"];
+                if (urlset) {
+                    const urlEntries = urlset["url"];
+                    const urlList = Array.isArray(urlEntries)
+                        ? urlEntries
+                        : urlEntries ? [urlEntries] : [];
+                    pageUrls = urlList
+                        .sort((a, b) => {
+                        const pa = parseFloat(String(a["priority"] ?? "0.5"));
+                        const pb = parseFloat(String(b["priority"] ?? "0.5"));
+                        return pb - pa;
+                    })
+                        .slice(0, input.max_pages)
+                        .map((u) => String(u["loc"] ?? ""))
+                        .filter(Boolean);
+                }
+            }
+            catch {
+                // fall through to root page fallback
+            }
+        }
+    }
+    catch {
+        // sitemap unavailable
+    }
+    // Fallback to root page if no sitemap
+    if (pageUrls.length === 0) {
+        pageUrls = [baseUrl];
+        validation_issues.push({
+            severity: "warning",
+            category: "sitemap",
+            where: `https://${hostname}/sitemap.xml`,
+            message: "No sitemap found - llms.txt generated from root page only.",
+            fix: "Create a sitemap.xml to enable comprehensive llms.txt generation.",
+            estimated_impact: "medium",
+        });
+    }
+    // Fetch each page
+    const pages = [];
+    let siteName = input.site_name ?? hostname;
+    let siteDescription = input.site_description ?? `Content from ${hostname}.`;
+    for (const url of pageUrls) {
+        if (pages.length >= input.max_pages)
+            break;
+        try {
+            const res = await politeFetch(url, {
+                respectRobots: true,
+                hostDelays: hostDelays ?? new Map(),
+                robotsCache,
+            });
+            const head = parseHead(res.body);
+            const body = parseBody(res.body, url);
+            let pathFallback = "";
+            try {
+                pathFallback = new URL(url).pathname.replace(/\//g, " ").trim();
+            }
+            catch {
+                pathFallback = url;
+            }
+            const title = head.ogTitle ?? head.title ?? (pathFallback || url);
+            const description = head.metaDescription ??
+                head.ogDescription ??
+                (body.paragraphs[0] ? body.paragraphs[0].substring(0, 120) : "");
+            // Use site root for name/description if this is the home page
+            if (url === baseUrl || url === `${baseUrl}/`) {
+                if (!input.site_name && head.ogTitle)
+                    siteName = head.ogTitle;
+                if (!input.site_description && head.metaDescription) {
+                    siteDescription = head.metaDescription;
+                }
+            }
+            pages.push({
+                url,
+                title,
+                description,
+                fullText: body.bodyText.substring(0, 5000),
+            });
+        }
+        catch {
+            // skip pages that fail to fetch
+        }
+    }
+    if (pages.length === 0) {
+        pages.push({ url: baseUrl, title: siteName, description: siteDescription });
+    }
+    const groups = groupPagesBySection(pages);
+    const llms_txt = buildLlmsTxt(siteName, siteDescription, groups);
+    let llms_full_txt = null;
+    if (input.include_full) {
+        const { content, truncated } = generateLlmsFullTxt(siteName, siteDescription, pages);
+        llms_full_txt = content;
+        if (truncated) {
+            validation_issues.push({
+                severity: "info",
+                category: "llms_txt",
+                where: "llms-full.txt",
+                message: "llms-full.txt was truncated at 500KB.",
+                fix: "Reduce max_pages or trim per-page body text extraction.",
+            });
+        }
+    }
+    // Validate generated output
+    const structuralIssues = validateLlmsTxtContent(llms_txt);
+    validation_issues.push(...structuralIssues);
+    return {
+        llms_txt,
+        llms_full_txt,
+        pages_indexed: pages.length,
+        validation_issues,
+        suggested_path: "/llms.txt",
+    };
+}
+//# sourceMappingURL=generate-llms-txt.js.map

package/dist/tools/generate-llms-txt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-llms-txt.js","sourceRoot":"","sources":["../../src/tools/generate-llms-txt.ts"],"names":[],"mappings":"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"}

package/dist/tools/rewrite-for-aeo.d.ts

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { type HostDelayMap } from "../lib/fetch.js";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const rewriteForAeoInputSchema: z.ZodEffects<z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    target_query: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<["article", "faq", "howto", "comparison"]>>;
+    max_words: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    respect_robots: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    respect_robots: boolean;
+    target_query: string;
+    format: "article" | "faq" | "howto" | "comparison";
+    max_words: number;
+    url?: string | undefined;
+    text?: string | undefined;
+}, {
+    target_query: string;
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    text?: string | undefined;
+    format?: "article" | "faq" | "howto" | "comparison" | undefined;
+    max_words?: number | undefined;
+}>, {
+    respect_robots: boolean;
+    target_query: string;
+    format: "article" | "faq" | "howto" | "comparison";
+    max_words: number;
+    url?: string | undefined;
+    text?: string | undefined;
+}, {
+    target_query: string;
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    text?: string | undefined;
+    format?: "article" | "faq" | "howto" | "comparison" | undefined;
+    max_words?: number | undefined;
+}>;
+export type RewriteForAeoInput = z.infer<typeof rewriteForAeoInputSchema>;
+export interface RewriteAeoResult {
+    rewritten_text: string;
+    schema_additions: string;
+    changes_made: string[];
+    before_score: number;
+    after_score: number;
+    mode: "sampling" | "prompt_template";
+}
+export declare function rewriteForAeo(input: RewriteForAeoInput, hostDelays?: HostDelayMap, robotsCache?: Map<string, string>, server?: McpServer): Promise<RewriteAeoResult>;
+//# sourceMappingURL=rewrite-for-aeo.d.ts.map

package/dist/tools/rewrite-for-aeo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite-for-aeo.d.ts","sourceRoot":"","sources":["../../src/tools/rewrite-for-aeo.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWjC,CAAC;AAEL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAAC;CACtC;AAkBD,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,EACzB,UAAU,CAAC,EAAE,YAAY,EACzB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAuG3B"}