@yoryoboy/bi-mcp 1.0.1

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/product-demand-low-capture-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  looksLikeProductQuery,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  rowLimitSchemaField,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  normalizeSearchConsoleRow,\n  scoreHighImpressionLowClickOpportunity,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleProductDemandLowCaptureQueriesSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  brandTerms: brandTermsSchemaField,\n  productTerms: z\n    .array(z.string().min(1))\n    .max(100)\n    .optional()\n    .describe(\"Optional product tokens used to better detect product-intent queries.\"),\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum impressions required to consider a product query.\"),\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  maxPosition: z\n    .number()\n    .min(1)\n    .max(100)\n    .optional()\n    .describe(\"Maximum average position allowed to keep only queries with some ranking potential.\"),\n  rowLimit: rowLimitSchemaField,\n});\n\nexport async function searchConsoleProductDemandLowCaptureQueriesHandler(\n  params: z.infer<typeof searchConsoleProductDemandLowCaptureQueriesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const minImpressions = params.minImpressions ?? 80;\n    const maxCtr = params.maxCtr ?? 4;\n    const maxPosition = params.maxPosition ?? 20;\n\n    const response = await querySearchConsolePerformance(\n      siteUrl,\n      buildSearchConsoleQueryBody({\n        startDate: params.startDate,\n        endDate: params.endDate,\n        dimensions: [\"query\", \"page\"],\n        searchType: params.searchType,\n        rowLimit: params.rowLimit ?? 250,\n      })\n    );\n\n    const opportunities = (response.rows ?? [])\n      .map((row) => normalizeSearchConsoleRow(row, [\"query\", \"page\"]))\n      .filter((row) => looksLikeProductQuery(row.dimensions.query, params.productTerms))\n      .map((row) => ({\n        query: row.dimensions.query,\n        page: row.dimensions.page,\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      .map((row) => ({\n        ...row,\n        opportunity_score: scoreHighImpressionLowClickOpportunity({\n          impressions: row.impressions,\n          ctrPercent: row.ctr_percent,\n          position: row.position,\n        }),\n        reason: \"Product-intent query shows demand but weak 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          max_position: maxPosition,\n        },\n        opportunities,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error\n        ? err.message\n        : \"Failed to find Search Console product demand low-capture queries\"\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/tools/search-console/query-page-matrix.js

@@ -0,0 +1,99 @@
+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,
+  normalizeSearchConsoleRow
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsoleQueryPageMatrixSchema = z.object({
+  startDate: startDateSchemaField,
+  endDate: endDateSchemaField,
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField,
+  searchType: searchTypeSchemaField,
+  queryContains: z.string().optional().describe("Optional substring that queries must contain."),
+  pageContains: z.string().optional().describe("Optional substring that landing pages must contain."),
+  rowLimit: rowLimitSchemaField,
+  startRow: startRowSchemaField
+});
+async function searchConsoleQueryPageMatrixHandler(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: ["query", "page"],
+        searchType: params.searchType,
+        dimensionFilters,
+        rowLimit: params.rowLimit,
+        startRow: params.startRow
+      })
+    );
+    const rows = (response.rows ?? []).map(
+      (row) => normalizeSearchConsoleRow(row, ["query", "page"])
+    );
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        filters: {
+          search_type: params.searchType ?? "web",
+          query_contains: params.queryContains,
+          page_contains: params.pageContains
+        },
+        rows: rows.map((row) => ({
+          query: row.dimensions.query,
+          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 query-page matrix"
+    );
+  }
+}
+export {
+  searchConsoleQueryPageMatrixHandler,
+  searchConsoleQueryPageMatrixSchema
+};
+//# sourceMappingURL=query-page-matrix.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/query-page-matrix.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  searchTypeSchemaField,\n  siteUrlSchemaField,\n  startDateSchemaField,\n  startRowSchemaField,\n  normalizeSearchConsoleRow,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleQueryPageMatrixSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  queryContains: z\n    .string()\n    .optional()\n    .describe(\"Optional substring that queries must contain.\"),\n  pageContains: z\n    .string()\n    .optional()\n    .describe(\"Optional substring that landing pages must contain.\"),\n  rowLimit: rowLimitSchemaField,\n  startRow: startRowSchemaField,\n});\n\nexport async function searchConsoleQueryPageMatrixHandler(\n  params: z.infer<typeof searchConsoleQueryPageMatrixSchema>\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: [\"query\", \"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) =>\n      normalizeSearchConsoleRow(row, [\"query\", \"page\"])\n    );\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          query_contains: params.queryContains,\n          page_contains: params.pageContains,\n        },\n        rows: rows.map((row) => ({\n          query: row.dimensions.query,\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 query-page matrix\"\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,EACZ,OAAO,EACP,SAAS,EACT,SAAS,+CAA+C;AAAA,EAC3D,cAAc,EACX,OAAO,EACP,SAAS,EACT,SAAS,qDAAqD;AAAA,EACjE,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,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,SAAS,MAAM;AAAA,QAC5B,YAAY,OAAO;AAAA,QACnB;AAAA,QACA,UAAU,OAAO;AAAA,QACjB,UAAU,OAAO;AAAA,MACnB,CAAC;AAAA,IACH;AAEA,UAAM,QAAQ,SAAS,QAAQ,CAAC,GAAG;AAAA,MAAI,CAAC,QACtC,0BAA0B,KAAK,CAAC,SAAS,MAAM,CAAC;AAAA,IAClD;AAEA,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,gBAAgB,OAAO;AAAA,UACvB,eAAe,OAAO;AAAA,QACxB;AAAA,QACA,MAAM,KAAK,IAAI,CAAC,SAAS;AAAA,UACvB,OAAO,IAAI,WAAW;AAAA,UACtB,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/query-performance.js

