@automatelab/citation-intelligence 0.5.1 → 0.7.0

package/dist/prompts.js

@@ -0,0 +1,137 @@
+// Prompt templates exposed via MCP. Each prompt returns one or more user
+// messages that guide the calling LLM to run a coherent sequence of this
+// server's tools - so a client doesn't have to know which tools to chain.
+import { z } from "zod";
+function userMessage(text) {
+    return { role: "user", content: { type: "text", text } };
+}
+export function registerPrompts(server) {
+    server.registerPrompt("audit_citation_readiness", {
+        title: "Audit citation readiness",
+        description: "Score a URL's citation likelihood across public signals, then deep-validate its schema.org markup, then list the top fixes. Uses predict_citation + schema_audit.",
+        argsSchema: {
+            url: z.string().describe("The page URL to audit."),
+        },
+    }, ({ url }) => ({
+        description: `Citation readiness audit for ${url}`,
+        messages: [
+            userMessage([
+                `Audit the citation readiness of ${url}.`,
+                ``,
+                `1. Call predict_citation with url="${url}" to get the public-signal score, grade, and ranked fixes.`,
+                `2. Call schema_audit with url="${url}" to deep-validate any JSON-LD / microdata and surface missing required fields.`,
+                `3. Summarize the result as:`,
+                `   - one-sentence verdict`,
+                `   - top 3 fixes (by impact)`,
+                `   - quick-wins (anything cheap that lifts score by >=5)`,
+                ``,
+                `Do not call any other tools. Do not invent fixes that predict_citation didn't surface.`,
+            ].join("\n")),
+        ],
+    }));
+    server.registerPrompt("competitor_snapshot", {
+        title: "Competitor citation snapshot",
+        description: "Build a cross-engine competitor map for a query and compare your own URL to the top-cited competitors. Uses canonical_competitor_set + compete_for_query.",
+        argsSchema: {
+            query: z.string().describe("The search query to analyze."),
+            your_url: z
+                .string()
+                .optional()
+                .describe("Your URL to benchmark against the competitor set. Optional."),
+        },
+    }, ({ query, your_url }) => ({
+        description: `Competitor snapshot for "${query}"`,
+        messages: [
+            userMessage([
+                `Build a competitor citation snapshot for the query: "${query}".`,
+                ``,
+                `1. Call canonical_competitor_set with query="${query}" to get the top cited domains across engines (sorted by cross-engine consensus).`,
+                your_url
+                    ? `2. Call compete_for_query with query="${query}" and your_url="${your_url}" to score your URL against the top competitors.`
+                    : `2. (Skipped - no your_url provided.) If you want a head-to-head score, ask the user for the URL to benchmark.`,
+                `3. Report:`,
+                `   - 3-5 sentence narrative: who dominates this query, how much consensus, where the gaps are`,
+                `   - top 5 competitor domains with engine_count + sample URLs`,
+                your_url
+                    ? `   - your URL's score vs the competitor average, and the largest signal gap`
+                    : `   - n/a (no your_url)`,
+                ``,
+                `Do not call check_citations directly - the two tools above already fan out.`,
+            ].join("\n")),
+        ],
+    }));
+    server.registerPrompt("ai_crawler_checkup", {
+        title: "AI crawler access checkup",
+        description: "Verify that all major AI crawlers (GPTBot, ClaudeBot, PerplexityBot, CCBot, Google-Extended, etc.) can fetch a URL and aren't being blocked at robots.txt or the server. Uses crawler_access_audit.",
+        argsSchema: {
+            url: z.string().describe("The page URL to check crawler access for."),
+        },
+    }, ({ url }) => ({
+        description: `AI crawler access check for ${url}`,
+        messages: [
+            userMessage([
+                `Check whether AI crawlers can fetch ${url}.`,
+                ``,
+                `1. Call crawler_access_audit with url="${url}" (default bot list, fetch_with_ua=true).`,
+                `2. Report:`,
+                `   - which bots are 'allowed' vs 'blocked'`,
+                `   - any robots.txt rules that block citation-relevant bots`,
+                `   - any UA-based gating (allowed in robots, but the server 4xx/5xx'd under the bot's UA)`,
+                `   - one concrete action item per blocked bot (e.g. "remove Disallow: / for GPTBot from robots.txt")`,
+                ``,
+                `If any consumer-facing AI engine bot (GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot) is blocked, surface it as a citation-blocking risk.`,
+            ].join("\n")),
+        ],
+    }));
+    server.registerPrompt("citation_gap_analysis", {
+        title: "Find queries with high Google rank but no AI citation",
+        description: "Surface queries where a domain ranks well on Google but isn't cited by AI engines - the closest editorial wins. Uses gsc_citation_gap.",
+        argsSchema: {
+            domain: z.string().describe("Your domain, e.g. 'automatelab.tech'."),
+            days: z
+                .string()
+                .optional()
+                .describe("Window in days for GSC data (default: 28)."),
+        },
+    }, ({ domain, days }) => ({
+        description: `Citation gap analysis for ${domain}`,
+        messages: [
+            userMessage([
+                `Find queries where ${domain} ranks well on Google but isn't cited by AI.`,
+                ``,
+                `1. Call gsc_citation_gap with domain="${domain}"${days ? ` and days=${days}` : ""}.`,
+                `2. Report the top 10 gap queries (rank <=10 on Google AND not cited by AI), with:`,
+                `   - the query`,
+                `   - Google rank + impressions`,
+                `   - the AI engine that should have cited it but didn't`,
+                `3. For the top 3, suggest the page-level fix most likely to flip the AI citation (refer to predict_citation signals).`,
+                ``,
+                `These are the highest-leverage editorial targets: traffic interest already proven, citation just missing.`,
+            ].join("\n")),
+        ],
+    }));
+    server.registerPrompt("sitemap_coverage_review", {
+        title: "Sitemap citation coverage review",
+        description: "Map a sitemap against the citation cache to see which URLs have been cited and which haven't. Identifies systemic visibility gaps. Uses sitemap_citation_map.",
+        argsSchema: {
+            sitemap_url: z.string().describe("Sitemap URL (sitemap.xml or sitemap index)."),
+        },
+    }, ({ sitemap_url }) => ({
+        description: `Sitemap citation coverage for ${sitemap_url}`,
+        messages: [
+            userMessage([
+                `Review citation coverage across the sitemap at ${sitemap_url}.`,
+                ``,
+                `1. Call sitemap_citation_map with sitemap_url="${sitemap_url}".`,
+                `2. Report:`,
+                `   - coverage_pct (mapped/total)`,
+                `   - top 5 most-cited URLs (by engine_count + citation_count)`,
+                `   - top 10 unmapped URLs that look high-value (judge by URL slug)`,
+                `3. Recommend 3 unmapped URLs to prioritize for citation-readiness audits next.`,
+                ``,
+                `Cache must be primed first - if citations_in_cache is 0, tell the user to run check_citations or run_panel for representative queries before re-running this.`,
+            ].join("\n")),
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

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

package/dist/resources.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerResources(server: McpServer): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,yCAAyC,CAAC;AA2MjD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiGzD"}

package/dist/resources.js

@@ -0,0 +1,242 @@
+// MCP resources surfaced by this server. Each resource returns cache state
+// the client can read or subscribe to without firing tool calls.
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CONFIG_DIR, CACHE_FILE } from "./lib/config.js";
+import { citedForDomain } from "./lib/cache.js";
+function asJson(uri, value) {
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: "application/json",
+                text: JSON.stringify(value, null, 2),
+            },
+        ],
+    };
+}
+async function loadCacheSummary() {
+    let size = 0;
+    let exists = false;
+    try {
+        const s = await stat(CACHE_FILE);
+        size = s.size;
+        exists = true;
+    }
+    catch {
+        // missing cache file - return empty summary
+    }
+    let entries = [];
+    if (exists) {
+        try {
+            const raw = await readFile(CACHE_FILE, "utf8");
+            const parsed = JSON.parse(raw);
+            entries = parsed.entries ?? [];
+        }
+        catch {
+            // ignore corrupt cache
+        }
+    }
+    const byType = {};
+    const byEngine = {};
+    const queries = new Set();
+    const urls = new Set();
+    let oldest = null;
+    let newest = null;
+    for (const e of entries) {
+        if (e.type)
+            byType[e.type] = (byType[e.type] ?? 0) + 1;
+        if (e.engine)
+            byEngine[e.engine] = (byEngine[e.engine] ?? 0) + 1;
+        if (e.query)
+            queries.add(e.query.toLowerCase());
+        for (const c of e.citations ?? [])
+            if (c.url)
+                urls.add(c.url);
+        for (const c of e.sources ?? [])
+            if (c.url)
+                urls.add(c.url);
+        if (e.fetched_at) {
+            if (!oldest || e.fetched_at < oldest)
+                oldest = e.fetched_at;
+            if (!newest || e.fetched_at > newest)
+                newest = e.fetched_at;
+        }
+    }
+    return {
+        cache_file: CACHE_FILE,
+        exists,
+        size_bytes: size,
+        entries_total: entries.length,
+        by_type: byType,
+        by_engine: byEngine,
+        unique_queries: queries.size,
+        unique_urls: urls.size,
+        oldest_fetched_at: oldest,
+        newest_fetched_at: newest,
+    };
+}
+async function loadPanelsList() {
+    const panelDir = join(CONFIG_DIR, "panels");
+    const snapshotDir = join(CONFIG_DIR, "snapshots");
+    const panels = [];
+    try {
+        const files = await readdir(panelDir);
+        for (const f of files.filter((f) => f.endsWith(".json"))) {
+            const name = f.slice(0, -5);
+            try {
+                const raw = await readFile(join(panelDir, f), "utf8");
+                const p = JSON.parse(raw);
+                panels.push({
+                    name,
+                    queries: p.queries?.length ?? 0,
+                    domain: p.domain,
+                    updated_at: p.updated_at,
+                });
+            }
+            catch {
+                panels.push({ name, queries: 0 });
+            }
+        }
+    }
+    catch {
+        // panels dir doesn't exist yet
+    }
+    const snapshotsByPanel = {};
+    try {
+        const panelDirs = await readdir(snapshotDir);
+        for (const p of panelDirs) {
+            try {
+                const files = await readdir(join(snapshotDir, p));
+                snapshotsByPanel[p] = files.filter((f) => f.endsWith(".json")).length;
+            }
+            catch {
+                // skip
+            }
+        }
+    }
+    catch {
+        // snapshots dir doesn't exist yet
+    }
+    return {
+        config_dir: CONFIG_DIR,
+        panels,
+        snapshots_by_panel: snapshotsByPanel,
+    };
+}
+const LLMS_TXT_PRIMER = [
+    "# llms.txt — what it is",
+    "",
+    "Proposed by llmstxt.org. A markdown file at /llms.txt that orients LLM",
+    "crawlers to your site: H1 title, short blurb, then sectioned link lists.",
+    "Distinct from robots.txt (gates) and sitemap.xml (URL enumeration) - it",
+    "tells the model *what's important*, not just *what exists*.",
+    "",
+    "## Mainstream signal status",
+    "",
+    "- OpenAI, Anthropic, Perplexity: no public statement of consumption.",
+    "- Adopters use it as a documentation / discoverability nudge.",
+    "- Generally harmless to ship; benefit > zero, cost ~ zero.",
+    "",
+    "## How this server helps",
+    "",
+    "- `llms_txt_generator` builds a draft from your sitemap.",
+    "- `audit_sitemap` ranks pages by citation-readiness before you include them.",
+    "- `predict_citation` scores any URL on the public signals (llms.txt is one).",
+    "",
+    "## Spec",
+    "",
+    "https://llmstxt.org",
+].join("\n");
+const CRAWLERS_PRIMER = [
+    "# AI crawlers cheatsheet",
+    "",
+    "## Training/index bots (robots.txt gate)",
+    "",
+    "- GPTBot — OpenAI ChatGPT training",
+    "- OAI-SearchBot — ChatGPT Search index",
+    "- ClaudeBot — Anthropic training",
+    "- PerplexityBot — Perplexity index",
+    "- CCBot — Common Crawl (feeds many LLM corpora)",
+    "- Google-Extended — robots-only opt-out token for Gemini training",
+    "- Applebot-Extended — robots-only opt-out for Apple Intelligence",
+    "- Bytespider — ByteDance Doubao",
+    "- Meta-ExternalAgent — Llama",
+    "",
+    "## Real-time fetch bots (UA gate)",
+    "",
+    "- ChatGPT-User — OpenAI on-prompt fetch",
+    "- Claude-Web — Anthropic on-prompt fetch",
+    "- Perplexity-User — Perplexity on-query fetch",
+    "",
+    "## Audit",
+    "",
+    "Use `crawler_access_audit` to verify these can each fetch a URL. Use the",
+    "`ai_crawler_checkup` prompt for an LLM-driven write-up.",
+].join("\n");
+export function registerResources(server) {
+    server.registerResource("cache_summary", "citation://cache/summary", {
+        title: "Citation cache summary",
+        description: "Aggregate counts of cached entries by type, engine, unique queries, and unique URLs. Read-only view of the local citation cache.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const summary = await loadCacheSummary();
+        return asJson(uri.toString(), summary);
+    });
+    server.registerResource("panels_list", "citation://panels", {
+        title: "Saved panels",
+        description: "List of saved query panels and per-panel snapshot counts. Mirrors track_queries action=list with snapshot context.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const panels = await loadPanelsList();
+        return asJson(uri.toString(), panels);
+    });
+    server.registerResource("llms_txt_primer", "citation://docs/llms-txt", {
+        title: "llms.txt primer",
+        description: "What llms.txt is, what it isn't, and how this server's tools help build one. Short markdown primer.",
+        mimeType: "text/markdown",
+    }, (uri) => ({
+        contents: [
+            {
+                uri: uri.toString(),
+                mimeType: "text/markdown",
+                text: LLMS_TXT_PRIMER,
+            },
+        ],
+    }));
+    server.registerResource("crawlers_primer", "citation://docs/ai-crawlers", {
+        title: "AI crawlers cheatsheet",
+        description: "Quick reference for the AI crawlers `crawler_access_audit` checks, grouped by training vs real-time fetch.",
+        mimeType: "text/markdown",
+    }, (uri) => ({
+        contents: [
+            {
+                uri: uri.toString(),
+                mimeType: "text/markdown",
+                text: CRAWLERS_PRIMER,
+            },
+        ],
+    }));
+    server.registerResource("cited_for_domain", new ResourceTemplate("citation://domain/{domain}/cited-for", {
+        list: undefined,
+    }), {
+        title: "Citations for a domain",
+        description: "Cached citations for {domain}. Returns the most recent 200 entries. Same source as cited_for tool, surfaced as a resource for clients that subscribe.",
+        mimeType: "application/json",
+    }, async (uri, variables) => {
+        const domainVar = variables.domain;
+        const domain = Array.isArray(domainVar) ? domainVar[0] : domainVar;
+        const safe = typeof domain === "string" ? domain : "";
+        const results = safe
+            ? await citedForDomain(safe, undefined, undefined, 200)
+            : [];
+        return asJson(uri.toString(), {
+            domain: safe,
+            results,
+            total: results.length,
+            source: "local_cache",
+        });
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/dist/tools/am-i-cited.d.ts

@@ -3,37 +3,100 @@ import type { Engine } from "../types.js";
 export declare const amICitedInputSchema: {
     domain: z.ZodString;
     queries: z.ZodArray<z.ZodString, "many">;
-    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "auto"]>>;
+    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
 };
 declare const inputSchema: z.ZodObject<{
     domain: z.ZodString;
     queries: z.ZodArray<z.ZodString, "many">;
-    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "auto"]>>;
+    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "google_ai_mode", "auto"]>>;
 }, "strip", z.ZodTypeAny, {
-    engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto";
+    engine: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto";
     domain: string;
     queries: string[];
 }, {
     domain: string;
     queries: string[];
-    engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto" | undefined;
+    engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode" | "auto" | undefined;
 }>;
+type PerQueryResult = {
+    query: string;
+    cited: boolean;
+    rank?: number;
+    matching_urls: string[];
+};
 export declare function amICited(input: z.infer<typeof inputSchema>): Promise<{
     domain: string;
-    engine: Engine;
+    mode: string;
+    fetched_at: string;
+    engines: never[];
+    per_engine: never[];
+    consensus: {
+        queries_cited_by_all: number;
+        queries_total: number;
+        consensus_rate: number;
+        queries?: undefined;
+    };
+    note: string;
+    engine?: undefined;
+    surface?: undefined;
+    interpretation_note?: undefined;
+    results?: undefined;
+    summary?: undefined;
+} | {
+    domain: string;
+    mode: string;
     fetched_at: string;
-    results: {
-        query: string;
-        cited: boolean;
-        rank?: number;
-        matching_urls: string[];
+    engines: {
+        engine: Engine;
+        surface: import("../types.js").Surface;
+        ok: boolean;
+        queries_cited: number;
+        citation_rate: number;
+    }[];
+    per_engine: {
+        engine: Engine;
+        surface: import("../types.js").Surface;
+        interpretation_note: string;
+        ok: boolean;
+        error: string | undefined;
+        results: PerQueryResult[];
+        summary: {
+            queries_total: number;
+            queries_cited: number;
+            citation_rate: number;
+            average_rank: number | undefined;
+        };
     }[];
+    consensus: {
+        queries_cited_by_all: number;
+        queries_total: number;
+        consensus_rate: number;
+        queries: string[];
+    };
+    note: string;
+    engine?: undefined;
+    surface?: undefined;
+    interpretation_note?: undefined;
+    results?: undefined;
+    summary?: undefined;
+} | {
+    domain: string;
+    mode: string;
+    engine: "perplexity" | "claude" | "openai" | "gemini" | "google_ai_mode";
+    surface: import("../types.js").Surface;
+    interpretation_note: string;
+    fetched_at: string;
+    results: PerQueryResult[];
     summary: {
         queries_total: number;
         queries_cited: number;
         citation_rate: number;
         average_rank: number | undefined;
     };
+    engines?: undefined;
+    per_engine?: undefined;
+    consensus?: undefined;
+    note?: undefined;
 }>;
 export {};
 //# sourceMappingURL=am-i-cited.d.ts.map

package/dist/tools/am-i-cited.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"am-i-cited.d.ts","sourceRoot":"","sources":["../../src/tools/am-i-cited.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,eAAO,MAAM,mBAAmB;;;;CAc/B,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;EAAgC,CAAC;AAoBlD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;eAKtD,MAAM;eACN,OAAO;eACP,MAAM;uBACE,MAAM,EAAE;;;;;;;;GAwC1B"}
+{"version":3,"file":"am-i-cited.d.ts","sourceRoot":"","sources":["../../src/tools/am-i-cited.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,eAAO,MAAM,mBAAmB;;;;CAiB/B,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;EAAgC,CAAC;AA+BlD,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAyBF,wBAAsB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoHhE"}