rank-math/inspect-url asks Google Search Console to inspect a URL.
mode=schedule, the default, queues the inspection in the background. mode=now runs it immediately and consumes one of the site’s limited daily URL Inspection quota units.
At a glance
| Ability | rank-math/inspect-url |
| Toolset | Rank Math — toolset/rank-math |
| Group | Rank Math › Analytics |
| Requires | Rank Math SEO, active on the site |
| Capability | manage_options |
| Safety | Writes data |
| 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 |
The quota is small and shared
Google allows a limited number of URL inspections per site per day, and it is a small number — small enough that an enthusiastic loop over a hundred URLs exhausts it and leaves nothing for anybody else working on the site that day.
The quota is also shared with the Search Console interface, so spending it programmatically takes it away from a person trying to diagnose something by hand.
Which is why scheduling is the default. A queued inspection runs in the background at a rate that respects the quota, and the result lands in the same place.
Use mode=now when the answer is needed immediately and for one URL — after fixing a noindex, say, to confirm the fix registered. Not for bulk work.
Results are read afterwards with rank-math/get-index-status.
Not idempotent: each call is a request, and each immediate one costs quota.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
url | string | Yes | The URL to inspect. |
mode | string | No — defaults to schedule | schedule to queue it, now to run it immediately and spend quota. |
What comes back
| Name | Type | What it is |
|---|---|---|
mode | string | Which mode ran. |
result | object | The inspection result, when run immediately. |
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:
Check whether Google has indexed our new pricing page.
It resolves to one call:
{
"ability": "rank-math/inspect-url",
"parameters": {
"url": "https://example.com/pricing/",
"mode": "schedule"
}
}Worth knowing
- The daily quota is small and shared with the Search Console interface.
- Schedule by default. Use
nowfor one URL when you need the answer today. - Read results with the index status ability.
- Each call is a request. Not idempotent.
Related abilities
- Get Rank Math Index Status — read the results
- Submit URLs to IndexNow — the non-Google equivalent
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category