@automatelab/ai-seo-mcp 0.1.0

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

@@ -0,0 +1,119 @@
+// Tool: rewrite_for_aeo
+// Rewrites content for Answer Engine Optimization via MCP sampling.
+// Falls back to returning a structured prompt template if sampling is unavailable.
+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 rewriteForAeoInputSchema = z
+    .object({
+    url: z.string().url().optional(),
+    text: z.string().optional(),
+    target_query: z.string(),
+    format: z.enum(["article", "faq", "howto", "comparison"]).default("article"),
+    max_words: z.number().int().min(100).max(5000).optional().default(1500),
+    respect_robots: z.boolean().optional().default(true),
+})
+    .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.
+
+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
+    let originalText = input.text ?? "";
+    if (input.url) {
+        const result = await politeFetch(input.url, {
+            respectRobots: input.respect_robots,
+            hostDelays,
+            robotsCache,
+        });
+        const body = parseBody(result.body, input.url);
+        originalText = body.bodyText.substring(0, 8000);
+    }
+    // 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>
+- changes_made: array of strings describing each change applied`;
+    // Attempt MCP sampling
+    if (server) {
+        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: AEO_SYSTEM_PROMPT,
+                    maxTokens: 4096,
+                },
+            }, 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            {});
+            const text = samplingResult?.content?.text ?? samplingResult?.content?.[0]?.text ?? "";
+            if (text) {
+                try {
+                    // Extract JSON from response (may be wrapped in markdown code blocks)
+                    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);
+                    const afterResult = await scoreCitationWorthiness({ text: parsed.rewritten_text, target_query: input.target_query, respect_robots: false }, hostDelays, robotsCache);
+                    return {
+                        rewritten_text: parsed.rewritten_text,
+                        schema_additions: parsed.schema_additions,
+                        changes_made: parsed.changes_made ?? [],
+                        before_score,
+                        after_score: afterResult.overall_score,
+                        mode: "sampling",
+                    };
+                }
+                catch {
+                    // JSON parse failed - fall through to prompt template
+                }
+            }
+        }
+        catch {
+            // Sampling unavailable or failed - fall through to prompt template
+        }
+    }
+    // Prompt template fallback
+    const promptTemplate = `${AEO_SYSTEM_PROMPT}
+
+${userMessage}`;
+    return {
+        rewritten_text: promptTemplate,
+        schema_additions: "",
+        changes_made: [
+            "sampling/createMessage unavailable - returned prompt template for manual use",
+        ],
+        before_score,
+        after_score: before_score, // unchanged since we did not rewrite
+        mode: "prompt_template",
+    };
+}
+//# sourceMappingURL=rewrite-for-aeo.js.map

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

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

package/dist/tools/rewrite-for-geo.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 rewriteForGeoInputSchema: z.ZodEffects<z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    target_query: z.ZodString;
+    add_comparison_table: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    max_words: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    respect_robots: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    respect_robots: boolean;
+    target_query: string;
+    max_words: number;
+    add_comparison_table: boolean;
+    url?: string | undefined;
+    text?: string | undefined;
+}, {
+    target_query: string;
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    text?: string | undefined;
+    max_words?: number | undefined;
+    add_comparison_table?: boolean | undefined;
+}>, {
+    respect_robots: boolean;
+    target_query: string;
+    max_words: number;
+    add_comparison_table: boolean;
+    url?: string | undefined;
+    text?: string | undefined;
+}, {
+    target_query: string;
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    text?: string | undefined;
+    max_words?: number | undefined;
+    add_comparison_table?: boolean | undefined;
+}>;
+export type RewriteForGeoInput = z.infer<typeof rewriteForGeoInputSchema>;
+export interface RewriteGeoResult {
+    rewritten_text: string;
+    schema_additions: string;
+    changes_made: string[];
+    before_score: number;
+    after_score: number;
+    entities_added: string[];
+    mode: "sampling" | "prompt_template";
+}
+export declare function rewriteForGeo(input: RewriteForGeoInput, hostDelays?: HostDelayMap, robotsCache?: Map<string, string>, server?: McpServer): Promise<RewriteGeoResult>;
+//# sourceMappingURL=rewrite-for-geo.d.ts.map

package/dist/tools/rewrite-for-geo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite-for-geo.d.ts","sourceRoot":"","sources":["../../src/tools/rewrite-for-geo.ts"],"names":[],"mappings":"AAGA,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,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWjC,CAAC;AAEL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAAC;CACtC;AAiBD,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,EACzB,UAAU,CAAC,EAAE,YAAY,EACzB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAsG3B"}

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

@@ -0,0 +1,115 @@
+// Tool: rewrite_for_geo
+// Rewrites content for Generative Engine Optimization (entity-rich, synthesis-ready structure).
+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 rewriteForGeoInputSchema = z
+    .object({
+    url: z.string().url().optional(),
+    text: z.string().optional(),
+    target_query: z.string(),
+    add_comparison_table: z.boolean().optional().default(false),
+    max_words: z.number().int().min(100).max(5000).optional().default(1500),
+    respect_robots: z.boolean().optional().default(true),
+})
+    .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.
+
+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 ?? "";
+    if (input.url) {
+        const result = await politeFetch(input.url, {
+            respectRobots: input.respect_robots,
+            hostDelays,
+            robotsCache,
+        });
+        const body = parseBody(result.body, input.url);
+        originalText = body.bodyText.substring(0, 8000);
+    }
+    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
+- entities_added: array of entity names you defined or linked`;
+    if (server) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore - sampling API availability varies by client
+            const samplingResult = await server.server.request({
+                method: "sampling/createMessage",
+                params: {
+                    messages: [{ role: "user", content: { type: "text", text: userMessage } }],
+                    systemPrompt: GEO_SYSTEM_PROMPT,
+                    maxTokens: 4096,
+                },
+            }, 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            {});
+            const text = samplingResult?.content?.text ?? samplingResult?.content?.[0]?.text ?? "";
+            if (text) {
+                try {
+                    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);
+                    const afterResult = await scoreCitationWorthiness({ text: parsed.rewritten_text, target_query: input.target_query, respect_robots: false }, hostDelays, robotsCache);
+                    return {
+                        rewritten_text: parsed.rewritten_text,
+                        schema_additions: parsed.schema_additions,
+                        changes_made: parsed.changes_made ?? [],
+                        before_score,
+                        after_score: afterResult.overall_score,
+                        entities_added: parsed.entities_added ?? [],
+                        mode: "sampling",
+                    };
+                }
+                catch {
+                    // fall through to prompt template
+                }
+            }
+        }
+        catch {
+            // sampling unavailable
+        }
+    }
+    const promptTemplate = `${GEO_SYSTEM_PROMPT}
+
+${userMessage}`;
+    return {
+        rewritten_text: promptTemplate,
+        schema_additions: "",
+        changes_made: [
+            "sampling/createMessage unavailable - returned prompt template for manual use",
+        ],
+        before_score,
+        after_score: before_score,
+        entities_added: [],
+        mode: "prompt_template",
+    };
+}
+//# sourceMappingURL=rewrite-for-geo.js.map

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

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

