@automatelab/ai-seo-mcp 0.1.0

package/dist/tools/audit-canonical.js

@@ -0,0 +1,122 @@
+// Tool: audit_canonical
+// Canonical link integrity, trailing-slash hygiene, self-referencing, og:url mismatches.
+import { z } from "zod";
+import { politeFetch } from "../lib/fetch.js";
+import { parseHead } from "../lib/html.js";
+export const auditCanonicalInputSchema = z.object({
+    url: z.string().url(),
+    respect_robots: z.boolean().optional().default(true),
+});
+export async function auditCanonical(input, hostDelays, robotsCache) {
+    const result = await politeFetch(input.url, {
+        respectRobots: input.respect_robots,
+        hostDelays,
+        robotsCache,
+    });
+    const head = parseHead(result.body);
+    const findings = [];
+    const finalUrl = result.finalUrl;
+    let isSelfRef = false;
+    let isCrossDomain = false;
+    let trailingSlashConsistent = true;
+    let canonicalOgUrlMatch = true;
+    if (!head.canonical) {
+        findings.push({
+            severity: "warning",
+            category: "technical",
+            where: '<link rel="canonical">',
+            message: "No canonical link element found.",
+            fix: `Add <link rel="canonical" href="${finalUrl}"> to <head>.`,
+            estimated_impact: "medium",
+        });
+    }
+    else {
+        try {
+            const pageUrl = new URL(finalUrl);
+            const canonUrl = new URL(head.canonical, input.url);
+            isSelfRef =
+                canonUrl.hostname === pageUrl.hostname &&
+                    canonUrl.pathname.replace(/\/$/, "") === pageUrl.pathname.replace(/\/$/, "");
+            isCrossDomain = canonUrl.hostname !== pageUrl.hostname;
+            // Trailing slash consistency
+            const pageHasSlash = pageUrl.pathname.endsWith("/");
+            const canonHasSlash = canonUrl.pathname.endsWith("/");
+            if (pageUrl.pathname !== "/" &&
+                canonUrl.pathname !== "/" &&
+                pageHasSlash !== canonHasSlash) {
+                trailingSlashConsistent = false;
+                findings.push({
+                    severity: "warning",
+                    category: "technical",
+                    where: '<link rel="canonical">',
+                    message: `Trailing slash inconsistency: page "${pageUrl.pathname}" vs canonical "${canonUrl.pathname}".`,
+                    fix: "Ensure canonical href and page URL use the same trailing slash convention. Pick one and redirect all variants.",
+                    estimated_impact: "low",
+                });
+            }
+            if (isCrossDomain) {
+                findings.push({
+                    severity: "warning",
+                    category: "technical",
+                    where: '<link rel="canonical">',
+                    message: `Canonical points to a different domain: ${canonUrl.hostname}.`,
+                    fix: "Verify this is intentional (syndicated content). If not, update to a self-referencing canonical.",
+                    estimated_impact: "medium",
+                });
+            }
+            else if (!isSelfRef) {
+                findings.push({
+                    severity: "warning",
+                    category: "technical",
+                    where: '<link rel="canonical">',
+                    message: "Canonical does not self-reference the current page URL.",
+                    fix: `Update canonical to: <link rel="canonical" href="${finalUrl}">.`,
+                    estimated_impact: "medium",
+                });
+            }
+        }
+        catch {
+            findings.push({
+                severity: "warning",
+                category: "technical",
+                where: '<link rel="canonical">',
+                message: `Canonical value "${head.canonical}" is not a valid URL.`,
+                fix: "Replace with a valid absolute URL.",
+                estimated_impact: "medium",
+            });
+        }
+        // og:url vs canonical mismatch
+        if (head.ogUrl && head.canonical) {
+            try {
+                const canonUrl = new URL(head.canonical, input.url);
+                const ogUrl = new URL(head.ogUrl, input.url);
+                canonicalOgUrlMatch =
+                    canonUrl.hostname === ogUrl.hostname && canonUrl.pathname === ogUrl.pathname;
+                if (!canonicalOgUrlMatch) {
+                    findings.push({
+                        severity: "warning",
+                        category: "technical",
+                        where: "og:url vs canonical",
+                        message: "og:url does not match canonical URL.",
+                        fix: `Set og:url to match the canonical URL: <meta property="og:url" content="${head.canonical}">.`,
+                        estimated_impact: "low",
+                    });
+                }
+            }
+            catch {
+                // ignore URL parse errors
+            }
+        }
+    }
+    return {
+        url: input.url,
+        final_url: finalUrl,
+        canonical_value: head.canonical,
+        is_self_referential: isSelfRef,
+        is_cross_domain: isCrossDomain,
+        trailing_slash_consistent: trailingSlashConsistent,
+        canonical_og_url_match: canonicalOgUrlMatch,
+        findings,
+    };
+}
+//# sourceMappingURL=audit-canonical.js.map

