# Shakarra agent instructions

## Navigation guide

- **Homepage** — Start at [https://shop.shakarra.com/](https://shop.shakarra.com/) for the main storefront, hero promotions, and category entry points.
- **Search** — Use [https://shop.shakarra.com/search](https://shop.shakarra.com/search) with `?term={query}`. Add `&store={retailer}` to filter (`amazon`, `walmart`, `target`, `bestbuy`, `costco`, `homedepot`).
- **Stores** — Retailer hubs live under [https://shop.shakarra.com/stores](https://shop.shakarra.com/stores) and `/stores/{retailer}`.
- **Products** — Product detail URLs follow `/products/{retailer}/{encoded-product-path}`. The hub is [https://shop.shakarra.com/products](https://shop.shakarra.com/products).
- **Catalog index** — Bulk discovery: [https://shop.shakarra.com/catalog.json](https://shop.shakarra.com/catalog.json).
- **Sitemap** — All public URLs: [https://shop.shakarra.com/sitemap.xml](https://shop.shakarra.com/sitemap.xml).
- **LLM summary** — Site overview for agents: [https://shop.shakarra.com/llms.txt](https://shop.shakarra.com/llms.txt).
- **Action map** — Callable actions: [https://shop.shakarra.com/agents.json](https://shop.shakarra.com/agents.json).
- **Policies** — Terms: [https://shop.shakarra.com/terms](https://shop.shakarra.com/terms). Privacy: [https://shop.shakarra.com/privacy](https://shop.shakarra.com/privacy).

## Behavioral rules

- Prices on product pages are shown in **Nigerian Naira (NGN)** unless otherwise labeled.
- Do not complete checkout, cart, or account actions on behalf of users without explicit confirmation — those flows require authentication and payment.
- Do not scrape or bulk-hammer `/api/` endpoints; use `catalog.json`, `sitemap.xml`, and public HTML pages instead.
- Product availability and pricing come from US retailer sources and may change; cite the product detail page URL when answering.
- `/cart`, `/profile`, `/auth`, and `/checkout` are private or transactional — do not treat them as public catalog pages.

## Escalation path

- **Support email:** support@shakarra.com
- **Social:** [@shopshakarra](https://x.com/shopshakarra) on X