@seoagent-official/seoagent 1.52.0 → 1.53.0

package/index.js

@@ -532,4 +532,4 @@ trend rather than fixating on a single number.
 `):c.error(`Not logged in. Run \`${f("login")}\` first.`),process.exitCode=1;return}let n=(e.apiBase||t.api_base||_.BASE).replace(/\/$/,""),r=`Bearer ${t.user_token}:${t.website_token}`,o;try{o=await fetch(`${n}/api/cli/whoami`,{method:"GET",headers:{Authorization:r,Accept:"application/json"}})}catch(s){c.error(`Network error: ${s.message}`),process.exitCode=1;return}if(o.status===404){if(e.json){process.stdout.write(`${JSON.stringify({logged_in:!0,server_supports_whoami:!1,api_base:n})}
 `);return}c.warn(`Logged in, but the server at this API base does not support \`/api/cli/whoami\` yet. Update with \`${f("update-cli")}\` (or re-deploy your server).`),c.message(`API base: ${n}`);return}let i=null;try{i=await o.json()}catch{i=null}if(!o.ok||!i||i.status!=="ok"){e.json?process.stdout.write(`${JSON.stringify({logged_in:!0,error:i?.error??`HTTP ${o.status}`})}
 `):c.error(`Could not fetch your account (HTTP ${o.status})${i?.error?`: ${i.error}`:""}`),process.exitCode=1;return}if(e.json){process.stdout.write(`${JSON.stringify({logged_in:!0,...i},null,2)}
-`);return}c.message(Au(i)),i.paid===!1&&c.message(`${U.dim("Upgrade for autopilot:")} ${U.cyan(_.PRICING)}`)}function Au(e){let n=i=>U.dim(i.padEnd(10)),r=[];if(e.email&&(r.push({content:`${U.green("\u2713")} ${U.dim("Logged in as")} ${U.bold(e.email)}`}),r.push({sep:!0})),e.domain&&r.push({content:`${n("Website:")}${U.cyan(e.domain)}`}),e.plan){let i=e.paid?U.bold(U.green(e.plan)):U.bold(e.plan);r.push({content:`${n("Plan:")}${i}`})}e.api_base&&r.push({content:`${n("API:")}${U.dim(e.api_base)}`});let o=`${U.bold(U.cyan("SEOAgent"))}  ${U.dim("\xB7")}  ${U.dim("whoami")}`;return O(r,{width:55,title:o})}import{select as rt,text as nt,confirm as ni,isCancel as M,intro as Iu,outro as Ru}from"@clack/prompts";import Lt from"picocolors";function Pu(){return[{command:"status",label:"Show project status",hint:"Audit, strategy, briefs, content, roadmap \u2014 everything at a glance.",run:async()=>Ue()},{command:"sync",label:"Sync with the cloud dashboard",hint:"Push local .seoagent/ changes + pull dashboard edits.",run:async()=>await H()},{command:"init",label:"Initialize a SEOAgent project",hint:"Scaffold .seoagent/ + the skill file in this directory.",run:async()=>{await Ne()}},{command:"login",label:"Connect this CLI to seoagent.com",hint:"Opens the browser to bind your account.",run:async()=>await We()},{command:"whoami",label:"Show logged-in account",hint:"Email, bound website, plan, API base.",run:async()=>await tt()},{command:"keywords",label:"Keyword research",hint:"Peek (free, one keyword) \xB7 enrich \xB7 discover \xB7 competitor gaps.",run:async()=>{let e=await rt({message:"Which mode?",options:[{value:"peek",label:"peek",hint:"Free, one keyword, no login required"},{value:"enrich",label:"enrich (default)",hint:"Enrich your full strategy (requires login)"},{value:"discover",label:"discover",hint:"Find new keywords to target (paid)"},{value:"competitors",label:"competitors",hint:"Find competitor keyword gaps (paid)"}]});if(!M(e))if(e==="peek"){let t=await nt({message:"Keyword to peek:",placeholder:"saas seo",validate:n=>String(n??"").trim()?void 0:"A keyword is required."});if(M(t))return;await re({peek:String(t)})}else e==="discover"?await re({discover:!0}):e==="competitors"?await re({competitors:!0}):await re()}},{command:"internal-links",label:"Analyze internal links",hint:"Find orphan pages \u2192 .seoagent/internal-links.md",run:async()=>ze({})},{command:"okf",label:"Open Knowledge Format bundle",hint:"Make your site AI-readable (AEO/GEO) \u2192 .seoagent/okf/",run:async()=>{let e=await rt({message:"Which OKF action?",options:[{value:"status",label:"status",hint:"Is a bundle present?"},{value:"scaffold",label:"scaffold",hint:"Create the starter bundle"},{value:"validate",label:"validate",hint:"Check type fields, timestamps, links"}]});M(e)||Ve(e==="status"?void 0:String(e))}},{command:"citations",label:"Measure AI citations (AEO/GEO)",hint:"Are answer engines citing you? Web-grounded \u2192 .seoagent/citations/scorecard.md",run:async()=>await Je()},{command:"generate-image",label:"Generate an image",hint:"Uses the detected (or explicit) provider.",run:async()=>{let e=await nt({message:"Image prompt:",placeholder:"a minimalist cyan box logo",validate:n=>String(n??"").trim()?void 0:"A prompt is required."});if(M(e))return;let t=await nt({message:"Output file path:",placeholder:".seoagent/content/images/hero.png",validate:n=>String(n??"").trim()?void 0:"An output path is required."});M(t)||await et({prompt:String(e),out:String(t)})}},{command:"env-check",label:"Check image-generation provider",hint:"Detect openai / fal / replicate from your env.",run:async()=>Ze({})},{command:"autopilot",label:"Toggle CLI autopilot",hint:"on / off / status \u2014 paid feature for queueing SEO fixes.",run:async()=>{let e=await rt({message:"Autopilot action:",options:[{value:"status",label:"status",hint:"Show current state"},{value:"on",label:"on",hint:"Turn autopilot ON (paid)"},{value:"off",label:"off",hint:"Turn autopilot OFF"}]});M(e)||await Ye(String(e))}},{command:"pull",label:"Pull dashboard changes only",hint:"Cloud \u2192 local. Same as the second half of `sync`.",run:async()=>await fe()},{command:"ack",label:"Close out a pending inbox action",hint:"Mark a .seoagent/inbox/ action completed or failed.",run:async()=>{let e=await nt({message:"Action ID to close out:",placeholder:"action-abc123",validate:r=>String(r??"").trim()?void 0:"Action ID is required."});if(M(e))return;let t=await ni({message:"Mark as failed instead of completed?",initialValue:!1});if(M(t))return;let n;if(t===!0){let r=await nt({message:"Reason for failure (optional):",placeholder:"couldn't apply because\u2026"});if(M(r))return;String(r).trim()&&(n=String(r))}await te(String(e),{failed:t===!0,reason:n})}},{command:"upgrade",label:"Upgrade your SEOAgent plan",hint:"Open the pricing page; contextual prompt if logged in.",run:async()=>await Ge()},{command:"update-cli",label:"Update the CLI to the latest version",hint:"npm install -g @seoagent-official/seoagent@latest + refresh your projects",run:async()=>await Ke({})},{command:"refresh",label:"Refresh the skill to your CLI version",hint:"This project \u2014 or every project on the machine via `refresh --all`.",run:async()=>{let e=await rt({message:"Refresh which?",options:[{value:"this",label:"This project",hint:"Just the current directory"},{value:"all",label:"All projects",hint:"Every SEOAgent project on this machine"}]});M(e)||Xe({all:e==="all"})}},{command:"logout",label:"Log out",hint:"Clear stored credentials for seoagent.com.",run:async()=>qe()},{command:"uninstall",label:"Uninstall SEOAgent from this project",hint:"Remove .seoagent/, the skill bundle, and the sync hook.",run:async()=>await Fe({})}]}var ei="__exit__";async function ti(e=Pu()){let t=e.map(o=>({value:o.command,label:o.label,hint:o.hint}));t.push({value:ei,label:"Exit",hint:"Close the menu"});let n=await rt({message:"What would you like to do?",options:t});if(M(n)||n===ei)return!0;let r=e.find(o=>o.command===n);if(!r)return c.warn(`Unknown menu pick "${String(n)}" \u2014 returning to menu.`),!1;try{await r.run()}catch(o){c.error(`\`${r.command}\` failed: ${o.message??String(o)}`)}return!1}async function An(){if(!process.stdin.isTTY){c.info("The menu needs an interactive terminal. Use the regular commands directly, e.g. `seoagent --help`.");return}Iu(`${Lt.bold(Lt.cyan("SEOAgent"))} ${Lt.dim("\xB7 menu")}`);let e=await ti();for(;!e;){let t=await ni({message:"Do another?",initialValue:!0});if(M(t)||t===!1){e=!0;break}e=await ti()}Ru(Lt.dim("See you next time."))}var v=new Ou;v.name("seoagent").description("AI SEO agent for Claude Code").version($).showSuggestionAfterError(!0).showHelpAfterError(!0);v.command("init").description("Initialize SEOAgent project \u2014 creates .seoagent/ and installs the skill file").option("-y, --yes","Non-interactive: use inferred/env/flag values only (requires domain if not inferable)").option("--domain <domain>","Website domain (non-interactive or override)").option("--site-type <type>","Site type: saas, service, product, content, etc.").action(e=>{Ne({yes:e.yes,domain:e.domain,siteType:e.siteType})});v.command("uninstall").description("Remove SEOAgent from this project \u2014 deletes .seoagent/, the skill bundle, and the sync hook").option("-y, --yes","Skip the confirmation prompt (also implied in a non-TTY shell)").option("--global","Also wipe ~/.config/seoagent (login + sync state, all projects)").action(e=>{Fe({yes:e.yes,global:e.global})});v.command("status").description("Show current SEO project state").action(Ue);v.command("login").description("Connect this CLI to your seoagent.com account (browser flow)").option("--api-base <url>","Override API base URL (for testing)").action(e=>{We({apiBase:e.apiBase})});v.command("logout").description("Remove stored credentials for seoagent.com").action(qe);v.command("sync").description("Sync .seoagent/ with your dashboard \u2014 push local changes then pull cloud changes (no-op when not logged in)").option("--silent","Suppress output (used by the Claude Code hook)").option("--force","Re-send every artifact on push; take cloud on every pull conflict").option("--path <relpath>","Push only files matching this path suffix").option("--push-only","Skip the cloud \u2192 local pull pass").option("--pull-only","Skip the local \u2192 cloud push pass (same as `seoagent pull`)").action(e=>{H({silent:e.silent,force:e.force,path:e.path,pushOnly:e.pushOnly,pullOnly:e.pullOnly})});v.command("pull").description("Pull cloud changes into .seoagent/ (dashboard / autopilot / chat edits)").option("--silent","Suppress output").option("--force","Take the cloud version on every conflict (discards local edits)").option("--print <path>","Read-only: print the current cloud body of one artifact to stdout (writes nothing). For conflict diffs.").action(e=>{fe({force:e.force,silent:e.silent,print:e.print})});v.command("ack [action_id]").description("Close out a pending action from .seoagent/inbox/ (omit id for an interactive picker)").option("--failed","Mark as failed instead of completed").option("--reason <text>","Reason for failure (used with --failed)").action((e,t)=>{te(e,{failed:t.failed,reason:t.reason})});v.command("inbox").description("List pending actions queued by autopilot in .seoagent/inbox/").option("--json","Output as JSON (handy for scripting / `jq`)").action(e=>{dn({json:e.json})});v.command("process").description("Sync the inbox, pick which actions to apply, and run them via the Claude Agent SDK (uses your `claude login` session or ANTHROPIC_API_KEY)").option("--yes, -y","Skip the sync + selection prompts; process every pending action (for CI)").option("--model <name>","Override the model the Agent SDK uses (e.g. claude-sonnet-4-5-20250929)").action(e=>{gn({yes:e.yes,model:e.model})});v.command("autopilot <action>").description("Turn CLI autopilot on|off or show status (paid; queues fixes for your agent)").option("--api-base <url>","Override API base URL (for testing)").action((e,t)=>{Ye(e,{apiBase:t.apiBase})});v.command("keywords").description("Enrich keywords with real volume + difficulty + opportunity labels (requires login)").option("--peek <keyword>","Free one-keyword DataForSEO lookup (no login required; daily quota)").option("--seed","Bootstrap an empty inventory from your Google Search Console queries (requires login + GSC)").option("--discover","Find NEW keywords to target from your existing strategy (paid)").option("--competitors","Find keywords competitors rank for that you don\u2019t (paid)").option("--json","Output as JSON (handy for scripting / `jq` \u2014 currently --peek only)").option("--api-base <url>","Override API base URL (for testing)").action(e=>{re({peek:e.peek,seed:e.seed,discover:e.discover,competitors:e.competitors,json:e.json,apiBase:e.apiBase})});v.command("internal-links").description("Analyze the repo for orphan pages (no inbound internal links) \u2192 .seoagent/internal-links.md").option("--json","Print the analysis as JSON instead of writing the report").action(e=>{ze({json:e.json})});v.command("okf [action]").description("Manage the Open Knowledge Format bundle for AI agents \u2014 [validate|scaffold] \u2192 .seoagent/okf/").option("--json","Output result as JSON").action((e,t)=>{Ve(e,{json:t.json})});v.command("citations").description("Measure whether answer engines cite you (AEO/GEO) \u2014 web-grounded via the Claude Agent SDK \u2192 .seoagent/citations/scorecard.md").option("--queries <n>","How many answer-engine queries to test (1\u201312, default 6)",e=>parseInt(e,10)).option("--model <name>","Override the model the Agent SDK uses").option("--json","Also print the parsed report as JSON").action(e=>{Je({queries:e.queries,model:e.model,json:e.json})});v.command("env-check").description("Detect which image generation provider is available (OPENAI / FAL / REPLICATE)").option("--json","Output detection result as JSON").action(e=>{Ze({json:e.json})});v.command("generate-image").description("Generate an image via the detected (or explicit) provider").requiredOption("--prompt <text>","Image prompt").requiredOption("--out <path>","Output file path (relative to cwd or absolute)").option("--provider <name>","Force provider: openai | fal | replicate").option("--size <wxh>","Pixel size hint, e.g. 1024x1024").option("--silent","Suppress progress output").action(e=>{et({prompt:e.prompt,out:e.out,provider:e.provider,size:e.size,silent:e.silent})});v.command("whoami").description("Show the logged-in account: email, bound website, plan, and API base").option("--json","Output as JSON (handy for scripting / `jq`)").option("--api-base <url>","Override API base URL (for testing)").action(e=>{tt({json:e.json,apiBase:e.apiBase})});v.command("upgrade").description("Open the SEOAgent Cloud pricing page in your browser (plan upgrade)").action(Ge);v.command("update-cli").description("Update the SEOAgent CLI to the latest npm version, then refresh every project on this machine").option("--dry-run","Show what would happen without running the install").option("--no-projects","Skip refreshing your other projects after the update").action(e=>{Ke({dryRun:e.dryRun,projects:e.projects})});v.command("refresh").description("Refresh the installed skill to your CLI version. `--all` sweeps every project on this machine.").option("--all","Refresh every registered project, not just this one").action(e=>{Xe({all:e.all})});v.command("menu").description("Interactive menu \u2014 pick a command from a list (no flags required)").action(()=>{An()});process.argv.length===2&&(v.outputHelp(),process.exit(0));v.parse();
+`);return}c.message(Au(i)),i.paid===!1&&c.message(`${U.dim("Upgrade for autopilot:")} ${U.cyan(_.PRICING)}`)}function Au(e){let n=i=>U.dim(i.padEnd(10)),r=[];if(e.email&&(r.push({content:`${U.green("\u2713")} ${U.dim("Logged in as")} ${U.bold(e.email)}`}),r.push({sep:!0})),e.domain&&r.push({content:`${n("Website:")}${U.cyan(e.domain)}`}),e.plan){let i=e.paid?U.bold(U.green(e.plan)):U.bold(e.plan);r.push({content:`${n("Plan:")}${i}`})}e.api_base&&r.push({content:`${n("API:")}${U.dim(e.api_base)}`});let o=`${U.bold(U.cyan("SEOAgent"))}  ${U.dim("\xB7")}  ${U.dim("whoami")}`;return O(r,{width:55,title:o})}import{select as rt,text as nt,confirm as ni,isCancel as M,intro as Iu,outro as Ru}from"@clack/prompts";import Lt from"picocolors";function Pu(){return[{command:"status",label:"Show project status",hint:"Audit, strategy, briefs, content, roadmap \u2014 everything at a glance.",run:async()=>Ue()},{command:"sync",label:"Sync with the cloud dashboard",hint:"Push local .seoagent/ changes + pull dashboard edits.",run:async()=>await H()},{command:"init",label:"Initialize a SEOAgent project",hint:"Scaffold .seoagent/ + the skill file in this directory.",run:async()=>{await Ne()}},{command:"login",label:"Connect this CLI to seoagent.com",hint:"Opens the browser to bind your account.",run:async()=>await We()},{command:"whoami",label:"Show logged-in account",hint:"Email, bound website, plan, API base.",run:async()=>await tt()},{command:"keywords",label:"Keyword research",hint:"Peek (free, one keyword) \xB7 enrich \xB7 discover \xB7 competitor gaps.",run:async()=>{let e=await rt({message:"Which mode?",options:[{value:"peek",label:"peek",hint:"Free, one keyword, no login required"},{value:"enrich",label:"enrich (default)",hint:"Enrich your full strategy (requires login)"},{value:"discover",label:"discover",hint:"Find new keywords to target (paid)"},{value:"competitors",label:"competitors",hint:"Find competitor keyword gaps (paid)"}]});if(!M(e))if(e==="peek"){let t=await nt({message:"Keyword to peek:",placeholder:"saas seo",validate:n=>String(n??"").trim()?void 0:"A keyword is required."});if(M(t))return;await re({peek:String(t)})}else e==="discover"?await re({discover:!0}):e==="competitors"?await re({competitors:!0}):await re()}},{command:"internal-links",label:"Analyze internal links",hint:"Find orphan pages \u2192 .seoagent/internal-links.md",run:async()=>ze({})},{command:"okf",label:"Open Knowledge Format bundle",hint:"Make your site AI-readable (AEO/GEO) \u2192 .seoagent/okf/",run:async()=>{let e=await rt({message:"Which OKF action?",options:[{value:"status",label:"status",hint:"Is a bundle present?"},{value:"scaffold",label:"scaffold",hint:"Create the starter bundle"},{value:"validate",label:"validate",hint:"Check type fields, timestamps, links"}]});M(e)||Ve(e==="status"?void 0:String(e))}},{command:"citations",label:"Measure AI citations (AEO/GEO)",hint:"Are answer engines citing you? Web-grounded \u2192 .seoagent/citations/scorecard.md",run:async()=>await Je()},{command:"generate-image",label:"Generate an image",hint:"Uses the detected (or explicit) provider.",run:async()=>{let e=await nt({message:"Image prompt:",placeholder:"a minimalist cyan box logo",validate:n=>String(n??"").trim()?void 0:"A prompt is required."});if(M(e))return;let t=await nt({message:"Output file path:",placeholder:".seoagent/content/images/hero.png",validate:n=>String(n??"").trim()?void 0:"An output path is required."});M(t)||await et({prompt:String(e),out:String(t)})}},{command:"env-check",label:"Check image-generation provider",hint:"Detect openai / fal / replicate from your env.",run:async()=>Ze({})},{command:"autopilot",label:"Toggle CLI autopilot",hint:"on / off / status \u2014 paid feature for queueing SEO fixes.",run:async()=>{let e=await rt({message:"Autopilot action:",options:[{value:"status",label:"status",hint:"Show current state"},{value:"on",label:"on",hint:"Turn autopilot ON (paid)"},{value:"off",label:"off",hint:"Turn autopilot OFF"}]});M(e)||await Ye(String(e))}},{command:"pull",label:"Pull dashboard changes only",hint:"Cloud \u2192 local. Same as the second half of `sync`.",run:async()=>await fe()},{command:"ack",label:"Close out a pending inbox action",hint:"Mark a .seoagent/inbox/ action completed or failed.",run:async()=>{let e=await nt({message:"Action ID to close out:",placeholder:"action-abc123",validate:r=>String(r??"").trim()?void 0:"Action ID is required."});if(M(e))return;let t=await ni({message:"Mark as failed instead of completed?",initialValue:!1});if(M(t))return;let n;if(t===!0){let r=await nt({message:"Reason for failure (optional):",placeholder:"couldn't apply because\u2026"});if(M(r))return;String(r).trim()&&(n=String(r))}await te(String(e),{failed:t===!0,reason:n})}},{command:"upgrade",label:"Upgrade your SEOAgent plan",hint:"Open the pricing page; contextual prompt if logged in.",run:async()=>await Ge()},{command:"update-cli",label:"Update the CLI to the latest version",hint:"npm install -g @seoagent-official/seoagent@latest + refresh your projects",run:async()=>await Ke({})},{command:"refresh",label:"Refresh the skill to your CLI version",hint:"This project \u2014 or every project on the machine via `refresh --all`.",run:async()=>{let e=await rt({message:"Refresh which?",options:[{value:"this",label:"This project",hint:"Just the current directory"},{value:"all",label:"All projects",hint:"Every SEOAgent project on this machine"}]});M(e)||Xe({all:e==="all"})}},{command:"logout",label:"Log out",hint:"Clear stored credentials for seoagent.com.",run:async()=>qe()},{command:"uninstall",label:"Uninstall SEOAgent from this project",hint:"Remove .seoagent/, the skill bundle, and the sync hook.",run:async()=>await Fe({})}]}var ei="__exit__";async function ti(e=Pu()){let t=e.map(o=>({value:o.command,label:o.label,hint:o.hint}));t.push({value:ei,label:"Exit",hint:"Close the menu"});let n=await rt({message:"What would you like to do?",options:t});if(M(n)||n===ei)return!0;let r=e.find(o=>o.command===n);if(!r)return c.warn(`Unknown menu pick "${String(n)}" \u2014 returning to menu.`),!1;try{await r.run()}catch(o){c.error(`\`${r.command}\` failed: ${o.message??String(o)}`)}return!1}async function An(){if(!process.stdin.isTTY){c.info("The menu needs an interactive terminal. Use the regular commands directly, e.g. `seoagent --help`.");return}Iu(`${Lt.bold(Lt.cyan("SEOAgent"))} ${Lt.dim("\xB7 menu")}`);let e=await ti();for(;!e;){let t=await ni({message:"Do another?",initialValue:!0});if(M(t)||t===!1){e=!0;break}e=await ti()}Ru(Lt.dim("See you next time."))}var v=new Ou;v.name("seoagent").description("AI SEO agent for Claude Code").version($).showSuggestionAfterError(!0).showHelpAfterError(!0);v.command("init").description("Initialize SEOAgent project \u2014 creates .seoagent/ and installs the skill file").option("-y, --yes","Non-interactive: use inferred/env/flag values only (requires domain if not inferable)").option("--domain <domain>","Website domain (non-interactive or override)").option("--site-type <type>","Site type: saas, service, product, content, etc.").action(e=>{Ne({yes:e.yes,domain:e.domain,siteType:e.siteType})});v.command("uninstall").description("Remove SEOAgent from this project \u2014 deletes .seoagent/, the skill bundle, and the sync hook").option("-y, --yes","Skip the confirmation prompt (also implied in a non-TTY shell)").option("--global","Also wipe ~/.config/seoagent (login + sync state, all projects)").action(e=>{Fe({yes:e.yes,global:e.global})});v.command("status").description("Show current SEO project state").action(Ue);v.command("login").description("Connect this CLI to your seoagent.com account (browser flow)").option("--api-base <url>","Override API base URL (for testing)").action(e=>{We({apiBase:e.apiBase})});v.command("logout").description("Remove stored credentials for seoagent.com").action(qe);v.command("sync").description("Sync .seoagent/ with your dashboard \u2014 push local changes then pull cloud changes (no-op when not logged in)").option("--silent","Suppress output (used by the Claude Code hook)").option("--force","Re-send every artifact on push; take cloud on every pull conflict").option("--path <relpath>","Push only files matching this path suffix").option("--push-only","Skip the cloud \u2192 local pull pass").option("--pull-only","Skip the local \u2192 cloud push pass (same as `seoagent pull`)").action(e=>{H({silent:e.silent,force:e.force,path:e.path,pushOnly:e.pushOnly,pullOnly:e.pullOnly})});v.command("pull").description("Pull cloud changes into .seoagent/ (dashboard / autopilot / chat edits)").option("--silent","Suppress output").option("--force","Take the cloud version on every conflict (discards local edits)").option("--print <path>","Read-only: print the current cloud body of one artifact to stdout (writes nothing). For conflict diffs.").action(e=>{fe({force:e.force,silent:e.silent,print:e.print})});v.command("ack [action_id]").description("Close out a pending action from .seoagent/inbox/ (omit id for an interactive picker)").option("--failed","Mark as failed instead of completed").option("--reason <text>","Reason for failure (used with --failed)").action((e,t)=>{te(e,{failed:t.failed,reason:t.reason})});v.command("inbox").description("List pending actions queued by autopilot in .seoagent/inbox/").option("--json","Output as JSON (handy for scripting / `jq`)").action(e=>{dn({json:e.json})});v.command("process").description("Sync the inbox, pick which actions to apply, and run them via the Claude Agent SDK (uses your `claude login` session or ANTHROPIC_API_KEY)").option("--yes, -y","Skip the sync + selection prompts; process every pending action (for CI)").option("--model <name>","Override the model the Agent SDK uses (e.g. claude-sonnet-4-5-20250929)").action(e=>{gn({yes:e.yes,model:e.model})});v.command("autopilot <action>").description("Turn CLI autopilot on|off or show status (paid; queues fixes for your agent)").option("--api-base <url>","Override API base URL (for testing)").action((e,t)=>{Ye(e,{apiBase:t.apiBase})});v.command("keywords").description("Enrich keywords with real volume + difficulty + opportunity labels (requires login)").option("--peek <keyword>","Free one-keyword DataForSEO lookup (no login required; daily quota)").option("--seed","Add the queries your site already ranks for (Google Search Console) to the inventory \u2014 additive, keeps existing keywords (requires login + GSC)").option("--discover","Find NEW keywords to target from your existing strategy (paid)").option("--competitors","Find keywords competitors rank for that you don\u2019t (paid)").option("--json","Output as JSON (handy for scripting / `jq` \u2014 currently --peek only)").option("--api-base <url>","Override API base URL (for testing)").action(e=>{re({peek:e.peek,seed:e.seed,discover:e.discover,competitors:e.competitors,json:e.json,apiBase:e.apiBase})});v.command("internal-links").description("Analyze the repo for orphan pages (no inbound internal links) \u2192 .seoagent/internal-links.md").option("--json","Print the analysis as JSON instead of writing the report").action(e=>{ze({json:e.json})});v.command("okf [action]").description("Manage the Open Knowledge Format bundle for AI agents \u2014 [validate|scaffold] \u2192 .seoagent/okf/").option("--json","Output result as JSON").action((e,t)=>{Ve(e,{json:t.json})});v.command("citations").description("Measure whether answer engines cite you (AEO/GEO) \u2014 web-grounded via the Claude Agent SDK \u2192 .seoagent/citations/scorecard.md").option("--queries <n>","How many answer-engine queries to test (1\u201312, default 6)",e=>parseInt(e,10)).option("--model <name>","Override the model the Agent SDK uses").option("--json","Also print the parsed report as JSON").action(e=>{Je({queries:e.queries,model:e.model,json:e.json})});v.command("env-check").description("Detect which image generation provider is available (OPENAI / FAL / REPLICATE)").option("--json","Output detection result as JSON").action(e=>{Ze({json:e.json})});v.command("generate-image").description("Generate an image via the detected (or explicit) provider").requiredOption("--prompt <text>","Image prompt").requiredOption("--out <path>","Output file path (relative to cwd or absolute)").option("--provider <name>","Force provider: openai | fal | replicate").option("--size <wxh>","Pixel size hint, e.g. 1024x1024").option("--silent","Suppress progress output").action(e=>{et({prompt:e.prompt,out:e.out,provider:e.provider,size:e.size,silent:e.silent})});v.command("whoami").description("Show the logged-in account: email, bound website, plan, and API base").option("--json","Output as JSON (handy for scripting / `jq`)").option("--api-base <url>","Override API base URL (for testing)").action(e=>{tt({json:e.json,apiBase:e.apiBase})});v.command("upgrade").description("Open the SEOAgent Cloud pricing page in your browser (plan upgrade)").action(Ge);v.command("update-cli").description("Update the SEOAgent CLI to the latest npm version, then refresh every project on this machine").option("--dry-run","Show what would happen without running the install").option("--no-projects","Skip refreshing your other projects after the update").action(e=>{Ke({dryRun:e.dryRun,projects:e.projects})});v.command("refresh").description("Refresh the installed skill to your CLI version. `--all` sweeps every project on this machine.").option("--all","Refresh every registered project, not just this one").action(e=>{Xe({all:e.all})});v.command("menu").description("Interactive menu \u2014 pick a command from a list (no flags required)").action(()=>{An()});process.argv.length===2&&(v.outputHelp(),process.exit(0));v.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seoagent-official/seoagent",
-  "version": "1.52.0",
+  "version": "1.53.0",
   "description": "The persistent AI SEO agent for Claude Code. Audits, keyword strategy, briefs, articles, and the autopilot loop (cloud detects → CLI executes → ack closes) — other SEO tools write the prompt, SEOAgent runs it.",
   "type": "module",
   "bin": {

package/skills/references/keyword-research.md

@@ -6,7 +6,9 @@ The **local skill alone** (no cloud account) uses `WebSearch` only — no real v
 
 A **free SEOAgent Cloud account** enriches the top ~25 keywords with **real volume + difficulty + opportunity classification** (DataForSEO Labs) — after `seoagent login`, run `seoagent keywords` and the enriched numbers project into `.seoagent/keywords.md`. **Paid upgrade** lifts the cap and unlocks `keywords --discover` (new targets from `keyword_ideas`) and `keywords --competitors` (gap keywords from rivals' `ranked_keywords`).
 
-**Cold start — seed from Search Console.** On a site with **no keyword inventory yet**, the best first move (once `seoagent login` + GSC are connected) is `seoagent keywords --seed`: it bootstraps the inventory from the site's **own impressed GSC queries** — real, inherently relevant, winnable terms (page-2 queries become "striking distance"). Do this *before* `--discover`/`--competitors`, which need an existing topic signal and otherwise return noise. If GSC isn't connected, recommend it (see Phase 2 in `seoagent.md`); if there's simply no impression data yet, fall back to the WebSearch protocol below + `--peek`.
+**Cold start — seed from Search Console.** On a site with **no keyword inventory yet**, the best first move (once `seoagent login` + GSC are connected) is `seoagent keywords --seed`: it adds the site's **own impressed GSC queries** — real, inherently relevant, winnable terms (page-2 queries become "striking distance"). It's **additive** (adds new queries, keeps any existing keywords — never overwrites). Do this *before* `--discover`/`--competitors`, which need a topic signal and otherwise return noise.
+
+**But GSC is historical — segment it against the current positioning.** The queries reflect *past* demand; if the brand/product has **pivoted or rebranded**, some seeds are legacy. Read `.seoagent/context.md`, then split the seeds into **on-strategy** (keep + prioritize) and **legacy/off-strategy** (harvest/defend only — don't anchor the new strategy to them). The pivot's new terms have little GSC history, so generate those forward-looking clusters from the positioning + WebSearch, not from `--seed`. If GSC isn't connected, recommend it (Phase 2 in `seoagent.md`); if the seeded data looks weeks stale, flag a possible GSC-sync lag.
 
 ### Use the Pro discovery commands correctly (avoid garbage)
 

package/skills/seoagent.md

@@ -433,9 +433,12 @@ Orphan pages — pages no other page links to — are hard for crawlers and user
 The single biggest quality lever for the strategy is **real Google Search Console data** — the queries the site *already* gets impressions for are the fastest-ranking wins (often a page-2 → page-1 push). Most users won't think to connect it, so **proactively recommend it before doing keyword work**:
 
 1. **If there's no sign of a cloud/GSC connection, recommend `seoagent login` up front** — phrase it as the value, not a chore: "I can ground this strategy in your actual Search Console data — the queries you already rank for — instead of guessing. It's a free ~30-second `seoagent login` to connect Google Search Console. Want me to wait while you do that?" Don't silently proceed on guesses when one command would make the whole strategy data-driven.
-2. **Once logged in + GSC connected, seed the inventory from real queries first:** `seoagent keywords --seed`. It pulls the site's own impressed queries, enriches them with real volume/difficulty, and labels striking-distance wins — a relevant, winnable starting inventory (no guessing, no junk). This is the **cold-start fix**: don't run `--discover`/`--competitors` on an empty inventory (they return noise — see `references/keyword-research.md`).
-3. **Then layer WebSearch research on top** for whitespace the site doesn't rank for yet, and enrich with `seoagent keywords`.
-4. **No GSC data yet (brand-new site)?** `--seed` will say so — fall back to WebSearch research + `--peek`, and revisit `--seed` once impressions accrue.
+2. **Once logged in + GSC connected, seed the inventory from real queries first:** `seoagent keywords --seed`. It pulls the site's own impressed queries, enriches them with real volume/difficulty, and labels striking-distance wins. **It's additive** — it adds new queries and keeps any keywords you already have; it won't overwrite `keywords.md`. This is the **cold-start fix**: don't run `--discover`/`--competitors` on an empty inventory (they return noise — see `references/keyword-research.md`).
+3. **Segment the GSC seeds against the *current* positioning — don't blindly adopt them.** GSC is **historical** demand, and the business may have **pivoted or rebranded** since (read `.seoagent/context.md` for what the site is *now*). Split the seeded queries into:
+   - **On-strategy** — aligned with the current positioning → keep and prioritize (these are real, winnable, *and* on-message).
+   - **Legacy / off-strategy** — demand from an older brand, product, or audience the site has moved away from → mark as *harvest/defend* (worth keeping rankings, not worth building the new strategy around). Note them as such; don't let them steer the clusters.
+4. **Add forward-looking clusters GSC can't show.** The new direction has little or no search history yet, so it won't appear in `--seed`. Generate those targets from the current positioning (`context.md`) + WebSearch — this is where the strategy points *forward*, not backward.
+5. **No GSC data yet (brand-new site)?** `--seed` will say so — fall back to WebSearch research + `--peek`, and revisit `--seed` once impressions accrue. **Stale GSC?** If the freshest seeded data looks weeks old, the cloud GSC sync may be behind — flag it to the user; the seed is only as fresh as the synced data.
 
 ### Cluster Structure (Hub and Spoke)