@rankcli/agent-runtime 0.0.13 → 0.0.15

package/dist/index.js

@@ -239,7 +239,7 @@ async function crawlUrl(params) {
 async function extractMeta(params) {
   const { html, url } = params;
   try {
-    const $ = cheerio62.load(html);
+    const $ = cheerio63.load(html);
     const meta = {
       title: $("title").text().trim() || void 0,
       description: $('meta[name="description"]').attr("content")?.trim(),
@@ -284,7 +284,7 @@ async function extractMeta(params) {
 async function analyzeHeadings(params) {
   const { html } = params;
   try {
-    const $ = cheerio62.load(html);
+    const $ = cheerio63.load(html);
     const headings = [];
     $("h1, h2, h3, h4, h5, h6").each((_, el) => {
       const tag = el.tagName.toLowerCase();
@@ -305,7 +305,7 @@ async function analyzeHeadings(params) {
 async function extractImages2(params) {
   const { html } = params;
   try {
-    const $ = cheerio62.load(html);
+    const $ = cheerio63.load(html);
     const images = [];
     $("img").each((_, el) => {
       images.push({
@@ -327,7 +327,7 @@ async function extractImages2(params) {
 async function extractLinks3(params) {
   const { html, baseUrl } = params;
   try {
-    const $ = cheerio62.load(html);
+    const $ = cheerio63.load(html);
     const links = [];
     const baseHostname = new URL(baseUrl).hostname;
     $("a[href]").each((_, el) => {
@@ -362,7 +362,7 @@ async function extractLinks3(params) {
 async function extractSchema2(params) {
   const { html } = params;
   try {
-    const $ = cheerio62.load(html);
+    const $ = cheerio63.load(html);
     const schemas = [];
     $('script[type="application/ld+json"]').each((_, el) => {
       try {
@@ -431,7 +431,7 @@ async function checkSitemap2(params) {
           timeout: 1e4
         });
         if (response.status === 200 && response.data.includes("<?xml")) {
-          const $ = cheerio62.load(response.data, { xmlMode: true });
+          const $ = cheerio63.load(response.data, { xmlMode: true });
           const urlCount = $("url").length || $("sitemap").length;
           return {
             success: true,
@@ -460,12 +460,12 @@ async function checkSitemap2(params) {
     };
   }
 }
-var cheerio62;
+var cheerio63;
 var init_crawl = __esm({
   "src/tools/crawl.ts"() {
     "use strict";
     init_http();
-    cheerio62 = __toESM(require("cheerio"));
+    cheerio63 = __toESM(require("cheerio"));
   }
 });
 
@@ -862,7 +862,7 @@ function analyzeRobotsTxtForAI(robotsTxt) {
   return { allowed, blocked, recommendations };
 }
 function detectRenderingMode(html) {
-  const $ = cheerio63.load(html);
+  const $ = cheerio64.load(html);
   const signals = [];
   const hasNextData = html.includes("__NEXT_DATA__");
   const hasNuxtData = html.includes("__NUXT__");
@@ -903,7 +903,7 @@ function detectRenderingMode(html) {
   };
 }
 function analyzeContentStructure(html) {
-  const $ = cheerio63.load(html);
+  const $ = cheerio64.load(html);
   const jsonLdScripts = $('script[type="application/ld+json"]');
   let hasStructuredData = jsonLdScripts.length > 0;
   let hasFAQSchema = false;
@@ -953,7 +953,7 @@ function analyzeContentStructure(html) {
   };
 }
 function analyzeCitationReadiness(html) {
-  const $ = cheerio63.load(html);
+  const $ = cheerio64.load(html);
   const bodyText = $("body").text();
   const hasCitations = $('cite, blockquote, [class*="citation"], [class*="reference"]').length > 0 || /\[\d+\]|\(\d{4}\)/.test(bodyText);
   const externalLinks = $('a[href^="http"]').filter((_, el) => {
@@ -986,7 +986,7 @@ function analyzeCitationReadiness(html) {
   };
 }
 function analyzeEntityExtraction(html) {
-  const $ = cheerio63.load(html);
+  const $ = cheerio64.load(html);
   const bodyText = $("body").text();
   const definedTerms = [];
   $("dfn, abbr[title]").each((_, el) => {
@@ -1022,7 +1022,7 @@ function analyzeEntityExtraction(html) {
   };
 }
 function calculateLLMSignals(structure, citation, entity, html) {
-  const $ = cheerio63.load(html);
+  const $ = cheerio64.load(html);
   let contentClarity = 0;
   if (structure.headingHierarchy === "good") contentClarity += 30;
   else if (structure.headingHierarchy === "needs-work") contentClarity += 15;
@@ -1328,11 +1328,11 @@ Allow: /
 Sitemap: ${siteUrl}/sitemap.xml
 `;
 }
-var cheerio63, AI_CRAWLERS, AI_CRAWLERS_INFO;
+var cheerio64, AI_CRAWLERS, AI_CRAWLERS_INFO;
 var init_geo_analyzer = __esm({
   "src/analyzers/geo-analyzer.ts"() {
     "use strict";
-    cheerio63 = __toESM(require("cheerio"));
+    cheerio64 = __toESM(require("cheerio"));
     AI_CRAWLERS = {
       // OpenAI
       GPTBot: { userAgent: "GPTBot", company: "OpenAI", purpose: "ChatGPT training & browsing" },
@@ -1691,7 +1691,7 @@ function generateCWVIssues(lcp, fidInp, cls, ttfb, url) {
   return issues;
 }
 function analyzeCoreWebVitals(html, url, headers) {
-  const $ = cheerio64.load(html);
+  const $ = cheerio65.load(html);
   const lcp = analyzeLCP(html, $);
   const fidInp = analyzeFID_INP(html, $);
   const cls = analyzeCLS(html, $);
@@ -1736,11 +1736,11 @@ function analyzeCoreWebVitals(html, url, headers) {
     issues
   };
 }
-var cheerio64;
+var cheerio65;
 var init_core_web_vitals_analyzer = __esm({
   "src/analyzers/core-web-vitals-analyzer.ts"() {
     "use strict";
-    cheerio64 = __toESM(require("cheerio"));
+    cheerio65 = __toESM(require("cheerio"));
   }
 });
 
@@ -2075,7 +2075,7 @@ function validateSchema(data, type) {
   };
 }
 function analyzeStructuredData2(html, url) {
-  const $ = cheerio65.load(html);
+  const $ = cheerio66.load(html);
   const schemas = [];
   const issues = [];
   const recommendations = [];
@@ -2339,11 +2339,11 @@ function generateSchemaTemplate(pageType, options) {
   }
   return JSON.stringify(result, null, 2);
 }
-var cheerio65, SCHEMA_REQUIREMENTS;
+var cheerio66, SCHEMA_REQUIREMENTS;
 var init_structured_data_analyzer = __esm({
   "src/analyzers/structured-data-analyzer.ts"() {
     "use strict";
-    cheerio65 = __toESM(require("cheerio"));
+    cheerio66 = __toESM(require("cheerio"));
     SCHEMA_REQUIREMENTS = {
       "Organization": {
         required: ["name", "url"],
@@ -2459,7 +2459,7 @@ function getImageFormat2(src) {
   }
 }
 function analyzeImages3(html, url) {
-  const $ = cheerio66.load(html);
+  const $ = cheerio67.load(html);
   const issues = [];
   const recommendations = [];
   let score = 100;
@@ -2677,11 +2677,11 @@ function generateResponsiveImage(options) {
   />
 </picture>`;
 }
-var cheerio66, MODERN_FORMATS3, LEGACY_FORMATS2, MAX_RECOMMENDED_DIMENSION;
+var cheerio67, MODERN_FORMATS3, LEGACY_FORMATS2, MAX_RECOMMENDED_DIMENSION;
 var init_image_optimization_analyzer = __esm({
   "src/analyzers/image-optimization-analyzer.ts"() {
     "use strict";
-    cheerio66 = __toESM(require("cheerio"));
+    cheerio67 = __toESM(require("cheerio"));
     MODERN_FORMATS3 = ["webp", "avif"];
     LEGACY_FORMATS2 = ["jpg", "jpeg", "png", "gif", "bmp"];
     MAX_RECOMMENDED_DIMENSION = 2e3;
@@ -2722,7 +2722,7 @@ function analyzeAnchorText2(text) {
   };
 }
 function analyzeInternalLinking(html, url) {
-  const $ = cheerio67.load(html);
+  const $ = cheerio68.load(html);
   const issues = [];
   const recommendations = [];
   let score = 100;
@@ -2961,11 +2961,11 @@ function suggestInternalLinks(content, availablePages) {
   }
   return suggestions.sort((a, b) => b.relevance - a.relevance).filter((s, i, arr) => arr.findIndex((x) => x.suggestedUrl === s.suggestedUrl) === i).slice(0, 10);
 }
-var cheerio67, GENERIC_ANCHOR_TEXTS;
+var cheerio68, GENERIC_ANCHOR_TEXTS;
 var init_internal_linking_analyzer = __esm({
   "src/analyzers/internal-linking-analyzer.ts"() {
     "use strict";
-    cheerio67 = __toESM(require("cheerio"));
+    cheerio68 = __toESM(require("cheerio"));
     GENERIC_ANCHOR_TEXTS = [
       "click here",
       "read more",
@@ -3159,7 +3159,7 @@ function analyzeMobileSpecific($) {
   };
 }
 function analyzeMobileSEO(html, url) {
-  const $ = cheerio68.load(html);
+  const $ = cheerio69.load(html);
   const issues = [];
   const recommendations = [];
   let score = 100;
@@ -3290,11 +3290,11 @@ function analyzeMobileSEO(html, url) {
     recommendations
   };
 }
-var cheerio68;
+var cheerio69;
 var init_mobile_seo_analyzer = __esm({
   "src/analyzers/mobile-seo-analyzer.ts"() {
     "use strict";
-    cheerio68 = __toESM(require("cheerio"));
+    cheerio69 = __toESM(require("cheerio"));
   }
 });
 
@@ -3306,9 +3306,12 @@ __export(index_exports, {
   LOCATION_CODES: () => LOCATION_CODES,
   OG_IMAGE_SPECS: () => OG_IMAGE_SPECS,
   PRIORITY_WEIGHTS: () => PRIORITY_WEIGHTS,
+  RankTracker: () => RankTracker,
   SEO_SCOPES: () => SEO_SCOPES,
   SITE_PROFILE_QUESTIONS: () => SITE_PROFILE_QUESTIONS,
   Schemas: () => Schemas,
+  SerpClient: () => SerpClient,
+  TIER_LIMITS: () => TIER_LIMITS,
   addTrackingResult: () => addTrackingResult,
   analyzeAnchorText: () => analyzeAnchorText,
   analyzeCanonicalAdvanced: () => analyzeCanonicalAdvanced,
@@ -4440,6 +4443,24 @@ var ISSUE_DEFINITIONS = {
     impact: "Your content will not be used for Bard/Gemini AI training (regular search unaffected).",
     howToFix: 'Remove "User-agent: Google-Extended Disallow: /" if you want Google AI visibility.'
   },
+  CLOUDFLARE_AI_CRAWLER_GATE_AMBIGUOUS: {
+    code: "CLOUDFLARE_AI_CRAWLER_GATE_AMBIGUOUS",
+    severity: "warning",
+    category: "ai-readiness",
+    title: "No explicit AI crawler rules on a Cloudflare-fronted site",
+    description: 'This site appears to be served through Cloudflare but robots.txt has no explicit Allow/Disallow rules for AI crawlers. Cloudflare blocks "mixed-use" AI crawlers by default on ad-hosting zones starting September 15, 2026, and is rolling out Pay Per Crawl / Pay Per Use gating beyond that.',
+    impact: "Without an explicit rule, whether AI crawlers (and future citation opportunities in ChatGPT, Claude, Perplexity, etc.) can reach this site now depends on Cloudflare account-level bot-management defaults, not on this codebase \u2014 a silent, invisible-to-git failure mode.",
+    howToFix: "Add explicit User-agent rules for GPTBot, Claude-Web/ClaudeBot, PerplexityBot, and Google-Extended in robots.txt, and confirm the matching allow/block posture in the Cloudflare dashboard under Bot Management \u2192 AI Crawl Control. If you'd rather charge than block, Cloudflare's Pay Per Crawl (AI Crawl Control \u2192 Payments tab) lets you set a per-crawl price instead of a flat allow/deny \u2014 worth a look if you get meaningful AI-crawler traffic."
+  },
+  NO_AGENT_EXPERIENCE_SURFACE: {
+    code: "NO_AGENT_EXPERIENCE_SURFACE",
+    severity: "notice",
+    category: "ai-readiness",
+    title: "No agent-facing discovery surface found",
+    description: "None of the emerging AI-agent discovery conventions were found: llms-full.txt, SKILL.md, a discoverable MCP server, or an OpenAPI spec. This is a genuinely new, low-adoption category as of 2026 \u2014 most sites have none of these yet \u2014 so this is an opportunity, not a compliance failure.",
+    impact: "AI agents (not just chatbots answering questions, but agents that browse and act on a user's behalf) increasingly prefer sites that expose machine-readable capabilities over ones that require scraping and guessing at HTML structure. Being an early, discoverable site in this space is a low-competition differentiator right now.",
+    howToFix: "Start with whichever fits your site: llms-full.txt (a single Markdown dump of your key content \u2014 measured as fetched roughly 2x more than plain llms.txt), a SKILL.md capability manifest, or an OpenAPI spec at /openapi.json if you already have an API. A discoverable MCP server is the highest-effort, highest-payoff option if your product has one to expose."
+  },
   HIGH_JS_RENDERING_RATIO: {
     code: "HIGH_JS_RENDERING_RATIO",
     severity: "warning",
@@ -7386,6 +7407,62 @@ async function checkInternalRedirects(internalLinks, batchSize = 10) {
 // src/audit/checks/ai-readiness.ts
 init_http();
 var cheerio13 = __toESM(require("cheerio"));
+
+// src/audit/checks/agent-experience.ts
+init_http();
+var SIGNAL_PATHS = [
+  { path: "/llms-full.txt", description: "Full-site content dump for AI agents \u2014 the fuller sibling of llms.txt, measured as fetched roughly 2x more often" },
+  { path: "/skill.md", description: "SKILL.md capability manifest (Anthropic Agent Skills convention)" },
+  { path: "/mcp", description: "MCP (Model Context Protocol) server, discoverable at a conventional path" },
+  { path: "/.well-known/mcp.json", description: "MCP server descriptor at the .well-known convention" },
+  { path: "/openapi.json", description: "OpenAPI spec \u2014 lets an agent discover and call your API directly instead of scraping HTML" },
+  { path: "/.well-known/ai-plugin.json", description: "AI plugin manifest (older but still-referenced convention for agent tool discovery)" }
+];
+async function fetchBody(baseUrl, path3) {
+  try {
+    const url = new URL(path3, baseUrl).href;
+    const response = await httpGet(url, {
+      timeout: 8e3,
+      validateStatus: () => true
+    });
+    return { status: response.status, body: String(response.data ?? "") };
+  } catch {
+    return null;
+  }
+}
+async function pathExists(baseUrl, path3, fallbackBody) {
+  const result = await fetchBody(baseUrl, path3);
+  if (!result) return false;
+  if (result.status === 404) return false;
+  if (result.status < 200 || result.status >= 400) return false;
+  if (fallbackBody != null && result.body === fallbackBody) return false;
+  return true;
+}
+async function checkAgentExperience(baseUrl) {
+  const issues = [];
+  const probePath = `/__rankcli_ax_probe_${Math.random().toString(36).slice(2)}`;
+  const baseline = await fetchBody(baseUrl, probePath);
+  const fallbackBody = baseline && baseline.status >= 200 && baseline.status < 400 ? baseline.body : null;
+  const signals = await Promise.all(
+    SIGNAL_PATHS.map(async ({ path: path3, description }) => ({
+      path: path3,
+      description,
+      present: await pathExists(baseUrl, path3, fallbackBody)
+    }))
+  );
+  const presentCount = signals.filter((s) => s.present).length;
+  const score = Math.round(presentCount / signals.length * 100);
+  if (presentCount === 0) {
+    issues.push({
+      ...ISSUE_DEFINITIONS.NO_AGENT_EXPERIENCE_SURFACE,
+      affectedUrls: [baseUrl],
+      details: { checkedPaths: SIGNAL_PATHS.map((s) => s.path) }
+    });
+  }
+  return { issues, data: { signals, score } };
+}
+
+// src/audit/checks/ai-readiness.ts
 var AI_BOTS = {
   GPTBot: "GPTBot",
   "ChatGPT-User": "ChatGPT-User",
@@ -7606,6 +7683,32 @@ function checkJSRenderingRatio(html, url) {
     data: { ratio, staticWordCount }
   };
 }
+async function checkCloudflareAICrawlerGate(baseUrl, botBlocking) {
+  const issues = [];
+  let behindCloudflare = false;
+  try {
+    const response = await httpGet(baseUrl, {
+      timeout: 1e4,
+      validateStatus: () => true
+    });
+    const server = response.headers["server"] || "";
+    behindCloudflare = server.toLowerCase().includes("cloudflare") || "cf-ray" in response.headers;
+  } catch {
+    behindCloudflare = false;
+  }
+  const hasExplicitAIRules = botBlocking.robotsExists && botBlocking.blockedBots.length > 0;
+  const ambiguous = behindCloudflare && !hasExplicitAIRules;
+  if (ambiguous) {
+    issues.push({
+      ...ISSUE_DEFINITIONS.CLOUDFLARE_AI_CRAWLER_GATE_AMBIGUOUS,
+      affectedUrls: [baseUrl]
+    });
+  }
+  return {
+    issues,
+    data: { behindCloudflare, hasExplicitAIRules, ambiguous }
+  };
+}
 async function runAIReadinessChecks(baseUrl, html) {
   const allIssues = [];
   const llmsResult = await checkLlmsTxt(baseUrl);
@@ -7614,12 +7717,18 @@ async function runAIReadinessChecks(baseUrl, html) {
   allIssues.push(...botResult.issues);
   const jsResult = checkJSRenderingRatio(html, baseUrl);
   allIssues.push(...jsResult.issues);
+  const cfGateResult = await checkCloudflareAICrawlerGate(baseUrl, botResult.data);
+  allIssues.push(...cfGateResult.issues);
+  const agentExperienceResult = await checkAgentExperience(baseUrl);
+  allIssues.push(...agentExperienceResult.issues);
   return {
     issues: allIssues,
     data: {
       llmsTxt: llmsResult.data,
       botBlocking: botResult.data,
-      jsRenderingRatio: jsResult.data.ratio
+      jsRenderingRatio: jsResult.data.ratio,
+      cloudflareAIGate: cfGateResult.data,
+      agentExperience: agentExperienceResult.data
     }
   };
 }
@@ -8085,7 +8194,13 @@ async function analyzeSecurityHeaders(url) {
       maxRedirects: 5
     });
     const headers = response.headers;
-    const isHttps = url.startsWith("https://");
+    let isHttps = false;
+    try {
+      const parsedUrl = new URL(url);
+      isHttps = parsedUrl.protocol === "https:";
+    } catch {
+      isHttps = url.toLowerCase().startsWith("https://");
+    }
     const getHeader = (name) => {
       const key = Object.keys(headers).find((k) => k.toLowerCase() === name.toLowerCase());
       return key ? headers[key] : null;
@@ -8157,10 +8272,17 @@ async function analyzeSecurityHeaders(url) {
       }
     };
   } catch (error) {
+    let isHttps = false;
+    try {
+      const parsedUrl = new URL(url);
+      isHttps = parsedUrl.protocol === "https:";
+    } catch {
+      isHttps = url.toLowerCase().startsWith("https://");
+    }
     return {
       issues,
       data: {
-        https: url.startsWith("https://"),
+        https: isHttps,
         headers: {
           hsts: null,
           csp: null,
@@ -12199,17 +12321,17 @@ function generateRecommendations2(renderingMethod, hasContentInHTML, charCount,
     );
     if (framework === "React") {
       recommendations.push(
-        'Quick fix: Add react-snap to pre-render pages at build time (npm install -D react-snap, add "postbuild": "react-snap" to scripts)'
+        "Quick fix: Use Vike (vike.dev) for SSR/SSG - works with Vite, minimal config needed"
       );
       recommendations.push(
-        "Alternative: Use Vike (vite-plugin-ssr) for SSR/SSG without changing frameworks"
+        "Alternative: Migrate to Next.js or Remix for built-in SSR/SSG support"
       );
     } else if (framework === "Vue") {
       recommendations.push(
-        "Quick fix: Add prerender-spa-plugin to pre-render pages at build time"
+        "Quick fix: Use Vike (vike.dev) for SSR/SSG - works with Vite, minimal config needed"
       );
       recommendations.push(
-        "Alternative: Use Vike (vite-plugin-ssr) for SSR/SSG without changing frameworks"
+        "Alternative: Migrate to Nuxt for built-in SSR/SSG support"
       );
     } else if (framework === "Angular Universal") {
       recommendations.push(
@@ -12217,7 +12339,7 @@ function generateRecommendations2(renderingMethod, hasContentInHTML, charCount,
       );
     } else {
       recommendations.push(
-        "Quick fix: Use a pre-rendering tool like react-snap or prerender-spa-plugin"
+        "Quick fix: Use Vike (vike.dev) for SSR/SSG with any Vite-based framework"
       );
     }
     recommendations.push(
@@ -12241,7 +12363,7 @@ function analyzeClientRendering(html, url) {
   const issues = [];
   const analysis = analyzeRendering(html);
   if (analysis.renderingMethod === "csr" && analysis.confidence !== "low") {
-    const howToFixByFramework = analysis.frameworkDetected === "React" ? 'Add react-snap to pre-render pages: npm install -D react-snap, then add "postbuild": "react-snap" to package.json scripts. No code changes needed.' : analysis.frameworkDetected === "Vue" ? "Add prerender-spa-plugin to pre-render pages at build time. Alternatively, use Vike for SSR/SSG." : "Pre-render your pages using react-snap, prerender-spa-plugin, or similar build-time tools.";
+    const howToFixByFramework = analysis.frameworkDetected === "React" ? "Use Vike (vike.dev) to add SSR/SSG to your Vite React app: npm install vike vike-react, then follow the setup guide. Alternatively, migrate to Next.js or Remix." : analysis.frameworkDetected === "Vue" ? "Use Vike (vike.dev) to add SSR/SSG to your Vite Vue app: npm install vike vike-vue, then follow the setup guide. Alternatively, migrate to Nuxt." : "Use Vike (vike.dev) for SSR/SSG with Vite-based frameworks, or use a framework with built-in SSR support (Next.js, Nuxt, Remix, SvelteKit).";
     issues.push({
       code: "CLIENT_SIDE_RENDERING",
       severity: "error",
@@ -12282,7 +12404,7 @@ function analyzeClientRendering(html, url) {
       title: `${analysis.frameworkDetected} detected without SSR markers`,
       description: `This appears to be a ${analysis.frameworkDetected} SPA without server-side rendering enabled.`,
       impact: "Single Page Applications without SSR have slower time-to-content for search crawlers.",
-      howToFix: analysis.frameworkDetected === "React" ? "Quick fix: Add react-snap (npm install -D react-snap) to pre-render at build time. Alternative: Use Vike for SSR/SSG." : "Quick fix: Add prerender-spa-plugin to pre-render at build time. Alternative: Use Vike for SSR/SSG.",
+      howToFix: analysis.frameworkDetected === "React" ? "Add SSR/SSG using Vike (vike.dev): npm install vike vike-react. Alternative: migrate to Next.js or Remix." : "Add SSR/SSG using Vike (vike.dev): npm install vike vike-vue. Alternative: migrate to Nuxt.",
       affectedUrls: [url],
       details: {
         framework: analysis.frameworkDetected,
@@ -16061,8 +16183,94 @@ function analyzeAIContentStructure(html, url) {
   };
 }
 
-// src/audit/checks/citation-quality.ts
+// src/audit/checks/rag-chunk-readiness.ts
 var cheerio44 = __toESM(require("cheerio"));
+var MIN_GOOD_WORDS = 150;
+var MAX_GOOD_WORDS = 450;
+var TOKENS_PER_WORD = 1.33;
+var DANGLING_OPENERS = /^(this|it|these|that|they|such|those|the former|the latter)\b/i;
+function classifySize(wordCount) {
+  if (wordCount < MIN_GOOD_WORDS) return "too-short";
+  if (wordCount > MAX_GOOD_WORDS) return "too-long";
+  return "good";
+}
+function extractSections($) {
+  const elements = $("h1, h2, h3, p, li, blockquote").toArray();
+  const sections = [];
+  let current = null;
+  for (const el of elements) {
+    const tag = el.tagName?.toLowerCase();
+    if (tag === "h1" || tag === "h2" || tag === "h3") {
+      if (current) sections.push(current);
+      current = { heading: $(el).text().trim(), headingLevel: parseInt(tag.slice(1), 10), text: "" };
+    } else if (current) {
+      current.text += " " + $(el).text();
+    }
+  }
+  if (current) sections.push(current);
+  return sections;
+}
+function analyzeRAGChunkReadiness(html, url) {
+  const issues = [];
+  const $ = cheerio44.load(html);
+  $("nav, footer, aside, script, style, noscript, header").remove();
+  const rawSections = extractSections($);
+  const sections = rawSections.map((s) => {
+    const words = s.text.trim().split(/\s+/).filter(Boolean);
+    const wordCount = words.length;
+    const estimatedTokens = Math.round(wordCount * TOKENS_PER_WORD);
+    const firstSentence = s.text.trim().split(/[.!?]/)[0] || "";
+    return {
+      heading: s.heading,
+      headingLevel: s.headingLevel,
+      wordCount,
+      estimatedTokens,
+      sizeQuality: classifySize(wordCount),
+      startsWithDanglingReference: DANGLING_OPENERS.test(firstSentence.trim())
+    };
+  });
+  const totalSections = sections.length;
+  const wellSizedSectionCount = sections.filter((s) => s.sizeQuality === "good").length;
+  const danglingReferenceCount = sections.filter((s) => s.startsWithDanglingReference).length;
+  const chunkReadinessScore = totalSections === 0 ? 0 : Math.round(
+    (wellSizedSectionCount / totalSections * 0.7 + (totalSections - danglingReferenceCount) / totalSections * 0.3) * 100
+  );
+  if (totalSections >= 3 && wellSizedSectionCount / totalSections < 0.5) {
+    const tooLong = sections.filter((s) => s.sizeQuality === "too-long").length;
+    const tooShort = sections.filter((s) => s.sizeQuality === "too-short").length;
+    issues.push({
+      code: "RAG_CHUNK_SIZE_MISMATCH",
+      severity: "notice",
+      category: "ai-readiness",
+      title: "Most sections are poorly sized for AI retrieval chunking",
+      description: `${wellSizedSectionCount} of ${totalSections} sections fall in a well-sized range for RAG retrieval (roughly 150-450 words); ${tooLong} are too long and likely to get split mid-thought, ${tooShort} are too short and likely to get merged with unrelated neighbors.`,
+      impact: "When an AI answer engine retrieves a chunk of this page in response to a query, oversized sections risk being cut off mid-point and undersized ones risk losing standalone context \u2014 both reduce the odds the retrieved chunk reads coherently in an AI-generated answer.",
+      howToFix: "Break up long sections (450+ words) with an additional H2/H3 subheading roughly every 300-400 words. Merge very short sections (under 150 words) into a neighboring section or expand them with enough context to stand alone.",
+      affectedUrls: [url],
+      details: { wellSizedSectionCount, totalSections, tooLong, tooShort }
+    });
+  }
+  if (totalSections >= 3 && danglingReferenceCount / totalSections > 0.3) {
+    issues.push({
+      code: "RAG_CHUNK_DANGLING_REFERENCES",
+      severity: "notice",
+      category: "ai-readiness",
+      title: "Several sections open with a reference to prior context",
+      description: `${danglingReferenceCount} of ${totalSections} sections start with a pronoun or demonstrative ("This...", "It...", "These...") that depends on the previous section to make sense.`,
+      impact: "A RAG system that retrieves one of these sections on its own \u2014 which is exactly how retrieval works, one chunk at a time \u2014 surfaces a sentence whose subject is undefined, reading as broken or confusing in an AI-generated answer.",
+      howToFix: 'Open each section by naming its actual subject instead of referring back to the previous one \u2014 e.g. "This approach reduces cost" becomes "Caching reduces cost."',
+      affectedUrls: [url],
+      details: { danglingReferenceCount, totalSections }
+    });
+  }
+  return {
+    issues,
+    data: { sections, totalSections, wellSizedSectionCount, danglingReferenceCount, chunkReadinessScore }
+  };
+}
+
+// src/audit/checks/citation-quality.ts
+var cheerio45 = __toESM(require("cheerio"));
 var REPUTABLE_SOURCES = {
   academic: [
     "scholar.google.com",
@@ -16129,7 +16337,7 @@ var REPUTABLE_SOURCES = {
 };
 function analyzeCitationQuality(html, url) {
   const issues = [];
-  const $ = cheerio44.load(html);
+  const $ = cheerio45.load(html);
   const parsedUrl = new URL(url);
   const currentDomain = parsedUrl.hostname;
   const $content = $("body").clone();
@@ -16358,12 +16566,12 @@ function analyzeCitationQuality(html, url) {
 }
 
 // src/audit/checks/answer-conciseness.ts
-var cheerio45 = __toESM(require("cheerio"));
+var cheerio46 = __toESM(require("cheerio"));
 var IDEAL_ANSWER_LENGTH = { min: 40, max: 150 };
 var MAX_FIRST_SENTENCE = 200;
 function analyzeAnswerConciseness(html, url) {
   const issues = [];
-  const $ = cheerio45.load(html);
+  const $ = cheerio46.load(html);
   $("nav, footer, aside, script, style, noscript, header").remove();
   const headings = $("h1, h2, h3, h4, h5, h6");
   let totalHeadings = 0;
@@ -16554,7 +16762,7 @@ function analyzeAnswerConciseness(html, url) {
 }
 
 // src/audit/checks/brand-mention-optimization.ts
-var cheerio46 = __toESM(require("cheerio"));
+var cheerio47 = __toESM(require("cheerio"));
 var BRAND_DEFINITION_PATTERNS = [
   /(?:we are|we're|is a|is the|is an)\s+(?:leading|premier|top|best|trusted|innovative|professional)/i,
   /(?:our mission|our vision|we help|we provide|we offer|we specialize)/i,
@@ -16592,7 +16800,7 @@ var REVIEW_PLATFORMS = [
 ];
 function analyzeBrandMentionOptimization(html, url) {
   const issues = [];
-  const $ = cheerio46.load(html);
+  const $ = cheerio47.load(html);
   const parsedUrl = new URL(url);
   const $content = $("body").clone();
   $content.find("nav, footer, script, style, noscript").remove();
@@ -16784,7 +16992,7 @@ function analyzeBrandMentionOptimization(html, url) {
 }
 
 // src/audit/checks/ai-citation-worthiness.ts
-var cheerio47 = __toESM(require("cheerio"));
+var cheerio48 = __toESM(require("cheerio"));
 var ORIGINAL_DATA_PATTERNS = [
   /(?:our data|our research|our study|our analysis|we found|we discovered)/i,
   /(?:survey of|surveyed|interviewed|analyzed)\s+\d+/i,
@@ -16831,7 +17039,7 @@ var STOCK_IMAGE_DOMAINS = [
 ];
 function analyzeAICitationWorthiness(html, url) {
   const issues = [];
-  const $ = cheerio47.load(html);
+  const $ = cheerio48.load(html);
   const $content = $("body").clone();
   $content.find("nav, footer, script, style, noscript, aside").remove();
   const bodyText = $content.text();
@@ -17056,7 +17264,7 @@ function analyzeAICitationWorthiness(html, url) {
 }
 
 // src/audit/checks/review-ecosystem.ts
-var cheerio48 = __toESM(require("cheerio"));
+var cheerio49 = __toESM(require("cheerio"));
 var REVIEW_PLATFORMS2 = {
   general: [
     { name: "Google Business", domain: "google.com/maps", aliases: ["goo.gl/maps", "maps.google"] },
@@ -17116,7 +17324,7 @@ var TRUST_BADGE_PATTERNS2 = [
 ];
 function analyzeReviewEcosystem(html, url) {
   const issues = [];
-  const $ = cheerio48.load(html);
+  const $ = cheerio49.load(html);
   const allLinks = $("a[href]").map((_, a) => $(a).attr("href") || "").get();
   const allLinksLower = allLinks.map((l) => l.toLowerCase());
   const linkedPlatforms = [];
@@ -17800,11 +18008,11 @@ function analyzeStructure(content) {
 }
 
 // src/audit/checks/html-compliance.ts
-var cheerio49 = __toESM(require("cheerio"));
+var cheerio50 = __toESM(require("cheerio"));
 init_http();
 async function analyzeHtmlCompliance(html, url, headers) {
   const issues = [];
-  const $ = cheerio49.load(html);
+  const $ = cheerio50.load(html);
   const parsedUrl = new URL(url);
   const doctypeMatch = html.match(/<!DOCTYPE\s+([^>]+)>/i);
   const hasDoctype = doctypeMatch !== null;
@@ -18370,7 +18578,7 @@ function getAssetType(url) {
 }
 
 // src/audit/checks/dom-size.ts
-var cheerio50 = __toESM(require("cheerio"));
+var cheerio51 = __toESM(require("cheerio"));
 var THRESHOLDS = {
   totalElements: {
     warning: 1500,
@@ -18387,7 +18595,7 @@ var THRESHOLDS = {
 };
 function analyzeDomSize(html, url) {
   const issues = [];
-  const $ = cheerio50.load(html);
+  const $ = cheerio51.load(html);
   const allElements = $("*");
   const totalElements = allElements.length;
   let maxDepth = 0;
@@ -18543,10 +18751,10 @@ function getDomReductionSuggestions(breakdown) {
 }
 
 // src/audit/checks/image-dimensions.ts
-var cheerio51 = __toESM(require("cheerio"));
+var cheerio52 = __toESM(require("cheerio"));
 function analyzeImageDimensions(html, url) {
   const issues = [];
-  const $ = cheerio51.load(html);
+  const $ = cheerio52.load(html);
   const images = $("img");
   const totalImages = images.length;
   let withDimensions = 0;
@@ -18657,7 +18865,7 @@ function truncateSrc(src) {
 }
 
 // src/audit/checks/color-contrast.ts
-var cheerio52 = __toESM(require("cheerio"));
+var cheerio53 = __toESM(require("cheerio"));
 var KNOWN_LOW_CONTRAST_PAIRS = [
   { fg: "#999999", bg: "#ffffff", ratio: 2.85 },
   { fg: "#888888", bg: "#ffffff", ratio: 3.54 },
@@ -18692,7 +18900,7 @@ var NAMED_COLORS = {
 };
 function analyzeColorContrast(html, url) {
   const issues = [];
-  const $ = cheerio52.load(html);
+  const $ = cheerio53.load(html);
   const potentialIssues = [];
   let elementsAnalyzed = 0;
   let passedChecks = 0;
@@ -18891,7 +19099,7 @@ function calculateContrastRatio(fg, bg) {
 
 // src/audit/checks/asset-minification.ts
 init_http();
-var cheerio53 = __toESM(require("cheerio"));
+var cheerio54 = __toESM(require("cheerio"));
 function isMinified(content, type) {
   const lines = content.split("\n");
   const totalLines = lines.length;
@@ -18919,7 +19127,7 @@ function isMinified(content, type) {
   };
 }
 function extractAssetUrls(html, baseUrl) {
-  const $ = cheerio53.load(html);
+  const $ = cheerio54.load(html);
   const base = new URL(baseUrl);
   const css = [];
   const js = [];
@@ -19065,10 +19273,10 @@ async function analyzeAssetMinification(html, url) {
 }
 
 // src/audit/checks/page-resources.ts
-var cheerio54 = __toESM(require("cheerio"));
+var cheerio55 = __toESM(require("cheerio"));
 function analyzePageResources(html, url) {
   const issues = [];
-  const $ = cheerio54.load(html);
+  const $ = cheerio55.load(html);
   const baseUrl = new URL(url);
   const baseHostname = baseUrl.hostname;
   const stylesheets = [];
@@ -19269,7 +19477,7 @@ function analyzePageResources(html, url) {
 
 // src/audit/checks/responsive-css.ts
 init_http();
-var cheerio55 = __toESM(require("cheerio"));
+var cheerio56 = __toESM(require("cheerio"));
 function extractMediaQueries(css) {
   const mediaQueries = [];
   const regex = /@media\s*([^{]+)/g;
@@ -19319,7 +19527,7 @@ function classifyBreakpoints(mediaQueries) {
 }
 async function analyzeResponsiveCss(html, url) {
   const issues = [];
-  const $ = cheerio55.load(html);
+  const $ = cheerio56.load(html);
   const baseUrl = new URL(url);
   const viewportMeta = $('meta[name="viewport"]').attr("content");
   const hasViewport = !!viewportMeta;
@@ -20057,10 +20265,10 @@ var urlSafetyDatabase = {
 };
 
 // src/audit/checks/tracking-verification.ts
-var cheerio56 = __toESM(require("cheerio"));
+var cheerio57 = __toESM(require("cheerio"));
 function analyzeTrackingVerification(html, url) {
   const issues = [];
-  const $ = cheerio56.load(html);
+  const $ = cheerio57.load(html);
   const ga4Match = html.match(/gtag\s*\(\s*['"]config['"]\s*,\s*['"](G-[A-Z0-9]+)['"]/i) || html.match(/googletagmanager\.com\/gtag\/js\?id=(G-[A-Z0-9]+)/i);
   const hasGa4 = !!ga4Match;
   const ga4MeasurementId = ga4Match ? ga4Match[1] : void 0;
@@ -20194,10 +20402,10 @@ async function runFullAudit(options) {
   const runExtendedChecks = tier !== "free";
   const parsedUrl = new URL(url);
   const domain = parsedUrl.hostname;
-  console.log(`
+  console.error(`
 \u{1F50D} Running comprehensive SEO audit on ${url}...
 `);
-  console.log("\u{1F4CB} Phase 1: Crawlability checks + page fetch (parallel)...");
+  console.error("\u{1F4CB} Phase 1: Crawlability checks + page fetch (parallel)...");
   const [crawlabilityResult, fetchResult] = await Promise.all([
     runCrawlabilityChecks(url).catch((err) => {
       console.error("Crawlability check failed:", err);
@@ -20207,26 +20415,32 @@ async function runFullAudit(options) {
       timeout: 3e4,
       validateStatus: () => true
     }).catch((err) => {
+      console.error("Main page fetch failed:", err instanceof Error ? { message: err.message, cause: err.cause } : err);
       return { error: err, data: "", headers: {} };
     })
   ]);
   allIssues.push(...crawlabilityResult);
   if ("error" in fetchResult) {
+    const err = fetchResult.error;
+    const errorMsg = err instanceof Error ? err.message : "Unknown error";
+    const errorCause = err instanceof Error && err.cause ? ` (${String(err.cause)})` : "";
     allIssues.push({
       code: "FETCH_ERROR",
       severity: "error",
-      category: "crawlability",
-      title: "Failed to fetch page",
-      description: `Could not fetch the page: ${fetchResult.error instanceof Error ? fetchResult.error.message : "Unknown error"}`,
-      impact: "Cannot perform full audit without page content.",
-      howToFix: "Ensure the URL is accessible and the server is responding.",
-      affectedUrls: [url]
+      category: "indexability",
+      // Not crawlability - robots/sitemap checks may have succeeded
+      title: "Page fetch failed",
+      description: `Could not load page content: ${errorMsg}${errorCause}. Only robots.txt and sitemap checks were performed.`,
+      impact: "Cannot perform full SEO audit without page HTML content.",
+      howToFix: "Verify the URL is accessible, the server is responding, and there are no firewall/geo blocks.",
+      affectedUrls: [url],
+      details: { error: errorMsg, cause: errorCause || void 0 }
     });
     return createReport(url, domain, allIssues, pages);
   }
   const html = fetchResult.data;
   const headers = fetchResult.headers;
-  console.log(`\u{1F4DD} Phase 2: Running synchronous HTML checks (tier: ${tier}, limit: ${checksLimit})...`);
+  console.error(`\u{1F4DD} Phase 2: Running synchronous HTML checks (tier: ${tier}, limit: ${checksLimit})...`);
   const onPageResult = analyzeOnPage(html, url);
   const structuredDataResult = analyzeStructuredData(html, url);
   const mobileResult = analyzeMobile(html, url);
@@ -20266,6 +20480,7 @@ async function runFullAudit(options) {
   const entityResult = runPremiumChecks ? analyzeEntitySEO(html, url) : { issues: [], data: {} };
   const qdfFreshnessResult = runPremiumChecks ? analyzeFreshnessSignals(html, url) : { issues: [], data: {} };
   const aiContentStructureResult = runPremiumChecks ? analyzeAIContentStructure(html, url) : { issues: [], data: {} };
+  const ragChunkReadinessResult = runPremiumChecks ? analyzeRAGChunkReadiness(html, url) : { issues: [], data: {} };
   const citationQualityResult = runPremiumChecks ? analyzeCitationQuality(html, url) : { issues: [], data: {} };
   const answerConcisenessResult = runPremiumChecks ? analyzeAnswerConciseness(html, url) : { issues: [], data: {} };
   const brandMentionResult = runPremiumChecks ? analyzeBrandMentionOptimization(html, url) : { issues: [], data: {} };
@@ -20304,6 +20519,7 @@ async function runFullAudit(options) {
     ...entityResult.issues,
     ...qdfFreshnessResult.issues,
     ...aiContentStructureResult.issues,
+    ...ragChunkReadinessResult.issues,
     ...citationQualityResult.issues,
     ...answerConcisenessResult.issues,
     ...brandMentionResult.issues,
@@ -20327,7 +20543,7 @@ async function runFullAudit(options) {
       };
     }
   }
-  console.log("\u{1F517} Phase 3: Running async checks (parallel)...");
+  console.error("\u{1F517} Phase 3: Running async checks (parallel)...");
   const safeAsync = async (name, fn, timeoutMs = 1e4) => {
     try {
       const resultPromise = fn();
@@ -20440,7 +20656,7 @@ async function runFullAudit(options) {
     loadTime: perfData.loadTime,
     issues: allIssues.map((i) => i.code)
   });
-  console.log("\n\u2705 Audit complete!\n");
+  console.error("\n\u2705 Audit complete!\n");
   return createReport(url, domain, allIssues, pages);
 }
 function createReport(url, domain, issues, pages) {
@@ -20601,10 +20817,10 @@ function groupIssuesByCategory(issues) {
 }
 
 // src/audit/checks/duplicate-content.ts
-var cheerio57 = __toESM(require("cheerio"));
+var cheerio58 = __toESM(require("cheerio"));
 var import_crypto = require("crypto");
 function extractContentHash(html, url) {
-  const $ = cheerio57.load(html);
+  const $ = cheerio58.load(html);
   $("script, style, nav, header, footer, aside, .nav, .header, .footer, .sidebar").remove();
   const title = $("title").text().trim();
   const bodyText = $("body").text().replace(/\s+/g, " ").trim();
@@ -21832,7 +22048,7 @@ var PRIORITY_WEIGHTS = {
 };
 
 // src/keywords/engine.ts
-var cheerio59 = __toESM(require("cheerio"));
+var cheerio60 = __toESM(require("cheerio"));
 init_http();
 
 // src/keywords/prioritizer.ts
@@ -22129,7 +22345,7 @@ function enrichKeywordsWithEstimates(keywords) {
 
 // src/keywords/sources/free-sources.ts
 init_http();
-var cheerio58 = __toESM(require("cheerio"));
+var cheerio59 = __toESM(require("cheerio"));
 var USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36";
 async function getPeopleAlsoAsk(query) {
   try {
@@ -22138,7 +22354,7 @@ async function getPeopleAlsoAsk(query) {
       headers: { "User-Agent": USER_AGENT },
       timeout: 1e4
     });
-    const $ = cheerio58.load(response.data);
+    const $ = cheerio59.load(response.data);
     const questions = [];
     $("[data-sgrd]").each((_, el) => {
       const text = $(el).text().trim();
@@ -22164,7 +22380,7 @@ async function getRelatedSearches(query) {
       headers: { "User-Agent": USER_AGENT },
       timeout: 1e4
     });
-    const $ = cheerio58.load(response.data);
+    const $ = cheerio59.load(response.data);
     const related = [];
     $("div[data-ved] a").each((_, el) => {
       const href = $(el).attr("href");
@@ -22254,7 +22470,7 @@ async function analyzeCompetitorTitles(query) {
       headers: { "User-Agent": USER_AGENT },
       timeout: 1e4
     });
-    const $ = cheerio58.load(response.data);
+    const $ = cheerio59.load(response.data);
     const titles = [];
     const keywords = /* @__PURE__ */ new Set();
     $("h3").each((_, el) => {
@@ -22587,7 +22803,7 @@ async function fetchPageMeta(url) {
     const response = await httpGet(url, {
       timeout: 1e4
     });
-    const $ = cheerio59.load(response.data);
+    const $ = cheerio60.load(response.data);
     return {
       url,
       title: $("title").text().trim() || void 0,
@@ -22718,7 +22934,7 @@ async function extractSeedKeywords(url) {
     const response = await httpGet(url, {
       timeout: 1e4
     });
-    const $ = cheerio59.load(response.data);
+    const $ = cheerio60.load(response.data);
     const seeds = /* @__PURE__ */ new Set();
     const title = $("title").text().toLowerCase();
     const titleWords = title.split(/[\s\-|:]+/).filter((w) => w.length > 3);
@@ -22740,7 +22956,7 @@ async function extractSeedKeywords(url) {
 }
 
 // src/keywords/site-crawler.ts
-var cheerio60 = __toESM(require("cheerio"));
+var cheerio61 = __toESM(require("cheerio"));
 init_http();
 var EXCLUDED_PATHS = [
   "/cdn-cgi/",
@@ -22853,7 +23069,7 @@ async function crawlPage(url, timeout) {
     validateStatus: (status) => status === 200
   });
   const html = response.data;
-  const $ = cheerio60.load(html);
+  const $ = cheerio61.load(html);
   $('script, style, noscript, iframe, nav, footer, header, aside, [role="navigation"]').remove();
   const title = $("title").text().trim();
   const description = $('meta[name="description"]').attr("content")?.trim() || "";
@@ -25511,7 +25727,7 @@ function getDateRange(days = 28) {
 
 // src/keywords/sources/competitor-analysis.ts
 init_http();
-var cheerio61 = __toESM(require("cheerio"));
+var cheerio62 = __toESM(require("cheerio"));
 var USER_AGENT2 = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36";
 async function discoverCompetitorKeywords(yourDomain, seedKeywords, competitors) {
   const yourKeywords = /* @__PURE__ */ new Set();
@@ -25608,7 +25824,7 @@ async function analyzeSERP(query) {
       headers: { "User-Agent": USER_AGENT2 },
       timeout: 1e4
     });
-    const $ = cheerio61.load(response.data);
+    const $ = cheerio62.load(response.data);
     const results = [];
     const relatedSearches = [];
     const peopleAlsoAsk = [];
@@ -37315,6 +37531,544 @@ function getAIVisibilitySummary(results) {
   };
 }
 
+// src/ranking/types.ts
+var TIER_LIMITS = {
+  free: {
+    maxKeywords: 10,
+    checksPerDay: 1,
+    serpFeatures: false,
+    competitorTracking: false,
+    historyDays: 7
+  },
+  solo: {
+    maxKeywords: 100,
+    checksPerDay: 1,
+    serpFeatures: true,
+    competitorTracking: false,
+    historyDays: 30
+  },
+  pro: {
+    maxKeywords: 500,
+    checksPerDay: 2,
+    serpFeatures: true,
+    competitorTracking: true,
+    historyDays: 90
+  },
+  agency: {
+    maxKeywords: 2e3,
+    checksPerDay: 4,
+    serpFeatures: true,
+    competitorTracking: true,
+    historyDays: 365
+  }
+};
+
+// src/ranking/serp-client.ts
+var SerpClient = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Check ranking for a single keyword
+   */
+  async checkRank(options) {
+    const results = [];
+    for (const keyword of options.keywords) {
+      try {
+        const result = await this.checkSingleKeyword({
+          ...options,
+          keyword
+        });
+        results.push(result);
+      } catch (error) {
+        console.error(`Error checking rank for "${keyword}":`, error);
+        results.push({
+          keyword,
+          position: null,
+          url: null,
+          serpFeatures: [],
+          topResults: [],
+          checkedAt: /* @__PURE__ */ new Date()
+        });
+      }
+    }
+    return results;
+  }
+  async checkSingleKeyword(options) {
+    switch (this.config.provider) {
+      case "valueserp":
+        return this.checkViaValueSerp(options);
+      case "serpapi":
+        return this.checkViaSerpApi(options);
+      case "direct":
+      default:
+        return this.checkViaDirect(options);
+    }
+  }
+  /**
+   * ValueSERP API implementation
+   * Docs: https://www.valueserp.com/docs
+   */
+  async checkViaValueSerp(options) {
+    if (!this.config.apiKey) {
+      throw new Error("ValueSERP API key required");
+    }
+    const params = new URLSearchParams({
+      api_key: this.config.apiKey,
+      q: options.keyword,
+      location: options.country || "United States",
+      google_domain: options.country === "US" ? "google.com" : `google.${options.country?.toLowerCase() || "com"}`,
+      gl: options.country || "us",
+      hl: options.language || "en",
+      device: options.device || "desktop",
+      num: "100"
+      // Get top 100 results
+    });
+    const response = await fetch(`https://api.valueserp.com/search?${params}`);
+    if (!response.ok) {
+      throw new Error(`ValueSERP API error: ${response.status}`);
+    }
+    const data = await response.json();
+    return this.parseValueSerpResponse(data, options.domain, options.keyword);
+  }
+  /**
+   * SerpAPI implementation (alternative)
+   * Docs: https://serpapi.com/search-api
+   */
+  async checkViaSerpApi(options) {
+    if (!this.config.apiKey) {
+      throw new Error("SerpAPI key required");
+    }
+    const params = new URLSearchParams({
+      api_key: this.config.apiKey,
+      q: options.keyword,
+      location: options.country === "US" ? "United States" : options.country || "United States",
+      gl: options.country?.toLowerCase() || "us",
+      hl: options.language || "en",
+      device: options.device || "desktop",
+      num: "100"
+    });
+    const response = await fetch(`https://serpapi.com/search?${params}`);
+    if (!response.ok) {
+      throw new Error(`SerpAPI error: ${response.status}`);
+    }
+    const data = await response.json();
+    return this.parseSerpApiResponse(data, options.domain, options.keyword);
+  }
+  /**
+   * Direct scraping fallback (rate-limited, use with caution)
+   */
+  async checkViaDirect(options) {
+    const searchUrl = `https://www.google.com/search?q=${encodeURIComponent(options.keyword)}&num=100`;
+    const headers = {
+      "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+      "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+      "Accept-Language": options.language || "en-US,en;q=0.9"
+    };
+    const response = await fetch(searchUrl, { headers });
+    if (!response.ok) {
+      throw new Error(`Direct search failed: ${response.status}`);
+    }
+    const html = await response.text();
+    return this.parseDirectSearchResults(html, options.domain, options.keyword);
+  }
+  parseValueSerpResponse(data, domain, keyword) {
+    const topResults = [];
+    const serpFeatures = [];
+    let position = null;
+    let url = null;
+    if (data.organic_results) {
+      for (let i = 0; i < data.organic_results.length; i++) {
+        const result = data.organic_results[i];
+        const resultDomain = this.extractDomain(result.link);
+        topResults.push({
+          position: i + 1,
+          url: result.link,
+          domain: resultDomain,
+          title: result.title
+        });
+        if (this.domainMatches(resultDomain, domain) && position === null) {
+          position = i + 1;
+          url = result.link;
+        }
+      }
+    }
+    if (data.answer_box) {
+      serpFeatures.push({
+        type: "featured_snippet",
+        position: 0,
+        hasOwnSite: this.domainMatches(this.extractDomain(data.answer_box.link || ""), domain)
+      });
+    }
+    if (data.people_also_ask) {
+      serpFeatures.push({
+        type: "people_also_ask",
+        hasOwnSite: data.people_also_ask.some(
+          (paa) => this.domainMatches(this.extractDomain(paa.link || ""), domain)
+        )
+      });
+    }
+    if (data.local_results) {
+      serpFeatures.push({ type: "local_pack" });
+    }
+    if (data.knowledge_graph) {
+      serpFeatures.push({ type: "knowledge_panel" });
+    }
+    return {
+      keyword,
+      position,
+      url,
+      serpFeatures,
+      topResults: topResults.slice(0, 10),
+      checkedAt: /* @__PURE__ */ new Date()
+    };
+  }
+  parseSerpApiResponse(data, domain, keyword) {
+    const topResults = [];
+    const serpFeatures = [];
+    let position = null;
+    let url = null;
+    if (data.organic_results) {
+      for (let i = 0; i < data.organic_results.length; i++) {
+        const result = data.organic_results[i];
+        const resultDomain = this.extractDomain(result.link);
+        topResults.push({
+          position: result.position || i + 1,
+          url: result.link,
+          domain: resultDomain,
+          title: result.title
+        });
+        if (this.domainMatches(resultDomain, domain) && position === null) {
+          position = result.position || i + 1;
+          url = result.link;
+        }
+      }
+    }
+    if (data.answer_box) {
+      serpFeatures.push({
+        type: "featured_snippet",
+        position: 0
+      });
+    }
+    if (data.related_questions) {
+      serpFeatures.push({ type: "people_also_ask" });
+    }
+    return {
+      keyword,
+      position,
+      url,
+      serpFeatures,
+      topResults: topResults.slice(0, 10),
+      checkedAt: /* @__PURE__ */ new Date()
+    };
+  }
+  parseDirectSearchResults(html, domain, keyword) {
+    const topResults = [];
+    let position = null;
+    let url = null;
+    const linkRegex = /<a[^>]+href="\/url\?q=([^"&]+)/g;
+    let match;
+    let index = 0;
+    while ((match = linkRegex.exec(html)) !== null && index < 100) {
+      try {
+        const decodedUrl = decodeURIComponent(match[1]);
+        const resultDomain = this.extractDomain(decodedUrl);
+        if (resultDomain.includes("google.com") || resultDomain.includes("gstatic.com")) {
+          continue;
+        }
+        index++;
+        topResults.push({
+          position: index,
+          url: decodedUrl,
+          domain: resultDomain
+        });
+        if (this.domainMatches(resultDomain, domain) && position === null) {
+          position = index;
+          url = decodedUrl;
+        }
+      } catch {
+      }
+    }
+    return {
+      keyword,
+      position,
+      url,
+      serpFeatures: [],
+      // Direct scraping doesn't easily extract SERP features
+      topResults: topResults.slice(0, 10),
+      checkedAt: /* @__PURE__ */ new Date()
+    };
+  }
+  extractDomain(url) {
+    try {
+      const parsed = new URL(url);
+      return parsed.hostname.replace(/^www\./, "");
+    } catch {
+      return "";
+    }
+  }
+  domainMatches(resultDomain, targetDomain) {
+    const normalizedResult = resultDomain.toLowerCase().replace(/^www\./, "");
+    const normalizedTarget = targetDomain.toLowerCase().replace(/^www\./, "");
+    return normalizedResult === normalizedTarget || normalizedResult.endsWith(`.${normalizedTarget}`);
+  }
+};
+
+// src/ranking/tracker.ts
+var RankTracker = class {
+  supabase;
+  serpClient;
+  constructor(config) {
+    this.supabase = config.supabase;
+    this.serpClient = new SerpClient(config.serpConfig);
+  }
+  /**
+   * Add keywords to track for a project
+   */
+  async addKeywords(projectId, keywords, options) {
+    const keywordRecords = keywords.map((keyword) => ({
+      project_id: projectId,
+      keyword: keyword.toLowerCase().trim(),
+      search_engine: options?.searchEngine || "google",
+      country: options?.country || "US",
+      language: options?.language || "en",
+      track_url: options?.trackUrl,
+      is_active: true
+    }));
+    const { data, error } = await this.supabase.from("keywords").upsert(keywordRecords, {
+      onConflict: "project_id,keyword",
+      ignoreDuplicates: false
+    }).select();
+    if (error) {
+      throw new Error(`Failed to add keywords: ${error.message}`);
+    }
+    return (data || []).map(this.mapKeyword);
+  }
+  /**
+   * Remove keywords from tracking
+   */
+  async removeKeywords(projectId, keywords) {
+    const normalizedKeywords = keywords.map((k) => k.toLowerCase().trim());
+    const { error } = await this.supabase.from("keywords").update({ is_active: false }).eq("project_id", projectId).in("keyword", normalizedKeywords);
+    if (error) {
+      throw new Error(`Failed to remove keywords: ${error.message}`);
+    }
+  }
+  /**
+   * Get all tracked keywords for a project
+   */
+  async getKeywords(projectId, includeInactive = false) {
+    let query = this.supabase.from("keywords").select("*").eq("project_id", projectId);
+    if (!includeInactive) {
+      query = query.eq("is_active", true);
+    }
+    const { data, error } = await query;
+    if (error) {
+      throw new Error(`Failed to get keywords: ${error.message}`);
+    }
+    return (data || []).map(this.mapKeyword);
+  }
+  /**
+   * Check rankings for all active keywords in a project
+   */
+  async checkRankings(projectId, domain) {
+    const keywords = await this.getKeywords(projectId);
+    if (keywords.length === 0) {
+      return [];
+    }
+    const groups = this.groupKeywords(keywords);
+    const results = [];
+    for (const group of groups) {
+      const checkResults = await this.serpClient.checkRank({
+        keywords: group.keywords.map((k) => k.keyword),
+        domain,
+        searchEngine: group.searchEngine,
+        country: group.country,
+        language: group.language
+      });
+      for (const result of checkResults) {
+        const keyword = group.keywords.find((k) => k.keyword === result.keyword);
+        if (!keyword) continue;
+        await this.saveRanking(keyword.id, result);
+        results.push({
+          keywordId: keyword.id,
+          keyword: result.keyword,
+          position: result.position,
+          url: result.url,
+          serpFeatures: result.serpFeatures,
+          competitorUrls: result.topResults,
+          checkedAt: result.checkedAt
+        });
+      }
+    }
+    await this.supabase.from("projects").update({ last_rank_check_at: (/* @__PURE__ */ new Date()).toISOString() }).eq("id", projectId);
+    return results;
+  }
+  /**
+   * Save a ranking result to the database
+   */
+  async saveRanking(keywordId, result) {
+    const { data: currentKeyword } = await this.supabase.from("keywords").select("current_position, best_position").eq("id", keywordId).single();
+    const previousPosition = currentKeyword?.current_position;
+    const bestPosition = currentKeyword?.best_position;
+    const newBestPosition = result.position !== null && (bestPosition === null || result.position < bestPosition) ? result.position : bestPosition;
+    const { error: updateError } = await this.supabase.from("keywords").update({
+      previous_position: previousPosition,
+      current_position: result.position,
+      best_position: newBestPosition,
+      last_checked: result.checkedAt.toISOString()
+    }).eq("id", keywordId);
+    if (updateError) {
+      console.error(`Failed to save ranking for ${result.keyword}:`, updateError);
+    }
+  }
+  /**
+   * Get ranking history for a keyword
+   * Note: Full history requires keyword_ranking_history table with keyword_ranking_id
+   * For now, returns current state as single history entry
+   */
+  async getHistory(keywordId, _days = 30) {
+    const { data, error } = await this.supabase.from("keywords").select("current_position, target_url, last_checked").eq("id", keywordId).single();
+    if (error || !data) {
+      return [];
+    }
+    return [{
+      position: data.current_position,
+      url: data.target_url,
+      serpFeatures: [],
+      recordedAt: data.last_checked ? new Date(data.last_checked) : /* @__PURE__ */ new Date()
+    }];
+  }
+  /**
+   * Get keyword trends for a project
+   */
+  async getTrends(projectId) {
+    const { data, error } = await this.supabase.from("keyword_rank_trends").select("*").eq("project_id", projectId);
+    if (error) {
+      return this.calculateTrends(projectId);
+    }
+    return (data || []).map((row) => ({
+      keywordId: row.keyword_id,
+      keyword: row.keyword,
+      currentPosition: row.current_position,
+      bestPosition: row.best_position,
+      positionChange: row.position_change || 0,
+      avgPosition: row.avg_position || 0,
+      dataPoints: row.data_points || 0
+    }));
+  }
+  /**
+   * Manual trend calculation fallback
+   */
+  async calculateTrends(projectId) {
+    const keywords = await this.getKeywords(projectId);
+    const trends = [];
+    for (const keyword of keywords) {
+      const history = await this.getHistory(keyword.id, 30);
+      if (history.length === 0) {
+        trends.push({
+          keywordId: keyword.id,
+          keyword: keyword.keyword,
+          currentPosition: keyword.currentPosition,
+          bestPosition: keyword.bestPosition,
+          positionChange: 0,
+          avgPosition: keyword.currentPosition || 0,
+          dataPoints: 0
+        });
+        continue;
+      }
+      const positions = history.filter((h) => h.position !== null).map((h) => h.position);
+      const avgPosition = positions.length > 0 ? positions.reduce((a, b) => a + b, 0) / positions.length : 0;
+      const positionChange = keyword.previousPosition && keyword.currentPosition ? keyword.previousPosition - keyword.currentPosition : 0;
+      trends.push({
+        keywordId: keyword.id,
+        keyword: keyword.keyword,
+        currentPosition: keyword.currentPosition,
+        bestPosition: keyword.bestPosition,
+        positionChange,
+        avgPosition,
+        dataPoints: history.length
+      });
+    }
+    return trends;
+  }
+  /**
+   * Export ranking data as CSV
+   */
+  async exportCSV(projectId, days = 30) {
+    const keywords = await this.getKeywords(projectId);
+    const rows = ["Keyword,Current Position,Best Position,Last Checked,Trend"];
+    for (const keyword of keywords) {
+      const history = await this.getHistory(keyword.id, days);
+      const trend = this.calculatePositionTrend(history);
+      rows.push([
+        `"${keyword.keyword}"`,
+        keyword.currentPosition?.toString() || "N/A",
+        keyword.bestPosition?.toString() || "N/A",
+        keyword.lastChecked?.toISOString() || "Never",
+        trend
+      ].join(","));
+    }
+    return rows.join("\n");
+  }
+  /**
+   * Calculate position trend from history
+   */
+  calculatePositionTrend(history) {
+    if (history.length < 2) return "\u2192";
+    const recent = history[0]?.position;
+    const older = history[history.length - 1]?.position;
+    if (recent === null || older === null) return "\u2192";
+    if (recent < older) return "\u2191";
+    if (recent > older) return "\u2193";
+    return "\u2192";
+  }
+  /**
+   * Group keywords by search engine and country
+   */
+  groupKeywords(keywords) {
+    const groups = /* @__PURE__ */ new Map();
+    for (const keyword of keywords) {
+      const key = `${keyword.searchEngine}:${keyword.country}:${keyword.language}`;
+      if (!groups.has(key)) {
+        groups.set(key, []);
+      }
+      groups.get(key).push(keyword);
+    }
+    return Array.from(groups.entries()).map(([key, keywords2]) => {
+      const [searchEngine, country, language] = key.split(":");
+      return {
+        searchEngine,
+        country,
+        language,
+        keywords: keywords2
+      };
+    });
+  }
+  /**
+   * Map database row to TrackedKeyword
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  mapKeyword(row) {
+    return {
+      id: row.id,
+      projectId: row.project_id,
+      keyword: row.keyword,
+      searchEngine: row.search_engine || "google",
+      country: row.country || "US",
+      language: row.language || "en",
+      currentPosition: row.current_position,
+      previousPosition: row.previous_position,
+      bestPosition: row.best_position,
+      trackUrl: row.track_url,
+      isActive: row.is_active,
+      lastChecked: row.last_checked ? new Date(row.last_checked) : null,
+      createdAt: new Date(row.created_at)
+    };
+  }
+};
+
 // src/analyzers/index.ts
 var analyzers_exports = {};
 __export(analyzers_exports, {
@@ -38506,9 +39260,12 @@ if (typeof globalThis !== "undefined") {
   LOCATION_CODES,
   OG_IMAGE_SPECS,
   PRIORITY_WEIGHTS,
+  RankTracker,
   SEO_SCOPES,
   SITE_PROFILE_QUESTIONS,
   Schemas,
+  SerpClient,
+  TIER_LIMITS,
   addTrackingResult,
   analyzeAnchorText,
   analyzeCanonicalAdvanced,