rank-math/research-keyword runs Rank Math Content AI keyword research and returns the recommended keywords, questions and related terms. It refuses without confirm: true.
It consumes credits from the connected Rank Math account.
Before you run it
This consumes credits from the connected Rank Math account, and they cannot be refunded. The balance is checked first and the request fails without spending anything if none remain — but a request that succeeds and returns something unhelpful has still spent them. Check the balance beforehand with rank-math/get-content-ai-status.
At a glance
| Ability | rank-math/research-keyword |
| Toolset | Rank Math — toolset/rank-math |
| Group | Rank Math › Content AI |
| Requires | Rank Math SEO, active on the site |
| Capability | manage_options |
| Safety | Spends credits that cannot be refunded, and refuses to run without confirm: true. |
| Repeatable | Not idempotent — each call changes the row set, so re-running is not a no-op |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
Content AI runs on credits bought from Rank Math. Spending somebody’s credits is not something to do as a side effect of a request, so every ability here states plainly whether it spends any, and the ones that do are gated.
The balance is checked before the request, so a call with no credits fails without spending anything rather than failing partway through something billable.
That protects against the zero case and nothing else. A call with credits available spends them, whatever comes back — and keyword research on a vague or misspelled term returns results about that term.
So the confirmation is doing real work here. It is not about reversibility, because nothing is changed on the site; it is about the request being deliberate, at the cost it carries.
Not idempotent. Each call is a fresh request and a fresh charge, which makes retrying a call whose result you did not see genuinely expensive rather than merely untidy.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
keyword | string | Yes | The keyword to research. |
country | string | No | The market to research it in. |
confirm | boolean | Yes — must be true | The irreversibility gate. Without it the call is refused before anything is touched. |
What comes back
| Name | Type | What it is |
|---|---|---|
keywords | array | Recommended keywords. |
questions | array | Related questions. |
related | array | Related terms. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Research the keyword “wordpress performance” with Content AI.
It resolves to one call:
{
"ability": "rank-math/research-keyword",
"parameters": {
"keyword": "wordpress performance",
"confirm": true
}
}Worth knowing
- Spends credits. They do not refund.
- Check the balance first — a zero-credit call fails free, a successful one does not.
- Not idempotent. Retrying costs again.
- Nothing on the site is changed.
Related abilities
- Get Rank Math Content AI Status — check the balance first
- Manage Content AI Output — keep what you paid for
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category