semrush-cli 0.1.1 → 0.3.0

package/dist/{errors-BhvanypE.js → errors-CU9T4acd.js}

@@ -1,7 +1,7 @@
 import { Schema } from "effect";
 
 //#region package.json
-var version$1 = "0.1.1";
+var version$1 = "0.3.0";
 
 //#endregion
 //#region src/report-catalog.json
@@ -17,7 +17,10 @@ var report_catalog_default = {
 			"properties": {},
 			"title": "EmptyQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_overview: {
 		"method": "keywords.GetInfo",
@@ -44,7 +47,10 @@ var report_catalog_default = {
 			"required": ["keyword"],
 			"title": "KeywordQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_ideas: {
 		"method": "ideas.GetKeywords",
@@ -83,7 +89,10 @@ var report_catalog_default = {
 			"required": ["keyword"],
 			"title": "IdeasQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_ideas_summary: {
 		"method": "ideas.GetKeywordsSummary",
@@ -115,7 +124,10 @@ var report_catalog_default = {
 			"required": ["keyword"],
 			"title": "IdeasSummaryQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_serp: {
 		"method": "serp.GetURLs",
@@ -149,7 +161,10 @@ var report_catalog_default = {
 			"required": ["keyword"],
 			"title": "KeywordListQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_ads: {
 		"method": "adwords.GetCopies",
@@ -183,7 +198,10 @@ var report_catalog_default = {
 			"required": ["keyword"],
 			"title": "KeywordListQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_clusters: {
 		"method": "clusters.Get",
@@ -210,7 +228,10 @@ var report_catalog_default = {
 			"required": ["keyword"],
 			"title": "KeywordQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_magic: {
 		"method": "ideas.GetKeywords",
@@ -291,7 +312,10 @@ var report_catalog_default = {
 			"required": ["keyword"],
 			"title": "MagicQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_magic_summary: {
 		"method": "ideas.GetKeywordsSummary",
@@ -359,7 +383,10 @@ var report_catalog_default = {
 			"required": ["keyword"],
 			"title": "MagicSummaryQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_magic_groups: {
 		"method": "ideas.GetGroups",
@@ -440,7 +467,10 @@ var report_catalog_default = {
 			"required": ["keyword"],
 			"title": "MagicQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_overview: {
 		"method": "organic.Summary",
@@ -468,7 +498,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_keywords: {
 		"method": "organic.Positions",
@@ -547,7 +580,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainReportQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_pages: {
 		"method": "organic.PagesV3",
@@ -626,7 +662,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainPagesQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_subdomains: {
 		"method": "organic.Subdomains",
@@ -705,7 +744,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainPagesQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_position_changes: {
 		"method": "organic.PositionChangesV2",
@@ -784,7 +826,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainChangesQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_competitors: {
 		"method": "organic.Competitors",
@@ -857,7 +902,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainCompetitorsQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_backlinks: {
 		"method": "backlinks.Overview",
@@ -877,7 +925,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainIdentityQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_ai_visibility: {
 		"method": "organic.AiSeoSummary",
@@ -897,7 +948,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainIdentityQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_ai_countries: {
 		"method": "organic.AiDistributionByCountry",
@@ -917,7 +971,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainIdentityQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_ai_sources: {
 		"method": "organic.AiTopSources",
@@ -958,7 +1015,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "AiSourcesQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_trends: {
 		"method": "organic.OverviewTrend",
@@ -997,7 +1057,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainTrendQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_paid_keywords: {
 		"method": "adwords.PositionsOverview",
@@ -1032,7 +1095,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainListQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_paid_competitors: {
 		"method": "adwords.CompetitorsOverview",
@@ -1067,7 +1133,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainListQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_topics: {
 		"method": "organic.TopicsResult",
@@ -1095,7 +1164,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	domain_topics_status: {
 		"method": "organic.TopicsStatus",
@@ -1123,7 +1195,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "DomainQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	databases: {
 		"method": "user.Databases",
@@ -1136,7 +1211,10 @@ var report_catalog_default = {
 			"properties": {},
 			"title": "EmptyQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	snapshot_dates: {
 		"method": "organic.SnapshotDates",
@@ -1161,7 +1239,10 @@ var report_catalog_default = {
 			},
 			"title": "HistoryQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	report_permissions: {
 		"method": "dpa.UserPermissions",
@@ -1179,7 +1260,10 @@ var report_catalog_default = {
 			} },
 			"title": "DatabaseQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_links: {
 		"method": "backlinks",
@@ -1230,7 +1314,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "BacklinkListQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_referring_domains: {
 		"method": "backlinks_refdomains",
@@ -1281,7 +1368,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "BacklinkListQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_history: {
 		"method": "historical",
@@ -1308,7 +1398,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "BacklinkQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_competitors: {
 		"method": "competitors",
@@ -1335,7 +1428,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "BacklinkQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_top_pages: {
 		"method": "backlinks_pages",
@@ -1386,7 +1482,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "BacklinkListQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_anchors: {
 		"method": "backlinks_anchors",
@@ -1437,7 +1536,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "BacklinkListQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_outgoing_domains: {
 		"method": "backlinks_outgoing_domains",
@@ -1488,7 +1590,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "BacklinkListQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_countries: {
 		"method": "geodomains",
@@ -1515,7 +1620,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "BacklinkQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_authority: {
 		"method": "ascore",
@@ -1542,7 +1650,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "BacklinkQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_categories: {
 		"method": "category-profile",
@@ -1569,7 +1680,10 @@ var report_catalog_default = {
 			"required": ["domain"],
 			"title": "BacklinkQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_gap: {
 		"method": "/spectrum/v1/Gap/KeywordsList",
@@ -1625,7 +1739,10 @@ var report_catalog_default = {
 			"required": ["domains"],
 			"title": "GapQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_gap_totals: {
 		"method": "/spectrum/v1/Gap/KeywordsTotals",
@@ -1660,7 +1777,10 @@ var report_catalog_default = {
 			"required": ["domains"],
 			"title": "GapSummaryQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	keyword_gap_overlap: {
 		"method": "/spectrum/v1/Gap/Overlaps",
@@ -1695,7 +1815,10 @@ var report_catalog_default = {
 			"required": ["domains"],
 			"title": "GapSummaryQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_gap: {
 		"method": "backlinks_matrix",
@@ -1755,7 +1878,10 @@ var report_catalog_default = {
 			"required": ["domains"],
 			"title": "BacklinkGapQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	backlink_comparison: {
 		"method": "backlinks_comparison",
@@ -1776,7 +1902,10 @@ var report_catalog_default = {
 			"required": ["domains"],
 			"title": "BacklinkComparisonQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	projects: {
 		"method": "/apis/v4-raw/crossroad/api/v0/crossroad/list",
@@ -1809,7 +1938,10 @@ var report_catalog_default = {
 			},
 			"title": "ProjectListQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	ai_capabilities: {
 		"method": "/ai-seo/api/v2/user/user_capabilities",
@@ -1822,7 +1954,10 @@ var report_catalog_default = {
 			"properties": {},
 			"title": "EmptyQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	audit_campaigns: {
 		"method": "/siteaudit/api/campaigns/seolist",
@@ -1835,7 +1970,10 @@ var report_catalog_default = {
 			"properties": {},
 			"title": "EmptyQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	folders: {
 		"method": "/apis/v4-raw/folders/api/v0/folders/selector-list",
@@ -1848,7 +1986,10 @@ var report_catalog_default = {
 			"properties": {},
 			"title": "EmptyQuery",
 			"type": "object"
-		}
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
 	},
 	saved_keyword_lists: {
 		"method": "/apis/v4-raw/saved-keywords/api/v0/list/all",
@@ -1861,124 +2002,1446 @@ var report_catalog_default = {
 			"properties": {},
 			"title": "EmptyQuery",
 			"type": "object"
+		},
+		"mutation": false,
+		"destructive": false,
+		"http_method": ""
+	},
+	project_create: {
+		"method": "/apis/v4-raw/folders/api/v0/folders",
+		"description": "Create a project, optionally with a website. Does not start tools or share it.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"name": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 255,
+					"pattern": "^(?=.*\\S)[^~|`!#%^&*=\\[\\]\\\\\\x27/{}\":<>?]+$",
+					"description": "Project name, up to 255 characters. The web UI restricts punctuation."
+				},
+				"domain": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 253,
+					"pattern": "^(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}$",
+					"description": "Domain or subdomain, without protocol or path."
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Print the request without sending it."
+				}
+			},
+			"required": ["name"]
 		}
-	}
-};
-
-//#endregion
-//#region src/report-parameters.ts
-const backlinkSorts = new Map([
-	["backlinks", "page_ascore"],
-	["backlinks_refdomains", "backlinksnum"],
-	["backlinks_anchors", "backlinksnum"],
-	["backlinks_pages", "domainsnum"],
-	["backlinks_outgoing_domains", "links_num"]
-]);
-const version = version$1;
-const reports = report_catalog_default;
-/** Fixed request shapes observed in semrush-web-mcp. No arbitrary RPC or URL input. */
-function reportParameters(definition, q) {
-	const family = definition.transport;
-	if (family === "magic") return magicParameters(definition, q);
-	if (family === "keyword") return keywordParameters(definition, q);
-	if (family === "direct") return "database" in q ? {
-		database: q.database ?? null,
-		global: q.global_data ?? null,
-		dateFormat: "date"
-	} : {};
-	if (family === "domain") return domainParameters(definition, q);
-	if (family === "backlink_gap") return backlinkComparisonParameters(definition, q);
-	if (family.startsWith("backlink")) return backlinkParameters(definition, q);
-	if (family === "gap") return gapParameters(definition, q);
-	if (family === "projects") return {
-		filter: q.filters ?? null,
-		range: {
-			limit: q.limit ?? null,
-			offset: q.offset ?? null
+	},
+	project_get: {
+		"method": "/apis/v4-raw/folders/api/v0/folders/folder",
+		"description": "Read one project by its current web folder ID.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "GET",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": { "folder_id": {
+				"type": "string",
+				"pattern": "^[0-9]+$",
+				"maxLength": 30,
+				"description": "Current web project folder ID, as a decimal string."
+			} },
+			"required": ["folder_id"]
 		}
-	};
-	if (family === "post" && definition.method.endsWith("/list/all")) return {
-		ownership: 1,
-		order: {
-			field: 3,
-			direction: 2
-		},
-		range: {
-			limit: 1e3,
-			offset: 0
+	},
+	project_update: {
+		"method": "/apis/v4-raw/folders/api/v0/folders/{folder_id}",
+		"description": "Rename a project or add its first domain. Existing domains cannot be changed.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "PUT",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"folder_id": {
+					"type": "string",
+					"pattern": "^[0-9]+$",
+					"maxLength": 30,
+					"description": "Current web project folder ID, as a decimal string."
+				},
+				"name": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 255,
+					"pattern": "^(?=.*\\S)[^~|`!#%^&*=\\[\\]\\\\\\x27/{}\":<>?]+$",
+					"description": "Project name, up to 255 characters. The web UI restricts punctuation."
+				},
+				"domain": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 253,
+					"pattern": "^(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}$",
+					"description": "Domain or subdomain, without protocol or path."
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Print the request without sending it."
+				}
+			},
+			"required": ["folder_id"],
+			"anyOf": [{ "required": ["name"] }, { "required": ["domain"] }]
 		}
-	};
-	if (definition.method.endsWith("selector-list")) return {
-		limit: 1e4,
-		offset: 0
-	};
-	return {};
-}
-function magicParameters(definition, q) {
-	const method = definition.method;
-	const filters = Object.fromEntries([
-		"phrase",
-		"competition_level",
-		"cpc",
-		"difficulty",
-		"results",
-		"volume",
-		"words_count"
-	].map((key) => [key, []]));
-	Object.assign(filters, {
-		serp_features: [{
-			inverted: false,
-			value: []
-		}],
-		phrase_include_logic: 0
-	}, q.filters ?? null);
-	const params = {
-		phrase: q.keyword ?? null,
-		database: q.database ?? null,
-		currency: q.currency ?? null,
-		mode: q.mode ?? null,
-		questions_only: q.questions_only ?? null,
-		topics_enabled: true,
-		filter: filters,
-		groups: q.groups ?? null,
-		order: {
-			direction: q.descending ? 1 : 0,
-			field: q.sort_field ?? null
-		},
-		groups_order: {
-			direction: 1,
-			field: "relevance"
+	},
+	project_delete: {
+		"method": "/apis/v4-raw/folders/api/v0/folders/{folder_id}",
+		"description": "Permanently delete a project and its attached tool data.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": true,
+		"http_method": "DELETE",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"folder_id": {
+					"type": "string",
+					"pattern": "^[0-9]+$",
+					"maxLength": 30,
+					"description": "Current web project folder ID, as a decimal string."
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Print the request without sending it."
+				}
+			},
+			"required": ["folder_id"]
 		}
-	};
-	if (method === "ideas.GetKeywords") params.page = {
-		number: q.page ?? null,
-		size: q.page_size ?? null
-	};
-	if (method === "ideas.GetGroups") params.groups_page = {
-		number: q.page ?? null,
-		size: q.page_size ?? null
-	};
-	return params;
-}
-function keywordParameters(definition, q) {
-	const method = definition.method;
-	if (!("keyword" in q)) return {};
-	const params = {
-		phrase: q.keyword ?? null,
-		database: q.database ?? null,
-		device: 0,
-		currency: "USD",
-		location: 0,
-		date: ""
-	};
-	if (method.startsWith("ideas.")) Object.assign(params, {
-		mode: 0,
-		questions_only: q.questions_only ?? null
-	});
-	return params;
-}
-function domainParameters(definition, q) {
-	const method = definition.method;
+	},
+	project_leave: {
+		"method": "/share/json/leave/project-smb",
+		"description": "Leave a shared project.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": true,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"folder_id": {
+					"type": "string",
+					"pattern": "^[0-9]+$",
+					"maxLength": 30,
+					"description": "Current web project folder ID, as a decimal string."
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Print the request without sending it."
+				}
+			},
+			"required": ["folder_id"]
+		}
+	},
+	project_limits: {
+		"method": "/apis/v4-raw/folders/api/v0/folders/limits",
+		"description": "Read project creation limits.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "GET",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {},
+			"required": []
+		}
+	},
+	project_tags: {
+		"method": "/apis/v4-raw/folders/api/v0/folders/tags",
+		"description": "Read available project tags.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "GET",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {},
+			"required": []
+		}
+	},
+	project_set_tags: {
+		"method": "/apis/v4-raw/folders/api/v0/folders/tags/{folder_id}",
+		"description": "Replace project tags. An empty array removes all its tags.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"folder_id": {
+					"type": "string",
+					"pattern": "^[0-9]+$",
+					"maxLength": 30,
+					"description": "Current web project folder ID, as a decimal string."
+				},
+				"tags": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1,
+						"maxLength": 50,
+						"pattern": "^[^~|`!#%^&*=\\[\\]\\\\\\x27/{}\":<>?]+$"
+					},
+					"maxItems": 3,
+					"uniqueItems": true
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Print the request without sending it."
+				}
+			},
+			"required": ["folder_id", "tags"]
+		}
+	},
+	project_check_domain: {
+		"method": "/apis/v4-raw/folders/api/v0/folders/check-domain",
+		"description": "Check website information before creating a project.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "GET",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": { "domain": {
+				"type": "string",
+				"minLength": 1,
+				"maxLength": 253,
+				"pattern": "^(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}$",
+				"description": "Domain or subdomain, without protocol or path."
+			} },
+			"required": ["domain"]
+		}
+	},
+	project_pin: {
+		"method": "/apis/v4-raw/crossroad/api/v0/crossroad/set-pinned",
+		"description": "Pin or unpin a project on the dashboard.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"folder_id": {
+					"type": "string",
+					"pattern": "^[0-9]+$",
+					"maxLength": 30,
+					"description": "Current web project folder ID, as a decimal string."
+				},
+				"pinned": { "type": "boolean" },
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Print the request without sending it."
+				}
+			},
+			"required": ["folder_id", "pinned"]
+		}
+	},
+	project_toolkits: {
+		"method": "/apis/v4-raw/crossroad/api/v0/crossroad/toolkits",
+		"description": "Read SEO, AI, local, social, advertising and content toolkit status.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"folder_ids": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"pattern": "^[0-9]+$",
+						"maxLength": 30,
+						"description": "Current web project folder ID, as a decimal string."
+					},
+					"minItems": 1,
+					"maxItems": 100,
+					"uniqueItems": true
+				},
+				"with_promo": {
+					"type": "boolean",
+					"default": false
+				}
+			},
+			"required": ["folder_ids"]
+		}
+	},
+	project_tools: {
+		"method": "/apis/v4-raw/crossroad/api/v0/crossroad/tools",
+		"description": "Read project dashboard metrics. Tool IDs match the web dashboard.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"folder_id": {
+					"type": "string",
+					"pattern": "^[0-9]+$",
+					"maxLength": 30,
+					"description": "Current web project folder ID, as a decimal string."
+				},
+				"tools": {
+					"type": "array",
+					"items": {
+						"type": "integer",
+						"minimum": 3,
+						"maximum": 33
+					},
+					"minItems": 1,
+					"maxItems": 31,
+					"uniqueItems": true
+				}
+			},
+			"required": ["folder_id", "tools"]
+		}
+	},
+	project_enable_seo: {
+		"method": "/projects/api/projects",
+		"description": "Create the SEO project associated with an existing web project. Uses project allowance.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"folder_id": {
+					"type": "string",
+					"pattern": "^[0-9]+$",
+					"maxLength": 30,
+					"description": "Current web project folder ID, as a decimal string."
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Print the request without sending it."
+				}
+			},
+			"required": ["folder_id"]
+		}
+	},
+	project_seo_auto_setup: {
+		"method": "/projects/api/projects/seo_auto_setup",
+		"description": "Start automatic SEO setup, including Site Audit and Position Tracking. Uses account allowances.",
+		"transport": "project_web",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"folder_id": {
+					"type": "string",
+					"pattern": "^[0-9]+$",
+					"maxLength": 30,
+					"description": "Current web project folder ID, as a decimal string."
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Print the request without sending it."
+				}
+			},
+			"required": ["folder_id"]
+		}
+	},
+	keyword_list_limits: {
+		"method": "user.GetInfo",
+		"description": "Read Keyword Strategy Builder list and clustering allowances.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {},
+			"required": []
+		}
+	},
+	keyword_lists: {
+		"method": "baskets.BasketsGetAll",
+		"description": "Read regular and structured keyword lists with pagination and ownership filters.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"page": {
+					"type": "integer",
+					"minimum": 1,
+					"default": 1
+				},
+				"page_size": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 1e3,
+					"default": 100
+				},
+				"sort_field": {
+					"type": "string",
+					"minLength": 1,
+					"default": "updated_at"
+				},
+				"descending": {
+					"type": "boolean",
+					"default": true
+				},
+				"name_filter": {
+					"type": "string",
+					"default": ""
+				},
+				"ownership": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 7,
+					"default": 7,
+					"description": "Web ownership bitmask. 7 includes owned and shared lists."
+				}
+			},
+			"required": []
+		}
+	},
+	keyword_list_create: {
+		"method": "baskets.BasketCreate",
+		"description": "Create an empty regular keyword list. Does not cluster or generate a strategy.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"name": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 255,
+					"pattern": "\\S"
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Preview without authentication or network access."
+				}
+			},
+			"required": ["name"]
+		}
+	},
+	keyword_list_get: {
+		"method": "baskets.BasketsGetByShareID",
+		"description": "Read one keyword list and its permissions.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				}
+			},
+			"required": ["basket_id", "owner_id"]
+		}
+	},
+	keyword_list_rename: {
+		"method": "baskets.BasketRename",
+		"description": "Rename a keyword list.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				},
+				"name": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 255,
+					"pattern": "\\S"
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Preview without authentication or network access."
+				}
+			},
+			"required": [
+				"basket_id",
+				"owner_id",
+				"name"
+			]
+		}
+	},
+	keyword_list_delete: {
+		"method": "baskets.BasketDelete",
+		"description": "Permanently delete one of your keyword lists.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": true,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Preview without authentication or network access."
+				}
+			},
+			"required": ["basket_id"]
+		}
+	},
+	keyword_list_keywords: {
+		"method": "baskets.KeywordsGetByFilter",
+		"description": "Read filtered, paginated keyword-list metrics.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				},
+				"page": {
+					"type": "integer",
+					"minimum": 1,
+					"default": 1
+				},
+				"page_size": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 1e3,
+					"default": 100
+				},
+				"sort_field": {
+					"type": "string",
+					"minLength": 1,
+					"default": "phrase"
+				},
+				"descending": {
+					"type": "boolean",
+					"default": true
+				},
+				"filters": {
+					"type": "object",
+					"description": "Keyword Strategy Builder Filter object. Unspecified fields default to empty arrays.",
+					"properties": {
+						"ClusterIDs": { "type": "array" },
+						"Databases": { "type": "array" },
+						"Phrase": { "type": "array" },
+						"CompetitionLevel": { "type": "array" },
+						"Cpc": { "type": "array" },
+						"Difficulty": { "type": "array" },
+						"SERPFeatures": { "type": "array" },
+						"Volume": { "type": "array" },
+						"ClickPotential": { "type": "array" },
+						"Tags": { "type": "array" },
+						"Intents": { "type": "array" }
+					},
+					"additionalProperties": false,
+					"default": {}
+				}
+			},
+			"required": ["basket_id", "owner_id"]
+		}
+	},
+	keyword_list_summary: {
+		"method": "baskets.KeywordsGetSummary",
+		"description": "Read keyword totals, volume and difficulty for the selected filters.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				},
+				"filters": {
+					"type": "object",
+					"description": "Keyword Strategy Builder Filter object. Unspecified fields default to empty arrays.",
+					"properties": {
+						"ClusterIDs": { "type": "array" },
+						"Databases": { "type": "array" },
+						"Phrase": { "type": "array" },
+						"CompetitionLevel": { "type": "array" },
+						"Cpc": { "type": "array" },
+						"Difficulty": { "type": "array" },
+						"SERPFeatures": { "type": "array" },
+						"Volume": { "type": "array" },
+						"ClickPotential": { "type": "array" },
+						"Tags": { "type": "array" },
+						"Intents": { "type": "array" }
+					},
+					"additionalProperties": false,
+					"default": {}
+				}
+			},
+			"required": ["basket_id", "owner_id"]
+		}
+	},
+	keyword_list_import: {
+		"method": "baskets.KeywordsImport",
+		"description": "Import phrases into a regular keyword list. Account keyword limits apply.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				},
+				"keywords": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1,
+						"pattern": "\\S"
+					},
+					"minItems": 1,
+					"uniqueItems": true
+				},
+				"database": {
+					"type": "string",
+					"pattern": "^[a-z]{2}(?:-[a-z]{2})?$",
+					"default": "us"
+				},
+				"tags": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1,
+						"pattern": "\\S"
+					},
+					"uniqueItems": true,
+					"default": []
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Preview without authentication or network access."
+				}
+			},
+			"required": [
+				"basket_id",
+				"owner_id",
+				"keywords"
+			]
+		}
+	},
+	keyword_list_delete_keywords: {
+		"method": "baskets.KeywordsDeleteByIDs",
+		"description": "Delete selected phrases from a keyword list. Returns an undo ID.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": true,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				},
+				"keywords": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1,
+						"pattern": "\\S"
+					},
+					"minItems": 1,
+					"uniqueItems": true
+				},
+				"database": {
+					"type": "string",
+					"pattern": "^[a-z]{2}(?:-[a-z]{2})?$",
+					"default": "us"
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Preview without authentication or network access."
+				}
+			},
+			"required": [
+				"basket_id",
+				"owner_id",
+				"keywords"
+			]
+		}
+	},
+	keyword_list_undo_delete: {
+		"method": "baskets.KeywordsDeleteUndo",
+		"description": "Restore a keyword deletion using its returned UndoID.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"undo_id": {
+					"type": "string",
+					"minLength": 1
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Preview without authentication or network access."
+				}
+			},
+			"required": ["undo_id"]
+		}
+	},
+	keyword_list_update_metrics: {
+		"method": "baskets.KeywordsRequestUpdateByIDs",
+		"description": "Request fresh metrics for selected phrases. Consumes the update allowance.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				},
+				"keywords": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1,
+						"pattern": "\\S"
+					},
+					"minItems": 1,
+					"uniqueItems": true
+				},
+				"database": {
+					"type": "string",
+					"pattern": "^[a-z]{2}(?:-[a-z]{2})?$",
+					"default": "us"
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Preview without authentication or network access."
+				}
+			},
+			"required": [
+				"basket_id",
+				"owner_id",
+				"keywords"
+			]
+		}
+	},
+	keyword_list_tags: {
+		"method": "baskets.GetBasketTags",
+		"description": "Read keyword tags and their usage in a list.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				}
+			},
+			"required": ["basket_id", "owner_id"]
+		}
+	},
+	keyword_list_add_tags: {
+		"method": "baskets.KeywordsAddTags",
+		"description": "Add tags to selected phrases.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				},
+				"keywords": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1,
+						"pattern": "\\S"
+					},
+					"minItems": 1,
+					"uniqueItems": true
+				},
+				"database": {
+					"type": "string",
+					"pattern": "^[a-z]{2}(?:-[a-z]{2})?$",
+					"default": "us"
+				},
+				"tags": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1,
+						"pattern": "\\S"
+					},
+					"uniqueItems": true,
+					"default": [],
+					"minItems": 1
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Preview without authentication or network access."
+				}
+			},
+			"required": [
+				"basket_id",
+				"owner_id",
+				"keywords",
+				"tags"
+			]
+		}
+	},
+	keyword_list_remove_tags: {
+		"method": "baskets.KeywordsDeleteTags",
+		"description": "Remove tags from selected phrases.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": true,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				},
+				"keywords": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1,
+						"pattern": "\\S"
+					},
+					"minItems": 1,
+					"uniqueItems": true
+				},
+				"database": {
+					"type": "string",
+					"pattern": "^[a-z]{2}(?:-[a-z]{2})?$",
+					"default": "us"
+				},
+				"tags": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1,
+						"pattern": "\\S"
+					},
+					"uniqueItems": true,
+					"default": [],
+					"minItems": 1
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Preview without authentication or network access."
+				}
+			},
+			"required": [
+				"basket_id",
+				"owner_id",
+				"keywords",
+				"tags"
+			]
+		}
+	},
+	keyword_list_cluster: {
+		"method": "baskets.RunClusterization",
+		"description": "Start clustering a keyword list. Consumes the clustering allowance.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Preview without authentication or network access."
+				}
+			},
+			"required": ["basket_id", "owner_id"]
+		}
+	},
+	keyword_list_cluster_forecast: {
+		"method": "baskets.BasketGetClusterizationForecast",
+		"description": "Read the clustering forecast for a keyword list.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				}
+			},
+			"required": ["basket_id", "owner_id"]
+		}
+	},
+	keyword_list_cluster_status: {
+		"method": "baskets.BasketGetClusterizationStatuses",
+		"description": "Read the current clustering status for a keyword list.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": false,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"basket_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "BasketID from keyword-lists."
+				},
+				"owner_id": {
+					"type": "integer",
+					"minimum": 1,
+					"maximum": 9007199254740991,
+					"description": "Owner.ID from keyword-lists, including shared lists."
+				}
+			},
+			"required": ["basket_id", "owner_id"]
+		}
+	},
+	keyword_strategy_create: {
+		"method": "baskets.BasketCreate",
+		"description": "Generate a structured keyword strategy from a domain or seed phrases. Consumes the clustering allowance.",
+		"transport": "kwm",
+		"total_method": "",
+		"web_report": "",
+		"mutation": true,
+		"destructive": false,
+		"http_method": "POST",
+		"schema": {
+			"type": "object",
+			"additionalProperties": false,
+			"properties": {
+				"name": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 255,
+					"pattern": "\\S"
+				},
+				"domain": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 253,
+					"pattern": "^(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}$",
+					"description": "Domain or subdomain, without protocol or path."
+				},
+				"database": {
+					"type": "string",
+					"pattern": "^[a-z]{2}(?:-[a-z]{2})?$",
+					"default": "us"
+				},
+				"seed_keywords": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1,
+						"pattern": "\\S"
+					},
+					"default": [],
+					"uniqueItems": true
+				},
+				"competitors": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1,
+						"maxLength": 253,
+						"pattern": "^(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}$",
+						"description": "Domain or subdomain, without protocol or path."
+					},
+					"default": [],
+					"uniqueItems": true
+				},
+				"confirm": {
+					"type": "boolean",
+					"default": false,
+					"description": "Confirm this account mutation."
+				},
+				"dry_run": {
+					"type": "boolean",
+					"default": false,
+					"description": "Preview without authentication or network access."
+				}
+			},
+			"required": ["name"],
+			"anyOf": [{ "required": ["domain"] }, {
+				"required": ["seed_keywords"],
+				"properties": { "seed_keywords": { "minItems": 1 } }
+			}]
+		}
+	}
+};
+
+//#endregion
+//#region src/report-parameters.ts
+const backlinkSorts = new Map([
+	["backlinks", "page_ascore"],
+	["backlinks_refdomains", "backlinksnum"],
+	["backlinks_anchors", "backlinksnum"],
+	["backlinks_pages", "domainsnum"],
+	["backlinks_outgoing_domains", "links_num"]
+]);
+const version = version$1;
+const reports = report_catalog_default;
+/** Fixed request shapes observed in semrush-web-mcp. No arbitrary RPC or URL input. */
+function reportParameters(definition, q) {
+	const family = definition.transport;
+	if (family === "kwm") return keywordListParameters(definition, q);
+	if (family === "project_web") return projectParameters(definition, q);
+	if (family === "magic") return magicParameters(definition, q);
+	if (family === "keyword") return keywordParameters(definition, q);
+	if (family === "direct") return "database" in q ? {
+		database: q.database ?? null,
+		global: q.global_data ?? null,
+		dateFormat: "date"
+	} : {};
+	if (family === "domain") return domainParameters(definition, q);
+	if (family === "backlink_gap") return backlinkComparisonParameters(definition, q);
+	if (family.startsWith("backlink")) return backlinkParameters(definition, q);
+	if (family === "gap") return gapParameters(definition, q);
+	if (family === "projects") return {
+		filter: q.filters ?? null,
+		range: {
+			limit: q.limit ?? null,
+			offset: q.offset ?? null
+		}
+	};
+	if (family === "post" && definition.method.endsWith("/list/all")) return {
+		ownership: 1,
+		order: {
+			field: 3,
+			direction: 2
+		},
+		range: {
+			limit: 1e3,
+			offset: 0
+		}
+	};
+	if (definition.method.endsWith("selector-list")) return {
+		limit: 1e4,
+		offset: 0
+	};
+	return {};
+}
+function magicParameters(definition, q) {
+	const method = definition.method;
+	const filters = Object.fromEntries([
+		"phrase",
+		"competition_level",
+		"cpc",
+		"difficulty",
+		"results",
+		"volume",
+		"words_count"
+	].map((key) => [key, []]));
+	Object.assign(filters, {
+		serp_features: [{
+			inverted: false,
+			value: []
+		}],
+		phrase_include_logic: 0
+	}, q.filters ?? null);
+	const params = {
+		phrase: q.keyword ?? null,
+		database: q.database ?? null,
+		currency: q.currency ?? null,
+		mode: q.mode ?? null,
+		questions_only: q.questions_only ?? null,
+		topics_enabled: true,
+		filter: filters,
+		groups: q.groups ?? null,
+		order: {
+			direction: q.descending ? 1 : 0,
+			field: q.sort_field ?? null
+		},
+		groups_order: {
+			direction: 1,
+			field: "relevance"
+		}
+	};
+	if (method === "ideas.GetKeywords") params.page = {
+		number: q.page ?? null,
+		size: q.page_size ?? null
+	};
+	if (method === "ideas.GetGroups") params.groups_page = {
+		number: q.page ?? null,
+		size: q.page_size ?? null
+	};
+	return params;
+}
+function keywordParameters(definition, q) {
+	const method = definition.method;
+	if (!("keyword" in q)) return {};
+	const params = {
+		phrase: q.keyword ?? null,
+		database: q.database ?? null,
+		device: 0,
+		currency: "USD",
+		location: 0,
+		date: ""
+	};
+	if (method.startsWith("ideas.")) Object.assign(params, {
+		mode: 0,
+		questions_only: q.questions_only ?? null
+	});
+	return params;
+}
+function domainParameters(definition, q) {
+	const method = definition.method;
 	if (!("domain" in q)) return { database: q.database ?? null };
 	const params = {
 		searchItem: q.domain ?? null,
@@ -2108,6 +3571,153 @@ function gapParameters(definition, q) {
 	});
 	return params;
 }
