@koda-sl/baker-cli 0.13.0 → 0.16.0

package/dist/commands/research/autocomplete.js

@@ -0,0 +1,73 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../client.js";
+import { buildResearchQueryContext, warnDefaults } from "../../geo-context.js";
+import { registerSchema } from "../../schemas.js";
+import { handleResearchError, RESEARCH_DATA_NOTE, writeResearchJson, writeResearchOutput } from "./output.js";
+registerSchema({
+    command: "research.autocomplete",
+    description: "Get Google Autocomplete suggestions for a seed keyword. Useful for keyword expansion and discovering what people actually search for. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en).",
+    args: {
+        keyword: { type: "string", description: "Seed keyword (positional)", required: true },
+        location: {
+            type: "string",
+            description: "Country code (us, uk, es, de...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted",
+            required: false,
+        },
+        language: {
+            type: "string",
+            description: "Language code or name. DEFAULTS TO en (English) if omitted",
+            required: false,
+        },
+        limit: { type: "string", description: "Max suggestions (default: 10, max: 20)", required: false },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+});
+const FIELDS = {
+    suggestion: "Autocomplete suggestion from Google",
+};
+export const autocompleteCommand = defineCommand({
+    meta: {
+        name: "autocomplete",
+        description: `Get Google Autocomplete suggestions for keyword expansion.
+
+Examples:
+  baker research autocomplete "running shoes"
+  baker research autocomplete "crm" --location uk --limit 5`,
+    },
+    args: {
+        keyword: { type: "positional", description: "Seed keyword", required: true },
+        location: { type: "string", description: "Country code or location code (default: us)", required: false },
+        language: { type: "string", description: "Language code or name (default: en)", required: false },
+        limit: { type: "string", description: "Max suggestions (default: 10, max: 20)", required: false },
+        output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+    run: async ({ args }) => {
+        const keyword = args.keyword;
+        const location = args.location || undefined;
+        const language = args.language || undefined;
+        const limit = args.limit ? Number(args.limit) : undefined;
+        const skipCache = args["no-cache"] ? true : undefined;
+        const queryContext = buildResearchQueryContext(location, language);
+        try {
+            const data = await apiPost("/api/research/autocomplete", {
+                keyword,
+                location,
+                language,
+                limit,
+                skipCache,
+            });
+            warnDefaults(queryContext);
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeResearchOutput(data, format);
+                return;
+            }
+            writeResearchJson({ ok: true, data, fields: FIELDS, note: RESEARCH_DATA_NOTE, query_context: queryContext });
+        }
+        catch (err) {
+            handleResearchError(err);
+        }
+    },
+});
+//# sourceMappingURL=autocomplete.js.map

package/dist/commands/research/autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.js","sourceRoot":"","sources":["../../../src/commands/research/autocomplete.ts"],"names":[],"mappings":"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"}

package/dist/commands/research/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/research/index.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,eAAe,qDA8B1B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/research/index.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,eAAe,qDAoC1B,CAAC"}

package/dist/commands/research/index.js

@@ -1,11 +1,13 @@
 import { defineCommand } from "citty";
 import { advertisersCommand } from "./advertisers.js";
+import { autocompleteCommand } from "./autocomplete.js";
 import { countriesCommand } from "./countries.js";
 import { intentCommand } from "./intent.js";
 import { keywordGapCommand } from "./keyword-gap.js";
 import { keywordsForSiteCommand } from "./keywords-for-site.js";
 import { languagesCommand } from "./languages.js";
 import { lighthouseCommand } from "./lighthouse.js";
+import { relevantPagesCommand } from "./relevant-pages.js";
 export const researchCommand = defineCommand({
     meta: {
         name: "research",
@@ -13,28 +15,34 @@ export const researchCommand = defineCommand({
 
 Commands:
   advertisers        — Who's bidding on a keyword?
+  autocomplete       — Google Autocomplete suggestions
   intent             — Google Search intent classification
   keywords-for-site  — Keywords a domain bids on
   keyword-gap        — Keywords they have that we don't
+  relevant-pages     — Top pages of a competitor domain
   lighthouse         — Landing page performance audit
   countries          — List supported country codes
   languages          — List supported language codes
 
 Examples:
   baker research advertisers "running shoes"
+  baker research autocomplete "running shoes"
   baker research intent "buy running shoes,best running shoes 2026"
   baker research keywords-for-site "competitor.com"
   baker research keyword-gap "them.com" "us.com"
+  baker research relevant-pages "competitor.com"
   baker research lighthouse "https://example.com/landing"`,
     },
     subCommands: {
         advertisers: advertisersCommand,
+        autocomplete: autocompleteCommand,
         countries: countriesCommand,
         intent: intentCommand,
         "keywords-for-site": keywordsForSiteCommand,
         "keyword-gap": keywordGapCommand,
         languages: languagesCommand,
         lighthouse: lighthouseCommand,
+        "relevant-pages": relevantPagesCommand,
     },
 });
 //# sourceMappingURL=index.js.map

package/dist/commands/research/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/research/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;;;;;;;;;;;;;0DAgByC;KACvD;IACD,WAAW,EAAE;QACX,WAAW,EAAE,kBAAkB;QAC/B,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,mBAAmB,EAAE,sBAAsB;QAC3C,aAAa,EAAE,iBAAiB;QAChC,SAAS,EAAE,gBAAgB;QAC3B,UAAU,EAAE,iBAAiB;KAC9B;CACF,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/research/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;0DAoByC;KACvD;IACD,WAAW,EAAE;QACX,WAAW,EAAE,kBAAkB;QAC/B,YAAY,EAAE,mBAAmB;QACjC,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;QACrB,mBAAmB,EAAE,sBAAsB;QAC3C,aAAa,EAAE,iBAAiB;QAChC,SAAS,EAAE,gBAAgB;QAC3B,UAAU,EAAE,iBAAiB;QAC7B,gBAAgB,EAAE,oBAAoB;KACvC;CACF,CAAC,CAAC"}

package/dist/commands/research/relevant-pages.d.ts

@@ -0,0 +1,34 @@
+export declare const relevantPagesCommand: import("citty").CommandDef<{
+    readonly target: {
+        readonly type: "positional";
+        readonly description: "Domain to analyze";
+        readonly required: true;
+    };
+    readonly location: {
+        readonly type: "string";
+        readonly description: "Country code or location code (default: us)";
+        readonly required: false;
+    };
+    readonly language: {
+        readonly type: "string";
+        readonly description: "Language code or name (default: en)";
+        readonly required: false;
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max results (default: 20, max: 1000)";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|csv|md|jsonl";
+        readonly required: false;
+        readonly default: "json";
+    };
+    readonly "no-cache": {
+        readonly type: "boolean";
+        readonly description: "Skip server cache, hit API directly";
+        readonly required: false;
+    };
+}>;
+//# sourceMappingURL=relevant-pages.d.ts.map

package/dist/commands/research/relevant-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relevant-pages.d.ts","sourceRoot":"","sources":["../../../src/commands/research/relevant-pages.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6C/B,CAAC"}

package/dist/commands/research/relevant-pages.js

@@ -0,0 +1,76 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../client.js";
+import { buildResearchQueryContext, warnDefaults } from "../../geo-context.js";
+import { registerSchema } from "../../schemas.js";
+import { handleResearchError, RESEARCH_DATA_NOTE, writeResearchJson, writeResearchOutput } from "./output.js";
+registerSchema({
+    command: "research.relevant-pages",
+    description: "Get the top pages of a competitor domain with organic traffic and ranking data. Shows which pages drive the most traffic. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en).",
+    args: {
+        target: { type: "string", description: "Domain to analyze (positional, e.g. competitor.com)", required: true },
+        location: {
+            type: "string",
+            description: "Country code (us, uk, es, de...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted",
+            required: false,
+        },
+        language: {
+            type: "string",
+            description: "Language code or name. DEFAULTS TO en (English) if omitted",
+            required: false,
+        },
+        limit: { type: "string", description: "Max results (default: 20, max: 1000)", required: false },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+});
+const FIELDS = {
+    page: "Page URL",
+    etv: "Estimated monthly organic traffic",
+    keywords: "Total organic keywords the page ranks for",
+    top_10: "Keywords in positions 1-10",
+};
+export const relevantPagesCommand = defineCommand({
+    meta: {
+        name: "relevant-pages",
+        description: `Get the top pages of a competitor domain with traffic data.
+
+Examples:
+  baker research relevant-pages "competitor.com"
+  baker research relevant-pages "competitor.com" --location es --limit 10`,
+    },
+    args: {
+        target: { type: "positional", description: "Domain to analyze", required: true },
+        location: { type: "string", description: "Country code or location code (default: us)", required: false },
+        language: { type: "string", description: "Language code or name (default: en)", required: false },
+        limit: { type: "string", description: "Max results (default: 20, max: 1000)", required: false },
+        output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+    run: async ({ args }) => {
+        const target = args.target;
+        const location = args.location || undefined;
+        const language = args.language || undefined;
+        const limit = args.limit ? Number(args.limit) : undefined;
+        const skipCache = args["no-cache"] ? true : undefined;
+        const queryContext = buildResearchQueryContext(location, language);
+        try {
+            const data = await apiPost("/api/research/relevant-pages", {
+                target,
+                location,
+                language,
+                limit,
+                skipCache,
+            });
+            warnDefaults(queryContext);
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeResearchOutput(data, format);
+                return;
+            }
+            writeResearchJson({ ok: true, data, fields: FIELDS, note: RESEARCH_DATA_NOTE, query_context: queryContext });
+        }
+        catch (err) {
+            handleResearchError(err);
+        }
+    },
+});
+//# sourceMappingURL=relevant-pages.js.map

package/dist/commands/research/relevant-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relevant-pages.js","sourceRoot":"","sources":["../../../src/commands/research/relevant-pages.ts"],"names":[],"mappings":"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"}

package/dist/env.d.ts

@@ -2,6 +2,8 @@ type Env = {
     BAKER_API_KEY: string;
     BAKER_API_URL: string;
     BAKER_GOOGLE_ADS_CUSTOMER_ID?: string;
+    BAKER_GA4_PROPERTY_ID?: string;
+    BAKER_GSC_SITE_URL?: string;
 };
 export declare function getEnv(): Env;
 export {};

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,KAAK,GAAG,GAAG;IACT,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B,CAAC,EAAE,MAAM,CAAC;CACvC,CAAC;AAIF,wBAAgB,MAAM,IAAI,GAAG,CAe5B"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAGA,KAAK,GAAG,GAAG;IACT,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAIF,wBAAgB,MAAM,IAAI,GAAG,CAiB5B"}

package/dist/env.js

@@ -11,6 +11,8 @@ export function getEnv() {
                     .string()
                     .regex(/^\d{10}$/)
                     .optional(),
+                BAKER_GA4_PROPERTY_ID: z.string().optional(),
+                BAKER_GSC_SITE_URL: z.string().optional(),
             },
             runtimeEnv: process.env,
         });

package/dist/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,IAAI,MAAuB,CAAC;AAE5B,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,SAAS,CAAC;YACjB,MAAM,EAAE;gBACN,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,+BAA+B,CAAC;gBAC5E,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,mCAAmC,CAAC;gBACzD,4BAA4B,EAAE,CAAC;qBAC5B,MAAM,EAAE;qBACR,KAAK,CAAC,UAAU,CAAC;qBACjB,QAAQ,EAAE;aACd;YACD,UAAU,EAAE,OAAO,CAAC,GAAG;SACxB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,IAAI,MAAuB,CAAC;AAE5B,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,SAAS,CAAC;YACjB,MAAM,EAAE;gBACN,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,+BAA+B,CAAC;gBAC5E,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,mCAAmC,CAAC;gBACzD,4BAA4B,EAAE,CAAC;qBAC5B,MAAM,EAAE;qBACR,KAAK,CAAC,UAAU,CAAC;qBACjB,QAAQ,EAAE;gBACb,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC5C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC1C;YACD,UAAU,EAAE,OAAO,CAAC,GAAG;SACxB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/error-handler.d.ts

@@ -0,0 +1,8 @@
+type ConnectionPlatform = "google_ads" | "ga4" | "gsc";
+/**
+ * Shared error handler for "No Connection" scenarios.
+ * Provides a structured error for AI agents with a suggested fix and alternative commands.
+ */
+export declare function handleConnectionError(platform: ConnectionPlatform, originalMessage?: string): never;
+export {};
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAEA,KAAK,kBAAkB,GAAG,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAkCnG"}

package/dist/error-handler.js

@@ -0,0 +1,37 @@
+import { writeJsonEnvelope } from "./commands/ads/output.js";
+/**
+ * Shared error handler for "No Connection" scenarios.
+ * Provides a structured error for AI agents with a suggested fix and alternative commands.
+ */
+export function handleConnectionError(platform, originalMessage) {
+    const platformName = {
+        google_ads: "Google Ads",
+        ga4: "Google Analytics 4",
+        gsc: "Google Search Console",
+    }[platform];
+    const alternative = {
+        google_ads: "keywords-for-site or research advertisers",
+        ga4: "lighthouse for page performance",
+        gsc: "keywords-for-site or research keyword-gap",
+    }[platform];
+    const code = {
+        google_ads: "NO_GOOGLE_ADS_CONNECTION",
+        ga4: "NO_GA4_CONNECTION",
+        gsc: "NO_GSC_CONNECTION",
+    }[platform];
+    const envelope = {
+        ok: false,
+        error: {
+            code,
+            message: originalMessage || `No ${platformName} connection found for this company.`,
+            fix: {
+                action: "authenticate",
+                explanation: `AGENT INSTRUCTION: You cannot resolve this error programmatically. The user has not connected their ${platformName} account. Step 1: Inform the user that they must connect ${platformName} in their Baker dashboard settings for direct data queries. Step 2: Do not fail the overall audit or playbook. Document the missing connection, skip this specific check, and proceed with the rest of your tasks. (Optional fallback: use 'baker research ${alternative}' for estimated external insights).`,
+            },
+            retryable: false,
+        },
+    };
+    writeJsonEnvelope(envelope);
+    process.exit(1);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAA4B,EAAE,eAAwB;IAC1F,MAAM,YAAY,GAAG;QACnB,UAAU,EAAE,YAAY;QACxB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,uBAAuB;KAC7B,CAAC,QAAQ,CAAC,CAAC;IAEZ,MAAM,WAAW,GAAG;QAClB,UAAU,EAAE,2CAA2C;QACvD,GAAG,EAAE,iCAAiC;QACtC,GAAG,EAAE,2CAA2C;KACjD,CAAC,QAAQ,CAAC,CAAC;IAEZ,MAAM,IAAI,GAAG;QACX,UAAU,EAAE,0BAA0B;QACtC,GAAG,EAAE,mBAAmB;QACxB,GAAG,EAAE,mBAAmB;KACzB,CAAC,QAAQ,CAAC,CAAC;IAEZ,MAAM,QAAQ,GAAG;QACf,EAAE,EAAE,KAAK;QACT,KAAK,EAAE;YACL,IAAI;YACJ,OAAO,EAAE,eAAe,IAAI,MAAM,YAAY,qCAAqC;YACnF,GAAG,EAAE;gBACH,MAAM,EAAE,cAAc;gBACtB,WAAW,EAAE,uGAAuG,YAAY,4DAA4D,YAAY,8PAA8P,WAAW,qCAAqC;aACvf;YACD,SAAS,EAAE,KAAK;SACjB;KACF,CAAC;IAEF,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koda-sl/baker-cli",
-  "version": "0.13.0",
+  "version": "0.16.0",
   "description": "AI-agent-first CLI for interacting with Baker",
   "type": "module",
   "bin": {