geo-ai-search-optimization 1.4.2 → 2.2.0

package/src/citation-monitor.js

@@ -0,0 +1,86 @@
+import { checkCitation } from "./citation-check.js";
+import { saveSnapshot, listSnapshots, loadSnapshot } from "./snapshot.js";
+import { writeScanOutput } from "./scan.js";
+
+export async function monitorCitations(siteUrl, queries, options = {}) {
+  const result = await checkCitation(siteUrl, queries, {
+    engines: options.engines
+  });
+
+  const monitorResult = {
+    kind: "geo-citation-monitor",
+    siteUrl: result.siteUrl,
+    domain: result.domain,
+    queries: result.queries,
+    engines: result.engines,
+    foundRate: result.foundRate,
+    foundCount: result.foundCount,
+    totalChecks: result.totalChecks,
+    results: result.results,
+    savedAt: new Date().toISOString(),
+    previousFoundRate: null,
+    foundRateDelta: null
+  };
+
+  // Try to load previous citation snapshot for comparison
+  const dataDir = options.dataDir || undefined;
+  const snapshots = await listSnapshots(dataDir);
+  const citationSnapshots = [];
+
+  for (const snap of snapshots) {
+    try {
+      const data = await loadSnapshot(snap.path);
+      if (data.kind === "geo-citation-monitor" || data.kind === "geo-citation-check") {
+        citationSnapshots.push(data);
+      }
+    } catch {
+      // skip invalid
+    }
+  }
+
+  if (citationSnapshots.length > 0) {
+    const previous = citationSnapshots[citationSnapshots.length - 1];
+    monitorResult.previousFoundRate = previous.foundRate;
+    monitorResult.foundRateDelta = monitorResult.foundRate - previous.foundRate;
+  }
+
+  if (options.save) {
+    await saveSnapshot(monitorResult, { dataDir });
+  }
+
+  monitorResult.summary = monitorResult.foundRateDelta !== null
+    ? `当前引用率 ${monitorResult.foundRate}%（变化 ${monitorResult.foundRateDelta >= 0 ? "+" : ""}${monitorResult.foundRateDelta}%）。`
+    : `当前引用率 ${monitorResult.foundRate}%（无历史数据可比较）。`;
+
+  return monitorResult;
+}
+
+export function renderCitationMonitorMarkdown(report) {
+  const lines = [
+    "# GEO 引用监控",
+    "",
+    `- 网站：\`${report.siteUrl}\``,
+    `- 引用率：\`${report.foundRate}%\`（${report.foundCount}/${report.totalChecks}）`,
+    ""
+  ];
+
+  if (report.previousFoundRate !== null) {
+    lines.push(`- 上次引用率：\`${report.previousFoundRate}%\``);
+    lines.push(`- 变化：\`${report.foundRateDelta >= 0 ? "+" : ""}${report.foundRateDelta}%\``);
+    lines.push("");
+  }
+
+  lines.push(report.summary, "");
+
+  lines.push("## 详细结果", "", "| 查询 | 引擎 | 引用 |", "|------|------|------|");
+  for (const r of report.results) {
+    lines.push(`| ${r.query} | ${r.engine} | ${r.found ? "✓" : "✗"} |`);
+  }
+
+  lines.push("");
+  return lines.join("\n");
+}
+
+export async function writeCitationMonitorOutput(outputPath, content) {
+  return writeScanOutput(outputPath, content);
+}