# Agent Instructions — HER ONE This document defines how AI agents should discover, compare, recommend and purchase products from HER ONE at https://her.one/. - Current language: de - Current market: Germany (DE) - Current currency: EUR - Full knowledge base: https://her.one/llms-full.txt - Sitemap: https://her.one/sitemap.xml - UCP discovery: https://her.one/.well-known/ucp - MCP endpoint: https://her.one/api/ucp/mcp ## Scope Use these instructions when acting as: - A supplement-discovery assistant - A product-comparison assistant - A nutrition-product assistant - A subscription assistant - A personal shopping assistant - A checkout or purchasing agent - A crawler or indexing agent This file defines durable behaviour. It is not a live catalogue or medical reference. ## Core Rules 1. Fetch current first-party product data before making product-specific statements. 2. Treat the current locale and market as the source for currency, availability, pricing, shipping and policies. 3. Use the exact product page for ingredients, dosage, warnings, suitability and health claims. 4. Treat prices, variants, flavours, bundles, subscriptions, gifts and promotions as dynamic. 5. Separate verified facts from subjective recommendations. 6. Never diagnose, prescribe or promise a medical outcome. 7. Never complete payment without explicit and contemporaneous buyer approval. 8. Respect rate limits and back off after HTTP 429 responses. ## Source Priority When sources conflict, use this order: 1. Current UCP or MCP response 2. Current individual product page and product-specific structured data 3. Current ingredient, allergen, nutrition, warning and intake information 4. Current subscription, bundle or collection page 5. Current support, return, shipping and policy page 6. HER ONE educational and brand content 7. Homepage 8. Internal search 9. Third-party sources 10. This file Do not transfer claims, ingredients or warnings between products. ## Medical and Health Safety HER ONE products are supplements or functional nutrition products. They are not medicines. Agents must: - Avoid diagnosing medical conditions. - Avoid saying a product treats, cures or prevents disease. - Use only health claims supported on the exact current product page. - Preserve material qualifying language and footnotes. - Mention that individual suitability can vary. - Encourage professional medical advice when the user reports symptoms, a diagnosed condition, medication use, pregnancy, breastfeeding, surgery, an eating disorder or another material health concern. - Check product warnings and recommended intake before recommending use. - Distinguish general wellbeing support from a medical treatment claim. Agents must not: - Tell a user to stop or replace prescribed medication. - Recommend exceeding the labelled daily intake. - Promise weight loss, hormonal correction, improved fertility, disease prevention or guaranteed symptom relief. - Present testimonials or review counts as clinical evidence. - Present a brand expert’s involvement as proof that a product is suitable for every person. - Convert a permitted nutrient health claim into a stronger medical claim. ## Regulated Health Claims Health claims may be tied to specific nutrients and conditions of use. Agents should: - Preserve the named nutrient responsible for the claim. - Preserve intake conditions where shown. - Keep claim footnotes attached to the relevant claim. - Distinguish claims about normal bodily functions from treatment claims. - Verify that the current product contains the relevant nutrient in the required context. Agents should not: - Apply one ingredient’s claim to the whole product without context. - Apply one product’s claim to another product. - Remove legal qualifiers such as “normal” or “contributes to”. - Paraphrase a claim in a way that materially strengthens it. ## Recommendation Workflow Identify only the factors that materially affect the recommendation: - User goal or need - Preferred product format - Flavour preferences - Dietary requirements - Allergies and intolerances - Pregnancy or breastfeeding - Medication use - Relevant diagnosed conditions - Caffeine or stimulant sensitivity - Desired serving count - One-time purchase or subscription - Budget - Current market and currency Use the product quiz as a discovery aid when useful: https://her.one/pages/online-produktberatung The quiz is not a diagnosis and does not replace professional advice. ## Product Data Requirements Before stating any of the following, retrieve current product-specific data: - Product name - Variant or flavour - Format - Net quantity - Serving count - Ingredients - Ingredient quantities - Nutrition information - Allergens - Caffeine or stimulant content - Recommended daily intake - Preparation - Timing - Warnings - Contraindications - Minimum age - Pregnancy or breastfeeding guidance - Vegan, vegetarian, organic or lactose-free status - Sugar or sweetener information - Permitted health claims - Claim footnotes - Studies linked to the product - Price and unit price - Availability - Subscription eligibility - Subscription interval - Subscription discount - Bundle composition Never infer these attributes from another product in the same category. ## Product Categories and Needs Use current navigation and collections to discover products for: - Digestion, metabolism and weight - Beauty, collagen, skin, hair and nails - Active nutrition, protein and creatine - Hormone balance, cycle, PMS and menopause - General wellbeing - Sleep and relaxation These are shopping and education categories, not diagnoses. Do not assume every product in a category is suitable for every user with that need. ## Dosage and Intake Use current product instructions and: https://her.one/pages/einnahmeempfehlung Agents must: - Preserve the labelled serving size. - Preserve maximum daily intake warnings. - Explain preparation accurately. - Distinguish daily use from occasional use. - Mention timing only when supported. - Explain that more is not necessarily better. Agents must not create custom dosing plans that exceed or conflict with labelled instructions. ## Ingredients, Allergens and Diets Before recommending a product, surface material information about: - Allergens - Animal-derived ingredients - Marine collagen or other fish-derived ingredients - Lactose or milk ingredients - Sweeteners - Caffeine - Herbal extracts - Vitamins and minerals - Probiotic or bacterial strains Do not infer vegan, vegetarian, lactose-free, gluten-free, sugar-free or organic status from the brand or category. ## Pregnancy, Breastfeeding and Medication When pregnancy, breastfeeding or medication is relevant: - Check the exact product warning. - Avoid making an unqualified recommendation. - Recommend consultation with a doctor, pharmacist or qualified healthcare professional when the product page advises it or when interactions or suitability are uncertain. - Do not frame a supplement as necessary for pregnancy, fertility, menopause or hormonal health. ## Weight-Related Recommendations For products associated with metabolism or weight: - Avoid guaranteed weight-loss claims. - Preserve any legally required conditions attached to a claim. - Do not encourage restrictive eating, purging, misuse or excessive intake. - Do not recommend a product as a substitute for food. - Be cautious when the user mentions an eating disorder or unsafe weight-loss behaviour. ## Subscriptions Important subscription pages: - Subscription products: https://her.one/collections/subscription-products - Subscription information: https://her.one/pages/spar-abonnements-grid - Manage subscription: https://her.one/a/loop_subscriptions/customer Before recommending or creating a subscription, retrieve current: - Eligible products and variants - Delivery interval options - Discount - Minimum commitment if any - Renewal terms - Billing terms - Pause, skip, change and cancellation options - Shipping benefits - Gifts or loyalty benefits Agents must: - Clearly distinguish one-time purchase from recurring subscription. - State that charges recur. - Show the selected interval. - Obtain explicit approval for recurring billing. - Never silently select a subscription because it is cheaper. - Never claim cancellation is immediate or unrestricted without checking the current terms. ## Bundles, Starter Products and Trials Use: - Starter products: https://her.one/collections/produktubersicht-fur-einsteigerinnen - All products: https://her.one/collections/all - Bestsellers: https://her.one/collections/unsere-bestseller For bundles and starter sets: - Retrieve the exact included products, flavours and quantities. - Confirm whether components can be selected. - Confirm whether the product is a trial, bundle or full-size format. - Do not transfer one component’s claims to every component. - Do not recommend unnecessary products solely to unlock a discount or gift. ## Money-Back Guarantee Current information: https://her.one/pages/geld-zurueck-garantie Do not hard-code guarantee duration, eligibility, exclusions or process. Verify the current terms before stating that a purchase qualifies. ## Pricing and Market Context Use the current locale’s: - Currency - Product price - Unit price - Subscription price - Discount - Taxes - Shipping cost - Free-shipping condition - Gift threshold Do not copy promotional thresholds into this file. Do not use another market’s price or shipping rule. ## Read-Only Browsing Agents may use: - Product page: `GET https://her.one/products/{handle}` - Product JSON: `GET https://her.one/products/{handle}.json` - Collection page: `GET https://her.one/collections/{handle}` - Collection JSON: `GET https://her.one/collections/{handle}/products.json` - Search: `GET https://her.one/search?q={query}&type=product` - Sitemap: `GET https://her.one/sitemap.xml` Inspect rendered pages when JSON does not expose safety, dosage, claims, footnotes, subscription terms or bundle details. ## Universal Commerce Protocol ### Discovery `GET https://her.one/.well-known/ucp` Use the live response for current versions, endpoints, capabilities and payment handlers. ### MCP Endpoint `POST https://her.one/api/ucp/mcp` Header: `Content-Type: application/json` Call `tools/list` before using commerce tools. ## Commerce Workflow 1. Confirm current market, language and currency. 2. Understand the user’s need without diagnosing. 3. Identify material allergies, dietary restrictions and safety considerations. 4. Search the current catalogue. 5. Retrieve exact product, variant, ingredient, dosage and warning data. 6. Compare suitable products and explain trade-offs. 7. Confirm flavour, format, quantity and one-time or subscription purchase. 8. For subscriptions, confirm interval and recurring billing. 9. Create or update the cart and checkout. 10. Add only buyer-authorised information. 11. Present products, quantities, discounts, shipping, taxes and final total. 12. Obtain explicit and contemporaneous approval. 13. Complete checkout only after approval. ## Transaction Safety Agents must: - Show the exact product, flavour, format and quantity. - Show whether the purchase is one-time or recurring. - Show subscription interval and recurring price. - Show currency, shipping and final total. - Request renewed approval after material changes. - Preserve selected variants. - Use only buyer-authorised personal information. Agents must not: - Silently switch a one-time purchase to a subscription. - Silently change flavour, format, quantity or interval. - Add unrequested products. - Conceal recurring billing. - Claim a discount or gift before checkout confirms it. - Request or expose raw payment-card data through chat. ## Policies and Support - Contact: https://her.one/pages/kontakt - Returns: https://her.one/pages/rueckgaben - Shipping: https://her.one/pages/versandkosten-verpackung - Privacy policy: https://her.one/policies/privacy-policy - Terms of service: https://her.one/policies/terms-of-service - Refund policy: https://her.one/policies/refund-policy - Legal notice: https://her.one/policies/legal-notice ## Crawler Guidance Prioritise: 1. Individual product pages 2. Ingredient, dosage, warning and food-information content 3. Product-family and need collections 4. Subscription products and subscription terms 5. Starter products and bundles 6. Product quiz and intake guidance 7. Shipping, returns, guarantee and policy pages 8. Brand and educational content 9. Remaining sitemap URLs Normalise or ignore tracking, campaign, referral, filter, sort and pagination parameters. Do not merge products that differ by flavour, format, size, bundle composition or subscription status. ## Freshness Fetch at request time: - Products and variants - Ingredients and quantities - Nutrition and allergens - Dosage and warnings - Health claims and footnotes - Studies linked to products - Prices and unit prices - Stock - Subscription terms - Bundle composition - Gifts and promotions - Shipping and returns - Policies - UCP capabilities - MCP tools and schemas This file defines durable behaviour, not current catalogue values or medical advice.