@yoryoboy/bi-mcp 1.0.1

package/dist/src/tools/search-console/device-breakdown.js

@@ -0,0 +1,85 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { querySearchConsolePerformance } from "../../services/search-console/search-console-client.js";
+import {
+  buildSearchConsoleQueryBody,
+  endDateSchemaField,
+  profileIdSchemaField,
+  resolveSearchConsoleSiteUrl,
+  searchTypeSchemaField,
+  siteUrlSchemaField,
+  startDateSchemaField,
+  sumSearchConsoleRows,
+  toPercent,
+  normalizeSearchConsoleRow,
+  round
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsoleDeviceBreakdownSchema = z.object({
+  startDate: startDateSchemaField,
+  endDate: endDateSchemaField,
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField,
+  searchType: searchTypeSchemaField,
+  queryContains: z.string().optional().describe("Optional query substring filter."),
+  pageContains: z.string().optional().describe("Optional page substring filter.")
+});
+async function searchConsoleDeviceBreakdownHandler(params) {
+  try {
+    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const dimensionFilters = [];
+    if (params.queryContains?.trim()) {
+      dimensionFilters.push({
+        dimension: "query",
+        operator: "contains",
+        expression: params.queryContains.trim()
+      });
+    }
+    if (params.pageContains?.trim()) {
+      dimensionFilters.push({
+        dimension: "page",
+        operator: "contains",
+        expression: params.pageContains.trim()
+      });
+    }
+    const response = await querySearchConsolePerformance(
+      siteUrl,
+      buildSearchConsoleQueryBody({
+        startDate: params.startDate,
+        endDate: params.endDate,
+        dimensions: ["device"],
+        searchType: params.searchType,
+        dimensionFilters
+      })
+    );
+    const rows = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, ["device"]));
+    const totals = sumSearchConsoleRows(rows);
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        device_breakdown: rows.map((row) => ({
+          device: row.dimensions.device,
+          clicks: row.clicks,
+          impressions: row.impressions,
+          ctr_percent: row.ctr_percent,
+          position: row.position,
+          impression_share_percent: round(toPercent(row.impressions, totals.impressions), 2),
+          click_share_percent: round(toPercent(row.clicks, totals.clicks), 2)
+        }))
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to fetch Search Console device breakdown"
+    );
+  }
+}
+export {
+  searchConsoleDeviceBreakdownHandler,
+  searchConsoleDeviceBreakdownSchema
+};
+//# sourceMappingURL=device-breakdown.js.map

