@automatelab/ai-seo-mcp 0.3.0 → 0.4.1

package/dist/tools/extract-entities.js

@@ -1,5 +1,6 @@
 // Tool: extract_entities
 // Extracts named entities, linked concepts, and sameAs graph nodes from page content.
+// Primary path: MCP sampling (host LLM does NER). Fallback: regex heuristic.
 import { z } from "zod";
 import { politeFetch } from "../lib/fetch.js";
 import { parseBody } from "../lib/html.js";
@@ -10,30 +11,135 @@ export const extractEntitiesInputSchema = z
     url: z.string().url().optional(),
     text: z.string().optional(),
     respect_robots: z.boolean().optional().default(true),
+    render: z.enum(["static", "headless"]).optional().default("static"),
 })
     .refine((d) => d.url !== undefined || d.text !== undefined, {
     message: "One of url or text is required",
 });
-export async function extractEntities(input, hostDelays, robotsCache) {
+const SAMPLING_SYSTEM_PROMPT = `You are an entity extractor for AI-citation optimization. Identify named entities (organizations, people, products, technologies, locations) in the provided content.
+
+For each entity:
+- "name": the canonical entity name as it appears
+- "type": one of "Organization", "Person", "Product", "Technology", "Location", "Event", "Other"
+- "same_as": array of URLs found in the page that authoritatively identify this entity (Wikipedia, Wikidata, LinkedIn, official brand site, etc.). Empty array if none found in the provided URL list.
+
+Skip generic terms, common words, and section headings. Cap at ~50 entities.
+
+Return JSON only, no prose. Shape: { "entities": [{ "name": "...", "type": "...", "same_as": ["..."] }] }`;
+async function trySampling(bodyText, externalLinks, server) {
+    const userMessage = `Page content (first 8000 chars):
+---
+${bodyText.substring(0, 8000)}
+---
+
+External links found on the page (use these to populate same_as where they authoritatively identify an entity):
+${externalLinks.slice(0, 40).map((l) => `- ${l}`).join("\n") || "(none)"}
+
+Extract entities and return JSON.`;
+    try {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore - sampling API availability varies by client; not typed in all SDK versions
+        const samplingResult = await server.server.request({
+            method: "sampling/createMessage",
+            params: {
+                messages: [{ role: "user", content: { type: "text", text: userMessage } }],
+                systemPrompt: SAMPLING_SYSTEM_PROMPT,
+                maxTokens: 2048,
+            },
+        }, 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        {});
+        const text = samplingResult?.content?.text ?? samplingResult?.content?.[0]?.text ?? "";
+        if (!text)
+            return null;
+        const jsonMatch = text.match(/```json\n([\s\S]+?)\n```/) ?? text.match(/\{[\s\S]+\}/);
+        const jsonStr = jsonMatch ? (jsonMatch[1] ?? jsonMatch[0]) : text;
+        const parsed = JSON.parse(jsonStr);
+        if (!parsed.entities || !Array.isArray(parsed.entities))
+            return null;
+        return parsed.entities;
+    }
+    catch {
+        return null;
+    }
+}
+function countOccurrences(text, term) {
+    if (!term)
+        return 0;
+    const lower = text.toLowerCase();
+    const termLower = term.toLowerCase();
+    let count = 0;
+    let idx = 0;
+    while ((idx = lower.indexOf(termLower, idx)) !== -1) {
+        count++;
+        idx += termLower.length;
+    }
+    return count;
+}
+export async function extractEntities(input, hostDelays, robotsCache, server) {
     const findings = [];
     let bodyText = "";
     let jsonLdBlocks = [];
+    let externalLinks = [];
     if (input.url) {
         const result = await politeFetch(input.url, {
             respectRobots: input.respect_robots,
             hostDelays,
             robotsCache,
+            renderMode: input.render,
         });
         const pageData = parseBody(result.body, input.url);
         bodyText = pageData.bodyText;
+        externalLinks = pageData.externalLinks ?? [];
         jsonLdBlocks = parseJsonLd(result.body);
     }
     else {
         bodyText = input.text;
     }
     const jsonLdEntities = extractJsonLdEntities(jsonLdBlocks);
-    const textEntities = extractTextEntities(bodyText);
-    const entities = mergeEntities(jsonLdEntities, textEntities, bodyText);
+    // Primary path: MCP sampling.
+    let mode = "regex_fallback";
+    let entities = [];
+    if (server) {
+        const sampled = await trySampling(bodyText, externalLinks, server);
+        if (sampled && sampled.length > 0) {
+            mode = "sampling";
+            const sampledEntities = sampled.map((e) => ({
+                name: e.name,
+                type: e.type ?? null,
+                same_as: Array.isArray(e.same_as) ? e.same_as.filter((s) => typeof s === "string") : [],
+                mention_count: countOccurrences(bodyText, e.name),
+                is_defined: false,
+            }));
+            // Merge with JSON-LD entities (JSON-LD wins on dup name, lowercase keyed).
+            const byName = new Map();
+            for (const e of sampledEntities)
+                byName.set(e.name.toLowerCase(), e);
+            for (const e of jsonLdEntities) {
+                const key = e.name.toLowerCase();
+                const existing = byName.get(key);
+                const count = countOccurrences(bodyText, e.name);
+                if (existing) {
+                    // JSON-LD's sameAs wins; merge with sampled name/type.
+                    byName.set(key, {
+                        ...existing,
+                        same_as: e.same_as.length > 0 ? e.same_as : existing.same_as,
+                        type: e.type ?? existing.type,
+                        mention_count: count || existing.mention_count,
+                    });
+                }
+                else {
+                    byName.set(key, { ...e, mention_count: count });
+                }
+            }
+            entities = Array.from(byName.values()).sort((a, b) => b.mention_count - a.mention_count);
+        }
+    }
+    // Fallback: regex extractor.
+    if (mode === "regex_fallback") {
+        const textEntities = extractTextEntities(bodyText);
+        entities = mergeEntities(jsonLdEntities, textEntities, bodyText);
+    }
     const entity_count = entities.length;
     const connected_entity_count = entities.filter((e) => e.same_as.length > 0).length;
     // Threshold: 15 connected entities = score of 100
@@ -64,6 +170,7 @@ export async function extractEntities(input, hostDelays, robotsCache) {
         connected_entity_count,
         citation_density_score,
         findings,
+        mode,
     };
 }
 //# sourceMappingURL=extract-entities.js.map

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

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

package/dist/tools/save-audit-report.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const saveAuditReportInputSchema: z.ZodObject<{
+    audit_result: z.ZodUnknown;
+    path: z.ZodString;
+    overwrite: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    overwrite: boolean;
+    audit_result?: unknown;
+}, {
+    path: string;
+    audit_result?: unknown;
+    overwrite?: boolean | undefined;
+}>;
+export type SaveAuditReportInput = z.infer<typeof saveAuditReportInputSchema>;
+export interface SaveAuditReportResult {
+    saved_to: string;
+    bytes_written: number;
+    format: "audit_page" | "audit_site";
+}
+export declare function saveAuditReport(input: SaveAuditReportInput): Promise<SaveAuditReportResult>;
+//# sourceMappingURL=save-audit-report.d.ts.map

package/dist/tools/save-audit-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-audit-report.d.ts","sourceRoot":"","sources":["../../src/tools/save-audit-report.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,GAAG,YAAY,CAAC;CACrC;AA8GD,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyBjG"}

package/dist/tools/save-audit-report.js

@@ -0,0 +1,133 @@
+// Tool: save_audit_report
+// Render an audit_page / audit_site result as Markdown and write to a workspace file.
+// Restricted to the directory tree under MCP_WORKSPACE_ROOT (or cwd if unset).
+import { z } from "zod";
+import { writeFile, mkdir } from "node:fs/promises";
+import { dirname, isAbsolute, resolve, sep, relative } from "node:path";
+export const saveAuditReportInputSchema = z.object({
+    audit_result: z.unknown().describe("The return value of `audit.page` or `audit.site`. Pass the structured result verbatim - the tool detects which shape it is and renders the matching Markdown report."),
+    path: z.string().min(1).describe("Target file path. May be relative to MCP_WORKSPACE_ROOT (or cwd if unset). Paths that escape the workspace root are rejected."),
+    overwrite: z.boolean().optional().default(true).describe("If true (default), overwrite an existing file. If false, the write fails when the target already exists."),
+});
+function severityEmoji(s) {
+    return s === "critical" ? "🔴" : s === "warning" ? "🟡" : "🔵";
+}
+function findingsToTable(findings) {
+    if (findings.length === 0)
+        return "_No findings._\n";
+    const rows = findings.map((f) => {
+        const impact = f.estimated_impact ? ` (impact: ${f.estimated_impact})` : "";
+        return `### ${severityEmoji(f.severity)} ${f.category} — ${f.message}\n\n` +
+            `**Where:** \`${f.where}\`${impact}\n\n` +
+            `**Fix:** ${f.fix}\n`;
+    });
+    return rows.join("\n");
+}
+function citationVerdict(grade) {
+    switch (grade) {
+        case "A": return "🟢 Highly citation-ready. AI assistants are likely to surface this page.";
+        case "B": return "🟢 Citation-ready with minor gaps. A few fixes will lift you into top-tier.";
+        case "C": return "🟡 Mixed signals. Several structural / authority issues are likely blocking citations.";
+        case "D": return "🟠 Low citation readiness. Multiple critical issues must be addressed.";
+        case "F": return "🔴 Not citation-ready. AI engines are likely skipping this page.";
+    }
+}
+function dimensionTable(scores) {
+    const rows = ["| Dimension | Score |", "|---|---|"];
+    for (const [k, v] of Object.entries(scores)) {
+        rows.push(`| ${k} | ${v}/100 |`);
+    }
+    return rows.join("\n");
+}
+function isAuditPage(x) {
+    return !!x && typeof x === "object" && "dimension_scores" in x && "grade" in x && "findings" in x;
+}
+function isAuditSite(x) {
+    return !!x && typeof x === "object" && "top_5_fixes" in x && "overall_grade" in x && "parts" in x;
+}
+function renderAuditPage(r) {
+    const sorted = [...r.findings].sort((a, b) => {
+        const rank = (s) => (s === "critical" ? 0 : s === "warning" ? 1 : 2);
+        return rank(a.severity) - rank(b.severity);
+    });
+    return [
+        `# AI-SEO audit: ${r.url}`,
+        ``,
+        `> ${citationVerdict(r.grade)}`,
+        ``,
+        `**Score:** ${r.score}/100 (grade ${r.grade})`,
+        `**Fetched:** ${r.fetched_at}`,
+        `**Content quality:** \`${r.content_quality}\``,
+        ``,
+        `## Dimension scores`,
+        ``,
+        dimensionTable(r.dimension_scores),
+        ``,
+        `## Findings (${r.findings.length})`,
+        ``,
+        findingsToTable(sorted),
+        ``,
+        `---`,
+        ``,
+        `_Generated by [@automatelab/ai-seo-mcp](https://github.com/AutomateLab-tech/ai-seo)._`,
+        ``,
+    ].join("\n");
+}
+function renderAuditSite(r) {
+    return [
+        `# AI-SEO site audit: ${r.domain}`,
+        ``,
+        `**Overall score:** ${r.overall_score}/100 (grade ${r.overall_grade})`,
+        `**Homepage:** ${r.homepage_url}`,
+        `**Fetched:** ${r.fetched_at}`,
+        ``,
+        `## Top 5 fixes`,
+        ``,
+        findingsToTable(r.top_5_fixes),
+        ``,
+        `## Components`,
+        ``,
+        `- \`audit_page\`: ${"error" in r.parts.audit_page ? `❌ ${r.parts.audit_page.error}` : `${r.parts.audit_page.score}/100`}`,
+        `- \`check_robots\`: ${"error" in r.parts.check_robots ? `❌ ${r.parts.check_robots.error}` : r.parts.check_robots.recommended_posture}`,
+        `- \`check_sitemap\`: ${"error" in r.parts.check_sitemap ? `❌ ${r.parts.check_sitemap.error}` : r.parts.check_sitemap.status}`,
+        `- \`audit_schema\`: ${"error" in r.parts.audit_schema ? `❌ ${r.parts.audit_schema.error}` : `${r.parts.audit_schema.ai_citation_readiness_score}/100`}`,
+        ``,
+        `---`,
+        ``,
+        `_Generated by [@automatelab/ai-seo-mcp](https://github.com/AutomateLab-tech/ai-seo)._`,
+        ``,
+    ].join("\n");
+}
+function resolveSafePath(target) {
+    const workspaceRoot = resolve(process.env["MCP_WORKSPACE_ROOT"] ?? process.cwd());
+    const absolute = isAbsolute(target) ? resolve(target) : resolve(workspaceRoot, target);
+    const rel = relative(workspaceRoot, absolute);
+    if (rel.startsWith("..") || rel.includes(`..${sep}`) || isAbsolute(rel)) {
+        throw new Error(`path "${target}" escapes MCP_WORKSPACE_ROOT (${workspaceRoot}). Set MCP_WORKSPACE_ROOT or pass a path inside it.`);
+    }
+    return absolute;
+}
+export async function saveAuditReport(input) {
+    let markdown;
+    let format;
+    if (isAuditSite(input.audit_result)) {
+        markdown = renderAuditSite(input.audit_result);
+        format = "audit_site";
+    }
+    else if (isAuditPage(input.audit_result)) {
+        markdown = renderAuditPage(input.audit_result);
+        format = "audit_page";
+    }
+    else {
+        throw new Error("audit_result does not look like an audit_page or audit_site output (missing expected fields).");
+    }
+    const absolute = resolveSafePath(input.path);
+    await mkdir(dirname(absolute), { recursive: true });
+    await writeFile(absolute, markdown, { encoding: "utf8", flag: input.overwrite ? "w" : "wx" });
+    return {
+        saved_to: absolute,
+        bytes_written: Buffer.byteLength(markdown, "utf8"),
+        format,
+    };
+}
+//# sourceMappingURL=save-audit-report.js.map

package/dist/tools/save-audit-report.js.map

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

package/dist/tools/test-citation.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { type HostDelayMap } from "../lib/fetch.js";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const testCitationInputSchema: z.ZodEffects<z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    target_query: z.ZodString;
+    engine: z.ZodDefault<z.ZodOptional<z.ZodEnum<["chatgpt", "claude", "perplexity", "google_ai_overviews", "any"]>>>;
+    respect_robots: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    respect_robots: boolean;
+    target_query: string;
+    engine: "any" | "chatgpt" | "claude" | "perplexity" | "google_ai_overviews";
+    url?: string | undefined;
+    text?: string | undefined;
+}, {
+    target_query: string;
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    text?: string | undefined;
+    engine?: "any" | "chatgpt" | "claude" | "perplexity" | "google_ai_overviews" | undefined;
+}>, {
+    respect_robots: boolean;
+    target_query: string;
+    engine: "any" | "chatgpt" | "claude" | "perplexity" | "google_ai_overviews";
+    url?: string | undefined;
+    text?: string | undefined;
+}, {
+    target_query: string;
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    text?: string | undefined;
+    engine?: "any" | "chatgpt" | "claude" | "perplexity" | "google_ai_overviews" | undefined;
+}>;
+export type TestCitationInput = z.infer<typeof testCitationInputSchema>;
+export interface TestCitationResult {
+    target_query: string;
+    engine: "chatgpt" | "claude" | "perplexity" | "google_ai_overviews" | "any";
+    would_cite: boolean;
+    confidence: number;
+    citation_excerpt: string | null;
+    reasoning: string;
+    blocking_issues: string[];
+    improvements: Array<{
+        change: string;
+        estimated_impact: "high" | "medium" | "low";
+    }>;
+    mode: "sampling" | "static_heuristic";
+}
+export declare function testCitation(input: TestCitationInput, hostDelays?: HostDelayMap, robotsCache?: Map<string, string>, server?: McpServer): Promise<TestCitationResult>;
+//# sourceMappingURL=test-citation.d.ts.map

