GET \/wp-json\/mescio-for-agents\/v1\/markdown?id=42\nGET \/wp-json\/mescio-for-agents\/v1\/markdown?url=https:\/\/yoursite.com\/my-page\/\n<\/code><\/pre>\n\nDeveloper hooks<\/h4>\n\n
Filter: mescio_enabled_post_types<\/code><\/strong> \u2014 add or remove post types dynamically.<\/p>\n\nFilter: mescio_pre_convert_content<\/code><\/strong> \u2014 modify the HTML before conversion to Markdown.<\/p>\n\nFilter: mescio_post_convert_content<\/code><\/strong> \u2014 modify the Markdown after conversion.<\/p>\n\nPrivacy<\/h4>\n\n
This plugin does not collect, store or transmit any personal data. It does not set cookies. It does not make external HTTP requests.<\/p>\n\n\n
\n- Upload the
mescio-for-agents<\/code> folder to \/wp-content\/plugins\/<\/code>, or install directly from the WordPress plugin directory.<\/li>\n- Activate the plugin through the Plugins<\/strong> menu in WordPress.<\/li>\n
- Optionally configure it at Settings \u2192 Mescio for Agents<\/strong>.<\/li>\n
- Test it:
curl https:\/\/yoursite.com\/any-post\/ -H \"Accept: text\/markdown\"<\/code><\/li>\n<\/ol>\n\nNo API keys, no external services, no additional dependencies required.<\/p>\n\n\n
\nWill this affect my site's SEO or how Google crawls it?<\/h3><\/dt>\nNo. The plugin only responds with Markdown when an HTTP client sends Accept: text\/markdown<\/code>. Standard browsers and Googlebot never send this header, so they receive the normal HTML page. The Markdown responses include X-Robots-Tag: noindex<\/code> to be safe.<\/p><\/dd>\nDoes it work with the Gutenberg block editor?<\/h3><\/dt>\nYes. The plugin applies WordPress's the_content<\/code> filter, which fully processes Gutenberg blocks into HTML before conversion.<\/p><\/dd>\nDoes it work with Elementor, Divi or other page builders?<\/h3><\/dt>\nYes. The HTML cleaner aggressively strips layout wrapper elements, data attributes and icon-only links produced by visual page builders, resulting in clean semantic Markdown.<\/p><\/dd>\n
Does it work without WooCommerce?<\/h3><\/dt>\nYes. WooCommerce is completely optional. Without it, the plugin works normally for posts and pages.<\/p><\/dd>\n
Does it require WPML or Polylang?<\/h3><\/dt>\nNo. Both are optional. Without them, Mescio for Agents detects the site language from the WordPress locale setting. You can also configure languages manually in Settings \u2192 Mescio for Agents.<\/p><\/dd>\n
Can I add custom post types?<\/h3><\/dt>\nYes, either from the settings page or via the mescio_enabled_post_types<\/code> filter:<\/p>\n\nadd_filter( 'mescio_enabled_post_types', function( $types ) {\n $types[] = 'my_cpt';\n return $types;\n});\n<\/code><\/pre><\/dd>\nIs there a \"powered by\" link added to my site?<\/h3><\/dt>\nNo. The plugin adds no frontend links, scripts or styles to your site.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.6.5<\/h4>\n\n\n- Security: added two-layer burst protection to rate limiter<\/li>\n
- Layer 1 \u2014 burst guard: IPs sending more than 20 requests in 5 seconds are auto-blocked for 10 minutes; block checked with a single transient read before any WordPress processing<\/li>\n
- Layer 2 \u2014 sustained limits unchanged: 10 req\/60s for llms-full.txt, 20 for REST search, 30 for other REST, 60 default<\/li>\n
- All burst thresholds filterable via
mescio_burst_limit<\/code>, mescio_burst_window<\/code>, mescio_block_duration<\/code><\/li>\n- REST 429 responses now include
Retry-After<\/code>, X-RateLimit-Remaining<\/code>, X-RateLimit-Reset<\/code> headers<\/li>\n- Consolidated REST rate limit logic into
Mescio_For_Agents_Rate_Limiter::check_for_rest()<\/code> (handles both burst + sustained in one call)<\/li>\n- Removed duplicate
get_request_ip()<\/code> from main class \u2014 now uses Rate_Limiter::get_ip()<\/code> throughout<\/li>\n<\/ul>\n\n1.6.3<\/h4>\n\n\n- Fix: shortcode builder tags (WPBakery, WoodMart, ecc.) rimossi anche dagli excerpt nel llms.txt index<\/li>\n
- Fix: llms.txt ora serve titoli, excerpt e permalink nella lingua corretta su siti multilingua (WPML\/Polylang)<\/li>\n
- Fix: llms-full.txt ora serve il contenuto completo dei post nella lingua corretta (WPML\/Polylang)<\/li>\n<\/ul>\n\n
1.6.1<\/h4>\n\n\n- Fixed 404 on multilingual sites using WPML or Polylang:
llms.txt<\/code> and llms-full.txt<\/code> now resolve correctly under language-prefixed URLs (e.g. \/it\/llms.txt<\/code>, \/en\/llms-full.txt<\/code>)<\/li>\n- Added
parse_request<\/code> early intercept (priority 1) as fallback for language plugins that rewrite REQUEST_URI before WordPress rewrite rules run<\/li>\n- Added rewrite rule variant matching
\/xx\/llms.txt<\/code> and \/xx-XX\/llms.txt<\/code> patterns<\/li>\n<\/ul>\n\n1.6.0<\/h4>\n\n\n- Added rate limiting: per-IP request throttling on all endpoints via WordPress transients<\/li>\n
llms-full.txt<\/code> limited to 10 req\/60s, REST search to 20, other REST to 30, default to 60<\/li>\n- Returns 429 Too Many Requests with
Retry-After<\/code> header when limit exceeded<\/li>\n- Respects Cloudflare, nginx and standard
X-Forwarded-For<\/code> proxy headers<\/li>\n- Added sensitive meta key filter: fields containing
password<\/code>, token<\/code>, email<\/code>, phone<\/code>, iban<\/code> and similar patterns are never exposed in Markdown front matter<\/li>\n- Both rate limiting and sensitive key filter are filterable by developers<\/li>\n<\/ul>\n\n
1.5.0<\/h4>\n\n\n- Added automatic custom fields support in Markdown front matter<\/li>\n
- If ACF is active, uses
get_fields()<\/code> with label-keyed, typed values; nested groups and repeaters flattened to dot notation (e.g. group.field<\/code>)<\/li>\n- Without ACF, exposes plain post meta \u2014 skipping internal keys (
_<\/code> prefix), serialized data, JSON blobs and known plugin internals<\/li>\n- Added
mescio_custom_meta<\/code> filter for developer overrides<\/li>\n<\/ul>\n\n1.4.0<\/h4>\n\n\n- Added
\/agents.txt<\/code> endpoint following IETF draft-srijal-agents-policy-00<\/li>\n- SHA-256 hash computed automatically from directive content<\/li>\n
- Configurable directives (path, ALLOW\/DISALLOW, optional params) via admin settings<\/li>\n
- Live preview of generated file with hash in settings page<\/li>\n
- Default directives:
\/ ALLOW<\/code>, \/wp-admin DISALLOW<\/code>, \/wp-login.php DISALLOW<\/code><\/li>\n- Added
\/agents.txt<\/code> link in Quick Links table<\/li>\n<\/ul>\n\n1.3.0<\/h4>\n\n\n- Refactored monolith into modular architecture (6 separate class files)<\/li>\n
- Added REST endpoint
\/wp-json\/mescio-for-agents\/v1\/context<\/code> \u2014 site metadata + llms.txt in JSON for MCP servers<\/li>\n- Added REST endpoint
\/wp-json\/mescio-for-agents\/v1\/search<\/code> \u2014 full-text search with Markdown output<\/li>\n- Added REST endpoint
\/wp-json\/mescio-for-agents\/v1\/page<\/code> \u2014 page by slug or ID<\/li>\n- Added REST endpoint
\/wp-json\/mescio-for-agents\/v1\/openapi<\/code> \u2014 OpenAPI 3.1 schema<\/li>\n- Added
llms-full.txt<\/code> pagination via ?limit=N&offset=N<\/code> with X-LLMS-Next<\/code> header<\/li>\n- Improved caching: real
Last-Modified<\/code> from content timestamp, ETag<\/code> from body hash, full 304 support<\/li>\n- Fixed excess blank lines in Markdown output from Elementor and other page builders<\/li>\n
- Expanded admin API Examples panel with 8 tabs and copy buttons<\/li>\n<\/ul>\n\n
1.2.0<\/h4>\n\n\n- Added
\/llms.txt<\/code> endpoint \u2014 auto-generated site index in the llmstxt.org standard format<\/li>\n- Added
\/llms-full.txt<\/code> endpoint \u2014 full site content in a single Markdown file for RAG pipelines<\/li>\n- Products in
llms.txt<\/code> grouped by WooCommerce category with price and stock status<\/li>\n- Added
mescio_llms_txt_posts_limit<\/code>, mescio_llms_txt_products_limit<\/code>, mescio_llms_full_txt_limit<\/code> filters<\/li>\n- Added flush rewrite rules on plugin activation\/deactivation<\/li>\n
- Added
\/llms.txt<\/code> and \/llms-full.txt<\/code> clickable links in the settings test panel<\/li>\n<\/ul>\n\n1.1.0<\/h4>\n\n\n- Added multilingual support: WPML, Polylang, TranslatePress and manual configuration<\/li>\n
- Added
Content-Language<\/code> and Link: rel=alternate<\/code> response headers<\/li>\n- Improved HTML to Markdown converter with aggressive page builder noise removal<\/li>\n
- Added UTF-8 and mojibake encoding auto-correction<\/li>\n
- Improved whitespace normalisation<\/li>\n
- Added 27-language selector in admin with flags and native names<\/li>\n
- Added plugin detection badges in settings page<\/li>\n
- Added test panel with ready-to-use curl and Python examples<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial release<\/li>\n
- Content negotiation via
Accept: text\/markdown<\/code> header<\/li>\n- YAML front matter with post metadata<\/li>\n
- WooCommerce product support<\/li>\n
- REST API endpoint
\/wp-json\/mescio-for-agents\/v1\/markdown<\/code><\/li>\nX-Markdown-Tokens<\/code> header with token count estimate<\/li>\nContent-Signal<\/code> header<\/li>\nVary: Accept<\/code> for correct HTTP caching<\/li>\n<\/ul>","raw_excerpt":"Mescio for Agents serves your WordPress content as clean Markdown to AI agents and GPT crawlers. Human visitors never notice a thing.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/284847","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=284847"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/vinsmach"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=284847"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=284847"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=284847"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=284847"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=284847"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=284847"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}