AI Shop Profile – llms.txt Business Card

About the Extension

Help AI Crawlers Understand Your Shop

As search behavior evolves, AI agents, large language models (LLMs), and automated assistants are regularly scanning your digital storefront. Sitemaps and product feeds remain important, but they are not designed to provide a concise contextual overview of your shop for AI systems.

The AI Shop Profile (`llms.txt`) plugin bridges this gap seamlessly. It acts as an automated business card and ultra-dense navigation map for artificial intelligence systems. By serving a lightweight, machine-readable Markdown map at your shop's `/llms.txt` path, you give AI crawlers a concise public overview that can help them understand your shop structure, service pages, available languages, currencies, and selected highlights.

High-Conversion Feature Highlights

* Native Shopware Cache Integration: Built with performance in mind. The endpoint integrates with the Shopware HTTP Cache and uses targeted invalidation for relevant shop structure, sales-channel, language, currency, and configuration changes. In normal operation, requests to `/llms.txt` are lightweight compared to rendering full storefront pages.

* The "Fail-Safe" Promotion Engine: Run time-sensitive events confidently. The built-in protection system demands a strict expiry date for discount or event text entries. The moment your promotional period passes, the content is instantly hidden from the frontend to eliminate outdated search data hallucinated by AI systems.

* Smart Assortment Compression: Rather than overloading crawls with millions of product combinations, the plugin maps top-level catalog trees down to a user-defined category depth. It strips heavy HTML clutter into normalized, plain text, optimizing token efficiency.

* Automated Bestselling Highlights: Give AI crawlers immediate access to what sells best. The core repository aggregator selectively generates mini-profiles for your top items—including name, direct link, and brand name matching.

* Multi-Tenant & Multi-Language Aware: Completely sales-channel isolated. It automatically resolves base context language and accepted currency tables for international domains, generating native SEO-friendly routing handles relative to the visiting context.

Technical Guardrails (Building Trust with Developers)

To ensure agencies feel safe installing our plugin on enterprise environments, we explicitly spell out its structural boundaries:

* No Hidden Prompts: Completely honest layout structure—no prompt injection tactics or crawler manipulation.

* Total Data Protection: Exposes public, storefront-facing URLs and basic metadata only. Zero risk of leaking secrets, checkout parameters, or customer database schemas.

* Zero Index Bloat: The endpoint forces an `X-Robots-Tag: noindex` header natively to avoid cluttering human-facing Google/Bing SERPs while still cleanly guiding machine scrapers.

Merchant Setup Guide (How it looks in Admin)

1. Activate the Module: Toggle the central control flag to instantly build or remove your public map.

2. Set Depth Limits: Restrict category maps between 1 to 5 tiers deep to fit small or massive enterprise trees gracefully.

3. Add Manual Guidance: Use custom free-text blocks to inform AI crawlers about stable details like support response windows, shipping focus areas, or distinct shop values.

4. Set an Expiry Trigger: Drop in seasonal promotions or current coupon values safely backed by a safety timestamp window.

---

* This plugin generates a static, cacheable Markdown file. It does not modify your database or override core Shopware behavior.

* Bestseller entries are only generated when your Shopware installation already has real product sales data and a valid highlight expiry date is active.