@automatelab/ai-seo-mcp 0.1.3 → 0.3.4

package/dist/tools/rewrite-for-aeo.js

@@ -17,20 +17,20 @@ export const rewriteForAeoInputSchema = z
     .refine((d) => d.url !== undefined || d.text !== undefined, {
     message: "One of url or text is required",
 });
-const AEO_SYSTEM_PROMPT = `You are an Answer Engine Optimization (AEO) specialist. Rewrite the provided content to maximize AI engine citation probability.
-
-Rules:
-1. Open with a direct 40-60 word answer to the target query (BLUF - Bottom Line Up Front).
-2. Structure body content into FAQ format: H3 questions ending in "?" followed by 40-60 word answers.
-3. Include at least one ordered list for procedural content.
-4. Define key technical terms inline (e.g., "X is a type of Y that...").
-5. Cite statistics with year and source where present.
-6. End with a "Key Takeaways" or "Summary" section.
-7. No em-dashes. No filler phrases ("In conclusion", "It is important to note").
-8. Keep within the max_words limit.
-9. For howto format: use numbered HowToStep structure.
-10. For comparison format: include a comparison table.
-
+const AEO_SYSTEM_PROMPT = `You are an Answer Engine Optimization (AEO) specialist. Rewrite the provided content to maximize AI engine citation probability.
+
+Rules:
+1. Open with a direct 40-60 word answer to the target query (BLUF - Bottom Line Up Front).
+2. Structure body content into FAQ format: H3 questions ending in "?" followed by 40-60 word answers.
+3. Include at least one ordered list for procedural content.
+4. Define key technical terms inline (e.g., "X is a type of Y that...").
+5. Cite statistics with year and source where present.
+6. End with a "Key Takeaways" or "Summary" section.
+7. No em-dashes. No filler phrases ("In conclusion", "It is important to note").
+8. Keep within the max_words limit.
+9. For howto format: use numbered HowToStep structure.
+10. For comparison format: include a comparison table.
+
 Also generate a JSON-LD schema block appropriate for the content type and format.`;
 export async function rewriteForAeo(input, hostDelays, robotsCache, server) {
     // Fetch URL if provided
@@ -47,18 +47,18 @@ export async function rewriteForAeo(input, hostDelays, robotsCache, server) {
     // Compute before score
     const beforeResult = await scoreCitationWorthiness({ text: originalText, target_query: input.target_query, respect_robots: false }, hostDelays, robotsCache);
     const before_score = beforeResult.overall_score;
-    const userMessage = `Target query: "${input.target_query}"
-Format: ${input.format}
-Max words: ${input.max_words}
-
-Original content:
----
-${originalText.substring(0, 4000)}
----
-
-Rewrite this content for AEO. Return your response as JSON with these fields:
-- rewritten_text: the rewritten content (Markdown)
-- schema_additions: JSON-LD string to add to the page <head>
+    const userMessage = `Target query: "${input.target_query}"
+Format: ${input.format}
+Max words: ${input.max_words}
+
+Original content:
+---
+${originalText.substring(0, 4000)}
+---
+
+Rewrite this content for AEO. Return your response as JSON with these fields:
+- rewritten_text: the rewritten content (Markdown)
+- schema_additions: JSON-LD string to add to the page <head>
 - changes_made: array of strings describing each change applied`;
     // Attempt MCP sampling
     if (server) {
@@ -102,8 +102,8 @@ Rewrite this content for AEO. Return your response as JSON with these fields:
         }
     }
     // Prompt template fallback