package/dist/src/tools/search-console/device-breakdown.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/device-breakdown.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  buildSearchConsoleQueryBody,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  sumSearchConsoleRows,\n  toPercent,\n  normalizeSearchConsoleRow,\n  round,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleDeviceBreakdownSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  queryContains: z.string().optional().describe(\"Optional query substring filter.\"),\n  pageContains: z.string().optional().describe(\"Optional page substring filter.\"),\n});\n\nexport async function searchConsoleDeviceBreakdownHandler(\n  params: z.infer<typeof searchConsoleDeviceBreakdownSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const dimensionFilters = [];\n\n    if (params.queryContains?.trim()) {\n      dimensionFilters.push({\n        dimension: \"query\",\n        operator: \"contains\",\n        expression: params.queryContains.trim(),\n      });\n    }\n\n    if (params.pageContains?.trim()) {\n      dimensionFilters.push({\n        dimension: \"page\",\n        operator: \"contains\",\n        expression: params.pageContains.trim(),\n      });\n    }\n\n    const response = await querySearchConsolePerformance(\n      siteUrl,\n      buildSearchConsoleQueryBody({\n        startDate: params.startDate,\n        endDate: params.endDate,\n        dimensions: [\"device\"],\n        searchType: params.searchType,\n        dimensionFilters,\n      })\n    );\n\n    const rows = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, [\"device\"]));\n    const totals = sumSearchConsoleRows(rows);\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        device_breakdown: rows.map((row) => ({\n          device: row.dimensions.device,\n          clicks: row.clicks,\n          impressions: row.impressions,\n          ctr_percent: row.ctr_percent,\n          position: row.position,\n          impression_share_percent: round(toPercent(row.impressions, totals.impressions), 2),\n          click_share_percent: round(toPercent(row.clicks, totals.clicks), 2),\n        })),\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Search Console device breakdown\"\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,qCAAqC;AAC9C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,qCAAqC,EAAE,OAAO;AAAA,EACzD,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,kCAAkC;AAAA,EAChF,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,iCAAiC;AAChF,CAAC;AAED,eAAsB,oCACpB,QACA;AACA,MAAI;AACF,UAAM,UAAU,4BAA4B,OAAO,SAAS,OAAO,SAAS;AAC5E,UAAM,mBAAmB,CAAC;AAE1B,QAAI,OAAO,eAAe,KAAK,GAAG;AAChC,uBAAiB,KAAK;AAAA,QACpB,WAAW;AAAA,QACX,UAAU;AAAA,QACV,YAAY,OAAO,cAAc,KAAK;AAAA,MACxC,CAAC;AAAA,IACH;AAEA,QAAI,OAAO,cAAc,KAAK,GAAG;AAC/B,uBAAiB,KAAK;AAAA,QACpB,WAAW;AAAA,QACX,UAAU;AAAA,QACV,YAAY,OAAO,aAAa,KAAK;AAAA,MACvC,CAAC;AAAA,IACH;AAEA,UAAM,WAAW,MAAM;AAAA,MACrB;AAAA,MACA,4BAA4B;AAAA,QAC1B,WAAW,OAAO;AAAA,QAClB,SAAS,OAAO;AAAA,QAChB,YAAY,CAAC,QAAQ;AAAA,QACrB,YAAY,OAAO;AAAA,QACnB;AAAA,MACF,CAAC;AAAA,IACH;AAEA,UAAM,QAAQ,SAAS,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,0BAA0B,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC1F,UAAM,SAAS,qBAAqB,IAAI;AAExC,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,QACV,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,kBAAkB,KAAK,IAAI,CAAC,SAAS;AAAA,UACnC,QAAQ,IAAI,WAAW;AAAA,UACvB,QAAQ,IAAI;AAAA,UACZ,aAAa,IAAI;AAAA,UACjB,aAAa,IAAI;AAAA,UACjB,UAAU,IAAI;AAAA,UACd,0BAA0B,MAAM,UAAU,IAAI,aAAa,OAAO,WAAW,GAAG,CAAC;AAAA,UACjF,qBAAqB,MAAM,UAAU,IAAI,QAAQ,OAAO,MAAM,GAAG,CAAC;AAAA,QACpE,EAAE;AAAA,MACJ,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/tools/search-console/high-impression-low-click-queries.js

@@ -0,0 +1,95 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { querySearchConsolePerformance } from "../../services/search-console/search-console-client.js";
+import {
+  brandTermsSchemaField,
+  buildSearchConsoleQueryBody,
+  classifyBrandLabel,
+  endDateSchemaField,
+  profileIdSchemaField,
+  resolveSearchConsoleSiteUrl,
+  rowLimitSchemaField,
+  scoreHighImpressionLowClickOpportunity,
+  searchTypeSchemaField,
+  siteUrlSchemaField,
+  startDateSchemaField,
+  normalizeSearchConsoleRow
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsoleHighImpressionLowClickQueriesSchema = z.object({
+  startDate: startDateSchemaField,
+  endDate: endDateSchemaField,
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField,
+  searchType: searchTypeSchemaField,
+  brandTerms: brandTermsSchemaField,
+  includeBrand: z.enum(["all", "only_brand", "only_non_brand"]).optional().describe("How to filter the query list when brandTerms are provided."),
+  minImpressions: z.number().min(1).optional().describe("Minimum impressions required to consider a query an opportunity."),
+  maxCtr: z.number().min(0).max(100).optional().describe("Maximum CTR percentage allowed to count as low capture."),
+  rowLimit: rowLimitSchemaField
+});
+async function searchConsoleHighImpressionLowClickQueriesHandler(params) {
+  try {
+    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const minImpressions = params.minImpressions ?? 100;
+    const maxCtr = params.maxCtr ?? 3;
+    const includeBrand = params.includeBrand ?? "all";
+    const response = await querySearchConsolePerformance(
+      siteUrl,
+      buildSearchConsoleQueryBody({
+        startDate: params.startDate,
+        endDate: params.endDate,
+        dimensions: ["query"],
+        searchType: params.searchType,
+        rowLimit: params.rowLimit ?? 250
+      })
+    );
+    const opportunities = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, ["query"])).map((row) => ({
+      query: row.dimensions.query,
+      clicks: row.clicks,
+      impressions: row.impressions,
+      ctr_percent: row.ctr_percent,
+      position: row.position,
+      brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms)
+    })).filter((row) => row.impressions >= minImpressions && row.ctr_percent <= maxCtr).filter((row) => {
+      if (includeBrand === "only_brand") {
+        return row.brand_classification === "brand";
+      }
+      if (includeBrand === "only_non_brand") {
+        return row.brand_classification === "non_brand";
+      }
+      return true;
+    }).map((row) => ({
+      ...row,
+      opportunity_score: scoreHighImpressionLowClickOpportunity({
+        impressions: row.impressions,
+        ctrPercent: row.ctr_percent,
+        position: row.position
+      }),
+      reason: "High impression volume with low click capture."
+    })).sort((left, right) => right.opportunity_score - left.opportunity_score);
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        thresholds: {
+          min_impressions: minImpressions,
+          max_ctr_percent: maxCtr
+        },
+        opportunities
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to find Search Console high-impression low-click queries"
+    );
+  }
+}
+export {
+  searchConsoleHighImpressionLowClickQueriesHandler,
+  searchConsoleHighImpressionLowClickQueriesSchema
+};
+//# sourceMappingURL=high-impression-low-click-queries.js.map

