Bulk SEO Meta Editor for AI Agents

Bulk edit Yoast SEO or Rank Math meta from outside wp-admin. WordPress does not expose those fields over the REST API, so editing a meta title programmatically normally means WP-CLI, a custom plugin, or a premium SEO tier. This plugin adds a clean, authenticated REST surface instead, so AI agents (Claude, ChatGPT, Perplexity), automation tools (n8n, Zapier, Make) and headless workflows can read and rewrite SEO titles, meta descriptions, canonical URLs, robots directives, Open Graph and Twitter fields on up to 100 posts in a single HTTP call.

Auto-detects which SEO plugin is active and exposes plugin-neutral field aliases (title, description, focus_kw, …) so you don’t need to memorise Yoast vs Rank Math meta keys.

What’s included

• REST endpoints: read and write SEO meta on any post, page or custom post type via the standard /wp/v2/posts/{id} route or the namespaced helpers
• Taxonomy term archives: edit SEO meta on category/tag/custom-taxonomy archive pages too, not just posts (Yoast and Rank Math both supported)
• Bulk update: apply changes to up to 100 posts or terms in a single call
• Bulk image alt text: update _wp_attachment_image_alt on up to 200 media-library attachments per call by image URL. Resolves CDN paths and -WIDTHxHEIGHT thumbnail suffixes back to the parent attachment automatically (v1.5.0+)
• CSV import / export: round-trip your SEO meta through Excel or Google Sheets, posts and terms in one file
• MCP server: bundled Node.js companion (bulk-seo-meta-editor-mcp on npm) so Claude Desktop and Claude Code can drive the plugin natively
• Auto-detection: works with Yoast SEO or Rank Math, picks the active one automatically
• Per-object permission checks: Contributors and Authors can only edit posts, media and terms they could edit in wp-admin; site-wide archive and global settings require an administrator
• Allowlist enforcement: only meta keys belonging to the active SEO plugin are accepted; arbitrary postmeta writes are rejected
• Custom JSON-LD schema (v1.6.0+): store structured data (FAQPage, HowTo, Service, or any type) per post; it is injected into Yoast’s or Rank Math’s existing schema graph rather than as a duplicate block

REST endpoints

All endpoints live under /wp-json/seo-meta-bridge/v1/ (or ?rest_route=/seo-meta-bridge/v1/... on plain-permalink installs):

• GET /status: detect the active SEO plugin and list available fields
• POST /bulk: update SEO meta on up to 100 posts/terms in one call
• POST /bulk-alts: update image alt text on up to 200 media-library attachments by URL
• GET /export: export all posts’ SEO meta as CSV, returned in the JSON response body
• POST /import: apply updates from a CSV upload or JSON rows array
• GET /schema (v1.6.0+): read back the custom JSON-LD schema stored on a post

The standard WordPress REST route also works: POST /wp/v2/posts/{id} with a meta payload containing Yoast or Rank Math keys.

Field aliases

Alias
Yoast meta key
Rank Math meta key

title
_yoast_wpseo_title
rank_math_title

description
_yoast_wpseo_metadesc
rank_math_description

focus_kw
_yoast_wpseo_focuskw
rank_math_focus_keyword

canonical
_yoast_wpseo_canonical
rank_math_canonical_url

og_title
_yoast_wpseo_opengraph-title
rank_math_facebook_title

og_image
_yoast_wpseo_opengraph-image
rank_math_facebook_image

tw_title
_yoast_wpseo_twitter-title
rank_math_twitter_title

Plus robots, OG/Twitter description fields, and Rank Math primary-taxonomy keys.

MCP server (Claude / Claude Code)

A Node.js MCP server is bundled at https://github.com/puneetindersingh/bulk-seo-meta-editor-for-ai-agents/tree/main/mcp-server and published to npm as bulk-seo-meta-editor-mcp. Add to Claude Desktop / Claude Code with one command and Claude can read, edit, bulk-update, and CSV-roundtrip SEO meta on any of your sites.

Security

• Application Passwords (Basic Auth), HTTPS required in production
• Per-post edit_post capability check on every write
• Meta keys are allowlisted to the active plugin’s known fields
• URL-shaped fields (canonical, og_image, twitter_image) sanitised through esc_url_raw
• No new admin UI, no settings page, nothing to misconfigure

Trademarks

Yoast SEO is a trademark of Yoast BV. Rank Math is a trademark of RankMath. Claude is a trademark of Anthropic PBC. ChatGPT is a trademark of OpenAI OpCo. WordPress is a trademark of the WordPress Foundation. All other product names, logos, and brands are property of their respective owners. This plugin is an independent integration and is not affiliated with, endorsed by, or sponsored by any of them. Trademarks are referenced only to describe interoperability with the listed products.