@rivi-software/agentic-seo-check 0.6.0 → 0.7.0

package/dist/mcp-hosted.js

@@ -0,0 +1,347 @@
+import { z } from "zod";
+import { auditAeoHtml, auditAeoSite, auditAeoUrl } from "./core/aeo/audit.js";
+import { auditHtml, auditSite, auditUrl } from "./core/audit.js";
+import { RequestRefusedError } from "./core/fetch.js";
+import { HOSTED_LIMITS, hostedGate, hostedUrlProblem, LOCAL_SERVER, } from "./core/hosted.js";
+import { commonOptions, detail, fail, format, LIST_RULES, listRules, respond, respondAeo, toOptions, } from "./mcp-shared.js";
+const LIMITS = HOSTED_LIMITS;
+/** What every hosted tool says it cannot do, and where to go instead. */
+const HOSTED_NOTE = `This is the hosted server: it requests pages from Cloudflare's network, so it cannot reach localhost, private networks or sites behind a login, cannot read build directories, does not render JavaScript or run Lighthouse, and limits requests per site and per caller. The local server does all of that: \`${LOCAL_SERVER}\`. `;
+const description = (schema) => schema.description ?? "";
+const ruleIds = (base) => z
+    .array(z.string().max(LIMITS.maxRuleIdChars))
+    .max(LIMITS.maxRuleIds)
+    .optional()
+    .describe(description(base));
+/** The local server's common options, capped, without `userAgent` and `headers`. */
+const hostedOptions = {
+    keyword: z
+        .string()
+        .max(LIMITS.maxKeywordChars)
+        .optional()
+        .describe(description(commonOptions.keyword)),
+    includeInfo: commonOptions.includeInfo,
+    disableRules: ruleIds(commonOptions.disableRules),
+    rules: ruleIds(commonOptions.rules),
+    baseline: z
+        .array(z.string().max(LIMITS.maxBaselineIdChars))
+        .max(LIMITS.maxBaselineIds)
+        .optional()
+        .describe(description(commonOptions.baseline)),
+    timeoutMs: z
+        .number()
+        .int()
+        .min(1000)
+        .max(LIMITS.timeoutMs)
+        .optional()
+        .describe(`Per-request timeout in milliseconds (default and most ${LIMITS.timeoutMs}).`),
+    format,
+    detail,
+};
+const url = z.string().url().max(2048);
+const html = z
+    .string()
+    .max(LIMITS.maxHtmlChars)
+    .optional()
+    .describe(`Raw HTML to audit instead of fetching a URL, up to ${LIMITS.maxHtmlChars.toLocaleString("en")} characters.`);
+const patterns = (what) => z
+    .array(z.string().max(LIMITS.maxPatternChars))
+    .max(LIMITS.maxPatterns)
+    .optional()
+    .describe(`${what} (at most ${LIMITS.maxPatterns}, of ${LIMITS.maxPatternChars} characters each).`);
+const crawlLimits = {
+    maxDepth: z
+        .number()
+        .int()
+        .min(0)
+        .max(LIMITS.maxDepth)
+        .default(LIMITS.maxDepth)
+        .describe(`Maximum link depth from the start URL (at most ${LIMITS.maxDepth}).`),
+    concurrency: z
+        .number()
+        .int()
+        .min(1)
+        .max(LIMITS.concurrency)
+        .default(LIMITS.concurrency)
+        .describe(`Parallel requests (at most ${LIMITS.concurrency}).`),
+};
+/** The page count of an answer, for the record of the call. */
+const pagesOf = (audit) => audit.kind === "page" ? 1 : (audit.pages?.length ?? 1);
+/** The host of a URL to audit, once the address rules allow it; throws their answer otherwise. */
+const allowedHost = (target) => {
+    const parsed = new URL(target);
+    const problem = hostedUrlProblem(parsed);
+    if (problem) {
+        throw new Error(problem);
+    }
+    return parsed.hostname;
+};
+/** The answer of a tool's work, or its error as a tool error, and how the call ended. */
+const settle = async (work) => {
+    try {
+        const { result, pages } = await work();
+        return { result, end: { outcome: "ok", pages } };
+    }
+    catch (error) {
+        return {
+            result: fail(error),
+            end: {
+                outcome: error instanceof RequestRefusedError ? "refused" : "error",
+                pages: 0,
+            },
+        };
+    }
+};
+/**
+ * Runs one tool call through the hosted profile: `startCall` may refuse it, every request goes
+ * through the hosted gate, and `end` hears how it went, once the answer is ready.
+ */
+const runCall = async (profile, info, work) => {
+    let call;
+    try {
+        call = await profile.startCall(info);
+    }
+    catch (error) {
+        return fail(error);
+    }
+    const { result, end } = await settle(() => work({
+        userAgent: profile.userAgent,
+        maxBodyBytes: LIMITS.maxBodyBytes,
+        gate: hostedGate(call.gate),
+    }));
+    try {
+        call.end?.(end);
+    }
+    catch {
+        // The record of a call is the server's to keep; failing to keep it never costs the caller
+        // the answer.
+    }
+    return result;
+};
+/** The options of an audit on the hosted server: the caller's, with the hosted fetch. */
+const auditOptions = (input, fetch) => ({
+    ...toOptions(input),
+    fetch: { ...fetch, timeoutMs: input.timeoutMs },
+});
+const registerAuditPage = (server, profile) => {
+    server.registerTool("seo_audit_page", {
+        title: "Audit one page for SEO",
+        description: `Audit a single page and return prioritised, actionable findings (rule id, severity, message, recommendation, CSS selector, evidence) with a \`fix\` for each: the exact edits that resolve it, quoting the code to replace (\`{{…}}\` marks words the author writes). ` +
+            `Checks title, meta description, headings, canonical, robots/noindex, viewport/lang, Open Graph/Twitter cards, images, links, hreflang, structured data (JSON-LD/microdata), content quality and the HTTP response. ` +
+            `Provide either \`url\` (a public http(s) URL) or \`html\` (raw HTML string, e.g. from a template or test render). ${HOSTED_NOTE}Typical workflow: audit, apply the \`fix\` of each error and warning in the source code, then re-check with \`rules\` (the rules you fixed) and \`baseline\` (the finding ids) to confirm they are fixed and nothing new appeared.`,
+        inputSchema: {
+            url: url
+                .optional()
+                .describe("Absolute http(s) URL to fetch and audit."),
+            html,
+            baseUrl: z
+                .string()
+                .url()
+                .optional()
+                .describe("With `html`: the URL the HTML would be served at (used to resolve links and classify them as internal/external)."),
+            ...hostedOptions,
+        },
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, (input) => {
+        const { html: source, url: target } = input;
+        // `html` wins over `url`; an empty `html` counts only when a `url` came with it.
+        const inline = source !== undefined && Boolean(source || target);
+        if (!inline && !target) {
+            return fail(new Error("Provide `url` or `html`."));
+        }
+        let host = null;
+        try {
+            host = inline || !target ? null : allowedHost(target);
+        }
+        catch (error) {
+            return fail(error);
+        }
+        return runCall(profile, { tool: "seo_audit_page", fetches: !inline, crawl: false, host }, async (fetch) => {
+            const options = {
+                ...auditOptions(input, fetch),
+                baseUrl: input.baseUrl,
+            };
+            const audit = inline || !target
+                ? await auditHtml(source ?? "", { url: input.baseUrl, source: "html", target: "inline-html" }, options)
+                : await auditUrl(target, options);
+            return {
+                result: respond(audit, input.format, input.detail),
+                pages: 1,
+            };
+        });
+    });
+};
+const registerCrawlSite = (server, profile) => {
+    server.registerTool("seo_crawl_site", {
+        title: "Crawl a site and audit every page",
+        description: `Crawl internal links from a start URL (at most ${LIMITS.maxPages} pages, depth ${LIMITS.maxDepth}), audit every HTML page, and run site-wide checks: robots.txt, XML sitemap coverage (missing/noindex/non-canonical/broken URLs), broken internal links with their sources, redirect chains, duplicate titles/descriptions/H1s/content, orphan and deep pages, soft-404 behaviour, http→https and www redirects, hreflang return links. ` +
+            `Returns site findings plus \`issues\` (page findings rolled up by rule with example URLs) and per-page scores. Use seo_audit_page on a specific URL for full per-page detail. ` +
+            `The crawl obeys robots.txt (a group for agentic-seo-check included), checks at most ${LIMITS.maxLinkChecks} link targets and reads at most ${LIMITS.maxSitemaps} sitemaps. ${HOSTED_NOTE}`,
+        inputSchema: {
+            url: url.describe("Start URL (usually the homepage)."),
+            maxPages: z
+                .number()
+                .int()
+                .min(1)
+                .max(LIMITS.maxPages)
+                .default(LIMITS.maxPages)
+                .describe(`Maximum pages to fetch (at most ${LIMITS.maxPages}).`),
+            ...crawlLimits,
+            delayMs: z
+                .number()
+                .int()
+                .min(0)
+                .max(5000)
+                .default(0)
+                .describe("Delay between requests per worker (politeness)."),
+            includeSubdomains: z
+                .boolean()
+                .default(false)
+                .describe("Treat subdomains of the start host as internal."),
+            checkExternalLinks: z
+                .boolean()
+                .default(false)
+                .describe(`Also probe external link targets for 4xx/5xx (at most ${LIMITS.maxLinkChecks}; slower).`),
+            includePatterns: patterns("Only crawl URLs matching one of these regular expressions"),
+            excludePatterns: patterns("Skip URLs matching any of these regular expressions"),
+            pageDetail: z
+                .enum(["summary", "full"])
+                .default("summary")
+                .describe("summary: per-page scores/counts only (findings are rolled up in `issues`); full: every finding on every page."),
+            ...hostedOptions,
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, (input) => {
+        let host;
+        try {
+            host = allowedHost(input.url);
+        }
+        catch (error) {
+            return fail(error);
+        }
+        return runCall(profile, { tool: "seo_crawl_site", fetches: true, crawl: true, host }, async (fetch) => {
+            const audit = await auditSite(input.url, {
+                ...auditOptions(input, fetch),
+                maxPages: input.maxPages,
+                maxDepth: input.maxDepth,
+                concurrency: input.concurrency,
+                delayMs: input.delayMs,
+                respectRobots: true,
+                includeSubdomains: input.includeSubdomains,
+                checkExternalLinks: input.checkExternalLinks,
+                maxLinkChecks: LIMITS.maxLinkChecks,
+                includePatterns: input.includePatterns,
+                excludePatterns: input.excludePatterns,
+                pageDetail: input.pageDetail,
+                maxSitemaps: LIMITS.maxSitemaps,
+                maxSitemapBytes: LIMITS.maxSitemapBytes,
+            });
+            return {
+                result: respond(audit, input.format, input.detail),
+                pages: pagesOf(audit),
+            };
+        });
+    });
+};
+const registerAeoAudit = (server, profile) => {
+    server.registerTool("seo_aeo_audit", {
+        title: "Audit a page or site for answer engines (AEO)",
+        description: `Answer engine optimization audit: can AI answer engines (ChatGPT search, Claude, Perplexity, Google AI Overviews and AI Mode, Copilot, Gemini) reach, quote and trust the content? ` +
+            `Checks robots.txt for each AI crawler (search crawlers, answer bots, training bots), Content-Signal lines and the shared \`__usage_ai-training\` opt-out, /llms.txt, nosnippet/max-snippet/data-nosnippet, Bing's noarchive/nocache for Copilot, noai, content that needs JavaScript, question headings without a direct answer, FAQPage/HowTo markup that the page does not show, article author and dates, and Organization/Person entities with sameAs. ` +
+            `Returns its own AEO score, a per-bot \`crawlers\` table and findings with rule ids (aeo.*). ` +
+            `Provide one of \`url\` (one page, or a site with \`crawl: true\`) or \`html\`. ${HOSTED_NOTE}The local server can also request the page with each AI bot's User-Agent (\`aiBots\`).`,
+        inputSchema: {
+            url: url
+                .optional()
+                .describe("Absolute http(s) URL to audit (the start URL with `crawl`)."),
+            html: z
+                .string()
+                .max(LIMITS.maxHtmlChars)
+                .optional()
+                .describe(`Raw HTML to audit instead of fetching a URL, up to ${LIMITS.maxHtmlChars.toLocaleString("en")} characters. Page checks only: there is no site to read robots.txt or llms.txt from.`),
+            baseUrl: z
+                .string()
+                .url()
+                .optional()
+                .describe("With `html`: the origin the HTML is served from (default http://localhost/)."),
+            crawl: z
+                .boolean()
+                .default(false)
+                .describe("With `url`: crawl internal links and audit every page."),
+            maxPages: z
+                .number()
+                .int()
+                .min(1)
+                .max(LIMITS.maxPages)
+                .default(LIMITS.maxPages)
+                .describe(`Crawl: maximum pages to audit (at most ${LIMITS.maxPages}).`),
+            ...crawlLimits,
+            includeSubdomains: z
+                .boolean()
+                .default(false)
+                .describe("Crawl: treat subdomains of the start host as internal."),
+            pageDetail: z
+                .enum(["summary", "full"])
+                .default("summary")
+                .describe("Crawl: summary keeps page findings rolled up in `issues`; full lists every page finding in `findings`."),
+            includeInfo: hostedOptions.includeInfo,
+            disableRules: hostedOptions.disableRules,
+            rules: hostedOptions.rules,
+            baseline: hostedOptions.baseline,
+            timeoutMs: hostedOptions.timeoutMs,
+            format,
+            detail,
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, (input) => {
+        if ((input.url === undefined) === (input.html === undefined)) {
+            return fail(new Error("Provide exactly one of `url` or `html`."));
+        }
+        let host = null;
+        try {
+            host = input.url === undefined ? null : allowedHost(input.url);
+        }
+        catch (error) {
+            return fail(error);
+        }
+        const crawl = input.url !== undefined && input.crawl;
+        return runCall(profile, { tool: "seo_aeo_audit", fetches: host !== null, crawl, host }, async (fetch) => {
+            const options = {
+                ...auditOptions(input, fetch),
+                baseUrl: input.baseUrl,
+                maxPages: input.maxPages,
+                maxDepth: input.maxDepth,
+                concurrency: input.concurrency,
+                respectRobots: true,
+                includeSubdomains: input.includeSubdomains,
+                pageDetail: input.pageDetail,
+            };
+            let audit;
+            if (input.url === undefined) {
+                audit = await auditAeoHtml(input.html ?? "", { url: input.baseUrl, target: "inline-html" }, options);
+            }
+            else if (crawl) {
+                audit = await auditAeoSite(input.url, options);
+            }
+            else {
+                audit = await auditAeoUrl(input.url, options);
+            }
+            return {
+                result: respondAeo(audit, input.format, input.detail),
+                pages: pagesOf(audit),
+            };
+        });
+    });
+};
+/** The hosted server's tools: as the local server's, less what needs the user's machine. */
+export const registerHostedTools = (server, profile) => {
+    registerAuditPage(server, profile);
+    registerCrawlSite(server, profile);
+    registerAeoAudit(server, profile);
+    server.registerTool("seo_list_rules", LIST_RULES, (input) => runCall(profile, { tool: "seo_list_rules", fetches: false, crawl: false, host: null }, () => ({ result: listRules(input), pages: 0 })));
+};
+//# sourceMappingURL=mcp-hosted.js.map

package/dist/mcp-hosted.js.map

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

package/dist/mcp-shared.d.ts

@@ -0,0 +1,135 @@
+/** What the local MCP server (mcp.ts) and the hosted one (mcp-hosted.ts) share: options and answers. */
+import { z } from "zod";
+import type { CrawlOptions } from "./core/audit.js";
+import type { AeoAudit, Audit } from "./core/types.js";
+export declare const format: z.ZodDefault<z.ZodEnum<{
+    json: "json";
+    markdown: "markdown";
+}>>;
+export declare const detail: z.ZodDefault<z.ZodEnum<{
+    compact: "compact";
+    full: "full";
+}>>;
+export declare const commonOptions: {
+    keyword: z.ZodOptional<z.ZodString>;
+    includeInfo: z.ZodDefault<z.ZodBoolean>;
+    disableRules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    baseline: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    userAgent: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    format: z.ZodDefault<z.ZodEnum<{
+        json: "json";
+        markdown: "markdown";
+    }>>;
+    detail: z.ZodDefault<z.ZodEnum<{
+        compact: "compact";
+        full: "full";
+    }>>;
+};
+export declare const toOptions: (input: {
+    keyword?: string;
+    includeInfo?: boolean;
+    disableRules?: string[];
+    rules?: string[];
+    baseline?: string[];
+    timeoutMs?: number;
+    userAgent?: string;
+    headers?: Record<string, string>;
+}) => CrawlOptions;
+export declare const respond: (audit: Audit, fmt: "json" | "markdown", det: "full" | "compact") => {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        schemaVersion: 1;
+        kind: "page";
+        target: string;
+        url: string;
+        source: import("./core/types.js").PageSource;
+        auditedAt: string;
+        response?: import("./core/types.js").ResponseInfo;
+        summary: import("./core/types.js").PageSummary;
+        baseline?: import("./core/types.js").BaselineComparison;
+        findings: import("./core/types.js").Finding[];
+        counts: import("./core/types.js").SeverityCounts;
+        score: number;
+        performance?: import("./core/types.js").PerformanceResult;
+        rendering?: import("./core/types.js").RenderComparison;
+        depth?: number;
+    } | {
+        schemaVersion: 1;
+        kind: "site";
+        target: string;
+        source: "crawl" | "directory";
+        auditedAt: string;
+        crawl: import("./core/types.js").CrawlStats;
+        robotsTxt: import("./core/types.js").RobotsTxtInfo | null;
+        sitemaps: import("./core/types.js").SitemapInfo;
+        pages: import("./core/types.js").PageAudit[];
+        baseline?: import("./core/types.js").BaselineComparison;
+        siteFindings: import("./core/types.js").Finding[];
+        issues: import("./core/types.js").IssueRollup[];
+        counts: import("./core/types.js").SeverityCounts;
+        score: number;
+    };
+};
+export declare const respondAeo: (audit: AeoAudit, fmt: "json" | "markdown", det: "full" | "compact") => {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        schemaVersion: 1;
+        kind: "aeo";
+        target: string;
+        url: string;
+        source: import("./core/types.js").PageSource | "crawl" | "directory";
+        score: number;
+        counts: import("./core/types.js").SeverityCounts;
+        auditedAt: string;
+        summary: import("./core/types.js").AeoSummary;
+        baseline?: import("./core/types.js").BaselineComparison;
+        findings: import("./core/types.js").Finding[];
+        crawlers: import("./core/types.js").AiCrawlerReport | null;
+        llmsTxt: import("./core/types.js").LlmsTxtInfo | null;
+        pages?: import("./core/types.js").AeoPage[];
+        issues?: import("./core/types.js").IssueRollup[];
+    };
+};
+/** seo_list_rules: the same tool on both servers. */
+export declare const LIST_RULES: {
+    title: string;
+    description: string;
+    inputSchema: {
+        category: z.ZodOptional<z.ZodString>;
+        rule: z.ZodOptional<z.ZodString>;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint: boolean;
+    };
+};
+export declare const listRules: (input: {
+    category?: string;
+    rule?: string;
+}) => {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        count: number;
+        rules: import("./core/types.js").RuleMeta[];
+    };
+};
+export declare const fail: (error: unknown) => {
+    isError: boolean;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};

package/dist/mcp-shared.js

@@ -0,0 +1,122 @@
+/** What the local MCP server (mcp.ts) and the hosted one (mcp-hosted.ts) share: options and answers. */
+import { z } from "zod";
+import { compactAeoAudit } from "./core/aeo/audit.js";
+import { compactAudit } from "./core/audit.js";
+import { baselineFromIds } from "./core/recheck.js";
+import { renderAeoMarkdown, renderMarkdown } from "./core/report/markdown.js";
+import { ALL_RULES } from "./core/rules/index.js";
+export const format = z
+    .enum(["json", "markdown"])
+    .default("json")
+    .describe("json (default) returns the structured audit; markdown returns a human-readable report.");
+export const detail = z
+    .enum(["full", "compact"])
+    .default("compact")
+    .describe("compact trims evidence lists and bulky fields to save tokens (default); full returns everything.");
+export const commonOptions = {
+    keyword: z
+        .string()
+        .optional()
+        .describe("Target keyword/phrase. Enables keyword.* checks (title, H1, body, description, URL, density)."),
+    includeInfo: z
+        .boolean()
+        .default(true)
+        .describe("Include info-level findings (best practices). Set false to see only errors and warnings."),
+    disableRules: z
+        .array(z.string())
+        .optional()
+        .describe('Rule ids to skip, e.g. ["twitter.card-missing"]. Use seo_list_rules to see ids.'),
+    rules: z
+        .array(z.string())
+        .optional()
+        .describe('Run only these rule ids, e.g. ["img.alt-missing"] to re-check the findings a fix was for. Use with `baseline`.'),
+    baseline: z
+        .array(z.string())
+        .optional()
+        .describe("The `id` of every finding of the earlier audit. The result then has `baseline`: the ids since fixed, still open and new (a new one may be a problem a fix caused). Re-check with the same options; for a crawl or directory, run both audits with pageDetail full so page findings have ids."),
+    timeoutMs: z
+        .number()
+        .int()
+        .min(1000)
+        .max(120_000)
+        .optional()
+        .describe("Per-request timeout in milliseconds (default 15000)."),
+    userAgent: z.string().optional().describe("Override the User-Agent header."),
+    headers: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe('Extra request headers, e.g. {"Authorization": "Basic ..."} for staging sites.'),
+    format,
+    detail,
+};
+export const toOptions = (input) => ({
+    keyword: input.keyword,
+    includeInfo: input.includeInfo,
+    disableRules: input.disableRules,
+    onlyRules: input.rules,
+    baseline: input.baseline ? baselineFromIds(input.baseline) : undefined,
+    fetch: {
+        timeoutMs: input.timeoutMs,
+        userAgent: input.userAgent,
+        headers: input.headers,
+    },
+});
+export const respond = (audit, fmt, det) => {
+    const report = det === "compact" ? compactAudit(audit) : audit;
+    const text = fmt === "markdown"
+        ? renderMarkdown(report)
+        : JSON.stringify(report, null, 2);
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: { ...report },
+    };
+};
+export const respondAeo = (audit, fmt, det) => {
+    const report = det === "compact" ? compactAeoAudit(audit) : audit;
+    const text = fmt === "markdown"
+        ? renderAeoMarkdown(report)
+        : JSON.stringify(report, null, 2);
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: { ...report },
+    };
+};
+/** seo_list_rules: the same tool on both servers. */
+export const LIST_RULES = {
+    title: "List SEO rules",
+    description: "List every rule this tool can report, with id, category, typical severity, what it checks and the generic fix. Filter by category or look up one rule id to understand a finding.",
+    inputSchema: {
+        category: z
+            .string()
+            .optional()
+            .describe("Filter by category (title, meta, headings, canonical, indexing, document, social, images, links, international, structured-data, content, keyword, response, rendering, performance, site, aeo)."),
+        rule: z.string().optional().describe("Return only this rule id."),
+    },
+    annotations: {
+        readOnlyHint: true,
+        openWorldHint: false,
+        idempotentHint: true,
+    },
+};
+export const listRules = (input) => {
+    const rules = ALL_RULES.filter((r) => (!input.category || r.category === input.category) &&
+        (!input.rule || r.id === input.rule));
+    const payload = { count: rules.length, rules };
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(payload, null, 2) },
+        ],
+        structuredContent: payload,
+    };
+};
+// oxlint-disable-next-line anti-slop/no-unknown-parameters -- a thrown value is unknown until this reads it
+export const fail = (error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        isError: true,
+        content: [
+            { type: "text", text: `agentic-seo-check error: ${message}` },
+        ],
+    };
+};
+//# sourceMappingURL=mcp-shared.js.map

package/dist/mcp-shared.js.map

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

package/dist/mcp.d.ts

@@ -1,5 +1,14 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { HostedProfile } from "./mcp-hosted.js";
+export type { HostedCall, HostedCallEnd, HostedCallInfo, HostedProfile, } from "./mcp-hosted.js";
 export declare const MCP_SERVER_NAME = "agentic-seo-check";
 export declare const MCP_SERVER_VERSION: string;
-export declare const createMcpServer: () => McpServer;
+export interface McpServerOptions {
+    /**
+     * Serve the hosted server's tools (hosted/, a Cloudflare Worker) instead of the local server's:
+     * no files on disk, rendering or Lighthouse, inputs capped, and every request through the gate.
+     */
+    hosted?: HostedProfile;
+}
+export declare const createMcpServer: (serverOptions?: McpServerOptions) => McpServer;
 export declare const startMcpServer: () => Promise<void>;