@automatelab/ai-seo-mcp 0.3.0 → 0.3.4

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.3.0",
+  "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",
@@ -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",

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"]
+}

package/src/lib/schema-types.json

@@ -1,56 +1,56 @@
-[
-  "Article",
-  "BlogPosting",
-  "NewsArticle",
-  "FAQPage",
-  "Question",
-  "Answer",
-  "HowTo",
-  "HowToStep",
-  "HowToSection",
-  "HowToTool",
-  "HowToSupply",
-  "Organization",
-  "LocalBusiness",
-  "Person",
-  "Product",
-  "Offer",
-  "AggregateOffer",
-  "Review",
-  "AggregateRating",
-  "Rating",
-  "BreadcrumbList",
-  "ListItem",
-  "SoftwareApplication",
-  "WebApplication",
-  "MobileApplication",
-  "WebSite",
-  "WebPage",
-  "ItemPage",
-  "AboutPage",
-  "ContactPage",
-  "SearchResultsPage",
-  "ImageObject",
-  "VideoObject",
-  "AudioObject",
-  "MediaObject",
-  "Event",
-  "CreativeWork",
-  "Book",
-  "Course",
-  "Recipe",
-  "Dataset",
-  "SpeakableSpecification",
-  "SearchAction",
-  "EntryPoint",
-  "PostalAddress",
-  "GeoCoordinates",
-  "OpeningHoursSpecification",
-  "PriceSpecification",
-  "MonetaryAmount",
-  "ContactPoint",
-  "Brand",
-  "Intangible",
-  "Thing",
-  "Place"
-]
+[
+  "Article",
+  "BlogPosting",
+  "NewsArticle",
+  "FAQPage",
+  "Question",
+  "Answer",
+  "HowTo",
+  "HowToStep",
+  "HowToSection",
+  "HowToTool",
+  "HowToSupply",
+  "Organization",
+  "LocalBusiness",
+  "Person",
+  "Product",
+  "Offer",
+  "AggregateOffer",
+  "Review",
+  "AggregateRating",
+  "Rating",
+  "BreadcrumbList",
+  "ListItem",
+  "SoftwareApplication",
+  "WebApplication",
+  "MobileApplication",
+  "WebSite",
+  "WebPage",
+  "ItemPage",
+  "AboutPage",
+  "ContactPage",
+  "SearchResultsPage",
+  "ImageObject",
+  "VideoObject",
+  "AudioObject",
+  "MediaObject",
+  "Event",
+  "CreativeWork",
+  "Book",
+  "Course",
+  "Recipe",
+  "Dataset",
+  "SpeakableSpecification",
+  "SearchAction",
+  "EntryPoint",
+  "PostalAddress",
+  "GeoCoordinates",
+  "OpeningHoursSpecification",
+  "PriceSpecification",
+  "MonetaryAmount",
+  "ContactPoint",
+  "Brand",
+  "Intangible",
+  "Thing",
+  "Place"
+]