@rankcli/cli 0.0.32 → 0.0.33

package/README.md

@@ -211,7 +211,7 @@ rankcli apply --url https://mysite.com --auto      # Auto-apply
 
 ### `rankcli keywords`
 
-AI-powered keyword research.
+AI-powered keyword research. `--ai` runs on the same provider as `audit --ai` (Apple Intelligence on a Mac that has it, else your key, else a local Ollama) and takes the same `--ai-provider` / `--ai-key` / `--ai-model` / `--ai-base-url` flags. Keyword clustering uses embeddings on OpenAI and term vectors everywhere else; local models judge 5 tool ideas instead of 15.
 
 ```bash
 rankcli keywords --url https://mysite.com --ai

package/dist/index.js

@@ -1922,19 +1922,27 @@ Respond with only this JSON object - no prose, no code fences:
 }`;
 }
 async function runAIAnalysis(url, issues, ai) {
-  const system = "You are an SEO expert. Respond with valid JSON only.";
+  const reply = await completeWithAI(ai, {
+    system: "You are an SEO expert. Respond with valid JSON only.",
+    prompt: buildPrompt(url, issues, ai.provider === "apple" ? APPLE_MAX_ISSUES : MAX_ISSUES_IN_PROMPT),
+    json: true
+  });
+  if ("error" in reply) return reply;
+  return parseAnalysis(reply.text, ai);
+}
+async function completeWithAI(ai, request) {
+  const { system, prompt } = request;
   if (ai.provider === "apple" && ai.helper) {
     const reply = await generateWithAppleAI(ai.helper, {
       system,
-      prompt: buildPrompt(url, issues, APPLE_MAX_ISSUES),
-      maxTokens: APPLE_MAX_TOKENS
+      prompt,
+      maxTokens: Math.min(request.maxTokens ?? APPLE_MAX_TOKENS, APPLE_MAX_TOKENS)
     });
     if ("error" in reply) return { error: `${ai.label} request failed: ${reply.error}` };
-    return parseAnalysis(reply.text, ai);
+    return reply;
   }
-  const prompt = buildPrompt(url, issues);
   const timeoutMs = ai.local ? 3e5 : 9e4;
-  const maxTokens = 4096;
+  const maxTokens = Math.max(request.maxTokens ?? 4096, 4096);
   const headers = { "Content-Type": "application/json" };
   let endpoint;
   let body;
@@ -1942,7 +1950,7 @@ async function runAIAnalysis(url, issues, ai) {
     endpoint = `${ai.baseUrl}/messages`;
     headers["x-api-key"] = ai.apiKey || "";
     headers["anthropic-version"] = "2023-06-01";
-    body = { model: ai.model, max_tokens: maxTokens, system, messages: [{ role: "user", content: prompt }] };
+    body = { model: ai.model, max_tokens: maxTokens, ...system ? { system } : {}, messages: [{ role: "user", content: prompt }] };
   } else {
     endpoint = `${ai.baseUrl}/chat/completions`;
     if (ai.apiKey) headers["Authorization"] = `Bearer ${ai.apiKey}`;
@@ -1953,12 +1961,12 @@ async function runAIAnalysis(url, issues, ai) {
     body = {
       model: ai.model,
       messages: [
-        { role: "system", content: system },
+        ...system ? [{ role: "system", content: system }] : [],
         { role: "user", content: prompt }
       ],
       // OpenAI's GPT-5.6 rejects max_tokens (and temperature); everyone else expects max_tokens.
       ...ai.provider === "openai" && !ai.local ? { max_completion_tokens: maxTokens } : { max_tokens: maxTokens },
-      ...ai.jsonMode ? { response_format: { type: "json_object" } } : {}
+      ...ai.jsonMode && request.json ? { response_format: { type: "json_object" } } : {}
     };
   }
   let response;
@@ -1982,7 +1990,7 @@ async function runAIAnalysis(url, issues, ai) {
   if (!content) {
     return { error: `${ai.label} returned no content (a reasoning model may have used its whole token budget - try another --ai-model)` };
   }
-  return parseAnalysis(content, ai);
+  return { text: content };
 }
 function parseAnalysis(content, ai) {
   const parsed = extractJsonObject(content);
@@ -3238,7 +3246,7 @@ async function trackHistory(options) {
     }
     const days = options.days || 30;
     const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1e3);
-    const { data: historyData, error } = await supabase.from("rankings").select("position, url, recorded_at").eq("keyword_id", keywordData.id).gte("recorded_at", cutoff.toISOString()).order("recorded_at", { ascending: false });
+    const { data: historyData, error } = await supabase.from("keyword_position_history").select("position, url, checked_at").eq("keyword_id", keywordData.id).gte("checked_at", cutoff.toISOString()).order("checked_at", { ascending: false });
     if (error) {
       spinner.fail(`Failed to load history: ${error.message}`);
       return { success: false, error: error.message };
@@ -3247,7 +3255,7 @@ async function trackHistory(options) {
     const history = (historyData || []).map((row) => ({
       position: row.position,
       url: row.url,
-      recordedAt: new Date(row.recorded_at)
+      recordedAt: new Date(row.checked_at)
     }));
     if (options.output === "json") {
       console.log(JSON.stringify({ keyword: options.keyword, history }, null, 2));
@@ -3255,7 +3263,9 @@ async function trackHistory(options) {
       console.log("\n" + import_chalk6.default.bold(`\u{1F4C8} History: "${options.keyword}"`));
       console.log("\u2550".repeat(50));
       if (history.length === 0) {
-        console.log(import_chalk6.default.dim("\nNo history available yet.\n"));
+        console.log(import_chalk6.default.dim(`
+No checks recorded yet. Run 'rankcli track check --url <your site>' to record one.
+`));
       } else {
         const positions = history.slice(0, 30).reverse().map((h) => h.position || 101);
         const sparkline = positions.map((p) => {
@@ -3266,7 +3276,7 @@ async function trackHistory(options) {
         }).join("");
         console.log(`
   ${sparkline}  (last ${positions.length} checks)`);
-        console.log(import_chalk6.default.dim("  \u2190 newer                    older \u2192\n"));
+        console.log(import_chalk6.default.dim("  \u2190 older                    newer \u2192\n"));
         const recent = history.slice(0, 10);
         for (const entry of recent) {
           console.log(`  ${entry.recordedAt.toLocaleDateString()}  ${formatPosition(entry.position)}`);
@@ -3580,6 +3590,40 @@ async function geo(options) {
 // src/commands/keywords.ts
 var readline2 = __toESM(require("readline"));
 var import_agent_runtime7 = require("@rankcli/agent-runtime");
+
+// src/lib/keyword-llm.ts
+async function openAIEmbeddings(ai, texts) {
+  const response = await fetch(`${ai.baseUrl}/embeddings`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", Authorization: `Bearer ${ai.apiKey}` },
+    body: JSON.stringify({ model: "text-embedding-3-small", input: texts }),
+    signal: AbortSignal.timeout(6e4)
+  });
+  if (!response.ok) throw new Error(`OpenAI embeddings returned HTTP ${response.status}`);
+  const data = await response.json();
+  return data.data.map((item) => item.embedding);
+}
+function keywordLLMFromAI(ai) {
+  const llm = {
+    async complete(prompt, opts = {}) {
+      const reply = await completeWithAI(ai, { system: opts.system, prompt, maxTokens: opts.maxTokens, json: true });
+      if ("error" in reply) throw new Error(reply.error);
+      return reply.text;
+    }
+  };
+  if (ai.provider === "openai" && ai.apiKey && ai.jsonMode) {
+    llm.embed = (texts) => openAIEmbeddings(ai, texts);
+  }
+  if (ai.provider === "apple") {
+    llm.maxContentChars = 5e3;
+    llm.maxToolIdeas = 5;
+  } else if (ai.local) {
+    llm.maxToolIdeas = 5;
+  }
+  return llm;
+}
+
+// src/commands/keywords.ts
 async function keywords(options) {
   console.log("\n\u{1F511} RankCLI - Keyword Research\n");
   console.log("This tool helps you find keywords you can actually rank for,");
@@ -3740,65 +3784,37 @@ async function keywordsQuick(url, providedSeeds) {
 `);
   }
 }
-var SUPABASE_URL = "https://eqzlmjbvrtrglknphdai.supabase.co";
 async function keywordsAI(url, options = {}) {
   console.log("\n\u{1F916} AI-Powered Keyword Research\n");
-  console.log("This uses GPT-4 to analyze your site and generate keyword recommendations");
-  console.log("with competitive analysis and free tool ideas.\n");
-  const openaiApiKey = options.openaiApiKey || process.env.OPENAI_API_KEY;
   try {
     const parsed = new URL(url.startsWith("http") ? url : `https://${url}`);
     url = parsed.href;
-    console.log(`\u{1F4CD} Analyzing: ${url}`);
-    console.log("");
-    if (!options.forceLocal) {
-      console.log("\u{1F517} Connecting to RankCLI cloud...");
-      try {
-        const response = await fetch(`${SUPABASE_URL}/functions/v1/ai-keywords`, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json"
-            // Auth header would go here if user is logged in
-          },
-          body: JSON.stringify({
-            url,
-            mode: "analyze"
-          })
-        });
-        if (response.ok) {
-          const result2 = await response.json();
-          if (result2.tier === "free" && result2.teaser) {
-            console.log("\n" + "\u2500".repeat(60));
-            console.log("\u{1F512} FREE TIER - Limited Preview");
-            console.log("\u2500".repeat(60));
-            console.log(`Found ${result2.teaser.totalKeywordsFound} keywords`);
-            console.log(`Top keywords: ${result2.teaser.topKeywords.join(", ")}`);
-            console.log(`
-${result2.teaser.upgradeMessage}`);
-            console.log('\n\u{1F4A1} Run "rankcli login" to access your paid plan features.\n');
-            return;
-          }
-          displayAIKeywordResults(result2);
-          return;
-        } else {
-          const errorText = await response.text();
-          console.log(`\u26A0\uFE0F  Cloud request failed, running locally...
-`);
-        }
-      } catch (err) {
-        console.log("\u26A0\uFE0F  Cloud unavailable, running locally...\n");
-      }
+    const resolution = await resolveAIProvider(options);
+    if (!resolution.ok) {
+      console.log(`\u274C ${resolution.error}`);
+      for (const hint of resolution.hints) console.log(`   ${hint}`);
+      console.log("");
+      process.exitCode = 1;
+      return;
     }
-    if (!openaiApiKey) {
-      console.log("\u274C OpenAI API key required for local processing.");
-      console.log('   Set OPENAI_API_KEY environment variable, or use "rankcli login" for cloud processing.\n');
+    const { ai } = resolution;
+    if (ai.notice) console.log(ai.notice);
+    const check = await completeWithAI(ai, { prompt: 'Reply with the JSON object {"ok": true} and nothing else.', maxTokens: 50, json: true });
+    if ("error" in check) {
+      console.log(`\u274C ${check.error}`);
+      console.log("   Choose another provider with --ai-provider, or fix the key or model and try again.\n");
+      process.exitCode = 1;
       return;
     }
-    console.log("\u{1F52C} Running local AI analysis (this may take a minute)...\n");
+    console.log(`\u{1F4CD} Analyzing: ${url}`);
+    console.log(`\u{1F9E0} Model: ${ai.label} (${ai.model})
+`);
+    console.log(`\u{1F52C} Running AI analysis (${ai.local ? "a few minutes on a local model" : "this may take a minute"})...
+`);
     const result = await (0, import_agent_runtime7.runAIKeywordResearch)({
       url,
       tier: "solo",
-      openaiApiKey,
+      llm: keywordLLMFromAI(ai),
       enableEnhancedToolIdeas: true,
       competitiveSearchKeys: {
         braveApiKey: process.env.BRAVE_API_KEY,
@@ -3811,6 +3827,7 @@ ${result2.teaser.upgradeMessage}`);
     console.log(`
 \u274C Error: ${error instanceof Error ? error.message : "Unknown error"}
 `);
+    process.exitCode = 1;
   }
 }
 function displayAIKeywordResults(result) {
@@ -4222,7 +4239,7 @@ async function testWebhook(channel, webhookUrl) {
 }
 
 // src/version.ts
-var VERSION = "0.0.32";
+var VERSION = "0.0.33";
 
 // src/index.ts
 var program = new import_commander.Command();
@@ -4253,11 +4270,13 @@ program.command("fix").description("Agentic SEO fixer - detect, fix, commit, and
   }
 });
 program.command("geo").description("GEO analysis - Check AI search visibility (ChatGPT, Perplexity, Claude)").option("-u, --url <url>", "URL to analyze").option("-o, --output <format>", "Output format (json, console)", "console").action(geo);
-program.command("keywords").description("AI-powered keyword research with actionable suggestions").option("-u, --url <url>", "Your website URL").option("-s, --seed <keywords>", "Seed keywords (comma-separated)").option("--auto", "Auto-extract seed keywords from your page").option("--quick", "Quick mode - skip questions, use defaults").option("--ai", "Use GPT-4 for enhanced analysis with free tool ideas").option("--local", "Force local processing (skip cloud worker)").option("--competitor", "Competitor gap analysis mode (SpyFu Kombat-style)").option("-c, --competitors <domains>", "Competitor domains (comma-separated)").action(async (options) => {
+program.command("keywords").description("AI-powered keyword research with actionable suggestions").option("-u, --url <url>", "Your website URL").option("-s, --seed <keywords>", "Seed keywords (comma-separated)").option("--auto", "Auto-extract seed keywords from your page").option("--quick", "Quick mode - skip questions, use defaults").option("--ai", "AI keyword research with free tool ideas, on your own provider (Apple Intelligence on a Mac that has it)").option("--ai-provider <provider>", "AI provider for --ai (auto-detected if omitted, or set RANKCLI_AI_PROVIDER)").option("--ai-key <key>", "AI provider API key (or the provider's env var)").option("--ai-model <model>", "Override the provider's default model").option("--ai-base-url <url>", "Any OpenAI-compatible server (implies --ai-provider custom)").option("--local", "No effect; --ai always runs locally on your provider (kept for old scripts)").option("--competitor", "Competitor gap analysis mode (SpyFu Kombat-style)").option("-c, --competitors <domains>", "Competitor domains (comma-separated)").action(async (options) => {
   if (options.ai && options.url) {
     await keywordsAI(options.url, {
-      forceLocal: options.local,
-      openaiApiKey: process.env.OPENAI_API_KEY
+      aiProvider: options.aiProvider,
+      aiKey: options.aiKey,
+      aiModel: options.aiModel,
+      aiBaseUrl: options.aiBaseUrl
     });
   } else if (options.competitor && options.url && options.seed) {
     const seeds = options.seed.split(",").map((s) => s.trim());

package/dist/index.mjs

@@ -1743,19 +1743,27 @@ Respond with only this JSON object - no prose, no code fences:
 }`;
 }
 async function runAIAnalysis(url, issues, ai) {
-  const system = "You are an SEO expert. Respond with valid JSON only.";
+  const reply = await completeWithAI(ai, {
+    system: "You are an SEO expert. Respond with valid JSON only.",
+    prompt: buildPrompt(url, issues, ai.provider === "apple" ? APPLE_MAX_ISSUES : MAX_ISSUES_IN_PROMPT),
+    json: true
+  });
+  if ("error" in reply) return reply;
+  return parseAnalysis(reply.text, ai);
+}
+async function completeWithAI(ai, request) {
+  const { system, prompt } = request;
   if (ai.provider === "apple" && ai.helper) {
     const reply = await generateWithAppleAI(ai.helper, {
       system,
-      prompt: buildPrompt(url, issues, APPLE_MAX_ISSUES),
-      maxTokens: APPLE_MAX_TOKENS
+      prompt,
+      maxTokens: Math.min(request.maxTokens ?? APPLE_MAX_TOKENS, APPLE_MAX_TOKENS)
     });
     if ("error" in reply) return { error: `${ai.label} request failed: ${reply.error}` };
-    return parseAnalysis(reply.text, ai);
+    return reply;
   }
-  const prompt = buildPrompt(url, issues);
   const timeoutMs = ai.local ? 3e5 : 9e4;
-  const maxTokens = 4096;
+  const maxTokens = Math.max(request.maxTokens ?? 4096, 4096);
   const headers = { "Content-Type": "application/json" };
   let endpoint;
   let body;
@@ -1763,7 +1771,7 @@ async function runAIAnalysis(url, issues, ai) {
     endpoint = `${ai.baseUrl}/messages`;
     headers["x-api-key"] = ai.apiKey || "";
     headers["anthropic-version"] = "2023-06-01";
-    body = { model: ai.model, max_tokens: maxTokens, system, messages: [{ role: "user", content: prompt }] };
+    body = { model: ai.model, max_tokens: maxTokens, ...system ? { system } : {}, messages: [{ role: "user", content: prompt }] };
   } else {
     endpoint = `${ai.baseUrl}/chat/completions`;
     if (ai.apiKey) headers["Authorization"] = `Bearer ${ai.apiKey}`;
@@ -1774,12 +1782,12 @@ async function runAIAnalysis(url, issues, ai) {
     body = {
       model: ai.model,
       messages: [
-        { role: "system", content: system },
+        ...system ? [{ role: "system", content: system }] : [],
         { role: "user", content: prompt }
       ],
       // OpenAI's GPT-5.6 rejects max_tokens (and temperature); everyone else expects max_tokens.
       ...ai.provider === "openai" && !ai.local ? { max_completion_tokens: maxTokens } : { max_tokens: maxTokens },
-      ...ai.jsonMode ? { response_format: { type: "json_object" } } : {}
+      ...ai.jsonMode && request.json ? { response_format: { type: "json_object" } } : {}
     };
   }
   let response;
@@ -1803,7 +1811,7 @@ async function runAIAnalysis(url, issues, ai) {
   if (!content) {
     return { error: `${ai.label} returned no content (a reasoning model may have used its whole token budget - try another --ai-model)` };
   }
-  return parseAnalysis(content, ai);
+  return { text: content };
 }
 function parseAnalysis(content, ai) {
   const parsed = extractJsonObject(content);
@@ -3069,7 +3077,7 @@ async function trackHistory(options) {
     }
     const days = options.days || 30;
     const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1e3);
-    const { data: historyData, error } = await supabase.from("rankings").select("position, url, recorded_at").eq("keyword_id", keywordData.id).gte("recorded_at", cutoff.toISOString()).order("recorded_at", { ascending: false });
+    const { data: historyData, error } = await supabase.from("keyword_position_history").select("position, url, checked_at").eq("keyword_id", keywordData.id).gte("checked_at", cutoff.toISOString()).order("checked_at", { ascending: false });
     if (error) {
       spinner.fail(`Failed to load history: ${error.message}`);
       return { success: false, error: error.message };
@@ -3078,7 +3086,7 @@ async function trackHistory(options) {
     const history = (historyData || []).map((row) => ({
       position: row.position,
       url: row.url,
-      recordedAt: new Date(row.recorded_at)
+      recordedAt: new Date(row.checked_at)
     }));
     if (options.output === "json") {
       console.log(JSON.stringify({ keyword: options.keyword, history }, null, 2));
@@ -3086,7 +3094,9 @@ async function trackHistory(options) {
       console.log("\n" + chalk6.bold(`\u{1F4C8} History: "${options.keyword}"`));
       console.log("\u2550".repeat(50));
       if (history.length === 0) {
-        console.log(chalk6.dim("\nNo history available yet.\n"));
+        console.log(chalk6.dim(`
+No checks recorded yet. Run 'rankcli track check --url <your site>' to record one.
+`));
       } else {
         const positions = history.slice(0, 30).reverse().map((h) => h.position || 101);
         const sparkline = positions.map((p) => {
@@ -3097,7 +3107,7 @@ async function trackHistory(options) {
         }).join("");
         console.log(`
   ${sparkline}  (last ${positions.length} checks)`);
-        console.log(chalk6.dim("  \u2190 newer                    older \u2192\n"));
+        console.log(chalk6.dim("  \u2190 older                    newer \u2192\n"));
         const recent = history.slice(0, 10);
         for (const entry of recent) {
           console.log(`  ${entry.recordedAt.toLocaleDateString()}  ${formatPosition(entry.position)}`);
@@ -3421,6 +3431,40 @@ import {
   formatTopicReport,
   runAIKeywordResearch
 } from "@rankcli/agent-runtime";
+
+// src/lib/keyword-llm.ts
+async function openAIEmbeddings(ai, texts) {
+  const response = await fetch(`${ai.baseUrl}/embeddings`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", Authorization: `Bearer ${ai.apiKey}` },
+    body: JSON.stringify({ model: "text-embedding-3-small", input: texts }),
+    signal: AbortSignal.timeout(6e4)
+  });
+  if (!response.ok) throw new Error(`OpenAI embeddings returned HTTP ${response.status}`);
+  const data = await response.json();
+  return data.data.map((item) => item.embedding);
+}
+function keywordLLMFromAI(ai) {
+  const llm = {
+    async complete(prompt, opts = {}) {
+      const reply = await completeWithAI(ai, { system: opts.system, prompt, maxTokens: opts.maxTokens, json: true });
+      if ("error" in reply) throw new Error(reply.error);
+      return reply.text;
+    }
+  };
+  if (ai.provider === "openai" && ai.apiKey && ai.jsonMode) {
+    llm.embed = (texts) => openAIEmbeddings(ai, texts);
+  }
+  if (ai.provider === "apple") {
+    llm.maxContentChars = 5e3;
+    llm.maxToolIdeas = 5;
+  } else if (ai.local) {
+    llm.maxToolIdeas = 5;
+  }
+  return llm;
+}
+
+// src/commands/keywords.ts
 async function keywords(options) {
   console.log("\n\u{1F511} RankCLI - Keyword Research\n");
   console.log("This tool helps you find keywords you can actually rank for,");
@@ -3581,65 +3625,37 @@ async function keywordsQuick(url, providedSeeds) {
 `);
   }
 }
-var SUPABASE_URL = "https://eqzlmjbvrtrglknphdai.supabase.co";
 async function keywordsAI(url, options = {}) {
   console.log("\n\u{1F916} AI-Powered Keyword Research\n");
-  console.log("This uses GPT-4 to analyze your site and generate keyword recommendations");
-  console.log("with competitive analysis and free tool ideas.\n");
-  const openaiApiKey = options.openaiApiKey || process.env.OPENAI_API_KEY;
   try {
     const parsed = new URL(url.startsWith("http") ? url : `https://${url}`);
     url = parsed.href;
-    console.log(`\u{1F4CD} Analyzing: ${url}`);
-    console.log("");
-    if (!options.forceLocal) {
-      console.log("\u{1F517} Connecting to RankCLI cloud...");
-      try {
-        const response = await fetch(`${SUPABASE_URL}/functions/v1/ai-keywords`, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json"
-            // Auth header would go here if user is logged in
-          },
-          body: JSON.stringify({
-            url,
-            mode: "analyze"
-          })
-        });
-        if (response.ok) {
-          const result2 = await response.json();
-          if (result2.tier === "free" && result2.teaser) {
-            console.log("\n" + "\u2500".repeat(60));
-            console.log("\u{1F512} FREE TIER - Limited Preview");
-            console.log("\u2500".repeat(60));
-            console.log(`Found ${result2.teaser.totalKeywordsFound} keywords`);
-            console.log(`Top keywords: ${result2.teaser.topKeywords.join(", ")}`);
-            console.log(`
-${result2.teaser.upgradeMessage}`);
-            console.log('\n\u{1F4A1} Run "rankcli login" to access your paid plan features.\n');
-            return;
-          }
-          displayAIKeywordResults(result2);
-          return;
-        } else {
-          const errorText = await response.text();
-          console.log(`\u26A0\uFE0F  Cloud request failed, running locally...
-`);
-        }
-      } catch (err) {
-        console.log("\u26A0\uFE0F  Cloud unavailable, running locally...\n");
-      }
+    const resolution = await resolveAIProvider(options);
+    if (!resolution.ok) {
+      console.log(`\u274C ${resolution.error}`);
+      for (const hint of resolution.hints) console.log(`   ${hint}`);
+      console.log("");
+      process.exitCode = 1;
+      return;
     }
-    if (!openaiApiKey) {
-      console.log("\u274C OpenAI API key required for local processing.");
-      console.log('   Set OPENAI_API_KEY environment variable, or use "rankcli login" for cloud processing.\n');
+    const { ai } = resolution;
+    if (ai.notice) console.log(ai.notice);
+    const check = await completeWithAI(ai, { prompt: 'Reply with the JSON object {"ok": true} and nothing else.', maxTokens: 50, json: true });
+    if ("error" in check) {
+      console.log(`\u274C ${check.error}`);
+      console.log("   Choose another provider with --ai-provider, or fix the key or model and try again.\n");
+      process.exitCode = 1;
       return;
     }
-    console.log("\u{1F52C} Running local AI analysis (this may take a minute)...\n");
+    console.log(`\u{1F4CD} Analyzing: ${url}`);
+    console.log(`\u{1F9E0} Model: ${ai.label} (${ai.model})
+`);
+    console.log(`\u{1F52C} Running AI analysis (${ai.local ? "a few minutes on a local model" : "this may take a minute"})...
+`);
     const result = await runAIKeywordResearch({
       url,
       tier: "solo",
-      openaiApiKey,
+      llm: keywordLLMFromAI(ai),
       enableEnhancedToolIdeas: true,
       competitiveSearchKeys: {
         braveApiKey: process.env.BRAVE_API_KEY,
@@ -3652,6 +3668,7 @@ ${result2.teaser.upgradeMessage}`);
     console.log(`
 \u274C Error: ${error instanceof Error ? error.message : "Unknown error"}
 `);
+    process.exitCode = 1;
   }
 }
 function displayAIKeywordResults(result) {
@@ -4078,7 +4095,7 @@ async function testWebhook(channel, webhookUrl) {
 }
 
 // src/version.ts
-var VERSION = "0.0.32";
+var VERSION = "0.0.33";
 
 // src/index.ts
 var program = new Command();
@@ -4109,11 +4126,13 @@ program.command("fix").description("Agentic SEO fixer - detect, fix, commit, and
   }
 });
 program.command("geo").description("GEO analysis - Check AI search visibility (ChatGPT, Perplexity, Claude)").option("-u, --url <url>", "URL to analyze").option("-o, --output <format>", "Output format (json, console)", "console").action(geo);
-program.command("keywords").description("AI-powered keyword research with actionable suggestions").option("-u, --url <url>", "Your website URL").option("-s, --seed <keywords>", "Seed keywords (comma-separated)").option("--auto", "Auto-extract seed keywords from your page").option("--quick", "Quick mode - skip questions, use defaults").option("--ai", "Use GPT-4 for enhanced analysis with free tool ideas").option("--local", "Force local processing (skip cloud worker)").option("--competitor", "Competitor gap analysis mode (SpyFu Kombat-style)").option("-c, --competitors <domains>", "Competitor domains (comma-separated)").action(async (options) => {
+program.command("keywords").description("AI-powered keyword research with actionable suggestions").option("-u, --url <url>", "Your website URL").option("-s, --seed <keywords>", "Seed keywords (comma-separated)").option("--auto", "Auto-extract seed keywords from your page").option("--quick", "Quick mode - skip questions, use defaults").option("--ai", "AI keyword research with free tool ideas, on your own provider (Apple Intelligence on a Mac that has it)").option("--ai-provider <provider>", "AI provider for --ai (auto-detected if omitted, or set RANKCLI_AI_PROVIDER)").option("--ai-key <key>", "AI provider API key (or the provider's env var)").option("--ai-model <model>", "Override the provider's default model").option("--ai-base-url <url>", "Any OpenAI-compatible server (implies --ai-provider custom)").option("--local", "No effect; --ai always runs locally on your provider (kept for old scripts)").option("--competitor", "Competitor gap analysis mode (SpyFu Kombat-style)").option("-c, --competitors <domains>", "Competitor domains (comma-separated)").action(async (options) => {
   if (options.ai && options.url) {
     await keywordsAI(options.url, {
-      forceLocal: options.local,
-      openaiApiKey: process.env.OPENAI_API_KEY
+      aiProvider: options.aiProvider,
+      aiKey: options.aiKey,
+      aiModel: options.aiModel,
+      aiBaseUrl: options.aiBaseUrl
     });
   } else if (options.competitor && options.url && options.seed) {
     const seeds = options.seed.split(",").map((s) => s.trim());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rankcli/cli",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "description": "RankCLI - Ship code, get ranked. SEO meets CI/CD.",
   "homepage": "https://rankcli.dev",
   "main": "dist/index.js",
@@ -45,7 +45,7 @@
     "update-version": "node scripts/update-version.js"
   },
   "dependencies": {
-    "@rankcli/agent-runtime": "^0.0.23",
+    "@rankcli/agent-runtime": "^0.0.24",
     "@supabase/supabase-js": "^2.98.0",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",