@automatelab/citation-intelligence 0.4.0

package/dist/index.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+// Citation Intelligence MCP - entrypoint.
+// All logging goes to stderr. stdout is reserved for JSON-RPC transport.
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { checkCitations, checkCitationsInputSchema, } from "./tools/check-citations.js";
+import { amICited, amICitedInputSchema } from "./tools/am-i-cited.js";
+import { aiOverview, aiOverviewInputSchema } from "./tools/ai-overview.js";
+import { citedFor, citedForInputSchema } from "./tools/cited-for.js";
+import { predictCitation, predictCitationInputSchema, } from "./tools/predict-citation.js";
+import { trackQueries, trackQueriesInputSchema } from "./tools/track-queries.js";
+import { runPanel, runPanelInputSchema } from "./tools/run-panel.js";
+import { citationTrend, citationTrendInputSchema } from "./tools/citation-trend.js";
+import { compareDomains, compareDomainsInputSchema } from "./tools/compare-domains.js";
+import { wikipediaMentions, wikipediaMentionsInputSchema } from "./tools/wikipedia-mentions.js";
+import { auditSitemap, auditSitemapInputSchema } from "./tools/audit-sitemap.js";
+import { gscCitationGap, gscCitationGapInputSchema } from "./tools/gsc-citation-gap.js";
+import { competeForQuery, competeForQueryInputSchema } from "./tools/compete-for-query.js";
+import { citationFreshnessScore, citationFreshnessScoreInputSchema } from "./tools/citation-freshness-score.js";
+import { citedForDiff, citedForDiffInputSchema } from "./tools/cited-for-diff.js";
+import { ToolFetchError } from "./lib/fetch.js";
+import { log } from "./lib/log.js";
+const server = new McpServer({
+    name: "@automatelab/citation-intelligence",
+    version: "0.4.0",
+});
+function toolError(err) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(err, null, 2) }],
+        isError: true,
+    };
+}
+function wrapHandler(handler) {
+    return handler()
+        .then((result) => ({
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        structuredContent: result,
+    }))
+        .catch((err) => {
+        if (err instanceof ToolFetchError) {
+            log.warn("tool returned ToolFetchError", err.toolError);
+            return toolError(err.toolError);
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        log.error("unhandled tool exception", { message });
+        return toolError({ type: "fetch_error", url: "", message });
+    });
+}
+server.registerTool("check_citations", {
+    description: "Return URLs cited by an AI engine (Perplexity, Claude, ChatGPT, Gemini, or Bing) for a query. Use this when an agent or user wants to see what sources an AI search engine grounds answers on. Requires at least one engine API key; auto-picks the first available.",
+    inputSchema: checkCitationsInputSchema,
+}, (args) => wrapHandler(() => checkCitations(args)));
+server.registerTool("am_i_cited", {
+    description: "Check whether a domain is cited by an AI engine across a cluster of queries. Returns per-query presence, rank, and a citation-rate summary. Use to measure visibility for a brand, product, or content site in AI search.",
+    inputSchema: amICitedInputSchema,
+}, (args) => wrapHandler(() => amICited(args)));
+server.registerTool("ai_overview", {
+    description: "Check whether Google shows an AI Overview for a query, and which URLs it cites. Uses SerpAPI (free tier: 100/month). Set SERPAPI_KEY.",
+    inputSchema: aiOverviewInputSchema,
+}, (args) => wrapHandler(() => aiOverview(args)));
+server.registerTool("cited_for", {
+    description: "List queries that the given domain has been cited for, served from the local cache. Build up a corpus by calling check_citations or am_i_cited first; cited_for queries it without spending API budget.",
+    inputSchema: citedForInputSchema,
+}, (args) => wrapHandler(() => citedFor(args)));
+server.registerTool("predict_citation", {
+    description: "Score citation likelihood for a URL from public signals (Wikipedia link presence, schema.org markup, /llms.txt, GitHub and Reddit references, canonical hygiene, HTTPS). No LLM fired - all heuristic. Returns 0-100 score, grade, signal breakdown, and ranked fixes.",
+    inputSchema: predictCitationInputSchema,
+}, (args) => wrapHandler(() => predictCitation(args)));
+server.registerTool("track_queries", {
+    description: "Save, load, or list named query panels. A panel is a persisted set of queries you want to monitor over time (e.g. editorial-watchlist). Use action=save with queries[] to create, action=load to read, action=list to enumerate. Panels live under <config>/panels/<name>.json.",
+    inputSchema: trackQueriesInputSchema,
+}, (args) => wrapHandler(() => trackQueries(args)));
+server.registerTool("run_panel", {
+    description: "Run a saved panel through am_i_cited and append a timestamped snapshot. Snapshots live under <config>/snapshots/<panel>/<iso>.json. Feeds citation_trend.",
+    inputSchema: runPanelInputSchema,
+}, (args) => wrapHandler(() => runPanel(args)));
+server.registerTool("citation_trend", {
+    description: "Report citation rate over time for a panel from stored snapshots. Returns the series of citation_rate per snapshot plus per-query deltas (gained/lost/unchanged) between first and last snapshot.",
+    inputSchema: citationTrendInputSchema,
+}, (args) => wrapHandler(() => citationTrend(args)));
+server.registerTool("compare_domains", {
+    description: "Run predict_citation on 2-10 URLs and return a side-by-side signal table plus a list of signals where the URLs diverge. Use to compare your URL to top-cited competitors for the same query.",
+    inputSchema: compareDomainsInputSchema,
+}, (args) => wrapHandler(() => compareDomains(args)));
+server.registerTool("wikipedia_mentions", {
+    description: "List Wikipedia articles that reference the given domain. Wikipedia citation is the highest-lift signal for LLM training corpora. Zero keys required.",
+    inputSchema: wikipediaMentionsInputSchema,
+}, (args) => wrapHandler(() => wikipediaMentions(args)));
+server.registerTool("audit_sitemap", {
+    description: "Fetch a sitemap.xml (or sitemap index) and run predict_citation on every URL. Returns results sorted worst-score-first. Surfaces systemic issues across a whole site in one pass. Zero engine keys needed.",
+    inputSchema: auditSitemapInputSchema,
+}, (args) => wrapHandler(() => auditSitemap(args)));
+server.registerTool("compete_for_query", {
+    description: "End-to-end competitive snapshot for a single query. Calls check_citations to get the cited URLs, then runs compare_domains on your_url vs the top cited competitors. Returns your score, the average competitor score, and the gap.",
+    inputSchema: competeForQueryInputSchema,
+}, (args) => wrapHandler(() => competeForQuery(args)));
+server.registerTool("citation_freshness_score", {
+    description: "Score how recent the pages cited for a query are. Calls check_citations, then collects dateModified for each cited URL, returns a 0-100 recency_score (halflife=365d) plus per-URL freshness bucket (fresh/current/stale/ancient/unknown). Surfaces queries where AI cites old content - opportunity to ship fresher.",
+    inputSchema: citationFreshnessScoreInputSchema,
+}, (args) => wrapHandler(() => citationFreshnessScore(args)));
+server.registerTool("cited_for_diff", {
+    description: "Diff cited_for between two time windows for a domain. Returns queries gained (cited now, not before baseline_until) and queries lost (cited before, not since current_since). Cache-only, no API spend. Use to track citation drift over time after publishing or migrating content.",
+    inputSchema: citedForDiffInputSchema,
+}, (args) => wrapHandler(() => citedForDiff(args)));
+server.registerTool("gsc_citation_gap", {
+    description: "Join Google Search Console performance with am_i_cited per query. Surfaces queries where the domain ranks well in Google but is not cited in AI - the closest editorial wins. Requires GCP service account creds (credentials_path or GOOGLE_APPLICATION_CREDENTIALS env).",
+    inputSchema: gscCitationGapInputSchema,
+}, (args) => wrapHandler(() => gscCitationGap(args)));
+const transport = new StdioServerTransport();
+await server.connect(transport);
+log.info("server ready on stdio", {
+    version: "0.4.0",
+    log_level: log.level(),
+    tools: [
+        "check_citations",
+        "am_i_cited",
+        "ai_overview",
+        "cited_for",
+        "predict_citation",
+        "track_queries",
+        "run_panel",
+        "citation_trend",
+        "compare_domains",
+        "wikipedia_mentions",
+        "audit_sitemap",
+        "gsc_citation_gap",
+        "compete_for_query",
+        "citation_freshness_score",
+        "cited_for_diff",
+    ],
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/cache.d.ts

@@ -0,0 +1,33 @@
+import type { Citation, Engine } from "../types.js";
+type CitationEntry = {
+    type: "citation_check";
+    engine: Engine;
+    query: string;
+    fetched_at: string;
+    citations: Citation[];
+    raw_answer?: string;
+};
+type AiOverviewEntry = {
+    type: "ai_overview";
+    query: string;
+    location?: string;
+    hl?: string;
+    fetched_at: string;
+    ai_overview_present: boolean;
+    ai_overview_text?: string;
+    sources: Citation[];
+};
+export type CacheEntry = CitationEntry | AiOverviewEntry;
+export declare function getCitations(query: string, engine: Engine): Promise<CitationEntry | null>;
+export declare function putCitations(entry: CitationEntry): Promise<void>;
+export declare function getAiOverview(query: string, location: string | undefined, hl: string | undefined): Promise<AiOverviewEntry | null>;
+export declare function putAiOverview(entry: AiOverviewEntry): Promise<void>;
+export declare function citedForDomain(domain: string, since: string | undefined, engineFilter: string | undefined, limit: number): Promise<Array<{
+    query: string;
+    engine: Engine;
+    rank: number;
+    fetched_at: string;
+    url: string;
+}>>;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/lib/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/lib/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpD,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;AAwCzD,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAW/B;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAYtE;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,EAAE,EAAE,MAAM,GAAG,SAAS,GACrB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAYjC;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAazE;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,KAAK,EAAE,MAAM,GACZ,OAAO,CACR,KAAK,CAAC;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC,CACH,CAkCA"}

package/dist/lib/cache.js

@@ -0,0 +1,110 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { CACHE_FILE, CACHE_TTL_DAYS, AI_OVERVIEW_TTL_DAYS } from "./config.js";
+const EMPTY = { version: 1, entries: [] };
+let memory = null;
+async function load() {
+    if (memory)
+        return memory;
+    try {
+        const raw = await readFile(CACHE_FILE, "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== 1 || !Array.isArray(parsed.entries)) {
+            memory = { ...EMPTY };
+        }
+        else {
+            memory = parsed;
+        }
+    }
+    catch {
+        memory = { ...EMPTY };
+    }
+    return memory;
+}
+async function persist() {
+    if (!memory)
+        return;
+    await mkdir(dirname(CACHE_FILE), { recursive: true });
+    await writeFile(CACHE_FILE, JSON.stringify(memory, null, 2), "utf8");
+}
+function isFresh(fetched_at, ttlDays) {
+    const t = Date.parse(fetched_at);
+    if (Number.isNaN(t))
+        return false;
+    const ageMs = Date.now() - t;
+    return ageMs < ttlDays * 86_400_000;
+}
+export async function getCitations(query, engine) {
+    const cache = await load();
+    const hit = cache.entries.find((e) => e.type === "citation_check" &&
+        e.engine === engine &&
+        e.query.toLowerCase() === query.toLowerCase());
+    if (!hit)
+        return null;
+    if (!isFresh(hit.fetched_at, CACHE_TTL_DAYS))
+        return null;
+    return hit;
+}
+export async function putCitations(entry) {
+    const cache = await load();
+    cache.entries = cache.entries.filter((e) => !(e.type === "citation_check" &&
+        e.engine === entry.engine &&
+        e.query.toLowerCase() === entry.query.toLowerCase()));
+    cache.entries.push(entry);
+    await persist();
+}
+export async function getAiOverview(query, location, hl) {
+    const cache = await load();
+    const hit = cache.entries.find((e) => e.type === "ai_overview" &&
+        e.query.toLowerCase() === query.toLowerCase() &&
+        (e.location ?? "") === (location ?? "") &&
+        (e.hl ?? "") === (hl ?? ""));
+    if (!hit)
+        return null;
+    if (!isFresh(hit.fetched_at, AI_OVERVIEW_TTL_DAYS))
+        return null;
+    return hit;
+}
+export async function putAiOverview(entry) {
+    const cache = await load();
+    cache.entries = cache.entries.filter((e) => !(e.type === "ai_overview" &&
+        e.query.toLowerCase() === entry.query.toLowerCase() &&
+        (e.location ?? "") === (entry.location ?? "") &&
+        (e.hl ?? "") === (entry.hl ?? "")));
+    cache.entries.push(entry);
+    await persist();
+}
+export async function citedForDomain(domain, since, engineFilter, limit) {
+    const cache = await load();
+    const sinceMs = since ? Date.parse(since) : 0;
+    const out = [];
+    const needle = domain.replace(/^https?:\/\//, "").replace(/\/$/, "").toLowerCase();
+    for (const e of cache.entries) {
+        if (e.type !== "citation_check")
+            continue;
+        if (engineFilter && e.engine !== engineFilter)
+            continue;
+        if (sinceMs && Date.parse(e.fetched_at) < sinceMs)
+            continue;
+        for (const c of e.citations) {
+            try {
+                const u = new URL(c.url);
+                if (u.hostname.toLowerCase().endsWith(needle)) {
+                    out.push({
+                        query: e.query,
+                        engine: e.engine,
+                        rank: c.rank,
+                        fetched_at: e.fetched_at,
+                        url: c.url,
+                    });
+                }
+            }
+            catch {
+                // skip malformed URLs
+            }
+        }
+    }
+    out.sort((a, b) => b.fetched_at.localeCompare(a.fetched_at));
+    return out.slice(0, limit);
+}
+//# sourceMappingURL=cache.js.map

package/dist/lib/cache.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,6 @@
+export declare const CONFIG_DIR: string;
+export declare const CACHE_FILE: string;
+export declare const CACHE_TTL_DAYS: number;
+export declare const AI_OVERVIEW_TTL_DAYS: number;
+export declare function envKey(name: string): string | undefined;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,QAE8B,CAAC;AAEtD,eAAO,MAAM,UAAU,QAAiC,CAAC;AAEzD,eAAO,MAAM,cAAc,QAE1B,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAEhC,CAAC;AAEF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGvD"}

package/dist/lib/config.js

@@ -0,0 +1,12 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const CONFIG_DIR = process.env.CITATION_CONFIG_DIR ??
+    join(homedir(), ".config", "citation-intelligence");
+export const CACHE_FILE = join(CONFIG_DIR, "cache.json");
+export const CACHE_TTL_DAYS = Number(process.env.CITATION_CACHE_TTL_DAYS ?? "7");
+export const AI_OVERVIEW_TTL_DAYS = Number(process.env.CITATION_AI_OVERVIEW_TTL_DAYS ?? "1");
+export function envKey(name) {
+    const v = process.env[name];
+    return v && v.trim().length > 0 ? v.trim() : undefined;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,UAAU,GACrB,OAAO,CAAC,GAAG,CAAC,mBAAmB;IAC/B,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAClC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,GAAG,CAC3C,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CACxC,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,GAAG,CACjD,CAAC;AAEF,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC"}

package/dist/lib/fetch.d.ts

@@ -0,0 +1,18 @@
+import type { ToolError } from "../types.js";
+export declare class ToolFetchError extends Error {
+    toolError: ToolError;
+    constructor(toolError: ToolError);
+}
+export type FetchOpts = {
+    method?: "GET" | "POST";
+    headers?: Record<string, string>;
+    body?: string;
+    timeoutMs?: number;
+};
+export declare function fetchJson<T = unknown>(url: string, opts?: FetchOpts): Promise<T>;
+export declare function fetchText(url: string, opts?: FetchOpts): Promise<{
+    text: string;
+    status: number;
+    finalUrl: string;
+}>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/lib/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/lib/fetch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAS,EAAE,SAAS,CAAC;gBACT,SAAS,EAAE,SAAS;CAIjC;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAsB,SAAS,CAAC,CAAC,GAAG,OAAO,EACzC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC,CAAC,CAAC,CAsCZ;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,SAAc,GACnB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB7D"}

package/dist/lib/fetch.js

@@ -0,0 +1,75 @@
+import { request } from "undici";
+export class ToolFetchError extends Error {
+    toolError;
+    constructor(toolError) {
+        super(toolError.message);
+        this.toolError = toolError;
+    }
+}
+export async function fetchJson(url, opts = {}) {
+    const { method = "GET", headers = {}, body, timeoutMs = 30_000 } = opts;
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    try {
+        const res = await request(url, {
+            method,
+            headers: { "user-agent": "citation-intelligence-mcp/0.1", ...headers },
+            body,
+            signal: ac.signal,
+        });
+        const text = await res.body.text();
+        if (res.statusCode >= 400) {
+            throw new ToolFetchError({
+                type: "fetch_error",
+                url,
+                status: res.statusCode,
+                message: `${res.statusCode}: ${text.slice(0, 500)}`,
+            });
+        }
+        if (!text)
+            return undefined;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new ToolFetchError({
+                type: "fetch_error",
+                url,
+                status: res.statusCode,
+                message: `non-JSON response: ${text.slice(0, 200)}`,
+            });
+        }
+    }
+    catch (err) {
+        if (err instanceof ToolFetchError)
+            throw err;
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new ToolFetchError({ type: "fetch_error", url, message: msg });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function fetchText(url, opts = {}) {
+    const { method = "GET", headers = {}, body, timeoutMs = 30_000 } = opts;
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    try {
+        const res = await request(url, {
+            method,
+            headers: { "user-agent": "citation-intelligence-mcp/0.1", ...headers },
+            body,
+            signal: ac.signal,
+        });
+        const text = await res.body.text();
+        return { text, status: res.statusCode, finalUrl: url };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new ToolFetchError({ type: "fetch_error", url, message: msg });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/dist/lib/fetch.js.map

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

package/dist/lib/log.d.ts

@@ -0,0 +1,11 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+declare function resolveLevel(): LogLevel;
+export declare const log: {
+    debug: (msg: string, extra?: unknown) => void;
+    info: (msg: string, extra?: unknown) => void;
+    warn: (msg: string, extra?: unknown) => void;
+    error: (msg: string, extra?: unknown) => void;
+    level: typeof resolveLevel;
+};
+export {};
+//# sourceMappingURL=log.d.ts.map

package/dist/lib/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAS3D,iBAAS,YAAY,IAAI,QAAQ,CAIhC;AAkBD,eAAO,MAAM,GAAG;iBACD,MAAM,UAAU,OAAO;gBACxB,MAAM,UAAU,OAAO;gBACvB,MAAM,UAAU,OAAO;iBACtB,MAAM,UAAU,OAAO;;CAErC,CAAC"}

package/dist/lib/log.js

@@ -0,0 +1,37 @@
+// Stderr logger. stdout is reserved for JSON-RPC transport.
+// Level controlled by CITATION_LOG_LEVEL env var: debug | info | warn | error (default: info).
+const LEVELS = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+function resolveLevel() {
+    const raw = (process.env.CITATION_LOG_LEVEL ?? "info").toLowerCase();
+    if (raw === "debug" || raw === "info" || raw === "warn" || raw === "error")
+        return raw;
+    return "info";
+}
+const TAG = "[citation-intelligence]";
+function emit(level, msg, extra) {
+    if (LEVELS[level] < LEVELS[resolveLevel()])
+        return;
+    const line = extra === undefined ? `${TAG} ${level}: ${msg}` : `${TAG} ${level}: ${msg} ${safeJson(extra)}`;
+    process.stderr.write(line + "\n");
+}
+function safeJson(v) {
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+export const log = {
+    debug: (msg, extra) => emit("debug", msg, extra),
+    info: (msg, extra) => emit("info", msg, extra),
+    warn: (msg, extra) => emit("warn", msg, extra),
+    error: (msg, extra) => emit("error", msg, extra),
+    level: resolveLevel,
+};
+//# sourceMappingURL=log.js.map

package/dist/lib/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,+FAA+F;AAI/F,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,GAAG,CAAC;IACvF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,GAAG,GAAG,yBAAyB,CAAC;AAEtC,SAAS,IAAI,CAAC,KAAe,EAAE,GAAW,EAAE,KAAe;IACzD,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QAAE,OAAO;IACnD,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,KAAK,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5G,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,KAAK,EAAE,CAAC,GAAW,EAAE,KAAe,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC;IAClE,IAAI,EAAE,CAAC,GAAW,EAAE,KAAe,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC;IAChE,IAAI,EAAE,CAAC,GAAW,EAAE,KAAe,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC;IAChE,KAAK,EAAE,CAAC,GAAW,EAAE,KAAe,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC;IAClE,KAAK,EAAE,YAAY;CACpB,CAAC"}

package/dist/lib/panels.d.ts

@@ -0,0 +1,30 @@
+export type Panel = {
+    name: string;
+    queries: string[];
+    domain?: string;
+    created_at: string;
+    updated_at: string;
+};
+export type Snapshot = {
+    panel: string;
+    domain: string;
+    engine: string;
+    taken_at: string;
+    per_query: Array<{
+        query: string;
+        cited: boolean;
+        rank?: number;
+        matching_urls: string[];
+    }>;
+    summary: {
+        queries_total: number;
+        queries_cited: number;
+        citation_rate: number;
+    };
+};
+export declare function savePanel(panel: Panel): Promise<void>;
+export declare function loadPanel(name: string): Promise<Panel | null>;
+export declare function listPanels(): Promise<string[]>;
+export declare function appendSnapshot(snap: Snapshot): Promise<string>;
+export declare function readSnapshots(panel: string, since?: string): Promise<Snapshot[]>;
+//# sourceMappingURL=panels.d.ts.map

package/dist/lib/panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../../src/lib/panels.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC,CAAC;IACH,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAiBF,wBAAsB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3D;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAOnE;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAOpD;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpE;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoBrB"}

package/dist/lib/panels.js

@@ -0,0 +1,69 @@
+import { mkdir, readFile, writeFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { CONFIG_DIR } from "./config.js";
+const PANEL_DIR = join(CONFIG_DIR, "panels");
+const SNAPSHOT_DIR = join(CONFIG_DIR, "snapshots");
+function panelFile(name) {
+    return join(PANEL_DIR, `${sanitize(name)}.json`);
+}
+function snapshotDir(name) {
+    return join(SNAPSHOT_DIR, sanitize(name));
+}
+function sanitize(name) {
+    return name.replace(/[^a-z0-9_-]/gi, "_").toLowerCase();
+}
+export async function savePanel(panel) {
+    await mkdir(PANEL_DIR, { recursive: true });
+    await writeFile(panelFile(panel.name), JSON.stringify(panel, null, 2), "utf8");
+}
+export async function loadPanel(name) {
+    try {
+        const raw = await readFile(panelFile(name), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function listPanels() {
+    try {
+        const files = await readdir(PANEL_DIR);
+        return files.filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5));
+    }
+    catch {
+        return [];
+    }
+}
+export async function appendSnapshot(snap) {
+    const dir = snapshotDir(snap.panel);
+    await mkdir(dir, { recursive: true });
+    const filename = `${snap.taken_at.replace(/[:.]/g, "-")}.json`;
+    const path = join(dir, filename);
+    await writeFile(path, JSON.stringify(snap, null, 2), "utf8");
+    return path;
+}
+export async function readSnapshots(panel, since) {
+    const dir = snapshotDir(panel);
+    let files = [];
+    try {
+        files = await readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    const snapshots = [];
+    for (const f of files.filter((f) => f.endsWith(".json")).sort()) {
+        try {
+            const raw = await readFile(join(dir, f), "utf8");
+            const snap = JSON.parse(raw);
+            if (since && snap.taken_at < since)
+                continue;
+            snapshots.push(snap);
+        }
+        catch {
+            // ignore corrupt snapshot
+        }
+    }
+    return snapshots;
+}
+//# sourceMappingURL=panels.js.map

package/dist/lib/panels.js.map

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

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

@@ -0,0 +1,29 @@
+import { z } from "zod";
+export declare const aiOverviewInputSchema: {
+    query: z.ZodString;
+    location: z.ZodOptional<z.ZodString>;
+    hl: z.ZodDefault<z.ZodString>;
+};
+declare const inputSchema: z.ZodObject<{
+    query: z.ZodString;
+    location: z.ZodOptional<z.ZodString>;
+    hl: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    hl: string;
+    location?: string | undefined;
+}, {
+    query: string;
+    hl?: string | undefined;
+    location?: string | undefined;
+}>;
+export declare function aiOverview(input: z.infer<typeof inputSchema>): Promise<{
+    query: string;
+    fetched_at: string;
+    ai_overview_present: boolean;
+    ai_overview_text: string | undefined;
+    sources: import("../types.js").Citation[];
+    cached: boolean;
+}>;
+export {};
+//# sourceMappingURL=ai-overview.d.ts.map