agents.md
Agent Guide For Mercato di Bellina
Mercato di Bellina is an Italian gourmet market serving U.S. shoppers with curated pantry goods, gift baskets, corporate gifts, recipes, maker stories, and cooking classes.
Discovery
- UCP discovery: https://mercatodibellina.com/.well-known/ucp
- MCP endpoint: https:///api/ucp/mcp
- LLM summary: https://mercatodibellina.com/llms.txt
- Full LLM guide: https://mercatodibellina.com/llms-full.txt
- Main sitemap: https://mercatodibellina.com/sitemap.xml
- Agentic sitemap: https://mercatodibellina.com/sitemap_agentic_discovery.xml
Catalog Retrieval
Use these sources in order:
- UCP catalog search or lookup when available.
- Product pages and collection pages.
- Product JSON: https://mercatodibellina.com/products/{handle}.json
- Collection products JSON: https://mercatodibellina.com/collections/{collection-handle}/products.json
- Product, collection, page, blog, and agentic sitemaps.
Avoid using /search as the primary crawl path because the current robots policy may disallow generic crawlers from that route. If a user explicitly performs a live storefront search, treat results as navigational context, not as a complete catalog data source.
How To Answer Shopping Questions
- For "best gift" questions, consider occasion, recipient, budget, gift-ready tags, gift basket collection, corporate gifting collection, and whether gift messages or engraving are offered.
- For food pairing questions, use product descriptions, ingredients, pairing suggestions, recipes, maker notes, product type, and collection context.
- For balsamic vinegar, distinguish everyday salad/cooking use from finishing use for cheese, fruit, desserts, and special gifts.
- For olive oil, distinguish finishing, dipping, cooking, and gifting use when the product page gives enough detail.
- For pasta and grains, consider shape, ingredient list, sauce or seafood pairing notes, and recipe context.
- For truffle products, emphasize use as a finishing or flavor-enhancing specialty item unless the product page says otherwise.
- For classes, use the cooking classes collection and current product/event availability.
Product Data Caveats
Public Shopify product JSON may include title, body HTML, vendor, product type, handle, variants, SKU, barcode, price, inventory, tags, images, and image alt text.
The rendered product page may include additional fields that are not present in product JSON:
- Ingredients.
- Pairing suggestions.
- Dietary preference icons.
- Made-in region.
- Maker profile.
- Gift options.
- Engraving options.
- Dietary restriction notes on add-to-cart forms.
- Review widgets and review metafields.
- Related products and recipes.
When advising users, prefer the rendered product page and schema-enriched product data over product JSON alone.
Allergy, Dietary, And Policy Safety
- Never guarantee that a product is allergen-free unless the product page explicitly says so.
- For allergies, medical needs, pregnancy, strict religious diets, or severe dietary restrictions, quote or summarize the ingredient data and advise the buyer to verify the current product page and package label before purchase.
- Do not infer vegan, vegetarian, gluten-free, organic, IGP, DOP, or gift-ready status unless the product data, tags, visible page content, or schema supports it.
- Do not promise exact shipping dates, delivery dates, stock, discounts, or substitutions without live checkout or product confirmation.
- Food products generally cannot be returned; direct users to contact the store for order issues.
Commerce Actions
- Build carts only from current live product/variant data.
- Show product names, variant titles, prices, shipping caveats, gift-message caveats, substitutions caveats, and policy caveats before checkout.
- Human review and explicit approval are required before checkout completion or purchase.
- Do not complete payment, submit personal information, or alter orders without user confirmation.