Beta [Olakunlevpn] Agentic Web & WebMCP 1.0.4 (Beta)

Agentic Web & WebMCP
Expose WebMCP tools, llms.txt, ard.json discovery, and clean accessibility for AI browsing agents.

---

Uses
AI agents like Google Gemini, Claude, and Chrome's built-in models are browsing the web autonomously. When they land on a standard XenForo forum, they run into three big walls:

• They have to scrape messy HTML tables and paginate through pages just to find one answer.
• Icon buttons (like search triggers, mobile menu toggles, and reaction bars) lack clear text names in the accessibility tree, leaving agents guessing what to click.
• Dynamic widgets and late-loading banner ads shift the page layout after load, causing agents to mis-click or lose their place.

This add-on turns your XenForo community into an AI-ready destination. It registers native WebMCP tools directly in the browser, publishes structured discovery files, clears out accessibility traps, and keeps your page layout steady under Google Chrome's Agentic Browsing audits.

---

Major Features

WebMCP Browser Integration
WebMCP lets modern AI browsing agents call forum capabilities directly instead of scraping raw HTML. The add-on provides:

• Direct Tool Registration: Exposes four core tools via navigator.modelContext, window.WebMCP, and standard browser events.
• Forum Keyword Search: AI agents can run keyword searches with optional node filtering and custom result limits.
• Thread Reader: Delivers clean, structured message text and author data by thread ID without scraping signatures, ads, or bloated markup.
• Board Hierarchy & Recent Activity: Lets visiting agents pull your public category list and latest discussions in clean JSON.
• Declarative Search Forms: Server-renders toolname and tooldescription attributes on XenForo search forms so agents recognize search inputs immediately.

Automated AI Discovery
Visiting crawlers need an easy way to map what your forum is about. The add-on handles discovery out of the box:

• Dynamic llms.txt and llms-full.txt: Automatically generated Markdown summaries listing your public boards, posting rules, and search endpoints.
• Agentic Resource Discovery (ard.json): Serves a valid ARD v1 manifest at /.well-known/ard.json and /ard.json.
• Robots & Head Autodiscovery: Injects <link rel="llms"> and <link rel="ard"> in the page head, and appends the Agentmap directive to your robots file.
• Automatic Caching: Builds the discovery files in the background on an hourly cron job to keep server load at zero.

Machine-Eye Accessibility (a11y)
Lighthouse agentic browsing audits test how well an AI agent can navigate your accessibility tree. This add-on cleans it up:

• Prohibited ARIA Role Cleanup: Removes invalid roles like role="tabpanel" from <li> tags and moves them to inner containers where they belong.
• Heading Tab Normalization: Fixes heading elements carrying role="tablist", turning them into compliant semantic containers.
• Accessible Control Names: Assigns clear aria-label text to mobile menu buttons, off-canvas toggles, and icon-only links.
• Focusable Guard: Automatically ensures aria-hidden elements (like node icon badges) cannot trap keyboard or agent focus.
• Live Region Notifications: Adds polite live regions to dynamic blocks so agents catch updates without spamming page reloads.

Layout Stability & Anti-CLS Shield
Layout shifts break agent interactions and frustrate human members alike:

• Reserved Ad Heights: Keeps a placeholder space ready for top and sidebar banner ads before their creatives load.
• Reserved Widget Heights: Prevents live statistics blocks from kicking the forum list downward when AJAX threads arrive.
• Zero Third-Party Coupling: Works entirely with standard XenForo templates and pure DOM observation, without modifying third-party add-on files.

---

Complete Feature List

Front-End & Agent Features

• Registers searchForum tool for keyword querying.
• Registers getThread tool for clean thread reading.
• Registers getNodeList tool for category discovery.
• Registers getRecentDiscussions tool for latest posts.
• Declarative metadata on quick search and advanced search forms.
• Real-time DOM mutation observer for dynamically loaded AJAX nodes.
• Built-in CSS layout stabilization for ads and live widgets.
• Lightweight minified JavaScript footprint (under 10 KB).

Admin & Crawler Controls

• Master on/off switch for all agent capabilities.
• Toggle individual WebMCP tools on or off.
• Adjustable per-minute IP rate limit to prevent crawler abuse.
• Customizable site overview prompt for AI visitors.
• Configurable min-height values for banner ads and live widgets.
• Automated hourly background cron for llms.txt generation.