@rivi-software/agentic-seo-check 0.0.0-stage → 0.1.1

package/dist/core/rules/structured-data.js

@@ -0,0 +1,381 @@
+import { isJsonObject, isString, typesOf } from "../html/structured-data.js";
+import { cap, defineRule, GOOGLE_DOCS } from "./rule.js";
+const G = "https://developers.google.com/search/docs/appearance/structured-data/";
+const ARTICLE = {
+    required: [],
+    recommended: ["headline", "image", "datePublished", "dateModified", "author"],
+    docs: `${G}article`,
+};
+// oxlint-disable-next-line anti-slop/no-known-value-widening -- the table is read with whatever @type a page names, so it needs an index type that lets a lookup miss
+export const SCHEMA_SPECS = {
+    Article: ARTICLE,
+    NewsArticle: ARTICLE,
+    BlogPosting: ARTICLE,
+    TechArticle: ARTICLE,
+    Product: {
+        required: ["name"],
+        recommended: ["image", "description", "brand", "sku", "offers"],
+        oneOf: [["offers", "review", "aggregateRating"]],
+        docs: `${G}product`,
+    },
+    Offer: {
+        required: ["price", "priceCurrency"],
+        recommended: ["availability", "url", "priceValidUntil"],
+        docs: `${G}product`,
+    },
+    AggregateOffer: {
+        required: ["lowPrice", "priceCurrency"],
+        recommended: ["highPrice", "offerCount"],
+        docs: `${G}product`,
+    },
+    Organization: {
+        required: ["name"],
+        recommended: ["url", "logo", "sameAs"],
+        docs: `${G}organization`,
+    },
+    WebSite: {
+        required: ["name", "url"],
+        recommended: [],
+        docs: `${G}sitelinks-searchbox`,
+    },
+    WebPage: { required: [], recommended: ["name"] },
+    BreadcrumbList: {
+        required: ["itemListElement"],
+        recommended: [],
+        docs: `${G}breadcrumb`,
+    },
+    ListItem: {
+        required: ["position"],
+        recommended: ["name", "item"],
+        docs: `${G}breadcrumb`,
+    },
+    ItemList: {
+        required: ["itemListElement"],
+        recommended: [],
+        docs: `${G}carousel`,
+    },
+    FAQPage: { required: ["mainEntity"], recommended: [], docs: `${G}faqpage` },
+    Question: {
+        required: ["name", "acceptedAnswer"],
+        recommended: [],
+        docs: `${G}faqpage`,
+    },
+    Answer: { required: ["text"], recommended: [], docs: `${G}faqpage` },
+    LocalBusiness: {
+        required: ["name", "address"],
+        recommended: [
+            "telephone",
+            "url",
+            "image",
+            "openingHoursSpecification",
+            "priceRange",
+            "geo",
+        ],
+        docs: `${G}local-business`,
+    },
+    Event: {
+        required: ["name", "startDate", "location"],
+        recommended: [
+            "endDate",
+            "description",
+            "image",
+            "offers",
+            "performer",
+            "organizer",
+            "eventStatus",
+            "eventAttendanceMode",
+        ],
+        docs: `${G}event`,
+    },
+    Recipe: {
+        required: ["name", "image"],
+        recommended: [
+            "author",
+            "datePublished",
+            "description",
+            "prepTime",
+            "cookTime",
+            "totalTime",
+            "recipeYield",
+            "recipeIngredient",
+            "recipeInstructions",
+            "aggregateRating",
+        ],
+        docs: `${G}recipe`,
+    },
+    VideoObject: {
+        required: ["name", "thumbnailUrl", "uploadDate"],
+        recommended: ["description", "duration", "contentUrl", "embedUrl"],
+        docs: `${G}video`,
+    },
+    Person: { required: ["name"], recommended: ["url", "sameAs", "jobTitle"] },
+    JobPosting: {
+        required: [
+            "title",
+            "description",
+            "datePosted",
+            "hiringOrganization",
+            "jobLocation",
+        ],
+        recommended: ["validThrough", "employmentType", "baseSalary", "identifier"],
+        docs: `${G}job-posting`,
+    },
+    HowTo: {
+        required: ["name", "step"],
+        recommended: ["image", "totalTime", "estimatedCost", "supply", "tool"],
+        docs: `${G}how-to`,
+    },
+    Review: {
+        required: ["itemReviewed", "reviewRating", "author"],
+        recommended: ["datePublished", "reviewBody"],
+        docs: `${G}review-snippet`,
+    },
+    Rating: {
+        required: ["ratingValue"],
+        recommended: ["bestRating", "worstRating"],
+        docs: `${G}review-snippet`,
+    },
+    AggregateRating: {
+        required: ["ratingValue"],
+        recommended: ["bestRating"],
+        oneOf: [["ratingCount", "reviewCount"]],
+        docs: `${G}review-snippet`,
+    },
+    SoftwareApplication: {
+        required: ["name"],
+        recommended: [
+            "applicationCategory",
+            "operatingSystem",
+            "offers",
+            "aggregateRating",
+        ],
+        oneOf: [["offers", "aggregateRating"]],
+        docs: `${G}software-app`,
+    },
+    Course: {
+        required: ["name", "description", "provider"],
+        recommended: [],
+        docs: `${G}course`,
+    },
+    Dataset: {
+        required: ["name", "description"],
+        recommended: ["url", "creator", "license", "distribution"],
+        docs: `${G}dataset`,
+    },
+    ImageObject: {
+        required: [],
+        recommended: ["contentUrl", "license", "creator"],
+        oneOf: [["contentUrl", "url"]],
+        docs: `${G}image-license-metadata`,
+    },
+    PostalAddress: {
+        required: [],
+        recommended: [
+            "streetAddress",
+            "addressLocality",
+            "postalCode",
+            "addressCountry",
+        ],
+    },
+};
+const DATE_PROPS = new Set([
+    "datePublished",
+    "dateModified",
+    "startDate",
+    "endDate",
+    "uploadDate",
+    "datePosted",
+    "validThrough",
+    "dateCreated",
+    "expires",
+]);
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}(?:[T ]\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})?)?$/u;
+const isPresent = (value) => {
+    if (value === null || value === undefined) {
+        return false;
+    }
+    if (isString(value)) {
+        return value.trim().length > 0;
+    }
+    if (Array.isArray(value)) {
+        return value.length > 0;
+    }
+    return true;
+};
+/** The properties a typed object lacks: required ones (and oneOf groups it fills none of), then recommended ones. */
+const missingProperties = (obj, spec) => {
+    const required = spec.required.filter((p) => !isPresent(obj[p]));
+    for (const group of spec.oneOf ?? []) {
+        if (!group.some((p) => isPresent(obj[p]))) {
+            required.push(`one of: ${group.join(" | ")}`);
+        }
+    }
+    const recommended = spec.recommended.filter((p) => !isPresent(obj[p]));
+    return { required, recommended };
+};
+/** Walk one structured-data item (and nested typed objects) collecting spec violations. */
+export const validateItem = (item) => {
+    const required = [];
+    const recommended = [];
+    const badDates = [];
+    const unknownTypes = [];
+    const visited = new Set();
+    const walk = (node, path, depth) => {
+        if (depth > 6 ||
+            !(Array.isArray(node) || isJsonObject(node)) ||
+            visited.has(node)) {
+            return;
+        }
+        visited.add(node);
+        if (Array.isArray(node)) {
+            for (const [i, n] of node.entries()) {
+                walk(n, `${path}[${i}]`, depth);
+            }
+            return;
+        }
+        for (const type of typesOf(node["@type"])) {
+            const spec = SCHEMA_SPECS[type];
+            if (!spec) {
+                unknownTypes.push(type);
+                continue;
+            }
+            const missing = missingProperties(node, spec);
+            if (missing.required.length) {
+                required.push({ type, missing: missing.required, path });
+            }
+            if (missing.recommended.length) {
+                recommended.push({ type, missing: missing.recommended, path });
+            }
+        }
+        for (const [key, value] of Object.entries(node)) {
+            if (DATE_PROPS.has(key) &&
+                isString(value) &&
+                !ISO_DATE.test(value.trim())) {
+                badDates.push(`${path ? `${path}.` : ""}${key}="${value}"`);
+            }
+            if (Array.isArray(value) || isJsonObject(value)) {
+                walk(value, path ? `${path}.${key}` : key, depth + 1);
+            }
+        }
+    };
+    // SAFETY: extractStructuredData builds every item's data from JSON.parse or from microdata, and both hold JSON values alone.
+    walk(item.data, "", 0);
+    return { required, recommended, badDates, unknownTypes };
+};
+export const structuredDataRules = [
+    defineRule({
+        id: "structured-data.invalid-json",
+        category: "structured-data",
+        severity: "error",
+        description: "A JSON-LD <script> block contains invalid JSON and will be ignored entirely.",
+        recommendation: "Fix the JSON syntax (trailing commas, unescaped quotes, HTML comments inside the script). Serialise with JSON.stringify instead of hand-writing it.",
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => page.structuredDataErrors.map((e) => make(`Invalid JSON-LD: ${e.message}`, {
+        selector: 'script[type="application/ld+json"]',
+        evidence: { snippet: e.snippet },
+    }))),
+    defineRule({
+        id: "structured-data.missing",
+        category: "structured-data",
+        severity: "info",
+        description: "The page has no structured data (JSON-LD or microdata).",
+        recommendation: "Add JSON-LD for the page type (Article, Product, Organization, BreadcrumbList, FAQPage, ...) to qualify for rich results.",
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => page.structuredData.length === 0 && page.structuredDataErrors.length === 0
+        ? make("Page has no structured data.")
+        : null),
+    defineRule({
+        id: "structured-data.missing-context",
+        category: "structured-data",
+        severity: "warning",
+        description: "A JSON-LD item has no @context or a context other than schema.org.",
+        recommendation: 'Set "@context": "https://schema.org" on every top-level JSON-LD object.',
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => {
+        const bad = page.structuredData.filter((i) => i.source === "json-ld" &&
+            !(i.context ?? "").toLowerCase().includes("schema.org"));
+        return bad.length
+            ? make(`${bad.length} JSON-LD item(s) lack a schema.org @context.`, {
+                selector: 'script[type="application/ld+json"]',
+                evidence: {
+                    contexts: cap(bad.map((i) => i.context)),
+                    types: cap(bad.flatMap((i) => i.types)),
+                },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "structured-data.missing-type",
+        category: "structured-data",
+        severity: "warning",
+        description: "A structured data item has no @type (or itemtype).",
+        recommendation: 'Add "@type" (e.g. "Article") to every structured data object.',
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => {
+        const bad = page.structuredData.filter((i) => i.types.length === 0);
+        return bad.length
+            ? make(`${bad.length} structured data item(s) have no @type.`, {
+                evidence: {
+                    sources: cap(bad.map((i) => i.source)),
+                    keys: cap(bad.map((i) => Object.keys(i.data).slice(0, 8))),
+                },
+            })
+            : null;
+    }),
+    defineRule({
+        id: "structured-data.missing-required",
+        category: "structured-data",
+        severity: "warning",
+        description: "A structured data item of a known type is missing properties Google requires for rich results.",
+        recommendation: "Add the missing properties listed in evidence. Validate with https://search.google.com/test/rich-results after fixing.",
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => page.structuredData.flatMap((item) => {
+        const { required } = validateItem(item);
+        return required.map((iss) => make(`${iss.type} is missing required: ${iss.missing.join(", ")}.`, {
+            selector: item.source === "json-ld"
+                ? 'script[type="application/ld+json"]'
+                : `[itemtype*="${iss.type}"]`,
+            evidence: {
+                type: iss.type,
+                missing: iss.missing,
+                path: iss.path || "(root)",
+                source: item.source,
+                docs: SCHEMA_SPECS[iss.type]?.docs,
+            },
+        }));
+    })),
+    defineRule({
+        id: "structured-data.missing-recommended",
+        category: "structured-data",
+        severity: "info",
+        description: "A structured data item is missing properties Google recommends for richer results.",
+        recommendation: "Add the recommended properties where the data exists; they unlock additional rich-result features.",
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => page.structuredData.flatMap((item) => {
+        const { recommended } = validateItem(item);
+        return recommended.map((iss) => make(`${iss.type} is missing recommended: ${iss.missing.join(", ")}.`, {
+            evidence: {
+                type: iss.type,
+                missing: iss.missing,
+                path: iss.path || "(root)",
+                source: item.source,
+            },
+        }));
+    })),
+    defineRule({
+        id: "structured-data.invalid-date",
+        category: "structured-data",
+        severity: "warning",
+        description: "Date properties in structured data that are not ISO 8601.",
+        recommendation: "Use ISO 8601 dates such as 2026-03-14 or 2026-03-14T09:30:00+01:00.",
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => {
+        const bad = page.structuredData.flatMap((i) => validateItem(i).badDates);
+        return bad.length
+            ? make(`${bad.length} structured data date(s) are not ISO 8601.`, {
+                evidence: { examples: cap(bad) },
+            })
+            : null;
+    }),
+];
+//# sourceMappingURL=structured-data.js.map

package/dist/core/rules/structured-data.js.map

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

package/dist/core/rules/title.d.ts

@@ -0,0 +1 @@
+export declare const titleRules: import("./rule.js").Rule[];

package/dist/core/rules/title.js

@@ -0,0 +1,74 @@
+import { isGenericTitle } from "../html/text.js";
+import { defineRule, GOOGLE_DOCS } from "./rule.js";
+export const titleRules = [
+    defineRule({
+        id: "title.missing",
+        category: "title",
+        severity: "error",
+        description: "The page has no <title> element or it is empty.",
+        recommendation: "Add a unique, descriptive <title> in <head> (about 30-60 characters) that states what the page is about.",
+        docs: GOOGLE_DOCS.titles,
+    }, ({ page }, make) => page.title
+        ? null
+        : make("Page has no <title> or the title is empty.", {
+            selector: "head > title",
+        })),
+    defineRule({
+        id: "title.multiple",
+        category: "title",
+        severity: "warning",
+        description: "More than one <title> element is present.",
+        recommendation: "Keep exactly one <title>. Browsers and crawlers may pick different ones when several exist.",
+        docs: GOOGLE_DOCS.titles,
+    }, ({ page }, make) => page.titles.length > 1
+        ? make(`Page has ${page.titles.length} <title> elements.`, {
+            selector: "title",
+            evidence: { titles: page.titles },
+        })
+        : null),
+    defineRule({
+        id: "title.too-long",
+        category: "title",
+        severity: "warning",
+        description: "Title is longer than the configured maximum (default 60 characters) and will be truncated in search results.",
+        recommendation: "Shorten the title to roughly 60 characters or fewer, keeping the most important words first.",
+        docs: GOOGLE_DOCS.titles,
+    }, ({ page, thresholds }, make) => page.title && page.title.length > thresholds.titleMaxChars
+        ? make(`Title is ${page.title.length} characters (max ${thresholds.titleMaxChars}).`, {
+            selector: "head > title",
+            evidence: {
+                title: page.title,
+                length: page.title.length,
+                max: thresholds.titleMaxChars,
+            },
+        })
+        : null),
+    defineRule({
+        id: "title.too-short",
+        category: "title",
+        severity: "info",
+        description: "Title is shorter than the configured minimum (default 30 characters).",
+        recommendation: "Consider a more descriptive title that includes the page topic and, where sensible, the brand.",
+        docs: GOOGLE_DOCS.titles,
+    }, ({ page, thresholds }, make) => page.title && page.title.length < thresholds.titleMinChars
+        ? make(`Title is only ${page.title.length} characters (recommended at least ${thresholds.titleMinChars}).`, {
+            selector: "head > title",
+            evidence: {
+                title: page.title,
+                length: page.title.length,
+                min: thresholds.titleMinChars,
+            },
+        })
+        : null),
+    defineRule({
+        id: "title.generic",
+        category: "title",
+        severity: "warning",
+        description: 'Title is a framework default or placeholder such as "React App", "Create Next App", "Home" or "Untitled".',
+        recommendation: "Replace the placeholder with a title that describes this page. In frameworks, set it per route (metadata export, <Head>, useHead, <svelte:head>, etc.).",
+        docs: GOOGLE_DOCS.titles,
+    }, ({ page }, make) => page.title && isGenericTitle(page.title)
+        ? make(`Title "${page.title}" looks like a placeholder or framework default.`, { selector: "head > title", evidence: { title: page.title } })
+        : null),
+];
+//# sourceMappingURL=title.js.map

package/dist/core/rules/title.js.map

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

package/dist/core/score.d.ts

@@ -0,0 +1,3 @@
+import type { Finding, PageAudit, SeverityCounts } from "./types.js";
+export declare const pageScore: (counts: SeverityCounts) => number;
+export declare const siteScore: (pages: PageAudit[], siteFindings: Finding[]) => number;

package/dist/core/score.js

@@ -0,0 +1,17 @@
+const PAGE_WEIGHTS = { error: 15, warning: 5, info: 1 };
+const SITE_WEIGHTS = { error: 10, warning: 3, info: 0.5 };
+const clamp = (n) => Math.max(0, Math.min(100, n));
+export const pageScore = (counts) => {
+    const deduction = counts.error * PAGE_WEIGHTS.error +
+        counts.warning * PAGE_WEIGHTS.warning +
+        counts.info * PAGE_WEIGHTS.info;
+    return clamp(Math.round(100 - deduction));
+};
+export const siteScore = (pages, siteFindings) => {
+    const avg = pages.length
+        ? pages.reduce((sum, p) => sum + p.score, 0) / pages.length
+        : 100;
+    const deduction = siteFindings.reduce((sum, f) => sum + SITE_WEIGHTS[f.severity], 0);
+    return clamp(Math.round(avg - deduction));
+};
+//# sourceMappingURL=score.js.map

package/dist/core/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../src/core/score.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAW,CAAC;AACjE,MAAM,YAAY,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAW,CAAC;AAEnE,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAsB,EAAU,EAAE;IAC1D,MAAM,SAAS,GACb,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK;QACjC,MAAM,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO;QACrC,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;IAElC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,KAAkB,EAClB,YAAuB,EACf,EAAE;IACV,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM;QACtB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM;QAC3D,CAAC,CAAC,GAAG,CAAC;IAER,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CACnC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,EAC1C,CAAC,CACF,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC;AAC5C,CAAC,CAAC"}

package/dist/core/site-rules.d.ts

@@ -0,0 +1,64 @@
+import type { ExtractedPage, Finding, ResponseInfo, RobotsTxtInfo, RuleMeta, SitemapInfo, Thresholds, CrawlStats } from "./types.js";
+export declare const SITE_RULES: RuleMeta[];
+export interface PageRecord {
+    /** Normalized final URL (or synthetic URL for files). */
+    url: string;
+    requestedUrl: string;
+    page: ExtractedPage;
+    response?: ResponseInfo;
+    depth: number;
+    /** File path for directory audits. */
+    file?: string;
+}
+export interface LinkCheck {
+    url: string;
+    status: number | null;
+    finalUrl: string;
+    redirectChain: {
+        url: string;
+        status: number;
+    }[];
+    error?: string;
+}
+export interface ProbeResults {
+    soft404?: {
+        url: string;
+        status: number | null;
+    } | null;
+    httpRedirect?: {
+        url: string;
+        status: number | null;
+        finalUrl: string | null;
+        redirectsToHttps: boolean;
+    } | null;
+    hostVariant?: {
+        url: string;
+        status: number | null;
+        finalUrl: string | null;
+        redirectsToMain: boolean;
+    } | null;
+}
+export interface SiteContext {
+    startUrl: string;
+    source: "crawl" | "directory";
+    pages: PageRecord[];
+    /** Status of every internal URL that was fetched or probed, keyed by normalized URL. */
+    linkChecks: Map<string, LinkCheck>;
+    /** For every internal target URL, the pages linking to it. */
+    linkSources: Map<string, Set<string>>;
+    robots: RobotsTxtInfo | null;
+    robotsAllows: ((url: string) => boolean) | null;
+    blockedByRobots: string[];
+    sitemaps: SitemapInfo;
+    probes: ProbeResults;
+    crawl: CrawlStats;
+    thresholds: Thresholds;
+    /** Compare URLs by path only (directory audits, where hosts are synthetic). */
+    pathOnly: boolean;
+    /** External link targets that were probed, keyed by URL. */
+    externalChecks?: Map<string, LinkCheck>;
+    externalSources?: Map<string, Set<string>>;
+    /** Directory audits: HTML files nobody links to. */
+    unlinkedPages?: string[];
+}
+export declare const runSiteRules: (ctx: SiteContext) => Finding[];