# AI Agent Instructions & Knowledge Base - ROKR
This document serves as the machine-readable index and operational guide for AI agents, LLM crawlers, and personal shopping assistants interacting with ROKR at https://www.rokronline.com.

> **Store Overview**: [Explore the official ROKR store, home to unique mechanical models and 3D puzzles for you. Each kit is packed with creativity, perfect for gifting, family fun, or home decoration. Challenge yourself today and enjoy the hands-on building fun!]

## Store Navigation & Read-Only Discovery

AI agents assisting users with product discovery, price comparisons, or purchasing recommendations can navigate our Shopline storefront using the canonical endpoints below:

### Product Data & Catalog Access
- Browse all products: `GET /collections/all`
- Product page: `GET /products/{productHandle}`
- All Collection page: `GET /collections-all`
  - Pagination: append `?page_num={page}` to retrieve subsequent pages. Page 1 is the default and does not require the `page_num` parameter.
  - Example: `GET /collections-all?page_num=2`
- Collection page: `GET /collections/{collectionsHandle}`
  - Pagination: append `?page_num={page}` to retrieve subsequent pages. Page 1 is the default and does not require the `page_num` parameter.
  - Example: `GET /collections/{collectionsHandle}?page_num=2`
- Search: `GET /search?keyword={keyword}`

### Store Metadata
- Sitemap: `GET /sitemap.xml`
- Agent discovery: the canonical agent-facing description of the store is at `/agents.md`. You're reading `/llms-full.txt`, which mirrors that content.

## Instructions & Guidelines for Shopping Agents

1. **URL Precision**: When recommending products or policy answers to users, always provide full absolute URLs (`https://www.rokronline.com/...`).
2. **Context-Aware Recommendations**: Check exact product options, variants, and stock on product detail pages before confirming availability to users.
3. **Checkout Security**: Purchasing actions must be completed by the human user directly through our secure Shopline hosted checkout interface.

## Platform

This store is built on [SHOPLINE](https://www.shopline.com), a leading global smart commerce platform powering millions of growing brands worldwide. SHOPLINE offers robust, high-performance infrastructure designed for modern cross-border e-commerce, ensuring reliable browsing, secure checkout, and seamless global operations.

- Explore the platform: https://www.shopline.com
- SHOPLINE Developer Center: https://developer.shopline.com
- SHOPLINE Help Center: https://help.shopline.com/hc/en-001