@@ -0,0 +1,109 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { querySearchConsolePerformance } from "../../services/search-console/search-console-client.js";
+import {
+  brandTermsSchemaField,
+  buildPaginationMetadata,
+  buildSearchConsoleQueryBody,
+  classifyBrandLabel,
+  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 searchConsoleQueryPerformanceSchema = 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."),
+  rowLimit: rowLimitSchemaField,
+  startRow: startRowSchemaField
+});
+async function searchConsoleQueryPerformanceHandler(params) {
+  try {
+    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const response = await querySearchConsolePerformance(
+      siteUrl,
+      buildSearchConsoleQueryBody({
+        startDate: params.startDate,
+        endDate: params.endDate,
+        dimensions: ["query"],
+        searchType: params.searchType,
+        rowLimit: params.rowLimit,
+        startRow: params.startRow
+      })
+    );
+    const includeBrand = params.includeBrand ?? "all";
+    const rows = (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) => {
+      if (includeBrand === "only_brand") {
+        return row.brand_classification === "brand";
+      }
+      if (includeBrand === "only_non_brand") {
+        return row.brand_classification === "non_brand";
+      }
+      return true;
+    });
+    const totals = sumSearchConsoleRows(
+      rows.map((row) => ({
+        keys: [row.query],
+        dimensions: { query: row.query },
+        clicks: row.clicks,
+        impressions: row.impressions,
+        ctr_percent: row.ctr_percent,
+        position: row.position
+      }))
+    );
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        filters: {
+          search_type: params.searchType ?? "web",
+          include_brand: includeBrand,
+          brand_terms: params.brandTerms
+        },
+        overview: {
+          total_clicks: totals.clicks,
+          total_impressions: totals.impressions,
+          average_ctr_percent: totals.ctrPercent,
+          average_position: totals.averagePosition
+        },
+        queries: rows,
+        metadata: buildPaginationMetadata({
+          startRow: params.startRow,
+          rowLimit: params.rowLimit,
+          returnedRows: response.rows?.length ?? 0
+        })
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to fetch Search Console query performance"
+    );
+  }
+}
+export {
+  searchConsoleQueryPerformanceHandler,
+  searchConsoleQueryPerformanceSchema
+};
+//# sourceMappingURL=query-performance.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/query-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  brandTermsSchemaField,\n  buildPaginationMetadata,\n  buildSearchConsoleQueryBody,\n  classifyBrandLabel,\n  endDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  rowLimitSchemaField,\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 searchConsoleQueryPerformanceSchema = 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  rowLimit: rowLimitSchemaField,\n  startRow: startRowSchemaField,\n});\n\nexport async function searchConsoleQueryPerformanceHandler(\n  params: z.infer<typeof searchConsoleQueryPerformanceSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\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,\n        startRow: params.startRow,\n      })\n    );\n\n    const includeBrand = params.includeBrand ?? \"all\";\n    const rows = (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) => {\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\n    const totals = sumSearchConsoleRows(\n      rows.map((row) => ({\n        keys: [row.query],\n        dimensions: { query: row.query },\n        clicks: row.clicks,\n        impressions: row.impressions,\n        ctr_percent: row.ctr_percent,\n        position: row.position,\n      }))\n    );\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          include_brand: includeBrand,\n          brand_terms: params.brandTerms,\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        queries: rows,\n        metadata: buildPaginationMetadata({\n          startRow: params.startRow,\n          rowLimit: params.rowLimit,\n          returnedRows: response.rows?.length ?? 0,\n        }),\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to fetch Search Console query 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,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,sCAAsC,EAAE,OAAO;AAAA,EAC1D,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,UAAU;AAAA,EACV,UAAU;AACZ,CAAC;AAED,eAAsB,qCACpB,QACA;AACA,MAAI;AACF,UAAM,UAAU,4BAA4B,OAAO,SAAS,OAAO,SAAS;AAC5E,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;AAAA,QACjB,UAAU,OAAO;AAAA,MACnB,CAAC;AAAA,IACH;AAEA,UAAM,eAAe,OAAO,gBAAgB;AAC5C,UAAM,QAAQ,SAAS,QAAQ,CAAC,GAC7B,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;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;AAEH,UAAM,SAAS;AAAA,MACb,KAAK,IAAI,CAAC,SAAS;AAAA,QACjB,MAAM,CAAC,IAAI,KAAK;AAAA,QAChB,YAAY,EAAE,OAAO,IAAI,MAAM;AAAA,QAC/B,QAAQ,IAAI;AAAA,QACZ,aAAa,IAAI;AAAA,QACjB,aAAa,IAAI;AAAA,QACjB,UAAU,IAAI;AAAA,MAChB,EAAE;AAAA,IACJ;AAEA,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;AAAA,UACf,aAAa,OAAO;AAAA,QACtB;AAAA,QACA,UAAU;AAAA,UACR,cAAc,OAAO;AAAA,UACrB,mBAAmB,OAAO;AAAA,UAC1B,qBAAqB,OAAO;AAAA,UAC5B,kBAAkB,OAAO;AAAA,QAC3B;AAAA,QACA,SAAS;AAAA,QACT,UAAU,wBAAwB;AAAA,UAChC,UAAU,OAAO;AAAA,UACjB,UAAU,OAAO;AAAA,UACjB,cAAc,SAAS,MAAM,UAAU;AAAA,QACzC,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/quick-win-opportunities.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,
+  classifyQuickWinType,
+  endDateSchemaField,
+  profileIdSchemaField,
+  resolveSearchConsoleSiteUrl,
+  scoreQuickWinOpportunity,
+  searchTypeSchemaField,
+  siteUrlSchemaField,
+  startDateSchemaField,
+  normalizeSearchConsoleRow
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsoleQuickWinOpportunitiesSchema = z.object({
+  startDate: startDateSchemaField,
+  endDate: endDateSchemaField,
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField,
+  searchType: searchTypeSchemaField,
+  brandTerms: brandTermsSchemaField,
+  minImpressions: z.number().min(1).optional().describe("Minimum impressions required to consider a quick win."),
+  quickWinMode: z.enum(["ctr", "position", "mixed"]).optional().describe("Whether to prioritize CTR fixes, ranking improvements, or both.")
+});
+async function searchConsoleQuickWinOpportunitiesHandler(params) {
+  try {
+    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const minImpressions = params.minImpressions ?? 80;
+    const quickWinMode = params.quickWinMode ?? "mixed";
+    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"])).filter((row) => row.impressions >= minImpressions).map((row) => {
+      const quickWinType = classifyQuickWinType(row.position, row.ctr_percent);
+      return {
+        query: row.dimensions.query,
+        clicks: row.clicks,
+        impressions: row.impressions,
+        ctr_percent: row.ctr_percent,
+        position: row.position,
+        quick_win_type: quickWinType,
+        brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms),
+        opportunity_score: scoreQuickWinOpportunity({
+          impressions: row.impressions,
+          ctrPercent: row.ctr_percent,
+          position: row.position
+        })
+      };
+    }).filter((row) => {
+      if (quickWinMode === "mixed") {
+        return row.position > 0 && row.position <= 20;
+      }
+      return row.quick_win_type === quickWinMode;
+    }).sort((left, right) => right.opportunity_score - left.opportunity_score).map((row) => ({
+      ...row,
+      reason: row.quick_win_type === "ctr" ? "The query already ranks fairly well, so a CTR lift is the fastest path." : "The query has traction, but ranking improvement appears to be the faster lever."
+    }));
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        thresholds: {
+          min_impressions: minImpressions,
+          quick_win_mode: quickWinMode
+        },
+        opportunities
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to find Search Console quick-win opportunities"
+    );
+  }
+}
+export {
+  searchConsoleQuickWinOpportunitiesHandler,
+  searchConsoleQuickWinOpportunitiesSchema
+};
+//# sourceMappingURL=quick-win-opportunities.js.map