package/dist/tools/score-ai-overview-eligibility.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { type HostDelayMap } from "../lib/fetch.js";
+import type { Finding } from "../types.js";
+export declare const scoreAiOverviewEligibilityInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    respect_robots: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    respect_robots: boolean;
+}, {
+    url: string;
+    respect_robots?: boolean | undefined;
+}>;
+export type ScoreAiOverviewEligibilityInput = z.infer<typeof scoreAiOverviewEligibilityInputSchema>;
+export interface AiOverviewEligibilityResult {
+    url: string;
+    overall_eligibility_score: number;
+    factors: {
+        semantic_completeness: number;
+        structured_data: number;
+        eeat_signals: number;
+        entity_density: number;
+        content_freshness: number;
+        passage_structure: number;
+        multimodal_content: number;
+    };
+    top_improvements: Array<{
+        action: string;
+        estimated_score_gain: number;
+    }>;
+    findings: Finding[];
+}
+export declare function scoreAiOverviewEligibility(input: ScoreAiOverviewEligibilityInput, hostDelays?: HostDelayMap, robotsCache?: Map<string, string>): Promise<AiOverviewEligibilityResult>;
+//# sourceMappingURL=score-ai-overview-eligibility.d.ts.map

package/dist/tools/score-ai-overview-eligibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-ai-overview-eligibility.d.ts","sourceRoot":"","sources":["../../src/tools/score-ai-overview-eligibility.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,qCAAqC;;;;;;;;;EAGhD,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB,EAAE,MAAM,CAAC;IAClC,OAAO,EAAE;QACP,qBAAqB,EAAE,MAAM,CAAC;QAC9B,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,gBAAgB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,+BAA+B,EACtC,UAAU,CAAC,EAAE,YAAY,EACzB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,2BAA2B,CAAC,CAqLtC"}