package/dist/tools/audit-canonical.js.map

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

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

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import type { AuditResult } from "../types.js";
+export declare const auditPageInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    include_raw_html: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    respect_robots: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    respect_robots: boolean;
+    include_raw_html: boolean;
+}, {
+    url: string;
+    respect_robots?: boolean | undefined;
+    include_raw_html?: boolean | undefined;
+}>;
+export type AuditPageInput = z.infer<typeof auditPageInputSchema>;
+export interface AuditPageResult extends AuditResult {
+    dimension_scores: {
+        schema: number;
+        robots: number;
+        technical: number;
+        freshness: number;
+        structure: number;
+        authority: number;
+        entity_density: number;
+        sitemap: number;
+    };
+    raw_html?: string;
+}
+export declare function auditPage(input: AuditPageInput): Promise<AuditPageResult>;
+//# sourceMappingURL=audit-page.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit-page.d.ts","sourceRoot":"","sources":["../../src/tools/audit-page.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,gBAAgB,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAsO/E"}

package/dist/tools/audit-page.js

@@ -0,0 +1,221 @@
+// Tool: audit_page
+// Full AI-SEO audit of a single URL. Runs all sub-audits and returns a composite score.
+import { z } from "zod";
+import { politeFetch, ToolFetchError } from "../lib/fetch.js";
+import { parseHead, parseBody } from "../lib/html.js";
+import { parseJsonLd, getAllSchemaTypes } from "../lib/schema.js";
+import { checkTechnical } from "./check-technical.js";
+import { auditSchema } from "./audit-schema.js";
+import { checkRobots } from "./check-robots.js";
+import { checkSitemap } from "./check-sitemap.js";
+import { freshnessScore, deriveGrade, computeWeightedScore } from "../lib/score.js";
+export const auditPageInputSchema = z.object({
+    url: z.string().url(),
+    include_raw_html: z.boolean().optional().default(false),
+    respect_robots: z.boolean().optional().default(true),
+});
+export async function auditPage(input) {
+    const hostDelays = new Map();
+    const robotsCache = new Map();
+    // Fetch URL once
+    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 fetched_at = new Date().toISOString();
+    const allFindings = [];
+    // --- Schema dimension ---
+    let schemaScore = 50;
+    try {
+        const schemaResult = await auditSchema({ url: input.url, respect_robots: input.respect_robots }, hostDelays, robotsCache);
+        schemaScore = schemaResult.ai_citation_readiness_score;
+        allFindings.push(...schemaResult.findings);
+    }
+    catch {
+        // schema audit failed - use default score
+    }
+    // --- Technical dimension ---
+    let technicalScore = 50;
+    try {
+        const techResult = await checkTechnical({ url: input.url, respect_robots: input.respect_robots }, hostDelays, robotsCache);
+        // Derive technical score from findings
+        const techFindings = techResult.findings;
+        allFindings.push(...techFindings);
+        const criticals = techFindings.filter((f) => f.severity === "critical").length;
+        const warnings = techFindings.filter((f) => f.severity === "warning").length;
+        technicalScore = Math.max(0, 100 - criticals * 20 - warnings * 8);
+        // noindex is a killer
+        if (techResult.noindex)
+            technicalScore = Math.max(0, technicalScore - 30);
+    }
+    catch {
+        // technical audit failed
+    }
+    // --- Robots dimension ---
+    let robotsScore = 70;
+    try {
+        const hostname = new URL(input.url).hostname;
+        const robotsResult = await checkRobots({ domain: hostname });
+        const robotsFindings = robotsResult.findings.filter((f) => f.severity === "critical" || f.severity === "warning");
+        allFindings.push(...robotsResult.findings);
+        robotsScore = Math.max(0, 100 -
+            robotsFindings.filter((f) => f.severity === "critical").length * 15 -
+            robotsFindings.filter((f) => f.severity === "warning").length * 7);
+    }
+    catch {
+        // robots check failed
+    }
+    // --- Page content for structure/freshness/authority/entity_density ---
+    const head = parseHead(result.body);
+    const body = parseBody(result.body, input.url);
+    const jsonLdBlocks = parseJsonLd(result.body);
+    const foundTypes = getAllSchemaTypes(jsonLdBlocks);
+    // --- Freshness dimension ---
+    let dateModified = null;
+    for (const b of jsonLdBlocks) {
+        const dm = b.parsed["dateModified"] ?? b.parsed["datePublished"];
+        if (typeof dm === "string") {
+            dateModified = dm;
+            break;
+        }
+    }
+    const freshnessScoreVal = freshnessScore(dateModified);
+    if (freshnessScoreVal < 50) {
+        allFindings.push({
+            severity: "warning",
+            category: "freshness",
+            where: "Article.dateModified",
+            message: dateModified
+                ? "Content appears stale (dateModified > 90 days ago)."
+                : "No dateModified found in structured data.",
+            fix: "Update content and set dateModified to today in Article JSON-LD.",
+            estimated_impact: "medium",
+        });
+    }
+    // --- Structure dimension ---
+    const hasFaq = foundTypes.includes("FAQPage") || body.h3s.some((h) => h.endsWith("?"));
+    const hasHowTo = foundTypes.includes("HowTo");
+    const hasOrderedList = body.orderedLists > 0;
+    const hasTable = body.tables > 0;
+    const goodHeadings = body.h2s.length >= 2;
+    let structureScore = 20;
+    if (hasFaq)
+        structureScore += 30;
+    if (hasHowTo)
+        structureScore += 15;
+    if (hasOrderedList)
+        structureScore += 15;
+    if (hasTable)
+        structureScore += 10;
+    if (goodHeadings)
+        structureScore += 10;
+    structureScore = Math.min(100, structureScore);
+    if (!hasFaq) {
+        allFindings.push({
+            severity: "critical",
+            category: "structure",
+            where: "<body>",
+            message: "No FAQ structure found (no FAQPage schema or H3 question headings).",
+            fix: "Add FAQ H3 headings ending in '?' with answer paragraphs, and a FAQPage JSON-LD block.",
+            estimated_impact: "high",
+        });
+    }
+    // --- Authority dimension ---
+    const hasOrg = foundTypes.includes("Organization");
+    const hasPerson = jsonLdBlocks.some((b) => b.types.includes("Person"));
+    const hasArticleWithAuthorNode = jsonLdBlocks.some((b) => b.types.some((t) => ["Article", "BlogPosting", "NewsArticle"].includes(t)) &&
+        typeof b.parsed["author"] === "object" &&
+        b.parsed["author"] !== null);
+    let authorityScore = 10;
+    if (hasOrg)
+        authorityScore += 30;
+    if (hasPerson || hasArticleWithAuthorNode)
+        authorityScore += 30;
+    const sameAsCount = jsonLdBlocks.reduce((acc, b) => {
+        const sa = b.parsed["sameAs"];
+        return acc + (Array.isArray(sa) ? sa.length : sa ? 1 : 0);
+    }, 0);
+    if (sameAsCount > 0)
+        authorityScore += Math.min(30, sameAsCount * 5);
+    authorityScore = Math.min(100, authorityScore);
+    if (authorityScore < 40) {
+        allFindings.push({
+            severity: "warning",
+            category: "authority",
+            where: "page-level",
+            message: "Low authority signals - missing Organization or author Person schema.",
+            fix: "Add Organization JSON-LD and Article.author as a Person node with sameAs links.",
+            estimated_impact: "high",
+        });
+    }
+    // --- Entity density dimension ---
+    const authoritativeDomains = [
+        "wikipedia.org", "wikidata.org", ".gov", "linkedin.com", "twitter.com",
+        "x.com", "crunchbase.com", "bloomberg.com", "reuters.com",
+    ];
+    const authExternalLinks = body.externalLinks.filter((href) => authoritativeDomains.some((d) => href.includes(d))).length;
+    const entityDensityScore = Math.min(100, (sameAsCount + authExternalLinks) * 7);
+    // --- Sitemap dimension ---
+    let sitemapScore = 50;
+    try {
+        const hostname = new URL(input.url).hostname;
+        const sitemapResult = await checkSitemap({ domain: hostname, max_urls_to_check: 50 }, hostDelays, robotsCache);
+        if (sitemapResult.status === "found") {
+            sitemapScore = 80;
+            if (sitemapResult.urls_with_lastmod / Math.max(1, sitemapResult.total_urls) > 0.8) {
+                sitemapScore = 100;
+            }
+        }
+        else {
+            sitemapScore = 20;
+        }
+    }
+    catch {
+        // sitemap check failed
+    }
+    // --- Weighted composite score ---
+    const dimensionScores = {
+        schema: schemaScore,
+        robots: robotsScore,
+        technical: technicalScore,
+        freshness: freshnessScoreVal,
+        structure: structureScore,
+        authority: authorityScore,
+        entity_density: entityDensityScore,
+        sitemap: sitemapScore,
+    };
+    const score = computeWeightedScore(dimensionScores);
+    const grade = deriveGrade(score);
+    // Deduplicate findings (same message from multiple sub-tools)
+    const seen = new Set();
+    const deduped = allFindings.filter((f) => {
+        const key = `${f.severity}:${f.category}:${f.message}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    const output = {
+        url: input.url,
+        fetched_at,
+        findings: deduped,
+        score,
+        grade,
+        dimension_scores: dimensionScores,
+    };
+    if (input.include_raw_html) {
+        output.raw_html = result.body;
+    }
+    return output;
+}
+//# sourceMappingURL=audit-page.js.map

package/dist/tools/audit-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-page.js","sourceRoot":"","sources":["../../src/tools/audit-page.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,wFAAwF;AAExF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAqB,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAkB,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGpF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACvD,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACrD,CAAC,CAAC;AAkBH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAqB;IACnD,MAAM,UAAU,GAAiB,IAAI,GAAG,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE9C,iBAAiB;IACjB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE;QAC1C,aAAa,EAAE,KAAK,CAAC,cAAc;QACnC,UAAU;QACV,WAAW;KACZ,CAAC,CAAC;IAEH,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,cAAc,CAAC;YACvB,IAAI,EAAE,mBAAmB;YACzB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAc,EAAE,CAAC;IAElC,2BAA2B;IAC3B,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,WAAW,CACpC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,EACxD,UAAU,EACV,WAAW,CACZ,CAAC;QACF,WAAW,GAAG,YAAY,CAAC,2BAA2B,CAAC;QACvD,WAAW,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IAED,8BAA8B;IAC9B,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,cAAc,CACrC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,EACxD,UAAU,EACV,WAAW,CACZ,CAAC;QACF,uCAAuC;QACvC,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC;QACzC,WAAW,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;QAC/E,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QAC7E,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,SAAS,GAAG,EAAE,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC;QAClE,sBAAsB;QACtB,IAAI,UAAU,CAAC,OAAO;YAAE,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,GAAG,EAAE,CAAC,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;IAED,2BAA2B;IAC3B,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QAC7C,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7D,MAAM,cAAc,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,CAC7D,CAAC;QACF,WAAW,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC3C,WAAW,GAAG,IAAI,CAAC,GAAG,CACpB,CAAC,EACD,GAAG;YACD,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,MAAM,GAAG,EAAE;YACnE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CACpE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IAED,wEAAwE;IACxE,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAEnD,8BAA8B;IAC9B,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACjE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3B,YAAY,GAAG,EAAE,CAAC;YAClB,MAAM;QACR,CAAC;IACH,CAAC;IACD,MAAM,iBAAiB,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IACvD,IAAI,iBAAiB,GAAG,EAAE,EAAE,CAAC;QAC3B,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,sBAAsB;YAC7B,OAAO,EAAE,YAAY;gBACnB,CAAC,CAAC,qDAAqD;gBACvD,CAAC,CAAC,2CAA2C;YAC/C,GAAG,EAAE,kEAAkE;YACvE,gBAAgB,EAAE,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACvF,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAC1C,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,MAAM;QAAE,cAAc,IAAI,EAAE,CAAC;IACjC,IAAI,QAAQ;QAAE,cAAc,IAAI,EAAE,CAAC;IACnC,IAAI,cAAc;QAAE,cAAc,IAAI,EAAE,CAAC;IACzC,IAAI,QAAQ;QAAE,cAAc,IAAI,EAAE,CAAC;IACnC,IAAI,YAAY;QAAE,cAAc,IAAI,EAAE,CAAC;IACvC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAE/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,qEAAqE;YAC9E,GAAG,EAAE,wFAAwF;YAC7F,gBAAgB,EAAE,MAAM;SACzB,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvE,MAAM,wBAAwB,GAAG,YAAY,CAAC,IAAI,CAChD,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ;QACtC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,CAC9B,CAAC;IACF,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,MAAM;QAAE,cAAc,IAAI,EAAE,CAAC;IACjC,IAAI,SAAS,IAAI,wBAAwB;QAAE,cAAc,IAAI,EAAE,CAAC;IAChE,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACjD,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC,EAAE,CAAC,CAAC,CAAC;IACN,IAAI,WAAW,GAAG,CAAC;QAAE,cAAc,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;IACrE,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAE/C,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;QACxB,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,uEAAuE;YAChF,GAAG,EAAE,iFAAiF;YACtF,gBAAgB,EAAE,MAAM;SACzB,CAAC,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,MAAM,oBAAoB,GAAG;QAC3B,eAAe,EAAC,cAAc,EAAC,MAAM,EAAC,cAAc,EAAC,aAAa;QAClE,OAAO,EAAC,gBAAgB,EAAC,eAAe,EAAC,aAAa;KACvD,CAAC;IACF,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3D,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CACnD,CAAC,MAAM,CAAC;IACT,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IAEhF,4BAA4B;IAC5B,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QAC7C,MAAM,aAAa,GAAG,MAAM,YAAY,CACtC,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAC3C,UAAU,EACV,WAAW,CACZ,CAAC;QACF,IAAI,aAAa,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YACrC,YAAY,GAAG,EAAE,CAAC;YAClB,IAAI,aAAa,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,GAAG,EAAE,CAAC;gBAClF,YAAY,GAAG,GAAG,CAAC;YACrB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;IAED,mCAAmC;IACnC,MAAM,eAAe,GAAG;QACtB,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,WAAW;QACnB,SAAS,EAAE,cAAc;QACzB,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,cAAc;QACzB,SAAS,EAAE,cAAc;QACzB,cAAc,EAAE,kBAAkB;QAClC,OAAO,EAAE,YAAY;KACtB,CAAC;IAEF,MAAM,KAAK,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAEjC,8DAA8D;IAC9D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACvC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACvD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAoB;QAC9B,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,UAAU;QACV,QAAQ,EAAE,OAAO;QACjB,KAAK;QACL,KAAK;QACL,gBAAgB,EAAE,eAAe;KAClC,CAAC;IAEF,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC3B,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { type HostDelayMap } from "../lib/fetch.js";
+import type { Finding } from "../types.js";
+export declare const auditSchemaInputSchema: z.ZodEffects<z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    schema_json: z.ZodOptional<z.ZodString>;
+    respect_robots: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    respect_robots: boolean;
+    url?: string | undefined;
+    schema_json?: string | undefined;
+}, {
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    schema_json?: string | undefined;
+}>, {
+    respect_robots: boolean;
+    url?: string | undefined;
+    schema_json?: string | undefined;
+}, {
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    schema_json?: string | undefined;
+}>;
+export type AuditSchemaInput = z.infer<typeof auditSchemaInputSchema>;
+export interface AuditSchemaResult {
+    source: "url" | "inline";
+    found_types: string[];
+    missing_priority_types: string[];
+    findings: Finding[];
+    ai_citation_readiness_score: number;
+}
+export declare function auditSchema(input: AuditSchemaInput, hostDelays?: HostDelayMap, robotsCache?: Map<string, string>): Promise<AuditSchemaResult>;
+//# sourceMappingURL=audit-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit-schema.d.ts","sourceRoot":"","sources":["../../src/tools/audit-schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;EAQ/B,CAAC;AAEL,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,EACvB,UAAU,CAAC,EAAE,YAAY,EACzB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAqD5B"}

package/dist/tools/audit-schema.js

@@ -0,0 +1,65 @@
+// Tool: audit_schema
+// Validates JSON-LD structured data against Schema.org rules and AI-citation best practices.
+import { z } from "zod";
+import { politeFetch, ToolFetchError } from "../lib/fetch.js";
+import { parseJsonLd, getAllSchemaTypes, getMissingPriorityTypes, validateJsonLd, computeSchemaScore } from "../lib/schema.js";
+export const auditSchemaInputSchema = z
+    .object({
+    url: z.string().url().optional(),
+    schema_json: z.string().optional(),
+    respect_robots: z.boolean().optional().default(true),
+})
+    .refine((d) => d.url !== undefined || d.schema_json !== undefined, {
+    message: "One of url or schema_json is required",
+});
+export async function auditSchema(input, hostDelays, robotsCache) {
+    let html;
+    let source;
+    if (input.schema_json) {
+        source = "inline";
+        // Wrap inline JSON in minimal HTML
+        html = `<html><head><script type="application/ld+json">${input.schema_json}</script></head></html>`;
+    }
+    else {
+        source = "url";
+        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.includes("html") && !ctStr.includes("xml") && ctStr !== "") {
+            throw new ToolFetchError({
+                type: "non_html_response",
+                url: input.url,
+                content_type: ctStr,
+            });
+        }
+        html = result.body;
+    }
+    const blocks = parseJsonLd(html);
+    const foundTypes = getAllSchemaTypes(blocks);
+    const missingPriorityTypes = getMissingPriorityTypes(foundTypes);
+    const findings = validateJsonLd(blocks);
+    // Add finding for no schema at all
+    if (foundTypes.length === 0 && source === "url") {
+        findings.push({
+            severity: "critical",
+            category: "schema",
+            where: "<head>",
+            message: "No JSON-LD structured data found on this page.",
+            fix: 'Add at least one <script type="application/ld+json"> block. Start with Article or FAQPage.',
+            estimated_impact: "high",
+        });
+    }
+    const ai_citation_readiness_score = computeSchemaScore(findings);
+    return {
+        source,
+        found_types: foundTypes,
+        missing_priority_types: missingPriorityTypes,
+        findings,
+        ai_citation_readiness_score,
+    };
+}
+//# sourceMappingURL=audit-schema.js.map

package/dist/tools/audit-schema.js.map

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

package/dist/tools/check-robots.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { type CrawlerStatus } from "../lib/robots.js";
+import type { Finding } from "../types.js";
+export declare const checkRobotsInputSchema: z.ZodObject<{
+    domain: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    domain: string;
+}, {
+    domain: string;
+}>;
+export type CheckRobotsInput = z.infer<typeof checkRobotsInputSchema>;
+export interface RobotsResult {
+    robots_url: string;
+    fetched_at: string;
+    training_crawlers: Record<string, CrawlerStatus>;
+    search_crawlers: Record<string, CrawlerStatus>;
+    user_triggered: Record<string, CrawlerStatus>;
+    findings: Finding[];
+    recommended_posture: "block_training_allow_search" | "allow_all" | "block_all" | "custom";
+}
+export declare function checkRobots(input: CheckRobotsInput): Promise<RobotsResult>;
+//# sourceMappingURL=check-robots.d.ts.map

package/dist/tools/check-robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-robots.d.ts","sourceRoot":"","sources":["../../src/tools/check-robots.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgD,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACjD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC/C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,mBAAmB,EAAE,6BAA6B,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC3F;AAeD,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CA+IhF"}