+/** Current project-selector and Crossroad web contracts. Control flags never go on wire. */
+function projectParameters(definition, q) {
+	const path = definition.method;
+	if (path === "/apis/v4-raw/folders/api/v0/folders" || definition.http_method === "PUT") {
+		const properties = [];
+		if (q.name !== void 0) properties.push({ name: { value: q.name } });
+		if (q.domain !== void 0) properties.push({ domain: { value: q.domain } });
+		return { properties };
+	}
+	if (path.endsWith("/leave/project-smb")) return { object_ids: [q.folder_id ?? null] };
+	if (path.includes("/tags/")) return { tags: Array.isArray(q.tags) ? q.tags.map((name) => ({ name })) : [] };
+	if (path.endsWith("/set-pinned")) return {
+		id: q.folder_id ?? null,
+		is_pinned: q.pinned ?? null
+	};
+	if (path.endsWith("/toolkits")) return {
+		folders: q.folder_ids ?? [],
+		withPromo: q.with_promo ?? false
+	};
+	if (path.endsWith("/tools")) return { items: Array.isArray(q.tools) ? q.tools.map((tool) => ({
+		folder_id: q.folder_id ?? null,
+		tool
+	})) : [] };
+	if (definition.http_method === "DELETE") return {};
+	return Object.fromEntries(Object.entries(q).filter(([key]) => key !== "confirm" && key !== "dry_run"));
+}
+/** Fixed public request plans. RPC credentials enter only inside the browser layer. */
+function webRequest(definition, query) {
+	if (definition.transport === "kwm") return {
+		method: "POST",
+		path: "/kwm/rpc",
+		body: rpcBody(definition.method, reportParameters(definition, query))
+	};
+	return {
+		method: definition.http_method,
+		path: definition.method.replace("{folder_id}", String(query.folder_id)),
+		body: reportParameters(definition, query)
+	};
+}
+function previewMutation(name, definition, query) {
+	return definition.mutation && query.dry_run === true ? {
+		dry_run: true,
+		report: name,
+		request: webRequest(definition, query)
+	} : void 0;
+}
+/** One JSON-RPC envelope for execution and credential-free previews. */
+function rpcBody(method, params) {
+	return {
+		id: 1,
+		jsonrpc: "2.0",
+		method,
+		params
+	};
+}
+/** Keyword Strategy Builder's casing differs from the keyword-research API. */
+function keywordListParameters(definition, q) {
+	const method = definition.method;
+	if (method === "user.GetInfo") return {};
+	if (method === "baskets.BasketsGetAll") return {
+		Order: {
+			Direction: q.descending ? 1 : 0,
+			Field: q.sort_field ?? null
+		},
+		Page: {
+			Number: q.page ?? null,
+			Size: q.page_size ?? null
+		},
+		Filter: {
+			Name: q.name_filter ?? "",
+			OwningType: q.ownership ?? 7
+		}
+	};
+	if (method === "baskets.BasketCreate") return {
+		Name: q.name ?? null,
+		Clusterization: "seed_keywords" in q ? {
+			Databases: [q.database ?? "us"],
+			Domain: q.domain ?? "",
+			Competitors: q.competitors ?? [],
+			SeedPhrases: q.seed_keywords ?? []
+		} : null
+	};
+	if (method === "baskets.BasketDelete") return { BasketIDs: [q.basket_id ?? null] };
+	if (method === "baskets.KeywordsDeleteUndo") return { UndoID: q.undo_id ?? null };
+	const shared = {
+		BasketID: q.basket_id ?? null,
+		OwnerID: q.owner_id ?? null
+	};
+	if (method === "baskets.BasketGetClusterizationStatuses") return { BasketIDs: [shared] };
+	if (method === "baskets.BasketRename") return {
+		...shared,
+		Name: q.name ?? null
+	};
+	if ("keywords" in q) {
+		const phrases = Array.isArray(q.keywords) ? q.keywords : [];
+		if (method === "baskets.KeywordsImport") return {
+			...shared,
+			Keywords: phrases.map((Phrase) => ({
+				Phrase,
+				Database: q.database ?? "us",
+				Tags: q.tags ?? []
+			}))
+		};
+		const params = {
+			...shared,
+			KeywordIDs: phrases.map((Phrase) => ({
+				Phrase,
+				Database: q.database ?? "us"
+			}))
+		};
+		if ("tags" in q) params.Tags = q.tags ?? [];
+		return params;
+	}
+	if ("filters" in q) {
+		const filter = Object.fromEntries([
+			"ClusterIDs",
+			"Databases",
+			"Phrase",
+			"CompetitionLevel",
+			"Cpc",
+			"Difficulty",
+			"SERPFeatures",
+			"Volume",
+			"ClickPotential",
+			"Tags",
+			"Intents"
+		].map((key) => [key, []]));
+		Object.assign(filter, q.filters);
+		if (method === "baskets.KeywordsGetSummary") return {
+			...shared,
+			Filter: filter
+		};
+		return {
+			...shared,
+			Filter: filter,
+			Order: {
+				Direction: q.descending ? 1 : 0,
+				Field: q.sort_field ?? null
+			},
+			Page: {
+				Number: q.page ?? null,
+				Size: q.page_size ?? null
+			}
+		};
+	}
+	return shared;
+}
 
 //#endregion
 //#region src/errors.ts
@@ -2120,5 +3730,5 @@ var ReportError = class extends Schema.TaggedError()("ReportError", { message: S
 var UsageError = class extends Schema.TaggedError()("UsageError", { message: Schema.String }) {};
 
 //#endregion
-export { reports as a, reportParameters as i, SessionError as n, version as o, UsageError as r, ReportError as t };
-//# sourceMappingURL=errors-BhvanypE.js.map
+export { reportParameters as a, version as c, previewMutation as i, webRequest as l, SessionError as n, reports as o, UsageError as r, rpcBody as s, ReportError as t };
+//# sourceMappingURL=errors-CU9T4acd.js.map