package/dist/tools/test-citation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-citation.d.ts","sourceRoot":"","sources":["../../src/tools/test-citation.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAahC,CAAC;AAEL,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,qBAAqB,GAAG,KAAK,CAAC;IAC5E,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;KAAE,CAAC,CAAC;IACrF,IAAI,EAAE,UAAU,GAAG,kBAAkB,CAAC;CACvC;AA+FD,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,EACxB,UAAU,CAAC,EAAE,YAAY,EACzB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,kBAAkB,CAAC,CA2E7B"}

package/dist/tools/test-citation.js

@@ -0,0 +1,159 @@
+// Tool: test_citation
+// Simulates "would an AI engine cite this page for this query?" via MCP sampling.
+// Primary path: ask the host LLM to role-play an AI search engine, decide cite/no-cite,
+// and return the excerpt it would surface. Fallback: deterministic heuristic from
+// score_citation_worthiness + audit_page findings.
+import { z } from "zod";
+import { politeFetch } from "../lib/fetch.js";
+import { parseBody } from "../lib/html.js";
+import { scoreCitationWorthiness } from "./score-citation-worthiness.js";
+export const testCitationInputSchema = z
+    .object({
+    url: z.string().url().optional(),
+    text: z.string().optional(),
+    target_query: z.string().min(3),
+    engine: z
+        .enum(["chatgpt", "claude", "perplexity", "google_ai_overviews", "any"])
+        .optional()
+        .default("any"),
+    respect_robots: z.boolean().optional().default(true),
+})
+    .refine((d) => d.url !== undefined || d.text !== undefined, {
+    message: "One of url or text is required",
+});
+const ENGINE_PERSONAS = {
+    chatgpt: "You are ChatGPT search. You prefer pages with BLUF openings, FAQPage / Article JSON-LD, named-entity density, and links to authoritative sources (Wikipedia, .gov, .edu).",
+    claude: "You are Claude Search. You favor pages with clear topical coherence, concise definitions, explicit authorship, and minimal marketing fluff. You penalize SEO boilerplate.",
+    perplexity: "You are Perplexity. You synthesize across sources and pick excerpts that are statistic-dense, citation-friendly, and clearly attributable. You favor numbered lists and comparison tables.",
+    google_ai_overviews: "You are Google's AI Overviews. You favor pages with Article / FAQ / HowTo schema, recent dateModified, E-E-A-T author signals, and direct answers to the query in the first 80 words.",
+    any: "You are a generic AI search assistant. You decide cite vs no-cite based on direct query answerability, structured data presence, entity density, and freshness.",
+};
+const SYSTEM_PROMPT_PREFIX = `You are simulating an AI search engine deciding whether to cite a web page in response to a user query.
+
+Return JSON only, no prose. Shape:
+{
+  "would_cite": boolean,
+  "confidence": 0-100 integer,
+  "citation_excerpt": string | null,
+  "reasoning": string,
+  "blocking_issues": [string, ...],
+  "improvements": [{ "change": string, "estimated_impact": "high" | "medium" | "low" }, ...]
+}
+
+Rules:
+- would_cite=true ONLY if the page contains a clear, attributable answer to the query in the first ~500 words.
+- citation_excerpt: if would_cite=true, the 20-60 word verbatim excerpt you would surface; otherwise null.
+- confidence reflects how likely a real engine is to surface this page given the query (not your certainty about the decision).
+- blocking_issues: 1-5 concrete reasons the page is/isn't citable. Empty array if would_cite=true and excerpt is clearly attributable.
+- improvements: 1-5 ranked, specific edits the author should make to improve citation probability.`;
+async function trySampling(bodyText, url, targetQuery, engine, server) {
+    const persona = ENGINE_PERSONAS[engine];
+    const userMessage = `Query: "${targetQuery}"
+${url ? `Page URL: ${url}` : ""}
+Page content (first 6000 chars):
+---
+${bodyText.substring(0, 6000)}
+---
+
+Decide cite vs no-cite. Return JSON only.`;
+    try {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore - sampling API availability varies by client; not typed in all SDK versions
+        const samplingResult = await server.server.request({
+            method: "sampling/createMessage",
+            params: {
+                messages: [{ role: "user", content: { type: "text", text: userMessage } }],
+                systemPrompt: `${SYSTEM_PROMPT_PREFIX}\n\nPersona: ${persona}`,
+                maxTokens: 2048,
+            },
+        }, 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        {});
+        const text = samplingResult?.content?.text ?? samplingResult?.content?.[0]?.text ?? "";
+        if (!text)
+            return null;
+        const jsonMatch = text.match(/```json\n([\s\S]+?)\n```/) ?? text.match(/\{[\s\S]+\}/);
+        const jsonStr = jsonMatch ? (jsonMatch[1] ?? jsonMatch[0]) : text;
+        const parsed = JSON.parse(jsonStr);
+        if (typeof parsed.would_cite !== "boolean")
+            return null;
+        return {
+            would_cite: parsed.would_cite,
+            confidence: Number.isFinite(parsed.confidence) ? Math.max(0, Math.min(100, parsed.confidence)) : 50,
+            citation_excerpt: parsed.citation_excerpt ?? null,
+            reasoning: parsed.reasoning ?? "",
+            blocking_issues: Array.isArray(parsed.blocking_issues) ? parsed.blocking_issues : [],
+            improvements: Array.isArray(parsed.improvements) ? parsed.improvements : [],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export async function testCitation(input, hostDelays, robotsCache, server) {
+    let bodyText = input.text ?? "";
+    if (input.url) {
+        const result = await politeFetch(input.url, {
+            respectRobots: input.respect_robots,
+            hostDelays,
+            robotsCache,
+        });
+        const parsed = parseBody(result.body, input.url);
+        bodyText = parsed.bodyText;
+    }
+    // Primary: MCP sampling
+    if (server) {
+        const sampled = await trySampling(bodyText, input.url, input.target_query, input.engine, server);
+        if (sampled) {
+            return {
+                target_query: input.target_query,
+                engine: input.engine,
+                would_cite: sampled.would_cite,
+                confidence: sampled.confidence,
+                citation_excerpt: sampled.citation_excerpt,
+                reasoning: sampled.reasoning,
+                blocking_issues: sampled.blocking_issues,
+                improvements: sampled.improvements,
+                mode: "sampling",
+            };
+        }
+    }
+    // Fallback: heuristic from score_citation_worthiness.
+    const score = await scoreCitationWorthiness({ text: bodyText, target_query: input.target_query, respect_robots: false }, hostDelays, robotsCache);
+    // would_cite gate: overall >= 70 AND the relevant engine subscore >= 65.
+    const engineScoreKey = {
+        chatgpt: "chatgpt",
+        claude: "claude",
+        perplexity: "perplexity",
+        google_ai_overviews: "google_ai_overviews",
+        any: null,
+    };
+    const key = engineScoreKey[input.engine];
+    const engineScore = key ? score.engine_scores[key] : score.overall_score;
+    const wouldCite = score.overall_score >= 70 && engineScore >= 65;
+    const blocking = score.findings
+        .filter((f) => f.severity === "critical" || f.severity === "warning")
+        .slice(0, 5)
+        .map((f) => f.message);
+    const improvements = score.findings
+        .filter((f) => f.severity === "critical" || f.severity === "warning")
+        .slice(0, 5)
+        .map((f) => ({
+        change: f.fix,
+        estimated_impact: (f.estimated_impact ?? "medium"),
+    }));
+    return {
+        target_query: input.target_query,
+        engine: input.engine,
+        would_cite: wouldCite,
+        confidence: Math.round((score.overall_score + engineScore) / 2),
+        citation_excerpt: null,
+        reasoning: wouldCite
+            ? `Heuristic verdict: overall citability ${score.overall_score}/100 and ${input.engine} subscore ${engineScore}/100 both clear the cite threshold.`
+            : `Heuristic verdict: overall citability ${score.overall_score}/100 and ${input.engine} subscore ${engineScore}/100 fall below cite threshold. Run with an MCP host that supports sampling for a model-based simulation.`,
+        blocking_issues: blocking,
+        improvements,
+        mode: "static_heuristic",
+    };
+}
+//# sourceMappingURL=test-citation.js.map

package/dist/tools/test-citation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-citation.js","sourceRoot":"","sources":["../../src/tools/test-citation.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,kFAAkF;AAClF,wFAAwF;AACxF,kFAAkF;AAClF,mDAAmD;AAEnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAqB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC;SACvE,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;IACjB,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACrD,CAAC;KACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE;IAC1D,OAAO,EAAE,gCAAgC;CAC1C,CAAC,CAAC;AAgBL,MAAM,eAAe,GAAgD;IACnE,OAAO,EACL,2KAA2K;IAC7K,MAAM,EACJ,2KAA2K;IAC7K,UAAU,EACR,4LAA4L;IAC9L,mBAAmB,EACjB,uLAAuL;IACzL,GAAG,EACD,iKAAiK;CACpK,CAAC;AAEF,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;mGAiBsE,CAAC;AAWpG,KAAK,UAAU,WAAW,CACxB,QAAgB,EAChB,GAAuB,EACvB,WAAmB,EACnB,MAAmC,EACnC,MAAiB;IAEjB,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,WAAW,WAAW;EAC1C,GAAG,CAAC,CAAC,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE;;;EAG7B,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC;;;0CAGa,CAAC;IAEzC,IAAI,CAAC;QACH,6DAA6D;QAC7D,yFAAyF;QACzF,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAChD;YACE,MAAM,EAAE,wBAAwB;YAChC,MAAM,EAAE;gBACN,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;gBAC1E,YAAY,EAAE,GAAG,oBAAoB,gBAAgB,OAAO,EAAE;gBAC9D,SAAS,EAAE,IAAI;aAChB;SACF;QACD,8DAA8D;QAC9D,EAAS,CACV,CAAC;QACF,MAAM,IAAI,GACR,cAAc,EAAE,OAAO,EAAE,IAAI,IAAI,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QAC5E,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACtF,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;QAC9D,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACxD,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,UAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;YACpG,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,IAAI;YACjD,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;YACjC,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE;YACpF,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;SAC5E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwB,EACxB,UAAyB,EACzB,WAAiC,EACjC,MAAkB;IAElB,IAAI,QAAQ,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE;YAC1C,aAAa,EAAE,KAAK,CAAC,cAAc;YACnC,UAAU;YACV,WAAW;SACZ,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACjD,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,wBAAwB;IACxB,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjG,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO;gBACL,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,IAAI,EAAE,UAAU;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,MAAM,KAAK,GAAG,MAAM,uBAAuB,CACzC,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,EAC3E,UAAU,EACV,WAAW,CACZ,CAAC;IAEF,yEAAyE;IACzE,MAAM,cAAc,GAAiF;QACnG,OAAO,EAAE,SAAS;QAClB,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,YAAY;QACxB,mBAAmB,EAAE,qBAAqB;QAC1C,GAAG,EAAE,IAAI;KACV,CAAC;IACF,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IACzE,MAAM,SAAS,GAAG,KAAK,CAAC,aAAa,IAAI,EAAE,IAAI,WAAW,IAAI,EAAE,CAAC;IAEjE,MAAM,QAAQ,GAAa,KAAK,CAAC,QAAQ;SACtC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC;SACpE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAEzB,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC;SACpE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,MAAM,EAAE,CAAC,CAAC,GAAG;QACb,gBAAgB,EAAE,CAAC,CAAC,CAAC,gBAAgB,IAAI,QAAQ,CAA8B;KAChF,CAAC,CAAC,CAAC;IAEN,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/D,gBAAgB,EAAE,IAAI;QACtB,SAAS,EAAE,SAAS;YAClB,CAAC,CAAC,yCAAyC,KAAK,CAAC,aAAa,YAAY,KAAK,CAAC,MAAM,aAAa,WAAW,qCAAqC;YACnJ,CAAC,CAAC,yCAAyC,KAAK,CAAC,aAAa,YAAY,KAAK,CAAC,MAAM,aAAa,WAAW,2GAA2G;QAC3N,eAAe,EAAE,QAAQ;QACzB,YAAY;QACZ,IAAI,EAAE,kBAAkB;KACzB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automatelab/ai-seo-mcp",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "mcpName": "io.github.AutomateLab-tech/ai-seo-mcp",
   "description": "AI Citation Toolkit - audit, score, and rewrite web pages for AI-citation eligibility. AEO/GEO/LLM visibility for any MCP client.",
   "license": "MIT",
@@ -34,6 +34,12 @@
     "undici": "7.25.0",
     "zod": "3.25.76"
   },
+  "peerDependencies": {
+    "playwright-core": "^1.49.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright-core": { "optional": true }
+  },
   "devDependencies": {
     "@types/node": "22.19.19",
     "tsx": "4.22.0",
@@ -45,6 +51,7 @@
     "src/lib/crawlers.json",
     "src/lib/schema-types.json",
     "action.yml",
+    "smithery.yaml",
     "README.md",
     "LICENSE"
   ],

package/smithery.yaml

@@ -0,0 +1,13 @@
+startCommand:
+  type: stdio
+
+configSchema:
+  type: object
+  properties: {}
+  required: []
+
+commandFunction: |-
+  () => ({
+    command: "npx",
+    args: ["-y", "@automatelab/ai-seo-mcp"]
+  })