package/dist/src/tools/search-console/quick-win-opportunities.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/quick-win-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  classifyQuickWinType,\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 searchConsoleQuickWinOpportunitiesSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  brandTerms: brandTermsSchemaField,\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum impressions required to consider a quick win.\"),\n  quickWinMode: z\n    .enum([\"ctr\", \"position\", \"mixed\"])\n    .optional()\n    .describe(\"Whether to prioritize CTR fixes, ranking improvements, or both.\"),\n});\n\nexport async function searchConsoleQuickWinOpportunitiesHandler(\n  params: z.infer<typeof searchConsoleQuickWinOpportunitiesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const minImpressions = params.minImpressions ?? 80;\n    const quickWinMode = params.quickWinMode ?? \"mixed\";\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      .filter((row) => row.impressions >= minImpressions)\n      .map((row) => {\n        const quickWinType = classifyQuickWinType(row.position, row.ctr_percent);\n        return {\n          query: row.dimensions.query,\n          clicks: row.clicks,\n          impressions: row.impressions,\n          ctr_percent: row.ctr_percent,\n          position: row.position,\n          quick_win_type: quickWinType,\n          brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms),\n          opportunity_score: scoreQuickWinOpportunity({\n            impressions: row.impressions,\n            ctrPercent: row.ctr_percent,\n            position: row.position,\n          }),\n        };\n      })\n      .filter((row) => {\n        if (quickWinMode === \"mixed\") {\n          return row.position > 0 && row.position <= 20;\n        }\n\n        return row.quick_win_type === quickWinMode;\n      })\n      .sort((left, right) => right.opportunity_score - left.opportunity_score)\n      .map((row) => ({\n        ...row,\n        reason:\n          row.quick_win_type === \"ctr\"\n            ? \"The query already ranks fairly well, so a CTR lift is the fastest path.\"\n            : \"The query has traction, but ranking improvement appears to be the faster lever.\",\n      }));\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          quick_win_mode: quickWinMode,\n        },\n        opportunities,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to find Search Console quick-win opportunities\"\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,2CAA2C,EAAE,OAAO;AAAA,EAC/D,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,gBAAgB,EACb,OAAO,EACP,IAAI,CAAC,EACL,SAAS,EACT,SAAS,uDAAuD;AAAA,EACnE,cAAc,EACX,KAAK,CAAC,OAAO,YAAY,OAAO,CAAC,EACjC,SAAS,EACT,SAAS,iEAAiE;AAC/E,CAAC;AAED,eAAsB,0CACpB,QACA;AACA,MAAI;AACF,UAAM,UAAU,4BAA4B,OAAO,SAAS,OAAO,SAAS;AAC5E,UAAM,iBAAiB,OAAO,kBAAkB;AAChD,UAAM,eAAe,OAAO,gBAAgB;AAE5C,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;AAAA,MACZ,CAAC;AAAA,IACH;AAEA,UAAM,iBAAiB,SAAS,QAAQ,CAAC,GACtC,IAAI,CAAC,QAAQ,0BAA0B,KAAK,CAAC,OAAO,CAAC,CAAC,EACtD,OAAO,CAAC,QAAQ,IAAI,eAAe,cAAc,EACjD,IAAI,CAAC,QAAQ;AACZ,YAAM,eAAe,qBAAqB,IAAI,UAAU,IAAI,WAAW;AACvE,aAAO;AAAA,QACL,OAAO,IAAI,WAAW;AAAA,QACtB,QAAQ,IAAI;AAAA,QACZ,aAAa,IAAI;AAAA,QACjB,aAAa,IAAI;AAAA,QACjB,UAAU,IAAI;AAAA,QACd,gBAAgB;AAAA,QAChB,sBAAsB,mBAAmB,IAAI,WAAW,OAAO,OAAO,UAAU;AAAA,QAChF,mBAAmB,yBAAyB;AAAA,UAC1C,aAAa,IAAI;AAAA,UACjB,YAAY,IAAI;AAAA,UAChB,UAAU,IAAI;AAAA,QAChB,CAAC;AAAA,MACH;AAAA,IACF,CAAC,EACA,OAAO,CAAC,QAAQ;AACf,UAAI,iBAAiB,SAAS;AAC5B,eAAO,IAAI,WAAW,KAAK,IAAI,YAAY;AAAA,MAC7C;AAEA,aAAO,IAAI,mBAAmB;AAAA,IAChC,CAAC,EACA,KAAK,CAAC,MAAM,UAAU,MAAM,oBAAoB,KAAK,iBAAiB,EACtE,IAAI,CAAC,SAAS;AAAA,MACb,GAAG;AAAA,MACH,QACE,IAAI,mBAAmB,QACnB,4EACA;AAAA,IACR,EAAE;AAEJ,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,gBAAgB;AAAA,QAClB;AAAA,QACA;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/rising-non-brand-queries.js

