Menu da documentação
Primeiros passos
O que é o Opus GrowthInício rápidoAdicione à sua IAComo funcionaSegurança e aprovaçãoCréditosPlanosPerguntas frequentesApps de IA
Todos os appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOutros MCPPlataformas de anúncios
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgências e MCCFontes de dados
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerSites e SEO
AI ServerWordPressSEO IntelligenceFraude de cliquesReferência de ferramentas
Todas as ferramentasGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceFraude de cliquesMulticanalConta e cobrançaIdioma
Keyword Historical Metrics
Google Ads Keyword Planner HISTORICAL METRICS for keywords you already have (not new ideas — use keyword_planner for ideas).
- Tipo
- Somente leitura
- Créditos
- 3
- Plataforma
- Google Ads
- Aprovação
- Não precisa, nada muda
O que faz
Google Ads Keyword Planner HISTORICAL METRICS for keywords you already have (not new ideas — use keyword_planner for ideas). For each keyword returns the month-by-month search volume (monthly_searches: [{month: 'YYYY-MM', searches}]), average monthly searches, competition (LOW/MEDIUM/HIGH + 0-100 index), the top-of-page bid range (low/high, account currency) and average CPC, plus the close variants Google grouped under it. It shows seasonality and trend for keywords (a fall in searches vs a seasonal pattern). keywords: up to 10,000 per call. language_id: Google language constant id (1000 English, 1037 Turkish, 1001 German…); empty = all languages. geo_ids: Google geo target constant ids (geo_target_search finds them); empty = all locations. start_month / end_month: 'YYYY-MM'; Google keeps roughly the last 4 years; default is the last 12 months. Read-only.
A descrição está em inglês porque é o texto oficial que sua IA vê.
MCP: keyword_historical_metrics
Como usar
Você não chama as ferramentas pelo nome. Escreva o que quer no ChatGPT, Claude ou outro assistente conectado ao Opus Growth; a IA escolhe esta ferramenta quando ela serve.
Parâmetros
| Nome | Tipo | Obrigatório | Padrão | |
|---|---|---|---|---|
| customer_id | string | Obrigatório | · | Google Ads customer account ID to query or change. Use the numeric ID returned by list_accounts; omit separators unless this tool explicitly says otherwise. |
| keywords | array | Obrigatório | · | List of keyword or search-term values to use; follow the provider's match-type and formatting rules. |
| language_id | string | Opcional | · | Exact language identifier to target. Use the ID returned by an Opus Growth list or create operation, not a display name. |
| geo_ids | array | Opcional | · | One or more exact geo identifiers to target. Use identifiers returned by an Opus Growth list or create operation, not display names. |
| start_month | string | Opcional | · | Exact start month value for keyword historical metrics. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation. |
| end_month | string | Opcional | · | Exact end month value for keyword historical metrics. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation. |
Ferramentas relacionadas
account_auditAccount Snapshotaccount_snapshotAdd Keywordsadd_keywordsAdd Negative Keywordadd_negative_keywordAdd PMax Imagesadd_pmax_imagesApply Recommendationapply_recommendationBudget Pacing Alertsbudget_pacing_alertsCompetitor Adscompetitor_adsConnect Business Profileconnect_business_profile