-    const promptTemplate = `${AEO_SYSTEM_PROMPT}
-
+    const promptTemplate = `${AEO_SYSTEM_PROMPT}
+
 ${userMessage}`;
     return {
         rewritten_text: promptTemplate,

package/dist/tools/rewrite-for-geo.js

@@ -16,19 +16,19 @@ export const rewriteForGeoInputSchema = z
     .refine((d) => d.url !== undefined || d.text !== undefined, {
     message: "One of url or text is required",
 });
-const GEO_SYSTEM_PROMPT = `You are a Generative Engine Optimization (GEO) specialist focused on Google AI Overviews and multi-source synthesis engines.
-
-Rules:
-1. Define every key entity inline on first mention: "X (also known as Y) is a type of Z that...".
-2. Include authoritative external citations with hyperlinks (Wikipedia, official docs, research papers).
-3. Add a comparison table if requested or if the query implies comparison.
-4. Use numbered feature lists for technical capabilities.
-5. Structure for multi-source synthesis: each section should be independently citable without reading the full article.
-6. Cite statistics with source, year, and context.
-7. Add a "Related entities" section at the end listing key entities with sameAs links.
-8. No em-dashes. No filler phrases.
-9. Keep within the max_words limit.
-
+const GEO_SYSTEM_PROMPT = `You are a Generative Engine Optimization (GEO) specialist focused on Google AI Overviews and multi-source synthesis engines.
+
+Rules:
+1. Define every key entity inline on first mention: "X (also known as Y) is a type of Z that...".
+2. Include authoritative external citations with hyperlinks (Wikipedia, official docs, research papers).
+3. Add a comparison table if requested or if the query implies comparison.
+4. Use numbered feature lists for technical capabilities.
+5. Structure for multi-source synthesis: each section should be independently citable without reading the full article.
+6. Cite statistics with source, year, and context.
+7. Add a "Related entities" section at the end listing key entities with sameAs links.
+8. No em-dashes. No filler phrases.
+9. Keep within the max_words limit.
+
 Generate JSON-LD schema for all key entities mentioned (Organization, Person, Product, SoftwareApplication as appropriate) with sameAs links.`;
 export async function rewriteForGeo(input, hostDelays, robotsCache, server) {
     let originalText = input.text ?? "";
@@ -43,19 +43,19 @@ export async function rewriteForGeo(input, hostDelays, robotsCache, server) {
     }
     const beforeResult = await scoreCitationWorthiness({ text: originalText, target_query: input.target_query, respect_robots: false }, hostDelays, robotsCache);
     const before_score = beforeResult.overall_score;
-    const userMessage = `Target query: "${input.target_query}"
-Add comparison table: ${input.add_comparison_table}
-Max words: ${input.max_words}
-
-Original content:
----
-${originalText.substring(0, 4000)}
----
-
-Rewrite this content for GEO. Return JSON with:
-- rewritten_text: Markdown content
-- schema_additions: JSON-LD for key entities
-- changes_made: array of changes applied
+    const userMessage = `Target query: "${input.target_query}"
+Add comparison table: ${input.add_comparison_table}
+Max words: ${input.max_words}
+
+Original content:
+---
+${originalText.substring(0, 4000)}
+---
+
+Rewrite this content for GEO. Return JSON with:
+- rewritten_text: Markdown content
+- schema_additions: JSON-LD for key entities
+- changes_made: array of changes applied
 - entities_added: array of entity names you defined or linked`;
     if (server) {
         try {
@@ -97,8 +97,8 @@ Rewrite this content for GEO. Return JSON with:
             // sampling unavailable
         }
     }
-    const promptTemplate = `${GEO_SYSTEM_PROMPT}
-
+    const promptTemplate = `${GEO_SYSTEM_PROMPT}
+
 ${userMessage}`;
     return {
         rewritten_text: promptTemplate,

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"),
+    path: z.string().min(1).describe("Target file path. May be relative to MCP_WORKSPACE_ROOT (or cwd)."),
+    overwrite: z.boolean().optional().default(true),
+});
+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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automatelab/ai-seo-mcp",
-  "version": "0.1.3",
+  "version": "0.3.4",
   "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",
@@ -13,7 +13,8 @@
   "engines": { "node": ">=20" },
   "type": "module",
   "bin": {
-    "ai-seo-mcp": "dist/index.js"
+    "ai-seo-mcp": "dist/index.js",
+    "ai-seo-audit": "dist/cli/audit-cli.js"
   },
   "main": "dist/index.js",
   "scripts": {
@@ -33,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",
@@ -43,6 +50,7 @@
     "dist",
     "src/lib/crawlers.json",
     "src/lib/schema-types.json",
+    "action.yml",
     "README.md",
     "LICENSE"
   ],

package/src/lib/crawlers.json

@@ -1,6 +1,6 @@
-{
-  "training": ["GPTBot", "ClaudeBot", "CCBot", "Meta-ExternalAgent", "Amazonbot"],
-  "search": ["OAI-SearchBot", "Claude-SearchBot", "PerplexityBot", "Bingbot", "DuckAssistBot"],
-  "user_triggered": ["ChatGPT-User", "Claude-User", "Google-Agent"],
-  "robots_token_only": ["Google-Extended", "Applebot-Extended"]
-}
+{
+  "training": ["GPTBot", "ClaudeBot", "CCBot", "Meta-ExternalAgent", "Amazonbot"],
+  "search": ["OAI-SearchBot", "Claude-SearchBot", "PerplexityBot", "Bingbot", "DuckAssistBot"],
+  "user_triggered": ["ChatGPT-User", "Claude-User", "Google-Agent"],
+  "robots_token_only": ["Google-Extended", "Applebot-Extended"]
+}