seo 0.15.2 → 0.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.js +83 -83
- package/dist/cli.js.map +1 -1
- package/dist/{dist-DOJoZZ9W.js → dist-Bv1JGvEz.js} +1 -1
- package/dist/{dist-Dpl5hSMM.js → dist-CHIJxr2Y.js} +140 -136
- package/dist/dist-CHIJxr2Y.js.map +1 -0
- package/dist/{esm-Dt4JJZ0P.js → esm-CV5s7esU.js} +2 -2
- package/dist/{esm-Dt4JJZ0P.js.map → esm-CV5s7esU.js.map} +1 -1
- package/dist/index.d.ts +55 -7
- package/dist/index.js +727 -147
- package/dist/index.js.map +1 -1
- package/dist/mcp.js +728 -148
- package/dist/mcp.js.map +1 -1
- package/package.json +1 -1
- package/skills/seo/SKILL.md +10 -1
- package/dist/dist-Dpl5hSMM.js.map +0 -1
package/dist/cli.js
CHANGED
|
@@ -1,131 +1,131 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { createRequire as __seoCreateRequire } from 'node:module'; const require = __seoCreateRequire(import.meta.url);
|
|
3
|
-
import{$ as e,$n as t,$t as n,A as r,An as i,At as a,B as o,Bn as s,Bt as c,C as l,Cn as u,Ct as d,D as f,Dn as ee,Dt as te,E as ne,En as p,Et as re,F as m,Fn as ie,Ft as ae,G as oe,Gn as se,Gt as ce,H as le,Hn as ue,Ht as de,I as fe,In as pe,It as me,J as he,Jn as ge,Jt as _e,K as ve,Kn as ye,Kt as be,L as xe,Ln as Se,Lt as Ce,M as we,Mn as Te,Mt as Ee,N as De,Nn as Oe,Nt as ke,O as Ae,On as je,Ot as Me,P as Ne,Pn as Pe,Pt as Fe,Q as Ie,Qn as Le,Qt as Re,R as ze,Rn as Be,Rt as Ve,S as He,Sn as Ue,St as We,T as Ge,Tn as Ke,Tt as qe,U as Je,Un as Ye,Ut as Xe,V as Ze,Vn as Qe,Vt as $e,W as et,Wn as tt,Wt as nt,X as rt,Xn as it,Xt as at,Y as ot,Yn as st,Yt as ct,Z as lt,Zn as ut,Zt as dt,_ as ft,_n as pt,_t as mt,a as ht,an as gt,ar as h,at as _t,b as vt,bn as yt,bt,c as xt,cn as St,cr as Ct,ct as wt,d as Tt,dn as Et,dt as Dt,en as Ot,er as kt,et as At,f as jt,fn as Mt,ft as Nt,g as Pt,gn as Ft,gt as It,h as Lt,hn as Rt,ht as zt,i as Bt,in as Vt,ir as Ht,it as Ut,j as Wt,jn as Gt,jt as Kt,k as qt,kn as Jt,kt as Yt,l as Xt,ln as Zt,lr as Qt,lt as $t,m as en,mn as tn,mt as nn,nn as rn,nr as an,nt as on,o as sn,on as cn,or as ln,ot as un,p as dn,pn as fn,pt as pn,q as mn,qn as hn,qt as gn,rn as _n,rr as vn,rt as yn,sn as bn,sr as xn,st as Sn,t as Cn,tn as wn,tr as Tn,tt as En,u as Dn,un as On,ut as kn,v as An,vn as jn,vt as Mn,w as Nn,wn as Pn,wt as Fn,x as In,xn as Ln,xt as Rn,y as zn,yn as Bn,yt as Vn,z as Hn,zn as Un,zt as Wn}from"./dist-Dpl5hSMM.js";import{randomBytes as Gn}from"node:crypto";import{arch as Kn,homedir as qn,platform as Jn}from"node:os";import{basename as Yn,dirname as Xn,join as g,posix as Zn,relative as Qn,resolve as $n,sep as er,win32 as tr}from"node:path";import{constants as nr,copyFileSync as rr,createWriteStream as ir,existsSync as _,mkdirSync as ar,readFileSync as or,readdirSync as sr,realpathSync as cr,renameSync as lr,rmSync as ur,statSync as dr,writeFileSync as fr}from"node:fs";import{fileURLToPath as pr}from"node:url";import{cp as mr,mkdir as hr,readFile as v,readdir as gr,rename as _r,writeFile as vr}from"node:fs/promises";import{isDeepStrictEqual as yr,stripVTControlCharacters as br}from"node:util";import{spawn as xr,spawnSync as Sr}from"node:child_process";import{defineCommand as y,runCommand as Cr,runMain as wr}from"citty";import{cancel as Tr,confirm as Er,intro as Dr,isCancel as Or,log as kr,multiselect as Ar,note as b,outro as x,password as jr,select as Mr,text as Nr}from"@clack/prompts";import Pr from"picocolors";import Fr from"string-width";import Ir from"cli-table3";import{finished as Lr}from"node:stream/promises";import{applyEdits as Rr,modify as zr,parse as Br,printParseErrorCode as Vr}from"jsonc-parser";import Hr from"update-notifier";const S={summary:/* @__PURE__ */ `workflow.site.generated_at.summary.attribution.confidence.classification.updates_matched.known_confounders.page_segment_status.page_segment_eligible_rows.page_segment_returned_rows.page_segment_limited_rows.page_segment_result_limit.page_segment_source_row_limit.page_segment_source_possibly_truncated.page_segment_warnings.query_segment_status.query_segment_eligible_rows.query_segment_returned_rows.query_segment_limited_rows.query_segment_result_limit.query_segment_source_row_limit.query_segment_source_possibly_truncated.query_segment_warnings.device_segment_status.device_segment_eligible_rows.device_segment_returned_rows.device_segment_limited_rows.device_segment_result_limit.device_segment_source_row_limit.device_segment_source_possibly_truncated.device_segment_warnings.country_segment_status.country_segment_eligible_rows.country_segment_returned_rows.country_segment_limited_rows.country_segment_result_limit.country_segment_source_row_limit.country_segment_source_possibly_truncated.country_segment_warnings`.split(`.`),steps:[`rank`,`tool`,`status`,`summary`],actions:[`rank`,`title`,`confidence`,`action`],findings:[`dimension`,`data_status`,`eligible_rows`,`returned_rows`,`limited_rows`,`result_limit`,`unmatched_rows`,`summary`,`winner_key`,`winner_click_delta`,`winner_impression_delta`,`winner_position_delta`,`loser_key`,`loser_click_delta`,`loser_impression_delta`,`loser_position_delta`],templates:[`rank`,`direction`,`template`,`confidence`,`url_count`,`click_delta`,`impression_delta`,`movement_share`,`movement_share_scope`,`confidence_scope`,`eligible_rows`,`returned_rows`,`limited_rows`,`result_limit`,`source_possibly_truncated`,`common_terms`,`sample_urls`,`summary`],evidence:[`rank`,`evidence`],confounders:[`rank`,`source`,`title`,`date`,`scope`,`target`,`description`],segment:[`rank`,`dimension`,`data_status`,`evidence_scope`,`key`,`before_clicks`,`after_clicks`,`click_delta`,`before_impressions`,`after_impressions`,`impression_delta`,`before_position`,`after_position`,`position_delta`],unmatchedSegment:[`rank`,`dimension`,`data_status`,`key`,`retained_in`,`clicks`,`impressions`,`position`,`reason`]};function Ur(e,t){return[...e.output.segments[t].winners,...e.output.segments[t].losers].map((n,r)=>({rank:r+1,dimension:t,data_status:e.output.segments[t].dataStatus,evidence_scope:n.evidenceScope,key:n.key,before_clicks:n.beforeClicks,after_clicks:n.afterClicks,click_delta:n.clickDelta,before_impressions:n.beforeImpressions,after_impressions:n.afterImpressions,impression_delta:n.impressionDelta,before_position:n.beforePosition,after_position:n.afterPosition,position_delta:n.positionDelta}))}function Wr(e,t){return e.output.segments[t].unmatchedSegments.map((n,r)=>({rank:r+1,dimension:t,data_status:e.output.segments[t].dataStatus,key:n.key,retained_in:n.retainedIn,clicks:n.clicks,impressions:n.impressions,position:n.position,reason:n.reason}))}function Gr(e){return[{filename:`postmortem-summary.csv`,headers:[...S.summary],rows:[{workflow:e.workflow,site:e.site,generated_at:e.generatedAt,summary:e.summary,attribution:e.output.update.attribution,confidence:e.output.update.confidence,classification:e.output.update.classification,updates_matched:e.output.update.overlappingUpdates.length,known_confounders:e.output.update.confounders.length,page_segment_status:e.output.segments.page.dataStatus,page_segment_eligible_rows:e.output.segments.page.coverage.eligibleRows,page_segment_returned_rows:e.output.segments.page.coverage.returnedRows,page_segment_limited_rows:e.output.segments.page.coverage.limitedRows,page_segment_result_limit:e.output.segments.page.coverage.resultLimit,page_segment_source_row_limit:e.output.segments.page.coverage.sourceRowLimit,page_segment_source_possibly_truncated:e.output.segments.page.coverage.sourcePossiblyTruncated,page_segment_warnings:e.output.segments.page.warnings.join(`; `),query_segment_status:e.output.segments.query.dataStatus,query_segment_eligible_rows:e.output.segments.query.coverage.eligibleRows,query_segment_returned_rows:e.output.segments.query.coverage.returnedRows,query_segment_limited_rows:e.output.segments.query.coverage.limitedRows,query_segment_result_limit:e.output.segments.query.coverage.resultLimit,query_segment_source_row_limit:e.output.segments.query.coverage.sourceRowLimit,query_segment_source_possibly_truncated:e.output.segments.query.coverage.sourcePossiblyTruncated,query_segment_warnings:e.output.segments.query.warnings.join(`; `),device_segment_status:e.output.segments.device.dataStatus,device_segment_eligible_rows:e.output.segments.device.coverage.eligibleRows,device_segment_returned_rows:e.output.segments.device.coverage.returnedRows,device_segment_limited_rows:e.output.segments.device.coverage.limitedRows,device_segment_result_limit:e.output.segments.device.coverage.resultLimit,device_segment_source_row_limit:e.output.segments.device.coverage.sourceRowLimit,device_segment_source_possibly_truncated:e.output.segments.device.coverage.sourcePossiblyTruncated,device_segment_warnings:e.output.segments.device.warnings.join(`; `),country_segment_status:e.output.segments.country.dataStatus,country_segment_eligible_rows:e.output.segments.country.coverage.eligibleRows,country_segment_returned_rows:e.output.segments.country.coverage.returnedRows,country_segment_limited_rows:e.output.segments.country.coverage.limitedRows,country_segment_result_limit:e.output.segments.country.coverage.resultLimit,country_segment_source_row_limit:e.output.segments.country.coverage.sourceRowLimit,country_segment_source_possibly_truncated:e.output.segments.country.coverage.sourcePossiblyTruncated,country_segment_warnings:e.output.segments.country.warnings.join(`; `)}]},{filename:`workflow-steps.csv`,headers:[...S.steps],rows:e.steps.map((e,t)=>({rank:t+1,tool:e.tool,status:e.status,summary:e.summary}))},{filename:`workflow-actions.csv`,headers:[...S.actions],rows:e.actions.map((e,t)=>({rank:t+1,title:e.title,confidence:e.confidence,action:e.action}))},{filename:`postmortem-findings.csv`,headers:[...S.findings],rows:e.output.insights.map(e=>({dimension:e.dimension,data_status:e.dataStatus,eligible_rows:e.coverage.eligibleRows,returned_rows:e.coverage.returnedRows,limited_rows:e.coverage.limitedRows,result_limit:e.coverage.resultLimit,unmatched_rows:e.unmatchedRows,summary:e.summary,winner_key:e.winner?.key,winner_click_delta:e.winner?.clickDelta,winner_impression_delta:e.winner?.impressionDelta,winner_position_delta:e.winner?.positionDelta,loser_key:e.loser?.key,loser_click_delta:e.loser?.clickDelta,loser_impression_delta:e.loser?.impressionDelta,loser_position_delta:e.loser?.positionDelta}))},{filename:`postmortem-template-movement.csv`,headers:[...S.templates],rows:e.output.templateMovement.map((e,t)=>({rank:t+1,direction:e.direction,template:e.signature,confidence:e.confidence,url_count:e.urlCount,click_delta:e.clickDelta,impression_delta:e.impressionDelta,movement_share:e.movementShare,movement_share_scope:e.movementShareScope,confidence_scope:e.confidenceScope,eligible_rows:e.segmentCoverage.eligibleRows,returned_rows:e.segmentCoverage.returnedRows,limited_rows:e.segmentCoverage.limitedRows,result_limit:e.segmentCoverage.resultLimit,source_possibly_truncated:e.segmentCoverage.sourcePossiblyTruncated,common_terms:e.commonTerms.join(`; `),sample_urls:e.sampleUrls.join(`; `),summary:e.summary}))},{filename:`postmortem-update-evidence.csv`,headers:[...S.evidence],rows:e.output.update.evidence.map((e,t)=>({rank:t+1,evidence:e}))},{filename:`postmortem-confounders.csv`,headers:[...S.confounders],rows:e.output.update.confounders.map((e,t)=>({rank:t+1,source:e.source,title:e.title,date:e.date,scope:e.scope,target:e.target,description:e.description}))},...[`page`,`query`,`device`,`country`].map(t=>({filename:`postmortem-segment-${t}.csv`,headers:[...S.segment],rows:Ur(e,t)})),...[`page`,`query`,`device`,`country`].map(t=>({filename:`postmortem-segment-${t}-unmatched.csv`,headers:[...S.unmatchedSegment],rows:Wr(e,t)}))]}function Kr(e){return _(e)?sr(e,{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.log`)).map(t=>{let n=g(e,t.name),r=dr(n);return{path:n,size:r.size,modifiedAt:r.mtimeMs}}):[]}function qr(e,t){let n=Xn(e),r=Yn(e,`.log`),i=0;for(;;){let e=g(n,`${r}.${t}${i?`-${i}`:``}.log`);if(!_(e))return e;i+=1}}function Jr(e={}){let n=e.directory??t().logDir,r=e.now??Date.now(),i=e.maxFileBytes??8388608,a=e.maxTotalBytes??67108864,o=e.maxAgeMs??12096e5;ar(n,{recursive:!0,mode:448});let s=0,c=0;for(let e of Kr(n))e.size<=i||(lr(e.path,qr(e.path,r)),s+=1);for(let e of Kr(n))e.modifiedAt>=r-o||(ur(e.path,{force:!0}),c+=1);let l=Kr(n).sort((e,t)=>e.modifiedAt-t.modifiedAt||(e.path<t.path?-1:+(e.path>t.path))),u=l.reduce((e,t)=>e+t.size,0);for(let e of l){if(u<=a)break;ur(e.path,{force:!0}),u-=e.size,c+=1}return{rotated:s,removed:c,sizeBytes:u}}function Yr(e){let t=e-Date.now();if(t<=0)return`expired`;let n=Math.round(t/6e4);if(n<60)return`in ${n}m`;let r=Math.floor(n/60),i=n%60;return i?`in ${r}h ${i}m`:`in ${r}h`}function Xr(e,t){return{type:`boolean`,default:!0,description:e,negativeDescription:t}}function C(e){return typeof e==`string`?e:void 0}function w(e){return typeof e==`boolean`?e:void 0}function Zr(e){let t=C(e.rendering);if(t!==void 0&&t!==`auto`&&t!==`on`&&t!==`off`)throw new h(`INVALID_INPUT`,`--rendering must be auto, on, or off.`);if(w(e.js)===!0&&t&&t!==`on`)throw new h(`INVALID_INPUT`,`Use either --js or --rendering on, not both with different modes.`);return t??(w(e.js)?`on`:`auto`)}function Qr(e,t){let n=w(e[t]);if(n===!1)return!0;if(n===!0)return!1;let r=w(e[$r(t)]);if(r===!1)return!0;if(r===!0)return!1;if(w(e[`no-${t}`])===!0||w(e[`no${ei(t)}`])===!0)return!0}function $r(e){return e.replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function ei(e){let t=$r(e);return t?`${t[0]?.toUpperCase()}${t.slice(1)}`:``}function T(e){if(typeof e==`number`)return e;if(typeof e!=`string`||!e.trim())return;let t=Number(e);return Number.isFinite(t)?t:void 0}function E(e,t){if(e===void 0||e===``)return;let n=T(e);if(n===void 0)throw new h(`INVALID_INPUT`,`${t} must be a number.`);return n}function D(e){if(typeof e!=`string`)return;let t=e.split(`,`).map(e=>e.trim()).filter(Boolean);return t.length?t:void 0}function ti(e){return D(e)??[]}function ni(e){let t={concurrency:T(e[`fetch-concurrency`]),intervalCap:T(e[`fetch-interval-cap`]),intervalMs:T(e[`fetch-interval-ms`])};return Object.values(t).some(e=>e!==void 0)?t:void 0}function O(e){return e.json===!0}async function ri(e,t){let n=C(e),r=C(t);if(n&&r)throw Error(`Use either --body or --body-file, not both.`);if(!n&&!r)return;let i=n??await v(r??``,`utf8`),a=JSON.parse(i);if(!a||typeof a!=`object`||Array.isArray(a))throw Error(`JSON body must be an object.`);return a}function k(e){if(e)return e;throw new h(`INVALID_INPUT`,"No site given. Pass --site with a domain, URL or sc-domain: property. Run `seo sites` to list your Search Console properties.")}async function ii(e,t={}){let n=k(e),r=(await On(t.refresh,t.account)).map(e=>e.siteUrl),i=Tn(r,n);if(!i)throw new h(`PROPERTY_NOT_FOUND`,`This Google login has no Search Console property for ${n}. Run \`seo sites\` to list the properties it can read.`);return i}function ai(e){if(e)return e;throw new h(`INVALID_INPUT`,"No Google Analytics property given. Pass --property with the numeric property id. Run `seo analytics google properties` to list them.")}function oi(e){if(typeof e==`number`)return Number.isFinite(e)?Math.round(e):void 0;if(!e)return;let t=Number.parseInt(e,10);return Number.isFinite(t)?t:void 0}function si(e={}){let t=e.env??process.env,n=oi(e.columns)??oi(e.streamColumns)??oi(t.COLUMNS)??80;return Math.min(200,Math.max(40,n))}function A(e={}){let t=e.env??process.env,n=e.isTTY??!!process.stdout.isTTY,r=e.color??!!(n&&t.NO_COLOR===void 0);return{columns:si({...e,env:t,streamColumns:e.streamColumns??process.stdout.columns}),colors:Pr.createColors(r),hasColor:r,isInteractive:n&&!t.CI}}function j(e){return Fr(br(e))}function ci(e,t){let n=[],r=``;for(let i of e)r&&j(`${r}${i}`)>t?(n.push(r),r=i):r+=i;return r&&n.push(r),n}function li(e,t){if(!e)return[``];let n=e.trim().split(/\s+/u),r=[],i=``;for(let e of n){let n=j(e)>t?ci(e,t):[e];for(let e of n)i?j(`${i} ${e}`)<=t?i+=` ${e}`:(r.push(i),i=e):i=e}return i&&r.push(i),r.length>0?r:[``]}function M(e,t){let n=Math.max(1,t);return e.replaceAll(`\r
|
|
3
|
+
import{$ as e,$n as t,$t as n,A as r,An as i,At as a,B as o,Bn as s,Bt as c,C as l,Cn as u,Ct as d,D as ee,Dn as te,Dt as ne,E as f,En as re,Et as p,F as ie,Fn as ae,Ft as oe,G as se,Gn as ce,Gt as le,H as ue,Hn as de,Ht as fe,I as pe,In as me,It as he,J as ge,Jn as _e,Jt as ve,K as ye,Kn as be,Kt as xe,L as Se,Ln as Ce,Lt as we,M as Te,Mn as Ee,Mt as De,N as Oe,Nn as ke,Nt as Ae,O as je,On as Me,Ot as Ne,P as Pe,Pn as Fe,Pt as Ie,Q as Le,Qn as Re,Qt as ze,R as Be,Rn as Ve,Rt as He,S as Ue,Sn as We,St as Ge,T as Ke,Tn as qe,Tt as Je,U as Ye,Un as Xe,Ut as Ze,V as Qe,Vn as $e,Vt as et,W as tt,Wn as nt,Wt as rt,X as it,Xn as at,Xt as ot,Y as st,Yn as ct,Yt as lt,Z as ut,Zn as dt,Zt as ft,_ as pt,_n as mt,_t as ht,a as gt,an as _t,ar as vt,at as yt,b as bt,bn as xt,bt as St,c as Ct,cn as wt,cr as Tt,ct as Et,d as Dt,dn as Ot,dt as kt,en as At,er as jt,et as Mt,f as Nt,fn as Pt,ft as Ft,g as It,gn as Lt,gt as Rt,h as zt,hn as Bt,ht as Vt,i as Ht,in as Ut,ir as Wt,it as Gt,j as Kt,jn as qt,jt as Jt,k as Yt,kn as Xt,kt as Zt,l as Qt,ln as $t,lr as en,lt as tn,m as nn,mn as rn,mt as an,nn as on,nr as sn,nt as cn,o as ln,on as un,or as m,ot as dn,p as fn,pn,pt as mn,q as hn,qn as gn,qt as _n,rn as vn,rr as yn,rt as bn,sn as xn,sr as Sn,st as Cn,t as wn,tn as Tn,tr as En,tt as Dn,u as On,un as kn,ur as An,ut as jn,v as Mn,vn as Nn,vt as Pn,w as Fn,wn as In,wt as Ln,x as Rn,xn as zn,xt as Bn,y as Vn,yn as Hn,yt as Un,z as Wn,zn as Gn,zt as Kn}from"./dist-CHIJxr2Y.js";import{randomBytes as qn}from"node:crypto";import{arch as Jn,homedir as Yn,platform as Xn}from"node:os";import{basename as Zn,dirname as Qn,join as h,posix as $n,relative as er,resolve as tr,sep as nr,win32 as rr}from"node:path";import{constants as ir,copyFileSync as ar,createWriteStream as or,existsSync as g,mkdirSync as sr,readFileSync as cr,readdirSync as lr,realpathSync as ur,renameSync as dr,rmSync as fr,statSync as pr,writeFileSync as mr}from"node:fs";import{fileURLToPath as hr}from"node:url";import{cp as gr,mkdir as _r,readFile as _,readdir as vr,rename as yr,writeFile as br}from"node:fs/promises";import{isDeepStrictEqual as xr,stripVTControlCharacters as Sr}from"node:util";import{spawn as Cr,spawnSync as wr}from"node:child_process";import{defineCommand as v,runCommand as Tr,runMain as Er}from"citty";import{cancel as Dr,confirm as Or,intro as y,isCancel as kr,log as Ar,multiselect as jr,note as b,outro as x,password as Mr,select as Nr,text as Pr}from"@clack/prompts";import Fr from"picocolors";import Ir from"string-width";import Lr from"cli-table3";import{finished as Rr}from"node:stream/promises";import{applyEdits as zr,modify as Br,parse as Vr,printParseErrorCode as Hr}from"jsonc-parser";import Ur from"update-notifier";const S={summary:/* @__PURE__ */ `workflow.site.generated_at.summary.attribution.confidence.classification.updates_matched.known_confounders.page_segment_status.page_segment_eligible_rows.page_segment_returned_rows.page_segment_limited_rows.page_segment_result_limit.page_segment_source_row_limit.page_segment_source_possibly_truncated.page_segment_warnings.query_segment_status.query_segment_eligible_rows.query_segment_returned_rows.query_segment_limited_rows.query_segment_result_limit.query_segment_source_row_limit.query_segment_source_possibly_truncated.query_segment_warnings.device_segment_status.device_segment_eligible_rows.device_segment_returned_rows.device_segment_limited_rows.device_segment_result_limit.device_segment_source_row_limit.device_segment_source_possibly_truncated.device_segment_warnings.country_segment_status.country_segment_eligible_rows.country_segment_returned_rows.country_segment_limited_rows.country_segment_result_limit.country_segment_source_row_limit.country_segment_source_possibly_truncated.country_segment_warnings`.split(`.`),steps:[`rank`,`tool`,`status`,`summary`],actions:[`rank`,`title`,`confidence`,`action`],findings:[`dimension`,`data_status`,`eligible_rows`,`returned_rows`,`limited_rows`,`result_limit`,`unmatched_rows`,`summary`,`winner_key`,`winner_click_delta`,`winner_impression_delta`,`winner_position_delta`,`loser_key`,`loser_click_delta`,`loser_impression_delta`,`loser_position_delta`],templates:[`rank`,`direction`,`template`,`confidence`,`url_count`,`click_delta`,`impression_delta`,`movement_share`,`movement_share_scope`,`confidence_scope`,`eligible_rows`,`returned_rows`,`limited_rows`,`result_limit`,`source_possibly_truncated`,`common_terms`,`sample_urls`,`summary`],evidence:[`rank`,`evidence`],confounders:[`rank`,`source`,`title`,`date`,`scope`,`target`,`description`],segment:[`rank`,`dimension`,`data_status`,`evidence_scope`,`key`,`before_clicks`,`after_clicks`,`click_delta`,`before_impressions`,`after_impressions`,`impression_delta`,`before_position`,`after_position`,`position_delta`],unmatchedSegment:[`rank`,`dimension`,`data_status`,`key`,`retained_in`,`clicks`,`impressions`,`position`,`reason`]};function Wr(e,t){return[...e.output.segments[t].winners,...e.output.segments[t].losers].map((n,r)=>({rank:r+1,dimension:t,data_status:e.output.segments[t].dataStatus,evidence_scope:n.evidenceScope,key:n.key,before_clicks:n.beforeClicks,after_clicks:n.afterClicks,click_delta:n.clickDelta,before_impressions:n.beforeImpressions,after_impressions:n.afterImpressions,impression_delta:n.impressionDelta,before_position:n.beforePosition,after_position:n.afterPosition,position_delta:n.positionDelta}))}function Gr(e,t){return e.output.segments[t].unmatchedSegments.map((n,r)=>({rank:r+1,dimension:t,data_status:e.output.segments[t].dataStatus,key:n.key,retained_in:n.retainedIn,clicks:n.clicks,impressions:n.impressions,position:n.position,reason:n.reason}))}function Kr(e){return[{filename:`postmortem-summary.csv`,headers:[...S.summary],rows:[{workflow:e.workflow,site:e.site,generated_at:e.generatedAt,summary:e.summary,attribution:e.output.update.attribution,confidence:e.output.update.confidence,classification:e.output.update.classification,updates_matched:e.output.update.overlappingUpdates.length,known_confounders:e.output.update.confounders.length,page_segment_status:e.output.segments.page.dataStatus,page_segment_eligible_rows:e.output.segments.page.coverage.eligibleRows,page_segment_returned_rows:e.output.segments.page.coverage.returnedRows,page_segment_limited_rows:e.output.segments.page.coverage.limitedRows,page_segment_result_limit:e.output.segments.page.coverage.resultLimit,page_segment_source_row_limit:e.output.segments.page.coverage.sourceRowLimit,page_segment_source_possibly_truncated:e.output.segments.page.coverage.sourcePossiblyTruncated,page_segment_warnings:e.output.segments.page.warnings.join(`; `),query_segment_status:e.output.segments.query.dataStatus,query_segment_eligible_rows:e.output.segments.query.coverage.eligibleRows,query_segment_returned_rows:e.output.segments.query.coverage.returnedRows,query_segment_limited_rows:e.output.segments.query.coverage.limitedRows,query_segment_result_limit:e.output.segments.query.coverage.resultLimit,query_segment_source_row_limit:e.output.segments.query.coverage.sourceRowLimit,query_segment_source_possibly_truncated:e.output.segments.query.coverage.sourcePossiblyTruncated,query_segment_warnings:e.output.segments.query.warnings.join(`; `),device_segment_status:e.output.segments.device.dataStatus,device_segment_eligible_rows:e.output.segments.device.coverage.eligibleRows,device_segment_returned_rows:e.output.segments.device.coverage.returnedRows,device_segment_limited_rows:e.output.segments.device.coverage.limitedRows,device_segment_result_limit:e.output.segments.device.coverage.resultLimit,device_segment_source_row_limit:e.output.segments.device.coverage.sourceRowLimit,device_segment_source_possibly_truncated:e.output.segments.device.coverage.sourcePossiblyTruncated,device_segment_warnings:e.output.segments.device.warnings.join(`; `),country_segment_status:e.output.segments.country.dataStatus,country_segment_eligible_rows:e.output.segments.country.coverage.eligibleRows,country_segment_returned_rows:e.output.segments.country.coverage.returnedRows,country_segment_limited_rows:e.output.segments.country.coverage.limitedRows,country_segment_result_limit:e.output.segments.country.coverage.resultLimit,country_segment_source_row_limit:e.output.segments.country.coverage.sourceRowLimit,country_segment_source_possibly_truncated:e.output.segments.country.coverage.sourcePossiblyTruncated,country_segment_warnings:e.output.segments.country.warnings.join(`; `)}]},{filename:`workflow-steps.csv`,headers:[...S.steps],rows:e.steps.map((e,t)=>({rank:t+1,tool:e.tool,status:e.status,summary:e.summary}))},{filename:`workflow-actions.csv`,headers:[...S.actions],rows:e.actions.map((e,t)=>({rank:t+1,title:e.title,confidence:e.confidence,action:e.action}))},{filename:`postmortem-findings.csv`,headers:[...S.findings],rows:e.output.insights.map(e=>({dimension:e.dimension,data_status:e.dataStatus,eligible_rows:e.coverage.eligibleRows,returned_rows:e.coverage.returnedRows,limited_rows:e.coverage.limitedRows,result_limit:e.coverage.resultLimit,unmatched_rows:e.unmatchedRows,summary:e.summary,winner_key:e.winner?.key,winner_click_delta:e.winner?.clickDelta,winner_impression_delta:e.winner?.impressionDelta,winner_position_delta:e.winner?.positionDelta,loser_key:e.loser?.key,loser_click_delta:e.loser?.clickDelta,loser_impression_delta:e.loser?.impressionDelta,loser_position_delta:e.loser?.positionDelta}))},{filename:`postmortem-template-movement.csv`,headers:[...S.templates],rows:e.output.templateMovement.map((e,t)=>({rank:t+1,direction:e.direction,template:e.signature,confidence:e.confidence,url_count:e.urlCount,click_delta:e.clickDelta,impression_delta:e.impressionDelta,movement_share:e.movementShare,movement_share_scope:e.movementShareScope,confidence_scope:e.confidenceScope,eligible_rows:e.segmentCoverage.eligibleRows,returned_rows:e.segmentCoverage.returnedRows,limited_rows:e.segmentCoverage.limitedRows,result_limit:e.segmentCoverage.resultLimit,source_possibly_truncated:e.segmentCoverage.sourcePossiblyTruncated,common_terms:e.commonTerms.join(`; `),sample_urls:e.sampleUrls.join(`; `),summary:e.summary}))},{filename:`postmortem-update-evidence.csv`,headers:[...S.evidence],rows:e.output.update.evidence.map((e,t)=>({rank:t+1,evidence:e}))},{filename:`postmortem-confounders.csv`,headers:[...S.confounders],rows:e.output.update.confounders.map((e,t)=>({rank:t+1,source:e.source,title:e.title,date:e.date,scope:e.scope,target:e.target,description:e.description}))},...[`page`,`query`,`device`,`country`].map(t=>({filename:`postmortem-segment-${t}.csv`,headers:[...S.segment],rows:Wr(e,t)})),...[`page`,`query`,`device`,`country`].map(t=>({filename:`postmortem-segment-${t}-unmatched.csv`,headers:[...S.unmatchedSegment],rows:Gr(e,t)}))]}function qr(e){return g(e)?lr(e,{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.log`)).map(t=>{let n=h(e,t.name),r=pr(n);return{path:n,size:r.size,modifiedAt:r.mtimeMs}}):[]}function Jr(e,t){let n=Qn(e),r=Zn(e,`.log`),i=0;for(;;){let e=h(n,`${r}.${t}${i?`-${i}`:``}.log`);if(!g(e))return e;i+=1}}function Yr(e={}){let t=e.directory??jt().logDir,n=e.now??Date.now(),r=e.maxFileBytes??8388608,i=e.maxTotalBytes??67108864,a=e.maxAgeMs??12096e5;sr(t,{recursive:!0,mode:448});let o=0,s=0;for(let e of qr(t))e.size<=r||(dr(e.path,Jr(e.path,n)),o+=1);for(let e of qr(t))e.modifiedAt>=n-a||(fr(e.path,{force:!0}),s+=1);let c=qr(t).sort((e,t)=>e.modifiedAt-t.modifiedAt||(e.path<t.path?-1:+(e.path>t.path))),l=c.reduce((e,t)=>e+t.size,0);for(let e of c){if(l<=i)break;fr(e.path,{force:!0}),l-=e.size,s+=1}return{rotated:o,removed:s,sizeBytes:l}}function Xr(e){let t=e-Date.now();if(t<=0)return`expired`;let n=Math.round(t/6e4);if(n<60)return`in ${n}m`;let r=Math.floor(n/60),i=n%60;return i?`in ${r}h ${i}m`:`in ${r}h`}function Zr(e,t){return{type:`boolean`,default:!0,description:e,negativeDescription:t}}function C(e){return typeof e==`string`?e:void 0}function w(e){return typeof e==`boolean`?e:void 0}function Qr(e){let t=C(e.rendering);if(t!==void 0&&t!==`auto`&&t!==`on`&&t!==`off`)throw new m(`INVALID_INPUT`,`--rendering must be auto, on, or off.`);if(w(e.js)===!0&&t&&t!==`on`)throw new m(`INVALID_INPUT`,`Use either --js or --rendering on, not both with different modes.`);return t??(w(e.js)?`on`:`auto`)}function $r(e,t){let n=w(e[t]);if(n===!1)return!0;if(n===!0)return!1;let r=w(e[ei(t)]);if(r===!1)return!0;if(r===!0)return!1;if(w(e[`no-${t}`])===!0||w(e[`no${ti(t)}`])===!0)return!0}function ei(e){return e.replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function ti(e){let t=ei(e);return t?`${t[0]?.toUpperCase()}${t.slice(1)}`:``}function T(e){if(typeof e==`number`)return e;if(typeof e!=`string`||!e.trim())return;let t=Number(e);return Number.isFinite(t)?t:void 0}function E(e,t){if(e===void 0||e===``)return;let n=T(e);if(n===void 0)throw new m(`INVALID_INPUT`,`${t} must be a number.`);return n}function D(e){if(typeof e!=`string`)return;let t=e.split(`,`).map(e=>e.trim()).filter(Boolean);return t.length?t:void 0}function ni(e){return D(e)??[]}function ri(e){let t={concurrency:T(e[`fetch-concurrency`]),intervalCap:T(e[`fetch-interval-cap`]),intervalMs:T(e[`fetch-interval-ms`])};return Object.values(t).some(e=>e!==void 0)?t:void 0}function O(e){return e.json===!0}async function ii(e,t){let n=C(e),r=C(t);if(n&&r)throw Error(`Use either --body or --body-file, not both.`);if(!n&&!r)return;let i=n??await _(r??``,`utf8`),a=JSON.parse(i);if(!a||typeof a!=`object`||Array.isArray(a))throw Error(`JSON body must be an object.`);return a}function k(e){if(e)return e;throw new m(`INVALID_INPUT`,"No site given. Pass --site with a domain, URL or sc-domain: property. Run `seo sites` to list your Search Console properties.")}async function ai(e,t={}){let n=k(e),r=(await Ot(t.refresh,t.account)).map(e=>e.siteUrl),i=sn(r,n);if(!i)throw new m(`PROPERTY_NOT_FOUND`,`This Google login has no Search Console property for ${n}. Run \`seo sites\` to list the properties it can read.`);return i}function oi(e){if(e)return e;throw new m(`INVALID_INPUT`,"No Google Analytics property given. Pass --property with the numeric property id. Run `seo analytics google properties` to list them.")}function si(e){if(typeof e==`number`)return Number.isFinite(e)?Math.round(e):void 0;if(!e)return;let t=Number.parseInt(e,10);return Number.isFinite(t)?t:void 0}function ci(e={}){let t=e.env??process.env,n=si(e.columns)??si(e.streamColumns)??si(t.COLUMNS)??80;return Math.min(200,Math.max(40,n))}function A(e={}){let t=e.env??process.env,n=e.isTTY??!!process.stdout.isTTY,r=e.color??!!(n&&t.NO_COLOR===void 0);return{columns:ci({...e,env:t,streamColumns:e.streamColumns??process.stdout.columns}),colors:Fr.createColors(r),hasColor:r,isInteractive:n&&!t.CI}}function j(e){return Ir(Sr(e))}function li(e,t){let n=[],r=``;for(let i of e)r&&j(`${r}${i}`)>t?(n.push(r),r=i):r+=i;return r&&n.push(r),n}function ui(e,t){if(!e)return[``];let n=e.trim().split(/\s+/u),r=[],i=``;for(let e of n){let n=j(e)>t?li(e,t):[e];for(let e of n)i?j(`${i} ${e}`)<=t?i+=` ${e}`:(r.push(i),i=e):i=e}return i&&r.push(i),r.length>0?r:[``]}function M(e,t){let n=Math.max(1,t);return e.replaceAll(`\r
|
|
4
4
|
`,`
|
|
5
5
|
`).split(`
|
|
6
|
-
`).flatMap(e=>
|
|
7
|
-
`)));return i.toString()}function
|
|
6
|
+
`).flatMap(e=>ui(e,n))}function di(e,t){if(j(e)<=t)return e;let n=Math.max(1,t-j(`...`)),r=``;for(let t of e){if(j(`${r}${t}`)>n)break;r+=t}return`${r}...`}const fi={top:``,"top-mid":``,"top-left":``,"top-right":``,bottom:``,"bottom-mid":``,"bottom-left":``,"bottom-right":``,left:``,"left-mid":``,mid:``,"mid-mid":``,right:``,"right-mid":``,middle:``};function pi(e){return e===void 0?``:String(e)}function mi(e,t){return e.map((e,n)=>{let r=t.map(e=>pi(e[n]));return Math.min(42,Math.max(j(e),...r.map(j),4))})}function hi(e,t,n){return e.length===0||e.length>4||!e.map((e,n)=>t.every(e=>/^-?(?:\d+(?:\.\d+)?|\d+(?:\.\d+)?%)$/u.test(pi(e[n]).trim()))).some(Boolean)?!1:mi(e,t).reduce((e,t)=>e+t+2,0)<=n.columns}function gi(e,t,n){if(!/(?:status|state|assessment|data|allowed)/iu.test(e))return t;let r=t.trim().toLowerCase();return[`pass`,`passed`,`completed`,`allowed`,`yes`].includes(r)?n.colors.green(t):[`warn`,`warning`,`review`,`partial`].includes(r)?n.colors.yellow(t):[`fail`,`failed`,`blocked`,`no`].includes(r)?n.colors.red(t):[`unknown`,`unavailable`].includes(r)?n.colors.blue(t):t}function _i(e,t,n){let r=mi(e,t).map(e=>e+2),i=new Lr({chars:fi,colWidths:r,head:e.map(e=>n.colors.bold(e)),style:{border:[],head:[],"padding-left":0,"padding-right":2},wordWrap:!1});for(let a of t)i.push(e.map((e,t)=>M(gi(e,pi(a[t]),n),Math.max(1,(r[t]??3)-2)).join(`
|
|
7
|
+
`)));return i.toString()}function vi(e,t,n,r){let i=r.columns-n-2;return i<24?[r.colors.dim(e),...M(t,r.columns-2).map(e=>` ${e}`)]:M(t,i).map((t,i)=>{let a=i===0?e.padEnd(n):``.padEnd(n);return`${r.colors.dim(a)}${` `.repeat(2)}${t}`})}function yi(e,t,n,r={}){let i=Math.min(28,Math.max(...e.map(e=>j(e)),0)),a=r.rowNumbers??!1,o=String(t.length).length;return t.map((t,r)=>{let s=[];a&&s.push(n.colors.bold(String(r+1).padStart(o,`0`)));for(let[r,a]of e.entries())s.push(...vi(a,gi(a,pi(t[r]),n),i,n));return s.join(`
|
|
8
8
|
`)}).join(`
|
|
9
9
|
|
|
10
|
-
`)}function
|
|
11
|
-
`)}function
|
|
12
|
-
`)}function
|
|
13
|
-
`)}function
|
|
14
|
-
`)}function
|
|
15
|
-
`)}`),e.metrics?.length&&r.push(
|
|
10
|
+
`)}function bi(e,t,n,r={}){return t.length===0?n.colors.dim(`No results.`):r.layout===`table`||r.layout!==`records`&&hi(e,t,n)?_i(e,t,n):yi(e,t,n,r)}function xi(e,t){if(e.length===0)return``;let n=Math.min(28,Math.max(...e.map(([e])=>j(e))));return e.flatMap(([e,r])=>{let i=vi(e,r,n,t);return i.length>0&&(i[0]=(i[0]??``).replace(e,t.colors.bold(e))),i}).join(`
|
|
11
|
+
`)}function Si(e,t){let n=[t.colors.bold(e.title)];return e.body&&n.push(...M(e.body,t.columns)),e.command&&n.push(t.colors.cyan(di(e.command,t.columns))),n.join(`
|
|
12
|
+
`)}function Ci(e,t){return e===`pass`?t.colors.green:e===`warning`?t.colors.yellow:e===`fail`?t.colors.red:e===`unknown`?t.colors.blue:e===`info`?t.colors.cyan:t.colors.dim}function wi(e){return e===`warning`?`WARN`:e===`notApplicable`?`N/A`:e.toUpperCase()}function Ti(e,t,n){let r=` `.repeat(t);return M(e,Math.max(1,n-t)).map(e=>`${r}${e}`)}function Ei(e,t){let n=Ci(e.status,t)(`[${wi(e.status)}]`.padEnd(10)),r=Math.max(1,t.columns-10),i=M(e.title,r).map((e,r)=>`${r===0?n:` `.repeat(10)}${t.colors.bold(e)}`);i.push(...Ti(e.explanation,10,t.columns));for(let n of e.evidence??[]){let e=M(n,Math.max(1,t.columns-20));i.push(...e.map((e,n)=>`${` `.repeat(10)}${n===0?`${t.colors.dim(`Evidence`)} `:` `}${e}`))}if(e.fix){let n=M(e.fix,Math.max(1,t.columns-15));i.push(...n.map((e,n)=>`${` `.repeat(10)}${n===0?`${t.colors.cyan(t.colors.bold(`Fix`))} `:` `}${e}`))}return i.join(`
|
|
13
|
+
`)}function Di(e,t){return M(e.map(e=>{let n=String(e.value),r=e.status?Ci(e.status,t)(n):t.colors.bold(n);return`${e.label} ${r}`}).join(t.colors.dim(` · `)),t.columns).join(`
|
|
14
|
+
`)}function Oi(e,t){let n=Ci(e.status,t),r=[t.colors.bold(e.title)];e.target&&r.push(t.colors.dim(e.target)),r.push(``),r.push(`${n(wi(e.status))} ${M(e.summary,Math.max(1,t.columns-6)).join(`
|
|
15
|
+
`)}`),e.metrics?.length&&r.push(Di(e.metrics,t));for(let n of e.sections.filter(e=>e.diagnostics.length>0))r.push(``,t.colors.bold(n.title)),r.push(n.diagnostics.map(e=>Ei(e,t)).join(`
|
|
16
16
|
|
|
17
17
|
`));if(e.notes?.length){r.push(``,t.colors.bold(`Notes`));for(let n of e.notes){let e=M(n,Math.max(1,t.columns-2));r.push(...e.map((e,t)=>`${t===0?`- `:` `}${e}`))}}return r.join(`
|
|
18
|
-
`)}function
|
|
19
|
-
`)}function
|
|
18
|
+
`)}function ki(e,t,n=`${t}s`){return e===1?t:n}function Ai(e,t,n){let r=` `.repeat(t);return M(e,Math.max(1,n-t)).map(e=>`${r}${e}`)}function ji(e,t,n){return[t.colors.bold(e),...n?M(n,t.columns):[]].join(`
|
|
19
|
+
`)}function Mi(e,t){let n={pass:t.colors.green,warn:t.colors.yellow,fail:t.colors.red};return e.map(e=>{let r=[`${n[e.status](e.status.toUpperCase().padEnd(4))} ${t.colors.bold(e.label)}`];if(r.push(...Ai(e.detail,6,t.columns)),e.fix){let n=M(e.fix,Math.max(1,t.columns-11));r.push(...n.map((e,n)=>`${` `.repeat(6)}${n===0?`${t.colors.bold(`Fix`)} `:` `}${e}`))}return r.join(`
|
|
20
20
|
`)}).join(`
|
|
21
21
|
|
|
22
|
-
`)}function
|
|
22
|
+
`)}function Ni(e){let t=e.filter(e=>e.status===`pass`).length,n=e.filter(e=>e.status===`warn`).length,r=e.filter(e=>e.status===`fail`).length;return`${t} ${ki(t,`check`)} passed, ${n} ${ki(n,`warning`)}, ${r} failed.`}function Pi(e,t,n){let r=n.columns-t-2-2;return r<24||j(e.id)>t?[...Ai(e.id,2,n.columns).map(e=>n.colors.cyan(e)),...Ai(e.name,4,n.columns)].join(`
|
|
23
23
|
`):M(e.name,r).map((r,i)=>{let a=i===0?e.id.padEnd(t):``.padEnd(t);return` ${n.colors.cyan(a)}${` `.repeat(2)}${r}`}).join(`
|
|
24
|
-
`)}function
|
|
24
|
+
`)}function Fi(e){let t=e.replaceAll(`-`,` `);return t.charAt(0).toUpperCase()+t.slice(1)}function Ii(e,t,n){let r=/* @__PURE__ */ new Map;for(let t of e){let e=r.get(t.category)??[];e.push(t),r.set(t.category,e)}let i=`${e.length} ${ki(e.length,n.noun)} across ${r.size} ${ki(r.size,`category`,`categories`)}.`,a=Math.min(30,Math.max(...e.map(e=>j(e.id)),0)),o=Object.keys(n.categoryLabels??{}).filter(e=>r.has(e)),s=[...r.keys()].filter(e=>!o.includes(e));return[i,...[...o,...s].map(e=>{let i=r.get(e)??[],o=n.categoryLabels?.[e]??Fi(e);return[t.colors.bold(`${o} (${i.length})`),...i.map(e=>Pi(e,a,t))].join(`
|
|
25
25
|
`)})].join(`
|
|
26
26
|
|
|
27
|
-
`)}function
|
|
27
|
+
`)}function Li(e,t,n){return e.length===0?t.colors.dim(n.empty):e.map(e=>{let n=[t.colors.bold(e.title)];e.description&&n.push(...Ai(e.description,2,t.columns));let r=e.meta?.filter(Boolean).join(` · `);return r&&n.push(...Ai(r,2,t.columns).map(e=>t.colors.dim(e))),n.join(`
|
|
28
28
|
`)}).join(`
|
|
29
29
|
|
|
30
|
-
`)}function
|
|
31
|
-
`)}function
|
|
32
|
-
`)}function zi(e,t){return e.length===0?t.colors.dim(`No parameters.`):Ii(e.map(e=>({title:e.name,description:e.description,meta:[e.type,e.required?`required`:`optional`]})),t,{empty:`No parameters.`})}function N(e={}){return!(e.json||!process.stdin.isTTY||!process.stdout.isTTY||process.env.CI)}function P(e){let t=e&&typeof e==`object`&&!Array.isArray(e)?Xt():void 0,n=t?{...e,updateNotice:t}:e;process.stdout.write(`${JSON.stringify(n,null,2)}\n`)}function F(e){let t=bi(e,A());t&&process.stdout.write(`${t}\n`)}function I(e,t){process.stdout.write(`${yi(e,t,A())}\n`)}function L(e){process.stdout.write(`${xi(e,A())}\n`)}function Bi(e,t){process.stdout.write(`${Ai(e,A(),t)}\n`)}function Vi(e){process.stdout.write(`${ji(e,A())}\n`)}function Hi(e){process.stdout.write(`${Di(e,A())}\n`)}function Ui(e,t){process.stdout.write(`${Fi(e,A(),t)}\n`)}function Wi(e,t){process.stdout.write(`${Ii(e,A(),t)}\n`)}function R(e,...t){process.stdout.write(`${Li(e,t,A())}\n`)}function Gi(e,t){process.stdout.write(`${Ri(e,t,A())}\n`)}function Ki(e){process.stdout.write(`${zi(e,A())}\n`)}function qi(e){return e<1024?`${e} B`:e<1048576?`${(e/1024).toFixed(1)} KB`:`${(e/1048576).toFixed(1)} MB`}function z(e){return typeof e==`symbol`&&process.exit(1),e}const Ji={site:`--site`,url:`--url`,section:`--section`,date:`--date`,pages:`--pages`,dimensions:`--dimensions`,detail:`--detail`,offset:`--offset`,max_urls:`--max-urls`,mark:`--mark`,issues:`--issues`,note:`--note`},Yi=e=>/^[\w:/.,<>@#?=&%+-]+$/.test(String(e))?String(e):`"${e}"`,Xi=(e,t)=>[`seo ${e}`,...Object.entries(t??{}).filter(([,e])=>e!==void 0).map(([e,t])=>`${Ji[e]??`--${e}`} ${Yi(t??``)}`)].join(` `),Zi={account:{type:`string`,description:`Saved Google account email.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local cache and fetch fresh data.`}},Qi={"start-date":{type:`string`,description:`Optional YYYY-MM-DD.`},"end-date":{type:`string`,description:`Optional YYYY-MM-DD.`}},B={detail:{type:`string`,description:`summary (default), rows for the next page, or full.`},offset:{type:`string`,description:`rows only: the first row.`}};function V(e){let t=C(e.detail)??`summary`;if(![`summary`,`rows`,`full`].includes(t))throw new h(`INVALID_INPUT`,`--detail is summary, rows or full.`);return t}function $i(e,t){return ii(t,{refresh:w(e.refresh),account:C(e.account)})}async function H(e,t){try{let n=await t(r({call:Xi,account:C(e.account),refresh:w(e.refresh)}));O(e)?P(n.data):process.stdout.write(`${n.text}\n`)}catch(e){throw ne(e)}}const ea=y({meta:{name:`report`,description:"Start here. No --site: last week across your audited sites (beta, after `seo login`). --site: overview and every section. Add --section for one"},args:{site:{type:`string`,description:"Site, URL or Search Console property. Leave it out for the summary of every audited site (beta, after `seo login`)."},section:{type:`string`,description:`Optional, needs --site. One of ${[...Ie,on].join(`, `)}. issues keeps a list of what was found for the site, on this machine.`},mark:{type:`string`,description:`With --site and --issues: ${yn.join(`, `)}. Records what the person decided; runs no checks.`},issues:{type:`string`,description:`With --mark: issue ids from --section issues, comma-separated.`},note:{type:`string`,description:`Optional, with --mark: why.`},...Qi,...B,...Zi},run:async({args:t})=>{let n=C(t.section),r=[...Ie,on];if(n&&!r.includes(n))throw new h(`INVALID_INPUT`,`--section is one of ${r.join(`, `)}.`);let i=C(t.site),a=C(t.mark),o=C(t.issues);if(a||o){if(a&&!yn.includes(a))throw new h(`INVALID_INPUT`,`--mark is one of ${yn.join(`, `)}.`);let e=await $i(t,k(i));await H(t,r=>At({site:e,section:n,mark:a,issues:o?.split(`,`),note:C(t.note)},r));return}if(!i&&!n&&Te()){await H(t,e=>et(e));return}let s=n===`bing`?await $i(t,i).catch(()=>k(i)):await $i(t,i).catch(async r=>{if(n||!i)throw r;return await H(t,n=>e({site:k(i),startDate:C(t[`start-date`]),endDate:C(t[`end-date`])},n).catch(()=>{throw r})),null});s!==null&&await H(t,e=>At({site:s,section:n,startDate:C(t[`start-date`]),endDate:C(t[`end-date`]),detail:V(t),offset:T(t.offset)},e))}}),ta=y({meta:{name:`page`,description:`One URL: live page facts, Google index status and its queries`},args:{url:{type:`string`,description:`The page URL.`,required:!0},...Qi,...B,...Zi},run:async({args:e})=>{let t=C(e.url)??``;if(!/^https?:\/\/\S+$/.test(t))throw new h(`INVALID_INPUT`,`--url must be a full http(s) URL.`);let n=await $i(e,t);await H(e,r=>he({site:n,url:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:T(e.offset)},r))}}),na=y({meta:{name:`compare`,description:`Equal periods before and after a date, with the pages and queries that moved`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},date:{type:`string`,description:`YYYY-MM-DD: the first day after the change.`,required:!0},pages:{type:`string`,description:`Optional URL text, such as /blog/.`},...Zi},run:async({args:e})=>{let t=await $i(e,C(e.site));await H(e,n=>ve({site:t,date:C(e.date)??``,pages:C(e.pages)},n))}}),ra=y({meta:{name:`index`,description:`Google indexing reasons for known URLs, checked live, and pages that lost most of their clicks`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},"max-urls":{type:`string`,description:`How many URLs to ask Google about, 100 by default. Ask for more when you want a fuller picture; it stops at the URL Inspection quota left today.`},...Qi,...B,...Zi},run:async({args:e})=>{let t=await $i(e,C(e.site)),n=T(e[`max-urls`]);if(n!==void 0&&(!Number.isInteger(n)||n<1||n>2e3))throw new h(`INVALID_INPUT`,`--max-urls is a whole number from 1 to ${_t}.`);await H(e,r=>mn({site:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:T(e.offset),maxUrls:n},r))}}),ia=y({meta:{name:`data`,description:`Raw Search Console or Bing rows beside the previous period, or Clicky landing pages`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},source:{type:`string`,description:`search_console (default), bing or clicky. Bing takes the first dimension, query or page. Clicky takes the site or its Clicky site ID.`},dimensions:{type:`string`,description:`Comma-separated: ${Nt.join(`, `)}. Default query.`},page:{type:`string`,description:`Optional: only rows for pages whose URL contains this.`},query:{type:`string`,description:`Optional: only rows for queries that contain this.`},...Qi,...B,...Zi},run:async({args:e})=>{let t=D(e.dimensions)??[`query`],n=t.filter(e=>!Nt.includes(e));if(n.length)throw new h(`INVALID_INPUT`,`Unknown dimensions: ${n.join(`, `)}. Use ${Nt.join(`, `)}.`);let r=C(e.source)??`search_console`;if(![`search_console`,`bing`,`clicky`].includes(r))throw new h(`INVALID_INPUT`,`--source is search_console, bing or clicky.`);if(r===`clicky`){let t=k(C(e.site));await H(e,async()=>Sn({site:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:T(e.offset)},await qt(),{connect:"save it at https://seoskill.dev/account#keys and run `seo login`, or run `seo analytics clicky connect` to keep it on this machine only.",refresh:Ae,call:e=>Xi(`data`,{source:`clicky`,site:t,detail:`rows`,offset:e})}));return}if(r===`bing`){let n=k(C(e.site));await H(e,r=>wt({site:n,dimension:t[0]===`page`?`page`:`query`,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:T(e.offset)},r));return}let i=await $i(e,C(e.site)),a=C(e.page),o=C(e.query);await H(e,n=>pn({site:i,dimensions:t,filters:[...a?[{dimension:`page`,operator:`contains`,expression:a}]:[],...o?[{dimension:`query`,operator:`contains`,expression:o}]:[]],startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:T(e.offset)},n))}}),aa=y({meta:{name:`research`,description:`Keyword, SERP, competitor, backlink and AI answer data from your DataForSEO or Ahrefs key`},args:{action:{type:`positional`,required:!0,description:ot.join(`, `)},provider:{type:`string`,description:`${rt.join(`, `)}. Default: the first one with a saved key.`},keywords:{type:`string`,description:`Comma-separated keywords.`},tasks:{type:`string`,description:`ai_answers only: comma-separated tasks an earlier run returned as not ready.`},target:{type:`string`,description:`Domain or URL.`},country:{type:`string`,description:`Two-letter country code. Default us.`},...B,account:Zi.account,json:Zi.json},run:async({args:e})=>{let t=C(e.action);if(!ot.includes(t))throw new h(`INVALID_INPUT`,`The action is one of ${ot.join(`, `)}.`);let n=await qt(),r={dataforseo:`x-dataforseo-login`,ahrefs:`x-ahrefs-key`},i=C(e.provider)??(t===`ai_answers`?`dataforseo`:rt.find(e=>n.has(r[e])))??`dataforseo`;if(!rt.includes(i))throw new h(`INVALID_INPUT`,`--provider is one of ${rt.join(`, `)}.`);if(!n.has(r[i]))throw new h(`AUTH_CONFIG_REQUIRED`,`No ${i} key. Save it at https://seoskill.dev/account#keys and run \`seo login\`, or run \`seo providers ${i} connect\` to keep it on this machine only.`);let a=D(e.keywords)??[],o=C(e.target),s=C(e.country);if(t===`ai_answers`){if(i!==`dataforseo`)throw new h(`INVALID_INPUT`,`ai_answers uses dataforseo.`);let r=D(e.tasks)??[],c=a.length||r.length?o??``:await $i(e,o);await H(e,i=>Dt({site:c,country:s??`us`,detail:V(e),offset:T(e.offset)??0,questions:a,tasks:r,waitSeconds:240},n,i,e=>Xi(`research`,{action:t,target:o,keywords:a.join(`,`)||void 0,country:s,detail:`rows`,offset:e}).replace(`--action `,``)))}else await H(e,()=>lt({provider:i,action:t,keywords:a,target:o,country:s,detail:V(e),offset:T(e.offset)},n,{call:e=>Xi(`research`,{action:t,provider:i,keywords:a.join(`,`)||void 0,target:o,country:s,detail:`rows`,offset:e}).replace(`--action `,``)}))}}),oa=y({meta:{name:`lint`,description:`Check copy for patterns common in AI-written text, weak copy and title and description length`},args:{paths:{type:`positional`,required:!0,description:`Files, folders or globs: .md, .mdx, .html, .astro or .txt. Up to 100 files.`},preset:{type:`string`,description:`${zt.join(`, `)}. Default blog for Markdown and text, landing for HTML and Astro. meta reads one title or description per line.`},format:{type:`string`,description:`${nn.join(`, `)}. Default: from each file name.`},"fail-on":{type:`string`,description:`error (default) or warning: exit with code 1 when a finding at that level or above is found.`},ignore:{type:`string`,description:`Rule ids or review lenses to skip, comma-separated.`},"ignore-phrase":{type:`string`,description:`A phrase to allow, such as a product name a rule keeps matching. Repeat it for more.`},json:Zi.json},run:async({args:e})=>{let t=C(e.preset);if(t&&!zt.includes(t))throw new h(`INVALID_INPUT`,`--preset is one of ${zt.join(`, `)}.`);let n=C(e.format);if(n&&!nn.includes(n))throw new h(`INVALID_INPUT`,`--format is one of ${nn.join(`, `)}.`);let r=C(e[`fail-on`])??`error`;if(r!==`error`&&r!==`warning`)throw new h(`INVALID_INPUT`,`--fail-on is error or warning.`);let i=(e._??[]).filter(e=>typeof e==`string`),a=[].concat(e[`ignore-phrase`]??[]).filter(e=>typeof e==`string`);try{let o=await En({paths:i,preset:t,format:n,ignoreRules:D(e.ignore),ignorePhrases:a},e=>l(e));O(e)?P(o.data):process.stdout.write(`${o.text}\n`);let{errors:s,warnings:c}=o.data;(s>0||r===`warning`&&c>0)&&(process.exitCode=1)}catch(e){throw ne(e)}}});function sa(e){return e===`keychain`?`system keychain`:e===`file`?`private local file`:e===`environment`?be:e??`missing`}function ca(e){if(e&&Mn(e))return e.trim();throw new h(`INVALID_INPUT`,`No Clicky site given. Pass --site-id with the numeric Clicky site ID.`)}async function la(e,t){return mt({siteId:e,sitekey:t}).catch(e=>{throw new h(e instanceof It&&e.code===`auth`?`AUTH_REQUIRED`:`PROVIDER_UNAVAILABLE`,e instanceof Error?e.message:String(e))})}const ua={type:`boolean`,default:!1,description:`Print machine-readable JSON.`},da={type:`string`,description:`Numeric Clicky site ID.`},fa=y({meta:{name:`connect`,description:`Check and save a Clicky site on this machine`},args:{"site-id":da,json:ua},run:async({args:e})=>{let t=O(e),n=N({json:t});n&&Dr(`Connect Clicky`);let r=ca(C(e[`site-id`])??(n?z(await Nr({message:`Clicky site ID`,validate:e=>Mn(e??``)?void 0:`Enter the numeric site ID from Clicky`})):void 0)),i=process.env.SEO_CLICKY_SITEKEY?.trim()||(n?z(await jr({message:`Clicky sitekey`,validate:e=>Vn(e??``)?void 0:`Enter the sitekey from Clicky (Preferences, Info)`})):void 0);if(!i)throw new h(`AUTH_REQUIRED`,`Run this command in a terminal or set ${be}.`);let a=await la(r,i.trim()),o=await at(r,i.trim()),s={siteId:r,domain:a,connected:!0,credentialSource:o};if(t){P(s);return}let c=`Clicky site ${r}${a?` (${a})`:``} saved in the ${sa(o)}. Next: seo analytics clicky report --site ${r}`;n?x(c):process.stdout.write(`${c}\n`)}}),pa=y({meta:{name:`status`,description:`Show a Clicky site saved on this machine`},args:{"site-id":da,check:{type:`boolean`,default:!1,description:`Check the saved sitekey with Clicky.`},json:ua},run:async({args:e})=>{let t=ca(C(e[`site-id`])),n=await ct(t),r=w(e.check);r&&n&&await la(t,n.siteKey);let i={siteId:t,connected:!!n,credentialSource:n?.source,liveCheck:r?n?`passed`:`unavailable`:`not-requested`};O(e)?P(i):F([[`Site ID`,t],[`Connected`,i.connected?`yes`:`no`],[`Credential`,sa(i.credentialSource)],[`Live check`,i.liveCheck]])}}),ma=y({meta:{name:`report`,description:`Clicky landing pages, traffic sources and search engines`},args:{site:{type:`string`,description:`The site, or its numeric Clicky site ID.`},...Qi,...B,json:ua},run:async({args:e})=>{let t=k(C(e.site));await H(e,async()=>Sn({site:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:V(e),offset:T(e.offset)},await qt(),{connect:"save it at https://seoskill.dev/account#keys and run `seo login`, or run `seo analytics clicky connect` to keep it on this machine only.",refresh:Ae,call:e=>`seo analytics clicky report --site ${t} --detail rows --offset ${e}`}))}}),ha=y({meta:{name:`disconnect`,description:`Remove a Clicky site saved on this machine`},args:{"site-id":da,json:ua},run:async({args:e})=>{let t=ca(C(e[`site-id`]));await gn(t);let n=!!process.env[be],r={siteId:t,savedCredentialRemoved:!0,environmentCredential:n?`active`:`missing`};O(e)?P(r):process.stdout.write(n?`Saved sitekey removed. ${be} is still active.\n`:`Clicky is disconnected for this site.
|
|
33
|
-
`)}}),
|
|
34
|
-
`)}}}),status:
|
|
35
|
-
`);return}let t=await
|
|
36
|
-
`):F(t.map(e=>[e.active?`Active account`:`Account`,e.accountEmail]))}}),use:
|
|
30
|
+
`)}function Ri(e,t,n){let r=t.filter(e=>e.trim().length>0).flatMap(e=>M(e,n.columns));return[n.colors.bold(e),...r].join(`
|
|
31
|
+
`)}function zi(e,t,n){let r=t.flatMap(e=>M(e,Math.max(1,n.columns-2)).map((e,t)=>`${t===0?`- `:` `}${e}`));return[n.colors.bold(e),...r].join(`
|
|
32
|
+
`)}function Bi(e,t){return e.length===0?t.colors.dim(`No parameters.`):Li(e.map(e=>({title:e.name,description:e.description,meta:[e.type,e.required?`required`:`optional`]})),t,{empty:`No parameters.`})}function N(e={}){return!(e.json||!process.stdin.isTTY||!process.stdout.isTTY||process.env.CI)}function P(e){let t=e&&typeof e==`object`&&!Array.isArray(e)?Qt():void 0,n=t?{...e,updateNotice:t}:e;process.stdout.write(`${JSON.stringify(n,null,2)}\n`)}function F(e){let t=xi(e,A());t&&process.stdout.write(`${t}\n`)}function I(e,t){process.stdout.write(`${bi(e,t,A())}\n`)}function Vi(e){process.stdout.write(`${Si(e,A())}\n`)}function Hi(e,t){process.stdout.write(`${ji(e,A(),t)}\n`)}function Ui(e){process.stdout.write(`${Mi(e,A())}\n`)}function Wi(e){process.stdout.write(`${Oi(e,A())}\n`)}function Gi(e,t){process.stdout.write(`${Ii(e,A(),t)}\n`)}function Ki(e,t){process.stdout.write(`${Li(e,A(),t)}\n`)}function qi(e,...t){process.stdout.write(`${Ri(e,t,A())}\n`)}function Ji(e,t){process.stdout.write(`${zi(e,t,A())}\n`)}function Yi(e){process.stdout.write(`${Bi(e,A())}\n`)}function Xi(e){return e<1024?`${e} B`:e<1048576?`${(e/1024).toFixed(1)} KB`:`${(e/1048576).toFixed(1)} MB`}function L(e){return typeof e==`symbol`&&process.exit(1),e}const Zi={site:`--site`,url:`--url`,section:`--section`,date:`--date`,pages:`--pages`,dimensions:`--dimensions`,detail:`--detail`,offset:`--offset`,max_urls:`--max-urls`,mark:`--mark`,issues:`--issues`,note:`--note`,end_date:`--end-date`},Qi=e=>/^[\w:/.,<>@#?=&%+-]+$/.test(String(e))?String(e):`"${e}"`,$i=(e,t)=>[`seo ${e}`,...Object.entries(t??{}).filter(([,e])=>e!==void 0).map(([e,t])=>`${Zi[e]??`--${e}`} ${Qi(t??``)}`)].join(` `),R={account:{type:`string`,description:`Saved Google account email.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local cache and fetch fresh data.`}},ea={"start-date":{type:`string`,description:`Optional YYYY-MM-DD.`},"end-date":{type:`string`,description:`Optional YYYY-MM-DD.`}},z={detail:{type:`string`,description:`summary (default), rows for the next page, or full.`},offset:{type:`string`,description:`rows only: the first row.`}};function B(e){let t=C(e.detail)??`summary`;if(![`summary`,`rows`,`full`].includes(t))throw new m(`INVALID_INPUT`,`--detail is summary, rows or full.`);return t}function ta(e,t){return ai(t,{refresh:w(e.refresh),account:C(e.account)})}async function V(e,t){try{let n=await t(r({call:$i,account:C(e.account),refresh:w(e.refresh)}));O(e)?P(n.data):process.stdout.write(`${n.text}\n`)}catch(e){throw f(e)}}const na=v({meta:{name:`report`,description:"Start here. No --site: last week across your audited sites (beta, after `seo login`). --site: overview and every section. Add --section for one"},args:{site:{type:`string`,description:"Site, URL or Search Console property. Leave it out for the summary of every audited site (beta, after `seo login`)."},section:{type:`string`,description:`Optional, needs --site. One of ${[...Le,bn,Dn].join(`, `)}. issues keeps a list of what was found for the site, on this machine. ${Dn} lays the latest Google ranking update (or the latest that started by --end-date) over the site.`},mark:{type:`string`,description:`With --site and --issues: ${Gt.join(`, `)}. Records what the person decided; runs no checks.`},issues:{type:`string`,description:`With --mark: issue ids from --section issues, comma-separated.`},note:{type:`string`,description:`Optional, with --mark: why.`},...ea,...z,...R},run:async({args:t})=>{let n=C(t.section),r=[...Le,bn,Dn];if(n&&!r.includes(n))throw new m(`INVALID_INPUT`,`--section is one of ${r.join(`, `)}.`);let i=C(t.site),a=C(t.mark),o=C(t.issues);if(a||o){if(a&&!Gt.includes(a))throw new m(`INVALID_INPUT`,`--mark is one of ${Gt.join(`, `)}.`);let e=await ta(t,k(i));await V(t,r=>Mt({site:e,section:n,mark:a,issues:o?.split(`,`),note:C(t.note)},r));return}if(!i&&!n&&ke()){await V(t,e=>tt(e));return}let s=n===`bing`?await ta(t,i).catch(()=>k(i)):await ta(t,i).catch(async r=>{if(n||!i)throw r;return await V(t,n=>e({site:k(i),startDate:C(t[`start-date`]),endDate:C(t[`end-date`])},n).catch(()=>{throw r})),null});s!==null&&await V(t,e=>Mt({site:s,section:n,startDate:C(t[`start-date`]),endDate:C(t[`end-date`]),detail:B(t),offset:T(t.offset)},e))}}),ra=v({meta:{name:`page`,description:`One URL: live page facts, Google index status and its queries`},args:{url:{type:`string`,description:`The page URL.`,required:!0},...ea,...z,...R},run:async({args:e})=>{let t=C(e.url)??``;if(!/^https?:\/\/\S+$/.test(t))throw new m(`INVALID_INPUT`,`--url must be a full http(s) URL.`);let n=await ta(e,t);await V(e,r=>ge({site:n,url:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:B(e),offset:T(e.offset)},r))}}),ia=v({meta:{name:`compare`,description:`Equal periods before and after a date, with the pages and queries that moved`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},date:{type:`string`,description:`YYYY-MM-DD: the first day after the change.`,required:!0},pages:{type:`string`,description:`Optional URL text, such as /blog/.`},...R},run:async({args:e})=>{let t=await ta(e,C(e.site));await V(e,n=>ye({site:t,date:C(e.date)??``,pages:C(e.pages)},n))}}),aa=v({meta:{name:`index`,description:`Google indexing reasons for known URLs, checked live, and pages that lost most of their clicks`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},"max-urls":{type:`string`,description:`How many URLs to ask Google about, 100 by default. Ask for more when you want a fuller picture; it stops at the URL Inspection quota left today.`},...ea,...z,...R},run:async({args:e})=>{let t=await ta(e,C(e.site)),n=T(e[`max-urls`]);if(n!==void 0&&(!Number.isInteger(n)||n<1||n>2e3))throw new m(`INVALID_INPUT`,`--max-urls is a whole number from 1 to ${dn}.`);await V(e,r=>hn({site:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:B(e),offset:T(e.offset),maxUrls:n},r))}}),oa=v({meta:{name:`data`,description:`Raw Search Console or Bing rows beside the previous period, or Clicky landing pages`},args:{site:{type:`string`,description:`Site, URL or Search Console property.`},source:{type:`string`,description:`search_console (default), bing or clicky. Bing takes the first dimension, query or page. Clicky takes the site or its Clicky site ID.`},dimensions:{type:`string`,description:`Comma-separated: ${mn.join(`, `)}. Default query.`},page:{type:`string`,description:`Optional: only rows for pages whose URL contains this.`},query:{type:`string`,description:`Optional: only rows for queries that contain this.`},...ea,...z,...R},run:async({args:e})=>{let t=D(e.dimensions)??[`query`],n=t.filter(e=>!mn.includes(e));if(n.length)throw new m(`INVALID_INPUT`,`Unknown dimensions: ${n.join(`, `)}. Use ${mn.join(`, `)}.`);let r=C(e.source)??`search_console`;if(![`search_console`,`bing`,`clicky`].includes(r))throw new m(`INVALID_INPUT`,`--source is search_console, bing or clicky.`);if(r===`clicky`){let t=k(C(e.site));await V(e,async()=>Et({site:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:B(e),offset:T(e.offset)},await Yt(),{connect:"save it at https://seoskill.dev/account#keys and run `seo login`, or run `seo analytics clicky connect` to keep it on this machine only.",refresh:je,call:e=>$i(`data`,{source:`clicky`,site:t,detail:`rows`,offset:e})}));return}if(r===`bing`){let n=k(C(e.site));await V(e,r=>tn({site:n,dimension:t[0]===`page`?`page`:`query`,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:B(e),offset:T(e.offset)},r));return}let i=await ta(e,C(e.site)),a=C(e.page),o=C(e.query);await V(e,n=>an({site:i,dimensions:t,filters:[...a?[{dimension:`page`,operator:`contains`,expression:a}]:[],...o?[{dimension:`query`,operator:`contains`,expression:o}]:[]],startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:B(e),offset:T(e.offset)},n))}}),sa=v({meta:{name:`research`,description:`Keyword, SERP, competitor, backlink and AI answer data from your DataForSEO or Ahrefs key`},args:{action:{type:`positional`,required:!0,description:st.join(`, `)},provider:{type:`string`,description:`${it.join(`, `)}. Default: the first one with a saved key.`},keywords:{type:`string`,description:`Comma-separated keywords.`},tasks:{type:`string`,description:`ai_answers only: comma-separated tasks an earlier run returned as not ready.`},target:{type:`string`,description:`Domain or URL.`},competitors:{type:`string`,description:`link_gap only: 2 to 5 comma-separated competitor domains.`},country:{type:`string`,description:`Two-letter country code. Default us.`},...z,account:R.account,json:R.json},run:async({args:e})=>{let t=C(e.action);if(!st.includes(t))throw new m(`INVALID_INPUT`,`The action is one of ${st.join(`, `)}.`);let n=await Yt(),r={dataforseo:`x-dataforseo-login`,ahrefs:`x-ahrefs-key`},i=C(e.provider)??(t===`ai_answers`?`dataforseo`:it.find(e=>n.has(r[e])))??`dataforseo`;if(!it.includes(i))throw new m(`INVALID_INPUT`,`--provider is one of ${it.join(`, `)}.`);if(!n.has(r[i]))throw new m(`AUTH_CONFIG_REQUIRED`,`No ${i} key. Save it at https://seoskill.dev/account#keys and run \`seo login\`, or run \`seo providers ${i} connect\` to keep it on this machine only.`);let a=D(e.keywords)??[],o=C(e.target),s=D(e.competitors)??[],c=C(e.country);if(t===`ai_answers`){if(i!==`dataforseo`)throw new m(`INVALID_INPUT`,`ai_answers uses dataforseo.`);let r=D(e.tasks)??[],s=a.length||r.length?o??``:await ta(e,o);await V(e,i=>Ft({site:s,country:c??`us`,detail:B(e),offset:T(e.offset)??0,questions:a,tasks:r,waitSeconds:240},n,i,e=>$i(`research`,{action:t,target:o,keywords:a.join(`,`)||void 0,country:c,detail:`rows`,offset:e}).replace(`--action `,``)))}else await V(e,()=>ut({provider:i,action:t,keywords:a,target:o,competitors:s,country:c,detail:B(e),offset:T(e.offset)},n,{call:e=>$i(`research`,{action:t,provider:i,keywords:a.join(`,`)||void 0,target:o,competitors:s.join(`,`)||void 0,country:c,detail:`rows`,offset:e}).replace(`--action `,``)}))}}),ca=v({meta:{name:`lint`,description:`Check copy for patterns common in AI-written text, weak copy and title and description length`},args:{paths:{type:`positional`,required:!0,description:`Files, folders or globs: .md, .mdx, .html, .astro or .txt. Up to 100 files.`},preset:{type:`string`,description:`${Rt.join(`, `)}. Default blog for Markdown and text, landing for HTML and Astro. meta reads one title or description per line.`},format:{type:`string`,description:`${Vt.join(`, `)}. Default: from each file name.`},"fail-on":{type:`string`,description:`error (default) or warning: exit with code 1 when a finding at that level or above is found.`},ignore:{type:`string`,description:`Rule ids or review lenses to skip, comma-separated.`},"ignore-phrase":{type:`string`,description:`A phrase to allow, such as a product name a rule keeps matching. Repeat it for more.`},json:R.json},run:async({args:e})=>{let t=C(e.preset);if(t&&!Rt.includes(t))throw new m(`INVALID_INPUT`,`--preset is one of ${Rt.join(`, `)}.`);let n=C(e.format);if(n&&!Vt.includes(n))throw new m(`INVALID_INPUT`,`--format is one of ${Vt.join(`, `)}.`);let r=C(e[`fail-on`])??`error`;if(r!==`error`&&r!==`warning`)throw new m(`INVALID_INPUT`,`--fail-on is error or warning.`);let i=(e._??[]).filter(e=>typeof e==`string`),a=[].concat(e[`ignore-phrase`]??[]).filter(e=>typeof e==`string`);try{let o=await cn({paths:i,preset:t,format:n,ignoreRules:D(e.ignore),ignorePhrases:a},e=>l(e));O(e)?P(o.data):process.stdout.write(`${o.text}\n`);let{errors:s,warnings:c}=o.data;(s>0||r===`warning`&&c>0)&&(process.exitCode=1)}catch(e){throw f(e)}}});function la(e){return e===`keychain`?`system keychain`:e===`file`?`private local file`:e===`environment`?_n:e??`missing`}function ua(e){if(e&&Un(e))return e.trim();throw new m(`INVALID_INPUT`,`No Clicky site given. Pass --site-id with the numeric Clicky site ID.`)}async function da(e,t){return Pn({siteId:e,sitekey:t}).catch(e=>{throw new m(e instanceof ht&&e.code===`auth`?`AUTH_REQUIRED`:`PROVIDER_UNAVAILABLE`,e instanceof Error?e.message:String(e))})}const fa={type:`boolean`,default:!1,description:`Print machine-readable JSON.`},pa={type:`string`,description:`Numeric Clicky site ID.`},ma=v({meta:{name:`connect`,description:`Check and save a Clicky site on this machine`},args:{"site-id":pa,json:fa},run:async({args:e})=>{let t=O(e),n=N({json:t});n&&y(`Connect Clicky`);let r=ua(C(e[`site-id`])??(n?L(await Pr({message:`Clicky site ID`,validate:e=>Un(e??``)?void 0:`Enter the numeric site ID from Clicky`})):void 0)),i=process.env.SEO_CLICKY_SITEKEY?.trim()||(n?L(await Mr({message:`Clicky sitekey`,validate:e=>St(e??``)?void 0:`Enter the sitekey from Clicky (Preferences, Info)`})):void 0);if(!i)throw new m(`AUTH_REQUIRED`,`Run this command in a terminal or set ${_n}.`);let a=await da(r,i.trim()),o=await ft(r,i.trim()),s={siteId:r,domain:a,connected:!0,credentialSource:o};if(t){P(s);return}let c=`Clicky site ${r}${a?` (${a})`:``} saved in the ${la(o)}. Next: seo analytics clicky report --site ${r}`;n?x(c):process.stdout.write(`${c}\n`)}}),ha=v({meta:{name:`status`,description:`Show a Clicky site saved on this machine`},args:{"site-id":pa,check:{type:`boolean`,default:!1,description:`Check the saved sitekey with Clicky.`},json:fa},run:async({args:e})=>{let t=ua(C(e[`site-id`])),n=await ot(t),r=w(e.check);r&&n&&await da(t,n.siteKey);let i={siteId:t,connected:!!n,credentialSource:n?.source,liveCheck:r?n?`passed`:`unavailable`:`not-requested`};O(e)?P(i):F([[`Site ID`,t],[`Connected`,i.connected?`yes`:`no`],[`Credential`,la(i.credentialSource)],[`Live check`,i.liveCheck]])}}),ga=v({meta:{name:`report`,description:`Clicky landing pages, traffic sources and search engines`},args:{site:{type:`string`,description:`The site, or its numeric Clicky site ID.`},...ea,...z,json:fa},run:async({args:e})=>{let t=k(C(e.site));await V(e,async()=>Et({site:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:B(e),offset:T(e.offset)},await Yt(),{connect:"save it at https://seoskill.dev/account#keys and run `seo login`, or run `seo analytics clicky connect` to keep it on this machine only.",refresh:je,call:e=>`seo analytics clicky report --site ${t} --detail rows --offset ${e}`}))}}),_a=v({meta:{name:`disconnect`,description:`Remove a Clicky site saved on this machine`},args:{"site-id":pa,json:fa},run:async({args:e})=>{let t=ua(C(e[`site-id`]));await ve(t);let n=!!process.env[_n],r={siteId:t,savedCredentialRemoved:!0,environmentCredential:n?`active`:`missing`};O(e)?P(r):process.stdout.write(n?`Saved sitekey removed. ${_n} is still active.\n`:`Clicky is disconnected for this site.
|
|
33
|
+
`)}}),va=v({meta:{name:`clicky`,description:`Read Clicky, or save a Clicky site on this machine only`},subCommands:{connect:ma,status:ha,report:ga,disconnect:_a}}),ya=v({meta:{name:`properties`,description:`List Google Analytics accounts and properties`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},account:{type:`string`,description:`Saved Google account email.`}},run:async({args:e})=>{let t=await Lt(C(e.account)),n=t.flatMap(e=>e.propertySummaries.map(t=>({account:e.displayName??e.account,property:Bt(t.property),displayName:t.displayName??t.property})));O(e)?P({accountSummaries:t,properties:n}):I([`Property`,`Name`,`Account`],n.map(e=>[e.property,e.displayName,e.account]))}}),ba=v({meta:{name:`report`,description:`Google Analytics landing pages for visits from search`},args:{property:{type:`string`,description:"Numeric Google Analytics property ID. Run `seo analytics google properties` to list them."},...ea,...z,json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=oi(C(e.property));await V(e,async()=>kt({property:t,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),detail:B(e),offset:T(e.offset)},await jn(await Ke(),t,Hn.signIn),{signIn:Hn.signIn,call:e=>`seo analytics google report --property ${t} --detail rows --offset ${e}`}))}}),xa=v({meta:{name:`google`,description:`Read Google Analytics properties and reports`},subCommands:{properties:ya,report:ba}}),Sa=v({meta:{name:`analytics`,description:`Read analytics data from connected providers`},subCommands:{clicky:va,google:xa}});function Ca(){return`Your browser will open. Choose your Google account and select all permission boxes for read-only access. Keep this terminal open and finish the browser steps within five minutes.`}async function wa(){return b(Ca(),`Google sign-in`),xt()}function Ta(e){return e?e===`environment-json`?`SEO_GOOGLE_SERVICE_ACCOUNT_JSON`:e===`environment-file`?`SEO_GOOGLE_SERVICE_ACCOUNT_FILE`:`GOOGLE_APPLICATION_CREDENTIALS`:`invalid or conflicting configuration`}function Ea(e){return e.active===`keychain`?`system keychain`:e.configured===`keychain`?`private file fallback`:`private file`}function Da(e){return e===`shared`?`SEO Skill app`:`Local OAuth config`}function Oa(e){let t=[[`Account`,e.accountEmail]],n=new Set(e.scope.split(/\s+/u).filter(Boolean));return n.has(`https://www.googleapis.com/auth/webmasters.readonly`)?t.push([`Search Console`,`Read only`]):t.push([`Search Console`,`Not granted`]),n.has(`https://www.googleapis.com/auth/analytics.readonly`)?t.push([`Google Analytics`,`Read only`]):t.push([`Google Analytics`,`Not granted`]),t.push([`OAuth app`,Da(e.clientSource)],[`Expires`,Xr(e.expiresAt)]),t}const ka=v({meta:{name:`auth`,description:`Authentication commands`},subCommands:{login:v({meta:{name:`login`,description:`Run Google OAuth flow`},run:async()=>{if((await zn()).activeMode===`service-account`)throw new m(`AUTH_CONFIG_REQUIRED`,`A service account is active from the environment. Unset its credential variable before running browser OAuth.`);let e=await wa();F(Oa({accountEmail:e.account_email,clientSource:e.client_source,expiresAt:e.expires_at,scope:e.scope}))}}),logout:v({meta:{name:`logout`,description:`Delete a local Google login`},args:{account:{type:`string`,description:`Delete the login for this Google account.`},all:{type:`boolean`,default:!1,description:`Delete every saved Google login.`}},run:async({args:e})=>{let t=await zn(),n=C(e.account);if(n&&e.all)throw new m(`INVALID_INPUT`,`Use either --account or --all, not both.`);let r=e.all?void 0:n??t.accounts.find(e=>e.active)?.accountEmail;await u(r),t.activeMode===`service-account`?process.stdout.write(`${e.all?`Deleted all local Google logins.`:r?`Deleted the local login for ${r}.`:`No local Google login was found.`} Service account credentials remain available through the environment.\n`):process.stdout.write(`${e.all?`Deleted all local Google logins.`:r?`Deleted the local login for ${r}.`:`No local Google login was found.`}\nRevoke at https://myaccount.google.com/permissions if you also want Google to forget the grant.\n`)}}),whoami:v({meta:{name:`whoami`,description:`Show the signed-in Google account`},args:{account:{type:`string`,description:`Show this saved Google account.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await zn();if(t.activeMode===`service-account`){let n={mode:`service-account`,account:t.identity??null,source:Ta(t.serviceAccount.source)};if(O(e)){P(n);return}F([[`Account type`,`Service account`],[`Account`,t.identity??`Invalid configuration`],[`Credentials`,n.source],[`Access`,`Search Console and Google Analytics, read only`]]);return}let n=C(e.account),r=n?await te(n):t.tokens;if(n&&!r)throw new m(`AUTH_REQUIRED`,`Google account ${n} is not connected.`);if(r)O(e)?P({mode:`oauth`,account:r.account_email,scopes:r.scope.split(/\s+/u).filter(Boolean),clientSource:r.client_source,expiresAt:r.expires_at}):F(Oa({accountEmail:r.account_email,clientSource:r.client_source,expiresAt:r.expires_at,scope:r.scope}));else{if(O(e)){P({mode:`oauth`,account:null});return}process.stdout.write(`Not logged in.
|
|
34
|
+
`)}}}),status:v({meta:{name:`status`,description:`Show local Google auth status`},args:{account:{type:`string`,description:`Show status for this saved Google account.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await zn(),n=C(e.account),r=n?await te(n):t.tokens;if(n&&!r&&t.activeMode!==`service-account`)throw new m(`AUTH_REQUIRED`,`Google account ${n} is not connected.`);let i=t.activeMode===`oauth`?await qe():void 0;if(O(e)){P({authenticated:t.activeMode===`oauth`?!!r:t.serviceAccount.configured,mode:t.activeMode,identity:t.identity,account:t.activeMode===`oauth`?r?.account_email:void 0,scopes:t.activeMode===`oauth`?r?.scope:void 0,clientSource:t.activeMode===`oauth`?r?.client_source:void 0,expiresAt:t.activeMode===`oauth`?r?.expires_at:void 0,sharedConfigured:t.sharedConfigured,byoConfigured:t.byoConfigured,serviceAccount:{configured:t.serviceAccount.configured,identity:t.serviceAccount.identity,source:t.serviceAccount.source,error:t.serviceAccount.error},accounts:t.accounts,...i?{tokenStorage:i}:{}});return}if(t.activeMode===`service-account`){let e=[[`Mode`,`service account`],[`Identity`,t.identity??`unavailable`],[`Source`,Ta(t.serviceAccount.source)],[`Scopes`,`Search Console readonly, Google Analytics readonly`],[`Storage`,`credentials stay in the environment`]];t.serviceAccount.error&&e.push([`Status`,t.serviceAccount.error]),F(e);return}if(!r){let e=t.serviceAccount.error?t.serviceAccount.error:t.sharedConfigured?`Shared seo app available`:t.byoConfigured?`Local OAuth config available`:`No OAuth client configured`;process.stdout.write(`Not logged in. ${e}. Run \`seo auth login\` to connect Google.\n`);return}let a=i??await qe();F([[`Account`,r.account_email],[`Connected accounts`,String(t.accounts.length)],[`Scopes`,r.scope],[`Client`,Da(r.client_source)],[`Expires`,Xr(r.expires_at)],[`Tokens file`,jt().tokensFile],[`Token storage`,Ea(a)],...a.reason?[[`Storage note`,a.reason]]:[],[`OAuth mode`,t.sharedConfigured?`SEO Skill app available`:t.byoConfigured?`Local OAuth config available`:`missing`],[`Revoke at`,`https://myaccount.google.com/permissions`]])}}),storage:v({meta:{name:`storage`,description:`Show or change local OAuth token storage`},args:{keychain:{type:`boolean`,default:!1,description:`Store OAuth tokens in the system keychain when available.`},file:{type:`boolean`,default:!1,description:`Store OAuth tokens in the private local file.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(e.keychain&&e.file)throw new m(`INVALID_INPUT`,`Choose either --keychain or --file, not both.`);let t=e.keychain||e.file?await Xt(e.keychain?`keychain`:`file`):await qe();O(e)?P(t):F([[`Configured storage`,t.configured],[`Active storage`,Ea(t)],...t.reason?[[`Note`,t.reason]]:[]])}}),refresh:v({meta:{name:`refresh`,description:`Refresh the Google OAuth token`},args:{account:{type:`string`,description:`Refresh this saved Google account.`}},run:async({args:e})=>{if((await zn()).activeMode===`service-account`){process.stdout.write(`Service accounts request short-lived Google tokens automatically. No local refresh token is stored.
|
|
35
|
+
`);return}let t=await We(C(e.account));process.stdout.write(`Refreshed. New expiry ${new Date(t.expires_at).toISOString()}.\n`)}}),accounts:v({meta:{name:`accounts`,description:`List saved Google accounts`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=re();O(e)?P({accounts:t}):t.length===0?process.stdout.write(`No Google accounts are connected.
|
|
36
|
+
`):F(t.map(e=>[e.active?`Active account`:`Account`,e.accountEmail]))}}),use:v({meta:{name:`use`,description:`Select the default Google account`},args:{account:{type:`positional`,required:!0,description:`Saved Google account email.`}},run:({args:e})=>{let t=C(e.account);if(!t)throw new m(`INVALID_INPUT`,`Google account is required.`);Me(t),process.stdout.write(`Default Google account: ${t}\n`)}}),"setup-client":v({meta:{name:`setup-client`,description:`Save your own Google Desktop OAuth client`},args:{json:{type:`boolean`,default:!1,description:`Return a structured error instead of prompting.`}},run:async({args:e})=>{if(!N({json:O(e)}))throw new m(`INVALID_INPUT`,"`seo auth setup-client` needs an interactive terminal. Run it without --json, or set SEO_GOOGLE_CLIENT_ID and SEO_GOOGLE_CLIENT_SECRET.");y(`Local Google OAuth client`),b(`This is the advanced path.
|
|
37
37
|
Most users should use the shared seo Google app.
|
|
38
|
-
Your actual sensitive data is the local refresh token, not the desktop app client secret.`,`Advanced`);let
|
|
39
|
-
`),
|
|
38
|
+
Your actual sensitive data is the local refresh token, not the desktop app client secret.`,`Advanced`);let t=L(await Pr({message:`Google Desktop OAuth client ID`,validate:e=>e?void 0:`Client ID is required`})),n=L(await Mr({message:`Google Desktop OAuth client secret`,validate:e=>e?void 0:`Client secret is required`}));i({clientId:t,clientSecret:n}),x(`Saved local OAuth config to ${jt().oauthClientFile}`)}})}}),Aa=[`gsc`,`google-analytics`,`dataforseo`,`ahrefs`,`clicky`,`http`];function ja(e){if(e!==void 0){if(typeof e==`string`&&Aa.includes(e))return e;throw new m(`INVALID_INPUT`,`--provider must be one of: ${Aa.join(`, `)}.`)}}const Ma=v({meta:{name:`cache`,description:`Cache helpers`},subCommands:{stats:v({meta:{name:`stats`,description:`Show local cache size and row counts`},run:async()=>{let e=Nn();F([[`DB`,e.dbPath],[`Size`,Xi(e.sizeBytes)],[`Cached data`,`${Xi(e.logicalSizeBytes)} of ${Xi(e.maxSizeBytes)} automatic limit`],[`Sites`,String(e.counts.sites??0)],[`Search Console`,String(e.counts.gsc_cache??0)],[`URL Inspection`,String(e.counts.url_inspection_cache??0)],[`Google Analytics`,String(e.counts.google_analytics_cache??0)],[`DataForSEO`,String(e.counts.provider_cache??0)],[`Ahrefs`,String(e.counts.ahrefs_cache??0)],[`Clicky`,String(e.counts.clicky_cache??0)],[`HTTP`,String(e.counts.http_cache??0)]])}}),clear:v({meta:{name:`clear`,description:`Clear cached API and HTTP data`},args:{provider:{type:`string`,description:`Optional cache provider: gsc, google-analytics, dataforseo, ahrefs, clicky, or http`}},run:async({args:e})=>{let t=mt(ja(e.provider));process.stdout.write(`Removed ${t} cached rows.\n`)}})}});function H(e){return Math.round(e).toLocaleString(`en-GB`)}function U(e){return e.toFixed(1)}function W(e){return`${(e*100).toFixed(1)}%`}function G(e,t=72){return di(e,t)}function Na(e){return e.verification?.requested?`${e.verification.verified} checked, ${e.verification.failed} failed`:`off`}function Pa(e){return{title:e.title,target:e.target,status:e.status,summary:e.summary,metrics:e.metrics,sections:(e.diagnostics??[]).map(e=>({title:e.title,diagnostics:e.items})),notes:e.notes}}function K(e){Wi(Pa(e))}function q(e,t){I(e,t.slice(0,25)),t.length>25&&process.stdout.write(`Showing 25 of ${t.length}. Use --json for full data.\n`)}function J(e,t,n=5){let r=t.filter(e=>e.action.trim().length>0).slice(0,n),i=Fa(e,r);i&&(process.stdout.write(`
|
|
39
|
+
`),Wi(i),t.length>r.length&&process.stdout.write(`Showing ${r.length} of ${t.length}. Use --json for full data.\n`))}function Fa(e,t){if(t.length)return{title:e,status:`info`,summary:`${t.length} ${t.length===1?`action`:`actions`} shown.`,sections:[{title:`Actions`,diagnostics:t.map(e=>({status:`info`,title:e.label,explanation:e.context??`Review the evidence before making changes.`,fix:e.action}))}]}}function Ia(e){process.stdout.write(`\nNext: ${e}\n`)}function Y(e,t){let n=t.filter(e=>e.trim().length>0);if(n.length){process.stdout.write(`\n${e}\n`);for(let e of n)process.stdout.write(`- ${e}\n`)}}const La=v({meta:{name:`content`,description:`Optimize page content from real GSC queries`},subCommands:{optimize:v({meta:{name:`optimize`,description:`Build a content optimization report for one URL`},args:{site:{type:`string`},url:{type:`string`,required:!0},days:{type:`string`,description:`GSC lookback days. Defaults to 28.`},limit:{type:`string`,description:`Maximum GSC queries to inspect. Defaults to 25.`},"min-impressions":{type:`string`,description:`Minimum query impressions. Defaults to 10.`},"include-brand":{type:`boolean`,default:!1,description:`Include branded queries.`},"verify-content":Zr(`Fetch the page for content checks. Defaults to true.`,`Skip fetching the page for content checks.`),js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for page extraction.`},refresh:{type:`boolean`,default:!1,description:`Bypass local GSC and HTTP cache.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=k(C(e.site)),r=await wt({site:n,url:C(e.url)??``,days:T(e.days),limit:T(e.limit),minImpressions:T(e[`min-impressions`]),includeBrand:w(e[`include-brand`]),verifyContent:w(e[`verify-content`])!==!1,js:w(e.js)?!0:`auto`,refresh:w(e.refresh)});t?P(r):(K({title:`Content optimization`,target:r.url,status:`info`,summary:r.summary.verdict,metrics:[{label:`Score`,value:`${r.summary.score}/100`},{label:`Primary intent`,value:r.summary.primaryIntent},{label:`Primary query`,value:r.summary.primaryQuery??`None`},{label:`Queries`,value:H(r.summary.queries)},{label:`Opportunities`,value:H(r.summary.opportunities)},{label:`Estimated lift`,value:H(r.summary.estimatedClickLift)}]}),J(`Top actions`,r.topActions.map(e=>({label:e.title,action:e.action,context:e.plainEnglish}))),r.brief.sections.length&&(process.stdout.write(`
|
|
40
40
|
Suggested sections
|
|
41
41
|
`),q([`Heading`,`Queries`],r.brief.sections.map(e=>[G(e.heading,48),G(e.queries.join(`, `),80)]))),r.intentMix.length&&(process.stdout.write(`
|
|
42
42
|
Intent mix
|
|
43
|
-
`),q([`Intent`,`Queries`,`Impressions`,`Clicks`],r.intentMix.map(e=>[e.intent,
|
|
43
|
+
`),q([`Intent`,`Queries`,`Impressions`,`Clicks`],r.intentMix.map(e=>[e.intent,H(e.queries),H(e.impressions),H(e.clicks)]))),Y(`Caveats`,r.caveats))}})}});var Ra=class{stream;buffer=``;constructor(e){this.stream=e}async write(e){this.buffer+=e,this.buffer.length>=65536&&await this.flush()}async flush(){if(!this.buffer)return;let e=this.buffer;this.buffer=``,this.stream.write(e)||await new Promise((e,t)=>{let n=()=>{i(),e()},r=e=>{i(),t(e)},i=()=>{this.stream.off(`drain`,n),this.stream.off(`error`,r)};this.stream.once(`drain`,n),this.stream.once(`error`,r)})}};function za(e){return` `.repeat(e)}function Ba(e){return e&&typeof e==`object`&&`toJSON`in e&&typeof e.toJSON==`function`?e.toJSON():e}async function Va(e,t,n,r,i=!1){let a=Ba(t);if(a===null)return await e.write(`null`),!0;if(typeof a==`string`||typeof a==`boolean`)return await e.write(JSON.stringify(a)),!0;if(typeof a==`number`)return await e.write(Number.isFinite(a)?String(a):`null`),!0;if(typeof a==`bigint`&&JSON.stringify(a),a===void 0||typeof a==`function`||typeof a==`symbol`)return i&&await e.write(`null`),i;if(!a||typeof a!=`object`)return!1;if(r.has(a))throw TypeError(`Converting circular structure to JSON`);r.add(a);try{if(Array.isArray(a)){if(a.length===0)return await e.write(`[]`),!0;await e.write(`[
|
|
44
44
|
`);for(let t=0;t<a.length;t+=1)t>0&&await e.write(`,
|
|
45
|
-
`),await e.write(
|
|
45
|
+
`),await e.write(za(n+1)),await Va(e,a[t],n+1,r,!0);return await e.write(`\n${za(n)}]`),!0}let t=Object.entries(a).filter(([,e])=>{let t=Ba(e);return![`undefined`,`function`,`symbol`].includes(typeof t)});if(t.length===0)return await e.write(`{}`),!0;await e.write(`{
|
|
46
46
|
`);for(let i=0;i<t.length;i+=1){let[a,o]=t[i];i>0&&await e.write(`,
|
|
47
|
-
`),await e.write(`${
|
|
48
|
-
`),await n.flush()}async function Ha(e,t){if(!e){await Va(process.stdout,t);return}await hr(Xn(e),{recursive:!0});let n=ir(e);try{await Va(n,t),n.end(),await Lr(n)}catch(e){throw n.destroy(),e}process.stdout.write(`Wrote ${e}\n`)}function Ua(e){return e.length?e.join(`, `):`none`}function Wa(e,t){let n=e.robotsTxt,r=(n?.botAccess??[]).filter(e=>e.purpose===t),i=t===`search`?`AI search bots`:`AI training bots`;if(!n||r.some(e=>e.allowed===null))return{status:`unknown`,title:`${i}: unknown`,explanation:`robots.txt could not be read (${n?.availability??`not checked`}).`};let a=r.filter(e=>e.allowed===!1);return{status:a.length?t===`search`?`warning`:`info`:`pass`,title:a.length?`${i}: ${a.length} of ${r.length} blocked`:`${i}: all ${r.length} allowed`,explanation:a.length?`Blocked: ${Ua(a.map(e=>e.userAgent))}.`:`Checked: ${Ua(r.map(e=>e.userAgent))}.`}}function Ga(e){let t=e.markdownNegotiation,n=e.markdownCopies,r=t?.markdown?`Accept: text/markdown returns Markdown${t.varyAccept?` with Vary: Accept`:` without Vary: Accept`}.`:t?.availability===`available`?`Accept: text/markdown returns ${t.contentType||`no content type`}.`:`Accept: text/markdown could not be checked (${t?.availability??`not checked`}).`,i=n?` ${n.publicPagesWithLink} of ${n.publicPages} public pages link to a Markdown copy${n.privatePagesWithLink?`, and ${n.privatePagesWithLink} signed-in pages do`:``}. ${n.checked} copies checked, ${n.broken.length} broken.${n.largest?` Largest checked copy: about ${n.largest.estimatedTokens} tokens.`:``}`:``;return{status:t?.markdown||n?.publicPagesWithLink?n?.broken.length||n?.privatePagesWithLink?`warning`:`pass`:t?.availability===`available`?`info`:`unknown`,title:`Markdown copies`,explanation:`${r}${i}`}}function Ka(e){let t=e.llmsTxt;if(!t||t.availability===void 0)return{status:`unknown`,title:`llms.txt`,explanation:`Not checked.`};if(t.availability!==`available`)return{status:t.availability===`absent`?`info`:`unknown`,title:`llms.txt`,explanation:t.availability===`absent`?`Not found (HTTP ${t.status??`none`}).`:`Could not be read (${t.availability}).`};let n=t.links;return{status:n?.broken.length?`warning`:`pass`,title:`llms.txt`,explanation:n?`${n.found} same-site links; ${n.checked} checked, ${n.broken.length} broken.`:`Present.`}}function qa(e){if(!e)return[];let t=(e.agentResources??[]).filter(e=>e.exists).map(e=>new URL(e.url).pathname),n=[...e.robotsTxt?.contentSignals??[],...e.startPageHeaders?.contentSignal?[e.startPageHeaders.contentSignal]:[]];return[Wa(e,`search`),Wa(e,`training`),Ga(e),Ka(e),{status:`info`,title:`Agent files`,explanation:`Found: ${Ua(t)}.`},{status:`info`,title:`Content-Signal and Link header`,explanation:`Content-Signal: ${Ua([...new Set(n)])}. Link header relations on the start page: ${Ua(e.startPageHeaders?.linkRelations??[])}.`}]}function Ja(e){return e===`high`?`fail`:`warning`}function Ya(e,t=Vt(e)){let n=_n(e),r=e.status===`failed`||e.summary.highIssues>0?`fail`:e.status===`partial`?`unknown`:e.summary.mediumIssues>0||e.summary.lowIssues>0?`warning`:`pass`,i=e.access.samples.slice(0,5).map(e=>({status:`fail`,title:e.evidence.guidance.summary,explanation:`${e.evidence.provider} returned ${e.evidence.kind} evidence for the crawler request.`,evidence:[e.url],fix:e.evidence.guidance.recommendedAction})),a=t.slice(0,10).map(e=>({status:Ja(e.severity),title:`${e.title} on ${e.count} ${e.count===1?`URL`:`URLs`}`,explanation:Ct(e.ruleId)?.whyItMatters??e.whyThisRanks,evidence:e.sampleUrls.slice(0,5),fix:e.howToFix})),o=n.slice(0,10).map(e=>({status:`warning`,title:`${e.title} on ${e.count} ${e.count===1?`URL`:`URLs`}`,explanation:Ct(e.ruleId)?.whyItMatters??e.whyThisRanks,evidence:e.sampleUrls.slice(0,5),fix:e.howToFix}));Hi({title:e.config.strategy===`health`?`Sitemap health pass`:`Site crawl`,target:e.config.url,status:r,summary:e.status===`partial`?`Partial evidence from ${e.summary.totalPages} retained pages. Review the caveats before treating missing findings as an all-clear.`:`${e.summary.totalPages} pages retained with ${e.issues.length} findings.`,metrics:[{label:`Pages`,value:e.summary.totalPages},{label:`High`,value:e.summary.highIssues,status:`fail`},{label:`Medium`,value:e.summary.mediumIssues,status:`warning`},{label:`Low`,value:e.summary.lowIssues,status:`info`},{label:`Failed fetches`,value:e.summary.failedUrls}],sections:[{title:`Access diagnostics`,diagnostics:i},{title:`Prioritised fixes`,diagnostics:a},{title:`Review before changing anything`,diagnostics:o},{title:`Agent access`,diagnostics:qa(e.ai)},...!i.length&&!a.length&&!o.length?[{title:`Checks`,diagnostics:[{status:`pass`,title:`No prioritised findings were observed`,explanation:`The evaluated crawl evidence did not produce a prioritised fix or review item.`}]}]:[]],notes:[`Strategy: ${e.config.strategy}. Data: ${e.status}. Report: ${e.id}.`,...e.warnings,...e.caveats]})}const Xa={"google-analytics-property":{type:`string`,description:`Google Analytics property ID for landing-page sessions.`},"clicky-site-id":{type:`string`,description:`Clicky site ID for landing-page visits.`}};function Za(e){let t=C(e[`google-analytics-property`]),n=C(e[`clicky-site-id`]);if(t&&n)throw new h(`INVALID_INPUT`,`Pass either --google-analytics-property or --clicky-site-id, not both.`);if(t)return{provider:`google`,propertyId:t};if(n)return{provider:`clicky`,siteId:_e(n)}}function Qa(e){let t=e.trim();if(/^https?:\/\//i.test(t))return t;if(t.startsWith(`sc-domain:`))return`https://${t.slice(10)}/`;if(/^[a-z0-9-]+(\.[a-z0-9-]+)+(:\d+)?(\/\S*)?$/i.test(t))return`https://${t.includes(`/`)?t:`${t}/`}`}function $a(e){return e?e.backpressure?.status===`stopped`?`stopped: ${e.backpressure.reason??`origin cooldown`}`:e.backpressure?.status===`slowed`?`slowed ${e.backpressure.delayMs}ms`:e.rendering?.status===`unavailable`?`raw HTML; rendering unavailable`:e.rendering?.status===`failed`?`raw HTML; rendering failed`:e.blocked?`blocked`:e.rendered?`rendered`:e.cache===`hit`?`cached`:e.fetched?`fetched`:e.source:`-`}function eo(e){return e?e===`serp-framing`?`wording gap`:e===`content-gap`?`content gap`:e===`technical-check`?`technical check`:`covered`:`-`}const to={high:3,medium:2,low:1},no=y({meta:{name:`crawl`,description:`Run a fast sitemap health pass or a full technical crawl`},args:{crawlUrl:{type:`positional`,required:!1,description:`Site start URL. Optional with --sitemap-url.`},url:{type:`string`,description:`Start URL to crawl. Defaults to the --site home page.`},site:{type:`string`,description:`GSC property URL for joining page metrics.`},...Xa,mode:{type:`string`,description:`Crawl mode: site, page, list, or sitemap. Start with sitemap --health for large sites.`},health:{type:`boolean`,default:!1,description:`Run the uncached sitemap status and redirect pass before a full audit. No page-body analysis.`},"sitemap-url":{type:`string`,description:`Explicit sitemap URL. Selects sitemap mode when --mode is omitted.`},urls:{type:`string`,description:`Comma-separated URLs for list mode.`},"urls-file":{type:`string`,description:`File with one URL per line for list mode.`},"max-pages":{type:`string`,description:`Maximum pages to crawl, up to 10,000. Defaults to 500.`},"max-depth":{type:`string`,description:`Maximum click depth, up to 64. Defaults to 16.`},concurrency:{type:`string`,description:`Parallel page fetches, up to 16. Defaults to 8, or progressively up to 4 with --health.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache and fetch fresh pages.`},include:{type:`string`,description:`Comma-separated URL patterns to include.`},exclude:{type:`string`,description:`Comma-separated URL patterns to exclude.`},"no-sitemap":{type:`boolean`,default:!1,description:`Do not seed URLs from sitemap.xml.`},"no-robots":{type:`boolean`,default:!1,description:`Do not skip URLs disallowed by robots.txt.`},"no-external":{type:`boolean`,default:!1,description:`Do not check external links. Reserved for full link checks.`},js:{type:`boolean`,default:!1,description:`Legacy alias for --rendering on.`},rendering:{type:`string`,description:`JavaScript rendering mode: auto, on, or off. Defaults to auto.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON. Alias for --format json.`},format:{type:`string`,description:`Output format: pretty, json, csv, html, markdown, or junit. JUnit requires --health.`},output:{type:`string`,description:`Write output to this path instead of stdout.`},csv:{type:`string`,description:`CSV table to render: issues or pages. Defaults to issues.`},severity:{type:`string`,description:`Only show top fixes at this severity.`},"fail-on":{type:`string`,description:`Exit non-zero when issues exist at this severity or above.`}},run:async({args:e})=>{let t=O(e),r=oo(e.format,t),i=C(e.output),a=so(e.csv),o=io(e.severity),s=io(e[`fail-on`]),l=await co(e),u=ao(e),d=C(e[`sitemap-url`]),f=w(e.health),ee=ro(e.mode);if(r===`junit`&&!f)throw new h(`INVALID_INPUT`,`--format junit requires --health.`);if((f||d)&&ee&&ee!==`sitemap`)throw new h(`INVALID_INPUT`,`--health and --sitemap-url require sitemap mode.`);if(f&&Qr(e,`sitemap`))throw new h(`INVALID_INPUT`,`--health cannot be combined with --no-sitemap.`);if((f||d)&&l.length)throw new h(`INVALID_INPUT`,`--health and --sitemap-url cannot be combined with URL list input.`);let te=C(e.site),ne=(u?Qa(u)??u:void 0)??(te?Qa(te):void 0)??(d?new URL(`/`,d).toString():void 0)??l[0];if(!ne)throw new h(`INVALID_INPUT`,"No crawl URL given. Pass a URL, --url or --site. Run `seo sites` to list your Search Console properties.");let p=await c({url:ne,site:te,mode:ee??(f||d?`sitemap`:l.length?`list`:void 0),strategy:f?`health`:`full`,sitemapUrl:d,urls:l,maxPages:T(e[`max-pages`]),maxDepth:T(e[`max-depth`]),concurrency:T(e.concurrency),refresh:w(e.refresh),fetchRate:ni({...e,"fetch-concurrency":e.concurrency}),include:D(e.include),exclude:D(e.exclude),googleAnalyticsPropertyId:C(e[`google-analytics-property`]),analyticsConnection:Za(e),useSitemap:!Qr(e,`sitemap`),respectRobots:!Qr(e,`robots`),checkExternal:!Qr(e,`external`),js:Zr(e)}),re=Vt(p,{severity:o}),m=s?p.issues.some(e=>to[e.severity]>=to[s]):!1,ie=p.status===`failed`,ae={...p,topFixes:re,reviewObservations:_n(p,{severity:o}),...s?{failOn:s,failedThreshold:m}:{}};r===`json`?(await Ha(i,ae),(ie||m)&&(process.exitCode=1)):r===`csv`?(await uo(i,a===`pages`?wn(p):dt(p)),(ie||m)&&(process.exitCode=1)):r===`html`?(await uo(i,Re(p,re)),(ie||m)&&(process.exitCode=1)):r===`junit`?(await uo(i,n(p)),(ie||m)&&(process.exitCode=1)):r===`markdown`?(await uo(i,Ot(p,re)),(ie||m)&&(process.exitCode=1)):i?(await uo(i,rn(p,re)),(ie||m)&&(process.exitCode=1)):(Ya(p,re),s&&(process.stdout.write(`
|
|
47
|
+
`),await e.write(`${za(n+1)}${JSON.stringify(a)}: `),await Va(e,o,n+1,r)}return await e.write(`\n${za(n)}}`),!0}finally{r.delete(a)}}async function Ha(e,t){let n=new Ra(e);await Va(n,t,0,/* @__PURE__ */ new Set)||await n.write(`undefined`),await n.write(`
|
|
48
|
+
`),await n.flush()}async function Ua(e,t){if(!e){await Ha(process.stdout,t);return}await _r(Qn(e),{recursive:!0});let n=or(e);try{await Ha(n,t),n.end(),await Rr(n)}catch(e){throw n.destroy(),e}process.stdout.write(`Wrote ${e}\n`)}function Wa(e){return e.length?e.join(`, `):`none`}function Ga(e,t){let n=e.robotsTxt,r=(n?.botAccess??[]).filter(e=>e.purpose===t),i=t===`search`?`AI search bots`:`AI training bots`;if(!n||r.some(e=>e.allowed===null))return{status:`unknown`,title:`${i}: unknown`,explanation:`robots.txt could not be read (${n?.availability??`not checked`}).`};let a=r.filter(e=>e.allowed===!1);return{status:a.length?t===`search`?`warning`:`info`:`pass`,title:a.length?`${i}: ${a.length} of ${r.length} blocked`:`${i}: all ${r.length} allowed`,explanation:a.length?`Blocked: ${Wa(a.map(e=>e.userAgent))}.`:`Checked: ${Wa(r.map(e=>e.userAgent))}.`}}function Ka(e){let t=e.markdownNegotiation,n=e.markdownCopies,r=t?.markdown?`Accept: text/markdown returns Markdown${t.varyAccept?` with Vary: Accept`:` without Vary: Accept`}.`:t?.availability===`available`?`Accept: text/markdown returns ${t.contentType||`no content type`}.`:`Accept: text/markdown could not be checked (${t?.availability??`not checked`}).`,i=n?` ${n.publicPagesWithLink} of ${n.publicPages} public pages link to a Markdown copy${n.privatePagesWithLink?`, and ${n.privatePagesWithLink} signed-in pages do`:``}. ${n.checked} copies checked, ${n.broken.length} broken.${n.largest?` Largest checked copy: about ${n.largest.estimatedTokens} tokens.`:``}`:``;return{status:t?.markdown||n?.publicPagesWithLink?n?.broken.length||n?.privatePagesWithLink?`warning`:`pass`:t?.availability===`available`?`info`:`unknown`,title:`Markdown copies`,explanation:`${r}${i}`}}function qa(e){let t=e.llmsTxt;if(!t||t.availability===void 0)return{status:`unknown`,title:`llms.txt`,explanation:`Not checked.`};if(t.availability!==`available`)return{status:t.availability===`absent`?`info`:`unknown`,title:`llms.txt`,explanation:t.availability===`absent`?`Not found (HTTP ${t.status??`none`}).`:`Could not be read (${t.availability}).`};let n=t.links;return{status:n?.broken.length?`warning`:`pass`,title:`llms.txt`,explanation:n?`${n.found} same-site links; ${n.checked} checked, ${n.broken.length} broken.`:`Present.`}}function Ja(e){if(!e)return[];let t=(e.agentResources??[]).filter(e=>e.exists).map(e=>new URL(e.url).pathname),n=[...e.robotsTxt?.contentSignals??[],...e.startPageHeaders?.contentSignal?[e.startPageHeaders.contentSignal]:[]];return[Ga(e,`search`),Ga(e,`training`),Ka(e),qa(e),{status:`info`,title:`Agent files`,explanation:`Found: ${Wa(t)}.`},{status:`info`,title:`Content-Signal and Link header`,explanation:`Content-Signal: ${Wa([...new Set(n)])}. Link header relations on the start page: ${Wa(e.startPageHeaders?.linkRelations??[])}.`}]}function Ya(e){return e===`high`?`fail`:`warning`}function Xa(e,t=_t(e)){let n=Ut(e),r=e.status===`failed`||e.summary.highIssues>0?`fail`:e.status===`partial`?`unknown`:e.summary.mediumIssues>0||e.summary.lowIssues>0?`warning`:`pass`,i=e.access.samples.slice(0,5).map(e=>({status:`fail`,title:e.evidence.guidance.summary,explanation:`${e.evidence.provider} returned ${e.evidence.kind} evidence for the crawler request.`,evidence:[e.url],fix:e.evidence.guidance.recommendedAction})),a=t.slice(0,10).map(e=>({status:Ya(e.severity),title:`${e.title} on ${e.count} ${e.count===1?`URL`:`URLs`}`,explanation:en(e.ruleId)?.whyItMatters??e.whyThisRanks,evidence:e.sampleUrls.slice(0,5),fix:e.howToFix})),o=n.slice(0,10).map(e=>({status:`warning`,title:`${e.title} on ${e.count} ${e.count===1?`URL`:`URLs`}`,explanation:en(e.ruleId)?.whyItMatters??e.whyThisRanks,evidence:e.sampleUrls.slice(0,5),fix:e.howToFix}));Wi({title:e.config.strategy===`health`?`Sitemap health pass`:`Site crawl`,target:e.config.url,status:r,summary:e.status===`partial`?`Partial evidence from ${e.summary.totalPages} retained pages. Review the caveats before treating missing findings as an all-clear.`:`${e.summary.totalPages} pages retained with ${e.issues.length} findings.`,metrics:[{label:`Pages`,value:e.summary.totalPages},{label:`High`,value:e.summary.highIssues,status:`fail`},{label:`Medium`,value:e.summary.mediumIssues,status:`warning`},{label:`Low`,value:e.summary.lowIssues,status:`info`},{label:`Failed fetches`,value:e.summary.failedUrls}],sections:[{title:`Access diagnostics`,diagnostics:i},{title:`Prioritised fixes`,diagnostics:a},{title:`Review before changing anything`,diagnostics:o},{title:`Agent access`,diagnostics:Ja(e.ai)},...!i.length&&!a.length&&!o.length?[{title:`Checks`,diagnostics:[{status:`pass`,title:`No prioritised findings were observed`,explanation:`The evaluated crawl evidence did not produce a prioritised fix or review item.`}]}]:[]],notes:[`Strategy: ${e.config.strategy}. Data: ${e.status}. Report: ${e.id}.`,...e.warnings,...e.caveats]})}const Za={"google-analytics-property":{type:`string`,description:`Google Analytics property ID for landing-page sessions.`},"clicky-site-id":{type:`string`,description:`Clicky site ID for landing-page visits.`}};function Qa(e){let t=C(e[`google-analytics-property`]),n=C(e[`clicky-site-id`]);if(t&&n)throw new m(`INVALID_INPUT`,`Pass either --google-analytics-property or --clicky-site-id, not both.`);if(t)return{provider:`google`,propertyId:t};if(n)return{provider:`clicky`,siteId:lt(n)}}function $a(e){let t=e.trim();if(/^https?:\/\//i.test(t))return t;if(t.startsWith(`sc-domain:`))return`https://${t.slice(10)}/`;if(/^[a-z0-9-]+(\.[a-z0-9-]+)+(:\d+)?(\/\S*)?$/i.test(t))return`https://${t.includes(`/`)?t:`${t}/`}`}function eo(e){return e?e.backpressure?.status===`stopped`?`stopped: ${e.backpressure.reason??`origin cooldown`}`:e.backpressure?.status===`slowed`?`slowed ${e.backpressure.delayMs}ms`:e.rendering?.status===`unavailable`?`raw HTML; rendering unavailable`:e.rendering?.status===`failed`?`raw HTML; rendering failed`:e.blocked?`blocked`:e.rendered?`rendered`:e.cache===`hit`?`cached`:e.fetched?`fetched`:e.source:`-`}function to(e){return e?e===`serp-framing`?`wording gap`:e===`content-gap`?`content gap`:e===`technical-check`?`technical check`:`covered`:`-`}const no={high:3,medium:2,low:1},ro=v({meta:{name:`crawl`,description:`Run a fast sitemap health pass or a full technical crawl`},args:{crawlUrl:{type:`positional`,required:!1,description:`Site start URL. Optional with --sitemap-url.`},url:{type:`string`,description:`Start URL to crawl. Defaults to the --site home page.`},site:{type:`string`,description:`GSC property URL for joining page metrics.`},...Za,mode:{type:`string`,description:`Crawl mode: site, page, list, or sitemap. Start with sitemap --health for large sites.`},health:{type:`boolean`,default:!1,description:`Run the uncached sitemap status and redirect pass before a full audit. No page-body analysis.`},"sitemap-url":{type:`string`,description:`Explicit sitemap URL. Selects sitemap mode when --mode is omitted.`},urls:{type:`string`,description:`Comma-separated URLs for list mode.`},"urls-file":{type:`string`,description:`File with one URL per line for list mode.`},"max-pages":{type:`string`,description:`Maximum pages to crawl, up to 10,000. Defaults to 500.`},"max-depth":{type:`string`,description:`Maximum click depth, up to 64. Defaults to 16.`},concurrency:{type:`string`,description:`Parallel page fetches, up to 16. Defaults to 8, or progressively up to 4 with --health.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache and fetch fresh pages.`},include:{type:`string`,description:`Comma-separated URL patterns to include.`},exclude:{type:`string`,description:`Comma-separated URL patterns to exclude.`},"no-sitemap":{type:`boolean`,default:!1,description:`Do not seed URLs from sitemap.xml.`},"no-robots":{type:`boolean`,default:!1,description:`Do not skip URLs disallowed by robots.txt.`},"no-external":{type:`boolean`,default:!1,description:`Do not check external links. Reserved for full link checks.`},js:{type:`boolean`,default:!1,description:`Legacy alias for --rendering on.`},rendering:{type:`string`,description:`JavaScript rendering mode: auto, on, or off. Defaults to auto.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON. Alias for --format json.`},format:{type:`string`,description:`Output format: pretty, json, csv, html, markdown, or junit. JUnit requires --health.`},output:{type:`string`,description:`Write output to this path instead of stdout.`},csv:{type:`string`,description:`CSV table to render: issues or pages. Defaults to issues.`},severity:{type:`string`,description:`Only show top fixes at this severity.`},"fail-on":{type:`string`,description:`Exit non-zero when issues exist at this severity or above.`}},run:async({args:e})=>{let t=O(e),r=so(e.format,t),i=C(e.output),a=co(e.csv),o=ao(e.severity),s=ao(e[`fail-on`]),c=await lo(e),l=oo(e),u=C(e[`sitemap-url`]),d=w(e.health),ee=io(e.mode);if(r===`junit`&&!d)throw new m(`INVALID_INPUT`,`--format junit requires --health.`);if((d||u)&&ee&&ee!==`sitemap`)throw new m(`INVALID_INPUT`,`--health and --sitemap-url require sitemap mode.`);if(d&&$r(e,`sitemap`))throw new m(`INVALID_INPUT`,`--health cannot be combined with --no-sitemap.`);if((d||u)&&c.length)throw new m(`INVALID_INPUT`,`--health and --sitemap-url cannot be combined with URL list input.`);let te=C(e.site),ne=(l?$a(l)??l:void 0)??(te?$a(te):void 0)??(u?new URL(`/`,u).toString():void 0)??c[0];if(!ne)throw new m(`INVALID_INPUT`,"No crawl URL given. Pass a URL, --url or --site. Run `seo sites` to list your Search Console properties.");let f=await et({url:ne,site:te,mode:ee??(d||u?`sitemap`:c.length?`list`:void 0),strategy:d?`health`:`full`,sitemapUrl:u,urls:c,maxPages:T(e[`max-pages`]),maxDepth:T(e[`max-depth`]),concurrency:T(e.concurrency),refresh:w(e.refresh),fetchRate:ri({...e,"fetch-concurrency":e.concurrency}),include:D(e.include),exclude:D(e.exclude),googleAnalyticsPropertyId:C(e[`google-analytics-property`]),analyticsConnection:Qa(e),useSitemap:!$r(e,`sitemap`),respectRobots:!$r(e,`robots`),checkExternal:!$r(e,`external`),js:Qr(e)}),re=_t(f,{severity:o}),p=s?f.issues.some(e=>no[e.severity]>=no[s]):!1,ie=f.status===`failed`,ae={...f,topFixes:re,reviewObservations:Ut(f,{severity:o}),...s?{failOn:s,failedThreshold:p}:{}};r===`json`?(await Ua(i,ae),(ie||p)&&(process.exitCode=1)):r===`csv`?(await fo(i,a===`pages`?on(f):ze(f)),(ie||p)&&(process.exitCode=1)):r===`html`?(await fo(i,n(f,re)),(ie||p)&&(process.exitCode=1)):r===`junit`?(await fo(i,At(f)),(ie||p)&&(process.exitCode=1)):r===`markdown`?(await fo(i,Tn(f,re)),(ie||p)&&(process.exitCode=1)):i?(await fo(i,vn(f,re)),(ie||p)&&(process.exitCode=1)):(Xa(f,re),s&&(process.stdout.write(`
|
|
49
49
|
Run metadata
|
|
50
|
-
`),F([[`Fail threshold`,s]])),(ie||
|
|
50
|
+
`),F([[`Fail threshold`,s]])),(ie||p)&&(process.exitCode=1))}});function io(e){let t=C(e);if(t){if([`site`,`page`,`list`,`sitemap`].includes(t))return t;throw new m(`INVALID_INPUT`,`Mode must be one of: site, page, list, sitemap.`)}}function ao(e){let t=C(e);if(t){if([`low`,`medium`,`high`].includes(t))return t;throw new m(`INVALID_INPUT`,`Severity must be one of: low, medium, high.`)}}function oo(e){let t=C(e.crawlUrl),n=C(e.url);if(t&&n&&t!==n)throw new m(`INVALID_INPUT`,`Use either a URL argument or --url, not both.`);return t??n}function so(e,t){let n=C(e);if(t&&n&&n!==`json`)throw new m(`INVALID_INPUT`,`Use either --json or --format, not both.`);if(!n)return t?`json`:`pretty`;if([`pretty`,`json`,`csv`,`html`,`markdown`,`junit`].includes(n))return n;throw new m(`INVALID_INPUT`,`Format must be one of: pretty, json, csv, html, markdown, junit.`)}function co(e){let t=C(e);if(!t)return`issues`;if([`issues`,`pages`].includes(t))return t;throw new m(`INVALID_INPUT`,`CSV table must be one of: issues, pages.`)}async function lo(e){let t=D(e.urls)??[],n=C(e[`urls-file`]);return n&&t.push(...uo(await _(n,`utf8`))),[...new Set(t)]}function uo(e){return e.split(/[\n,]/).map(e=>e.trim()).filter(e=>e&&!e.startsWith(`#`))}async function fo(e,t){e?(await _r(Qn(e),{recursive:!0}),await br(e,t),process.stdout.write(`Wrote ${e}\n`)):process.stdout.write(t)}const po=v({meta:{name:`gsc-query`,description:`Run a raw Search Console Search Analytics query`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},account:{type:`string`,description:`Saved Google account email.`},"start-date":{type:`string`,description:`Start date YYYY-MM-DD.`},"end-date":{type:`string`,description:`End date YYYY-MM-DD. Without dates: the last 28 days of final data.`},dimensions:{type:`string`,description:`Comma-separated GSC dimensions, for example query,page.`},type:{type:`string`,description:`Search type. Defaults to web.`},limit:{type:`string`,description:`Maximum rows to request and print.`},body:{type:`string`,description:`Raw Search Analytics JSON body.`},"body-file":{type:`string`,description:`Path to a Search Analytics JSON body file.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},refresh:{type:`boolean`,default:!1,description:`Bypass local cache and fetch fresh GSC data.`}},run:async({args:e})=>{let t=await ii(e.body,e[`body-file`])??{startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),dimensions:D(e.dimensions)??[`query`,`page`],type:C(e.type)??`web`,rowLimit:T(e.limit),dataState:`final`};try{Object.assign(t,En({startDate:C(t.startDate),endDate:C(t.endDate)},28))}catch(e){throw f(e)}let n=O(e),r=k(C(e.site)??C(t.siteUrl));delete t.siteUrl;let i=await Pt(r,t,{refresh:w(e.refresh),accountEmail:C(e.account)}),a=T(e.limit),o=a?i.rows.slice(0,a):i.rows;n?P({site:r,request:t,...i,rows:o,rowsReturned:o.length}):(K({title:`Search Console query`,target:r,status:i.rowsFetched>o.length?`unknown`:`info`,summary:`${o.length} rows returned from ${i.rowsFetched} fetched rows.`,metrics:[{label:`Rows returned`,value:o.length},{label:`Rows fetched`,value:i.rowsFetched},{label:`API calls`,value:i.calls}]}),I([`Keys`,`Clicks`,`Impr`,`CTR`,`Pos`],o.slice(0,25).map(e=>[e.keys.join(` | `),Math.round(e.clicks),Math.round(e.impressions),e.ctr.toFixed(3),e.position.toFixed(1)])))}}),mo=v({meta:{name:`url-inspect`,description:`Inspect a URL with the Search Console URL Inspection API`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},account:{type:`string`,description:`Saved Google account email.`},url:{type:`string`,description:`URL to inspect.`},language:{type:`string`,description:`Optional inspection language code.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=k(C(e.site)),r=C(e.url);if(!r)throw Error(`Pass --url.`);let i=await pn({siteUrl:n,inspectionUrl:r,accountEmail:C(e.account),languageCode:C(e.language)});if(t){P(i);return}let a=i.inspectionResult?.indexStatusResult;K({title:`URL Inspection`,target:r,status:a===void 0?`unknown`:a.verdict===`PASS`?`pass`:`warning`,summary:a===void 0?`Google did not return index status evidence for this URL.`:`${a.verdict??`Unknown`}: ${a.coverageState??`Coverage state unavailable`}.`,metrics:[{label:`Property`,value:n},{label:`Robots`,value:a?.robotsTxtState??`Unknown`},{label:`Last crawl`,value:a?.lastCrawlTime??`Unknown`},{label:`Google canonical`,value:a?.googleCanonical??`Unknown`}]})}}),ho={days:{cli:`days`,arg:{type:`string`,description:`GSC lookback window. Defaults to 28.`}},recentDays:{cli:`recent`,arg:{type:`string`,description:`Recent anomaly window in days. Defaults to 14.`}},range:{cli:`days`,arg:{type:`string`,description:`GSC lookback window. Defaults to 28.`}},limit:{cli:`limit`,arg:{type:`string`,description:`Maximum rows to return.`}},checkLimit:{cli:`check-limit`,arg:{type:`string`,description:`Maximum candidate pages to fetch and check.`}},minImpressions:{cli:`min-impressions`,arg:{type:`string`,description:`Minimum query impressions.`}},includeBrand:{cli:`include-brand`,arg:{type:`boolean`,default:!1,description:`Include branded queries in opportunity reports.`}},verifyContent:{cli:`verify-content`,arg:{type:`boolean`,default:!1,description:`Verify top opportunities against page title, meta, and content.`}},verifyLimit:{cli:`verify-limit`,arg:{type:`string`,description:`Maximum opportunity URLs to verify.`}},js:{cli:`js`,arg:{type:`boolean`,default:!1,description:`Force JavaScript rendering for verified pages.`}},fetchConcurrency:{cli:`fetch-concurrency`,arg:{type:`string`,description:`Maximum concurrent page fetches per host, up to 16. Defaults to 4.`}},fetchIntervalCap:{cli:`fetch-interval-cap`,arg:{type:`string`,description:`Maximum page fetches per interval per host. Defaults to 4.`}},fetchIntervalMs:{cli:`fetch-interval-ms`,arg:{type:`string`,description:`Fetch rate interval in milliseconds. Defaults to 1000.`}},refresh:{cli:`refresh`,arg:{type:`boolean`,default:!1,description:`Bypass local cache and fetch fresh data.`}}};function X(e,t={}){return Object.fromEntries(e.map(e=>{let n=ho[e];return[n.cli,{...n.arg,...t[e]}]}))}function go(e){return e.toLocaleString(`en-GB`,{maximumFractionDigits:e>=100?0:1})}function _o(e){if(e===null)return`n/a`;let t=Math.abs(e)>=10?e.toFixed(0):e.toFixed(1);return`${e>0?`+`:``}${t}%`}const vo=v({meta:{name:`traffic-anomaly`,description:`Detect unusual recent GSC traffic movement`},args:{site:{type:`string`},...X([`days`,`recentDays`,`refresh`],{days:{description:`Baseline window length in days. Defaults to 90.`},recentDays:{description:`Recent anomaly window in days. Defaults to 7.`},refresh:{description:`Bypass local cache and fetch fresh GSC data.`}}),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=await Jt({site:k(C(e.site)),days:T(e.days),recentDays:T(e.recent),refresh:w(e.refresh)});t?P(n):(K({title:`Traffic anomaly report`,target:n.site,status:n.coverage?.status===`complete`?n.anomalies.some(e=>e.significant)?`warning`:`pass`:`unknown`,summary:n.anomalies.some(e=>e.significant)?`At least one recent metric moved beyond the report threshold.`:`No significant recent movement was found in the retained evidence.`,metrics:[{label:`Metrics checked`,value:n.anomalies.length},{label:`Significant`,value:n.anomalies.filter(e=>e.significant).length},{label:`Observed days`,value:n.coverage?.observedDays??`Unavailable`},{label:`Expected days`,value:n.coverage?.expectedDays??`Unavailable`}]}),q([`Metric`,`Direction`,`Baseline/day`,`Recent/day`,`Change`,`z`,`Significant`],n.anomalies.map(e=>[e.metric,e.direction,go(e.baselineMean),go(e.comparisonMean),_o(e.percentChange),e.zScore??`n/a`,e.significant?`yes`:`no`])),n.coverage&&Y(`Evidence coverage`,[`${n.coverage.observedDays} of ${n.coverage.expectedDays} requested calendar days returned date aggregates.`,...n.coverage.caveats]))}}),yo=v({meta:{name:`update-correlate`,description:`Compare traffic movement with official Google update windows`},args:{site:{type:`string`},...X([`days`,`recentDays`,`refresh`],{days:{description:`Baseline window length in days. Defaults to 90.`},recentDays:{description:`Recent anomaly window in days. Defaults to 7.`},refresh:{description:`Bypass local cache and fetch fresh GSC data.`}}),"padding-days":{type:`string`,description:`Days around update windows to count as overlap.`},"known-change":{type:`string`,description:`Manual site-side change to treat as a confounder, for example pruning pages or blocking traffic.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=k(C(e.site)),r=await De({site:n,days:T(e.days),recentDays:T(e.recent),paddingDays:T(e[`padding-days`]),knownConfounders:C(e[`known-change`])?[C(e[`known-change`])??``]:void 0,refresh:w(e.refresh)});t?P(r):(K({title:`Google update correlation`,target:r.site,status:`unknown`,summary:r.summary,metrics:[{label:`Classification`,value:r.classification.replaceAll(`-`,` `)},{label:`Attribution`,value:r.attribution.replaceAll(`-`,` `)},{label:`Confidence`,value:r.confidence},{label:`Updates matched`,value:r.overlappingUpdates.length},{label:`Known confounders`,value:r.confounders.length},{label:`Source`,value:r.source.name}]}),Y(`Evidence`,r.evidence),Y(`Report caveats`,r.caveats),Y(`Recommended next checks`,r.actions),q([`Metric`,`Direction`,`Baseline/day`,`Recent/day`,`Change`,`z`],r.anomalies.map(e=>[e.metric,e.direction,go(e.baselineMean),go(e.comparisonMean),_o(e.percentChange),e.zScore??`n/a`])),r.overlappingUpdates.length&&(process.stdout.write(`
|
|
51
51
|
Updates
|
|
52
|
-
`),I([`Start`,`End`,`Type`,`Name`],r.overlappingUpdates.map(e=>[e.start.slice(0,10),e.end?.slice(0,10)??`open`,e.type,e.name]))),
|
|
53
|
-
`};function
|
|
54
|
-
`,config:{}};let t=
|
|
55
|
-
`)}const
|
|
56
|
-
`));else{if(await
|
|
57
|
-
`),
|
|
58
|
-
`),`Setup will`),b(
|
|
59
|
-
`),`Then run`),x(`Dry run complete. Nothing was changed.`));return}
|
|
60
|
-
`),`MCP setup skipped`),
|
|
61
|
-
seo report --site <site> run the main report for one of them`,`Try next`),x(`Setup complete.`),
|
|
52
|
+
`),I([`Start`,`End`,`Type`,`Name`],r.overlappingUpdates.map(e=>[e.start.slice(0,10),e.end?.slice(0,10)??`open`,e.type,e.name]))),Ia(`seo segment-impact --site ${JSON.stringify(n)} --dimension page`))}}),bo={site:{type:`string`,description:`Search Console property, for example sc-domain:example.com.`}};function xo(e){return{type:`string`,description:`Output folder. Defaults to ./seo-export/<site>-${e}-YYYY-MM-DD.`}}function So(e){return e.toLowerCase().replace(/^sc-domain:/,``).replace(/^https?:\/\//,``).replace(/[^a-z0-9._-]+/g,`-`).replace(/^-+|-+$/g,``)}function Co(e){let t=(/* @__PURE__ */ new Date()).toISOString().slice(0,10),n=So(e.site);return tr(process.cwd(),`seo-export`,`${n}-${e.report}-${t}`)}async function wo(e,t){await _r(e,{recursive:!0});let n=[];for(let r of t){let t=tr(e,r.filename);await br(t,xn(r.rows,r.headers),`utf8`),n.push(t)}return n}function To(e,t){process.stdout.write(`Wrote ${Kn(t.length,`CSV file`)} to ${e}\n`);for(let e of t)process.stdout.write(`- ${e}\n`)}const Eo=v({meta:{name:`refresh-priorities`,description:`Export the ranked SEO priority queue, score breakdowns, grouped findings, and diagnosis detail CSVs.`},args:{...bo,out:xo(`refresh-priorities`),...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum queue items to export. Defaults to 25.`}}),...Za,"verify-content":Zr(`Verify top opportunities against page title, meta, and content. Defaults to true.`,`Skip page content verification.`),"verify-limit":{type:`string`,description:`Maximum opportunity URLs to verify. Defaults to 5.`}},run:async({args:e})=>{let t=k(C(e.site)),n=await Ge({site:t,days:T(e.days),recentDays:T(e.recent),limit:T(e.limit),includeBrand:w(e[`include-brand`]),googleAnalyticsPropertyId:C(e[`google-analytics-property`]),analyticsConnection:Qa(e),verifyContent:w(e[`verify-content`]),verifyLimit:T(e[`verify-limit`]),refresh:w(e.refresh)}),r=C(e.out)??Co({report:`refresh-priorities`,site:t});To(r,await wo(r,un(n)))}}),Do=v({meta:{name:`update-postmortem`,description:`Export update postmortem attribution, findings, template movement, and segment movers.`},args:{...bo,out:xo(`update-postmortem`),...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum winners/losers per segment. Defaults to 20.`}}),"known-change":{type:`string`,description:`Manual site-side change to treat as a confounder, for example pruning pages or blocking traffic.`}},run:async({args:e})=>{let t=k(C(e.site)),n=await Bn({site:t,days:T(e.days),recentDays:T(e.recent),limit:T(e.limit),includeBrand:w(e[`include-brand`]),knownConfounders:C(e[`known-change`])?[C(e[`known-change`])??``]:void 0,refresh:w(e.refresh)}),r=C(e.out)??Co({report:`update-postmortem`,site:t});To(r,await wo(r,Kr(n)))}}),Oo=v({meta:{name:`export`,description:`Export full report data to CSV files`},subCommands:{"update-postmortem":Do,"refresh-priorities":Eo}});function ko(e,t,n={}){if(process.platform!==`win32`)return wr(e,t,n);let r=e=>/^[\w./:=@\\-]+$/.test(e)?e:`"${e.replaceAll(`"`,`""`)}"`;return wr([e,...t].map(r).join(` `),{...n,shell:!0})}function Ao(e){let t=e.platform===`win32`?rr:$n;return e.platform===`win32`?e.env.APPDATA??t.resolve(e.home,`AppData/Roaming`):e.platform===`darwin`?t.resolve(e.home,`Library/Application Support`):e.env.XDG_CONFIG_HOME??t.resolve(e.home,`.config`)}function jo(e={}){let t=e.home??Yn(),n=e.platform??process.platform,r=Ao({home:t,platform:n,env:e.env??process.env}),i=n===`win32`?rr:$n,a=[];if(n===`darwin`||n===`win32`){let e=i.resolve(r,`Claude`);a.push({kind:`json`,client:`claude-desktop`,label:`Claude Desktop`,path:i.resolve(e,`claude_desktop_config.json`),commandNames:[],detectionPaths:n===`darwin`?[e,`/Applications/Claude.app`]:[e]})}return a.push({kind:`json`,client:`claude-code`,label:`Claude Code`,path:i.resolve(t,`.claude.json`),includeType:!0,commandNames:[`claude`],detectionPaths:[i.resolve(t,`.claude`)]},{kind:`native`,client:`codex`,label:`Codex`,path:i.resolve(t,`.codex/config.toml`),executable:`codex`,commandNames:[`codex`],detectionPaths:[i.resolve(t,`.codex`)]},{kind:`json`,client:`cursor`,label:`Cursor`,path:i.resolve(t,`.cursor/mcp.json`),commandNames:[`cursor`,`cursor-agent`],detectionPaths:[i.resolve(t,`.cursor`),...n===`darwin`?[`/Applications/Cursor.app`]:[]]}),a}function Mo(e,t={}){let n=t.platform??process.platform,r=t.exists??g,i=t.nodePath??process.execPath,a=n===`win32`?[`${e}.cmd`,`${e}.exe`,e]:[e],o=(t.path??process.env.PATH??``).split(n===`win32`?`;`:`:`).filter(Boolean);for(let e of o)for(let t of a){let n=h(e,t);if(r(n))return n}for(let e of a){let t=h(Qn(i),e);if(r(t))return t}return e}function No(e){return Mo(e)!==e}function Po(e={}){let t=e.targets??jo(),n=e.hasCommand??No,r=e.hasPath??g;return t.filter(e=>e.kind===`native`?e.commandNames.some(n):r(e.path)||e.detectionPaths.some(r)||e.commandNames.some(n))}const Fo={insertSpaces:!0,tabSize:2,eol:`
|
|
53
|
+
`};function Io(){return(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g,`-`)}function Lo(e,t){sr(Qn(e),{recursive:!0,mode:448});let n=`${e}.${process.pid}.${Date.now()}.tmp`,r=g(e)?pr(e).mode&511:384;mr(n,t,{encoding:`utf8`,mode:r}),dr(n,e)}function Ro(e){let t=`${e}.bak-${Io()}`,n=t,r=2;for(;g(n);)n=`${t}-${r}`,r+=1;ar(e,n,ir.COPYFILE_EXCL)}function zo(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Bo(e){if(!g(e.path))return{source:`{}
|
|
54
|
+
`,config:{}};let t=cr(e.path,`utf8`),n=[],r=Vr(t,n,{allowTrailingComma:!0});if(n.length>0){let t=n[0],r=t?`${Hr(t.error)} at offset ${t.offset}`:`unknown parse error`;throw Error(`Cannot update ${e.path}: invalid JSONC (${r}).`)}if(!zo(r))throw Error(`Cannot update ${e.path}: config root must be an object.`);if(r.mcpServers!==void 0&&!zo(r.mcpServers))throw Error(`Cannot update ${e.path}: mcpServers must be an object.`);return{source:t,config:r}}function Vo(e){return e.includes(`mcp`)&&e.includes(`serve`)&&e.some(e=>e===`seo`||e.startsWith(`seo@`)||e===`@seo/cli`)}function Ho(e,t){return typeof e.command!=`string`||t.length!==3||t[1]!==`mcp`||t[2]!==`serve`||!zo(e.env)?!1:e.env.SEO_MCP_CONFIGURED_BY===`seo`}function Uo(e){if(!zo(e)||!Array.isArray(e.args))return!1;let t=e.args.filter(e=>typeof e==`string`);return Vo(t)||Ho(e,t)}function Wo(e){let t=zr(e.source,Br(e.source,[`mcpServers`,e.name??`seo`],e.value,{formattingOptions:Fo}));g(e.target.path)&&Ro(e.target.path),Lo(e.target.path,t)}function Go(e,t){let n=ko(e,t,{encoding:`utf8`});return{status:n.status,stdout:String(n.stdout??``),stderr:String(n.stderr??``),error:n.error}}function Ko(e){let t=e.replaceAll(`\\`,`/`).toLowerCase();return t.includes(`/_npx/`)||t.includes(`/.npm/_npx/`)||t.includes(`/.cache/pnpm/dlx/`)}function qo(e){if(!e||!g(e))return;let t=ur(e);return Ko(t)?void 0:t}function Jo(e={}){let t=qo(e.cliPath??process.argv[1]);if(t)return{command:e.nodePath??process.execPath,args:[t,`mcp`,`serve`]};let n=`seo@${e.version??at}`;return(e.platform??process.platform)===`win32`?{command:`cmd`,args:[`/c`,`npx`,`-y`,n,`mcp`,`serve`]}:{command:`npx`,args:[`-y`,n,`mcp`,`serve`]}}function Yo(e=!1,t=Jo()){let n=jt(),r={command:t.command,args:t.args,env:{SEO_CONFIG_DIR:n.configDir,SEO_MCP_CONFIGURED_BY:`seo`}};return e&&(r.type=`stdio`),r}function Xo(e){return e.includes(`SEO_MCP_CONFIGURED_BY`)||/args:\s+-y\s+(?:seo(?:@\S+)?|@seo\/cli)\s+mcp\s+serve\b/.test(e)}function Zo(e,t,n){let r=Mo(e.executable),i=n.runCommand(r,[`mcp`,`get`,`seo`]);if(i.error?.code===`ENOENT`)throw Error("Cannot install SEO MCP for Codex: the `codex` command is not available on PATH. Install Codex CLI or choose another MCP client.");let a=i.status===0;if(a&&!Xo(i.stdout))throw Error(`Cannot ${t} SEO MCP: ${e.path} already has an unmanaged mcp_servers.seo entry.`);if(t===`install`&&a&&!n.reinstall||t===`uninstall`&&!a)return{client:e.client,path:e.path,changed:!1};if(t===`install`&&a){let e=n.runCommand(r,[`mcp`,`remove`,`seo`]);if(e.error||e.status!==0){let t=e.error?.message??e.stderr.trim()??`unknown error`;throw Error(`Cannot reinstall SEO MCP for Codex: ${t}`)}}let o=jt(),s=t===`install`?[`mcp`,`add`,`seo`,`--env`,`SEO_CONFIG_DIR=${o.configDir}`,`--env`,`SEO_MCP_CONFIGURED_BY=seo`,`--`,n.serverCommand.command,...n.serverCommand.args]:[`mcp`,`remove`,`seo`],c=n.runCommand(r,s);if(c.error||c.status!==0){let e=c.error?.message??c.stderr.trim()??`unknown error`;throw Error(`Cannot ${t} SEO MCP for Codex: ${e}`)}return{client:e.client,path:e.path,changed:!0}}function Qo(e,t={}){let n={runCommand:t.runCommand??Go,reinstall:t.reinstall??!1,serverCommand:t.serverCommand??Jo()};if(e.kind===`native`)return Zo(e,`install`,n);let{source:r,config:i}=Bo(e),a=i.mcpServers?.seo,o=Yo(e.includeType,n.serverCommand);if(xr(a,o)&&!n.reinstall)return{client:e.client,path:e.path,changed:!1};if(a!==void 0&&!Uo(a))throw Error(`Cannot install SEO MCP: ${e.path} already has an unmanaged mcpServers.seo entry.`);return Wo({target:e,source:r,value:o}),{client:e.client,path:e.path,changed:!0}}function $o(e,t={}){if(e.kind===`native`)return Zo(e,`uninstall`,{runCommand:t.runCommand??Go,reinstall:!1,serverCommand:Jo()});if(!g(e.path))return{client:e.client,path:e.path,changed:!1};let{source:n,config:r}=Bo(e),i=r.mcpServers;if(i?.seo===void 0)return{client:e.client,path:e.path,changed:!1};if(!Uo(i.seo))throw Error(`Cannot uninstall SEO MCP: ${e.path} has an unmanaged mcpServers.seo entry.`);return Wo({target:e,source:n,value:void 0}),{client:e.client,path:e.path,changed:!0}}const es=`https://seoskill.dev/mcp`,ts=`seoskill`;function ns(e){return e.client!==`claude-desktop`}function rs(e){return e.includeType?{type:`http`,url:es}:{url:es}}function is(e){return zo(e)&&e.url===`https://seoskill.dev/mcp`}function as(e,t={}){if(!ns(e))throw Error(`${e.label} takes the hosted server from its Connectors settings, not its config file.`);if(e.kind===`native`){let n=t.runCommand??Go,r=Mo(e.executable),i=n(r,[`mcp`,`get`,ts]);if(i.error?.code===`ENOENT`)throw Error("Cannot add the hosted MCP server for Codex: the `codex` command is not available on PATH.");if(i.status===0){if(i.stdout.includes(`https://seoskill.dev/mcp`))return{client:e.client,path:e.path,changed:!1};throw Error(`Cannot add the hosted MCP server: ${e.path} already has a different mcp_servers.${ts} entry.`)}let a=n(r,[`mcp`,`add`,ts,`--url`,es]);if(a.error||a.status!==0){let e=a.error?.message??a.stderr.trim()??`unknown error`;throw Error(`Cannot add the hosted MCP server for Codex: ${e}`)}return{client:e.client,path:e.path,changed:!0}}let{source:n,config:r}=Bo(e),i=r.mcpServers?.[ts];if(is(i))return{client:e.client,path:e.path,changed:!1};if(i!==void 0)throw Error(`Cannot add the hosted MCP server: ${e.path} already has a different mcpServers.${ts} entry.`);return Wo({target:e,source:n,value:rs(e),name:ts}),{client:e.client,path:e.path,changed:!0}}const os=e=>process.stdout.write(`${e}\n`);async function ss(){let{google:e,bing:t,keys:n}=await Ee();return{status:`linked`,google:e.map(e=>e.email),bing:t.length,keys:Object.keys(n).filter(e=>e!==`x-dataforseo-login`&&!e.startsWith(`x-clicky-`)),clicky:Object.keys(n).filter(e=>e.startsWith(Cn)).length}}function cs(e){return[`Linked to your seoskill.dev account.`,`Google: ${e.google.join(`, `)||`none`}.`,`Bing: ${e.bing?`${e.bing} linked`:`not connected (add it at ${qt}/account)`}.`,`Keys: ${e.keys.length?e.keys.map(e=>e.replace(/^x-|-(key|password)$/g,``)).join(`, `):`none`}.`,`Clicky: ${e.clicky?`${e.clicky} site${e.clicky===1?``:`s`}`:`none`}.`,`Next: seo sites, then seo report --site <site>.`].join(`
|
|
55
|
+
`)}const ls=v({meta:{name:`login`,description:`Link this machine to your seoskill.dev account: its Google accounts, Bing and keys`},args:{json:{type:`boolean`,default:!1,description:`Print JSON.`}},run:async({args:e})=>{let t=O(e),n=async()=>{let e=await ss();t?P(e):os(cs(e))};if(process.env.SEO_TOKEN?.trim()){await n();return}if(Ve()){let e=await ae();if(e===`linked`)return n();if(e===`pending`&&!N({json:t})){let e=Ve();t?P({status:`pending`,...ds(e)}):os(`Waiting for approval. Open ${e?.url} and click "Link this machine", then run \`seo login\` again.`);return}}else if(ke()){await n();return}let r=Ve()??await Gn();if(!N({json:t}))t?P({status:`pending`,...ds(r)}):os([`Open this link in the person's browser and ask them to approve it:`,r.url,`Code: ${r.code}. After they approve, run \`seo login\` again.`].join(`
|
|
56
|
+
`));else{if(await us())return n();os("The login expired. Run `seo login` again."),process.exitCode=1}}});async function us(){let e=Ve()??await Gn();for(os(`Opening ${e.url}\nApprove code ${e.code} there. Waiting…`),await Ce(e.url);Ve();){await new Promise(e=>setTimeout(e,3e3));let e=await ae();if(e===`linked`)return!0;if(e===`expired`)break}return!1}const ds=e=>({url:e?.url,code:e?.code}),fs=v({meta:{name:`logout`,description:`Unlink this machine from your seoskill.dev account`},args:{json:{type:`boolean`,default:!1,description:`Print JSON.`}},run:async({args:e})=>{let t=await Fe();O(e)?P({unlinked:t}):os(t?`This machine is no longer linked to your seoskill.dev account.`:`This machine was not linked.`)}});function ps(e={}){let t=ko(`npx`,[`-y`,`skills`,`add`,`iannuttall/seo`],{stdio:e.quiet?`ignore`:`inherit`});return t.error?{status:`failed`,error:t.error.message}:t.status===0?{status:`installed`}:{status:`failed`,error:`npx skills add exited with status ${t.status??`unknown`}.`}}async function ms(e){let t=async()=>{let{google:e}=await Ee().catch(()=>({google:[]}));return{status:`linked`,accountEmail:e.map(e=>e.email).join(`, `)||void 0}};if(process.env.SEO_TOKEN?.trim()||ke())return t();if(!e.interactive)return null;let n=L(await Nr({message:`How do you want to sign in?`,options:[{value:`account`,label:`Sign in or create a free seoskill.dev account`,hint:`Recommended. Your Google accounts, Bing and keys in one place, for the CLI and the hosted MCP`},{value:`local`,label:`Sign in with Google on this machine only`},{value:`skip`,label:`Skip for now`}]}));return n===`skip`?{status:`skipped`}:n===`local`?null:await us()?t():(b("The link expired. Run `seo login` to try again.",`Not signed in`),{status:`skipped`})}function hs(e){let t={value:`skip`,label:`Skip for now`};return e.sharedConfigured||e.byoConfigured?[{value:`login`,label:`Connect Google`,hint:`Opens your browser for read-only Search Console and Google Analytics access`},t]:[{value:`setup`,label:`Set up Google login for local development`,hint:`This source checkout does not include the public app credentials`},t]}async function gs(){let e=await wa();return b(`Connected as ${e.account_email}. seo has read-only access and cannot change your site.`,`Google connected`),{status:`connected`,accountEmail:e.account_email}}async function _s(e){let t=await zn();if(t.activeMode===`service-account`)return{status:`service-account`,accountEmail:t.identity};if(!e.interactive){if(t.tokens)return{status:`already-connected`,accountEmail:t.tokens.account_email};throw new m(`AUTH_REQUIRED`,me())}let n=re();if(n.length>0){let e=L(await Nr({message:`Google account to use`,options:[...n.map(e=>({value:{type:`account`,accountEmail:e.accountEmail},label:e.accountEmail,hint:e.active?`Current default`:void 0})),{value:{type:`connect`},label:`Connect another Google account`}]}));if(e.type===`account`)return Me(e.accountEmail),{status:`already-connected`,accountEmail:e.accountEmail};if(t.sharedConfigured||t.byoConfigured)return gs()}let r=L(await Nr({message:`Connect Google now?`,options:hs({sharedConfigured:t.sharedConfigured,byoConfigured:t.byoConfigured})}));if(r===`skip`)return{status:`skipped`};if(r===`setup`){let e=L(await Pr({message:`Google Desktop OAuth client ID`,validate:e=>e?void 0:`Client ID is required`})),t=L(await Mr({message:`Google Desktop OAuth client secret`,validate:e=>e?void 0:`Client secret is required`}));i({clientId:e,clientSecret:t})}return gs()}async function vs(){return L(await Or({message:`Install the SEO skill so your agents know how to use seo?`,initialValue:!0}))?ps():{status:`declined`}}async function ys(){let e=Po();if(e.length===0)return[];let t=L(await Nr({message:`Add an MCP server to your agents?`,options:[{value:`hosted`,label:`Free hosted server (recommended)`,hint:`${es}, your agent asks you to sign in with Google`},{value:`local`,label:`Local server`,hint:`Runs on this machine with the sign-in from this setup`},{value:`skip`,label:`Skip for now`}]}));if(t===`skip`)return[];let n=L(await jr({message:`Which agents?`,options:e.map(e=>({value:e.client,label:e.label,hint:e.path})),initialValues:e.map(e=>e.client)})),r=e.filter(e=>n.includes(e.client)).map(e=>{let n=t===`hosted`&&ns(e)?`hosted`:`local`;try{return{...n===`hosted`?as(e):Qo(e),server:n}}catch(t){return{client:e.client,path:e.path,server:n,changed:!1,error:t instanceof Error?t.message:String(t)}}});return t===`hosted`&&r.some(e=>e.client===`claude-desktop`)&&b(`Claude Desktop got the local server. To use the hosted one there, open Settings, then Connectors, and add ${es} as a custom connector.`,`Claude Desktop`),r}const bs=[`seo sites`,`seo report --site <site>`],xs=[`Sign in or create your free seoskill.dev account, or sign in with Google on this machine only (read-only Search Console and Google Analytics).`,`Add the free hosted MCP server (${es}) or a local one to your agents.`,`Install the SEO skill for your agents.`];function Ss(e){return e.status===`skipped`?`skipped`:e.status===`linked`?`seoskill.dev account${e.accountEmail?` (${e.accountEmail})`:``}`:e.status===`service-account`?`service account${e.accountEmail?` ${e.accountEmail}`:``}`:e.accountEmail??`connected`}function Cs(e){return e.status===`installed`?`installed`:e.status===`failed`?`install failed`:`not installed`}function ws(e){return e.length===0?`not added`:e.map(e=>e.error?`${e.client} skipped`:`${e.client} (${e.server})`).join(`, `)}function Ts(){process.stdout.write(`
|
|
57
|
+
`),Vi({title:`Help other people find SEO Skill`,body:`If SEO Skill saved you time, a GitHub star helps other people find it.`,command:`https://github.com/iannuttall/seo`})}async function Es(e){let n=O(e);if(n||y(process.argv[2]===`setup`?`seo setup`:`seo start`),e[`dry-run`]){n?P({dryRun:!0,steps:xs,next:bs}):(b(xs.map((e,t)=>`${t+1}. ${e}`).join(`
|
|
58
|
+
`),`Setup will`),b(bs.join(`
|
|
59
|
+
`),`Then run`),x(`Dry run complete. Nothing was changed.`));return}t();let r=N({json:n}),i=await ms({interactive:r})??await _s({interactive:r}),a=r?await ys():[],o=r?await vs():{status:`skipped`};if(n){P({auth:i,mcp:a,skill:o,next:bs});return}F([[`Sign-in`,Ss(i)],[`MCP server`,ws(a)],[`SEO skill`,Cs(o)]]);let s=a.filter(e=>e.error);s.length&&b(s.map(e=>`${e.client}: ${e.error}`).join(`
|
|
60
|
+
`),`MCP setup skipped`),o.error&&b(o.error,`SEO skill install failed`),b(`seo sites list your Search Console properties
|
|
61
|
+
seo report --site <site> run the main report for one of them`,`Try next`),x(`Setup complete.`),Ts()}const Ds=v({meta:{name:`setup`,description:`Sign in with Google, then add the MCP server and skill`},args:{"dry-run":{type:`boolean`,default:!1,description:`Show what setup does without changing anything.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON. Never prompts.`}},run:async({args:e})=>Es(e)}),Os=v({...Ds,meta:{name:`start`,description:`Start here: sign in with Google, then add the MCP server and skill to your agents`}}),ks=v({...Os,meta:{name:`init`,description:"Legacy alias for `seo start`."}}),As=v({meta:{name:`logs`,description:`Manage local log retention`},subCommands:{prune:v({meta:{name:`prune`,description:`Rotate large logs and remove old local logs`},args:{quiet:{type:`boolean`,default:!1,description:`Do not print a result.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=Yr();O(e)?P(t):e.quiet||process.stdout.write(`Rotated ${t.rotated} and removed ${t.removed} log files. ${Xi(t.sizeBytes)} retained.\n`)}})}}),js=[{client:`claude-desktop`,flag:`claude-desktop`},{client:`claude-code`,flag:`claude-code`},{client:`codex`,flag:`codex`},{client:`cursor`,flag:`cursor`}];function Ms(e,t){return w(e.all)?t:js.filter(({flag:t})=>w(e[t])).map(({client:e})=>e)}const Ns=v({meta:{name:`mcp`,description:`MCP server helpers`},subCommands:{serve:v({meta:{name:`serve`,description:`Run the SEO MCP server`},args:{test:{type:`boolean`,default:!1,description:`Start in test mode`}},run:async({args:e})=>{let{startMcpServer:t}=await import(`./dist-Bv1JGvEz.js`);await t({test:w(e.test)})}}),install:v({meta:{name:`install`,description:`Install or remove SEO MCP config for local clients`},args:{uninstall:{type:`boolean`,default:!1,description:`Remove the SEO MCP config instead of adding it`},reinstall:{type:`boolean`,default:!1,description:`Rewrite an existing managed SEO MCP config`},"claude-desktop":{type:`boolean`,default:!1,description:`Update Claude Desktop`},"claude-code":{type:`boolean`,default:!1,description:`Update Claude Code`},codex:{type:`boolean`,default:!1,description:`Update Codex CLI, app, and IDE extension`},cursor:{type:`boolean`,default:!1,description:`Update Cursor`},all:{type:`boolean`,default:!1,description:`Update every detected MCP client`},json:{type:`boolean`,default:!1,description:`Print structured JSON output`}},run:async({args:e})=>{if(w(e.uninstall)&&w(e.reinstall))throw new m(`INVALID_INPUT`,`Use either --uninstall or --reinstall, not both.`);let t=jo(),n=Po({targets:t}),r=O(e),i=Ms(e,n.map(e=>e.client));if(i.length===0){if(!N({json:r}))throw new m(`INVALID_INPUT`,`Choose an MCP client with --claude-desktop, --claude-code, --codex, --cursor, or --all.`);let a=n.length>0?n:t;i=L(await jr({message:e.uninstall?`Remove seo from which MCP clients?`:`Install seo into which MCP clients?`,options:a.map(e=>({value:e.client,label:e.label,hint:e.path})),initialValues:n.map(e=>e.client),required:!0}))}let a=i.filter(e=>!t.some(t=>t.client===e));if(a.length>0)throw new m(`INVALID_INPUT`,`MCP setup is not supported for ${a.join(`, `)} on ${process.platform}.`);let o=t.filter(e=>i.includes(e.client)).map(t=>w(e.uninstall)?$o(t):Qo(t,{reinstall:w(e.reinstall)}));if(r)P({operation:w(e.uninstall)?`uninstall`:`install`,results:o});else for(let e of o)process.stdout.write(`${e.changed?`updated`:`skipped`} ${e.client} · ${e.path}\n`)}})}}),Ps=v({meta:{name:`index-coverage`,description:`Find crawlable pages that deserve a closer Google index check`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},url:{type:`string`,description:`Start URL to crawl. Defaults to the home page.`},sitemaps:{type:`string`,description:`Comma-separated XML sitemap URLs. Defaults to declarations captured by the crawl.`},days:{type:`string`,description:`Finalized Search Console date range. Defaults to 90 days.`},"row-limit":{type:`string`,description:`Maximum Search Console page rows. Defaults to 100000.`},"max-sitemap-urls":{type:`string`,description:`Maximum sitemap inventory URLs. Defaults to 100000.`},limit:{type:`string`,description:`Maximum URLs returned in each evidence group. Defaults to 100.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local Search Console cache.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=k(C(e.site)),r=ni(e.sitemaps),i=await Zt({site:n,url:C(e.url),sitemaps:r.length?r:void 0,days:T(e.days),rowLimit:T(e[`row-limit`]),maxSitemapUrls:T(e[`max-sitemap-urls`]),itemsPerSection:T(e.limit),refresh:w(e.refresh)});t?P(i):(K({title:`Index coverage`,target:i.site,status:i.sources.crawl.completeness===`complete`&&i.sources.searchConsole.completeness===`complete`?i.summary.crawlableCandidatesWithoutRetainedSearchVisibility>0?`warning`:`pass`:`unknown`,summary:`${i.summary.crawlableCandidatesWithoutRetainedSearchVisibility} crawlable pages need URL Inspection review.`,metrics:[{label:`Crawl report`,value:i.input.crawlReport.id},{label:`Crawl evidence`,value:i.sources.crawl.completeness},{label:`Sitemap evidence`,value:i.sources.sitemap.completeness},{label:`Search evidence`,value:i.sources.searchConsole.completeness},{label:`Search window`,value:`${i.sources.searchConsole.startDate} to ${i.sources.searchConsole.endDate}`},{label:`Search-visible pages`,value:i.summary.retainedSearchVisibleUrls},{label:`Blocked/non-indexable`,value:i.summary.blockedOrNonIndexableCrawlUrls},{label:`Sitemap only`,value:i.summary.sitemapOnlyUrls},{label:`Search Console only`,value:i.summary.searchConsoleOnlyUrls}]}),i.crawlableWithoutRetainedSearchVisibility.items.length&&(process.stdout.write(`
|
|
62
62
|
Representative URL Inspection candidates
|
|
63
|
-
`),I([`URL`,`Status`,`In sitemap`],i.crawlableWithoutRetainedSearchVisibility.items.map(e=>[G(e.url,80),e.status,e.inSitemap?`yes`:`no`]))),Y(`How to read this report`,i.caveats))}}),
|
|
63
|
+
`),I([`URL`,`Status`,`In sitemap`],i.crawlableWithoutRetainedSearchVisibility.items.map(e=>[G(e.url,80),e.status,e.inSitemap?`yes`:`no`]))),Y(`How to read this report`,i.caveats))}}),Fs=v({meta:{name:`link-recover`,description:`Find search-value URLs that are now broken, blocked, or poorly redirected`},args:{site:{type:`string`},...X([`days`,`limit`,`minImpressions`,`refresh`,`js`],{days:{description:`GSC lookback window. Defaults to 90.`},limit:{description:`Maximum GSC pages to check. Defaults to 50.`},minImpressions:{description:`Minimum impressions to check a page. Defaults to 100.`},refresh:{description:`Bypass local GSC and HTTP caches.`},js:{description:`Force JavaScript rendering for final page extraction.`}}),"min-clicks":{type:`string`,description:`Minimum clicks to check a page. Defaults to 1.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=await ne({site:k(C(e.site)),days:T(e.days),limit:T(e.limit),minClicks:T(e[`min-clicks`]),minImpressions:T(e[`min-impressions`]),refresh:w(e.refresh),js:w(e.js)?!0:`auto`});t?P(n):(K({title:`Link recovery`,target:n.site,status:n.warnings.length>0?`unknown`:n.summary.recoverable>0?`warning`:`pass`,summary:n.summary.recoverable>0?`${H(n.summary.recoverable)} previously visible URLs need recovery review.`:`No recoverable URLs were found in the retained evidence.`,metrics:[{label:`Range`,value:`${n.range.startDate} to ${n.range.endDate}`},{label:`Checked`,value:H(n.summary.checked)},{label:`Recoverable`,value:H(n.summary.recoverable)},{label:`High severity`,value:H(n.summary.high)},{label:`Clicks at risk`,value:H(n.summary.clicksAtRisk)},{label:`Impressions at risk`,value:H(n.summary.impressionsAtRisk)}]}),n.items.length&&(q([`Severity`,`Issue`,`Clicks`,`Impr`,`URL`,`Action`],n.items.map(e=>[e.severity,e.issue,H(e.clicks),H(e.impressions),G(e.url,56),G(e.recommendation.action,72)])),J(`Top recovery actions`,n.items.map(e=>({label:G(e.url,96),context:`${e.severity}, ${H(e.clicks)} clicks at risk`,action:e.recommendation.action})))),Y(`Warnings`,n.warnings.slice(0,10)))}}),Is=v({meta:{name:`redirect-trace`,description:`Trace redirects and report final indexability/canonical issues`},args:{url:{type:`string`,required:!0,description:`URL to trace.`},"max-hops":{type:`string`,description:`Maximum redirect hops to follow. Defaults to 10.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache for final page extraction.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for final page extraction.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Ne({url:C(e.url)??``,maxHops:T(e[`max-hops`]),refresh:w(e.refresh),js:w(e.js)?!0:`auto`});O(e)?P(t):(K({title:`Redirect trace`,target:t.url,status:t.summary.issues.length>0?`warning`:t.summary.finalIndexable===void 0?`unknown`:`pass`,summary:t.summary.issues.length>0?t.summary.issues.join(`, `):`${t.summary.hops} redirect hops ended at HTTP ${t.summary.finalStatus}.`,metrics:[{label:`Final URL`,value:t.finalUrl},{label:`Final status`,value:t.summary.finalStatus},{label:`Indexable`,value:t.summary.finalIndexable===void 0?`Unknown`:t.summary.finalIndexable?`Yes`:`No`},{label:`Hops`,value:t.summary.hops}]}),I([`#`,`Status`,`URL`,`Next`],t.chain.map((e,t)=>[t+1,e.status,G(e.url,72),G(e.nextUrl??`-`,72)])),t.finalPage&&(process.stdout.write(`
|
|
64
64
|
Final page
|
|
65
|
-
`),F([[`Title`,t.finalPage.title??`-`],[`Canonical`,t.finalPage.canonical??`-`],[`Meta robots`,t.finalPage.metaRobots??`-`]])),Y(`Warnings`,t.warnings.slice(0,10)))}}),
|
|
65
|
+
`),F([[`Title`,t.finalPage.title??`-`],[`Canonical`,t.finalPage.canonical??`-`],[`Meta robots`,t.finalPage.metaRobots??`-`]])),Y(`Warnings`,t.warnings.slice(0,10)))}}),Ls=v({meta:{name:`ai-referrals`,description:`Find AI referral traffic detected in Google Analytics`},args:{property:{type:`string`,description:"Numeric Google Analytics property ID. Run `seo analytics google properties` to list them."},"start-date":{type:`string`,default:`28daysAgo`},"end-date":{type:`string`,default:`yesterday`},"max-rows":{type:`string`,description:`Maximum Google Analytics rows per query. Defaults to 100000.`},"result-limit":{type:`string`,description:`Maximum ranked landing pages returned. Defaults to 25.`},limit:{type:`string`,description:`Legacy alias for --max-rows.`},refresh:{type:`boolean`,default:!1,description:`Bypass cached Google Analytics responses.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=oi(C(e.property)),r=await rn({property:n,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),maxRows:E(e[`max-rows`],`--max-rows`),resultLimit:E(e[`result-limit`],`--result-limit`),limit:E(e.limit,`--limit`),refresh:e.refresh===!0});if(t)P(r);else{if(K({title:`AI referral report`,target:r.property,status:r.dataStatus===`complete`?`info`:`unknown`,summary:r.summary.verdict,metrics:[{label:`Evidence`,value:r.dataStatus===`complete`?`Complete`:`Partial`,status:r.dataStatus===`complete`?`pass`:`unknown`},{label:`AI sessions`,value:H(r.summary.sessions)},{label:`AI users`,value:r.summary.totalUsers===null?`Unavailable`:H(r.summary.totalUsers)},{label:`Sources`,value:H(r.summary.sources)},{label:`Landing pages`,value:H(r.summary.landingPages)},{label:`Landing-page output`,value:`${H(r.selection.landingPages.returnedRows)} returned / ${H(r.selection.landingPages.retainedRows)} retained`},{label:`Source rows`,value:H(r.dataSource.sourceDiscovery.returnedRows)}]}),r.sources.length&&(process.stdout.write(`
|
|
66
66
|
AI sources
|
|
67
|
-
`),q([`Source`,`Sessions`,`Events`,`Share of AI sessions`],r.sources.map(e=>[e.label,
|
|
67
|
+
`),q([`Source`,`Sessions`,`Events`,`Share of AI sessions`],r.sources.map(e=>[e.label,H(e.sessions),H(e.eventCount),W(e.shareOfAiSessions)]))),r.landingPages.length&&(process.stdout.write(`
|
|
68
68
|
Landing pages
|
|
69
|
-
`),q([`Landing page`,`Sessions`,`Events`,`Top source`],r.landingPages.map(e=>[G(e.landingPage,64),
|
|
69
|
+
`),q([`Landing page`,`Sessions`,`Events`,`Top source`],r.landingPages.map(e=>[G(e.landingPage,64),H(e.sessions),H(e.eventCount),e.topSourceDetails.label]))),r.dataSource.partialReasons.length){process.stdout.write(`
|
|
70
70
|
Evidence warnings
|
|
71
|
-
`);for(let e of r.dataSource.partialReasons)process.stdout.write(`- ${e}\n`)}process.stdout.write(`\nNote: ${r.summary.caveat}\n`)}}}),Ls=y({meta:{name:`cannibal`,description:`Find queries with material exposure across multiple URLs`},args:{site:{type:`string`},...X([`days`,`limit`,`includeBrand`,`minImpressions`,`refresh`],{minImpressions:{description:`Minimum query impressions. Defaults to 50.`}}),"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=w(e.refresh),r=k(C(e.site)),i=await me({site:r,days:E(e.days,`--days`),limit:E(e.limit,`--limit`),minImpressions:E(e[`min-impressions`],`--min-impressions`),brandTerms:[...D(e[`brand-terms`])??[]],includeBrand:w(e[`include-brand`]),refresh:n});t?P(i):(K({title:`Cannibalisation report`,target:i.site,status:i.dataStatus===`complete`?`info`:`unknown`,summary:i.summary.verdict,metrics:[{label:`Evidence`,value:i.dataStatus},{label:`Range`,value:`${i.range.startDate} to ${i.range.endDate}`},{label:`Eligible`,value:U(i.summary.eligibleClusters)},{label:`Returned`,value:U(i.summary.returnedClusters)},{label:`Suppressed brand queries`,value:U(i.summary.suppressedQueries)},{label:`GSC completeness`,value:i.source.completeness},{label:`Brand queries`,value:w(e[`include-brand`])?`included`:`excluded`}]}),q([`Query`,`URLs`,`Property impr`,`Exposure`,`HHI`,`Review first`],i.items.map(e=>[G(e.query,42),e.pages.length,e.propertyImpressions===void 0?`n/a`:U(e.propertyImpressions),U(e.pageExposureImpressions),e.hhi.toFixed(2),G(e.suggestedOwnerUrl,56)])),J(`Top cannibalisation actions`,i.items.map(e=>({label:e.query,context:`${e.pages.length} material URLs; first review ${G(e.suggestedOwnerUrl,64)}`,action:e.recommendation.action}))),Y(`Report caveats`,i.caveats),Y(`Provider usage`,[i.ledgerSummary]))}}),Rs=y({meta:{name:`ctr-underperformers`,description:`Find high-impression queries with weak CTR for their position`},args:{site:{type:`string`},...X([`includeBrand`,`minImpressions`],{minImpressions:{description:`Minimum query impressions. Defaults to 1 per 5,000 retained impressions, from 30 to 200.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=k(C(e.site)),r=await Wn({site:n,minImpressions:T(e[`min-impressions`]),includeBrand:w(e[`include-brand`])});t?P(r):(K({title:`CTR underperformers`,target:r.site,status:r.dataStatus===`partial`?`unknown`:`info`,summary:r.summary.verdict,metrics:[{label:`Underperformers`,value:U(r.summary.underperformers)},{label:`Estimated click gap`,value:U(r.summary.estimatedClickShortfall)},{label:`Brand queries`,value:r.summary.brandFiltering},{label:`Evidence`,value:r.dataStatus},{label:`GSC completeness`,value:r.source.completeness}]}),Y(`Why this matters`,[`These queries already have visibility; the fastest win is usually better SERP framing, not new content.`,`Start with high-impression rows where actual CTR is far below the expected CTR for that ranking position.`]),Y(`Recommended actions`,r.recommendations),Y(`Report caveats`,r.caveats),q([`Query`,`URL`,`Pos`,`Impr`,`CTR`,`Expected`,`Gap`,`Action`],r.items.map(e=>[G(e.query,36),G(e.url,48),ja(e.position),U(e.impressions),W(e.actualCtr),W(e.expectedCtr),U(e.clickShortfall),G(e.recommendation.action,72)])),J(`Top CTR actions`,r.items.map(e=>({label:e.query,context:`${U(e.clickShortfall)} click gap, ${W(e.actualCtr)} CTR`,action:e.recommendation.action}))))}});function zs(e){return e>0?ja(e):`n/a`}const Bs=y({meta:{name:`decaying`,description:`Find query/page rows losing clicks between two GSC windows`},args:{site:{type:`string`},...X([`days`,`limit`,`includeBrand`,`refresh`]),comparison:{type:`string`,description:`Comparison: previous-period or year-over-year.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},"min-drop-pct":{type:`string`,description:`Minimum click drop percentage. Defaults to 20.`},"min-previous-clicks":{type:`string`,description:`Minimum previous-window clicks for a query/page row. Defaults to 2.`},"min-click-loss":{type:`string`,description:`Minimum absolute click loss. Defaults to 1.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=w(e.refresh),r=C(e.comparison),i=E(e.days,`--days`),a=E(e.limit,`--limit`),o=E(e[`min-drop-pct`],`--min-drop-pct`),s=E(e[`min-previous-clicks`],`--min-previous-clicks`),c=E(e[`min-click-loss`],`--min-click-loss`);if(r!==void 0&&r!==`previous-period`&&r!==`year-over-year`)throw new h(`INVALID_INPUT`,`--comparison must be previous-period or year-over-year.`);let l=k(C(e.site)),u=await ae({site:l,days:i,limit:a,comparison:r,brandTerms:[...D(e[`brand-terms`])??[]],includeBrand:w(e[`include-brand`]),minDropPct:o,minPreviousClicks:s,minClickLoss:c,refresh:n});t?P(u):(K({title:`Decaying pages`,target:u.site,status:u.dataStatus===`complete`?u.summary.returnedRows>0?`warning`:`pass`:`unknown`,summary:u.summary.verdict,metrics:[{label:`Evidence`,value:u.dataStatus},{label:`Comparison`,value:u.comparison},{label:`Observed declines`,value:U(u.summary.returnedRows)},{label:`Eligible declines`,value:U(u.summary.eligibleRows)},{label:`Decay clusters`,value:U(u.summary.groups)},{label:`Observed click decline`,value:U(u.summary.returnedObservedRetainedQueryClickLoss)},{label:`Eligible click decline`,value:U(u.summary.observedRetainedQueryClickLoss)},{label:`Brand queries`,value:u.summary.brandFiltering},{label:`Minimum drop`,value:`${u.filters.minDropPct}%`},{label:`Minimum previous clicks`,value:U(u.filters.minPreviousClicks)},{label:`GSC completeness`,value:u.source.completeness}]}),Y(`Why this matters`,[`This report compares retained query/page rows and only counts declines observed in both windows.`,`Position, CTR, and impression movements are signals for investigation, not proof of cause.`]),Y(`Recommended actions`,u.recommendations),Y(`Report caveats`,u.caveats),Y(`Warnings`,u.warnings),u.items.length&&(u.groups.length&&(q([`Cluster`,`Rows`,`Observed loss`,`Drop`,`Sample query`,`Action`],u.groups.map(e=>[G(e.label,42),U(e.count),U(e.totalClickLoss),`${e.averageDropPct.toFixed(1)}%`,G(e.sampleQueries[0]??`-`,40),G(e.recommendation,72)])),J(`Top decay cluster actions`,u.groups.map(e=>({label:e.label,context:`${U(e.count)} retained rows, ${U(e.totalClickLoss)} observed click decline`,action:e.recommendation})))),q([`Query`,`Template`,`URL`,`Signals`,`Decline`,`Clicks`,`Impr`,`CTR`,`Pos`,`Action`],u.items.map(e=>[G(e.query,32),G(e.template.label,26),G(e.url,44),e.signals.join(`, `),U(e.clickLoss),`${U(e.previous.clicks)} -> ${U(e.current.clicks)}`,`${U(e.previous.impressions)} -> ${U(e.current.impressions)}`,`${W(e.previous.ctr)} -> ${W(e.current.ctr)}`,`${zs(e.previous.position)} -> ${zs(e.current.position)}`,G(e.recommendation.action,64)])),J(`Top decay actions`,u.items.map(e=>({label:e.query,context:`${e.template.label}, ${U(e.clickLoss)} fewer observed clicks`,action:e.recommendation.action})))))}});function Vs(e){if(!e)return;let t=Date.now();return e=>{let n=((Date.now()-t)/1e3).toFixed(1);process.stderr.write(`[seo ${n}s] ${e}\n`)}}const Hs=y({meta:{name:`internal-links`,description:`Internal links to add across a site (--site) or to one page (--url), placed in real sentences`},args:{site:{type:`string`,description:`Site to audit: a domain, URL or Search Console property.`},url:{type:`string`,description:`One page to find internal links to.`},"max-pages":{type:`string`,description:`Site audits only: pages to crawl, 500 by default, up to 5,000.`},...Qi,...B,refresh:{type:`boolean`,default:!1,description:`Bypass the local cache and fetch fresh data.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=w(e.refresh),r=C(e.url),i=C(e.site);if(!!r==!!i)throw new h(`INVALID_INPUT`,`Send --site to audit a whole site, or --url to find links to one page.`);let a=C(e[`max-pages`]),o=a===void 0?void 0:T(a);if(a!==void 0&&o===void 0)throw new h(`INVALID_INPUT`,`--max-pages is a whole number.`);let s=r??i,c=await Yt({site:s,targetUrl:r,maxPages:o,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),refresh:n},{...await f({site:s,refresh:n}),progress:Vs(!t&&process.stderr.isTTY)});if(t){P(c);return}let l={...r?{url:r}:{site:i},...o===void 0?{}:{"max-pages":o}};process.stdout.write(`${Ut(c,{detail:V(e),offset:T(e.offset)??0,more:(e,t)=>Xi(`internal-links`,{...l,detail:e,offset:t})})}\n`)}}),Us=y({meta:{name:`page-opportunities`,description:`Find first-party traffic growth opportunities for one URL`},args:{site:{type:`string`},url:{type:`string`,required:!0},...X([`days`,`limit`,`minImpressions`,`includeBrand`,`js`,`refresh`],{limit:{description:`Maximum page queries to inspect. Defaults to 25.`},minImpressions:{description:`Minimum query impressions. Defaults to 10.`},includeBrand:{description:`Include branded queries in page opportunity reports.`},js:{description:`Force JavaScript rendering for page extraction.`},refresh:{description:`Bypass local GSC and HTTP cache.`}}),"verify-content":Xr(`Fetch the page for title/H1/body checks. Defaults to true.`,`Skip fetching the page for title/H1/body checks.`),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=k(C(e.site)),r=await St({site:n,url:C(e.url)??``,days:T(e.days),limit:T(e.limit),minImpressions:T(e[`min-impressions`]),includeBrand:w(e[`include-brand`]),verifyContent:w(e[`verify-content`])!==!1,js:w(e.js)?!0:`auto`,refresh:w(e.refresh)});t?P(r):(K({title:`Page opportunities`,target:r.url,status:r.verification.status===`failed`?`unknown`:`info`,summary:r.summary.verdict,metrics:[{label:`Title`,value:r.page?.title??`Not fetched`},{label:`Fetch`,value:$a(r.page?.fetchDiagnostics)},{label:`Verification`,value:r.verification.status},{label:`Rows`,value:`${U(r.selection.returnedRows)} returned / ${U(r.selection.eligibleRows)} eligible / ${U(r.selection.sourceRows)} source`},{label:`Queries`,value:U(r.summary.queries)},{label:`Impressions`,value:U(r.summary.impressions)},{label:`Opportunities`,value:U(r.summary.opportunities)},{label:`CTR shortfall`,value:U(r.summary.estimatedCtrClickShortfall)},{label:`Focus`,value:r.summary.focus},{label:`Evidence`,value:r.dataStatus}]}),Y(`Why this matters`,[`This report starts from queries where this exact URL already has impressions, so recommendations stay tied to first-party demand.`,`Content verification separates body gaps from title/meta framing issues, which helps avoid adding copy when the page already covers the query.`]),Y(`Recommended actions`,r.recommendations),Y(`Report caveats`,r.caveats),r.items.length?(q([`Type`,`Query`,`Evidence`,`Pos`,`CTR`,`Expected`,`Impr`,`Shortfall`,`Action`],r.items.map(e=>[e.opportunityType,G(e.query,38),e.verification.signals.length?e.verification.signals.join(`, `):e.verification.status,e.position.toFixed(1),W(e.ctr),e.expectedCtr===void 0?`n/a`:W(e.expectedCtr),U(e.impressions),e.estimatedCtrClickShortfall===void 0?`n/a`:U(e.estimatedCtrClickShortfall),G(e.recommendation,72)])),J(`Top page actions`,r.items.map(e=>({label:e.query,context:`${e.opportunityType}, ${U(e.impressions)} impressions`,action:e.recommendation})))):process.stdout.write(r.dataStatus===`empty`?`No GSC query rows found for this exact URL.
|
|
71
|
+
`);for(let e of r.dataSource.partialReasons)process.stdout.write(`- ${e}\n`)}process.stdout.write(`\nNote: ${r.summary.caveat}\n`)}}}),Rs=v({meta:{name:`cannibal`,description:`Find queries with material exposure across multiple URLs`},args:{site:{type:`string`},...X([`days`,`limit`,`includeBrand`,`minImpressions`,`refresh`],{minImpressions:{description:`Minimum query impressions. Defaults to 50.`}}),"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=w(e.refresh),r=k(C(e.site)),i=await we({site:r,days:E(e.days,`--days`),limit:E(e.limit,`--limit`),minImpressions:E(e[`min-impressions`],`--min-impressions`),brandTerms:[...D(e[`brand-terms`])??[]],includeBrand:w(e[`include-brand`]),refresh:n});t?P(i):(K({title:`Cannibalisation report`,target:i.site,status:i.dataStatus===`complete`?`info`:`unknown`,summary:i.summary.verdict,metrics:[{label:`Evidence`,value:i.dataStatus},{label:`Range`,value:`${i.range.startDate} to ${i.range.endDate}`},{label:`Eligible`,value:H(i.summary.eligibleClusters)},{label:`Returned`,value:H(i.summary.returnedClusters)},{label:`Suppressed brand queries`,value:H(i.summary.suppressedQueries)},{label:`GSC completeness`,value:i.source.completeness},{label:`Brand queries`,value:w(e[`include-brand`])?`included`:`excluded`}]}),q([`Query`,`URLs`,`Property impr`,`Exposure`,`HHI`,`Review first`],i.items.map(e=>[G(e.query,42),e.pages.length,e.propertyImpressions===void 0?`n/a`:H(e.propertyImpressions),H(e.pageExposureImpressions),e.hhi.toFixed(2),G(e.suggestedOwnerUrl,56)])),J(`Top cannibalisation actions`,i.items.map(e=>({label:e.query,context:`${e.pages.length} material URLs; first review ${G(e.suggestedOwnerUrl,64)}`,action:e.recommendation.action}))),Y(`Report caveats`,i.caveats),Y(`Provider usage`,[i.ledgerSummary]))}}),zs=v({meta:{name:`ctr-underperformers`,description:`Find high-impression queries with weak CTR for their position`},args:{site:{type:`string`},...X([`includeBrand`,`minImpressions`],{minImpressions:{description:`Minimum query impressions. Defaults to 1 per 5,000 retained impressions, from 30 to 200.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=k(C(e.site)),r=await c({site:n,minImpressions:T(e[`min-impressions`]),includeBrand:w(e[`include-brand`])});t?P(r):(K({title:`CTR underperformers`,target:r.site,status:r.dataStatus===`partial`?`unknown`:`info`,summary:r.summary.verdict,metrics:[{label:`Underperformers`,value:H(r.summary.underperformers)},{label:`Estimated click gap`,value:H(r.summary.estimatedClickShortfall)},{label:`Brand queries`,value:r.summary.brandFiltering},{label:`Evidence`,value:r.dataStatus},{label:`GSC completeness`,value:r.source.completeness}]}),Y(`Why this matters`,[`These queries already have visibility; the fastest win is usually better SERP framing, not new content.`,`Start with high-impression rows where actual CTR is far below the expected CTR for that ranking position.`]),Y(`Recommended actions`,r.recommendations),Y(`Report caveats`,r.caveats),q([`Query`,`URL`,`Pos`,`Impr`,`CTR`,`Expected`,`Gap`,`Action`],r.items.map(e=>[G(e.query,36),G(e.url,48),U(e.position),H(e.impressions),W(e.actualCtr),W(e.expectedCtr),H(e.clickShortfall),G(e.recommendation.action,72)])),J(`Top CTR actions`,r.items.map(e=>({label:e.query,context:`${H(e.clickShortfall)} click gap, ${W(e.actualCtr)} CTR`,action:e.recommendation.action}))))}});function Bs(e){return e>0?U(e):`n/a`}const Vs=v({meta:{name:`decaying`,description:`Find query/page rows losing clicks between two GSC windows`},args:{site:{type:`string`},...X([`days`,`limit`,`includeBrand`,`refresh`]),comparison:{type:`string`,description:`Comparison: previous-period or year-over-year.`},"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},"min-drop-pct":{type:`string`,description:`Minimum click drop percentage. Defaults to 20.`},"min-previous-clicks":{type:`string`,description:`Minimum previous-window clicks for a query/page row. Defaults to 2.`},"min-click-loss":{type:`string`,description:`Minimum absolute click loss. Defaults to 1.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=w(e.refresh),r=C(e.comparison),i=E(e.days,`--days`),a=E(e.limit,`--limit`),o=E(e[`min-drop-pct`],`--min-drop-pct`),s=E(e[`min-previous-clicks`],`--min-previous-clicks`),c=E(e[`min-click-loss`],`--min-click-loss`);if(r!==void 0&&r!==`previous-period`&&r!==`year-over-year`)throw new m(`INVALID_INPUT`,`--comparison must be previous-period or year-over-year.`);let l=k(C(e.site)),u=await he({site:l,days:i,limit:a,comparison:r,brandTerms:[...D(e[`brand-terms`])??[]],includeBrand:w(e[`include-brand`]),minDropPct:o,minPreviousClicks:s,minClickLoss:c,refresh:n});t?P(u):(K({title:`Decaying pages`,target:u.site,status:u.dataStatus===`complete`?u.summary.returnedRows>0?`warning`:`pass`:`unknown`,summary:u.summary.verdict,metrics:[{label:`Evidence`,value:u.dataStatus},{label:`Comparison`,value:u.comparison},{label:`Observed declines`,value:H(u.summary.returnedRows)},{label:`Eligible declines`,value:H(u.summary.eligibleRows)},{label:`Decay clusters`,value:H(u.summary.groups)},{label:`Observed click decline`,value:H(u.summary.returnedObservedRetainedQueryClickLoss)},{label:`Eligible click decline`,value:H(u.summary.observedRetainedQueryClickLoss)},{label:`Brand queries`,value:u.summary.brandFiltering},{label:`Minimum drop`,value:`${u.filters.minDropPct}%`},{label:`Minimum previous clicks`,value:H(u.filters.minPreviousClicks)},{label:`GSC completeness`,value:u.source.completeness}]}),Y(`Why this matters`,[`This report compares retained query/page rows and only counts declines observed in both windows.`,`Position, CTR, and impression movements are signals for investigation, not proof of cause.`]),Y(`Recommended actions`,u.recommendations),Y(`Report caveats`,u.caveats),Y(`Warnings`,u.warnings),u.items.length&&(u.groups.length&&(q([`Cluster`,`Rows`,`Observed loss`,`Drop`,`Sample query`,`Action`],u.groups.map(e=>[G(e.label,42),H(e.count),H(e.totalClickLoss),`${e.averageDropPct.toFixed(1)}%`,G(e.sampleQueries[0]??`-`,40),G(e.recommendation,72)])),J(`Top decay cluster actions`,u.groups.map(e=>({label:e.label,context:`${H(e.count)} retained rows, ${H(e.totalClickLoss)} observed click decline`,action:e.recommendation})))),q([`Query`,`Template`,`URL`,`Signals`,`Decline`,`Clicks`,`Impr`,`CTR`,`Pos`,`Action`],u.items.map(e=>[G(e.query,32),G(e.template.label,26),G(e.url,44),e.signals.join(`, `),H(e.clickLoss),`${H(e.previous.clicks)} -> ${H(e.current.clicks)}`,`${H(e.previous.impressions)} -> ${H(e.current.impressions)}`,`${W(e.previous.ctr)} -> ${W(e.current.ctr)}`,`${Bs(e.previous.position)} -> ${Bs(e.current.position)}`,G(e.recommendation.action,64)])),J(`Top decay actions`,u.items.map(e=>({label:e.query,context:`${e.template.label}, ${H(e.clickLoss)} fewer observed clicks`,action:e.recommendation.action})))))}});function Hs(e){if(!e)return;let t=Date.now();return e=>{let n=((Date.now()-t)/1e3).toFixed(1);process.stderr.write(`[seo ${n}s] ${e}\n`)}}const Us=v({meta:{name:`internal-links`,description:`Internal links to add across a site (--site) or to one page (--url), placed in real sentences`},args:{site:{type:`string`,description:`Site to audit: a domain, URL or Search Console property.`},url:{type:`string`,description:`One page to find internal links to.`},"max-pages":{type:`string`,description:`Site audits only: pages to crawl, 500 by default, up to 5,000.`},...ea,...z,refresh:{type:`boolean`,default:!1,description:`Bypass the local cache and fetch fresh data.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=w(e.refresh),r=C(e.url),i=C(e.site);if(!!r==!!i)throw new m(`INVALID_INPUT`,`Send --site to audit a whole site, or --url to find links to one page.`);let o=C(e[`max-pages`]),s=o===void 0?void 0:T(o);if(o!==void 0&&s===void 0)throw new m(`INVALID_INPUT`,`--max-pages is a whole number.`);let c=r??i,l=await a({site:c,targetUrl:r,maxPages:s,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),refresh:n},{...await ee({site:c,refresh:n}),progress:Hs(!t&&process.stderr.isTTY)});if(t){P(l);return}let u={...r?{url:r}:{site:i},...s===void 0?{}:{"max-pages":s}};process.stdout.write(`${yt(l,{detail:B(e),offset:T(e.offset)??0,more:(e,t)=>$i(`internal-links`,{...u,detail:e,offset:t})})}\n`)}}),Ws=v({meta:{name:`page-opportunities`,description:`Find first-party traffic growth opportunities for one URL`},args:{site:{type:`string`},url:{type:`string`,required:!0},...X([`days`,`limit`,`minImpressions`,`includeBrand`,`js`,`refresh`],{limit:{description:`Maximum page queries to inspect. Defaults to 25.`},minImpressions:{description:`Minimum query impressions. Defaults to 10.`},includeBrand:{description:`Include branded queries in page opportunity reports.`},js:{description:`Force JavaScript rendering for page extraction.`},refresh:{description:`Bypass local GSC and HTTP cache.`}}),"verify-content":Zr(`Fetch the page for title/H1/body checks. Defaults to true.`,`Skip fetching the page for title/H1/body checks.`),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=k(C(e.site)),r=await $t({site:n,url:C(e.url)??``,days:T(e.days),limit:T(e.limit),minImpressions:T(e[`min-impressions`]),includeBrand:w(e[`include-brand`]),verifyContent:w(e[`verify-content`])!==!1,js:w(e.js)?!0:`auto`,refresh:w(e.refresh)});t?P(r):(K({title:`Page opportunities`,target:r.url,status:r.verification.status===`failed`?`unknown`:`info`,summary:r.summary.verdict,metrics:[{label:`Title`,value:r.page?.title??`Not fetched`},{label:`Fetch`,value:eo(r.page?.fetchDiagnostics)},{label:`Verification`,value:r.verification.status},{label:`Rows`,value:`${H(r.selection.returnedRows)} returned / ${H(r.selection.eligibleRows)} eligible / ${H(r.selection.sourceRows)} source`},{label:`Queries`,value:H(r.summary.queries)},{label:`Impressions`,value:H(r.summary.impressions)},{label:`Opportunities`,value:H(r.summary.opportunities)},{label:`CTR shortfall`,value:H(r.summary.estimatedCtrClickShortfall)},{label:`Focus`,value:r.summary.focus},{label:`Evidence`,value:r.dataStatus}]}),Y(`Why this matters`,[`This report starts from queries where this exact URL already has impressions, so recommendations stay tied to first-party demand.`,`Content verification separates body gaps from title/meta framing issues, which helps avoid adding copy when the page already covers the query.`]),Y(`Recommended actions`,r.recommendations),Y(`Report caveats`,r.caveats),r.items.length?(q([`Type`,`Query`,`Evidence`,`Pos`,`CTR`,`Expected`,`Impr`,`Shortfall`,`Action`],r.items.map(e=>[e.opportunityType,G(e.query,38),e.verification.signals.length?e.verification.signals.join(`, `):e.verification.status,e.position.toFixed(1),W(e.ctr),e.expectedCtr===void 0?`n/a`:W(e.expectedCtr),H(e.impressions),e.estimatedCtrClickShortfall===void 0?`n/a`:H(e.estimatedCtrClickShortfall),G(e.recommendation,72)])),J(`Top page actions`,r.items.map(e=>({label:e.query,context:`${e.opportunityType}, ${H(e.impressions)} impressions`,action:e.recommendation})))):process.stdout.write(r.dataStatus===`empty`?`No GSC query rows found for this exact URL.
|
|
72
72
|
`:`GSC rows were found, but none met the report criteria.
|
|
73
|
-
`))}}),
|
|
74
|
-
`),process.stdout.write(`${a.ledgerSummary}\n`)))}}),
|
|
75
|
-
`),
|
|
73
|
+
`))}}),Gs=v({meta:{name:`query-cluster`,description:`Cluster GSC queries into repeated demand themes`},args:{site:{type:`string`},scope:{type:`string`},...X([`includeBrand`,`minImpressions`,`limit`],{includeBrand:{description:`Include branded queries in query clustering.`},minImpressions:{description:`Minimum impressions per query. Defaults to 25.`},limit:{description:`Maximum clusters to return. Defaults to 25; max 100.`}}),json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=k(C(e.site)),r=await Je({site:n,scope:C(e.scope),includeBrand:w(e[`include-brand`]),minImpressions:T(e[`min-impressions`]),limit:T(e.limit)});t?P(r):(K({title:`Query clusters`,target:r.site,status:`info`,summary:r.summary.verdict,metrics:[{label:`Scope`,value:r.scope??`All pages`},{label:`Clusters`,value:H(r.summary.clusters)},{label:`Queries`,value:H(r.summary.queries)},{label:`Impressions`,value:H(r.summary.impressions)},{label:`Clicks`,value:H(r.summary.clicks)},{label:`Minimum impressions`,value:H(r.summary.minImpressions)},{label:`Result limit`,value:H(r.summary.limit)},{label:`High opportunity`,value:H(r.summary.highOpportunityClusters)},{label:`Brand queries`,value:r.summary.brandFiltering}]}),Y(`Why this matters`,[`Clusters show repeated demand themes, so they are better inputs for page sections, hubs, and templates than one-off query exports.`,`Prioritise clusters with high impressions and low clicks; they usually reveal unclear intent coverage or weak SERP framing.`]),Y(`Recommended actions`,r.recommendations),Y(`Report caveats`,r.caveats),q([`Cluster`,`Intent`,`Queries`,`Impr`,`CTR`,`Expected`,`Lift`,`Action`],r.clusters.map(e=>[G(e.label,32),e.intent,e.queries.length,H(e.totals?.impressions??0),W(e.totals?.ctr??0),W(e.benchmark?.expectedCtr??0),e.estimatedClickLift===void 0?`-`:H(e.estimatedClickLift),G(e.recommendation??``,72)])),J(`Top cluster actions`,r.clusters.map(e=>({label:e.label,context:`${H(e.totals?.impressions??0)} impressions, ${e.estimatedClickLift===void 0?`ranking opportunity`:`${H(e.estimatedClickLift)} estimated click lift`}`,action:e.recommendation??``}))))}}),Ks=v({meta:{name:`quick-wins`,description:`Find high-ranking low-CTR query/page opportunities`},args:{site:{type:`string`},...X([`days`,`limit`,`includeBrand`,`minImpressions`,`verifyContent`,`verifyLimit`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),"brand-terms":{type:`string`,description:`Comma-separated brand terms to exclude.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=T(e[`verify-limit`]),r=w(e[`verify-content`])===!0||n!==void 0,i=k(C(e.site)),a=await oe({site:i,days:T(e.days),limit:T(e.limit),minImpressions:T(e[`min-impressions`]),brandTerms:[...D(e[`brand-terms`])??[]],includeBrand:w(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:w(e.js)?!0:void 0,rate:ri(e),refresh:w(e.refresh)});t?P(a):(K({title:`Quick wins`,target:a.site,status:a.source.possiblyTruncated?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible rows`,value:H(a.summary.eligibleRows)},{label:`Returned rows`,value:H(a.summary.returnedRows)},{label:`Query clusters`,value:H(a.summary.repeatedQueryGroups)},{label:`Template patterns`,value:H(a.summary.templatePatterns)},{label:`CTR click shortfall`,value:H(a.summary.returnedEstimatedCtrClickShortfall)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Evidence`,value:a.dataStatus},{label:`Verification`,value:Na(a)}]}),Y(`Why this matters`,[`These rows have GSC average positions from 4 to 10 and observed CTR below a site-peer or versioned fallback target.`,`Page evidence is needed before treating a CTR shortfall as a title, content, or technical finding.`]),Y(`Recommended actions`,a.recommendations),Y(`Report caveats`,a.caveats),a.items.length&&(a.templateRecommendations.length&&(q([`Template`,`URLs`,`Rows`,`Shortfall`,`Impr`,`Action`],a.templateRecommendations.map(e=>[G(e.templateLabel,34),H(e.urlCount),H(e.rowCount),H(e.totalEstimatedCtrClickShortfall),H(e.totalImpressions),G(e.action,72)])),J(`Top template actions`,a.templateRecommendations.map(e=>({label:e.templateLabel,context:`${H(e.urlCount)} URLs, ${H(e.totalEstimatedCtrClickShortfall)} heuristic CTR click shortfall`,action:`${e.action} ${e.evidence}`})))),a.groups.length&&(q([`Cluster`,`URLs`,`Rows`,`Shortfall`,`Impr`,`Sample URL`,`Action`],a.groups.map(e=>[G(e.label,44),H(e.urlCount),H(e.rowCount),H(e.totalEstimatedCtrClickShortfall),H(e.totalImpressions),G(e.sampleUrls[0]??`-`,46),G(e.recommendation,72)])),J(`Top cluster actions`,a.groups.map(e=>({label:e.label,context:`${H(e.urlCount)} URLs, ${H(e.totalEstimatedCtrClickShortfall)} heuristic CTR click shortfall`,action:e.recommendation})))),q([`Query`,`Template`,`URL`,`Pos`,`Impr`,`CTR / target`,`Shortfall`,`Fetch`,`Check`,`Action`],a.items.map(e=>[G(e.query,36),G(e.template.label,24),G(e.url,48),U(e.position),H(e.impressions),`${W(e.ctr)} / ${W(e.targetCtr)}`,H(e.estimatedCtrClickShortfall),eo(e.contentVerification?.fetchDiagnostics),to(e.contentVerification?.classification),G(e.recommendation.action,64)])),J(`Top opportunity actions`,a.items.map(e=>({label:e.query,context:`${e.template.label}, pos ${U(e.position)}, ${H(e.impressions)} impressions`,action:e.recommendation.action})))))}}),qs=v({meta:{name:`second-page`,description:`Find URLs averaging positions above 10 through 20 in GSC`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`range`,`minImpressions`,`limit`,`includeBrand`,`verifyContent`,`verifyLimit`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=T(e[`verify-limit`]),r=w(e[`verify-content`])===!0||n!==void 0,i=k(C(e.site)),a=await Ln({site:i,range:T(e.days),minImpressions:T(e[`min-impressions`]),limit:C(e.limit)?Number(C(e.limit)):10,includeBrand:w(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:w(e.js)?!0:void 0,rate:ri(e),refresh:w(e.refresh)});t?P(a):(K({title:`Second-page opportunities`,target:a.site,status:a.source.possiblyTruncated||a.summary.fetchFailures>0?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible pages`,value:H(a.summary.eligiblePages)},{label:`Returned pages`,value:H(a.summary.returnedPages)},{label:`Eligible queries`,value:H(a.summary.eligibleQueries)},{label:`Impressions`,value:H(a.summary.eligibleImpressions)},{label:`Content issues`,value:H(a.summary.contentIssues)},{label:`Technical issues`,value:H(a.summary.technicalIssues)},{label:`Fetch failures`,value:H(a.summary.fetchFailures)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Evidence`,value:a.dataStatus},{label:`Verification`,value:Na(a)}]}),Y(`Recommended actions`,a.recommendations),Y(`Report caveats`,a.caveats),a.items.length?(q([`Query`,`Template`,`Pos`,`Impr`,`CTR`,`Queries`,`Fetch`,`Check`,`Action`],a.items.map(e=>[e.primaryQuery,e.template.label,e.position.toFixed(1),Math.round(e.impressions),e.ctr.toFixed(3),H(e.queryCount),eo(e.fetchDiagnostics),to(e.contentVerification?.classification),e.recommendation.action])),J(`Top second-page actions`,a.items.map(e=>({label:e.primaryQuery,context:`${e.template.label}, pos ${U(e.position)}, ${H(e.impressions)} impressions`,action:e.recommendation.action}))),process.stdout.write(`${a.ledgerSummary}\n`)):(process.stdout.write(`No average-position candidates matched this report.
|
|
74
|
+
`),process.stdout.write(`${a.ledgerSummary}\n`)))}}),Js=v({meta:{name:`audit-page`,description:`Fetch one page and audit title, metadata, content, links, and schema`},args:{url:{type:`string`,required:!0,description:`URL to audit.`},site:{type:`string`,description:`Optional GSC property for page search metrics, for example sc-domain:example.com.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering for extraction.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache.`}},run:async({args:e})=>{let t=await kn({url:C(e.url)??``,site:C(e.site),js:w(e.js)?!0:`auto`,refresh:w(e.refresh)});O(e)?P(t):K({title:`Page audit`,target:t.url,status:t.issues.some(e=>e.severity===`high`)?`fail`:t.issues.length>0?`warning`:`pass`,summary:t.issues.length>0?`${t.issues.length} ${t.issues.length===1?`issue needs`:`issues need`} review.`:`No page issues were found by the available checks.`,metrics:[{label:`Final URL`,value:t.page.finalUrl},{label:`Title`,value:t.page.title??`Missing`},{label:`Meta description`,value:t.page.metaDescription??`Missing`},{label:`Words`,value:t.page.wordCount},{label:`Fetch`,value:eo(t.fetchDiagnostics)}],diagnostics:[{title:`Issues`,items:t.issues.map(e=>({status:e.severity===`high`?`fail`:`warning`,title:`${e.code}: ${e.principle}`,explanation:e.detail}))}]})}});function Ys(e){let t=C(e)??`mobile`;if(t!==`mobile`&&t!==`desktop`)throw new m(`INVALID_INPUT`,`Invalid --strategy. Use mobile or desktop.`);return t}function Xs(e){return e?e.displayValue??String(e.value??`not measured`):`not measured`}function Zs(e){if(!e)return`not available`;let t=e.unit===`milliseconds`?`ms`:``;return`${e.p75}${t} (${e.rating})`}const Qs=v({meta:{name:`perf`,description:`Audit lab performance and field Core Web Vitals`},subCommands:{audit:v({meta:{name:`audit`,description:`Run a Lighthouse/Core Web Vitals performance audit`},args:{url:{type:`string`,description:`URL to audit.`},strategy:{type:`string`,default:`mobile`,description:`Audit strategy: mobile or desktop.`},"lighthouse-bin":{type:`string`,description:`Custom Lighthouse binary path. Defaults to the bundled version.`},"crux-key":{type:`string`,description:`CrUX API key. Prefer SEO_CRUX_API_KEY to avoid shell history.`},raw:{type:`boolean`,default:!1,description:`Include the full Lighthouse JSON in JSON output.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local performance report cache.`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=O(e),n=C(e.url);if(!n)throw new m(`INVALID_INPUT`,`No URL given. Pass --url.`);let r=await p({url:n,strategy:Ys(e.strategy),lighthouseBin:C(e[`lighthouse-bin`]),cruxApiKey:C(e[`crux-key`]),refresh:w(e.refresh),includeRaw:t&&w(e.raw)});t?P(r):(K({title:`Performance report`,target:r.url,status:r.dataStatus===`partial`?`unknown`:r.grade===`good`?`pass`:`warning`,summary:r.headline,metrics:[{label:`Source`,value:r.source},{label:`Strategy`,value:r.strategy},{label:`Lab score`,value:r.score===void 0?`Unknown`:`${r.score}/100`},{label:`Lab grade`,value:r.grade},{label:`Evidence`,value:r.dataStatus},{label:`FCP`,value:Xs(r.metrics.firstContentfulPaint)},{label:`LCP`,value:Xs(r.metrics.largestContentfulPaint)},{label:`TBT`,value:Xs(r.metrics.totalBlockingTime)},{label:`CLS`,value:Xs(r.metrics.cumulativeLayoutShift)},{label:`INP`,value:Xs(r.metrics.interactionToNextPaint)},{label:`Server response`,value:Xs(r.metrics.serverResponseTime)},{label:`Fallback fetch`,value:Xs(r.metrics.fallbackFetchDuration)},{label:`Field data`,value:r.fieldData?`${r.fieldData.scope} ${r.fieldData.formFactor.toLowerCase()} (${r.fieldData.assessment.status})`:r.fieldDataStatus.status},{label:`Field LCP p75`,value:Zs(r.fieldData?.metrics.largestContentfulPaint)},{label:`Field INP p75`,value:Zs(r.fieldData?.metrics.interactionToNextPaint)},{label:`Field CLS p75`,value:Zs(r.fieldData?.metrics.cumulativeLayoutShift)},{label:`Field period`,value:r.fieldData?.collectionPeriod?.firstDate&&r.fieldData.collectionPeriod.lastDate?`${r.fieldData.collectionPeriod.firstDate} to ${r.fieldData.collectionPeriod.lastDate}`:`Unavailable`}]}),J(`Top actions`,r.topActions.map(e=>({label:e.title,action:e.action,context:e.plainEnglish}))),Y(`Caveats`,r.caveats))}})}}),$s=v({meta:{name:`doctor`,description:`Check local auth, scopes, config, and defaults`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Fn();O(e)?(P(t),t.ok||(process.exitCode=1)):(Hi(`SEO doctor`,Ni(t.checks)),process.stdout.write(`
|
|
75
|
+
`),Ui(t.checks),process.stdout.write(`\nChecked ${t.generatedAt}\n`),t.ok||(process.exitCode=1))}}),ec=e=>{let t=C(e)??`page`;if(t!==`page`&&t!==`query`&&t!==`country`&&t!==`device`)throw Error(`Invalid --dimension. Use page, query, country, or device.`);return t},tc=v({meta:{name:`segment-impact`,description:`Compare GSC movement by page, query, device, or country`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},dimension:{type:`string`,default:`page`,description:`Segment by page, query, country, or device.`},...X([`days`,`limit`,`refresh`],{days:{description:`Recent window length from 1 to 240 days. Defaults to 28.`},limit:{description:`Maximum segment rows to print. Defaults to 25.`},refresh:{description:`Bypass local cache and fetch fresh GSC data.`}}),compare:{type:`string`,description:`Legacy 1-240 day comparison length. Must equal the current window.`},"start-date":{type:`string`,description:`Exact current-window start date in YYYY-MM-DD format.`},"end-date":{type:`string`,description:`Exact current-window end date in YYYY-MM-DD format.`},"max-rows":{type:`string`,description:`Maximum retained GSC rows per window. Defaults to 100000.`},"unmatched-limit":{type:`string`,description:`Maximum one-window evidence rows to return. Defaults to 25.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=ec(e.dimension),r=E(e.days,`--days`),i=E(e.compare,`--compare`),a=E(e.limit,`--limit`),o=E(e[`unmatched-limit`],`--unmatched-limit`),s=E(e[`max-rows`],`--max-rows`),c=k(C(e.site)),l=await He({site:c,dimension:n,days:r,compareDays:i,startDate:C(e[`start-date`]),endDate:C(e[`end-date`]),limit:a,unmatchedLimit:o,maxRows:s,refresh:w(e.refresh)});t?P(l):(K({title:`Segment impact`,target:l.site,status:l.dataStatus===`complete`?`info`:`unknown`,summary:l.summary.verdict,metrics:[{label:`Dimension`,value:l.dimension},{label:`Evidence`,value:l.dataStatus},{label:`Before`,value:`${l.before.startDate} to ${l.before.endDate}`},{label:`After`,value:`${l.after.startDate} to ${l.after.endDate}`}]}),I([`Segment`,`Clicks before`,`Clicks after`,`Delta`,`Pos delta`],l.items.map(e=>[e.key,e.beforeClicks,e.afterClicks,e.clickDelta,e.positionDelta??`-`])),l.unmatchedSegments.length&&(process.stdout.write(`
|
|
76
76
|
One-window evidence (not treated as zero)
|
|
77
|
-
`),I([`Segment`,`Retained in`,`Clicks`,`Impressions`],l.unmatchedSegments.map(e=>[e.key,e.retainedIn,e.clicks,e.impressions]))),Y(`Warnings`,l.warnings))}});function
|
|
78
|
-
`))}});function
|
|
79
|
-
`)}}),describe:
|
|
80
|
-
`),`Package`),b(`This package can read files, use the network, and run with the same local permissions as seo. Installing it is not a security review or endorsement.`,`Third-party code`),!
|
|
81
|
-
`):I([`Provider`,`Package`,`Version`,`Status`],n.installed.map(e=>[e.id,e.package,e.version,e.error??e.loadStatus]))}})},
|
|
82
|
-
`),
|
|
77
|
+
`),I([`Segment`,`Retained in`,`Clicks`,`Impressions`],l.unmatchedSegments.map(e=>[e.key,e.retainedIn,e.clicks,e.impressions]))),Y(`Warnings`,l.warnings))}});function nc(e){return`${H(e)} ${e===1?`row`:`rows`}`}const rc=v({meta:{name:`striking-distance`,description:`Find query/page rows averaging positions above 10 through 20`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`days`,`minImpressions`,`limit`,`includeBrand`,`verifyContent`,`verifyLimit`,`js`,`fetchConcurrency`,`fetchIntervalCap`,`fetchIntervalMs`,`refresh`]),json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=T(e[`verify-limit`]),r=w(e[`verify-content`])===!0||n!==void 0,i=k(C(e.site)),a=await Ie({site:i,days:T(e.days),minImpressions:T(e[`min-impressions`]),limit:T(e.limit),includeBrand:w(e[`include-brand`]),verifyContent:r,verifyLimit:n,js:w(e.js)?!0:void 0,rate:ri(e),refresh:w(e.refresh)});t?P(a):(K({title:`Striking-distance opportunities`,target:a.site,status:a.source.possiblyTruncated?`unknown`:`info`,summary:a.summary.verdict,metrics:[{label:`Eligible rows`,value:H(a.summary.eligibleRows)},{label:`Returned rows`,value:H(a.summary.returnedRows)},{label:`Template groups`,value:H(a.summary.groups)},{label:`Impressions`,value:H(a.summary.eligibleImpressions)},{label:`Brand queries`,value:a.summary.brandFiltering},{label:`Verification`,value:a.verification.requested?`Requested`:`Off`},{label:`Evidence`,value:a.dataStatus}]}),Y(`Why this matters`,[`These rows have a GSC average position above 10 and at most 20. Treat them as candidates for investigation, not guaranteed page-two rankings.`,`Groups use all eligible rows. A shared-template label is only a candidate until recurring evidence is verified across distinct URLs.`]),Y(`Recommended actions`,a.recommendations),Y(`Report caveats`,a.caveats),a.groups.length&&(q([`Group`,`Rows`,`URLs`,`Impr`,`Avg pos`,`Scope`,`Action`],a.groups.map(e=>[G(e.label,36),H(e.rowCount),H(e.uniqueUrls),H(e.totalImpressions),U(e.impressionWeightedPosition),e.actionScope,G(e.recommendation.action,72)])),J(`Top striking-distance group actions`,a.groups.map(e=>({label:e.label,context:`${nc(e.rowCount)}, ${H(e.totalImpressions)} impressions`,action:e.recommendation.action})))),a.items.length?(q([`Query`,`Template`,`URL`,`Impr`,`CTR`,`Pos`,`Score`,`Fetch`,`Check`,`Action`],a.items.map(e=>[G(e.query,36),G(e.template.label,24),G(e.url,48),H(e.impressions),W(e.ctr),U(e.position),e.priority.score,eo(e.contentVerification?.fetchDiagnostics),to(e.contentVerification?.classification),G(e.recommendation.action,72)])),J(`Top striking-distance actions`,a.items.map(e=>({label:e.query,context:`${e.template.label}, pos ${U(e.position)}, ${H(e.impressions)} impressions`,action:e.recommendation.action})))):process.stdout.write(`No striking-distance opportunities matched these filters.
|
|
78
|
+
`))}});function ic(e){return e===`keychain`?`system keychain`:e===`file`?`private local file`:e??`missing`}function ac(e){return e===null?`unavailable`:`$${(e/1e6).toFixed(2)}`}function oc(e){return e.limit===null?e.used===null?`not reported`:`${e.used.toLocaleString(`en-US`)} used; no key limit`:`${(e.remaining??0).toLocaleString(`en-US`)} of ${e.limit.toLocaleString(`en-US`)} remaining`}const sc=v({meta:{name:`connect`,description:`Validate and save an Ahrefs API v3 key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(!N({json:O(e)}))throw new m(`AUTH_REQUIRED`,`Run \`seo providers ahrefs connect\` in a terminal. Agents and CI can set ${o}.`);y(`Connect Ahrefs`),b(`Paste an API v3 key from Ahrefs Account settings. The validation check and Domain Rating are free; other research can consume API units.`,`API key`);let t=L(await Mr({message:`Ahrefs API v3 key`,validate:e=>e?.trim()?void 0:`API key is required`})),n=await new fn({apiKey:t}).limitsAndUsage(),r=await Ye(t);b(`${n.subscription} subscription. API key units: ${oc(n.apiKeyUnits)}.`,`Connection verified`),x(`Saved in the ${ic(r)}. Run seo providers ahrefs status --check to verify it again.`)}}),cc=v({meta:{name:`status`,description:`Show the local Ahrefs connection`},args:{check:{type:`boolean`,default:!1,description:`Verify the API key with the free account endpoint.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await ue(),n=!!e.check,r=n&&t?await new fn().limitsAndUsage():void 0,i={connected:!!t,apiVersion:t?3:null,credentialSource:t?.source,liveCheck:r?{status:`passed`,subscription:r.subscription,apiKeyExpiresAt:r.apiKeyExpiresAt,usageResetsAt:r.usageResetsAt,apiKeyUnits:r.apiKeyUnits,workspaceUnits:r.workspaceUnits,observedAt:r.observedAt,requestCostUnits:r.requestCostUnits}:{status:n?`unavailable`:`not-requested`}};O(e)?P(i):F([[`Connected`,i.connected?`yes`:`no`],[`API version`,i.apiVersion?`Version 3`:`not connected`],[`Credential`,ic(i.credentialSource)],[`Live check`,i.liveCheck.status===`passed`?`passed at ${i.liveCheck.observedAt}`:i.liveCheck.status===`unavailable`?`not available without credentials`:`not requested; pass --check to verify`],...r?[[`Subscription`,r.subscription],[`API key units`,oc(r.apiKeyUnits)],[`Workspace units`,oc(r.workspaceUnits)],[`Usage resets`,r.usageResetsAt],[`Key expires`,r.apiKeyExpiresAt]]:[]])}}),lc=v({meta:{name:`disconnect`,description:`Remove the saved Ahrefs API v3 key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await Qe();let t=!!process.env[o]?.trim(),n={savedCredentialRemoved:!0,environmentCredential:t?`active`:`missing`,note:t?`The environment variable was not changed. Clear ${o} to fully disconnect.`:`Ahrefs is disconnected.`};O(e)?P(n):process.stdout.write(`${n.note}\n`)}}),uc=v({meta:{name:`ahrefs`,description:`Connect Ahrefs for optional search and link data`},subCommands:{connect:sc,status:cc,disconnect:lc}}),dc="Run `seo providers bing connect` with a new API key.",fc=v({meta:{name:`connect`,description:`Check and save a Bing Webmaster Tools API key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(!N({json:O(e)}))throw new m(`AUTH_REQUIRED`,`Run \`seo providers bing connect\` in a terminal. Agents and CI can set ${pe}.`);y(`Connect Bing Webmaster Tools`),b(`In Bing Webmaster Tools, open Settings, then API access, and copy the API key. Bing data is free.`,`API key`);let t=L(await Mr({message:`Bing Webmaster API key`,validate:e=>e?.trim()?void 0:`API key is required`})),n=await vt(Wt({apiKey:t},{signIn:dc})),r=await Wn(t);b(`${n.filter(e=>e.verified).length} verified sites.`,`Connection verified`),x(`Saved in the ${ic(r)}.`)}}),pc=v({meta:{name:`status`,description:`Show the Bing Webmaster connection`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Be(),n=t?await vt(Wt({apiKey:t.apiKey},{signIn:dc})):null,r={connected:!!t,credentialSource:t?.source??null,sites:n?.filter(e=>e.verified).map(e=>e.url)??[]};O(e)?P(r):process.stdout.write(t?`Connected (${ic(t.source)}). Verified sites: ${r.sites.join(`, `)||`none`}.\n`:"Not connected. Run `seo providers bing connect`.\n")}}),mc=v({meta:{name:`disconnect`,description:`Remove the saved Bing Webmaster API key`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await Se();let t=!!process.env[pe]?.trim(),n=t?`The saved key is removed. Clear ${pe} to fully disconnect.`:`Bing is disconnected.`;O(e)?P({removed:!0,environment:t}):process.stdout.write(`${n}\n`)}}),hc=v({meta:{name:`bing`,description:`Connect Bing Webmaster Tools for Bing search data`},subCommands:{connect:fc,status:pc,disconnect:mc}}),gc=v({meta:{name:`connect`,description:`Validate and save DataForSEO API credentials`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{if(!N({json:O(e)}))throw new m(`AUTH_REQUIRED`,`Run \`seo providers dataforseo connect\` in a terminal. Agents and CI can set ${Kt} and ${Te}.`);y(`Connect DataForSEO`),b(`Use the API login and API password from DataForSEO API Access. The validation call is free; later research reports can make charged requests.`,`API credentials`);let t=L(await Pr({message:`DataForSEO API login`,validate:e=>e?.trim()?void 0:`API login is required`})),n=L(await Mr({message:`DataForSEO API password`,validate:e=>e?void 0:`API password is required`})),r={login:t.trim(),password:n},i=await new Nt({credentials:()=>r}).userData(),a=await ie(r);b(`${i.login} is connected with an account balance of ${ac(i.balanceMicros)}.`,`Connection verified`),x(`Saved in the ${ic(a)}. Run seo providers dataforseo status --check to verify it again.`)}}),_c=v({meta:{name:`status`,description:`Show the local DataForSEO connection`},args:{check:{type:`boolean`,default:!1,description:`Verify credentials with the free account endpoint.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await Pe(),n=!!e.check,r=n&&t?await new Nt().userData():void 0,i={connected:!!t,credentialSource:t?.source,migratedLegacyCredentials:t?.migrated??!1,liveCheck:r?{status:`passed`,account:r.login,timezone:r.timezone,balanceMicros:r.balanceMicros,observedAt:r.observedAt,requestCostMicros:r.requestCostMicros}:{status:n?`unavailable`:`not-requested`}};O(e)?P(i):F([[`Connected`,i.connected?`yes`:`no`],[`Credential`,ic(i.credentialSource)],[`Live check`,i.liveCheck.status===`passed`?`passed at ${i.liveCheck.observedAt}`:i.liveCheck.status===`unavailable`?`not available without credentials`:`not requested; pass --check to verify`],...r?[[`Account`,r.login],[`Balance`,ac(r.balanceMicros)]]:[]])}}),vc=v({meta:{name:`disconnect`,description:`Remove saved DataForSEO credentials`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{await Oe();let t=!!process.env[Kt]?.trim(),n=!!process.env[Te],r={savedCredentialsRemoved:!0,environmentCredentials:t&&n?`active`:t||n?`partial`:`missing`,note:t||n?`Environment variables were not changed. Clear ${Kt} and ${Te} to fully disconnect.`:`DataForSEO is disconnected.`};O(e)?P(r):process.stdout.write(`${r.note}\n`)}}),yc=v({meta:{name:`dataforseo`,description:`Connect DataForSEO for optional search data`},subCommands:{connect:gc,status:_c,disconnect:vc}});function bc(e){if(!e)return{};let t;try{t=JSON.parse(e)}catch{throw new m(`INVALID_INPUT`,`--account must be a JSON object.`)}if(!t||Array.isArray(t)||typeof t!=`object`)throw new m(`INVALID_INPUT`,`--account must be a JSON object.`);let n=Object.entries(t);if(n.length>20||n.some(([e,t])=>!e||e.length>64||typeof t!=`string`||t.length>4096))throw new m(`INVALID_INPUT`,`--account must contain at most 20 bounded string fields.`);return Object.fromEntries(n.map(([e,t])=>[e,t.trim()]))}function xc(e){if(!e)return{};let t;try{t=JSON.parse(e)}catch{throw new m(`INVALID_INPUT`,`--params must be a JSON object.`)}if(!t||Array.isArray(t)||typeof t!=`object`)throw new m(`INVALID_INPUT`,`--params must be a JSON object.`);let n=Object.entries(t);if(n.length>100||n.some(([e])=>!/^[A-Za-z][A-Za-z0-9-]{0,63}$/u.test(e))||Buffer.byteLength(e)>65536)throw new m(`INVALID_INPUT`,`--params must be a JSON object smaller than 64 KiB.`);return Object.fromEntries(n)}async function Sc(e){let t=await Ze(),n=t.registry.get(e);if(n)return n;let r=t.failures.find(t=>t.id===e);throw r?new m(`INVALID_INPUT`,`Provider ${e} could not load: ${r.message}`):new m(`INVALID_INPUT`,`Provider ${e} is not installed.`)}function Cc(e,t){let n=new Set(e.connection.fields.filter(e=>e.kind===`account`).map(e=>e.id)),r=Object.keys(t).find(e=>!n.has(e));if(r)throw new m(`INVALID_INPUT`,`${r} is not an account field for ${e.displayName}.`);let i=e.connection.normalizeAccount?e.connection.normalizeAccount(t):{...t};if(Object.keys(i).find(e=>!n.has(e)))throw new m(`PROVIDER_UNAVAILABLE`,`${e.displayName} returned an unknown account field.`);for(let t of e.connection.fields.filter(e=>e.kind===`account`&&e.required!==!1))if(!i[t.id]?.trim())throw new m(`INVALID_INPUT`,`${t.label} is required.`);return i}async function wc(){return Mn()}const Tc={list:v({meta:{name:`list`,description:`List installed provider packages`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await wc();O(e)?P(t):t.installed.length>0?I([`Installed provider`,`Package`,`Version`,`Status`],t.installed.map(e=>[e.id,e.package,e.version,e.loadStatus])):process.stdout.write(`No provider extensions are installed.
|
|
79
|
+
`)}}),describe:v({meta:{name:`describe`,description:`Describe one installed provider for an agent`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=await pt(t);O(e)?P(n):F([[`Provider`,n.displayName],[`Package`,`${n.package}@${n.version}`],[`Description`,n.description],[`Capabilities`,n.capabilities.map(e=>e.id).join(`, `)||`none`],[`Actions`,n.actions.map(e=>e.id).join(`, `)||`none`]])}}),install:v({meta:{name:`install`,description:`Install one provider package from npm`},args:{package:{type:`positional`,required:!0,description:`npm package name with an optional exact version.`},yes:{type:`boolean`,default:!1,description:`Approve third-party code installation without prompting.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.package)??``,n=O(e),r=w(e.yes),i=N({json:n});if(!r&&!i)throw new m(`INVALID_INPUT`,`Provider installation runs third-party code. Review the package, then pass --yes to approve it in JSON or CI mode.`);let a;try{a=await nn(t)}catch(e){throw new m(`INVALID_INPUT`,e instanceof Error?e.message:String(e))}if(!r&&(y(`Install provider package`),b([`${a.package}@${a.version}`,`Publisher: ${a.publisher??`not supplied by npm`}`,`Repository: ${a.repository??`not supplied by npm`}`,`Integrity: ${a.integrity}`].join(`
|
|
80
|
+
`),`Package`),b(`This package can read files, use the network, and run with the same local permissions as seo. Installing it is not a security review or endorsement.`,`Third-party code`),!L(await Or({message:`Install ${a.package}@${a.version}?`,initialValue:!1})))){x(`Provider was not installed.`);return}let o;try{o=await zt(a)}catch(e){throw new m(`PROVIDER_UNAVAILABLE`,e instanceof Error?e.message:String(e))}n?P({installed:o,package:a}):x(`Installed provider ${o.id} from ${o.package}@${o.version}.`)}}),remove:v({meta:{name:`remove`,description:`Remove one installed provider extension`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},yes:{type:`boolean`,default:!1,description:`Remove the package without prompting.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=O(e),r=w(e.yes),i=N({json:n});if(!r&&!i)throw new m(`INVALID_INPUT`,`Pass --yes to remove a provider extension in JSON or CI mode.`);if(!r&&!L(await Or({message:`Remove provider ${t}?`,initialValue:!1})))return;let a=await It(t);if(!a)throw new m(`INVALID_INPUT`,`Provider ${t} is not installed.`);n?P({removed:a}):process.stdout.write(`Removed ${t}.\n`)}}),connect:v({meta:{name:`connect`,description:`Validate and save one installed provider connection`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},account:{type:`string`,description:`Account fields as JSON. Secret fields must use their environment variables.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=O(e),r=N({json:n}),i=await Sc(t),a={...bt(t),...bc(C(e.account))},o={};if(r){y(`Connect ${i.displayName}`),i.connection.verificationNotice&&b(i.connection.verificationNotice,`Connection check`);for(let e of i.connection.fields){if(e.kind===`account`){let t=L(await Pr({message:e.label,placeholder:e.description,initialValue:a[e.id],validate:t=>e.required!==!1&&!t?.trim()?`${e.label} is required`:void 0}));t?.trim()&&(a[e.id]=t.trim());continue}if(e.envVar&&process.env[e.envVar]?.trim())continue;let t=L(await Mr({message:e.label,validate:t=>e.required!==!1&&!t?.trim()?`${e.label} is required`:void 0}));t?.trim()&&(o[e.id]=t.trim())}}a=Cc(i,a);let s={...o};Object.keys(s).length===0&&(s=await le({providerId:t,account:a,fields:i.connection.fields})),await fe({providerId:t,account:a,credentials:s}),Object.keys(o).length>0&&await xe({providerId:t,account:a,credentials:o}),Rn(t,a);let c={provider:t,connected:!0,account:a,capabilities:(i.capabilities??[]).map(e=>e.id),actions:(i.actions??[]).map(e=>e.id)};n?P(c):x(`Connected ${i.displayName}. Run seo providers describe ${t} to see what it can do.`)}}),status:v({meta:{name:`status`,description:`Show one installed provider connection`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},check:{type:`boolean`,default:!1,description:`Run the provider connection check.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=await Sc(t),r=bt(t),i;try{i=await le({providerId:t,account:r,fields:n.connection.fields})}catch{i=void 0}let a=n.connection.fields.filter(e=>e.kind===`account`&&e.required!==!1).every(e=>!!r[e.id]?.trim())&&i!==void 0,o=w(e.check);if(o&&!a)throw new m(`AUTH_REQUIRED`,`Provider ${t} is not connected. Run \`seo providers connect ${t}\`.`);o&&i&&await fe({providerId:t,account:r,credentials:i});let s={provider:t,installed:!0,connected:a,account:r,capabilities:(n.capabilities??[]).map(e=>e.id),actions:(n.actions??[]).map(e=>e.id),check:o?`passed`:`not-requested`};O(e)?P(s):I([`Provider`,`Connected`,`Capabilities`,`Check`],[[n.displayName,a?`yes`:`no`,s.capabilities.join(`, `),s.check]])}}),disconnect:v({meta:{name:`disconnect`,description:`Remove one saved provider connection`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``;await Sc(t);let n=bt(t);await rt({providerId:t,account:n}),Vn(t);let r={provider:t,disconnected:!0,note:`Environment variables were not changed.`};O(e)?P(r):process.stdout.write(`Disconnected ${t}. ${r.note}\n`)}}),run:v({meta:{name:`run`,description:`Run one action supplied by an installed provider`},args:{id:{type:`positional`,required:!0,description:`Installed provider id.`},action:{type:`positional`,required:!0,description:`Provider action id.`},account:{type:`string`,description:`Account fields as JSON. Defaults to the saved connection.`},params:{type:`string`,description:`Action parameters as a JSON object.`},refresh:{type:`boolean`,default:!1,description:`Bypass the local provider cache.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=C(e.action)??``;await Sc(t);let r={...bt(t),...bc(C(e.account))};P(await Ue({providerId:t,actionId:n,account:r,params:xc(C(e.params)),refresh:w(e.refresh)}))}}),doctor:v({meta:{name:`doctor`,description:`Validate installed provider packages and entry points`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=await wc(),n={ok:t.installed.every(e=>e.loadStatus===`ready`),installed:t.installed};O(e)?P(n):n.installed.length===0?process.stdout.write(`No provider extensions are installed.
|
|
81
|
+
`):I([`Provider`,`Package`,`Version`,`Status`],n.installed.map(e=>[e.id,e.package,e.version,e.error??e.loadStatus]))}})},Ec=v({meta:{name:`providers`,description:`Connect optional data providers`},subCommands:{...Tc,ahrefs:uc,bing:hc,dataforseo:yc}}),Dc={"ai-search":`AI search`,crawl:`Crawling and technical checks`,diagnosis:`Diagnosis`,monitoring:`Monitoring`,opportunities:`Opportunities`,reporting:`Reporting`,setup:`Setup`,workflows:`Workflows`};function Oc(e){let t=C(e);if(t){if(!wn.includes(t))throw new m(`INVALID_INPUT`,`Unknown report category: ${t}. Choose ${wn.join(`, `)}.`);return t}}async function kc(e,t){let n=C(e),r=C(t);if(n&&r)throw new m(`INVALID_INPUT`,`Use either --params or --params-file, not both.`);if(!n&&!r)return{};let i=n??await _(r??``,`utf8`),a;try{a=JSON.parse(i)}catch{throw new m(`INVALID_INPUT`,`Report parameters must be valid JSON.`)}if(!a||typeof a!=`object`||Array.isArray(a))throw new m(`INVALID_INPUT`,`Report parameters must be an object.`);return a}function Ac(e){if(!e.isError)return;let t=e.structuredContent;throw new m(t?.error?.code??`INTERNAL_ERROR`,t?.error?.message??`The report could not be completed.`)}function jc(e){if(!e||typeof e!=`object`)return[];let t=e,n=new Set(t.required??[]);return Object.entries(t.properties??{}).map(([e,t])=>{let r=Array.isArray(t.type)?t.type.join(` | `):t.type??`any`;return{name:e,type:r===`array`&&t.items?.type?`${t.items.type}[]`:t.format?`${r} (${t.format})`:r,required:n.has(e),description:t.description}})}const Mc=v({meta:{name:`list`,description:`List report ids available to the CLI and MCP server`},args:{category:{type:`string`,description:`Filter by category: ${wn.join(`, `)}.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=Oc(e.category),n=ln(t);O(e)?P({reports:n,categories:wn}):(Gi(n,{noun:`report`,categoryLabels:Dc}),process.stdout.write(`
|
|
82
|
+
`),Vi({title:`Need the detail?`,body:`Describe one report to see when to use it, what it needs, and what the result can prove.`,command:`seo reports describe <id>`}))}}),Nc=v({meta:{name:`describe`,description:`Show the purpose and parameter schema for one report`},args:{id:{type:`positional`,required:!0,description:"Report id from `seo reports list`."},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=Ht(C(e.id)??``);O(e)?P({report:t}):(Hi(t.name,t.description),process.stdout.write(`
|
|
83
83
|
`),F([[`ID`,t.id],[`Category`,t.category],[`Outcome`,t.outcome]]),process.stdout.write(`
|
|
84
|
-
`),
|
|
85
|
-
`),
|
|
86
|
-
`),
|
|
87
|
-
`),
|
|
88
|
-
`),
|
|
89
|
-
`),
|
|
90
|
-
`),
|
|
84
|
+
`),Ji(`Use when`,t.useWhen),process.stdout.write(`
|
|
85
|
+
`),Ji(`Avoid when`,t.avoidWhen),process.stdout.write(`
|
|
86
|
+
`),Ji(`Read in order`,t.readOrder),process.stdout.write(`
|
|
87
|
+
`),Ji(`Do not claim`,t.doNotClaim),process.stdout.write(`
|
|
88
|
+
`),qi(`Verify`,t.verify),process.stdout.write(`
|
|
89
|
+
`),Vi({title:`Implement findings`,body:t.agentWorkflow.completion,command:t.agentWorkflow.actionView.cli}),t.related.length>0&&(process.stdout.write(`
|
|
90
|
+
`),Ji(`Related reports`,t.related.map(e=>`${e.id}: ${e.reason}`))),process.stdout.write(`
|
|
91
91
|
Parameters
|
|
92
|
-
`),
|
|
93
|
-
`),
|
|
94
|
-
`),
|
|
95
|
-
`),
|
|
96
|
-
`),
|
|
97
|
-
`),
|
|
98
|
-
`),
|
|
99
|
-
`)?i:`${i}\n`)}});async function
|
|
100
|
-
`);for(let t of e.rules.slice(0,40)){let n=e.issues.filter(e=>e.rule===t.rule).slice(0,3).map(e=>e.found?`${e.file}: ${e.found}`:e.file);
|
|
101
|
-
`||s===`\r`?r&&=(t.push(n),n=``,!1):(n+=s,r=!0)}if(i||a)throw new
|
|
92
|
+
`),Yi(jc(t.inputSchema)),process.stdout.write(`
|
|
93
|
+
`),Vi({title:`Need the exact schema?`,command:`seo reports describe ${t.id} --json`}))}}),Pc=v({meta:{name:`run`,description:`Run one report with JSON parameters`},args:{id:{type:`positional`,required:!0,description:"Report id from `seo reports list`."},params:{type:`string`,description:`Report parameters as a JSON object.`},"params-file":{type:`string`,description:`Read report parameters from a JSON file.`},"actions-only":{type:`boolean`,default:!1,description:`Return findings, verification, and retained inventories without the full report body.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.id)??``,n=await kc(e.params,e[`params-file`]),r=await gt(t,n,{view:w(e[`actions-only`])?`actions`:`full`});if(Ac(r),O(e))P(r.structuredContent??{});else for(let e of r.content)process.stdout.write(`${e.text}\n`)}}),Fc=v({meta:{name:`reports`,description:`Discover and run the complete report catalog`},subCommands:{list:Mc,describe:Nc,run:Pc}}),Ic=v({meta:{name:`rules`,description:`List crawler rule ids and default guidance`},args:{category:{type:`string`,description:`Filter rules by category.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.category),n=An().filter(e=>!t||e.category===t);O(e)?P({rules:n}):Gi(n.map(e=>({id:e.id,category:e.category,name:`${e.title} · ${e.defaultSeverity}`})),{noun:`rule`})}}),Lc=v({meta:{name:`explain`,description:`Explain one crawler rule in plain English`},args:{rule:{type:`string`,required:!0,description:`Rule id to explain, for example missing_title.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=C(e.rule)??``,n=en(t);if(!n)throw Error(`Unknown rule: ${t}`);O(e)?P(n):(F([[`Rule`,n.id],[`Title`,n.title],[`Category`,n.category],[`Severity`,n.defaultSeverity]]),process.stdout.write(`
|
|
94
|
+
`),qi(`Why it matters`,n.whyItMatters),process.stdout.write(`
|
|
95
|
+
`),qi(`How to fix`,n.howToFix),process.stdout.write(`
|
|
96
|
+
`),qi(`Impact if ignored`,n.impactIfIgnored),process.stdout.write(`
|
|
97
|
+
`),qi(`How to verify`,n.howToVerify))}});function Rc(){return Vc(`skills`,process.env.SEO_SKILLS_DIR)}function zc(){return Vc(`evals`,process.env.SEO_EVALS_DIR)}function Bc(){return Vc(`site-kit`)}function Vc(e,t){if(t)return tr(t);let n=Qn(hr(import.meta.url));for(let t=0;t<6;t+=1){let t=h(n,e);if(g(h(t,`README.md`)))return t;n=Qn(n)}throw new m(`INTERNAL_ERROR`,`Packaged ${e} could not be found. Reinstall \`seo\` and try again.`)}function Hc(e){return cr(h(e,`SKILL.md`),`utf8`).match(/^description:\s*(.+)$/m)?.[1]?.trim()??``}const Uc=[[`setup`,`Sign in to the accounts the site needs, one at a time`],[`market`,`Choose a market with real demand and data you can own`],[`data`,`Get, clean and keep the dataset`],[`plan`,`Plan the pages from what people search for`],[`build`,`Start the site and deploy a private preview`],[`golden-page`,`Build one page that is the best answer on the web`],[`writing`,`Write copy people enjoy and AI answers can quote`],[`scale`,`Turn the golden page into every page, with gates`],[`launch`,`Go live and get the important pages indexed`],[`grow`,`Measure with your own data and improve every week`]],Wc=/* @__PURE__ */ new Set([`node_modules`,`dist`,`.astro`,`.wrangler`]);function Gc(e){return e.toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-|-$/g,``)}function Kc(e){return Gc(Zn(e)).split(`-`).filter(Boolean).map(e=>`${e[0]?.toUpperCase()}${e.slice(1)}`).join(` `)}function qc(e){let t=(e??`example.com`).trim().toLowerCase().replace(/^https?:\/\//,``).replace(/\/.*$/,``);if(!/^(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z]{2,}$/.test(t))throw new m(`INVALID_INPUT`,`--domain must be a domain such as example.com, not ${e}.`);return t}async function Jc(e,t){let n=JSON.parse(await _(e,`utf8`));t(n),await br(e,`${JSON.stringify(n,null,2)}\n`)}function Yc(){return ko(`pnpm`,[`--version`],{stdio:`ignore`}).status===0?`pnpm`:`npm`}const Xc=v({meta:{name:`new`,description:`Copy the Astro on Cloudflare starter into a new folder`},args:{folder:{type:`positional`,required:!0,description:`Folder to create. It must not exist or must be empty.`},name:{type:`string`,description:`Site name. Defaults to the folder name.`},domain:{type:`string`,description:`Production domain. Defaults to example.com until you buy one.`},install:{type:`boolean`,default:!0,description:`Install packages after copying.`,negativeDescription:`Copy the files only.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=tr(String(e.folder));if(g(n)&&(await vr(n)).some(e=>e!==`.git`))throw new m(`INVALID_INPUT`,`${n} is not empty. Choose a new folder for the site.`);let r=C(e.name)?.trim()||Kc(n),i=qc(C(e.domain)),a=Gc(Zn(n))||`site`,o=qn(16).toString(`hex`),s=h(Bc(),`starter`);await gr(s,n,{recursive:!0,filter:e=>!er(s,e).split(nr).some(e=>Wc.has(e))}),await yr(h(n,`gitignore`),h(n,`.gitignore`)),await Jc(h(n,`site.config.json`),e=>{e.name=r,e.domain=i,e.indexNowKey=o}),await br(h(n,`public`,`${o}.txt`),o),await Jc(h(n,`package.json`),e=>{e.name=a;let t=e.devDependencies;t.seo=`^${at}`});let c=h(n,`wrangler.jsonc`);await br(c,(await _(c,`utf8`)).replace(`"name": "example-site"`,`"name": ${JSON.stringify(a)}`));let l=h(n,`README.md`);await br(l,(await _(l,`utf8`)).replace(/^# .*$/m,`# ${r}`));let u=$r(e,`install`)===!0?void 0:Yc(),d=!1;u&&(t||process.stdout.write(`Installing packages with ${u}...\n`),d=ko(u,[`install`],{cwd:n,stdio:t?`ignore`:`inherit`}).status===0);let ee=[`cd ${er(process.cwd(),n)||`.`}`,`seo site guide setup`];t?P({folder:n,name:r,domain:i,installed:d,packageManager:u??null,next:ee}):(Hi(`Created ${r}`,n),F([[`Domain`,i],[`Packages`,d?`installed with ${u}`:u?`${u} install failed. Run it in the folder.`:`not installed`]]),process.stdout.write(`
|
|
98
|
+
`),qi(`What is in it`,"An example site about parks, built from src/data. It already passes `seo site check`: titles, canonicals, JSON-LD, sharing images, Markdown copies, llms.txt and sitemaps are done for every page.",`Later steps replace the example data and pages with yours.`),Vi({title:`Next`,body:`Read the first step. Each step ends with the next one.`,command:ee.join(` && `)}))}});function Zc(e){let t=Gc(e.join(` `));return Uc.find(([e])=>e===t)?.[0]}const Qc=v({meta:{name:`guide`,description:`Print the instructions for one step of building the site`},args:{step:{type:`positional`,required:!1,description:Uc.map(([e])=>e).join(`, `)},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=e._?.length?e._:[C(e.step)??``];if(!n.join(``).trim()){if(t){P({steps:Uc.map(([e,t])=>({step:e,summary:t}))});return}Hi(`Build a site, one step at a time`,"Run `seo site guide <step>` and follow it before the next step."),Ji(`Steps`,Uc.map(([e,t])=>`${e}: ${t}`)),Vi({title:`Start here`,command:`seo site guide setup`});return}let r=Zc(n);if(!r)throw new m(`INVALID_INPUT`,`Unknown step "${n.join(` `)}". Steps: ${Uc.map(([e])=>e).join(`, `)}.`);let i=await _(h(Bc(),`guide`,`${r}.md`),`utf8`),a=Uc.findIndex(([e])=>e===r),o=Uc[a+1]?.[0];t?P({step:r,number:a+1,of:Uc.length,markdown:i,next:o?`seo site guide ${o}`:null}):process.stdout.write(i.endsWith(`
|
|
99
|
+
`)?i:`${i}\n`)}});async function $c(e){return(await vr(e,{withFileTypes:!0,recursive:!0})).filter(e=>e.isFile()).map(t=>er(e,h(t.parentPath,t.name)).split(nr).join(`/`))}function el(e){Hi(e.status===`passed`?`Site check passed`:e.status===`partial`?`Site check stopped early`:`Site check failed`,e.origin),F([[`Pages`,e.pagesChecked===e.pagesFound?String(e.pagesFound):`${e.pagesChecked} of ${e.pagesFound} checked`],[`Failures`,String(e.failures)],[`Warnings`,String(e.warnings)]]),process.stdout.write(`
|
|
100
|
+
`);for(let t of e.rules.slice(0,40)){let n=e.issues.filter(e=>e.rule===t.rule).slice(0,3).map(e=>e.found?`${e.file}: ${e.found}`:e.file);Ji(`${t.level===`fail`?`Fail`:`Warn`} ${t.rule} (${t.group}, ${t.count}). ${t.fix}`,t.count>n.length?[...n,`and ${t.count-n.length} more`]:n)}e.rules.length>40&&process.stdout.write(`${e.rules.length-40} more rules failed. Use --json for all of them.\n\n`),e.status===`partial`&&qi(`Not every page was checked`,`The check stops at ${e.pagesChecked} pages, so it cannot say the rest pass. Split the site or build fewer, stronger pages.`),Vi(e.status===`passed`?{title:`Next`,body:`Deploy the build, or read the next step of the guide.`,command:`seo site guide`}:{title:`Next`,body:`Fix the template or the data behind the first rule, then build again.`,command:`pnpm build`})}const tl=v({meta:{name:`check`,description:`Check the built site and fail on any rule it breaks`},args:{dir:{type:`string`,description:`Site folder with site.config.json. Defaults to this folder.`},dist:{type:`string`,description:`Build folder. Defaults to dist inside the site folder.`},domain:{type:`string`,description:`Production domain. Defaults to the one in site.config.json.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=tr(C(e.dir)??`.`),r=tr(n,C(e.dist)??`dist`),i=h(n,`site.config.json`),a=g(i)?JSON.parse(await _(i,`utf8`)):{},o=C(e.domain)??a.domain;if(!o)throw new m(`INVALID_INPUT`,"No domain. Run this in a folder made by `seo site new`, or pass --domain.");if(!g(r))throw new m(`INVALID_INPUT`,`${r} does not exist. Build the site first with \`pnpm build\`.`);let s=await Dt({origin:`https://${qc(o)}`,files:await $c(r),readText:e=>_(h(r,e),`utf8`),readBytes:e=>_(h(r,e)),allowWords:a.allowWords??[],sources:g(h(n,`src`))?{files:(await $c(h(n,`src`))).map(e=>`src/${e}`),readText:e=>_(h(n,e),`utf8`)}:void 0});t?P(s):el(s),s.status!==`passed`&&(process.exitCode=1)}}),nl=v({meta:{name:`site`,description:`Build a data-driven site on Astro and Cloudflare`},subCommands:{new:Xc,guide:Qc,check:tl}}),rl=`claude -p`;function il(){let e=zc();return lr(e,{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.json`)).map(t=>({subject:Zn(t.name,`.json`),path:h(e,t.name)})).sort((e,t)=>e.subject<t.subject?-1:+(e.subject>t.subject))}function al(e,t){let n;try{n=cr(t,`utf8`)}catch{throw new m(`INVALID_INPUT`,`Cannot read eval file for ${e}.`)}let r;try{r=JSON.parse(n)}catch{throw new m(`INVALID_INPUT`,`Eval file ${e}.json is not valid JSON.`)}if(!r||typeof r!=`object`||Array.isArray(r))throw new m(`INVALID_INPUT`,`Eval file ${e}.json must be an object.`);let i=r;if(i.subject!==e)throw new m(`INVALID_INPUT`,`Eval file ${e}.json must set subject to "${e}".`);if(!Array.isArray(i.evals)||i.evals.length===0)throw new m(`INVALID_INPUT`,`Eval file ${e}.json must have a non-empty evals array.`);let a=/* @__PURE__ */ new Set;return{subject:e,evals:i.evals.map((t,n)=>{let r=t,i=`${e}.json eval ${n+1}`;if(!Number.isInteger(r?.id))throw new m(`INVALID_INPUT`,`${i}: id must be an integer.`);let o=r.id;if(a.has(o))throw new m(`INVALID_INPUT`,`${i}: duplicate id ${o}.`);if(a.add(o),typeof r.prompt!=`string`||r.prompt.trim().length===0)throw new m(`INVALID_INPUT`,`${i}: prompt must be a non-empty string.`);if(typeof r.expected_output!=`string`||r.expected_output.trim().length===0)throw new m(`INVALID_INPUT`,`${i}: expected_output must be a non-empty string.`);if(!Array.isArray(r.assertions)||r.assertions.length===0||r.assertions.some(e=>typeof e!=`string`||e.trim().length===0))throw new m(`INVALID_INPUT`,`${i}: assertions must be a non-empty array of non-empty strings.`);if(r.files!==void 0&&!Array.isArray(r.files))throw new m(`INVALID_INPUT`,`${i}: files must be an array.`);return{id:o,prompt:r.prompt,expected_output:r.expected_output,assertions:r.assertions,files:r.files??[]}})}}function ol(){let e=h(Rc(),`seo`,`SKILL.md`);if(!g(e))throw new m(`INTERNAL_ERROR`,"The seo router skill could not be found. Reinstall `seo` or use --no-skill.");return cr(e,`utf8`)}function sl(e){let t=[],n=``,r=!1,i=!1,a=!1;for(let o=0;o<e.length;o+=1){let s=e[o];i?(s===`'`?i=!1:n+=s,r=!0):a?(s===`"`?a=!1:s===`\\`&&(e[o+1]===`"`||e[o+1]===`\\`)?(n+=e[o+1],o+=1):n+=s,r=!0):s===`'`?(i=!0,r=!0):s===`"`?(a=!0,r=!0):s===`\\`?o+1<e.length&&(n+=e[o+1],o+=1,r=!0):s===` `||s===` `||s===`
|
|
101
|
+
`||s===`\r`?r&&=(t.push(n),n=``,!1):(n+=s,r=!0)}if(i||a)throw new m(`INVALID_INPUT`,`Unbalanced quote in agent command.`);return r&&t.push(n),t}function cl(e,t){let n=sl(e);if(n.length===0)throw new m(`INVALID_INPUT`,`Agent command must not be empty.`);let r=n.some(e=>e.includes(`{prompt}`));return{argv:r?n.map(e=>e.split(`{prompt}`).join(t)):n,usesPlaceholder:r}}function ll(e,t){return e?`${e.trim()}\n\n---\n\nUser request:\n${t}`:t}function ul(e,t,n,r=!1){let i=[`You are judging whether an AI agent response satisfies a list of assertions.`,`Judge only against the assertions. Be strict but fair.`,``,`Original request:`,e,``,`Agent response:`,t,``,`Assertions to evaluate, in this exact order:`,`<assertions>`,n.map((e,t)=>`${t+1}. ${e}`).join(`
|
|
102
102
|
`),`</assertions>`,``,`Judge outcomes, not narration. An assertion about reading, checking, or`,`following fields or steps passes when the reply demonstrably used that`,`information or produced the result it protects, even if the reply never`,`names the field or step. Fail it only when the reply contradicts it or`,`shows the work was not done.`,``,`Reply with STRICT JSON only. No prose, no markdown, no code fence:`,`{"results":[{"assertion":"<assertion text>","pass":true,"reason":"<short reason>"}]}`,`Return exactly ${n.length} result${n.length===1?``:`s`}, one per assertion, in the same order.`].join(`
|
|
103
|
-
`);return r?`${i}\n\nYour previous reply could not be parsed as the required JSON with one result per assertion. Reply again with STRICT JSON only, in the exact shape shown, and nothing else.`:i}function
|
|
103
|
+
`);return r?`${i}\n\nYour previous reply could not be parsed as the required JSON with one result per assertion. Reply again with STRICT JSON only, in the exact shape shown, and nothing else.`:i}function dl(e){let t=e.indexOf(`{`);if(t===-1)return;let n=0,r=!1,i=!1;for(let a=t;a<e.length;a+=1){let o=e[a];if(r)i?i=!1:o===`\\`?i=!0:o===`"`&&(r=!1);else if(o===`"`)r=!0;else if(o===`{`)n+=1;else if(o===`}`&&(--n,n===0))try{return JSON.parse(e.slice(t,a+1))}catch{return}}}function fl(e,t){let n=dl(e);if(!n||typeof n!=`object`)return{error:`Judge reply did not contain a JSON object.`};let r=n.results;return Array.isArray(r)?r.length===t.length?{verdicts:t.map((e,t)=>{let n=r[t];return{assertion:e,verdict:n?.pass===!0?`pass`:`fail`,reason:typeof n?.reason==`string`&&n.reason.trim().length>0?n.reason.trim():`No reason given.`,source:`judge verdict`}})}:{error:`Judge returned ${r.length} results for ${t.length} assertions.`}:{error:`Judge reply had no results array.`}}function pl(e,t){return new Promise(n=>{let r=Date.now(),[i,...a]=e,o;try{o=Cr(i,a,{stdio:[`pipe`,`pipe`,`pipe`]})}catch(e){n({stdout:``,stderr:``,code:null,timedOut:!1,spawnError:e instanceof Error?e.message:String(e),durationMs:Date.now()-r});return}let s=``,c=``,l=!1,u=!1,d,ee=setTimeout(()=>{u=!0,o.kill(`SIGTERM`),d=setTimeout(()=>{try{o.kill(`SIGKILL`)}catch{}},2e3),d.unref()},t.timeoutMs),te=e=>{l||(l=!0,clearTimeout(ee),d&&clearTimeout(d),n({...e,durationMs:Date.now()-r}))};o.stdout?.on(`data`,e=>{s+=e}),o.stderr?.on(`data`,e=>{c+=e}),o.on(`error`,e=>{te({stdout:s,stderr:c,code:null,timedOut:u,spawnError:e.message})}),o.on(`close`,e=>{te({stdout:s,stderr:c,code:e,timedOut:u})}),o.stdin&&(t.input===void 0?o.stdin.end():o.stdin.end(t.input))})}async function ml(e,t,n){let{argv:r,usesPlaceholder:i}=cl(e,t);return pl(r,{input:i?void 0:t,timeoutMs:n})}async function hl(e,t){let n=Date.now(),r=ll(t.skillBody,e.prompt),i=await ml(t.agent,r,t.timeoutMs),a=i.stdout.trim(),o={id:e.id,prompt:e.prompt,reply:a,agentDurationMs:i.durationMs};if(i.spawnError)return{...o,status:`errored`,error:`Agent command failed to start: ${i.spawnError}`,durationMs:Date.now()-n,assertions:gl(e.assertions)};if(i.timedOut)return{...o,status:`errored`,error:`Agent timed out after ${Math.round(t.timeoutMs/1e3)}s.`,durationMs:Date.now()-n,assertions:gl(e.assertions)};if(a.length===0)return{...o,status:`errored`,error:`Agent returned no output on stdout.`,durationMs:Date.now()-n,assertions:gl(e.assertions)};if(!t.judge)return{...o,status:`unjudged`,durationMs:Date.now()-n,assertions:gl(e.assertions)};let s=0,c=``;for(let r=0;r<2;r+=1){let i=ul(e.prompt,a,e.assertions,r>0),l=await ml(t.judge,i,t.timeoutMs);if(s+=l.durationMs,l.spawnError)return{...o,status:`errored`,error:`Judge command failed to start: ${l.spawnError}`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:gl(e.assertions)};if(l.timedOut)return{...o,status:`errored`,error:`Judge timed out after ${Math.round(t.timeoutMs/1e3)}s.`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:gl(e.assertions)};let u=fl(l.stdout,e.assertions);if(`verdicts`in u){let e=u.verdicts.some(e=>e.verdict===`fail`);return{...o,status:e?`failed`:`passed`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:u.verdicts}}c=u.error}return{...o,status:`errored`,error:`Judge output could not be parsed after a retry: ${c}`,judgeDurationMs:s,durationMs:Date.now()-n,assertions:gl(e.assertions)}}function gl(e){return e.map(e=>({assertion:e,verdict:`unjudged`}))}async function _l(e,t,n){let r=Array(e.length),i=0,a=async()=>{for(;;){let t=i;if(i+=1,t>=e.length)return;r[t]=await n(e[t],t)}},o=Math.max(1,Math.min(t,e.length));return await Promise.all(Array.from({length:o},()=>a())),r}function vl(e){let t={passed:0,failed:0,errored:0,unjudged:0};for(let n of e)t[n.status]+=1;return t}function yl(e){let t=[],n=C(e.subject);n&&t.push(n);let r=e._;if(Array.isArray(r))for(let e of r)typeof e==`string`&&e.length>0&&t.push(e);return[...new Set(t)]}function bl(e){let t=il();if(e.length===0)return t;let n=new Map(t.map(e=>[e.subject,e]));return e.map(e=>{let r=n.get(e);if(!r){let n=t.map(e=>e.subject).join(`, `);throw new m(`INVALID_INPUT`,`Unknown eval subject: ${e}.${n?` Known subjects: ${n}.`:``}`)}return r})}function xl(e){let t=il().map(e=>{let t=al(e.subject,e.path);return{subject:e.subject,evals:t.evals.length}});if(e){P({schemaVersion:1,subjects:t});return}if(t.length===0){process.stdout.write(`No eval subjects found.
|
|
104
104
|
`);return}let n=Math.max(...t.map(e=>e.subject.length));process.stdout.write(`Eval subjects
|
|
105
|
-
`);for(let e of t){let t=e.evals===1?`eval`:`evals`;process.stdout.write(` ${e.subject.padEnd(n)} ${e.evals} ${t}\n`)}}function
|
|
105
|
+
`);for(let e of t){let t=e.evals===1?`eval`:`evals`;process.stdout.write(` ${e.subject.padEnd(n)} ${e.evals} ${t}\n`)}}function Sl(e){return e===`passed`?`PASS`:e===`failed`?`FAIL`:e===`errored`?`ERROR`:`UNJUDGED`}function Cl(e,t){t.judged?process.stdout.write(`Assertion verdicts below are judge verdicts, model judgments from the judge agent, not ground truth.
|
|
106
106
|
|
|
107
107
|
`):process.stdout.write(`Judging was skipped. Review each agent reply against the assertion checklist by hand.
|
|
108
108
|
|
|
109
|
-
`);for(let n of e){process.stdout.write(`# ${n.subject}\n`);for(let e of n.evals)if(process.stdout.write(`\n[${
|
|
110
|
-
`);for(let t of e.assertions)process.stdout.write(` - [ ] ${t.assertion}\n`)}else for(let t of e.assertions){let e=t.verdict===`pass`?`pass`:t.verdict===`fail`?`fail`:`unjudged`;process.stdout.write(` - ${e}: ${t.assertion}\n`),t.reason&&process.stdout.write(` judge verdict: ${t.reason}\n`)}let e=
|
|
109
|
+
`);for(let n of e){process.stdout.write(`# ${n.subject}\n`);for(let e of n.evals)if(process.stdout.write(`\n[${Sl(e.status)}] eval ${e.id} (${e.durationMs}ms)\n`),process.stdout.write(` prompt: ${Tl(e.prompt,100)}\n`),e.error&&process.stdout.write(` error: ${e.error}\n`),!t.judged){process.stdout.write(` reply: ${Tl(e.reply,200)}\n`),process.stdout.write(` assertions to review:
|
|
110
|
+
`);for(let t of e.assertions)process.stdout.write(` - [ ] ${t.assertion}\n`)}else for(let t of e.assertions){let e=t.verdict===`pass`?`pass`:t.verdict===`fail`?`fail`:`unjudged`;process.stdout.write(` - ${e}: ${t.assertion}\n`),t.reason&&process.stdout.write(` judge verdict: ${t.reason}\n`)}let e=vl(n.evals);process.stdout.write(`\nSubject ${n.subject}: ${e.passed} passed, ${e.failed} failed, ${e.errored} errored${e.unjudged?`, ${e.unjudged} unjudged`:``}.\n\n`)}let n=wl(e);process.stdout.write(`Totals: ${n.passed} passed, ${n.failed} failed, ${n.errored} errored${n.unjudged?`, ${n.unjudged} unjudged`:``} across ${n.evals} evals.\n`)}function wl(e){let t={passed:0,failed:0,errored:0,unjudged:0,evals:0};for(let n of e)t.passed+=n.passed,t.failed+=n.failed,t.errored+=n.errored,t.unjudged+=n.unjudged,t.evals+=n.evals.length;return t}function Tl(e,t){let n=e.replace(/\s+/g,` `).trim();return n.length>t?`${n.slice(0,t-1)}…`:n}const El=v({meta:{name:`eval`,description:`Run behaviour evals for the seo skill against a local agent and judge the results`},args:{subject:{type:`positional`,required:!1,description:`Eval subject (report id or job). Omit to run every subject.`},list:{type:`boolean`,default:!1,description:`List eval subjects with their eval counts and exit.`},id:{type:`string`,description:`Run one eval id within a single subject.`},agent:{type:`string`,default:rl,description:`Agent command. Use {prompt} to place the prompt in argv, otherwise it is sent on stdin.`},"judge-agent":{type:`string`,description:`Judge command. Defaults to the same command as --agent.`},judge:Zr(`Judge assertions with an agent.`,`Skip judging and print replies with an assertion checklist.`),skill:Zr(`Send the seo router skill as context before the prompt.`,`Omit the seo router skill context.`),timeout:{type:`string`,default:`300`,description:`Timeout in seconds per agent or judge call.`},concurrency:{type:`string`,default:`1`,description:`Evals to run in parallel (max 4).`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e);if(e.list===!0){xl(t);return}let n=bl(yl(e)),r=T(e.id);if(r!==void 0&&n.length!==1)throw new m(`INVALID_INPUT`,`--id needs exactly one subject. Name the subject to filter.`);let i=T(e.timeout)??300;if(!(i>0))throw new m(`INVALID_INPUT`,`--timeout must be a positive number of seconds.`);let a=Math.max(1,Math.min(4,T(e.concurrency)??1)),o=C(e.agent)??rl,s=e.judge===!1?null:C(e[`judge-agent`])??o,c=e.skill===!1?null:ol(),l={agent:o,judge:s,skillBody:c,timeoutMs:i*1e3},u=[];for(let e of n){let n=al(e.subject,e.path).evals;if(r!==void 0&&(n=n.filter(e=>e.id===r),n.length===0))throw new m(`INVALID_INPUT`,`No eval with id ${r} in subject ${e.subject}.`);t||process.stderr.write(`Running ${n.length} eval${n.length===1?``:`s`} for ${e.subject}...\n`);let i=await _l(n,a,e=>hl(e,l)),o=vl(i);u.push({subject:e.subject,...o,evals:i})}let d=wl(u),ee=d.failed>0||d.errored>0;t?P({schemaVersion:1,agent:o,judge:s,judged:s!==null,skillContext:c!==null,timeoutSeconds:i,concurrency:a,subjects:u,totals:d}):Cl(u,{judged:s!==null,agent:o,judge:s}),ee&&(process.exitCode=1)}});function Dl(){let e=Rc();return lr(e,{withFileTypes:!0}).filter(t=>t.isDirectory()&&g(h(e,t.name,`SKILL.md`))).map(t=>({name:t.name,description:Hc(h(e,t.name)),path:h(e,t.name)})).sort((e,t)=>e.name<t.name?-1:+(e.name>t.name))}function Ol(e){let t=Dl();if(!e)return t;let n=t.find(t=>t.name===e);if(!n)throw new m(`INVALID_INPUT`,`Unknown skill: ${e}.`);return[n]}const kl=v({meta:{name:`list`,description:`Show the packaged SEO skill`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=Dl();if(O(e))P({skills:t});else{Hi(`SEO skill`,`Packaged with this CLI.`),process.stdout.write(`
|
|
111
111
|
`);for(let e of t)F([[`Name`,e.name],[`Purpose`,`Helps agents choose and run the right SEO audit or report.`],[`Path`,e.path]]);process.stdout.write(`
|
|
112
|
-
`),
|
|
113
|
-
`)}}}),
|
|
114
|
-
`),F(Object.entries(t.counts).map(([e,t])=>[e,String(t)]))}}),
|
|
115
|
-
`)):
|
|
112
|
+
`),Vi({title:`Add it to an agent`,body:`Run setup to install the skill and connect your first site.`,command:`seo start`})}}}),Al=v({meta:{name:`path`,description:`Print a packaged agent skill path`},args:{name:{type:`positional`,description:`Skill name. Omit it for the skill directory.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=C(e.name),n=t?Ol(t)[0]?.path:Rc();O(e)?P({name:t,path:n}):process.stdout.write(`${n}\n`)}}),jl=v({meta:{name:`install`,description:`Install the SEO skill for coding agents`},args:{json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:({args:e})=>{let t=O(e),n=ps({quiet:t});if(t)P(n),n.status===`failed`&&(process.exitCode=1);else{if(n.status===`failed`)throw new m(`INTERNAL_ERROR`,`Skill install failed: ${n.error}`);process.stdout.write(`SEO skill installed. Agents that support skills can discover it now.
|
|
113
|
+
`)}}}),Ml=v({meta:{name:`skill`,description:`Inspect the packaged SEO skill and run its evals`},subCommands:{list:kl,path:Al,install:jl,eval:El}}),Nl=v({meta:{name:`privacy`,description:`Show local config, token, cache, and log storage paths`},run:async()=>{let e=In(),t=Nn();F(e.map(e=>[e.label,`${e.path} · ${Xi(e.sizeBytes)} · ${e.mode}`])),process.stdout.write(`
|
|
114
|
+
`),F(Object.entries(t.counts).map(([e,t])=>[e,String(t)]))}}),Pl=v({meta:{name:`reset`,description:`Delete saved credentials and all local data`},args:{yes:{type:`boolean`,default:!1,description:`Confirm deletion without prompting.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e);if(!e.yes&&!N({json:t}))throw new m(`INVALID_INPUT`,`Cannot prompt here. Pass --yes to confirm reset.`);e.yes||L(await Or({message:`Delete saved credentials and all local data?`,initialValue:!1}))?(await On(),t?P({reset:!0}):process.stdout.write(`Reset complete.
|
|
115
|
+
`)):Dr(`Reset aborted.`)}}),Fl=v({meta:{name:`sites`,description:`List Search Console properties available to this Google login`},args:{json:{type:`boolean`,default:!1},refresh:{type:`boolean`,default:!1},account:{type:`string`,description:`Saved Google account email.`}},run:async({args:e})=>{let t=await Ot(w(e.refresh),C(e.account));O(e)?P({sites:t}):I([`Property`,`Permission`],t.map(e=>[e.siteUrl,e.permissionLevel??`unknown`]))}}),Il=v({meta:{name:`updates`,description:`List official Google Search Status ranking updates`},args:{product:{type:`string`,default:`Ranking`},limit:{type:`string`,default:`10`},json:{type:`boolean`,default:!1}},run:async({args:e})=>{let t=await Ae({product:C(e.product),limit:T(e.limit)});O(e)?P({updates:t}):Ki(t.map(e=>({title:e.name,meta:[e.type,e.status,`${e.start.slice(0,10)} to ${e.end?.slice(0,10)??`present`}`]})),{empty:`No matching Google Search updates.`})}}),Ll={ci:`disabled automatically in CI or tests`,do_not_track:`disabled by DO_NOT_TRACK`,environment:`disabled by a telemetry environment variable`,local_setting:`disabled in local settings`,invalid_state:`disabled because the local state file is invalid`};function Rl(e){return{enabled:e.enabled,...e.reason?{reason:e.reason}:{},stateFile:e.stateFile,...e.state?{firstRunAt:e.state.firstRunAt,cohort:e.state.cohort,sentMilestones:e.state.sentMilestones}:{}}}function zl(e,t){let n=Rl(e);t?P(n):(F([[`Anonymous telemetry`,e.enabled?`enabled`:`disabled`],[`Reason`,e.reason?Ll[e.reason]:`local setting`],[`State file`,e.stateFile],[`Install cohort`,e.state?.cohort??`not created`]]),process.stdout.write(`
|
|
116
116
|
Only tool usage is sent. URLs, report data, Google data, and identifiers are never sent.
|
|
117
117
|
`),process.stdout.write(`Details: https://seoskill.dev/telemetry
|
|
118
|
-
`))}const
|
|
118
|
+
`))}const Bl={type:`boolean`,default:!1,description:`Print machine-readable JSON.`},Vl=v({meta:{name:`telemetry`,description:`Check or change anonymous usage telemetry`},subCommands:{status:v({meta:{name:`status`,description:`Show whether anonymous usage telemetry is enabled`},args:{json:Bl},run:async({args:e})=>zl($e(),O(e))}),enable:v({meta:{name:`enable`,description:`Enable anonymous usage telemetry in local settings`},args:{json:Bl},run:async({args:e})=>{zl(nt(!0),O(e))}}),disable:v({meta:{name:`disable`,description:`Disable anonymous usage telemetry in local settings`},args:{json:Bl},run:async({args:e})=>{zl(nt(!1),O(e))}})}});function Hl(e){let t=e.toLowerCase();return[`pass`,`passed`,`complete`,`completed`,`joined`].includes(t)?`pass`:[`warn`,`warning`,`partial`,`review`].includes(t)?`warning`:[`fail`,`failed`,`error`].includes(t)?`fail`:[`unknown`,`unavailable`].includes(t)?`unknown`:`info`}function Ul(e){let t=e.steps.map(e=>Hl(e.status)),n=t.includes(`fail`)?`fail`:t.includes(`warning`)?`warning`:t.includes(`unknown`)?`unknown`:`pass`;Wi({title:e.workflow,target:e.site,status:n,summary:e.summary,metrics:[{label:`Completed`,value:t.filter(e=>e===`pass`).length,status:`pass`},{label:`Review`,value:t.filter(e=>e===`warning`).length,status:`warning`},{label:`Unknown`,value:t.filter(e=>e===`unknown`).length,status:`unknown`}],sections:[{title:`Evidence collection`,diagnostics:e.steps.map(e=>({status:Hl(e.status),title:e.tool,explanation:e.summary,evidence:[`Status: ${e.status}`]}))},{title:`Priority actions`,diagnostics:e.actions.map(e=>({status:`warning`,title:e.title,explanation:`Confidence: ${e.confidence}.`,fix:e.action}))}]})}const Wl=v({meta:{name:`crawl-queue`,description:`Run a crawl and return a ranked implementation queue`},args:{crawlUrl:{type:`positional`,required:!1,description:`Start URL to crawl.`},url:{type:`string`,description:`Start URL to crawl. Defaults to the --site home page.`},site:{type:`string`,description:`GSC property URL for joining page metrics.`},...Za,mode:{type:`string`,description:`Crawl mode: site, page, list, or sitemap. Defaults to site.`},urls:{type:`string`,description:`Comma-separated URLs for list mode.`},"urls-file":{type:`string`,description:`File with one URL per line for list mode.`},"max-pages":{type:`string`,description:`Maximum pages to crawl. Defaults to 500.`},"max-depth":{type:`string`,description:`Maximum click depth. Defaults to 16.`},concurrency:{type:`string`,description:`Parallel page fetches. Defaults to 8.`},"fetch-interval-cap":{type:`string`,description:`Maximum page fetches per interval per host.`},"fetch-interval-ms":{type:`string`,description:`Fetch rate interval in milliseconds.`},refresh:{type:`boolean`,default:!1,description:`Bypass local HTTP cache and fetch fresh pages.`},include:{type:`string`,description:`Comma-separated URL patterns to include.`},exclude:{type:`string`,description:`Comma-separated URL patterns to exclude.`},limit:{type:`string`,description:`Maximum queue items to print. Defaults to 25.`},"no-sitemap":{type:`boolean`,default:!1,description:`Do not seed URLs from sitemap.xml.`},"no-robots":{type:`boolean`,default:!1,description:`Do not skip URLs disallowed by robots.txt.`},"no-external":{type:`boolean`,default:!1,description:`Do not check external links.`},js:{type:`boolean`,default:!1,description:`Force JavaScript rendering when Playwright is installed.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=await ql(e),r=Kl(e),i=C(e.site),a=r??(i?$a(i):void 0)??n[0];if(!a)throw new m(`INVALID_INPUT`,"No crawl URL given. Pass a URL, --url or --site. Run `seo sites` to list your Search Console properties.");let o=await d({url:a,site:i,mode:Gl(e.mode)??(n.length?`list`:void 0),urls:n,maxPages:T(e[`max-pages`]),maxDepth:T(e[`max-depth`]),concurrency:T(e.concurrency),refresh:w(e.refresh),fetchRate:ri({...e,"fetch-concurrency":e.concurrency}),include:D(e.include),exclude:D(e.exclude),googleAnalyticsPropertyId:C(e[`google-analytics-property`]),analyticsConnection:Qa(e),useSitemap:!$r(e,`sitemap`),respectRobots:!$r(e,`robots`),checkExternal:!$r(e,`external`),js:!!w(e.js),limit:T(e.limit)});t?P(o):(Ul(o),I([`Rank`,`Score`,`Rule`,`Severity`,`Affected`,`Target`,`Action`],o.output.queue.map((e,t)=>[t+1,e.score,e.ruleId,e.severity,e.affectedUrls,e.target,e.action])),J(`Implementation queue details`,o.output.queue.map(e=>({label:`${e.ruleId} (${e.affectedUrls} URLs)`,context:`${e.severity}, score ${e.score}`,action:`${e.action} Verify with: ${e.verification.command}`}))))}});function Gl(e){let t=C(e);if(t){if([`site`,`page`,`list`,`sitemap`].includes(t))return t;throw Error(`Mode must be one of: site, page, list, sitemap.`)}}function Kl(e){let t=C(e.crawlUrl),n=C(e.url);if(t&&n&&t!==n)throw Error(`Use either a URL argument or --url, not both.`);return t??n}async function ql(e){let t=D(e.urls)??[],n=C(e[`urls-file`]);return n&&t.push(...Jl(await _(n,`utf8`))),[...new Set(t)]}function Jl(e){return e.split(/[\n,]/).map(e=>e.trim()).filter(e=>e&&!e.startsWith(`#`))}const Yl=v({meta:{name:`refresh-priorities`,description:`Agent workflow for a ranked SEO action queue`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum queue items to print. Defaults to 25.`}}),...Za,"verify-content":Zr(`Verify top opportunities against page title, meta, and content. Defaults to true.`,`Skip page content verification.`),"verify-limit":{type:`string`,description:`Maximum opportunity URLs to verify. Defaults to 5.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=k(C(e.site)),r=await Ge({site:n,days:T(e.days),recentDays:T(e.recent),limit:T(e.limit),includeBrand:w(e[`include-brand`]),googleAnalyticsPropertyId:C(e[`google-analytics-property`]),analyticsConnection:Qa(e),verifyContent:w(e[`verify-content`]),verifyLimit:T(e[`verify-limit`]),refresh:w(e.refresh)});t?P(r):(Ul(r),I([`Source`,`Category`,`Score`,`Findings`,`Template`,`Analytics`,`Target`,`Action`],r.output.queue.map(e=>[e.source,e.category,e.score,e.grouped?.count??1,e.template?.label??`-`,e.analytics?.sessions??`-`,e.target,e.action])),J(`Queue action details`,r.output.queue.map(e=>({label:e.target,context:`${e.category}, score ${e.score}`,action:e.action}))))}});function Xl(e){return e===null?`-`:e.toLocaleString(`en-GB`,{maximumFractionDigits:e>=100?0:1})}function Zl(e){return[...e.winners.map(e=>({direction:`winner`,item:e})),...e.losers.map(e=>({direction:`loser`,item:e}))]}function Ql(e,t){let n=Zl(t);n.length&&(process.stdout.write(`\n${e}\n`),I([`Direction`,`Key`,`Clicks`,`Impr.`,`Position`],n.map(({direction:e,item:t})=>[e,t.key,Xl(t.clickDelta),Xl(t.impressionDelta),Xl(t.positionDelta)])))}function $l(e){process.stdout.write(`
|
|
119
119
|
Segment coverage
|
|
120
|
-
`),I([`Dimension`,`Eligible`,`Returned`,`Limited`,`Result cap`,`Source cap`,`Source capped`],[`page`,`query`,`device`,`country`].map(t=>{let n=e[t].coverage;return[t,n.eligibleRows,n.returnedRows,n.limitedRows,n.resultLimit,n.sourceRowLimit,n.sourcePossiblyTruncated?`yes`:`no`]}))}function
|
|
120
|
+
`),I([`Dimension`,`Eligible`,`Returned`,`Limited`,`Result cap`,`Source cap`,`Source capped`],[`page`,`query`,`device`,`country`].map(t=>{let n=e[t].coverage;return[t,n.eligibleRows,n.returnedRows,n.limitedRows,n.resultLimit,n.sourceRowLimit,n.sourcePossiblyTruncated?`yes`:`no`]}))}function eu(e){e.length&&(process.stdout.write(`
|
|
121
121
|
Template movement
|
|
122
|
-
`),I([`Direction`,`Template`,`Pattern confidence`,`URLs`,`Clicks`,`Returned share`,`Common terms`],e.map(e=>[e.direction,e.signature,e.confidence,e.urlCount,
|
|
122
|
+
`),I([`Direction`,`Template`,`Pattern confidence`,`URLs`,`Clicks`,`Returned share`,`Common terms`],e.map(e=>[e.direction,e.signature,e.confidence,e.urlCount,Xl(e.clickDelta),`${Math.round(e.movementShare*100)}%`,e.commonTerms.join(`, `)||`-`])),Y(`Template actions`,e.map(e=>e.summary)),Y(`Template evidence scope`,[`Shares use returned directional page click movement. Pattern confidence applies only to returned matched-retained page segments.`]))}const tu=v({meta:{name:`update-postmortem`,description:`Agent workflow for Google update winner/loser analysis`},args:{site:{type:`string`,description:`GSC property URL, for example sc-domain:example.com.`},...X([`days`,`recentDays`,`limit`,`includeBrand`,`refresh`],{days:{description:`Diagnosis window length in days. Defaults to 90.`},limit:{description:`Maximum winners/losers per segment. Defaults to 20.`}}),"known-change":{type:`string`,description:`Manual site-side change to treat as a confounder, for example pruning pages or blocking traffic.`},json:{type:`boolean`,default:!1,description:`Print machine-readable JSON.`}},run:async({args:e})=>{let t=O(e),n=k(C(e.site)),r=await Bn({site:n,days:T(e.days),recentDays:T(e.recent),limit:T(e.limit),includeBrand:w(e[`include-brand`]),knownConfounders:C(e[`known-change`])?[C(e[`known-change`])??``]:void 0,refresh:w(e.refresh)});t?P(r):(K({title:`Update postmortem`,target:r.site,status:`unknown`,summary:r.summary,metrics:[{label:`Attribution`,value:r.output.update.attribution.replaceAll(`-`,` `)},{label:`Confidence`,value:r.output.update.confidence},{label:`Known confounders`,value:r.output.update.confounders.length}]}),Y(`Recommended actions`,r.actions.map(e=>`${e.title} (${e.confidence}): ${e.action}`)),Y(`Postmortem findings`,r.output.insights.map(e=>e.summary)),Y(`Segment evidence warnings`,[...r.output.segments.page.warnings,...r.output.segments.query.warnings,...r.output.segments.device.warnings,...r.output.segments.country.warnings].filter((e,t,n)=>n.indexOf(e)===t)),eu(r.output.templateMovement),Y(`Update evidence`,r.output.update.evidence),$l(r.output.segments),Ql(`Page winners and losers`,r.output.segments.page),Ql(`Query winners and losers`,r.output.segments.query),Ql(`Device winners and losers`,r.output.segments.device),Ql(`Country winners and losers`,r.output.segments.country),Ia(`seo export update-postmortem --site ${JSON.stringify(n)}`))}}),nu=/* @__PURE__ */ new Set([`database`,`filesystem`,`internal`,`unknown`]);function ru(e){return e.replace(/^v/,``).split(`.`)[0]||`unknown`}function iu(e){return Re(e[0])?e[0]:void 0}function au(e,t){return Xe(e)?`seo ${e}`:t?`seo ${t}`:`seo command`}function ou(e){let t=dt(e.error);if(!nu.has(t.errorCategory))return;let n=iu(e.args),r=au(e.report,n),i=[Tt(e.error).code,t.errorCategory,t.failureReason,t.failureContext].filter(Boolean).join(` | `),a=new URL(`https://github.com/iannuttall/seo/issues/new`);return a.searchParams.set(`template`,`bug.yml`),a.searchParams.set(`title`,`bug: ${r} failed`),a.searchParams.set(`version`,e.version??at),a.searchParams.set(`runtime`,`Node ${ru(e.nodeVersion??process.version)} on ${e.processPlatform??Xn()} (${e.processArch??Jn()})`),a.searchParams.set(`diagnostics`,i),a.toString()}const su={"refresh-priorities":`seo report`,"query-cluster":`seo report`,"quick-wins":`seo report --section quick-wins`,"ctr-underperformers":`seo report --section low-ctr`,"striking-distance":`seo report --section striking-distance`,"second-page":`seo report --section second-page`,decaying:`seo report --section content-decay`,cannibal:`seo report --section cannibalization`,"traffic-anomaly":`seo report --section traffic-drop`,"page-opportunities":`seo page --url <url>`,"audit-page":`seo page --url <url>`,"url-inspect":`seo page --url <url>`,"segment-impact":`seo compare --date <date>`,"update-correlate":`seo compare --date <date>`,"update-postmortem":`seo compare --date <date>`,"link-recover":`seo index`,"gsc-query":`seo data`},cu={"agent-readiness":null,"ai-readiness":null,"community-intent":null,"entity-readiness":null,llms:null,"monthly-report":`seo report`,okf:null,pseo:null,"report-narrative":`seo report`,"seo-to-ai-query":null,"server-logs":null,links:`seo research backlinks --target <domain>`,"export knowledge":null,"export monthly":`seo report --json`,"export narrative":`seo report --json`,"export pseo":null,indexnow:null,"providers semrush":`seo providers`,"providers limits":null,"providers spend":null,"providers dataforseo limits":null,"providers dataforseo spend":null,"providers ahrefs limits":null,"change-log":null,client:null,project:null,projects:null,"content-groups":null,"crawl-diff":`seo crawl`,"crawl-reports":`seo crawl`,diagnose:`seo report`,"diagnose-property":`seo report`,"export diagnose":`seo report --json`,"index-watch":`seo page --url <url>`,monitoring:`seo crawl`,schedule:null,"technical-watch":`seo crawl`,tests:`seo compare --date <date>`},Z=`It saved history between runs. Your agent keeps its own notes now.`,lu=`Commands take --site now instead of a saved project.`,uu=`Spend is controlled in your provider account. Set limits in DataForSEO, Ahrefs or the other provider.`,du={"providers limits":uu,"providers spend":uu,"providers dataforseo limits":uu,"providers dataforseo spend":uu,"providers ahrefs limits":uu,"change-log":Z,client:lu,project:lu,projects:lu,"content-groups":Z,"crawl-diff":Z,"crawl-reports":Z,diagnose:Z,"diagnose-property":Z,"export diagnose":Z,"index-watch":Z,monitoring:Z,schedule:Z,"technical-watch":Z,tests:Z},fu=/* @__PURE__ */ new Set([`client`,`project`,`projects`]);function pu(e){let t=e.findIndex(e=>e.startsWith(`-`)),n=t===-1?e:e.slice(0,t),r=+(n[0]===`help`);for(let e=3;e>=1;--e){let t=n.slice(r,r+e).join(` `);if(n.length-r>=e&&Object.hasOwn(cu,t))return t}return null}function mu(e){let t=Object.hasOwn(su,e)?su[e]:void 0;return t?`\`seo ${e}\` is now \`${t}\`. The old name stops working in 1.0.0.`:null}function hu(e){let t=pu(e);if(!t)return null;let n=cu[t],r=t.split(` `)[0]??``,i=n?`Use \`${n}\` instead.`:fu.has(r)?"Run `seo sites` to list your Search Console properties.":r===`providers`?"Run `seo providers --help` for the provider commands.":"Run `seo help` for the commands.";return`\`seo ${t}\` was removed. ${Object.hasOwn(du,t)?du[t]:`SEO Skill now focuses on Search Console, analytics and keyword data.`} ${i}`}const gu={"internal-links":[`--days`,`--limit`,`--check-limit`,`--min-impressions`,`--brand-terms`,`--include-brand`,`--no-include-brand`,`--js`,`--no-js`,`--fetch-concurrency`,`--fetch-interval-cap`,`--fetch-interval-ms`]},_u=e=>e.split(`=`)[0]??``;function vu(e){let t=e.find(e=>[`--project`,`--client`].includes(_u(e)));if(t)return`\`${_u(t)}\` was removed. ${lu} Pass --site with a domain, URL or sc-domain: property, or run \`seo sites\` to list your Search Console properties.`;let n=e[0]??``,r=Object.hasOwn(gu,n)?e.find(e=>gu[n]?.includes(_u(e))):void 0;if(!r)return null;let i=_u(r);return`\`${i}\` was removed from \`seo ${n}\`. It now sets its own limits, brand terms and page fetching, and shows them in the output.${i===`--days`?` Pass --start-date and --end-date for other dates.`:``}`}function yu(e){return e.replaceAll(`\\`,`/`).toLowerCase()}function bu(e,t){return t===`win32`?`${e}.cmd`:e}function xu(e,t=process.platform){let n=yu(e);if(!(n.includes(`/_npx/`)||n.includes(`/.npm/_npx/`)||n.includes(`/.cache/pnpm/dlx/`)||n.includes(`/.volta/`))){if(n.includes(`/.pnpm/`)||n.includes(`/pnpm/global/`))return{command:bu(`pnpm`,t),args:[`add`,`--global`,`seo@latest`]};if(n.includes(`/.bun/install/global/`))return{command:bu(`bun`,t),args:[`add`,`--global`,`seo@latest`]};if(n.includes(`/.config/yarn/global/`))return{command:bu(`yarn`,t),args:[`global`,`add`,`seo@latest`]};if(n.includes(`/node_modules/seo/`))return{command:bu(`npm`,t),args:[`install`,`--global`,`seo@latest`]}}}function Su(e){return!(!e.stdinIsTty||!e.stdoutIsTty||e.env.CI||e.env.NO_UPDATE_NOTIFIER||e.env.NODE_ENV===`test`||e.env.npm_lifecycle_event||e.env.npm_execpath||e.env.TERM===`dumb`||e.argv.includes(`--json`)||e.argv.some(e=>[`--help`,`-h`,`--version`,`-v`].includes(e))||[`help`,`mcp`].includes(e.argv[0]??``))}function Cu(e){if(e)try{return ur(e)}catch{return e}}async function wu(e){let t=await Nr({message:`seo ${e.update.latest} is available. You have ${e.update.current}.`,options:[{value:`update`,label:`Update now`,hint:[e.command.command,...e.command.args].join(` `)},{value:`later`,label:`Later`}],initialValue:`later`});return kr(t)?`later`:t}function Tu(e){return ko(e.command,e.args,{stdio:`inherit`}).status}async function Eu(e,t={}){if(!Su({argv:t.argv??process.argv.slice(2),env:t.env??process.env,stdinIsTty:t.stdinIsTty??!!process.stdin.isTTY,stdoutIsTty:t.stdoutIsTty??!!process.stdout.isTTY}))return;let n=Cu(t.cliPath??process.argv[1]),r=n?xu(n,t.platform??process.platform):void 0;if(!r)return;let i=(t.createNotifier??(e=>Ur({pkg:e,shouldNotifyInNpmScript:!1})))(e).update;if(i&&Ct(i.current,i.latest)&&await(t.prompt??wu)({command:r,update:i})!==`later`)return(t.run??Tu)(r)===0?(Ar.success(`Updated seo to ${i.latest}. Run your command again.`),0):(Ar.error(`The update failed. Your current version is unchanged.`),1)}function Du(e){if(process.stderr.isTTY&&!process.env.CI&&!(e.includes(`--json`)||e[0]===`mcp`))try{let{configDir:e,configFile:t}=jt();if(!g(t))return;let n=h(e,`notices.json`),r=g(n)?JSON.parse(cr(n,`utf8`)):[];if(r.includes(`0.4`))return;process.stderr.write(`
|
|
123
123
|
SEO Skill 0.4: eight commands replace the old reports, and projects are gone: every command takes --site (run \`seo sites\` to list yours). Old command names print what to use instead.
|
|
124
124
|
Free hosted MCP server, nothing to install: https://seoskill.dev/docs/mcp
|
|
125
125
|
To stay on the old version: npm i -g seo@0.2.41
|
|
126
126
|
What changed: https://github.com/iannuttall/seo/blob/main/CHANGELOG.md
|
|
127
127
|
|
|
128
|
-
`),
|
|
129
|
-
`),
|
|
130
|
-
`),
|
|
128
|
+
`),mr(n,JSON.stringify([...r,`0.4`]),{mode:384})}catch{}}const Ou={name:`seo`,version:at},ku=[{title:`Start here`,commands:[[`seo start`,`Sign in with Google, then add the MCP server and skill`],[`seo report`,`Last week across your audited sites (beta, after seo login)`],[`seo report --site <site>`,`One site: overview and every section`],[`seo report --site <site> --section quick-wins`,`One section of the report, with live page checks`]]},{title:`Commands`,commands:[[`seo page --url <url>`,`One page: live facts, index status, queries`],[`seo compare --date <date>`,`Before and after a date`],[`seo index`,`Pages that lost most of their clicks`],[`seo research <action>`,`Keyword, SERP, competitor and backlink data from your key`],[`seo data`,`Raw Search Console, Bing or Clicky rows`],[`seo crawl`,`Crawl a site and list technical issues`],[`seo internal-links`,`Pages that could link to a target page`],[`seo lint <files>`,`Check copy for AI writing patterns and length`],[`seo site new <folder>`,`Start a data-driven site on Astro and Cloudflare`]]},{title:`Setup`,commands:[[`seo login`,`Use your seoskill.dev account on this machine`],[`seo sites`,`List Search Console properties`],[`seo mcp install`,`Add the local MCP server to your agents`],[`seo providers`,`Connect DataForSEO or Ahrefs`],[`seo doctor`,`Check local auth and config`]]}],Au=[...ku,{title:`More commands`,commands:[[`seo crawl-queue`,`Run a crawl and rank the fix queue`],[`seo rules`,`List crawler rule ids`],[`seo explain --rule missing_title`,`Explain a crawler rule`],[`seo redirect-trace`,`Trace redirects`],[`seo perf audit`,`Run a page performance audit`],[`seo index-coverage`,`Choose pages for URL Inspection`],[`seo ai-referrals`,`AI referral traffic in Google Analytics`],[`seo analytics google report`,`Google Analytics landing pages for visits from search`],[`seo updates`,`List official Google ranking updates`],[`seo export`,`Export report data to CSV`],[`seo reports list`,`List every structured report`],[`seo skill list`,`Show the packaged SEO skill`],[`seo auth`,`Manage Google auth`],[`seo cache`,`Manage local cache`],[`seo privacy`,`Show local storage paths`],[`seo telemetry status`,`Check anonymous usage telemetry`],[`seo reset`,`Delete saved credentials and all local data`]]}];function ju(e){Hi(`seo v${Ou.version}`,`Your own Search Console, Google Analytics and Bing data, as facts for your agent.`),process.stdout.write(`
|
|
129
|
+
`),Gi(e.flatMap(e=>e.commands.map(([t,n])=>({category:e.title,id:t,name:n}))),{noun:`command`,categoryLabels:Object.fromEntries(e.map(e=>[e.title,e.title]))}),process.stdout.write(`
|
|
130
|
+
`),qi(`More help`,"Use `seo help <command>` or `seo <command> --help` for command help.","Use `seo help all` for the longer command list.")}const Mu=v({meta:{name:`seo`,version:Ou.version,description:`Local-first SEO CLI and MCP server`},subCommands:{init:ks,analytics:Sa,auth:ka,mcp:Ns,doctor:$s,privacy:Nl,telemetry:Vl,reset:Pl,cache:Ma,logs:As,crawl:ro,"crawl-queue":Wl,content:La,providers:Ec,export:Oo,"index-coverage":Ps,"link-recover":Fs,rules:Ic,explain:Lc,"refresh-priorities":Yl,"redirect-trace":Is,skill:Ml,start:Os,setup:Ds,site:nl,login:ls,logout:fs,report:na,page:ra,compare:ia,index:aa,data:oa,research:sa,lint:ca,reports:Fc,"segment-impact":tc,"striking-distance":rc,"update-postmortem":tu,sites:Fl,"gsc-query":po,"url-inspect":mo,updates:Il,"traffic-anomaly":vo,"update-correlate":yo,"ai-referrals":Ls,"audit-page":Js,"second-page":qs,cannibal:Rs,decaying:Vs,"quick-wins":Ks,"page-opportunities":Ws,perf:Qs,"internal-links":Us,"ctr-underperformers":zs,"query-cluster":Gs},run:async()=>{process.argv.slice(2).length===0&&process.stdout.write("Use `seo start` to set up, then `seo report` for the main report.\n")}}),Nu={cannibal:`cannibalisation`,crawl:`site-crawl`,"crawl-queue":`top-fixes`,decaying:`decaying-pages`,doctor:`setup-check`,explain:`explain-crawl-issue`,"link-recover":`link-recovery`,"query-cluster":`query-clusters`,report:`search-performance-overview`,rules:`crawler-rules`,"update-correlate":`update-correlation`},Pu=/* @__PURE__ */ new Set([`ai-referrals`,`audit-page`,`ctr-underperformers`,`index-coverage`,`internal-links`,`page-opportunities`,`quick-wins`,`redirect-trace`,`refresh-priorities`,`second-page`,`segment-impact`,`striking-distance`,`traffic-anomaly`,`update-postmortem`]),Fu=new Set(ln().map(e=>e.id));function Iu(e,t){let n=e.indexOf(t);return n>=0?e[n+1]:e.find(e=>e.startsWith(`${t}=`))?.slice(t.length+1)}function Lu(e){let[t,n,r]=e;if(t)return t in yn?se(t,{section:Iu(e,`--section`),action:n})??void 0:t===`reports`&&n===`run`?r&&Fu.has(r)?r:void 0:t===`content`&&n===`optimize`?`content-optimization`:t===`perf`&&n===`audit`?`performance-audit`:Nu[t]??(Pu.has(t)?t:void 0)}const Ru=process.argv.slice(2);function zu(e){let t=e[1];return t&&[`list`,`describe`,`run`,`-h`,`--help`].includes(t)?e:t===void 0?[`reports`,`list`]:t.startsWith(`-`)?(process.stderr.write("Running `seo report`: `seo reports` lists reports.\n"),[`report`,...e.slice(1)]):[`reports`,`run`,...e.slice(1)]}const Q=Ru[0]===`mcp`&&(Ru[1]===void 0||/^-(?!h$|-help$)/.test(Ru[1]))&&!process.stdin.isTTY?[`mcp`,`serve`,...Ru.slice(1)]:Ru[0]===`reports`?zu(Ru):Ru;Du(Q);const Bu=hu(Q)??vu(Q);Bu&&(process.stderr.write(`${Bu}\n`),process.exit(2));const Vu=mu(Q[0]??``);Vu&&!Q.some(e=>[`--help`,`-h`].includes(e))&&process.stderr.write(`${Vu}\n`);const Hu={agent:s()},Uu=Q[0]===`telemetry`,Wu=Q[0]===`mcp`&&Q[1]===`serve`;!Uu&&!Wu&&de(Hu),Wu||Qt();const Gu=await Eu(Ou,{argv:Q});Gu!==void 0&&process.exit(Gu),(Q.length===0||Q.length===1&&[`help`,`--help`,`-h`].includes(Q[0]??``))&&(ju(ku),process.exit(0)),Q[0]===`help`&&Q[1]===`all`&&(ju(Au),process.exit(0));const $=Q[0]===`help`&&Q.length>1?[...Q.slice(1),`--help`]:Q;$!==Q&&(process.argv=[process.argv[0]??`node`,process.argv[1]??`seo`,...$]);const Ku=$.some(e=>[`--help`,`-h`].includes(e)),qu=Q.length===1&&[`--version`,`-v`].includes(Q[0]??``),Ju=Ku||qu?void 0:Lu($);if(Ku||qu)await Er(Mu);else{Ju&&_e(Ju,Hu);let e=Q.includes(`--json`);try{await Tr(Mu,{rawArgs:$}),Ju&&be(Ju,Hu),[`init`,`setup`,`start`].includes($[0]??``)&&!$.includes(`--dry-run`)&&ct(Hu)}catch(t){if(t?.code===`E_NO_COMMAND`&&await Er(Mu,{rawArgs:[...$,`--help`]}),Ju)gn(Ju,t,Hu);else if(!Uu){let e=iu($);e&&ce(e,t,Hu)}let n=Tt(t);if(e){let e=Qt();process.stdout.write(`${JSON.stringify({...Sn(n),...e?{updateNotice:e}:{}},null,2)}\n`)}else{process.stderr.write(`Error: ${n.message}\n`);let e=ou({args:$,error:t,report:Ju});e&&process.stderr.write(`Report this bug: ${e}\n`)}process.exitCode=n.exitCode}let t=e||Wu?void 0:Qt();t&&process.stderr.write(`\n${t}\n`)}export{};
|
|
131
131
|
//# sourceMappingURL=cli.js.map
|