{"id":303290,"date":"2026-04-30T13:58:10","date_gmt":"2026-04-30T13:58:10","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/agent-ready-essentials\/"},"modified":"2026-04-30T13:58:12","modified_gmt":"2026-04-30T13:58:12","slug":"kolibia-agent-ready","status":"publish","type":"plugin","link":"https:\/\/ca.wordpress.org\/plugins\/kolibia-agent-ready\/","author":1973050,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.0","stable_tag":"1.0.0","tested":"7.0","requires":"6.8","requires_php":"8.0","requires_plugins":null,"header_name":"Kolibia Agent-Ready","header_author":"Konrad Karpieszuk","header_description":"Adds API discovery and Markdown responses so AI agents can use your WordPress content and services. Aligns your site with emerging agent-readiness patterns for WordPress.","assets_banners_color":"","last_updated":"2026-04-30 13:58:12","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/kolibia.pl","rating":0,"author_block_rating":0,"active_installs":0,"downloads":80,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"kkarpieszuk","date":"2026-04-30 13:58:12"}},"upgrade_notice":[],"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[15643,2353,257149,226124,4608],"plugin_category":[],"plugin_contributors":[163741],"plugin_business_model":[],"class_list":["post-303290","plugin","type-plugin","status-publish","hentry","plugin_tags-agents","plugin_tags-ai","plugin_tags-content-negotiation","plugin_tags-llm","plugin_tags-markdown","plugin_contributors-kkarpieszuk","plugin_committers-kkarpieszuk"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/kolibia-agent-ready.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Kolibia Agent-Ready makes <strong>singular<\/strong> WordPress content available as <strong>Markdown<\/strong> so tools and agents do not have to scrape HTML. Behaviour follows common <strong>content negotiation<\/strong> patterns (similar in spirit to <a href=\"https:\/\/developers.cloudflare.com\/fundamentals\/reference\/markdown-for-agents\/\">Markdown for Agents<\/a> on Cloudflare): clients that prefer Markdown can request it explicitly.<\/p>\n\n<p><strong>What is included today<\/strong><\/p>\n\n<ul>\n<li><strong>Markdown responses for singular content<\/strong> \u2014 For each <strong>built-in public post type<\/strong> registered by WordPress core (<code>post<\/code>, <code>page<\/code>, <code>attachment<\/code> on a typical site), a single-item URL can return <code>Content-Type: text\/markdown; charset=UTF-8<\/code> instead of the themed HTML page.<\/li>\n<li><strong>When Markdown is served<\/strong>\n\n<ul>\n<li>The request includes an <code>Accept<\/code> header that lists <strong><code>text\/markdown<\/code><\/strong> (requests with <code>text\/markdown;q=0<\/code> are ignored).<\/li>\n<li><strong>Or<\/strong> the URL includes the query argument <strong><code>output_format=md<\/code><\/strong> (handy for browsers and manual testing).<\/li>\n<\/ul><\/li>\n<li><strong>HTML to Markdown<\/strong> \u2014 Rendered post body is passed through WordPress\u2019s <code>the_content<\/code> filters, then converted to Markdown using the <a href=\"https:\/\/github.com\/thephpleague\/html-to-markdown\">league\/html-to-markdown<\/a> library. A short YAML front matter block includes <code>title<\/code> and <code>permalink<\/code>.<\/li>\n<li><strong>Password-protected content<\/strong> \u2014 If a password is required, the response is a small Markdown message instead of the full body.<\/li>\n<li><strong>Discovery in HTML<\/strong> \u2014 On the normal HTML view, the plugin prints <code>&lt;link rel=\"alternate\" type=\"text\/markdown\" href=\"\u2026?output_format=md\" \/&gt;<\/code> so clients can find the Markdown URL.<\/li>\n<li><strong>Admin shortcut<\/strong> \u2014 On the posts and pages list screens, a row action <strong>View as AI Agent<\/strong> opens the same Markdown URL (preview URLs are used for drafts where WordPress would show Preview).<\/li>\n<\/ul>\n\n<p><strong>Developer filters<\/strong><\/p>\n\n<ul>\n<li><code>kolibia_ar_markdown_post_types<\/code> \u2014 Defaults to all <strong>public, built-in<\/strong> post types from core; override to add custom post types or remove types (e.g. <code>attachment<\/code>).<\/li>\n<li><code>kolibia_ar_post_markdown<\/code> \u2014 Filter the final Markdown string.<\/li>\n<li><code>kolibia_ar_markdown_password_required<\/code> \u2014 Filter the Markdown shown when a password is required.<\/li>\n<\/ul>\n\n<p><strong>Roadmap<\/strong><\/p>\n\n<p>Further \u201cagent readiness\u201d features (broader API discovery, additional formats) may be added in future releases.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Copy the <code>agent-ready<\/code> folder into <code>wp-content\/plugins\/<\/code> (or install the distributed package).<\/li>\n<li>Activate <strong>Kolibia Agent-Ready<\/strong> under Plugins in the WordPress admin.<\/li>\n<li>That's it! AI Agents will automatically discover your site's content.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20to%20configure%20anything%3F\"><h3>Do I need to configure anything?<\/h3><\/dt>\n<dd><p>No. Just activate the plugin and you're good to go. AI Agents will automatically discover your site's content.<\/p><\/dd>\n<dt id=\"does%20this%20replace%20my%20theme%20for%20visitors%3F\"><h3>Does this replace my theme for visitors?<\/h3><\/dt>\n<dd><p>No. Normal visitors still get HTML. Markdown is returned only when <code>text\/markdown<\/code> is negotiated or <code>?output_format=md<\/code> is used (and the same permission rules as viewing the content apply).<\/p><\/dd>\n<dt id=\"which%20urls%20are%20affected%3F\"><h3>Which URLs are affected?<\/h3><\/dt>\n<dd><p>Singular URLs for built-in public types from core (typically posts, pages, and media attachment pages). Custom post types are not included unless you add them via the <code>kolibia_ar_markdown_post_types<\/code> filter.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release: Markdown negotiation, <code>output_format=md<\/code>, alternate link, admin \u201cView as AI Agent\u201d, HTML-to-Markdown for singular core public post types.<\/li>\n<\/ul>","raw_excerpt":"Kolibia Agent-Ready adds API discovery and Markdown responses so AI agents can use your WordPress content and services.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/303290","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=303290"}],"author":[{"embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kkarpieszuk"}],"wp:attachment":[{"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=303290"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=303290"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=303290"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=303290"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=303290"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=303290"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}