package/dist/src/tools/search-console/high-impression-low-click-queries.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/high-impression-low-click-queries.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  brandTermsSchemaField,\n  buildSearchConsoleQueryBody,\n  classifyBrandLabel,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  rowLimitSchemaField,\n  scoreHighImpressionLowClickOpportunity,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  normalizeSearchConsoleRow,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleHighImpressionLowClickQueriesSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  brandTerms: brandTermsSchemaField,\n  includeBrand: z\n    .enum([\"all\", \"only_brand\", \"only_non_brand\"])\n    .optional()\n    .describe(\"How to filter the query list when brandTerms are provided.\"),\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum impressions required to consider a query an opportunity.\"),\n  maxCtr: z\n    .number()\n    .min(0)\n    .max(100)\n    .optional()\n    .describe(\"Maximum CTR percentage allowed to count as low capture.\"),\n  rowLimit: rowLimitSchemaField,\n});\n\nexport async function searchConsoleHighImpressionLowClickQueriesHandler(\n  params: z.infer<typeof searchConsoleHighImpressionLowClickQueriesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const minImpressions = params.minImpressions ?? 100;\n    const maxCtr = params.maxCtr ?? 3;\n    const includeBrand = params.includeBrand ?? \"all\";\n    const response = await querySearchConsolePerformance(\n      siteUrl,\n      buildSearchConsoleQueryBody({\n        startDate: params.startDate,\n        endDate: params.endDate,\n        dimensions: [\"query\"],\n        searchType: params.searchType,\n        rowLimit: params.rowLimit ?? 250,\n      })\n    );\n\n    const opportunities = (response.rows ?? [])\n      .map((row) => normalizeSearchConsoleRow(row, [\"query\"]))\n      .map((row) => ({\n        query: row.dimensions.query,\n        clicks: row.clicks,\n        impressions: row.impressions,\n        ctr_percent: row.ctr_percent,\n        position: row.position,\n        brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms),\n      }))\n      .filter((row) => row.impressions >= minImpressions && row.ctr_percent <= maxCtr)\n      .filter((row) => {\n        if (includeBrand === \"only_brand\") {\n          return row.brand_classification === \"brand\";\n        }\n\n        if (includeBrand === \"only_non_brand\") {\n          return row.brand_classification === \"non_brand\";\n        }\n\n        return true;\n      })\n      .map((row) => ({\n        ...row,\n        opportunity_score: scoreHighImpressionLowClickOpportunity({\n          impressions: row.impressions,\n          ctrPercent: row.ctr_percent,\n          position: row.position,\n        }),\n        reason: \"High impression volume with low click capture.\",\n      }))\n      .sort((left, right) => right.opportunity_score - left.opportunity_score);\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        thresholds: {\n          min_impressions: minImpressions,\n          max_ctr_percent: maxCtr,\n        },\n        opportunities,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error\n        ? err.message\n        : \"Failed to find Search Console high-impression low-click queries\"\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,qCAAqC;AAC9C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,mDAAmD,EAAE,OAAO;AAAA,EACvE,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,cAAc,EACX,KAAK,CAAC,OAAO,cAAc,gBAAgB,CAAC,EAC5C,SAAS,EACT,SAAS,4DAA4D;AAAA,EACxE,gBAAgB,EACb,OAAO,EACP,IAAI,CAAC,EACL,SAAS,EACT,SAAS,kEAAkE;AAAA,EAC9E,QAAQ,EACL,OAAO,EACP,IAAI,CAAC,EACL,IAAI,GAAG,EACP,SAAS,EACT,SAAS,yDAAyD;AAAA,EACrE,UAAU;AACZ,CAAC;AAED,eAAsB,kDACpB,QACA;AACA,MAAI;AACF,UAAM,UAAU,4BAA4B,OAAO,SAAS,OAAO,SAAS;AAC5E,UAAM,iBAAiB,OAAO,kBAAkB;AAChD,UAAM,SAAS,OAAO,UAAU;AAChC,UAAM,eAAe,OAAO,gBAAgB;AAC5C,UAAM,WAAW,MAAM;AAAA,MACrB;AAAA,MACA,4BAA4B;AAAA,QAC1B,WAAW,OAAO;AAAA,QAClB,SAAS,OAAO;AAAA,QAChB,YAAY,CAAC,OAAO;AAAA,QACpB,YAAY,OAAO;AAAA,QACnB,UAAU,OAAO,YAAY;AAAA,MAC/B,CAAC;AAAA,IACH;AAEA,UAAM,iBAAiB,SAAS,QAAQ,CAAC,GACtC,IAAI,CAAC,QAAQ,0BAA0B,KAAK,CAAC,OAAO,CAAC,CAAC,EACtD,IAAI,CAAC,SAAS;AAAA,MACb,OAAO,IAAI,WAAW;AAAA,MACtB,QAAQ,IAAI;AAAA,MACZ,aAAa,IAAI;AAAA,MACjB,aAAa,IAAI;AAAA,MACjB,UAAU,IAAI;AAAA,MACd,sBAAsB,mBAAmB,IAAI,WAAW,OAAO,OAAO,UAAU;AAAA,IAClF,EAAE,EACD,OAAO,CAAC,QAAQ,IAAI,eAAe,kBAAkB,IAAI,eAAe,MAAM,EAC9E,OAAO,CAAC,QAAQ;AACf,UAAI,iBAAiB,cAAc;AACjC,eAAO,IAAI,yBAAyB;AAAA,MACtC;AAEA,UAAI,iBAAiB,kBAAkB;AACrC,eAAO,IAAI,yBAAyB;AAAA,MACtC;AAEA,aAAO;AAAA,IACT,CAAC,EACA,IAAI,CAAC,SAAS;AAAA,MACb,GAAG;AAAA,MACH,mBAAmB,uCAAuC;AAAA,QACxD,aAAa,IAAI;AAAA,QACjB,YAAY,IAAI;AAAA,QAChB,UAAU,IAAI;AAAA,MAChB,CAAC;AAAA,MACD,QAAQ;AAAA,IACV,EAAE,EACD,KAAK,CAAC,MAAM,UAAU,MAAM,oBAAoB,KAAK,iBAAiB;AAEzE,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,QACV,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,YAAY;AAAA,UACV,iBAAiB;AAAA,UACjB,iBAAiB;AAAA,QACnB;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QACX,IAAI,UACJ;AAAA,IACN;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/tools/search-console/index.js

@@ -0,0 +1,15 @@
+export * from "./list-accessible-sites.js";
+export * from "./site-context.js";
+export * from "./search-performance.js";
+export * from "./query-performance.js";
+export * from "./page-performance.js";
+export * from "./query-page-matrix.js";
+export * from "./device-breakdown.js";
+export * from "./country-breakdown.js";
+export * from "./high-impression-low-click-queries.js";
+export * from "./low-ctr-opportunities.js";
+export * from "./visibility-declines.js";
+export * from "./product-demand-low-capture-queries.js";
+export * from "./rising-non-brand-queries.js";
+export * from "./quick-win-opportunities.js";
+//# sourceMappingURL=index.js.map

package/dist/src/tools/search-console/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/index.ts"],
+  "sourcesContent": ["export * from \"./list-accessible-sites.js\";\nexport * from \"./site-context.js\";\nexport * from \"./search-performance.js\";\nexport * from \"./query-performance.js\";\nexport * from \"./page-performance.js\";\nexport * from \"./query-page-matrix.js\";\nexport * from \"./device-breakdown.js\";\nexport * from \"./country-breakdown.js\";\nexport * from \"./high-impression-low-click-queries.js\";\nexport * from \"./low-ctr-opportunities.js\";\nexport * from \"./visibility-declines.js\";\nexport * from \"./product-demand-low-capture-queries.js\";\nexport * from \"./rising-non-brand-queries.js\";\nexport * from \"./quick-win-opportunities.js\";\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/src/tools/search-console/list-accessible-sites.js

@@ -0,0 +1,42 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { listSearchConsoleSites } from "../../services/search-console/search-console-client.js";
+import {
+  normalizePermissionLevel,
+  normalizeSearchConsoleSiteEntry
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const listAccessibleSitesSchema = z.object({});
+async function listAccessibleSitesHandler(_params) {
+  try {
+    const sites = await listSearchConsoleSites();
+    const normalizedSites = sites.map(normalizeSearchConsoleSiteEntry).sort((left, right) => left.site_url.localeCompare(right.site_url));
+    const preferredDomainProperty = normalizedSites.find(
+      (site) => site.property_type === "domain" && (site.permission_level === "siteowner" || site.permission_level === "owner")
+    );
+    return object(
+      stripNulls({
+        total_sites: normalizedSites.length,
+        recommended_default_site_url: preferredDomainProperty?.site_url ?? normalizedSites[0]?.site_url,
+        sites: normalizedSites,
+        summary: {
+          domain_properties: normalizedSites.filter((site) => site.property_type === "domain").length,
+          url_prefix_properties: normalizedSites.filter((site) => site.property_type === "url_prefix").length,
+          owner_level_sites: sites.filter((site) => {
+            const permissionLevel = normalizePermissionLevel(site.permissionLevel);
+            return permissionLevel === "owner" || permissionLevel === "siteowner";
+          }).length
+        }
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to list accessible Search Console sites"
+    );
+  }
+}
+export {
+  listAccessibleSitesHandler,
+  listAccessibleSitesSchema
+};
+//# sourceMappingURL=list-accessible-sites.js.map

package/dist/src/tools/search-console/list-accessible-sites.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/list-accessible-sites.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { listSearchConsoleSites } from \"../../services/search-console/search-console-client.js\";\nimport {\n  inferSearchConsolePropertyType,\n  normalizePermissionLevel,\n  normalizeSearchConsoleSiteEntry,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const listAccessibleSitesSchema = z.object({});\n\nexport async function listAccessibleSitesHandler(\n  _params: z.infer<typeof listAccessibleSitesSchema>\n) {\n  try {\n    const sites = await listSearchConsoleSites();\n    const normalizedSites = sites\n      .map(normalizeSearchConsoleSiteEntry)\n      .sort((left, right) => left.site_url.localeCompare(right.site_url));\n\n    const preferredDomainProperty = normalizedSites.find(\n      (site) =>\n        site.property_type === \"domain\" &&\n        (site.permission_level === \"siteowner\" || site.permission_level === \"owner\")\n    );\n\n    return object(\n      stripNulls({\n        total_sites: normalizedSites.length,\n        recommended_default_site_url: preferredDomainProperty?.site_url ?? normalizedSites[0]?.site_url,\n        sites: normalizedSites,\n        summary: {\n          domain_properties: normalizedSites.filter((site) => site.property_type === \"domain\").length,\n          url_prefix_properties: normalizedSites.filter((site) => site.property_type === \"url_prefix\").length,\n          owner_level_sites: sites.filter((site) => {\n            const permissionLevel = normalizePermissionLevel(site.permissionLevel);\n            return permissionLevel === \"owner\" || permissionLevel === \"siteowner\";\n          }).length,\n        },\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to list accessible Search Console sites\"\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,8BAA8B;AACvC;AAAA,EAEE;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,4BAA4B,EAAE,OAAO,CAAC,CAAC;AAEpD,eAAsB,2BACpB,SACA;AACA,MAAI;AACF,UAAM,QAAQ,MAAM,uBAAuB;AAC3C,UAAM,kBAAkB,MACrB,IAAI,+BAA+B,EACnC,KAAK,CAAC,MAAM,UAAU,KAAK,SAAS,cAAc,MAAM,QAAQ,CAAC;AAEpE,UAAM,0BAA0B,gBAAgB;AAAA,MAC9C,CAAC,SACC,KAAK,kBAAkB,aACtB,KAAK,qBAAqB,eAAe,KAAK,qBAAqB;AAAA,IACxE;AAEA,WAAO;AAAA,MACL,WAAW;AAAA,QACT,aAAa,gBAAgB;AAAA,QAC7B,8BAA8B,yBAAyB,YAAY,gBAAgB,CAAC,GAAG;AAAA,QACvF,OAAO;AAAA,QACP,SAAS;AAAA,UACP,mBAAmB,gBAAgB,OAAO,CAAC,SAAS,KAAK,kBAAkB,QAAQ,EAAE;AAAA,UACrF,uBAAuB,gBAAgB,OAAO,CAAC,SAAS,KAAK,kBAAkB,YAAY,EAAE;AAAA,UAC7F,mBAAmB,MAAM,OAAO,CAAC,SAAS;AACxC,kBAAM,kBAAkB,yBAAyB,KAAK,eAAe;AACrE,mBAAO,oBAAoB,WAAW,oBAAoB;AAAA,UAC5D,CAAC,EAAE;AAAA,QACL;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/tools/search-console/low-ctr-opportunities.js

@@ -0,0 +1,98 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { querySearchConsolePerformance } from "../../services/search-console/search-console-client.js";
+import {
+  brandTermsSchemaField,
+  buildSearchConsoleQueryBody,
+  classifyBrandLabel,
+  endDateSchemaField,
+  profileIdSchemaField,
+  resolveSearchConsoleSiteUrl,
+  scoreQuickWinOpportunity,
+  searchTypeSchemaField,
+  siteUrlSchemaField,
+  startDateSchemaField,
+  normalizeSearchConsoleRow
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsoleLowCtrOpportunitiesSchema = z.object({
+  startDate: startDateSchemaField,
+  endDate: endDateSchemaField,
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField,
+  searchType: searchTypeSchemaField,
+  brandTerms: brandTermsSchemaField,
+  includeBrand: z.enum(["all", "only_brand", "only_non_brand"]).optional().describe("How to filter the query list when brandTerms are provided."),
+  minImpressions: z.number().min(1).optional().describe("Minimum impressions required to consider a CTR opportunity."),
+  maxCtr: z.number().min(0).max(100).optional().describe("Maximum CTR percentage allowed to count as underperforming."),
+  maxPosition: z.number().min(1).max(100).optional().describe("Maximum average position to keep only queries that already rank reasonably well.")
+});
+async function searchConsoleLowCtrOpportunitiesHandler(params) {
+  try {
+    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const minImpressions = params.minImpressions ?? 100;
+    const maxCtr = params.maxCtr ?? 4;
+    const maxPosition = params.maxPosition ?? 10;
+    const includeBrand = params.includeBrand ?? "all";
+    const response = await querySearchConsolePerformance(
+      siteUrl,
+      buildSearchConsoleQueryBody({
+        startDate: params.startDate,
+        endDate: params.endDate,
+        dimensions: ["query"],
+        searchType: params.searchType,
+        rowLimit: 250
+      })
+    );
+    const opportunities = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, ["query"])).map((row) => ({
+      query: row.dimensions.query,
+      clicks: row.clicks,
+      impressions: row.impressions,
+      ctr_percent: row.ctr_percent,
+      position: row.position,
+      brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms)
+    })).filter(
+      (row) => row.impressions >= minImpressions && row.ctr_percent <= maxCtr && row.position > 0 && row.position <= maxPosition
+    ).filter((row) => {
+      if (includeBrand === "only_brand") {
+        return row.brand_classification === "brand";
+      }
+      if (includeBrand === "only_non_brand") {
+        return row.brand_classification === "non_brand";
+      }
+      return true;
+    }).map((row) => ({
+      ...row,
+      opportunity_score: scoreQuickWinOpportunity({
+        impressions: row.impressions,
+        ctrPercent: row.ctr_percent,
+        position: row.position
+      }),
+      reason: "Ranking is already acceptable, so low CTR suggests snippet or title optimization potential."
+    })).sort((left, right) => right.opportunity_score - left.opportunity_score);
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        thresholds: {
+          min_impressions: minImpressions,
+          max_ctr_percent: maxCtr,
+          max_position: maxPosition
+        },
+        opportunities
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to find Search Console low-CTR opportunities"
+    );
+  }
+}
+export {
+  searchConsoleLowCtrOpportunitiesHandler,
+  searchConsoleLowCtrOpportunitiesSchema
+};
+//# sourceMappingURL=low-ctr-opportunities.js.map

package/dist/src/tools/search-console/low-ctr-opportunities.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/low-ctr-opportunities.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  brandTermsSchemaField,\n  buildSearchConsoleQueryBody,\n  classifyBrandLabel,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  scoreQuickWinOpportunity,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  normalizeSearchConsoleRow,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleLowCtrOpportunitiesSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  brandTerms: brandTermsSchemaField,\n  includeBrand: z\n    .enum([\"all\", \"only_brand\", \"only_non_brand\"])\n    .optional()\n    .describe(\"How to filter the query list when brandTerms are provided.\"),\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum impressions required to consider a CTR opportunity.\"),\n  maxCtr: z\n    .number()\n    .min(0)\n    .max(100)\n    .optional()\n    .describe(\"Maximum CTR percentage allowed to count as underperforming.\"),\n  maxPosition: z\n    .number()\n    .min(1)\n    .max(100)\n    .optional()\n    .describe(\"Maximum average position to keep only queries that already rank reasonably well.\"),\n});\n\nexport async function searchConsoleLowCtrOpportunitiesHandler(\n  params: z.infer<typeof searchConsoleLowCtrOpportunitiesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const minImpressions = params.minImpressions ?? 100;\n    const maxCtr = params.maxCtr ?? 4;\n    const maxPosition = params.maxPosition ?? 10;\n    const includeBrand = params.includeBrand ?? \"all\";\n\n    const response = await querySearchConsolePerformance(\n      siteUrl,\n      buildSearchConsoleQueryBody({\n        startDate: params.startDate,\n        endDate: params.endDate,\n        dimensions: [\"query\"],\n        searchType: params.searchType,\n        rowLimit: 250,\n      })\n    );\n\n    const opportunities = (response.rows ?? [])\n      .map((row) => normalizeSearchConsoleRow(row, [\"query\"]))\n      .map((row) => ({\n        query: row.dimensions.query,\n        clicks: row.clicks,\n        impressions: row.impressions,\n        ctr_percent: row.ctr_percent,\n        position: row.position,\n        brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms),\n      }))\n      .filter(\n        (row) =>\n          row.impressions >= minImpressions &&\n          row.ctr_percent <= maxCtr &&\n          row.position > 0 &&\n          row.position <= maxPosition\n      )\n      .filter((row) => {\n        if (includeBrand === \"only_brand\") {\n          return row.brand_classification === \"brand\";\n        }\n\n        if (includeBrand === \"only_non_brand\") {\n          return row.brand_classification === \"non_brand\";\n        }\n\n        return true;\n      })\n      .map((row) => ({\n        ...row,\n        opportunity_score: scoreQuickWinOpportunity({\n          impressions: row.impressions,\n          ctrPercent: row.ctr_percent,\n          position: row.position,\n        }),\n        reason: \"Ranking is already acceptable, so low CTR suggests snippet or title optimization potential.\",\n      }))\n      .sort((left, right) => right.opportunity_score - left.opportunity_score);\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        thresholds: {\n          min_impressions: minImpressions,\n          max_ctr_percent: maxCtr,\n          max_position: maxPosition,\n        },\n        opportunities,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to find Search Console low-CTR opportunities\"\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/search-console/page-performance.js

@@ -0,0 +1,104 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { querySearchConsolePerformance } from "../../services/search-console/search-console-client.js";
+import {
+  buildPaginationMetadata,
+  buildSearchConsoleQueryBody,
+  endDateSchemaField,
+  profileIdSchemaField,
+  resolveSearchConsoleSiteUrl,
+  rowLimitSchemaField,
+  searchTypeSchemaField,
+  siteUrlSchemaField,
+  startDateSchemaField,
+  startRowSchemaField,
+  sumSearchConsoleRows,
+  normalizeSearchConsoleRow
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsolePagePerformanceSchema = z.object({
+  startDate: startDateSchemaField,
+  endDate: endDateSchemaField,
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField,
+  searchType: searchTypeSchemaField,
+  pageContains: z.string().optional().describe("Optional substring that page URLs must contain."),
+  pageRegex: z.string().optional().describe("Optional regex expression to match page URLs."),
+  rowLimit: rowLimitSchemaField,
+  startRow: startRowSchemaField
+});
+async function searchConsolePagePerformanceHandler(params) {
+  try {
+    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const dimensionFilters = [];
+    if (params.pageContains?.trim()) {
+      dimensionFilters.push({
+        dimension: "page",
+        operator: "contains",
+        expression: params.pageContains.trim()
+      });
+    }
+    if (params.pageRegex?.trim()) {
+      dimensionFilters.push({
+        dimension: "page",
+        operator: "includingRegex",
+        expression: params.pageRegex.trim()
+      });
+    }
+    const response = await querySearchConsolePerformance(
+      siteUrl,
+      buildSearchConsoleQueryBody({
+        startDate: params.startDate,
+        endDate: params.endDate,
+        dimensions: ["page"],
+        searchType: params.searchType,
+        dimensionFilters,
+        rowLimit: params.rowLimit,
+        startRow: params.startRow
+      })
+    );
+    const rows = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, ["page"]));
+    const totals = sumSearchConsoleRows(rows);
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        filters: {
+          search_type: params.searchType ?? "web",
+          page_contains: params.pageContains,
+          page_regex: params.pageRegex
+        },
+        overview: {
+          total_clicks: totals.clicks,
+          total_impressions: totals.impressions,
+          average_ctr_percent: totals.ctrPercent,
+          average_position: totals.averagePosition
+        },
+        pages: rows.map((row) => ({
+          page: row.dimensions.page,
+          clicks: row.clicks,
+          impressions: row.impressions,
+          ctr_percent: row.ctr_percent,
+          position: row.position
+        })),
+        metadata: buildPaginationMetadata({
+          startRow: params.startRow,
+          rowLimit: params.rowLimit,
+          returnedRows: rows.length
+        })
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to fetch Search Console page performance"
+    );
+  }
+}
+export {
+  searchConsolePagePerformanceHandler,
+  searchConsolePagePerformanceSchema
+};
+//# sourceMappingURL=page-performance.js.map

package/dist/src/tools/search-console/page-performance.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/page-performance.ts"],
+  "sourcesContent": ["import { error, object } from \"mcp-use/server\";\nimport { z } from \"zod\";\n\nimport { querySearchConsolePerformance } from \"../../services/search-console/search-console-client.js\";\nimport {\n  buildPaginationMetadata,\n  buildSearchConsoleQueryBody,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  rowLimitSchemaField,\n  searchConsoleDimensionFilterSchema,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  startRowSchemaField,\n  sumSearchConsoleRows,\n  normalizeSearchConsoleRow,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsolePagePerformanceSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  pageContains: z\n    .string()\n    .optional()\n    .describe(\"Optional substring that page URLs must contain.\"),\n  pageRegex: z\n    .string()\n    .optional()\n    .describe(\"Optional regex expression to match page URLs.\"),\n  rowLimit: rowLimitSchemaField,\n  startRow: startRowSchemaField,\n});\n\nexport async function searchConsolePagePerformanceHandler(\n  params: z.infer<typeof searchConsolePagePerformanceSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const dimensionFilters = [];\n\n    if (params.pageContains?.trim()) {\n      dimensionFilters.push({\n        dimension: \"page\",\n        operator: \"contains\",\n        expression: params.pageContains.trim(),\n      });\n    }\n\n    if (params.pageRegex?.trim()) {\n      dimensionFilters.push({\n        dimension: \"page\",\n        operator: \"includingRegex\",\n        expression: params.pageRegex.trim(),\n      });\n    }\n\n    const response = await querySearchConsolePerformance(\n      siteUrl,\n      buildSearchConsoleQueryBody({\n        startDate: params.startDate,\n        endDate: params.endDate,\n        dimensions: [\"page\"],\n        searchType: params.searchType,\n        dimensionFilters,\n        rowLimit: params.rowLimit,\n        startRow: params.startRow,\n      })\n    );\n\n    const rows = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, [\"page\"]));\n    const totals = sumSearchConsoleRows(rows);\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        filters: {\n          search_type: params.searchType ?? \"web\",\n          page_contains: params.pageContains,\n          page_regex: params.pageRegex,\n        },\n        overview: {\n          total_clicks: totals.clicks,\n          total_impressions: totals.impressions,\n          average_ctr_percent: totals.ctrPercent,\n          average_position: totals.averagePosition,\n        },\n        pages: rows.map((row) => ({\n          page: row.dimensions.page,\n          clicks: row.clicks,\n          impressions: row.impressions,\n          ctr_percent: row.ctr_percent,\n          position: row.position,\n        })),\n        metadata: buildPaginationMetadata({\n          startRow: params.startRow,\n          rowLimit: params.rowLimit,\n          returnedRows: rows.length,\n        }),\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Search Console page performance\"\n    );\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,OAAO,cAAc;AAC9B,SAAS,SAAS;AAElB,SAAS,qCAAqC;AAC9C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,qCAAqC,EAAE,OAAO;AAAA,EACzD,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,cAAc,EACX,OAAO,EACP,SAAS,EACT,SAAS,iDAAiD;AAAA,EAC7D,WAAW,EACR,OAAO,EACP,SAAS,EACT,SAAS,+CAA+C;AAAA,EAC3D,UAAU;AAAA,EACV,UAAU;AACZ,CAAC;AAED,eAAsB,oCACpB,QACA;AACA,MAAI;AACF,UAAM,UAAU,4BAA4B,OAAO,SAAS,OAAO,SAAS;AAC5E,UAAM,mBAAmB,CAAC;AAE1B,QAAI,OAAO,cAAc,KAAK,GAAG;AAC/B,uBAAiB,KAAK;AAAA,QACpB,WAAW;AAAA,QACX,UAAU;AAAA,QACV,YAAY,OAAO,aAAa,KAAK;AAAA,MACvC,CAAC;AAAA,IACH;AAEA,QAAI,OAAO,WAAW,KAAK,GAAG;AAC5B,uBAAiB,KAAK;AAAA,QACpB,WAAW;AAAA,QACX,UAAU;AAAA,QACV,YAAY,OAAO,UAAU,KAAK;AAAA,MACpC,CAAC;AAAA,IACH;AAEA,UAAM,WAAW,MAAM;AAAA,MACrB;AAAA,MACA,4BAA4B;AAAA,QAC1B,WAAW,OAAO;AAAA,QAClB,SAAS,OAAO;AAAA,QAChB,YAAY,CAAC,MAAM;AAAA,QACnB,YAAY,OAAO;AAAA,QACnB;AAAA,QACA,UAAU,OAAO;AAAA,QACjB,UAAU,OAAO;AAAA,MACnB,CAAC;AAAA,IACH;AAEA,UAAM,QAAQ,SAAS,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,0BAA0B,KAAK,CAAC,MAAM,CAAC,CAAC;AACxF,UAAM,SAAS,qBAAqB,IAAI;AAExC,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,QACV,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,SAAS;AAAA,UACP,aAAa,OAAO,cAAc;AAAA,UAClC,eAAe,OAAO;AAAA,UACtB,YAAY,OAAO;AAAA,QACrB;AAAA,QACA,UAAU;AAAA,UACR,cAAc,OAAO;AAAA,UACrB,mBAAmB,OAAO;AAAA,UAC1B,qBAAqB,OAAO;AAAA,UAC5B,kBAAkB,OAAO;AAAA,QAC3B;AAAA,QACA,OAAO,KAAK,IAAI,CAAC,SAAS;AAAA,UACxB,MAAM,IAAI,WAAW;AAAA,UACrB,QAAQ,IAAI;AAAA,UACZ,aAAa,IAAI;AAAA,UACjB,aAAa,IAAI;AAAA,UACjB,UAAU,IAAI;AAAA,QAChB,EAAE;AAAA,QACF,UAAU,wBAAwB;AAAA,UAChC,UAAU,OAAO;AAAA,UACjB,UAAU,OAAO;AAAA,UACjB,cAAc,KAAK;AAAA,QACrB,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AAAA,EACF,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/tools/search-console/product-demand-low-capture-queries.js

@@ -0,0 +1,93 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { querySearchConsolePerformance } from "../../services/search-console/search-console-client.js";
+import {
+  brandTermsSchemaField,
+  buildSearchConsoleQueryBody,
+  classifyBrandLabel,
+  endDateSchemaField,
+  looksLikeProductQuery,
+  profileIdSchemaField,
+  resolveSearchConsoleSiteUrl,
+  rowLimitSchemaField,
+  searchTypeSchemaField,
+  siteUrlSchemaField,
+  startDateSchemaField,
+  normalizeSearchConsoleRow,
+  scoreHighImpressionLowClickOpportunity
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsoleProductDemandLowCaptureQueriesSchema = z.object({
+  startDate: startDateSchemaField,
+  endDate: endDateSchemaField,
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField,
+  searchType: searchTypeSchemaField,
+  brandTerms: brandTermsSchemaField,
+  productTerms: z.array(z.string().min(1)).max(100).optional().describe("Optional product tokens used to better detect product-intent queries."),
+  minImpressions: z.number().min(1).optional().describe("Minimum impressions required to consider a product query."),
+  maxCtr: z.number().min(0).max(100).optional().describe("Maximum CTR percentage allowed to count as low capture."),
+  maxPosition: z.number().min(1).max(100).optional().describe("Maximum average position allowed to keep only queries with some ranking potential."),
+  rowLimit: rowLimitSchemaField
+});
+async function searchConsoleProductDemandLowCaptureQueriesHandler(params) {
+  try {
+    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const minImpressions = params.minImpressions ?? 80;
+    const maxCtr = params.maxCtr ?? 4;
+    const maxPosition = params.maxPosition ?? 20;
+    const response = await querySearchConsolePerformance(
+      siteUrl,
+      buildSearchConsoleQueryBody({
+        startDate: params.startDate,
+        endDate: params.endDate,
+        dimensions: ["query", "page"],
+        searchType: params.searchType,
+        rowLimit: params.rowLimit ?? 250
+      })
+    );
+    const opportunities = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, ["query", "page"])).filter((row) => looksLikeProductQuery(row.dimensions.query, params.productTerms)).map((row) => ({
+      query: row.dimensions.query,
+      page: row.dimensions.page,
+      clicks: row.clicks,
+      impressions: row.impressions,
+      ctr_percent: row.ctr_percent,
+      position: row.position,
+      brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms)
+    })).filter(
+      (row) => row.impressions >= minImpressions && row.ctr_percent <= maxCtr && row.position > 0 && row.position <= maxPosition
+    ).map((row) => ({
+      ...row,
+      opportunity_score: scoreHighImpressionLowClickOpportunity({
+        impressions: row.impressions,
+        ctrPercent: row.ctr_percent,
+        position: row.position
+      }),
+      reason: "Product-intent query shows demand but weak click capture."
+    })).sort((left, right) => right.opportunity_score - left.opportunity_score);
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        thresholds: {
+          min_impressions: minImpressions,
+          max_ctr_percent: maxCtr,
+          max_position: maxPosition
+        },
+        opportunities
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to find Search Console product demand low-capture queries"
+    );
+  }
+}
+export {
+  searchConsoleProductDemandLowCaptureQueriesHandler,
+  searchConsoleProductDemandLowCaptureQueriesSchema
+};
+//# sourceMappingURL=product-demand-low-capture-queries.js.map