@@ -0,0 +1,121 @@
+import { error, object } from "mcp-use/server";
+import { z } from "zod";
+import { querySearchConsolePerformance } from "../../services/search-console/search-console-client.js";
+import {
+  brandTermsSchemaField,
+  buildComparisonMap,
+  buildSearchConsoleQueryBody,
+  classifyBrandLabel,
+  computeChangePercent,
+  currentEndDateSchemaField,
+  currentStartDateSchemaField,
+  previousEndDateSchemaField,
+  previousStartDateSchemaField,
+  profileIdSchemaField,
+  resolveSearchConsoleSiteUrl,
+  searchTypeSchemaField,
+  siteUrlSchemaField,
+  normalizeSearchConsoleRow
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsoleRisingNonBrandQueriesSchema = z.object({
+  currentStartDate: currentStartDateSchemaField,
+  currentEndDate: currentEndDateSchemaField,
+  previousStartDate: previousStartDateSchemaField,
+  previousEndDate: previousEndDateSchemaField,
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField,
+  searchType: searchTypeSchemaField,
+  brandTerms: brandTermsSchemaField,
+  minImpressions: z.number().min(1).optional().describe("Minimum current-period impressions required to include a query."),
+  minGrowthRate: z.number().min(0).optional().describe("Minimum impressions growth percentage required to consider a query rising.")
+});
+async function searchConsoleRisingNonBrandQueriesHandler(params) {
+  try {
+    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const minImpressions = params.minImpressions ?? 50;
+    const minGrowthRate = params.minGrowthRate ?? 20;
+    const [currentResponse, previousResponse] = await Promise.all([
+      querySearchConsolePerformance(
+        siteUrl,
+        buildSearchConsoleQueryBody({
+          startDate: params.currentStartDate,
+          endDate: params.currentEndDate,
+          dimensions: ["query"],
+          searchType: params.searchType,
+          rowLimit: 250
+        })
+      ),
+      querySearchConsolePerformance(
+        siteUrl,
+        buildSearchConsoleQueryBody({
+          startDate: params.previousStartDate,
+          endDate: params.previousEndDate,
+          dimensions: ["query"],
+          searchType: params.searchType,
+          rowLimit: 250
+        })
+      )
+    ]);
+    const currentRows = (currentResponse.rows ?? []).map(
+      (row) => normalizeSearchConsoleRow(row, ["query"])
+    );
+    const previousRows = (previousResponse.rows ?? []).map(
+      (row) => normalizeSearchConsoleRow(row, ["query"])
+    );
+    const previousMap = buildComparisonMap(previousRows, (row) => row.dimensions.query);
+    const risingQueries = currentRows.map((row) => {
+      const previousRow = previousMap.get(row.dimensions.query);
+      return {
+        query: row.dimensions.query,
+        current_clicks: row.clicks,
+        previous_clicks: previousRow?.clicks ?? 0,
+        current_impressions: row.impressions,
+        previous_impressions: previousRow?.impressions ?? 0,
+        current_ctr_percent: row.ctr_percent,
+        previous_ctr_percent: previousRow?.ctr_percent ?? 0,
+        current_position: row.position,
+        previous_position: previousRow?.position ?? 0,
+        brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms)
+      };
+    }).filter((row) => row.brand_classification === "non_brand").filter((row) => row.current_impressions >= minImpressions).map((row) => ({
+      ...row,
+      impressions_growth_percent: computeChangePercent(
+        row.current_impressions,
+        row.previous_impressions
+      ),
+      clicks_growth_percent: computeChangePercent(row.current_clicks, row.previous_clicks)
+    })).filter((row) => (row.impressions_growth_percent ?? 0) >= minGrowthRate).sort(
+      (left, right) => (right.impressions_growth_percent ?? 0) - (left.impressions_growth_percent ?? 0)
+    );
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        comparison: {
+          current_period: {
+            start_date: params.currentStartDate,
+            end_date: params.currentEndDate
+          },
+          previous_period: {
+            start_date: params.previousStartDate,
+            end_date: params.previousEndDate
+          }
+        },
+        thresholds: {
+          min_impressions: minImpressions,
+          min_growth_rate_percent: minGrowthRate
+        },
+        rising_queries: risingQueries
+      })
+    );
+  } catch (err) {
+    return error(
+      err instanceof Error ? err.message : "Failed to find Search Console rising non-brand queries"
+    );
+  }
+}
+export {
+  searchConsoleRisingNonBrandQueriesHandler,
+  searchConsoleRisingNonBrandQueriesSchema
+};
+//# sourceMappingURL=rising-non-brand-queries.js.map

