Get top keywords is a WordPress ability from Rank Math SEO — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Get top keywords
Read-onlyRetrieve the top-performing keywords by clicks from Google Search Console, with impressions, CTR, and average position.
Requires the Rank Math SEO plugin on WordPress 6.9+ for the Abilities API. AI Visibility abilities require the 'manage_options' capability; Link Genius abilities require 'rank_math_link_builder'; Post SEO abilities require 'rank_math_onpage_general'; Schema abilities require 'rank_math_onpage_snippet'; SEO Analysis abilities require 'rank_math_site_analysis'; Analytics abilities require 'rank_math_analytics'; Content Analysis abilities require 'rank_math_onpage_analysis'. Some outputs (broken-link audit data in get-link-report, extra schema types in get-post-schema) are only populated when Rank Math PRO is active.
What it does
This ability returns Rank Math's Search Console keyword report: the top keywords ranked by clicks over a chosen date range (last_7_days, last_30_days, last_3_months, last_6_months, or last_12_months, defaulting to last_30_days), each with its clicks, impressions, click-through rate, and average position. An optional limit (1-100, default 25) caps how many keywords are returned. On Rank Math PRO, each keyword can additionally include a position trend versus the previous period, whether it's tracked in the PRO Rank Tracker, and the specific pages on the site that rank for it. The response also reports whether Google Search Console is connected, so an AI assistant can tell a disconnected state apart from a genuinely empty result. Requires the 'rank_math_analytics' capability.
See it in action
You ask your AI assistant
"Show me my top 10 keywords by clicks from Google Search Console over the last 30 days."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| date_range | string | No | Date range for which to fetch keyword data: last_7_days, last_30_days, last_3_months, last_6_months, or last_12_months. Defaults to last_30_days. |
| limit | integer | No | Maximum number of keywords to return (1-100). Defaults to 25. |
Returns
An object with keywords (array of {keyword, clicks, impressions, ctr, position, trend, is_tracked, ranking_posts} — trend, is_tracked and ranking_posts are populated by Rank Math PRO), date_range, and connected (boolean, whether Google Search Console is connected).
Permission
Requires the 'rank_math_analytics' capability.
More Rank Math SEO abilities
Analyze post content
Gather a post's raw content, metadata, and list of on-page SEO tests so an AI agent can run Rank Math's full on-page analysis itself.
Audit site SEO
Run Rank Math's site-wide SEO audit and get back a structured score with per-test findings and fix hints.
Create AI Visibility brand
Add a new brand to AI Visibility monitoring and automatically kick off its first analysis.
Fix site SEO
Apply an automatic fix for a single failing Rank Math SEO audit test.
Get AI Visibility brand insights
Pull the full AI Visibility analysis for a single brand — score, rank, sentiment, mentions, citations, competitor breakdown, and raw per-query AI responses.
Get AI Visibility brand queries
List the search queries being monitored for a brand's AI Visibility tracking, including which are enabled or auto-generated baselines.