fix(ahrefs): default optional country to us consistently across all tools

paid_pages, metrics_history, keywords_history, and batch_analysis were the
only 4 of the 11 tools with an optional country param that didn't fall back
to "us" when omitted, unlike domain_rating, metrics, keyword_overview,
organic_keywords, organic_competitors, top_pages, and related_terms - all
of which default client-side. Aligned all four to the same convention so
direct tool/agent calls without an explicit country get the same behavior
regardless of which operation is used.

Author: waleedlatif1

apps/docs/content/docs/en/integrations/ahrefs.mdx

@@ -302,7 +302,7 @@ Get a target domain's pages that receive paid search traffic, sorted by estimate
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `target` | string | Yes | The target domain or URL to analyze. Example: "example.com" |
-| `country` | string | No | Country code for traffic data. Example: "us", "gb", "de" |
+| `country` | string | No | Country code for traffic data. Example: "us", "gb", "de" \(default: "us"\) |
 | `mode` | string | No | Analysis mode: domain \(entire domain\), prefix \(URL prefix\), subdomains \(include all subdomains, default\), exact \(exact URL match\) |
 | `date` | string | No | Date to report metrics on, in YYYY-MM-DD format \(defaults to today\) |
 | `limit` | number | No | Maximum number of results to return. Example: 50 \(default: 1000\) |
@@ -410,7 +410,7 @@ Get the historical organic and paid traffic trend for a target domain or URL ove
 | `dateTo` | string | No | End date of the historical period, in YYYY-MM-DD format \(defaults to today\) |
 | `volumeMode` | string | No | Search volume calculation: "monthly" or "average" \(default: "monthly"\) |
 | `historyGrouping` | string | No | Time interval for grouping data points: "daily", "weekly", or "monthly" \(default: "monthly"\) |
-| `country` | string | No | Country code for traffic data. Example: "us", "gb", "de" |
+| `country` | string | No | Country code for traffic data. Example: "us", "gb", "de" \(default: "us"\) |
 | `mode` | string | No | Analysis mode: domain \(entire domain\), prefix \(URL prefix\), subdomains \(include all subdomains, default\), exact \(exact URL match\) |
 | `apiKey` | string | Yes | Ahrefs API Key |
 
@@ -460,7 +460,7 @@ Get the historical organic keyword ranking distribution for a target domain or U
 | `dateFrom` | string | Yes | Start date of the historical period, in YYYY-MM-DD format |
 | `dateTo` | string | No | End date of the historical period, in YYYY-MM-DD format \(defaults to today\) |
 | `historyGrouping` | string | No | Time interval for grouping data points: "daily", "weekly", or "monthly" \(default: "monthly"\) |
-| `country` | string | No | Country code for search results. Example: "us", "gb", "de" |
+| `country` | string | No | Country code for search results. Example: "us", "gb", "de" \(default: "us"\) |
 | `mode` | string | No | Analysis mode: domain \(entire domain\), prefix \(URL prefix\), subdomains \(include all subdomains, default\), exact \(exact URL match\) |
 | `apiKey` | string | Yes | Ahrefs API Key |
 