package/dist/tools/score-ai-overview-eligibility.js

@@ -0,0 +1,186 @@
+// Tool: score_ai_overview_eligibility
+// Scores a page's probability of appearing in Google AI Overviews using correlation factors.
+import { z } from "zod";
+import { politeFetch } from "../lib/fetch.js";
+import { parseHead, parseBody } from "../lib/html.js";
+import { parseJsonLd, getAllSchemaTypes } from "../lib/schema.js";
+import { freshnessScore } from "../lib/score.js";
+export const scoreAiOverviewEligibilityInputSchema = z.object({
+    url: z.string().url(),
+    respect_robots: z.boolean().optional().default(true),
+});
+export async function scoreAiOverviewEligibility(input, hostDelays, robotsCache) {
+    const result = await politeFetch(input.url, {
+        respectRobots: input.respect_robots,
+        hostDelays,
+        robotsCache,
+    });
+    const head = parseHead(result.body);
+    const body = parseBody(result.body, input.url);
+    const jsonLdBlocks = parseJsonLd(result.body);
+    const foundTypes = getAllSchemaTypes(jsonLdBlocks);
+    const findings = [];
+    // 1. Semantic completeness - count paragraphs with 100-200 words
+    const selfContainedBlocks = body.paragraphs.filter((p) => {
+        const words = p.split(/\s+/).filter((w) => w.length > 0);
+        return words.length >= 100 && words.length <= 200;
+    });
+    const semantic_completeness = Math.min(100, selfContainedBlocks.length * 25);
+    // 2. Structured data presence - tier 1 types
+    const tier1Types = ["FAQPage", "HowTo", "Article", "BlogPosting", "NewsArticle", "Organization"];
+    const tier1Found = tier1Types.filter((t) => foundTypes.includes(t));
+    const structured_data = Math.min(100, tier1Found.length * 25);
+    // 3. E-E-A-T signals: author Person, Organization, sameAs
+    let eeatScore = 30; // base
+    const hasOrg = foundTypes.includes("Organization");
+    const hasPerson = jsonLdBlocks.some((b) => b.types.includes("Person"));
+    const hasSameAs = jsonLdBlocks.some((b) => {
+        const sa = b.parsed["sameAs"];
+        return Array.isArray(sa) ? sa.length > 0 : !!sa;
+    });
+    const hasArticleWithAuthorNode = jsonLdBlocks.some((b) => b.types.some((t) => ["Article", "BlogPosting", "NewsArticle"].includes(t)) &&
+        typeof b.parsed["author"] === "object" &&
+        b.parsed["author"] !== null);
+    if (hasOrg)
+        eeatScore += 20;
+    if (hasPerson)
+        eeatScore += 20;
+    if (hasSameAs)
+        eeatScore += 15;
+    if (hasArticleWithAuthorNode)
+        eeatScore += 15;
+    const eeat_signals = Math.min(100, eeatScore);
+    // 4. Entity density - sameAs links + authoritative external hrefs
+    const authoritativeDomains = [
+        "wikipedia.org", "wikidata.org", ".gov", "linkedin.com", "twitter.com",
+        "x.com", "crunchbase.com", "bloomberg.com", "reuters.com",
+    ];
+    const sameAsCount = jsonLdBlocks.reduce((acc, b) => {
+        const sa = b.parsed["sameAs"];
+        return acc + (Array.isArray(sa) ? sa.length : sa ? 1 : 0);
+    }, 0);
+    const authExternalLinks = body.externalLinks.filter((href) => authoritativeDomains.some((d) => href.includes(d))).length;
+    const entity_density = Math.min(100, (sameAsCount + authExternalLinks) * 7);
+    // 5. Content freshness - from JSON-LD dateModified
+    let dateModified = null;
+    for (const b of jsonLdBlocks) {
+        const dm = b.parsed["dateModified"] ?? b.parsed["datePublished"];
+        if (typeof dm === "string") {
+            dateModified = dm;
+            break;
+        }
+    }
+    const content_freshness = freshnessScore(dateModified);
+    // 6. Passage structure - FAQ, comparison table, ordered list
+    const hasH3Questions = body.h3s.some((h) => h.endsWith("?"));
+    const hasFaqSchema = foundTypes.includes("FAQPage");
+    const hasFaq = hasH3Questions || hasFaqSchema;
+    const hasComparisonTable = body.tables > 0;
+    const hasOrderedList = body.orderedLists > 0;
+    let passage_structure = 0;
+    if (hasFaq)
+        passage_structure += 25;
+    if (hasComparisonTable)
+        passage_structure += 25;
+    if (hasOrderedList)
+        passage_structure += 25;
+    if (body.h2s.length >= 3)
+        passage_structure += 25; // good heading structure
+    passage_structure = Math.min(100, passage_structure);
+    // 7. Multimodal content
+    let multimodal = 0;
+    if (body.images > 0)
+        multimodal += 30;
+    if (body.videos > 0)
+        multimodal += 30;
+    if (foundTypes.includes("ImageObject"))
+        multimodal += 20;
+    if (foundTypes.includes("VideoObject"))
+        multimodal += 20;
+    const multimodal_content = Math.min(100, multimodal);
+    // Weighted score per spec:
+    // semantic_completeness 25%, structured_data 25%, passage_structure 20%,
+    // eeat_signals 15%, entity_density 10%, content_freshness 3%, multimodal_content 2%
+    const overall_eligibility_score = Math.round(semantic_completeness * 0.25 +
+        structured_data * 0.25 +
+        passage_structure * 0.20 +
+        eeat_signals * 0.15 +
+        entity_density * 0.10 +
+        content_freshness * 0.03 +
+        multimodal_content * 0.02);
+    // Top improvements
+    const improvements = [];
+    if (!hasFaqSchema) {
+        improvements.push({
+            action: "Add FAQPage JSON-LD schema with 3-5 Q&A pairs targeting sub-queries",
+            estimated_score_gain: Math.round(25 * 0.25 + 25 * 0.20), // structured_data + passage_structure
+        });
+    }
+    if (!hasArticleWithAuthorNode) {
+        improvements.push({
+            action: "Add Article JSON-LD with author as a Person node including sameAs links",
+            estimated_score_gain: Math.round(15 * 0.15),
+        });
+    }
+    if (!hasComparisonTable) {
+        improvements.push({
+            action: "Add a comparison table or step-by-step list to improve passage structure",
+            estimated_score_gain: Math.round(25 * 0.20),
+        });
+    }
+    if (semantic_completeness < 50) {
+        improvements.push({
+            action: "Expand body paragraphs to 100-200 words each for self-contained answer blocks",
+            estimated_score_gain: Math.round(50 * 0.25),
+        });
+    }
+    improvements.sort((a, b) => b.estimated_score_gain - a.estimated_score_gain);
+    const top_improvements = improvements.slice(0, 3);
+    // Key findings
+    if (!hasFaqSchema && !hasH3Questions) {
+        findings.push({
+            severity: "warning",
+            category: "structure",
+            where: "page-level",
+            message: "No FAQ structure found (no FAQPage schema and no H3 questions).",
+            fix: "Add FAQ H3 headings ending in '?' with answer paragraphs, plus FAQPage JSON-LD.",
+            estimated_impact: "high",
+        });
+    }
+    if (eeat_signals < 50) {
+        findings.push({
+            severity: "warning",
+            category: "authority",
+            where: "page-level",
+            message: "Weak E-E-A-T signals - no Organization or author Person schema found.",
+            fix: "Add Organization JSON-LD to site-wide head, and Article.author as a Person node.",
+            estimated_impact: "high",
+        });
+    }
+    if (content_freshness < 50 && dateModified) {
+        findings.push({
+            severity: "warning",
+            category: "freshness",
+            where: "Article.dateModified",
+            message: "Content appears stale (dateModified > 90 days ago).",
+            fix: "Update the page content and set dateModified to today in the Article JSON-LD.",
+            estimated_impact: "medium",
+        });
+    }
+    return {
+        url: input.url,
+        overall_eligibility_score,
+        factors: {
+            semantic_completeness,
+            structured_data,
+            eeat_signals,
+            entity_density,
+            content_freshness,
+            passage_structure,
+            multimodal_content,
+        },
+        top_improvements,
+        findings,
+    };
+}
+//# sourceMappingURL=score-ai-overview-eligibility.js.map

