@automatelab/citation-intelligence 0.5.0 → 0.6.0

package/README.md

@@ -38,7 +38,7 @@ The AI citation tracking market is dominated by VC-funded dashboards starting at
 
 | Tool | Purpose |
 |---|---|
-| `check_citations` | URLs cited by Perplexity / Claude / ChatGPT / Gemini / Bing for a query |
+| `check_citations` | URLs cited by Perplexity / Claude / ChatGPT / Gemini / Bing / Brave / Google AI Mode for a query |
 | `am_i_cited` | Presence + rank for a domain across a query cluster |
 | `ai_overview` | Google AI Overview presence + cited sources |
 | `cited_for` | Queries the domain has been cited for, from local cache |
@@ -50,6 +50,37 @@ The AI citation tracking market is dominated by VC-funded dashboards starting at
 | `wikipedia_mentions` | List Wikipedia articles referencing a domain (zero keys) |
 | `audit_sitemap` | Bulk `predict_citation` across every URL in a sitemap, worst-first |
 | `gsc_citation_gap` | Join Google Search Console performance with AI citation status |
+| `compete_for_query` | End-to-end competitive snapshot: your URL vs top cited competitors |
+| `citation_freshness_score` | Recency score (halflife=365d) for the pages an engine cites |
+| `cited_for_diff` | Diff of `cited_for` between two time windows for a domain |
+| `schema_audit` | Deep schema.org validation - required fields per `@type`, malformed JSON-LD |
+| `llms_txt_generator` | Generate an `llms.txt` (https://llmstxt.org) from a sitemap |
+| `answer_box_position` | Bin each citation's first mention in `raw_answer` into early/middle/late thirds |
+| `citation_provenance` | Fan a query across engines, report per-URL cross-engine consensus |
+| `citation_evidence` | Extract the cited snippet from `raw_answer` for each citation (why, not just that) |
+| `crawler_access_audit` | Verify GPTBot / ClaudeBot / PerplexityBot / CCBot / Google-Extended etc. can fetch a URL |
+| `sitemap_citation_map` | Cross-reference sitemap URLs with cached citations (inverse of audit_sitemap) |
+| `canonical_competitor_set` | Top cited domains per query, aggregated across engines |
+
+### Prompts
+
+Server-side prompt templates the client can offer end users (call via the MCP prompt list):
+
+- `audit_citation_readiness(url)` - chains `predict_citation` + `schema_audit`
+- `competitor_snapshot(query, your_url?)` - chains `canonical_competitor_set` + `compete_for_query`
+- `ai_crawler_checkup(url)` - runs `crawler_access_audit` and writes a remediation list
+- `citation_gap_analysis(domain, days?)` - drives `gsc_citation_gap` and suggests next moves
+- `sitemap_coverage_review(sitemap_url)` - runs `sitemap_citation_map` and recommends priorities
+
+### Resources
+
+Cache views the client can read or subscribe to (no tool call required):
+
+- `citation://cache/summary` - entry counts by type/engine, unique queries/URLs, oldest/newest
+- `citation://panels` - saved panels + per-panel snapshot counts
+- `citation://docs/llms-txt` - llms.txt primer (markdown)
+- `citation://docs/ai-crawlers` - AI crawlers cheatsheet (markdown)
+- `citation://domain/{domain}/cited-for` - dynamic template: citations for `{domain}`
 
 ## Quick start
 

package/dist/adapters/google-ai-mode.d.ts

@@ -0,0 +1,6 @@
+import type { AdapterResult } from "../types.js";
+export declare function googleAiModeSearch(query: string, maxResults: number, opts?: {
+    location?: string;
+    hl?: string;
+}): Promise<AdapterResult>;
+//# sourceMappingURL=google-ai-mode.d.ts.map

package/dist/adapters/google-ai-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-ai-mode.d.ts","sourceRoot":"","sources":["../../src/adapters/google-ai-mode.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,aAAa,CAAC;AAmB3D,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,aAAa,CAAC,CAgDxB"}

package/dist/adapters/google-ai-mode.js

@@ -0,0 +1,48 @@
+import { envKey } from "../lib/config.js";
+import { fetchJson, ToolFetchError } from "../lib/fetch.js";
+export async function googleAiModeSearch(query, maxResults, opts) {
+    const key = envKey("SERPAPI_KEY");
+    if (!key) {
+        throw new ToolFetchError({
+            type: "missing_key",
+            engine: "google_ai_mode",
+            env_var: "SERPAPI_KEY",
+            message: "Set SERPAPI_KEY to use the Google AI Mode engine (separate from ai_overview). Free tier at https://serpapi.com (100 searches/month).",
+        });
+    }
+    const params = new URLSearchParams({
+        engine: "google_ai_mode",
+        q: query,
+        api_key: key,
+        hl: opts?.hl ?? "en",
+    });
+    if (opts?.location)
+        params.set("location", opts.location);
+    const res = await fetchJson(`https://serpapi.com/search?${params.toString()}`);
+    const block = res.ai_mode ?? res;
+    const textParts = [];
+    for (const t of block.text_blocks ?? []) {
+        const s = t.text ?? t.snippet;
+        if (s)
+            textParts.push(s);
+    }
+    const citations = [];
+    const seen = new Set();
+    for (const ref of block.references ?? []) {
+        if (!ref.link || seen.has(ref.link))
+            continue;
+        seen.add(ref.link);
+        citations.push({
+            url: ref.link,
+            title: ref.title,
+            rank: citations.length + 1,
+        });
+        if (citations.length >= maxResults)
+            break;
+    }
+    return {
+        citations,
+        raw_answer: textParts.join("\n\n") || undefined,
+    };
+}
+//# sourceMappingURL=google-ai-mode.js.map

package/dist/adapters/google-ai-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-ai-mode.js","sourceRoot":"","sources":["../../src/adapters/google-ai-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAoB5D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAa,EACb,UAAkB,EAClB,IAAyC;IAEzC,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,cAAc,CAAC;YACvB,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,aAAa;YACtB,OAAO,EACL,sIAAsI;SACzI,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,MAAM,EAAE,gBAAgB;QACxB,CAAC,EAAE,KAAK;QACR,OAAO,EAAE,GAAG;QACZ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,IAAI;KACrB,CAAC,CAAC;IACH,IAAI,IAAI,EAAE,QAAQ;QAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE1D,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,8BAA8B,MAAM,CAAC,QAAQ,EAAE,EAAE,CAClD,CAAC;IAEF,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;IACjC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnB,SAAS,CAAC,IAAI,CAAC;YACb,GAAG,EAAE,GAAG,CAAC,IAAI;YACb,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;SAC3B,CAAC,CAAC;QACH,IAAI,SAAS,CAAC,MAAM,IAAI,UAAU;YAAE,MAAM;IAC5C,CAAC;IAED,OAAO;QACL,SAAS;QACT,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS;KAChD,CAAC;AACJ,CAAC"}

package/dist/adapters/openai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,aAAa,CAAC;AAmB3D,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAsDxB"}
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,aAAa,CAAC;AAmB3D,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAqDxB"}

package/dist/adapters/openai.js

@@ -1,7 +1,7 @@
 import { envKey } from "../lib/config.js";
 import { fetchJson, ToolFetchError } from "../lib/fetch.js";
 import { log } from "../lib/log.js";
-const DEFAULT_OPENAI_MODEL = "gpt-4.1-mini";
+const OPENAI_MODEL = "gpt-4o-mini";
 export async function openaiSearch(query, maxResults) {
     const key = envKey("OPENAI_API_KEY");
     if (!key) {
@@ -12,10 +12,9 @@ export async function openaiSearch(query, maxResults) {
             message: "Set OPENAI_API_KEY to use the ChatGPT engine. Get a key at https://platform.openai.com.",
         });
     }
-    const model = envKey("OPENAI_MODEL") ?? DEFAULT_OPENAI_MODEL;
-    log.debug("openai web_search", { model });
+    log.debug("openai web_search", { model: OPENAI_MODEL });
     const body = JSON.stringify({
-        model,
+        model: OPENAI_MODEL,
         tools: [{ type: "web_search_preview" }],
         input: query,
     });

package/dist/adapters/openai.js.map

@@ -1 +1 @@
-{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGpC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAiB5C,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAa,EACb,UAAkB;IAElB,MAAM,GAAG,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,cAAc,CAAC;YACvB,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,gBAAgB;YACzB,OAAO,EACL,yFAAyF;SAC5F,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,oBAAoB,CAAC;IAC7D,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,KAAK;QACL,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QACvC,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,qCAAqC,EACrC;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,GAAG,EAAE;YAC9B,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI;KACL,CACF,CAAC;IAEF,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,IAAI;gBAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/D,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;gBACtC,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;oBAC9D,SAAS;gBACX,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClB,SAAS,CAAC,IAAI,CAAC;oBACb,GAAG,EAAE,GAAG,CAAC,GAAG;oBACZ,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;iBAC3B,CAAC,CAAC;gBACH,IAAI,SAAS,CAAC,MAAM,IAAI,UAAU;oBAAE,MAAM;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;AACtE,CAAC"}
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGpC,MAAM,YAAY,GAAG,aAAa,CAAC;AAiBnC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAa,EACb,UAAkB;IAElB,MAAM,GAAG,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,cAAc,CAAC;YACvB,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,gBAAgB;YACzB,OAAO,EACL,yFAAyF;SAC5F,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;QACvC,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,qCAAqC,EACrC;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,GAAG,EAAE;YAC9B,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI;KACL,CACF,CAAC;IAEF,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,IAAI;gBAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/D,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;gBACtC,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;oBAC9D,SAAS;gBACX,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClB,SAAS,CAAC,IAAI,CAAC;oBACb,GAAG,EAAE,GAAG,CAAC,GAAG;oBACZ,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC;iBAC3B,CAAC,CAAC;gBACH,IAAI,SAAS,CAAC,MAAM,IAAI,UAAU;oBAAE,MAAM;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;AACtE,CAAC"}

package/dist/index.js

@@ -22,11 +22,17 @@ import { schemaAudit, schemaAuditInputSchema } from "./tools/schema-audit.js";
 import { llmsTxtGenerator, llmsTxtGeneratorInputSchema } from "./tools/llms-txt-generator.js";
 import { answerBoxPosition, answerBoxPositionInputSchema } from "./tools/answer-box-position.js";
 import { citationProvenance, citationProvenanceInputSchema } from "./tools/citation-provenance.js";
+import { citationEvidence, citationEvidenceInputSchema } from "./tools/citation-evidence.js";
+import { crawlerAccessAudit, crawlerAccessAuditInputSchema } from "./tools/crawler-access-audit.js";
+import { sitemapCitationMap, sitemapCitationMapInputSchema } from "./tools/sitemap-citation-map.js";
+import { canonicalCompetitorSet, canonicalCompetitorSetInputSchema } from "./tools/canonical-competitor-set.js";
+import { registerPrompts } from "./prompts.js";
+import { registerResources } from "./resources.js";
 import { ToolFetchError } from "./lib/fetch.js";
 import { log } from "./lib/log.js";
 const server = new McpServer({
     name: "@automatelab/citation-intelligence",
-    version: "0.5.0",
+    version: "0.6.0",
 });
 function toolError(err) {
     return {
@@ -126,10 +132,28 @@ server.registerTool("citation_provenance", {
     description: "Fan a query out across multiple AI engines and report per-URL cross-engine consensus. Returns each unique cited URL with the list of engines that cited it, plus a consensus_urls list (URLs cited by ALL engines). High engine_count = strong cross-engine citation signal; engine_count=1 = engine-specific.",
     inputSchema: citationProvenanceInputSchema,
 }, (args) => wrapHandler(() => citationProvenance(args)));
+server.registerTool("citation_evidence", {
+    description: "Extract the cited snippet from the AI engine's raw answer for each citation. Calls check_citations, then for each returned URL finds the first mention in raw_answer and returns a context window plus the nearest quoted span or containing sentence. Use to see *why* an engine cited a URL, not just *that* it did. Returns 'not found' for engines without raw_answer (Bing, Brave).",
+    inputSchema: citationEvidenceInputSchema,
+}, (args) => wrapHandler(() => citationEvidence(args)));
+server.registerTool("crawler_access_audit", {
+    description: "Verify that major AI crawlers (GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot, CCBot, Google-Extended, Applebot-Extended, Bytespider, Meta-ExternalAgent, plus real-time fetch UAs) can fetch a URL. Parses robots.txt and does a live GET with each bot's User-Agent. Surfaces robots.txt blocks AND UA-based gating that breaks AI citation.",
+    inputSchema: crawlerAccessAuditInputSchema,
+}, (args) => wrapHandler(() => crawlerAccessAudit(args)));
+server.registerTool("sitemap_citation_map", {
+    description: "Cross-reference a sitemap with the citation cache. For each sitemap URL, reports whether it appears in cached citations (and how many queries/engines cited it). Inverse of audit_sitemap: not 'how citable is each URL', but 'has each URL actually been cited yet'. Cache must be primed via check_citations or run_panel first.",
+    inputSchema: sitemapCitationMapInputSchema,
+}, (args) => wrapHandler(() => sitemapCitationMap(args)));
+server.registerTool("canonical_competitor_set", {
+    description: "Fan a query across engines and aggregate citations by registered domain (not URL). Returns top competitor domains ranked by cross-engine consensus, with per-engine breakdown and top URLs per domain. Use to identify the canonical competitor set for a query - the domains every engine treats as authoritative.",
+    inputSchema: canonicalCompetitorSetInputSchema,
+}, (args) => wrapHandler(() => canonicalCompetitorSet(args)));
+registerPrompts(server);
+registerResources(server);
 const transport = new StdioServerTransport();
 await server.connect(transport);
 log.info("server ready on stdio", {
-    version: "0.5.0",
+    version: "0.6.0",
     log_level: log.level(),
     tools: [
         "check_citations",
@@ -151,6 +175,24 @@ log.info("server ready on stdio", {
         "llms_txt_generator",
         "answer_box_position",
         "citation_provenance",
+        "citation_evidence",
+        "crawler_access_audit",
+        "sitemap_citation_map",
+        "canonical_competitor_set",
+    ],
+    prompts: [
+        "audit_citation_readiness",
+        "competitor_snapshot",
+        "ai_crawler_checkup",
+        "citation_gap_analysis",
+        "sitemap_coverage_review",
+    ],
+    resources: [
+        "citation://cache/summary",
+        "citation://panels",
+        "citation://docs/llms-txt",
+        "citation://docs/ai-crawlers",
+        "citation://domain/{domain}/cited-for",
     ],
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/prompts.d.ts

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

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuKvD"}

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