UCP Score for commerciovirtuoso.it
91 out of 100, grade A: ready for UCP agents. The missing 9 points are spread across Conformance and Capabilities. One spec break on the status page isn't counted in the score.
Discovery 100Conformance 97Capabilities 75release 2026-04-08
"ucp": {
"version": "2026-08-25",
...
},
"keys": [ ... ] // beside "ucp", not inside it
Set the version to 2026-08-25 and publish your public keys as a root-level "keys" list. The older "signing_keys" field is still accepted, but "keys" is the one every verifier reads.
HTTPS, UCP profile reachable, AI bot access, llms.txt, sitemap.xml, Open Graph tags, Organization schema (JSON-LD), Mobile viewport metaShow
- HTTPS · Profile URL uses https://
- UCP profile reachable · HTTP 200
- AI bot access · robots.txt allows /.well-known/ucp
- llms.txt · Found at /llms.txt
- sitemap.xml · Found at /sitemap.xml
- Open Graph tags · og:title and og:type/url present
- Organization schema (JSON-LD) · Organization-typed JSON-LD detected
- Mobile viewport meta · <meta name="viewport"> present
Profile passes schema validation, Protocol version present and well-formed, Public keys published, Spec & schema URLs resolve (10)Show
- Profile passes schema validation · No structural errors
- Protocol version present and well-formed · Version: 2026-04-08
- Public keys published · Keys published at the top level
- Spec & schema URLs resolve (10) · All 10 URLs resolved.
Capabilities declared, Checkout capability, Transports declaredShow
- Capabilities declared · 3 of 6 capability families detected: Checkout, Order Management, Catalog. A family counts once however many namespaces or extensions declare it.
- Checkout capability · dev.ucp.shopping.checkout detected
- Transports declared · REST
The score measures what the profile declares across the three areas above. These break a rule in the spec that agents follow, so they can stop an agent before the score matters.
Files commerciovirtuoso.it publishes for agents beyond its UCP profile, from our weekly look. Only what we found is listed.
/agents.md/agents.md as served 3.5 KB
# Agent Instructions — commercioVirtuoso.it
This document describes how AI agents can interact with commercioVirtuoso.it, an Italian multi-vendor marketplace at https://commerciovirtuoso.it.
## What makes this store different
Products are sold by **independent vendors**. A single order is split into per-vendor groups, each with its own shipment, tracking number and delivery estimate. An agent that assumes one shipment per order will misreport delivery dates to the buyer.
Every product carries a **CVIN**: a 9-digit public identifier, shown on the product page and stable for the life of the product. Use it — not the slug — when referring a product to a human (support, order issues) or storing a reference. Slugs change; the CVIN never does.
## Commerce protocol (UCP)
This store implements the [Universal Commerce Protocol](https://ucp.dev).
- **Discovery** — `GET https://commerciovirtuoso.it/.well-known/ucp` returns the business profile: supported version, service endpoints, capabilities and the Ed25519 signing keys. It is the single source of truth; do not hardcode what you read here.
- **API base** — the profile's `services["dev.ucp.shopping"][].endpoint`. Requests are REST + JSON.
### Typical flow
1. **Discover** — `GET /.well-known/ucp`
2. **Search** — `POST <base>/catalog/search` (also `catalog/lookup`, `catalog/product`)
3. **Checkout** — `POST <base>/checkout-sessions`, then `GET <base>/checkout-sessions/{id}`
4. **Complete** — `POST <base>/checkout-sessions/{id}/complete`
### Rules that will bite you
- **Checkout completion is not programmatic.** We publish no payment handler (`payment_handlers` is empty by design, pending Stripe SPT general availability in the EU). `complete` answers `escalation_required` with a `continue_url`: send the buyer there to pay on our checkout. Never assume a payment succeeded because `complete` returned HTTP 200.
- **Payment always requires the buyer.** No agent may complete a payment without contemporaneous human approval.
- **Requests are signed.** Checkout calls must carry an RFC 9421 signature and a `UCP-Agent` header pointing at your own `/.well-known/ucp` profile, whose signing keys we fetch to verify you.
- **Respect rate limits.** Back off on 429.
## Read-only browsing (no authentication)
- Sitemap index: `GET https://commerciovirtuoso.it/sitemap.xml` — the entry point to every indexable URL.
- Product page: `GET https://commerciovirtuoso.it/products/{slug}`
- Collection page: `GET https://commerciovirtuoso.it/collections/{slug}`
- Brand directory: `GET https://commerciovirtuoso.it/brands`
- Machine-readable site summary: `GET https://commerciovirtuoso.it/llms.txt`
There is no public product JSON endpoint. To read catalog data programmatically, use the UCP catalog capability rather than scraping the storefront.
Do not crawl `/search`, `/cart`, `/checkout`, `/account` or `/wishlist`: they are disallowed in `https://commerciovirtuoso.it/robots.txt`.
## Store policies
- [Terms of service](https://commerciovirtuoso.it/legal/terms-of-service)
- [Privacy policy](https://commerciovirtuoso.it/legal/privacy-policy)
- [Refund policy](https://commerciovirtuoso.it/legal/refund-policy)
- [Return policy](https://commerciovirtuoso.it/legal/return-policy)
- [Shipping policy](https://commerciovirtuoso.it/legal/shipping-policy)
- [Warranty policy](https://commerciovirtuoso.it/legal/warranty-policy)
- [Ranking parameters](https://commerciovirtuoso.it/legal/ranking-parameters) — how search results are ordered (EU P2B disclosure).