package/dist/tools/score-ai-overview-eligibility.js.map

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

package/dist/tools/score-citation-worthiness.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { type HostDelayMap } from "../lib/fetch.js";
+import type { Finding } from "../types.js";
+export declare const scoreCitationWorthinessInputSchema: z.ZodEffects<z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    target_query: z.ZodOptional<z.ZodString>;
+    respect_robots: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    respect_robots: boolean;
+    url?: string | undefined;
+    text?: string | undefined;
+    target_query?: string | undefined;
+}, {
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    text?: string | undefined;
+    target_query?: string | undefined;
+}>, {
+    respect_robots: boolean;
+    url?: string | undefined;
+    text?: string | undefined;
+    target_query?: string | undefined;
+}, {
+    url?: string | undefined;
+    respect_robots?: boolean | undefined;
+    text?: string | undefined;
+    target_query?: string | undefined;
+}>;
+export type ScoreCitationWorthinessInput = z.infer<typeof scoreCitationWorthinessInputSchema>;
+export interface CitationWorthinessResult {
+    overall_score: number;
+    engine_scores: {
+        perplexity: number;
+        chatgpt: number;
+        google_ai_overviews: number;
+        claude: number;
+    };
+    sub_scores: {
+        bluf_present: boolean;
+        faq_blocks: number;
+        statistic_density: number;
+        entity_clarity: number;
+        heading_question_ratio: number;
+        answer_completeness: number;
+    };
+    improvements: string[];
+    findings: Finding[];
+}
+export declare function scoreCitationWorthiness(input: ScoreCitationWorthinessInput, hostDelays?: HostDelayMap, robotsCache?: Map<string, string>): Promise<CitationWorthinessResult>;
+//# sourceMappingURL=score-citation-worthiness.d.ts.map

package/dist/tools/score-citation-worthiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-citation-worthiness.d.ts","sourceRoot":"","sources":["../../src/tools/score-citation-worthiness.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;EAS3C,CAAC;AAEL,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,EAAE;QACV,YAAY,EAAE,OAAO,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;QACvB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AA+BD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,EACnC,UAAU,CAAC,EAAE,YAAY,EACzB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,wBAAwB,CAAC,CA2HnC"}