# Goldnat for WordPress — Rank Math SEO

Ask your AI agent to fix SEO titles and descriptions, add FAQ schema, redirect broken URLs from the 404 log and check your sitemap and robots.txt. Every change goes through Rank Math itself, with the same permissions as your Rank Math screens.

- Platform: WordPress
- Edition: paid add-on
- Web page: https://plugins.goldnat.ai/wordpress/wp-rank-math-ai-connect
- Installation guide: https://plugins.goldnat.ai/wordpress/guide
- Requires: Goldnat for WordPress (https://plugins.goldnat.ai/wordpress/wordpress-plugin.md)

## What it does

- **Rank Math does the work** — Scores, audits, schema output, redirections and sitemaps are handled by Rank Math itself. The agent uses the same functions Rank Math's own screens and its agent abilities use.
- **Same permissions as your Rank Math screens** — Each tool checks the Rank Math capability for the matching screen, and edits to a post also need the right to edit that post. Editors see only what they could change in wp-admin.
- **A preview before anything is removed** — Deleting redirections, schema entries or 404 log entries and applying an audit fix answer with a preview first and run only after you confirm.
- **Nothing leaves your site by surprise** — Redirection targets are stored as text and the audit only checks your own site. The agent never fetches a URL you give it.
- **Your SEO in one conversation** — 39 tools: SEO titles, descriptions and focus keywords (one post or many), SEO scores, content analysis, links, schema entries, redirections, the 404 log, sitemap, robots.txt, llms.txt, the site SEO audit and its fixes, modules, homepage, breadcrumbs, website identity and post-type defaults.
- **From 404 to redirect in one step** — The agent reads the 404 log, suggests where each broken URL should go and creates the redirection when you agree.
- **Works with free Rank Math** — Rank Math SEO 1.0.271 or newer on WordPress 6.9 or newer is all you need; Rank Math PRO is not required.

## What you can ask the agent

- "Which posts have a weak SEO score?" — The agent lists posts by Rank Math score and grade, including posts without a focus keyword.
- "Write better titles and descriptions for these five posts." — It reads each post, proposes the text and saves it in Rank Math after you agree.
- "What is breaking on my site?" — It reads the 404 log and creates redirections for the URLs you choose.
- "Add an FAQ section to the schema of this post." — It adds an FAQPage schema entry that Rank Math outputs with the page.
- "Run an SEO audit." — It runs Rank Math's site audit, explains each failing test and applies Rank Math's fix when you confirm.
- "Is /old-shop redirected anywhere?" — It checks which redirection catches that path and where it sends visitors.

## Install and connect

1. Install the free core plugin first: Goldnat for WordPress (https://plugins.goldnat.ai/wordpress/wordpress-plugin). This plugin runs on top of it.
2. Buy Goldnat for WordPress — Rank Math SEO at goldnat.ai, download it, and upload it in your WordPress admin panel. Enter the license key you receive.
3. Connect your AI agent: in goldnat.ai (or another compatible agent) add your site address. You are sent to your own WordPress site to log in and approve what the agent may do (read only, or read and write).
4. Ask the agent in plain language. It calls the plugin on your site as you, and shows you the result.
5. Full installation guide with screenshots: https://plugins.goldnat.ai/wordpress/guide

## What the agent can and cannot do

- The agent acts as the WordPress user who connected it. It can never see or change more than that user can.
- You approve the access level when you connect (read only, or read and write), and you can revoke the connection at any time from the plugin page in your admin panel.
- Actions that delete content or cannot be undone ask for an explicit confirmation first.
- Your content stays on your site. The plugin answers the agent's requests directly; it does not copy your site anywhere else.

## Tools

Each tool is called by the agent by name. "write" tools need write access approved at connection.

- `rankmath.auditSiteSeo` (read) — Rank Math's site-wide SEO audit: overall score and grade and every test with its status and fix hint. Returns the last stored audit unless refresh is true (a fresh audit can take up to a minute).
- `rankmath.fixSiteSeoIssue` (admin) — Apply Rank Math's own automatic fix for one failing audit test: blog_public, permalink_structure, site_description, sitemaps, schema, noindex, opengraph, robots_txt, focus_keywords or post_titles. Changes site settings or posts, so it requires confirm: true (without it the answer explains the change).
- `rankmath.getSystemStatus` (admin) — Rank Math and WordPress status for SEO troubleshooting: Rank Math version, plan, active modules, Google connection state, its database tables, and the WordPress settings that affect indexing. Private values are left out. Administrators only.
- `rankmath.analyzePostContent` (read) — Get what Rank Math checks for one saved post — its content, SEO data and the list of on-page SEO tests — so you can judge it against its focus keyword (or the keyword you give).
- `rankmath.bulkUpdateSeoMeta` (write) — Update SEO title, meta description and focus keywords on up to 20 posts in one call. Each row is checked and saved on its own; the answer lists what was saved and what was refused.
- `rankmath.getLinkReport` (read) — Site-wide link counts from Rank Math's link counter: total internal and external links and how many posts have no internal or no external link.
- `rankmath.getPostLinks` (read) — List the internal and external links Rank Math's link counter recorded for one post.
- `rankmath.getSeoMeta` (read) — Get the Rank Math SEO data of one post or page: SEO title, meta description, focus keywords, robots, canonical URL, Open Graph and Twitter texts, SEO score, pillar-content flag and primary category. Requires edit access to that post.
- `rankmath.getSeoScores` (read) — List posts with their Rank Math SEO score and grade, newest-modified first. Only posts you may edit are listed.
- `rankmath.updateSeoMeta` (write) — Update the Rank Math SEO data of one post or page. Only the fields you send change; an empty string clears a field. Title, description, keywords, pillar flag and primary category need rank_math_onpage_general; robots and canonical need rank_math_onpage_advanced; social texts need rank_math_onpage_social.
- `rankmath.clearSitemapCache` (write) — Clear Rank Math's stored sitemap cache so every sitemap is rebuilt on its next request.
- `rankmath.getLlmsTxt` (read) — Whether Rank Math's llms.txt file is on, its URL and the generated content.
- `rankmath.getRobotsTxt` (read) — The robots.txt content Rank Math serves, and whether a physical robots.txt file overrides it.
- `rankmath.getSitemapStatus` (read) — Whether Rank Math's XML sitemap is on, the sitemap index URL and each sitemap with its estimated item count.
- `rankmath.updateRobotsTxt` (write) — Replace the robots.txt content Rank Math serves (up to 10 000 characters; tags are stripped). Refused when a physical robots.txt file exists, because Rank Math cannot serve its own then.
- `rankmath.updateSitemapSettings` (write) — Change XML sitemap settings: links per sitemap page, images and featured images, excluded post and term ids, the author sitemap, and which post types and taxonomies are included.
- `rankmath.clear404Logs` (delete) — Empty the whole 404 log. Requires confirm: true; without it the answer says how many entries would be removed.
- `rankmath.delete404Logs` (delete) — Delete up to 100 entries from the 404 log by id. Requires confirm: true.
- `rankmath.list404Logs` (read) — List the URLs Rank Math's 404 monitor recorded, with hit count, last access, referrer and user agent, plus totals.
- `rankmath.redirect404Log` (write) — Fix a recorded 404: create an exact-match redirection from its path to a target URL and, unless keep_log is true, remove the log entry.
- `rankmath.createRedirection` (write) — Create a redirection from one or more source paths to a target URL, as 301, 302, 307, 410 or 451. Refuses a redirection that points to itself.
- `rankmath.deleteRedirections` (delete) — Permanently delete up to 50 redirections. Requires confirm: true; without it the answer previews what would be deleted.
- `rankmath.findRedirectionForUrl` (read) — Check which active redirection, if any, catches a URL or path on this site and where it sends the visitor. Nothing is fetched.
- `rankmath.getRedirection` (read) — Get one redirection: every source pattern and how it is matched, the target, type, status, hits and last access time.
- `rankmath.listRedirections` (read) — List Rank Math redirections with their sources, target, type, status and hits, plus totals. Filter by status or search text.
- `rankmath.setRedirectionStatus` (write) — Switch up to 50 redirections to active, inactive or trashed (trashed ones can be switched back).
- `rankmath.updateRedirection` (write) — Change an existing redirection: its sources, target, type or status. Fields you do not send keep their value.
- `rankmath.addPostSchema` (write) — Add a schema entry (for example Article, FAQPage, HowTo, Product, Event) to one post. Rank Math sanitises and stores it as its schema editor does.
- `rankmath.deletePostSchema` (delete) — Remove one schema entry from a post. Requires confirm: true.
- `rankmath.getPostSchema` (read) — Get the schema (structured data) entries attached to one post, each with its schema_id, and the schema types available on this site.
- `rankmath.updatePostSchema` (write) — Replace one schema entry of a post (schema_id from getPostSchema). Only entries that belong to that post can be changed.
- `rankmath.getSettings` (admin) — Rank Math settings by section: general, titles, sitemap, instant_indexing, modules, auto_update. Keys and tokens are removed. Administrators only.
- `rankmath.setModuleStatus` (admin) — Turn Rank Math modules on or off, e.g. {"redirections": true, "404-monitor": true}. Module slugs are listed by getSettings (modules section). Administrators only.
- `rankmath.updateBreadcrumbSettings` (write) — Change Rank Math breadcrumbs: on or off, separator, home link and label, prefix, archive / search / 404 formats and which parts are shown.
- `rankmath.updateGlobalSeoSettings` (write) — Change site-wide SEO defaults: global robots directives, noindex for empty taxonomy archives, title separator, title capitalisation and the default Twitter card.
- `rankmath.updateHomepageSeo` (write) — Set the SEO title, meta description and focus keyword of the homepage (the keyword only applies to a static front page).
- `rankmath.updateLinkSettings` (write) — Change how Rank Math treats links in content: nofollow and new tab for external links, nofollow image links, nofollow domain lists, stripping the category base and redirecting attachment pages.
- `rankmath.updatePostTypeSeoSettings` (write) — Change per-post-type SEO defaults: title and description templates, default schema type and article type, custom robots and whether the SEO box is shown, e.g. {"post": {"title": "%title% %sep% %sitename%"}}.
- `rankmath.updateWebsiteIdentity` (write) — Set the Knowledge Graph identity Rank Math puts into schema: person or company, website name and alternate name, the person / organisation name, organisation description, business type and URL.

## Frequently asked questions

**Do I need Rank Math PRO or a Rank Math account?**

No. The tools use the free Rank Math plugin. Features that need a Rank Math account or credits, such as Analytics, rank tracking and Content AI, are not included.

**Does it use Rank Math Content AI credits?**

No. Your own AI agent writes the titles, descriptions and schema; the plugin saves them through Rank Math.

**What if a Rank Math module is switched off?**

The tools for that module say which module is off. An administrator can switch it on by asking the agent or in Rank Math's dashboard.

**Which AI agents can I use?**

Our own agent at goldnat.ai, and other AI agents that support the Servio protocol. The list of compatible clients is on this page.

**Can the AI see or change things I can't?**

No. It works as the WordPress user who connected it, with exactly that user's permissions. Connect it with an account that has only the access you want it to have.

**Will it change things without asking?**

Only if you approved write access when you connected it. Deleting or irreversible actions ask for an explicit confirmation.

**How do I disconnect an agent?**

Revoke its connection from the plugin page in your admin panel. The agent loses access immediately.

**Do I also need Goldnat for WordPress?**

Yes. Goldnat for WordPress — Rank Math SEO runs on top of the free core plugin, which handles the secure connection.

## Guides

- [Managing Many WordPress Sites with an AI Agent](https://plugins.goldnat.ai/docs/06-managing-many-wordpress-sites) — A practical guide for agencies and freelancers who look after several WordPress sites — how to connect one AI agent to all of them with the Goldnat plugins, what it can check and change on each site, how permissions and confirmations keep it safe, and a weekly routine you can copy.
