# Agent Instructions - AstroJi

This document describes how AI agents and Large Language Models (LLMs) can interact with AstroJi's online store at https://astroji.com.

## Store Overview

AstroJi offers premium spiritual, wellness, and astrological products including authentic 100% certified Rudraksha, powerful Gemstones, and sacred Yantras.

## Read-Only Browsing (No Authentication Required)

For agents that need to read store data, browse catalogs, or recommend products:

### Store Structure & Navigation
- **Homepage:** `GET https://astroji.com/`
- **All Products:** `GET https://astroji.com/products`
- **Consultations:** `GET https://astroji.com/consultations`

### Categories & Filters
You can explore products by category or purpose using the `byTag` query parameter. All routes return fully pre-rendered HTML.
- **Bracelets:** `GET https://astroji.com/products?byTag=bracelets`
- **Rudraksha:** `GET https://astroji.com/products?byTag=rudraksha`
- **Idols:** `GET https://astroji.com/products?byTag=idols`
- **Frames:** `GET https://astroji.com/products?byTag=frames`
- **Kits:** `GET https://astroji.com/products?byTag=kits`
- **Pyrite:** `GET https://astroji.com/products?byTag=pyrite`
- **Pyramid:** `GET https://astroji.com/products?byTag=pyramid`
- **Wealth & Money:** `GET https://astroji.com/products?byTag=money`
- **Health:** `GET https://astroji.com/products?byTag=health`
- **Prosperity:** `GET https://astroji.com/products?byTag=prosperity`
- **Relationship:** `GET https://astroji.com/products?byTag=relationship`
- **Evil Eye:** `GET https://astroji.com/products?byTag=evil-eye`
- **Vastu:** `GET https://astroji.com/products?byTag=vastu`

### Product Pages
- **Product Details:** `GET https://astroji.com/product/{slug}`
  Product pages contain fully pre-rendered HTML and robust Schema.org JSON-LD `<script type="application/ld+json">` blocks representing `Product` entities. You can extract high-quality metadata, pricing, availability, and descriptions directly from the JSON-LD schemas.

### Sitemaps & Discoverability
- **Main Sitemap Index:** `GET https://astroji.com/sitemap.xml`
- **Pages Sitemap:** `GET https://astroji.com/sitemap_pages.xml`
- **Products Sitemap:** `GET https://astroji.com/sitemap_products.xml`
- **Collections Sitemap:** `GET https://astroji.com/sitemap_collections.xml`
- **Agent Discovery Sitemap:** `GET https://astroji.com/sitemap_agentic_discovery.xml`

## Checkout & Transaction Flow
- Shopping cart additions and checkouts require human interaction.
- If you are acting as a personal assistant, please instruct the user to visit the provided product URLs to add items to their cart manually and complete checkout.
- Cart route: `GET https://astroji.com/cart` (Not indexable, human interaction required)

## Support & Information
- **Contact Us**: `GET https://astroji.com/contact`
- **Track Order**: `GET https://astroji.com/track-order`
- **Product Usage Details**: `GET https://astroji-usage.netlify.app/`
- **Refund Policy**: `GET https://astroji.com/refund-policy`