@canonry/canonry 7.65.1 → 7.66.0

package/dist/{chunk-GM5ZOWBK.js → chunk-VGUZPC3I.js}

@@ -6,12 +6,12 @@ import {
 import {
   createApiClient,
   runWithUsageTags
-} from "./chunk-F7NZEUXP.js";
+} from "./chunk-EIMXB6UH.js";
 import {
   canonryMcpTools,
   mcpOutputSchema,
   toolOperationAccess
-} from "./chunk-BV6NXSAH.js";
+} from "./chunk-ALQEGGYM.js";
 import {
   PACKAGE_VERSION
 } from "./chunk-AOJU5LKX.js";
@@ -24,7 +24,7 @@ import {
   isReadOnlyKey,
   restrictedWriteScopes,
   upgradeCaveatFor
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // src/mcp/server.ts
 import { randomUUID } from "crypto";
@@ -258,7 +258,7 @@ var OPERATIONS_GUIDE = {
         "canonry_seo_sync",
         "canonry_seo_run_cancel"
       ],
-      "guidance": "Read saved SEO evidence first. Preserve profile, exact domain or host, market, language, plan revision, dataset and collection date. SEO traffic and keyword metrics are third-party estimates, separate from Search Console observations and AI citation and mention coverage. Refresh requires explicit approval for the profile and work, a fresh refresh intent and an idempotency key. Hosted financial controls are internal; no credential or billing information belongs in the response."
+      "guidance": "Read saved SEO evidence first. Preserve profile, exact domain or host, market, language, plan revision, dataset and collection date. Market rankings (canonry_seo_market_rankings) are the site's Google position for its tracked queries by market, the same queries AI visibility measures. SEO traffic and keyword metrics are third-party estimates, separate from Search Console observations and AI citation and mention coverage. Refresh requires explicit approval for the profile and work, a fresh refresh intent and an idempotency key. Hosted financial controls are internal; no credential or billing information belongs in the response."
     },
     "operations": {
       "keywords": [

package/dist/{chunk-DQVJB6CZ.js → chunk-WNCOBSPN.js}

@@ -13365,6 +13365,7 @@ var STORED_READ_OPERATIONS = /* @__PURE__ */ new Set([
   "GET /api/v1/projects/{name}/seo/keyword-metrics",
   "GET /api/v1/projects/{name}/seo/domain-intelligence",
   "GET /api/v1/projects/{name}/seo/ranked-keywords",
+  "GET /api/v1/projects/{name}/seo/market-rankings",
   "GET /api/v1/projects/{name}/gbp/local-post-attempt",
   "GET /api/v1/openapi.json",
   "GET /api/v1/screenshots/{snapshotId}",
@@ -21214,7 +21215,7 @@ function uncheckedSourcesLabel(value) {
 
 // ../contracts/src/seo.ts
 import { z as z66 } from "zod";
-var seoCapabilitySchema = z66.enum(["keyword-metrics", "domain-intelligence", "ranked-keywords"]);
+var seoCapabilitySchema = z66.enum(["keyword-metrics", "domain-intelligence", "ranked-keywords", "market-rankings"]);
 var SeoCapabilities = seoCapabilitySchema.enum;
 var seoProviderSchema = z66.enum(["dataforseo"]);
 var SeoProviders = seoProviderSchema.enum;
@@ -21240,16 +21241,36 @@ var seoScopeSelectionSchema = z66.object({
   key: z66.string().min(1).max(200).optional(),
   expectedPlanRevision: z66.number().int().nonnegative().optional()
 }).strict();
+var seoDeviceSchema = z66.enum(["desktop", "mobile"]);
+var SeoDevices = seoDeviceSchema.enum;
+var seoSearchTextSchema = z66.enum(["query", "query-without-market-region"]);
+var SeoSearchTexts = seoSearchTextSchema.enum;
+var seoMarketLocationSchema = z66.object({
+  key: z66.string().trim().min(1).max(200),
+  locationCode: z66.number().int().positive(),
+  /** The provider's name for the location, shown beside results. */
+  label: z66.string().trim().min(1).max(200)
+}).strict();
+var SEO_MARKET_RANKING_MAX_SEARCHES = 1e3;
+var SEO_PROJECT_MARKET_KEY = "project";
+var seoRankingSettingsSchema = z66.object({
+  locations: z66.array(seoMarketLocationSchema).max(500),
+  /** How many organic results to check per search, in steps of 10. A target past this reads as not ranked. */
+  depth: z66.number().int().min(10).max(100).multipleOf(10),
+  device: seoDeviceSchema,
+  searchText: seoSearchTextSchema
+}).strict();
 var seoProfileInputSchema = z66.object({
   name: z66.string().trim().min(1).max(120),
   connectionId: z66.string().min(1).max(100),
-  capabilities: z66.array(seoCapabilitySchema).min(1).max(3),
+  capabilities: z66.array(seoCapabilitySchema).min(1).max(4),
   targets: z66.array(seoTargetSchema).max(20),
   keywords: z66.array(z66.string().trim().min(1).max(80).regex(/^\S+(?:\s+\S+){0,9}$/, "Use at most 10 words per keyword.")).max(700),
   locationCode: z66.number().int().positive(),
   languageCode: z66.string().min(2).max(10),
   limit: z66.number().int().min(1).max(1e3),
-  scope: seoScopeSelectionSchema
+  scope: seoScopeSelectionSchema,
+  rankings: seoRankingSettingsSchema.optional()
 }).strict();
 var seoProfileSchema = seoProfileInputSchema.extend({
   id: z66.string(),
@@ -21311,7 +21332,7 @@ var seoProvenanceSchema = z66.object({
   engine: z66.literal("google"),
   locationCode: z66.number().int().positive(),
   languageCode: z66.string(),
-  device: z66.literal("unspecified"),
+  device: z66.union([z66.literal("unspecified"), seoDeviceSchema]),
   collectedAt: z66.string(),
   sourceUpdatedAt: z66.string().nullable()
 }).strict();
@@ -21355,13 +21376,52 @@ var seoRankedKeywordSchema = z66.object({
   serpFeatures: z66.array(z66.string()),
   provenance: seoProvenanceSchema
 }).strict();
+var seoMarketRankingContextSchema = z66.object({
+  marketKey: z66.string(),
+  marketLabel: z66.string(),
+  /** The market's top-level group (a metro, say), or null when it has none. */
+  regionKey: z66.string().nullable(),
+  regionLabel: z66.string().nullable(),
+  queryId: z66.string().nullable(),
+  queryText: z66.string(),
+  queryClass: queryClassSchema
+}).strict();
+var seoMarketRankingSchema = seoMarketRankingContextSchema.extend({
+  /** The exact text searched on Google for `queryText` (see `seoSearchTextSchema`). */
+  searchText: z66.string(),
+  locationLabel: z66.string(),
+  target: seoTargetSchema,
+  rankOrganic: z66.number().int().positive().nullable(),
+  rankAbsolute: z66.number().int().positive().nullable(),
+  url: z66.string().nullable(),
+  depth: z66.number().int().positive(),
+  /** Tracked competitors found in the same results, by their best organic position. */
+  competitors: z66.array(z66.object({ domain: z66.string(), rankOrganic: z66.number().int().positive() }).strict()),
+  provenance: seoProvenanceSchema
+}).strict();
 var seoResultsSchema = z66.object({
   keywordMetrics: z66.array(seoKeywordMetricsSchema),
   domainIntelligence: z66.array(seoDomainIntelligenceSchema),
-  rankedKeywords: z66.array(seoRankedKeywordSchema)
+  rankedKeywords: z66.array(seoRankedKeywordSchema),
+  marketRankings: z66.array(seoMarketRankingSchema)
 }).strict();
 function emptySeoResults() {
-  return { keywordMetrics: [], domainIntelligence: [], rankedKeywords: [] };
+  return { keywordMetrics: [], domainIntelligence: [], rankedKeywords: [], marketRankings: [] };
+}
+function marketRegionName(marketLabel) {
+  const comma = marketLabel.lastIndexOf(",");
+  if (comma < 0) return null;
+  const region = marketLabel.slice(comma + 1).trim();
+  return region || null;
+}
+function seoSearchTextForQuery(queryText, marketLabel, rule) {
+  const text = queryText.replace(/\s+/g, " ").trim();
+  if (rule === SeoSearchTexts.query || marketLabel === null) return text;
+  const region = marketRegionName(marketLabel.replace(/\s+/g, " "));
+  if (!region) return text;
+  const suffix = `, ${region}`;
+  if (text.length <= suffix.length || text.slice(-suffix.length).toLowerCase() !== suffix.toLowerCase()) return text;
+  return text.slice(0, -suffix.length).trim();
 }
 var seoRunSchema = z66.object({
   id: z66.string(),
@@ -21393,7 +21453,8 @@ var seoTaskSchema = z66.object({
 var seoResultCountsSchema = z66.object({
   keywordMetrics: z66.number().int().nonnegative(),
   domainIntelligence: z66.number().int().nonnegative(),
-  rankedKeywords: z66.number().int().nonnegative()
+  rankedKeywords: z66.number().int().nonnegative(),
+  marketRankings: z66.number().int().nonnegative()
 }).strict();
 var seoRunDetailSchema = seoRunSchema.extend({
   tasks: z66.array(seoTaskSchema),
@@ -21417,6 +21478,11 @@ var seoPageShape = {
 var seoKeywordMetricsListSchema = z66.object({ ...seoPageShape, items: z66.array(seoKeywordMetricsSchema) }).strict();
 var seoDomainIntelligenceListSchema = z66.object({ ...seoPageShape, items: z66.array(seoDomainIntelligenceSchema) }).strict();
 var seoRankedKeywordListSchema = z66.object({ ...seoPageShape, items: z66.array(seoRankedKeywordSchema) }).strict();
+var seoMarketRankingQuerySchema = seoEvidenceQuerySchema.extend({
+  marketKey: z66.string().min(1).max(200).optional(),
+  regionKey: z66.string().min(1).max(200).optional()
+}).strict();
+var seoMarketRankingListSchema = z66.object({ ...seoPageShape, items: z66.array(seoMarketRankingSchema) }).strict();
 var seoOverviewSchema = z66.object({
   status: seoStatusSchema,
   profiles: z66.array(seoProfileSchema),
@@ -21432,7 +21498,8 @@ var seoOverviewSchema = z66.object({
   }).strict().nullable(),
   keywordMetricsCount: z66.number().int().nonnegative(),
   domainIntelligenceCount: z66.number().int().nonnegative(),
-  rankedKeywordCount: z66.number().int().nonnegative()
+  rankedKeywordCount: z66.number().int().nonnegative(),
+  marketRankingCount: z66.number().int().nonnegative()
 }).strict();
 var seoMicrosSchema = z66.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
 var seoOperatorTaskSchema = z66.object({
@@ -27292,6 +27359,10 @@ export {
   SeoScopeKinds,
   SeoRunStatuses,
   SeoAvailability,
+  seoDeviceSchema,
+  SEO_MARKET_RANKING_MAX_SEARCHES,
+  SEO_PROJECT_MARKET_KEY,
+  seoRankingSettingsSchema,
   seoProfileInputSchema,
   seoProfileSchema,
   seoProfileListSchema,
@@ -27301,6 +27372,7 @@ export {
   seoQuoteSchema,
   seoSyncInputSchema,
   emptySeoResults,
+  seoSearchTextForQuery,
   seoRunSchema,
   seoRunDetailSchema,
   seoRunListSchema,
@@ -27308,6 +27380,8 @@ export {
   seoKeywordMetricsListSchema,
   seoDomainIntelligenceListSchema,
   seoRankedKeywordListSchema,
+  seoMarketRankingQuerySchema,
+  seoMarketRankingListSchema,
   seoOverviewSchema,
   seoOperatorTaskSchema,
   seoReconcileInputSchema,

package/dist/{chunk-LTX3TJ3E.js → chunk-XC44Q5XR.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-HGMYEDAQ.js";
 import {
   describeError
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // src/commands/mcp.ts
 import fs from "fs";

package/dist/{chunk-IYB3EGSD.js → chunk-YJYLFIVT.js}

@@ -1,7 +1,7 @@
 import {
   API_PROVIDER_NAMES,
   ProviderNames
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // src/provider-registration.ts
 function isApiProviderRegistrable(name, entry) {

package/dist/{chunk-IJKKK7F4.js → chunk-YRX5UOM3.js}

@@ -1,7 +1,7 @@
 import {
   USAGE_TELEMETRY_HEADERS,
   redactLogString
-} from "./chunk-DQVJB6CZ.js";
+} from "./chunk-WNCOBSPN.js";
 
 // ../api-routes/src/request-context.ts
 import { AsyncLocalStorage } from "async_hooks";