--- name: mcp-web-metadata-auditor description: > Audit, implement, and fix web page metadata including titles, descriptions, canonical URLs, robots directives, Open Graph and Twitter cards, favicons, manifests, JSON-LD, locale alternates, and route-level metadata defaults. Use when shipping searchable or shareable pages, fixing social previews, investigating duplicate or stale head tags, reviewing indexing intent, or building metadata components across modern and legacy stacks. Keep changes scoped to metadata, preserve the project's existing framework pattern, and use mcp-ui-internationalization for broader locale architecture. --- # MCP Web Metadata Auditor Garantire metadata coerenti, deterministici e verificabili senza trasformare un intervento sul `` in un refactor del frontend. ## Workflow 1. Identificare route pubbliche, private, duplicate, localizzate, preview ed error pages. 2. Eseguire `scripts/mcp-web-metadata-auditor/inspect_metadata.py ` come inventario statico iniziale. 3. Individuare il singolo owner dei metadata per ogni route o template. 4. Correggere prima duplicati, canonical e indexing intent. 5. Allineare title, description, canonical, `og:url`, locale e social image. 6. Validare JSON-LD contro contenuto realmente visibile. 7. Verificare output server, transizioni client, URL assoluti e ambienti non production. 8. Aggiungere test di regressione per tag critici e duplicazioni. ## Regole permanenti - Non emettere due sistemi concorrenti di metadata sulla stessa pagina. - Non inventare rating, prezzi, recensioni o attributi strutturati. - Non usare `noindex` per nascondere problemi di canonicalizzazione. - Sanitizzare i valori dinamici e costruire URL assoluti da configurazione affidabile. - Non migrare librerie o framework SEO salvo richiesta esplicita. - Verificare social preview su un URL raggiungibile, non soltanto su localhost. ## Output 1. route/template inventory 2. critical duplication and indexing findings 3. metadata contract per page type 4. patch minima 5. social and structured-data checks 6. regression tests and residual risks ## References - [metadata-rules](references/metadata-rules.md) - [framework-adapters](references/framework-adapters.md) - [validation-and-regression](references/validation-and-regression.md)