@koda-sl/baker-cli 0.34.1 → 0.34.3

package/dist/commands/research/keywords-for-site.js

@@ -0,0 +1,90 @@
+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.keywords-for-site",
+    description: "Get keywords a competitor targets in Google. Use --type paid to see only paid keywords, --type organic for organic only. IMPORTANT: If --location and --language are omitted, defaults to United States (us) and English (en). The response includes a query_context object showing which location/language were used.",
+    args: {
+        target: { type: "string", description: "Domain or URL to analyze (positional)", required: true },
+        location: {
+            type: "string",
+            description: "Country code (us, uk, es, de...) or DataForSEO location code. DEFAULTS TO us (United States) if omitted — always set this for non-US markets",
+            required: false,
+        },
+        language: {
+            type: "string",
+            description: "Language code or name. DEFAULTS TO en (English) if omitted — always set this for non-English markets",
+            required: false,
+        },
+        sort: {
+            type: "string",
+            description: "Sort: relevance, search_volume, competition, cpc (default: search_volume)",
+            required: false,
+        },
+        type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+        limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+});
+const FIELDS = {
+    keyword: "Keyword the site targets",
+    search_volume: "Monthly search volume",
+    cpc: "Cost per click in USD",
+    competition: "LOW, MEDIUM, or HIGH",
+    competition_index: "Competition score 0-100",
+};
+export const keywordsForSiteCommand = defineCommand({
+    meta: {
+        name: "keywords-for-site",
+        description: `Get keywords a competitor targets in Google. Use --type to filter paid/organic.
+
+Examples:
+  baker research keywords-for-site "competitor.com"
+  baker research keywords-for-site "competitor.com" --type paid --limit 20
+  baker research keywords-for-site "competitor.com" --type organic --location uk`,
+    },
+    args: {
+        target: { type: "positional", description: "Domain or URL 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 },
+        sort: { type: "string", description: "Sort: relevance, search_volume, competition, cpc", required: false },
+        type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
+        limit: { type: "string", description: "Max results (default: 50, 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 sort = args.sort || undefined;
+        const type = args.type || 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/keywords-for-site", {
+                target,
+                location,
+                language,
+                sort,
+                type,
+                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=keywords-for-site.js.map

package/dist/commands/research/keywords-for-site.js.map

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

package/dist/commands/research/languages.d.ts

@@ -0,0 +1,2 @@
+export declare const languagesCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=languages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../../src/commands/research/languages.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,gBAAgB,qDAQ3B,CAAC"}

package/dist/commands/research/languages.js

@@ -0,0 +1,42 @@
+import { defineCommand } from "citty";
+import { registerSchema } from "../../schemas.js";
+import { writeResearchJson } from "./output.js";
+registerSchema({
+    command: "research.languages",
+    description: "List all supported language codes for --language flag in research commands.",
+    args: {},
+});
+const LANGUAGES = [
+    { code: "en", name: "english" },
+    { code: "es", name: "spanish" },
+    { code: "fr", name: "french" },
+    { code: "de", name: "german" },
+    { code: "it", name: "italian" },
+    { code: "pt", name: "portuguese" },
+    { code: "nl", name: "dutch" },
+    { code: "ja", name: "japanese" },
+    { code: "ko", name: "korean" },
+    { code: "zh", name: "chinese" },
+    { code: "ar", name: "arabic" },
+    { code: "ru", name: "russian" },
+    { code: "pl", name: "polish" },
+    { code: "tr", name: "turkish" },
+    { code: "sv", name: "swedish" },
+    { code: "no", name: "norwegian" },
+    { code: "da", name: "danish" },
+    { code: "fi", name: "finnish" },
+];
+const FIELDS = {
+    code: "Language code to pass as --language",
+    name: "Language name (also accepted by --language)",
+};
+export const languagesCommand = defineCommand({
+    meta: {
+        name: "languages",
+        description: "List all supported language codes for --language flag.",
+    },
+    run: () => {
+        writeResearchJson({ ok: true, data: LANGUAGES, fields: FIELDS });
+    },
+});
+//# sourceMappingURL=languages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"languages.js","sourceRoot":"","sources":["../../../src/commands/research/languages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,cAAc,CAAC;IACb,OAAO,EAAE,oBAAoB;IAC7B,WAAW,EAAE,6EAA6E;IAC1F,IAAI,EAAE,EAAE;CACT,CAAC,CAAC;AAEH,MAAM,SAAS,GAA0C;IACvD,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE;IAClC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE;IAC7B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE;IAChC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE;IACjC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;CAChC,CAAC;AAEF,MAAM,MAAM,GAA2B;IACrC,IAAI,EAAE,qCAAqC;IAC3C,IAAI,EAAE,6CAA6C;CACpD,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;IAC5C,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,wDAAwD;KACtE;IACD,GAAG,EAAE,GAAG,EAAE;QACR,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/research/lighthouse.d.ts

@@ -0,0 +1,24 @@
+export declare const lighthouseCommand: import("citty").CommandDef<{
+    readonly url: {
+        readonly type: "positional";
+        readonly description: "Full URL to audit (with https://)";
+        readonly required: true;
+    };
+    readonly mobile: {
+        readonly type: "string";
+        readonly description: "Test as mobile: true|false (default: true)";
+        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=lighthouse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lighthouse.d.ts","sourceRoot":"","sources":["../../../src/commands/research/lighthouse.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;EAqC5B,CAAC"}

package/dist/commands/research/lighthouse.js

@@ -0,0 +1,60 @@
+import { defineCommand } from "citty";
+import { apiPost } from "../../client.js";
+import { registerSchema } from "../../schemas.js";
+import { handleResearchError, writeResearchJson, writeResearchOutput } from "./output.js";
+registerSchema({
+    command: "research.lighthouse",
+    description: "Landing page performance audit. Returns metrics that affect Google Ads Quality Score and CPC.",
+    args: {
+        url: { type: "string", description: "Full URL to audit (with https://)", required: true },
+        mobile: { type: "boolean", description: "Test as mobile (default: true)", required: false },
+        "no-cache": { type: "boolean", description: "Skip server cache, hit API directly", required: false },
+    },
+});
+const FIELDS = {
+    url: "URL that was audited",
+    performance_score: "Lighthouse performance score 0-100 (aim for 90+)",
+    fcp_ms: "First Contentful Paint in ms (good: < 1800)",
+    lcp_ms: "Largest Contentful Paint in ms (good: < 2500)",
+    cls: "Cumulative Layout Shift (good: < 0.1)",
+    speed_index_ms: "Speed Index in ms (good: < 3400)",
+    interactive_ms: "Time to Interactive in ms (good: < 3800)",
+};
+export const lighthouseCommand = defineCommand({
+    meta: {
+        name: "lighthouse",
+        description: `Landing page performance audit. Metrics affecting Google Ads Quality Score.
+
+Examples:
+  baker research lighthouse "https://example.com/landing"
+  baker research lighthouse "https://example.com" --mobile false`,
+    },
+    args: {
+        url: { type: "positional", description: "Full URL to audit (with https://)", required: true },
+        mobile: { type: "string", description: "Test as mobile: true|false (default: true)", 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 url = args.url;
+        const mobile = args.mobile === "false" ? false : undefined;
+        const skipCache = args["no-cache"] ? true : undefined;
+        try {
+            const data = await apiPost("/api/research/lighthouse", {
+                url,
+                mobile,
+                skipCache,
+            });
+            const format = args.output || "json";
+            if (format !== "json") {
+                writeResearchOutput([data], format);
+                return;
+            }
+            writeResearchJson({ ok: true, data, fields: FIELDS });
+        }
+        catch (err) {
+            handleResearchError(err);
+        }
+    },
+});
+//# sourceMappingURL=lighthouse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lighthouse.js","sourceRoot":"","sources":["../../../src/commands/research/lighthouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE1F,cAAc,CAAC;IACb,OAAO,EAAE,qBAAqB;IAC9B,WAAW,EAAE,+FAA+F;IAC5G,IAAI,EAAE;QACJ,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzF,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gCAAgC,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC3F,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,qCAAqC,EAAE,QAAQ,EAAE,KAAK,EAAE;KACrG;CACF,CAAC,CAAC;AAYH,MAAM,MAAM,GAA2B;IACrC,GAAG,EAAE,sBAAsB;IAC3B,iBAAiB,EAAE,kDAAkD;IACrE,MAAM,EAAE,6CAA6C;IACrD,MAAM,EAAE,+CAA+C;IACvD,GAAG,EAAE,uCAAuC;IAC5C,cAAc,EAAE,kCAAkC;IAClD,cAAc,EAAE,0CAA0C;CAC3D,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;IAC7C,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE;;;;iEAIgD;KAC9D;IACD,IAAI,EAAE;QACJ,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,mCAAmC,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE,QAAQ,EAAE,KAAK,EAAE;QACtG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE;QACtG,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,qCAAqC,EAAE,QAAQ,EAAE,KAAK,EAAE;KACrG;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAa,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAEtD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAmB,0BAA0B,EAAE;gBACvE,GAAG;gBACH,MAAM;gBACN,SAAS;aACV,CAAC,CAAC;YAEH,MAAM,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,MAAM,CAAC;YACjD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,mBAAmB,CAAC,CAAC,IAA0C,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;YACD,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/research/output.d.ts

@@ -0,0 +1,29 @@
+export declare const RESEARCH_DATA_NOTE = "Estimates based on third-party SERP data \u2014 not exact figures. Use for directional insights, not precise measurement.";
+interface PaginationInfo {
+    offset: number;
+    limit: number;
+    has_more: boolean;
+    next_offset?: number;
+}
+interface ResearchSuccessEnvelope<T> {
+    ok: true;
+    data: T;
+    fields?: Record<string, string>;
+    note?: string;
+    total_count?: number;
+    pagination?: PaginationInfo;
+    [key: string]: unknown;
+}
+interface ResearchErrorEnvelope {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+}
+type ResearchOutput = ResearchSuccessEnvelope<unknown> | ResearchErrorEnvelope;
+export declare function writeResearchJson(envelope: ResearchOutput): void;
+export declare function writeResearchOutput(data: Array<Record<string, unknown>>, format: string, fields?: string[]): void;
+export declare function handleResearchError(err: unknown): never;
+export {};
+//# sourceMappingURL=output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/commands/research/output.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,8HACyF,CAAC;AAEzH,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,uBAAuB,CAAC,CAAC;IACjC,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,qBAAqB;IAC7B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,KAAK,cAAc,GAAG,uBAAuB,CAAC,OAAO,CAAC,GAAG,qBAAqB,CAAC;AAE/E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAEhE;AAgDD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAcjH;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAgBvD"}

package/dist/commands/research/output.js

@@ -0,0 +1,81 @@
+import { ApiError } from "../../client.js";
+export const RESEARCH_DATA_NOTE = "Estimates based on third-party SERP data — not exact figures. Use for directional insights, not precise measurement.";
+export function writeResearchJson(envelope) {
+    process.stdout.write(`${JSON.stringify(envelope, null, 2)}\n`);
+}
+function toCsvRow(values) {
+    return values
+        .map((v) => {
+        if (v.includes(",") || v.includes('"') || v.includes("\n")) {
+            return `"${v.replace(/"/g, '""')}"`;
+        }
+        return v;
+    })
+        .join(",");
+}
+function flattenRow(row) {
+    const flat = {};
+    for (const [key, val] of Object.entries(row)) {
+        flat[key] = typeof val === "object" && val !== null ? JSON.stringify(val) : String(val ?? "");
+    }
+    return flat;
+}
+function writeCsv(data, fields) {
+    if (data.length === 0)
+        return;
+    const cols = fields ?? Object.keys(data[0] ?? {});
+    process.stdout.write(`${toCsvRow(cols)}\n`);
+    for (const row of data) {
+        const flat = flattenRow(row);
+        process.stdout.write(`${toCsvRow(cols.map((f) => flat[f] ?? ""))}\n`);
+    }
+}
+function writeJsonl(data) {
+    for (const row of data) {
+        process.stdout.write(`${JSON.stringify(row)}\n`);
+    }
+}
+function writeMd(data, fields) {
+    if (data.length === 0)
+        return;
+    const cols = fields ?? Object.keys(data[0] ?? {});
+    process.stdout.write(`| ${cols.join(" | ")} |\n`);
+    process.stdout.write(`| ${cols.map(() => "---").join(" | ")} |\n`);
+    for (const row of data) {
+        const flat = flattenRow(row);
+        process.stdout.write(`| ${cols.map((f) => flat[f] ?? "").join(" | ")} |\n`);
+    }
+}
+export function writeResearchOutput(data, format, fields) {
+    switch (format) {
+        case "csv":
+            writeCsv(data, fields);
+            break;
+        case "jsonl":
+            writeJsonl(data);
+            break;
+        case "md":
+            writeMd(data, fields);
+            break;
+        default:
+            writeResearchJson({ ok: true, data });
+    }
+}
+export function handleResearchError(err) {
+    if (err instanceof ApiError) {
+        writeResearchJson({
+            ok: false,
+            error: {
+                code: err.code,
+                message: err.message,
+            },
+        });
+        process.exit(1);
+    }
+    writeResearchJson({
+        ok: false,
+        error: { code: "NETWORK_ERROR", message: err instanceof Error ? err.message : "Unexpected error" },
+    });
+    process.exit(1);
+}
+//# sourceMappingURL=output.js.map

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

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

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/commands/research/web.d.ts

@@ -0,0 +1,19 @@
+export declare const webCommand: import("citty").CommandDef<{
+    readonly question: {
+        readonly type: "positional";
+        readonly description: "The research question";
+        readonly required: true;
+    };
+    readonly depth: {
+        readonly type: "string";
+        readonly description: "Research depth: medium|high|xhigh (default: medium)";
+        readonly required: false;
+    };
+    readonly output: {
+        readonly type: "string";
+        readonly description: "Format: json|md (default: json)";
+        readonly required: false;
+        readonly default: "json";
+    };
+}>;
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/commands/research/web.ts"],"names":[],"mappings":"AAsEA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;EA6DrB,CAAC"}

package/dist/commands/research/web.js

@@ -0,0 +1,112 @@
+import { defineCommand } from "citty";
+import { apiGet, apiPost } from "../../client.js";
+import { registerSchema } from "../../schemas.js";
+import { handleResearchError, writeResearchJson } from "./output.js";
+registerSchema({
+    command: "research.web",
+    description: "Search the web with AI to answer marketing questions — competitors, ICP, pricing, pain points, market trends. Three depth levels: medium (quick, default), high (thorough), xhigh (exhaustive deep research).",
+    args: {
+        question: {
+            type: "string",
+            description: "The research question to answer using live web data",
+            required: true,
+        },
+        depth: {
+            type: "string",
+            description: "Research depth: medium (quick), high (thorough), xhigh (exhaustive). Default: medium",
+            required: false,
+            enum: ["medium", "high", "xhigh"],
+        },
+    },
+});
+const TIMEOUT_MS = {
+    medium: 180_000,
+    high: 360_000,
+    xhigh: 900_000,
+};
+const FIELDS = {
+    answer: "AI-generated research answer (markdown)",
+    sources: "Array of {title, url} sources used for grounding",
+};
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function runDeepResearch(question) {
+    const { interactionId } = await apiPost("/api/research/deep-research/start", { question });
+    process.stderr.write(`Deep research started (${interactionId}). Polling...\n`);
+    const deadline = Date.now() + TIMEOUT_MS.xhigh;
+    while (Date.now() < deadline) {
+        await sleep(10_000);
+        const poll = await apiGet("/api/research/deep-research/poll", {
+            id: interactionId,
+        });
+        if (poll.status === "completed" && poll.result) {
+            return poll.result;
+        }
+        if (poll.status === "failed" || poll.status === "cancelled") {
+            throw new Error(`Deep research ${poll.status}`);
+        }
+        process.stderr.write(`  status: ${poll.status}\n`);
+    }
+    throw new Error("Deep research timed out");
+}
+export const webCommand = defineCommand({
+    meta: {
+        name: "web",
+        description: `Search the web with AI to answer any open-ended marketing question. Uses live internet data via Google Search.
+
+Depth levels:
+  medium  — Quick lookup using Gemini Flash with minimal thinking (default)
+  high    — Thorough answer using Gemini Flash with deep thinking
+  xhigh   — Exhaustive deep research using Gemini Deep Research (slow, use sparingly)
+
+Examples:
+  baker research web "Who are the main competitors of HubSpot CRM?"
+  baker research web "What are the top pain points for SMB CRM buyers?" --depth high
+  baker research web "Full competitive analysis of project management SaaS" --depth xhigh`,
+    },
+    args: {
+        question: { type: "positional", description: "The research question", required: true },
+        depth: { type: "string", description: "Research depth: medium|high|xhigh (default: medium)", required: false },
+        output: { type: "string", description: "Format: json|md (default: json)", required: false, default: "json" },
+    },
+    run: async ({ args }) => {
+        const question = args.question;
+        if (question.length < 5) {
+            writeResearchJson({
+                ok: false,
+                error: { code: "VALIDATION_ERROR", message: "Question must be at least 5 characters" },
+            });
+            process.exit(1);
+        }
+        const depth = (args.depth || "medium");
+        if (!["medium", "high", "xhigh"].includes(depth)) {
+            writeResearchJson({
+                ok: false,
+                error: { code: "VALIDATION_ERROR", message: "Depth must be one of: medium, high, xhigh" },
+            });
+            process.exit(1);
+        }
+        try {
+            const data = depth === "xhigh"
+                ? await runDeepResearch(question)
+                : await apiPost("/api/research/explore", { question, depth }, { timeoutMs: TIMEOUT_MS[depth] });
+            const format = args.output || "json";
+            if (format === "md") {
+                process.stdout.write(`${data.answer}\n`);
+                if (data.sources.length > 0) {
+                    process.stdout.write("\n## Sources\n");
+                    for (const s of data.sources) {
+                        process.stdout.write(`- [${s.title}](${s.url})\n`);
+                    }
+                }
+                return;
+            }
+            writeResearchJson({ ok: true, data, fields: FIELDS });
+        }
+        catch (err) {
+            handleResearchError(err);
+        }
+    },
+});
+//# sourceMappingURL=web.js.map

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

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