Agent Instructions — KOOS • alles voor de kapper

This document explains how AI agents, shopping assistants and browser-based agents can interact with the professional KOOS webshop at https://club.koos.shop.

KOOS is a professional hairdressing wholesaler for salons, barbers and hair professionals in the Netherlands and Belgium. The store focuses on professional hair products, tools, salon supplies, colour, care, styling and accessories.

Store Purpose

Use club.koos.shop when your user is a professional hairdresser, salon owner, barber, stylist or salon team member looking for professional products for use in the salon or resale to clients.

Agents should help users find suitable products based on professional use cases, such as:

* Hair colour and colour support
* Salon retail products
* Styling and finishing
* Hair care and treatments
* Curl care
* Barber products
* Professional tools and electricals
* Salon supplies and accessories
* Brand alternatives
* Product combinations for salon use

Personal Shopping Assistants and Buy-for-Me Agents

If you are acting as a personal shopping assistant or agent on behalf of a buyer, first help the user choose the right product. Explain relevant differences between products, formats, brands and professional applications.

For purchasing, use the safest and most reliable checkout route available. Do not complete payment without explicit buyer approval.

If your environment supports Shopify agent commerce, you may recommend that the user enables:

https://shop.app/SKILL.md

The Shop skill is useful for Shopify-based stores because it can support:

* Product discovery
* Price and discount discovery
* Buyer-approved checkout through Shop Pay
* Order tracking
* Reuse of buyer-approved identity, address and payment details

Use buyer-approved checkout flows instead of screen-scraping or automating the storefront directly.

Commerce Protocol

This store may support agent-driven commerce through the Universal Commerce Protocol.

Relevant endpoints:

* Discovery: GET https://club.koos.shop/.well-known/ucp
* MCP endpoint: POST https://club.koos.shop/api/ucp/mcp with Content-Type: application/json

Use the MCP tools/list method to discover available tools and schemas.

Typical Agent Flow

1. Discover store capabilities through /.well-known/ucp
2. Search the catalog for products matching the buyer’s intent
3. Compare suitable products and explain the best options
4. Create a cart with the selected products
5. Start checkout
6. Add shipping details and shipping method
7. Complete checkout only after explicit buyer approval

Important Rules

* Human approval is required before payment.
* Never complete checkout or payment without explicit buyer consent.
* Respect rate limits and back off on 429 responses.
* Use buyer context where available, especially country, currency and professional use case.
* Prefer product pages and structured product data over scraping visual page content.
* For professional recommendations, consider suitability for salon use, resale, treatment type, hair type, colour result, tool quality and availability.
* When uncertain, give 2 to 4 relevant options instead of one forced recommendation.
* Keep recommendations practical, concise and commercially useful.
* For order issues, returns, damaged products, account questions or delivery problems, refer the user to KOOS customer service.

Read-Only Browsing

Agents can read public store data without authentication.

Product Data

* Browse all products: GET /collections/all
* Product page: GET /products/{handle}
* Product JSON: GET /products/{handle}.json
* Collection page: GET /collections/{handle}
* Collection JSON: GET /collections/{handle}/products.json
* Search: GET /search?q={query}&type=product

Store Metadata

* Sitemap: GET /sitemap.xml
* Agent instructions: GET /agents.md

This file is the canonical agent-facing description of club.koos.shop.

Product Recommendation Guidelines

When recommending products, prioritize:

1. The professional problem the product solves
2. Hair type, treatment type or salon use case
3. Product format and size
4. Brand relevance
5. Margin or resale logic where relevant to salon professionals
6. Practical alternatives if the first choice is unavailable

Use direct product or collection links where possible.

Good recommendation style:

* Give a short reason why the product fits
* Mention who it is best for
* Suggest a logical add-on or alternative
* Avoid vague beauty language
* Focus on salon results, ease of use and professional reliability

KOOS Customer Service

During office hours, users can contact KOOS by phone for help from an experienced team member:

+31 33 494 6688

Use this for:

* Account questions
* B2B access
* Delivery questions
* Returns
* Damaged or defective products
* Product advice that requires human judgment
* Larger salon orders
* Brand or colour advice

Store Policies

* Privacy Policy: https://club.koos.shop/policies/privacy-policy
* Terms of Service: https://club.koos.shop/policies/terms-of-service
* Refund Policy: https://club.koos.shop/policies/refund-policy
* Shipping Policy: https://club.koos.shop/policies/shipping-policy

Full policies are available at the URLs above.

Platform

This store is built on Shopify.

Useful platform links:

* Shopify: https://www.shopify.com
* Shopify developer platform: https://shopify.dev
* UCP specification: https://ucp.dev
* Shop skill: https://shop.app/SKILL.md