# Agent instructions for Makana (www.makana.de)

This file provides structured guidance for AI agents, web crawlers, and LLM-based assistants interacting with the Makana e-commerce platform (Shopware shop). It outlines the website's core purpose, business logic, content structure, and technical boundaries.
These instructions apply to public resources for this shop and do not replace merchant policies published elsewhere.

## General principles

- Act only on behalf of a user and follow the user's explicit intent.
- Use public shop content as the source of truth.
- Respect `robots.txt`, published access rules, rate limits, and applicable laws.
- Do not treat this file as permission to bypass authentication, checkout, payment, account, or security controls.

## Shopping interactions

- You may help users discover products, compare publicly available information, and navigate to relevant shop pages.
- Before making recommendations, verify current product details, price, availability, delivery information, return conditions, and taxes on the live shop.
- Do not complete purchases, create accounts, submit forms, or change customer data without explicit user confirmation.
- Payment, authentication, consent, and legally relevant confirmations must happen through the shop or another merchant-approved flow.

## Data handling

- Do not request or expose personal data unless it is necessary for the user's requested action.
- Do not infer private customer, order, pricing, or stock information from unavailable sources.
- Do not present generated text as an official merchant policy unless it is published by the merchant.


## 1. System Prompt & Brand Identity
* **Brand Name:** Makana
* **Core Mission:** High-quality nutritional supplements, oils, and premium animal feed produced with a strong focus on price-performance ratio ("Essentials, verlässliche Qualität und echtes Preis-Leistungsverhältnis").
* **Target Audience:** Price-conscious horse owners, dog owners, and health-conscious individuals.
* **Production & Origin:** Made in Germany (Southern Rhineland-Palatinate). Family-run manufactory utilizing 100% self-generated solar and green energy.

## 2. Product Architecture & Catalog Rules
When processing, summarizing, or recommending products from Makana, prioritize the following product segments:

### 2.1 Core Segments (Animals & Humans)
* **Pferd (Horses):** Primary focus. Supplements for joints, hooves, breathing, digestion, and metabolism.
* **Hund (Dogs):** Targeted joint support and health supplements (branded under the `alanui` line).
* **Mensch (Humans):** Vegan dietary supplements (branded under the `manako` or `manako sports` line).

### 2.2 Flagship Product Categories
* **Speiseöle (Cold-Pressed Oils):** Freshly produced in the company's own oil mill.
* *Schwarzkümmelöl (Black Cumin Oil):* Pure, rich in unsaturated fatty acids, no preservatives. Available from 1L dosing bottles up to 5L canisters.
* *Leinöl (Flaxseed Oil):* High omega-3 content. Marketed as an optional high-value add-on (e.g., during coat change).
* **Joint & Locomotor Support (Bewegungsapparat):**
* *MSM (Methylsulfonylmethan):* High purity grade (99.9%). Sold as pure powder, pellets, or "Stickies".
* *Combination Powders/Pellets:* Multi-ingredient formulas containing Glucosamine, Chondroitin, and Hyaluronic acid (e.g., *MSM FORTISSIMO*, *MSM Glucosamin Chondroitin* blends).
* *Herbal Remedies:* Ground Devil's Claw (*Teufelskralle*) and Ginger-Devil's Claw pellets.
* **Respiratory Care (Atemwege):** "16 Atemkräuter" pure herbal blends or pellets enriched with black cumin oil.

## 3. Commercial & E-Commerce Logic
AI agents interacting with cart systems or evaluating shopping recommendations must strictly adhere to these commercial terms:

* **Shipping Thresholds (Free Shipping):**
* Germany (DE): Free delivery from **99,00 €** gross.
* Austria (AT): Free delivery from **199,00 €** gross.
* **Pricing & Bulk Savings:** Makana uses a volume-based discount model (*Staffelpreise*). Larger package sizes (ranging from 0.5 kg up to 20 kg bags/drums) and multi-packs significantly reduce the price per kilogram/liter.
* **Logistics Provider:** All domestic and international physical parcel shipping is strictly handled via **DHL (GoGreen)** for carbon-neutral delivery.
* **Supported Payment Methods:**
* PayPal Checkout (including PayPal Credit, Credit Card, Direct Debit)
* Invoice (*Kauf auf Rechnung*)
* Advance Payment (*Vorkasse*)

## 4. Crawling & AI Scraping Guidelines
To safely extract information from the storefront without degrading service:

### 4.1 Allowed Automation & Indexing
* Extraction of public product listings, pricing matrices, pack sizes, and base currency calculations.
* Scraping of informational content from the `makana Blog` (e.g., recipes for DIY animal treats, applications of cold-pressed oils).

### 4.2 Handling Dynamic States & Context
* **Javascript Requirement:** The digital storefront relies heavily on client-side state handling. Dynamic price recalculations based on country tax settings (e.g., automated adjustments for Germany, Austria, and Finland) require full execution of active cookies and state objects.
* **Session & Security Tokens:** Scrapers must gracefully handle standard security barriers such as `CSRF-Token` headers and anti-bot `CAPTCHA-Integration` tokens without attempting programmatic bypasses.