Beschrijving
Agentic Optimization helps WordPress sites expose public content to AI agents in a safer, WordPress-native way.
If SEO helped search engines discover, index, and understand websites, Agentic Optimization does something similar for AI agents, assistants, and LLM-powered tools. It gives public WordPress content clearer discovery files, cleaner read-only endpoints, and structured access paths that are easier for agentic systems to use responsibly.
Instead of trying to make AI tools scrape full themes, shortcodes, and plugin output blindly, this plugin helps site owners publish a more intentional agent-facing layer for public content.
Features in the free plugin:
- Root-level
llms.txt - Optional root-level
llms-full.txt - Optional
/.well-known/ai.txtand/ai.txtguidance for AI-agent discovery - Root-level
agent-sitemap.xml - Optional WordPress
robots.txtenhancement with discovery hints - Optional AI-agent user-agent routing from public content pages to the markdown view
- Optional public URL format switcher with
?vwao_view=markdown,json,html, orclean - Optional agent sitemap mode that lists public markdown variant URLs such as
?vwao_agent=1 - Public REST search, content, markdown, comments, categories, tags, and site info endpoints
- Read-only MCP endpoint with search, content, comments, taxonomy, and site info tools
- Hard request caps and transient-based rate limiting
- Privacy-friendly analytics with aggregate counts and hashed IP logs only
- Admin-managed site description and site details for llms.txt context
- SEO-aware content exclusion hooks for common noindex patterns
- Extension points for future add-ons and custom integrations
- Formatter and admin hooks for add-ons that extend post type coverage or editorial agent overrides
The plugin is intentionally conservative:
- Read-only only
- Public content only
- No drafts, private content, or pending comments
- Comments exposure disabled by default
- MCP disabled by default
- Analytics disabled by default
External Services
This plugin generates agent-optimized discovery files and sitemaps using standard XML formats.
Sitemaps.org XML Schema
The agent-sitemap.xml output uses the standard sitemap XML namespace (http://www.sitemaps.org/schemas/sitemap/0.9) and a custom extension URN namespace (urn:videowhisper:agentic:1.0). These are identifier strings embedded in locally generated XML documents only. No data is transmitted to external services when the sitemap file is generated or served.
- sitemaps.org protocol reference: https://www.sitemaps.org/protocol.html
Installatie
- Upload the plugin folder to
/wp-content/plugins/. - Activate VideoWhisper Agentic Optimization in the WordPress admin.
- Go to
Settings > Agentic Optimization. - Enable the discovery outputs and APIs you want to expose.
- Save settings to publish your selected endpoints.
FAQ
-
What URLs does the plugin create?
-
When enabled, the plugin publishes:
/llms.txt/llms-full.txt/.well-known/ai.txt/ai.txt/agent-sitemap.xml/robots.txt(enhanced virtual output when enabled)/wp-json/videowhisper-agentic-optimization/v1/search/wp-json/videowhisper-agentic-optimization/v1/content/wp-json/videowhisper-agentic-optimization/v1/markdown/<id>/wp-json/videowhisper-agentic-optimization/v1/comments/<post_id>/wp-json/videowhisper-agentic-optimization/v1/site-info/wp-json/videowhisper-agentic-optimization/v1/mcp
-
Does the free plugin allow writes?
-
No. The free plugin only exposes read-only access to public content.
-
How can I test AI-agent routing?
-
Enable AI-agent routing on the Robots tab, then open any public post or page with
?vwao_agent=1appended to the URL. The parameter name can be changed in settings. -
Can agents access the normal human page?
-
Yes. Markdown responses include a human page URL with
?vwao_human=1, which bypasses AI-agent redirects and returns the normal theme-rendered page. -
What does the URL view parameter do?
-
When enabled, public single content URLs can render alternate views with
?vwao_view=markdown,?vwao_view=json,?vwao_view=html, or?vwao_view=clean. Explicit view requests bypass AI-agent redirects. -
Does it track visitors?
-
Analytics are disabled by default. When enabled, the plugin stores aggregate counters and recent event logs with hashed IP values only.
Beoordelingen
Er zijn geen beoordelingen voor deze plugin.
Bijdragers & ontwikkelaars
“Agentic Optimization – SEO for AI Agents” is open source software. De volgende personen hebben bijgedragen aan deze plugin.
BijdragersVertaal “Agentic Optimization – SEO for AI Agents” in je eigen taal.
Interesse in ontwikkeling?
Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.
Changelog
1.0.8
- Added optional
/.well-known/ai.txtand/ai.txtdiscovery guidance for AI agents. - Added configurable AI-agent user-agent routing from public single content pages to the markdown view.
- Added configurable
vwao_agentandvwao_humanURL parameters for agent markdown and human page variants. - Added optional
vwao_view=markdown|json|html|cleanpublic URL view switching. - Added optional agent sitemap mode that lists agent-view markdown URLs.
- Improved robots.txt recommendations with agent API allow lines when related endpoints are enabled.
1.0.4
- Added endpoint-specific public content matrices with per-endpoint discovery exposure and per-type discovery limits.
- Added grouped discovery output for
llms.txt,llms-full.txt, andagent-sitemap.xmlwith improved page, post, and custom post type ordering. - Improved agent markup conversion and fixed plain-text discovery output so markdown blockquotes and other characters are not HTML-escaped.
- Improved admin Discovery reporting and external integration hooks.
1.0.3
- Added:
vwao_post_summaryandvwao_admin_tab_labelhooks so add-ons can extend summaries and admin navigation safely. - Changed: the built-in post type chooser now focuses on posts and pages, while extensions can add custom post type exposure through hooks.
- Bumped stable tag to 1.0.3.
1.0.2
- Changed: REST namespace is now plugin-prefixed as
/wp-json/videowhisper-agentic-optimization/v1/...for WordPress.org compliance. - Bumped stable tag to 1.0.2.
1.0.1
- Fixed: Active settings tab now passed through the Settings API
$inputarray, removing direct POST reads inside the sanitize callback. - Added:
== External Services ==section in readme.txt documenting XML namespace usage foragent-sitemap.xml. - Changed: Custom
agent-sitemap.xmlextension namespace from URL form to URN (urn:videowhisper:agentic:1.0) to avoid implying any external service call. - Bumped stable tag to 1.0.1.
1.0.0
- Initial release.
- Added root-level
llms.txt,llms-full.txt, andagent-sitemap.xml. - Added admin-managed llms.txt context fields and optional robots.txt enhancement.
- Added public REST endpoints for search, content, markdown, comments, terms, and site info.
- Added a read-only HTTP JSON-RPC MCP endpoint.
- Added rate limiting, analytics, settings UI, and extension hooks for future add-ons.