@@ -487,7 +487,7 @@ Get bulk SEO metrics (Domain Rating, backlinks, referring domains, organic traff
 | `targets` | string | Yes | Comma-separated list of domains or URLs to analyze. Example: "example.com,competitor.com" |
 | `mode` | string | No | Analysis mode applied to every target: domain \(entire domain\), prefix \(URL prefix\), subdomains \(include all subdomains, default\), exact \(exact URL match\) |
 | `protocol` | string | No | Protocol applied to every target: "both" \(default\), "http", or "https" |
-| `country` | string | No | Country code for traffic data. Example: "us", "gb", "de" |
+| `country` | string | No | Country code for traffic data. Example: "us", "gb", "de" \(default: "us"\) |
 | `volumeMode` | string | No | Search volume calculation: "monthly" or "average" \(default: "monthly"\) |
 | `apiKey` | string | Yes | Ahrefs API Key |
 

apps/sim/tools/ahrefs/batch_analysis.ts

@@ -37,7 +37,7 @@ export const batchAnalysisTool: ToolConfig<AhrefsBatchAnalysisParams, AhrefsBatc
         type: 'string',
         required: false,
         visibility: 'user-or-llm',
-        description: 'Country code for traffic data. Example: "us", "gb", "de"',
+        description: 'Country code for traffic data. Example: "us", "gb", "de" (default: "us")',
       },
       volumeMode: {
         type: 'string',
@@ -75,7 +75,7 @@ export const batchAnalysisTool: ToolConfig<AhrefsBatchAnalysisParams, AhrefsBatc
         return {
           select: SELECT_FIELDS.split(','),
           targets,
-          ...(params.country ? { country: params.country } : {}),
+          country: params.country || 'us',
           volume_mode: params.volumeMode || 'monthly',
         }
       },

apps/sim/tools/ahrefs/keywords_history.ts

@@ -46,7 +46,7 @@ export const keywordsHistoryTool: ToolConfig<
       type: 'string',
       required: false,
       visibility: 'user-or-llm',
-      description: 'Country code for search results. Example: "us", "gb", "de"',
+      description: 'Country code for search results. Example: "us", "gb", "de" (default: "us")',
     },
     mode: {
       type: 'string',
@@ -71,7 +71,7 @@ export const keywordsHistoryTool: ToolConfig<
       url.searchParams.set('select', SELECT_FIELDS)
       if (params.historyGrouping) url.searchParams.set('history_grouping', params.historyGrouping)
       if (params.dateTo) url.searchParams.set('date_to', params.dateTo)
-      if (params.country) url.searchParams.set('country', params.country)
+      url.searchParams.set('country', params.country || 'us')
       if (params.mode) url.searchParams.set('mode', params.mode)
       return url.toString()
     },

apps/sim/tools/ahrefs/metrics_history.ts

@@ -49,7 +49,7 @@ export const metricsHistoryTool: ToolConfig<
       type: 'string',
       required: false,
       visibility: 'user-or-llm',
-      description: 'Country code for traffic data. Example: "us", "gb", "de"',
+      description: 'Country code for traffic data. Example: "us", "gb", "de" (default: "us")',
     },
     mode: {
       type: 'string',
@@ -75,7 +75,7 @@ export const metricsHistoryTool: ToolConfig<
       url.searchParams.set('select', SELECT_FIELDS)
       url.searchParams.set('volume_mode', params.volumeMode || 'monthly')
       if (params.historyGrouping) url.searchParams.set('history_grouping', params.historyGrouping)
-      if (params.country) url.searchParams.set('country', params.country)
+      url.searchParams.set('country', params.country || 'us')
       if (params.mode) url.searchParams.set('mode', params.mode)
       return url.toString()
     },

apps/sim/tools/ahrefs/paid_pages.ts

@@ -21,7 +21,7 @@ export const paidPagesTool: ToolConfig<AhrefsPaidPagesParams, AhrefsPaidPagesRes
       type: 'string',
       required: false,
       visibility: 'user-or-llm',
-      description: 'Country code for traffic data. Example: "us", "gb", "de"',
+      description: 'Country code for traffic data. Example: "us", "gb", "de" (default: "us")',
     },
     mode: {
       type: 'string',
@@ -58,7 +58,7 @@ export const paidPagesTool: ToolConfig<AhrefsPaidPagesParams, AhrefsPaidPagesRes
       // Date is required - default to today if not provided
       const date = params.date || new Date().toISOString().split('T')[0]
       url.searchParams.set('date', date)
-      if (params.country) url.searchParams.set('country', params.country)
+      url.searchParams.set('country', params.country || 'us')
       if (params.mode) url.searchParams.set('mode', params.mode)
       if (params.limit) url.searchParams.set('limit', String(params.limit))
       return url.toString()