package/dist/src/tools/search-console/rising-non-brand-queries.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/rising-non-brand-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  buildComparisonMap,\n  buildSearchConsoleQueryBody,\n  classifyBrandLabel,\n  computeChangePercent,\n  currentEndDateSchemaField,\n  currentStartDateSchemaField,\n  previousEndDateSchemaField,\n  previousStartDateSchemaField,\n  profileIdSchemaField,\n  resolveSearchConsoleSiteUrl,\n  searchTypeSchemaField,\n  siteUrlSchemaField,\n  normalizeSearchConsoleRow,\n} from \"../../search-console/search-console-utils.js\";\nimport { stripNulls } from \"../../utils/strip-payload.js\";\n\nexport const searchConsoleRisingNonBrandQueriesSchema = z.object({\n  currentStartDate: currentStartDateSchemaField,\n  currentEndDate: currentEndDateSchemaField,\n  previousStartDate: previousStartDateSchemaField,\n  previousEndDate: previousEndDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  searchType: searchTypeSchemaField,\n  brandTerms: brandTermsSchemaField,\n  minImpressions: z\n    .number()\n    .min(1)\n    .optional()\n    .describe(\"Minimum current-period impressions required to include a query.\"),\n  minGrowthRate: z\n    .number()\n    .min(0)\n    .optional()\n    .describe(\"Minimum impressions growth percentage required to consider a query rising.\"),\n});\n\nexport async function searchConsoleRisingNonBrandQueriesHandler(\n  params: z.infer<typeof searchConsoleRisingNonBrandQueriesSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const minImpressions = params.minImpressions ?? 50;\n    const minGrowthRate = params.minGrowthRate ?? 20;\n\n    const [currentResponse, previousResponse] = await Promise.all([\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.currentStartDate,\n          endDate: params.currentEndDate,\n          dimensions: [\"query\"],\n          searchType: params.searchType,\n          rowLimit: 250,\n        })\n      ),\n      querySearchConsolePerformance(\n        siteUrl,\n        buildSearchConsoleQueryBody({\n          startDate: params.previousStartDate,\n          endDate: params.previousEndDate,\n          dimensions: [\"query\"],\n          searchType: params.searchType,\n          rowLimit: 250,\n        })\n      ),\n    ]);\n\n    const currentRows = (currentResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"query\"])\n    );\n    const previousRows = (previousResponse.rows ?? []).map((row) =>\n      normalizeSearchConsoleRow(row, [\"query\"])\n    );\n    const previousMap = buildComparisonMap(previousRows, (row) => row.dimensions.query);\n\n    const risingQueries = currentRows\n      .map((row) => {\n        const previousRow = previousMap.get(row.dimensions.query);\n        return {\n          query: row.dimensions.query,\n          current_clicks: row.clicks,\n          previous_clicks: previousRow?.clicks ?? 0,\n          current_impressions: row.impressions,\n          previous_impressions: previousRow?.impressions ?? 0,\n          current_ctr_percent: row.ctr_percent,\n          previous_ctr_percent: previousRow?.ctr_percent ?? 0,\n          current_position: row.position,\n          previous_position: previousRow?.position ?? 0,\n          brand_classification: classifyBrandLabel(row.dimensions.query, params.brandTerms),\n        };\n      })\n      .filter((row) => row.brand_classification === \"non_brand\")\n      .filter((row) => row.current_impressions >= minImpressions)\n      .map((row) => ({\n        ...row,\n        impressions_growth_percent: computeChangePercent(\n          row.current_impressions,\n          row.previous_impressions\n        ),\n        clicks_growth_percent: computeChangePercent(row.current_clicks, row.previous_clicks),\n      }))\n      .filter((row) => (row.impressions_growth_percent ?? 0) >= minGrowthRate)\n      .sort(\n        (left, right) =>\n          (right.impressions_growth_percent ?? 0) - (left.impressions_growth_percent ?? 0)\n      );\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        comparison: {\n          current_period: {\n            start_date: params.currentStartDate,\n            end_date: params.currentEndDate,\n          },\n          previous_period: {\n            start_date: params.previousStartDate,\n            end_date: params.previousEndDate,\n          },\n        },\n        thresholds: {\n          min_impressions: minImpressions,\n          min_growth_rate_percent: minGrowthRate,\n        },\n        rising_queries: risingQueries,\n      })\n    );\n  } catch (err) {\n    return error(\n      err instanceof Error ? err.message : \"Failed to find Search Console rising non-brand queries\"\n    );\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,89 @@
+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,
+  searchConsoleAggregationTypes,
+  searchConsoleDimensionFilterSchema,
+  searchConsoleDimensions,
+  searchTypeSchemaField,
+  siteUrlSchemaField,
+  startDateSchemaField,
+  startRowSchemaField,
+  sumSearchConsoleRows,
+  normalizeSearchConsoleRow
+} from "../../search-console/search-console-utils.js";
+import { stripNulls } from "../../utils/strip-payload.js";
+const searchConsoleSearchPerformanceSchema = z.object({
+  startDate: startDateSchemaField,
+  endDate: endDateSchemaField,
+  siteUrl: siteUrlSchemaField,
+  profileId: profileIdSchemaField,
+  dimensions: z.array(z.enum(searchConsoleDimensions)).max(5).optional().describe("Dimensions to group the Search Console query by."),
+  searchType: searchTypeSchemaField,
+  dimensionFilters: z.array(searchConsoleDimensionFilterSchema).max(10).optional().describe("Optional Search Console dimension filters."),
+  aggregationType: z.enum(searchConsoleAggregationTypes).optional().describe("Aggregation type for the Search Console query."),
+  rowLimit: rowLimitSchemaField,
+  startRow: startRowSchemaField
+});
+async function searchConsoleSearchPerformanceHandler(params) {
+  try {
+    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);
+    const dimensions = params.dimensions ?? [];
+    const body = buildSearchConsoleQueryBody({
+      startDate: params.startDate,
+      endDate: params.endDate,
+      dimensions,
+      searchType: params.searchType,
+      dimensionFilters: params.dimensionFilters,
+      aggregationType: params.aggregationType,
+      rowLimit: params.rowLimit,
+      startRow: params.startRow
+    });
+    const response = await querySearchConsolePerformance(siteUrl, body);
+    const rows = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, dimensions));
+    const totals = sumSearchConsoleRows(rows);
+    return object(
+      stripNulls({
+        site_url: siteUrl,
+        profile_id: params.profileId?.trim() || void 0,
+        date_range: {
+          start_date: params.startDate,
+          end_date: params.endDate
+        },
+        query: {
+          dimensions,
+          search_type: params.searchType ?? "web",
+          aggregation_type: params.aggregationType ?? response.responseAggregationType,
+          dimension_filters: params.dimensionFilters
+        },
+        overview: {
+          total_clicks: totals.clicks,
+          total_impressions: totals.impressions,
+          average_ctr_percent: totals.ctrPercent,
+          average_position: totals.averagePosition
+        },
+        rows,
+        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 search performance"
+    );
+  }
+}
+export {
+  searchConsoleSearchPerformanceHandler,
+  searchConsoleSearchPerformanceSchema
+};
+//# sourceMappingURL=search-performance.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/search-console/search-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  searchConsoleAggregationTypes,\n  searchConsoleDimensionFilterSchema,\n  searchConsoleDimensions,\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 searchConsoleSearchPerformanceSchema = z.object({\n  startDate: startDateSchemaField,\n  endDate: endDateSchemaField,\n  siteUrl: siteUrlSchemaField,\n  profileId: profileIdSchemaField,\n  dimensions: z\n    .array(z.enum(searchConsoleDimensions))\n    .max(5)\n    .optional()\n    .describe(\"Dimensions to group the Search Console query by.\"),\n  searchType: searchTypeSchemaField,\n  dimensionFilters: z\n    .array(searchConsoleDimensionFilterSchema)\n    .max(10)\n    .optional()\n    .describe(\"Optional Search Console dimension filters.\"),\n  aggregationType: z\n    .enum(searchConsoleAggregationTypes)\n    .optional()\n    .describe(\"Aggregation type for the Search Console query.\"),\n  rowLimit: rowLimitSchemaField,\n  startRow: startRowSchemaField,\n});\n\nexport async function searchConsoleSearchPerformanceHandler(\n  params: z.infer<typeof searchConsoleSearchPerformanceSchema>\n) {\n  try {\n    const siteUrl = resolveSearchConsoleSiteUrl(params.siteUrl, params.profileId);\n    const dimensions = params.dimensions ?? [];\n    const body = buildSearchConsoleQueryBody({\n      startDate: params.startDate,\n      endDate: params.endDate,\n      dimensions,\n      searchType: params.searchType,\n      dimensionFilters: params.dimensionFilters,\n      aggregationType: params.aggregationType,\n      rowLimit: params.rowLimit,\n      startRow: params.startRow,\n    });\n\n    const response = await querySearchConsolePerformance(siteUrl, body);\n    const rows = (response.rows ?? []).map((row) => normalizeSearchConsoleRow(row, dimensions));\n    const totals = sumSearchConsoleRows(rows);\n\n    return object(\n      stripNulls({\n        site_url: siteUrl,\n        profile_id: params.profileId?.trim() || undefined,\n        date_range: {\n          start_date: params.startDate,\n          end_date: params.endDate,\n        },\n        query: {\n          dimensions,\n          search_type: params.searchType ?? \"web\",\n          aggregation_type: params.aggregationType ?? response.responseAggregationType,\n          dimension_filters: params.dimensionFilters,\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        rows,\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 search 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,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,kBAAkB;AAEpB,MAAM,uCAAuC,EAAE,OAAO;AAAA,EAC3D,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY,EACT,MAAM,EAAE,KAAK,uBAAuB,CAAC,EACrC,IAAI,CAAC,EACL,SAAS,EACT,SAAS,kDAAkD;AAAA,EAC9D,YAAY;AAAA,EACZ,kBAAkB,EACf,MAAM,kCAAkC,EACxC,IAAI,EAAE,EACN,SAAS,EACT,SAAS,4CAA4C;AAAA,EACxD,iBAAiB,EACd,KAAK,6BAA6B,EAClC,SAAS,EACT,SAAS,gDAAgD;AAAA,EAC5D,UAAU;AAAA,EACV,UAAU;AACZ,CAAC;AAED,eAAsB,sCACpB,QACA;AACA,MAAI;AACF,UAAM,UAAU,4BAA4B,OAAO,SAAS,OAAO,SAAS;AAC5E,UAAM,aAAa,OAAO,cAAc,CAAC;AACzC,UAAM,OAAO,4BAA4B;AAAA,MACvC,WAAW,OAAO;AAAA,MAClB,SAAS,OAAO;AAAA,MAChB;AAAA,MACA,YAAY,OAAO;AAAA,MACnB,kBAAkB,OAAO;AAAA,MACzB,iBAAiB,OAAO;AAAA,MACxB,UAAU,OAAO;AAAA,MACjB,UAAU,OAAO;AAAA,IACnB,CAAC;AAED,UAAM,WAAW,MAAM,8BAA8B,SAAS,IAAI;AAClE,UAAM,QAAQ,SAAS,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,0BAA0B,KAAK,UAAU,CAAC;AAC1F,UAAM,SAAS,qBAAqB,IAAI;AAExC,WAAO;AAAA,MACL,WAAW;AAAA,QACT,UAAU;AAAA,QACV,YAAY,OAAO,WAAW,KAAK,KAAK;AAAA,QACxC,YAAY;AAAA,UACV,YAAY,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,QACnB;AAAA,QACA,OAAO;AAAA,UACL;AAAA,UACA,aAAa,OAAO,cAAc;AAAA,UAClC,kBAAkB,OAAO,mBAAmB,SAAS;AAAA,UACrD,mBAAmB,OAAO;AAAA,QAC5B;AAAA,QACA,UAAU;AAAA,UACR,cAAc,OAAO;AAAA,UACrB,mBAAmB,OAAO;AAAA,UAC1B,qBAAqB,OAAO;AAAA,UAC5B,kBAAkB,OAAO;AAAA,QAC3B;AAAA,QACA;AAAA,QACA,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": []
+}