@automatelab/ai-seo-mcp 0.1.0

package/dist/lib/robots.js

@@ -0,0 +1,83 @@
+// robots.txt parser wrapper and AI crawler registry.
+// robots-parser is a CommonJS module; import via createRequire for reliable NodeNext compat.
+import { createRequire } from "module";
+import { fetch as undiciFetch } from "undici";
+import { POLITE_FETCH } from "./config.js";
+import crawlersData from "./crawlers.json" with { type: "json" };
+const _require = createRequire(import.meta.url);
+// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-explicit-any
+const robotsParser = _require("robots-parser");
+export const CRAWLERS = crawlersData;
+/** All crawler user-agents we check (excludes robots_token_only which have no HTTP UA). */
+export function getAllCrawlerAgents() {
+    return [
+        ...CRAWLERS.training,
+        ...CRAWLERS.search,
+        ...CRAWLERS.user_triggered,
+    ];
+}
+/**
+ * Fetch raw robots.txt content. Does NOT use politeFetch to avoid recursion.
+ * Returns empty string if fetch fails.
+ */
+export async function fetchRobotsTxt(robotsUrl) {
+    try {
+        const response = await undiciFetch(robotsUrl, {
+            method: "GET",
+            headers: { "User-Agent": POLITE_FETCH.USER_AGENT },
+            signal: AbortSignal.timeout(POLITE_FETCH.TIMEOUT_MS),
+            redirect: "follow",
+        });
+        const text = await response.text();
+        console.error(`[robots] ${response.status} ${robotsUrl}`);
+        if (response.status === 404)
+            return "";
+        return text;
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Parse robots.txt text and check if a URL is allowed for a given user-agent.
+ * Returns true (allowed) if robots.txt is empty or parse fails.
+ */
+export function checkRobotsAllowed(robotsText, url, userAgent) {
+    if (!robotsText)
+        return true;
+    try {
+        const robots = robotsParser(url, robotsText);
+        const result = robots.isAllowed(url, userAgent);
+        return result !== false;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Check the robots.txt posture for a specific crawler user-agent.
+ * Returns "allowed", "disallowed", or "not-mentioned".
+ */
+export function checkCrawlerStatus(robotsText, robotsUrl, userAgent) {
+    if (!robotsText)
+        return "not-mentioned";
+    try {
+        const robots = robotsParser(robotsUrl, robotsText);
+        // Check if explicitly disallowed
+        const isAllowed = robots.isAllowed("/", userAgent);
+        if (isAllowed === false)
+            return "disallowed";
+        // Check if explicitly mentioned (as opposed to just allowed by default)
+        // robots-parser returns undefined when not mentioned, false when disallowed, true when allowed
+        // We detect "not-mentioned" by checking if the agent appears anywhere in the robots.txt
+        const lowerText = robotsText.toLowerCase();
+        const agentLower = userAgent.toLowerCase();
+        if (!lowerText.includes(agentLower))
+            return "not-mentioned";
+        return "allowed";
+    }
+    catch {
+        return "not-mentioned";
+    }
+}
+//# sourceMappingURL=robots.js.map

package/dist/lib/robots.js.map

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

package/dist/lib/schema-types.json

@@ -0,0 +1,56 @@
+[
+    "Article",
+    "BlogPosting",
+    "NewsArticle",
+    "FAQPage",
+    "Question",
+    "Answer",
+    "HowTo",
+    "HowToStep",
+    "HowToSection",
+    "HowToTool",
+    "HowToSupply",
+    "Organization",
+    "LocalBusiness",
+    "Person",
+    "Product",
+    "Offer",
+    "AggregateOffer",
+    "Review",
+    "AggregateRating",
+    "Rating",
+    "BreadcrumbList",
+    "ListItem",
+    "SoftwareApplication",
+    "WebApplication",
+    "MobileApplication",
+    "WebSite",
+    "WebPage",
+    "ItemPage",
+    "AboutPage",
+    "ContactPage",
+    "SearchResultsPage",
+    "ImageObject",
+    "VideoObject",
+    "AudioObject",
+    "MediaObject",
+    "Event",
+    "CreativeWork",
+    "Book",
+    "Course",
+    "Recipe",
+    "Dataset",
+    "SpeakableSpecification",
+    "SearchAction",
+    "EntryPoint",
+    "PostalAddress",
+    "GeoCoordinates",
+    "OpeningHoursSpecification",
+    "PriceSpecification",
+    "MonetaryAmount",
+    "ContactPoint",
+    "Brand",
+    "Intangible",
+    "Thing",
+    "Place"
+]

package/dist/lib/schema.d.ts

@@ -0,0 +1,20 @@
+import type { Finding } from "../types.js";
+export declare const KNOWN_SCHEMA_TYPES: Set<string>;
+export interface ParsedJsonLd {
+    raw: string;
+    parsed: Record<string, unknown>;
+    types: string[];
+}
+/** Extract @type value(s) as an array of strings. */
+export declare function extractTypes(obj: Record<string, unknown>): string[];
+/** Parse all JSON-LD blocks from HTML. Returns only successfully-parsed blocks. */
+export declare function parseJsonLd(html: string): ParsedJsonLd[];
+/** Extract a flat list of all schema types present. */
+export declare function getAllSchemaTypes(blocks: ParsedJsonLd[]): string[];
+/** Get missing priority schema types. */
+export declare function getMissingPriorityTypes(foundTypes: string[]): string[];
+/** Validate all parsed JSON-LD blocks and emit findings. */
+export declare function validateJsonLd(blocks: ParsedJsonLd[]): Finding[];
+/** Compute ai_citation_readiness_score from schema findings. */
+export declare function computeSchemaScore(findings: Finding[]): number;
+//# sourceMappingURL=schema.d.ts.map

package/dist/lib/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/lib/schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,kBAAkB,aAA2C,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAWD,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAMnE;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAmBxD;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAMlE;AAKD,yCAAyC;AACzC,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAiBtE;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CA8NhE;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAQ9D"}

package/dist/lib/schema.js

@@ -0,0 +1,311 @@
+// JSON-LD extractor and Schema.org validator.
+import { extractJsonLdBlocks } from "./html.js";
+import schemaTypes from "./schema-types.json" with { type: "json" };
+export const KNOWN_SCHEMA_TYPES = new Set(schemaTypes);
+/** Flatten @graph arrays into individual objects. */
+function flattenGraph(obj) {
+    const graph = obj["@graph"];
+    if (Array.isArray(graph)) {
+        return graph;
+    }
+    return [obj];
+}
+/** Extract @type value(s) as an array of strings. */
+export function extractTypes(obj) {
+    const t = obj["@type"];
+    if (!t)
+        return [];
+    if (typeof t === "string")
+        return [t];
+    if (Array.isArray(t))
+        return t.filter((v) => typeof v === "string");
+    return [];
+}
+/** Parse all JSON-LD blocks from HTML. Returns only successfully-parsed blocks. */
+export function parseJsonLd(html) {
+    const blocks = extractJsonLdBlocks(html);
+    const results = [];
+    for (const raw of blocks) {
+        try {
+            const parsed = JSON.parse(raw);
+            const nodes = flattenGraph(parsed);
+            for (const node of nodes) {
+                results.push({
+                    raw,
+                    parsed: node,
+                    types: extractTypes(node),
+                });
+            }
+        }
+        catch {
+            // skip malformed blocks
+        }
+    }
+    return results;
+}
+/** Extract a flat list of all schema types present. */
+export function getAllSchemaTypes(blocks) {
+    const all = new Set();
+    for (const b of blocks) {
+        for (const t of b.types)
+            all.add(t);
+    }
+    return Array.from(all);
+}
+const TIER1_TYPES = ["FAQPage", "HowTo", "Article", "BlogPosting", "NewsArticle", "Organization"];
+const TIER2_TYPES = ["Product", "BreadcrumbList", "SoftwareApplication", "Person", "Review", "AggregateRating"];
+/** Get missing priority schema types. */
+export function getMissingPriorityTypes(foundTypes) {
+    const found = new Set(foundTypes);
+    const hasArticle = found.has("Article") || found.has("BlogPosting") || found.has("NewsArticle");
+    const missing = [];
+    for (const t of TIER1_TYPES) {
+        if (t === "Article" || t === "BlogPosting" || t === "NewsArticle") {
+            if (!hasArticle)
+                missing.push("Article/BlogPosting/NewsArticle");
+            break; // add once
+        }
+        if (!found.has(t))
+            missing.push(t);
+    }
+    // deduplicate
+    const uniqueMissing = Array.from(new Set(missing));
+    for (const t of TIER2_TYPES) {
+        if (!found.has(t))
+            uniqueMissing.push(t);
+    }
+    return uniqueMissing;
+}
+/** Validate all parsed JSON-LD blocks and emit findings. */
+export function validateJsonLd(blocks) {
+    const findings = [];
+    for (const block of blocks) {
+        const obj = block.parsed;
+        // @context must be https
+        const ctx = obj["@context"];
+        if (typeof ctx === "string" && ctx === "http://schema.org") {
+            findings.push({
+                severity: "critical",
+                category: "schema",
+                where: `${block.types.join(",")}.@context`,
+                message: "@context uses http:// - must be https://schema.org.",
+                fix: 'Replace "http://schema.org" with "https://schema.org".',
+                estimated_impact: "medium",
+            });
+        }
+        // Article/BlogPosting/NewsArticle checks
+        if (block.types.some((t) => ["Article", "BlogPosting", "NewsArticle"].includes(t))) {
+            const author = obj["author"];
+            if (author === undefined) {
+                findings.push({
+                    severity: "warning",
+                    category: "schema",
+                    where: `${block.types[0]}.author`,
+                    message: "Article is missing an author property.",
+                    fix: 'Add {"@type":"Person","name":"Author Name","url":"...","sameAs":["..."]}.',
+                    estimated_impact: "high",
+                });
+            }
+            else if (typeof author === "string") {
+                findings.push({
+                    severity: "critical",
+                    category: "schema",
+                    where: `${block.types[0]}.author`,
+                    message: "author is a plain string value, not a Person node.",
+                    fix: 'Replace with {"@type":"Person","name":"' + author + '","url":"https://...","sameAs":["..."]}.',
+                    estimated_impact: "high",
+                });
+            }
+            else if (typeof author === "object" && author !== null) {
+                const authorObj = author;
+                if (!authorObj["sameAs"]) {
+                    findings.push({
+                        severity: "info",
+                        category: "schema",
+                        where: `${block.types[0]}.author.sameAs`,
+                        message: "Person node has no sameAs links, reducing entity verification.",
+                        fix: 'Add sameAs array with LinkedIn, Wikipedia, or official profile URLs.',
+                    });
+                }
+            }
+        }
+        // sameAs must be external absolute URLs
+        const sameAs = obj["sameAs"];
+        if (sameAs) {
+            const saList = Array.isArray(sameAs)
+                ? sameAs
+                : typeof sameAs === "string"
+                    ? [sameAs]
+                    : [];
+            for (const sa of saList) {
+                if (typeof sa !== "string")
+                    continue;
+                if (!sa.startsWith("http")) {
+                    findings.push({
+                        severity: "warning",
+                        category: "schema",
+                        where: `${block.types.join(",")}.sameAs`,
+                        message: `sameAs value "${sa.substring(0, 60)}" is not an absolute URL.`,
+                        fix: "Use absolute, external, dereferenceable URLs for sameAs values.",
+                        estimated_impact: "medium",
+                    });
+                }
+                else {
+                    try {
+                        const parsed = new URL(sa);
+                        // Check if it looks internal (no meaningful hostname)
+                        if (parsed.hostname.length < 4) {
+                            findings.push({
+                                severity: "warning",
+                                category: "schema",
+                                where: `${block.types.join(",")}.sameAs`,
+                                message: `sameAs value "${sa}" may be an internal or invalid URL.`,
+                                fix: "Use external authoritative URLs (Wikipedia, Wikidata, LinkedIn, official brand sites).",
+                                estimated_impact: "medium",
+                            });
+                        }
+                    }
+                    catch {
+                        findings.push({
+                            severity: "warning",
+                            category: "schema",
+                            where: `${block.types.join(",")}.sameAs`,
+                            message: `sameAs value "${sa.substring(0, 60)}" is not a valid URL.`,
+                            fix: "Replace with a valid absolute URL.",
+                            estimated_impact: "medium",
+                        });
+                    }
+                }
+            }
+        }
+        // FAQPage checks
+        if (block.types.includes("FAQPage")) {
+            const mainEntity = obj["mainEntity"];
+            if (!mainEntity) {
+                findings.push({
+                    severity: "warning",
+                    category: "schema",
+                    where: "FAQPage.mainEntity",
+                    message: "FAQPage is missing mainEntity (array of Question nodes).",
+                    fix: 'Add mainEntity: [{"@type":"Question","name":"Q?","acceptedAnswer":{"@type":"Answer","text":"A"}}].',
+                    estimated_impact: "high",
+                });
+            }
+            else if (Array.isArray(mainEntity)) {
+                const questions = mainEntity.map((q) => typeof q["name"] === "string" ? q["name"] : "");
+                const seen = new Set();
+                const duplicates = questions.filter((q) => {
+                    if (seen.has(q))
+                        return true;
+                    seen.add(q);
+                    return false;
+                });
+                if (duplicates.length > 0) {
+                    findings.push({
+                        severity: "critical",
+                        category: "schema",
+                        where: "FAQPage.mainEntity",
+                        message: `FAQPage has ${duplicates.length} duplicate Question.name values.`,
+                        fix: "Ensure each Question has a unique name value.",
+                        estimated_impact: "medium",
+                    });
+                }
+            }
+        }
+        // HowTo checks
+        if (block.types.includes("HowTo")) {
+            const steps = obj["step"];
+            if (!steps || (Array.isArray(steps) && steps.length === 0)) {
+                findings.push({
+                    severity: "warning",
+                    category: "schema",
+                    where: "HowTo.step",
+                    message: "HowTo schema has no step array - provides no AI signal.",
+                    fix: 'Add step: [{"@type":"HowToStep","name":"Step name","text":"Step description"}].',
+                    estimated_impact: "medium",
+                });
+            }
+        }
+        // Review rating checks
+        if (block.types.includes("Review")) {
+            const reviewRating = obj["reviewRating"];
+            if (reviewRating) {
+                const ratingValue = reviewRating["ratingValue"];
+                if (typeof ratingValue === "number") {
+                    findings.push({
+                        severity: "warning",
+                        category: "schema",
+                        where: "Review.reviewRating.ratingValue",
+                        message: "ratingValue is a number - must be a numeric string.",
+                        fix: 'Change ratingValue from a number to a string, e.g. "4.5" instead of 4.5.',
+                        estimated_impact: "low",
+                    });
+                }
+            }
+        }
+        // Organization logo check
+        if (block.types.includes("Organization")) {
+            const logo = obj["logo"];
+            if (!logo) {
+                findings.push({
+                    severity: "warning",
+                    category: "schema",
+                    where: "Organization.logo",
+                    message: "Organization is missing a logo property.",
+                    fix: 'Add logo: {"@type":"ImageObject","url":"https://example.com/logo.png"}.',
+                    estimated_impact: "medium",
+                });
+            }
+            else if (typeof logo === "string") {
+                findings.push({
+                    severity: "warning",
+                    category: "schema",
+                    where: "Organization.logo",
+                    message: "Organization.logo is a string URL, not an ImageObject.",
+                    fix: 'Replace with {"@type":"ImageObject","url":"<logo-url>"}.',
+                    estimated_impact: "low",
+                });
+            }
+        }
+        // Person sameAs check
+        if (block.types.includes("Person")) {
+            if (!obj["sameAs"]) {
+                findings.push({
+                    severity: "info",
+                    category: "schema",
+                    where: "Person.sameAs",
+                    message: "Person node has no sameAs - reduces E-E-A-T verification.",
+                    fix: "Add sameAs links to LinkedIn, Twitter/X, Wikipedia, or other authority profiles.",
+                });
+            }
+        }
+        // Unknown type check
+        for (const t of block.types) {
+            if (!KNOWN_SCHEMA_TYPES.has(t)) {
+                findings.push({
+                    severity: "warning",
+                    category: "schema",
+                    where: "@type",
+                    message: `Unrecognized Schema.org type: "${t}".`,
+                    fix: "Verify the type name at schema.org and correct any typo or deprecated type name.",
+                    estimated_impact: "low",
+                });
+            }
+        }
+    }
+    return findings;
+}
+/** Compute ai_citation_readiness_score from schema findings. */
+export function computeSchemaScore(findings) {
+    let score = 100;
+    for (const f of findings) {
+        if (f.severity === "critical")
+            score -= 20;
+        else if (f.severity === "warning")
+            score -= 8;
+        else
+            score -= 2;
+    }
+    return Math.max(0, score);
+}
+//# sourceMappingURL=schema.js.map

package/dist/lib/schema.js.map

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

package/dist/lib/score.d.ts

@@ -0,0 +1,32 @@
+import type { Finding } from "../types.js";
+export type Grade = "A" | "B" | "C" | "D" | "F";
+/** Derive a letter grade from a 0-100 numeric score. */
+export declare function deriveGrade(score: number): Grade;
+/**
+ * Weighted dimension score for audit_page.
+ * Weights: schema 25%, technical 20%, structure 20%, robots 10%,
+ *          freshness 10%, authority 10%, entity_density 3%, sitemap 2%.
+ */
+export declare function computeWeightedScore(dimensions: {
+    schema: number;
+    technical: number;
+    structure: number;
+    robots: number;
+    freshness: number;
+    authority: number;
+    entity_density: number;
+    sitemap: number;
+}): number;
+/**
+ * Compute a simple score from a findings list.
+ * Starts at 100, deducts per finding severity.
+ * critical: -15, warning: -7, info: -2
+ */
+export declare function scoreFromFindings(findings: Finding[], baseScore?: number, weights?: {
+    critical: number;
+    warning: number;
+    info: number;
+}): number;
+/** Freshness score from a dateModified ISO string. 100 if within 90 days, decays linearly to 0 at 365 days. */
+export declare function freshnessScore(dateModified: string | null): number;
+//# sourceMappingURL=score.d.ts.map

package/dist/lib/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../src/lib/score.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEhD,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAMhD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAWT;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EAAE,EACnB,SAAS,SAAM,EACf,OAAO;;;;CAAwC,GAC9C,MAAM,CAQR;AAED,+GAA+G;AAC/G,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAUlE"}

package/dist/lib/score.js

@@ -0,0 +1,62 @@
+// Grade derivation and dimension weighting formulas.
+/** Derive a letter grade from a 0-100 numeric score. */
+export function deriveGrade(score) {
+    if (score >= 90)
+        return "A";
+    if (score >= 75)
+        return "B";
+    if (score >= 60)
+        return "C";
+    if (score >= 45)
+        return "D";
+    return "F";
+}
+/**
+ * Weighted dimension score for audit_page.
+ * Weights: schema 25%, technical 20%, structure 20%, robots 10%,
+ *          freshness 10%, authority 10%, entity_density 3%, sitemap 2%.
+ */
+export function computeWeightedScore(dimensions) {
+    const score = dimensions.schema * 0.25 +
+        dimensions.technical * 0.2 +
+        dimensions.structure * 0.2 +
+        dimensions.robots * 0.1 +
+        dimensions.freshness * 0.1 +
+        dimensions.authority * 0.1 +
+        dimensions.entity_density * 0.03 +
+        dimensions.sitemap * 0.02;
+    return Math.round(Math.max(0, Math.min(100, score)));
+}
+/**
+ * Compute a simple score from a findings list.
+ * Starts at 100, deducts per finding severity.
+ * critical: -15, warning: -7, info: -2
+ */
+export function scoreFromFindings(findings, baseScore = 100, weights = { critical: 15, warning: 7, info: 2 }) {
+    let score = baseScore;
+    for (const f of findings) {
+        if (f.severity === "critical")
+            score -= weights.critical;
+        else if (f.severity === "warning")
+            score -= weights.warning;
+        else
+            score -= weights.info;
+    }
+    return Math.max(0, Math.min(100, score));
+}
+/** Freshness score from a dateModified ISO string. 100 if within 90 days, decays linearly to 0 at 365 days. */
+export function freshnessScore(dateModified) {
+    if (!dateModified)
+        return 30; // unknown freshness - partial credit
+    const modified = new Date(dateModified).getTime();
+    const now = Date.now();
+    const ageMs = now - modified;
+    const ageDays = ageMs / (1000 * 60 * 60 * 24);
+    if (ageDays <= 90)
+        return 100;
+    if (ageDays >= 365)
+        return 0;
+    // linear decay from 100 at 90 days to 0 at 365 days
+    return Math.round(100 * (1 - (ageDays - 90) / (365 - 90)));
+}
+//# sourceMappingURL=score.js.map

package/dist/lib/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../src/lib/score.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAMrD,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,UASpC;IACC,MAAM,KAAK,GACT,UAAU,CAAC,MAAM,GAAG,IAAI;QACxB,UAAU,CAAC,SAAS,GAAG,GAAG;QAC1B,UAAU,CAAC,SAAS,GAAG,GAAG;QAC1B,UAAU,CAAC,MAAM,GAAG,GAAG;QACvB,UAAU,CAAC,SAAS,GAAG,GAAG;QAC1B,UAAU,CAAC,SAAS,GAAG,GAAG;QAC1B,UAAU,CAAC,cAAc,GAAG,IAAI;QAChC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAmB,EACnB,SAAS,GAAG,GAAG,EACf,OAAO,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;IAE/C,IAAI,KAAK,GAAG,SAAS,CAAC;IACtB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,QAAQ,KAAK,UAAU;YAAE,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;aACpD,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;YAAE,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;;YACvD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,cAAc,CAAC,YAA2B;IACxD,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC,CAAC,qCAAqC;IACnE,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,GAAG,GAAG,QAAQ,CAAC;IAC7B,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,IAAI,OAAO,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC9B,IAAI,OAAO,IAAI,GAAG;QAAE,OAAO,CAAC,CAAC;IAC7B,oDAAoD;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/tools/audit-canonical.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { type HostDelayMap } from "../lib/fetch.js";
+import type { Finding } from "../types.js";
+export declare const auditCanonicalInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    respect_robots: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    respect_robots: boolean;
+}, {
+    url: string;
+    respect_robots?: boolean | undefined;
+}>;
+export type AuditCanonicalInput = z.infer<typeof auditCanonicalInputSchema>;
+export interface CanonicalResult {
+    url: string;
+    final_url: string;
+    canonical_value: string | null;
+    is_self_referential: boolean;
+    is_cross_domain: boolean;
+    trailing_slash_consistent: boolean;
+    canonical_og_url_match: boolean;
+    findings: Finding[];
+}
+export declare function auditCanonical(input: AuditCanonicalInput, hostDelays?: HostDelayMap, robotsCache?: Map<string, string>): Promise<CanonicalResult>;
+//# sourceMappingURL=audit-canonical.d.ts.map

package/dist/tools/audit-canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-canonical.d.ts","sourceRoot":"","sources":["../../src/tools/audit-canonical.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,yBAAyB;;;;;;;;;EAGpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,yBAAyB,EAAE,OAAO,CAAC;IACnC,sBAAsB,EAAE,OAAO,CAAC;IAChC,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,EAC1B,UAAU,CAAC,EAAE,YAAY,EACzB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,eAAe,CAAC,CAqH1B"}