Keyword Research
keyword_researchResearch keyword demand: search volume, difficulty, CPC, and intent, plus keyword ideas, Google Trends interest and related queries, and Google Ads keyword performance. Volume and difficulty come from a live keyword vendor: a workspace without vendor credits gets an explanatory error with the path forward, never fabricated numbers. Use for what to target and how much demand exists; for who ranks today use serp_competitors. Already scoped to the connected workspace and its site; no domain or site parameter is needed. Cost: metrics and suggestions bill AI credits (live vendor data at actual cost); trends, related_queries, compare and performance are FREE (Google Trends / your connected Google Ads).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | suggestions/ads_performance: max results. | |
| action | Yes | Which operation to run. metrics (volume/difficulty/CPC/intent); suggestions (keyword ideas from seeds); compare_trends (Trends interest, keywords side by side); trend (Trends interest over time for one keyword); related (Trends related queries). | |
| keyword | No | trend/related: the single keyword to analyze. | |
| keywords | No | metrics/suggestions/compare_trends: the seed or target keywords. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||