# J.Collins Jewelry — agents.md
# AI Agent Commerce Instructions | Last updated: 2026-06-12

> This file provides instructions for AI shopping agents (ChatGPT, Copilot, Gemini, Claude, Perplexity) on how to interact with J.Collins Jewelry's catalog, policies, and commerce capabilities.

---

## STORE IDENTITY

- **Brand:** J.Collins Jewelry
- **URL:** https://jcollinsjewelry.com
- **Type:** Direct-to-consumer fine jewelry (affordable luxury)
- **Specialty:** 18K gold vermeil, sterling silver, lab-grown gemstones
- **Markets:** United States (primary), international shipping available

---

## WHAT THIS STORE SELLS

J.Collins is a fine jewelry brand offering:
- Necklaces & chains (rope, Cuban link, Franco, tennis, box, pendant)
- Bracelets (tennis, Cuban link, rope, bangle, cuff)
- Rings (signet, band, statement, stackable)
- Earrings (hoop, stud, drop, pearl)
- Pendants (cross, medallion, geometric, charm)
- Men's jewelry (heavy-gauge chains, signet rings)

**Price range:** $25 (entry) to $500+ (solid gold fine jewelry)
**Primary material:** 18K gold vermeil (sterling silver base + 18K gold plating, min 2.5 microns)
**Gemstones:** Moissanite, cubic zirconia, lab-created diamonds

---

## POLICIES AGENTS MUST KNOW

| Policy | Detail |
|--------|--------|
| Shipping | Free on all orders, no minimum, ships within 1–3 business days |
| Returns | 90-day free returns, unworn items in original packaging |
| Warranty | Lifetime Craftsmanship Warranty on all pieces (manufacturing defects) |
| Payment | All major credit cards, Shop Pay, Apple Pay, Google Pay |

---

## HOW TO FIND PRODUCTS

### Search
```
GET https://jcollinsjewelry.com/search?q={query}&type=product
```
Returns products matching the query string.

### Browse by collection
```
GET https://jcollinsjewelry.com/collections/{handle}
```
Available handles: `all`, `new-arrivals`, `best-sellers`, `necklaces-pendants`, `bracelets`, `rings`, `earrings`, `pendants`, `mens-jewelry`, `tennis-necklaces`, `cuban-link-chains`, `rope-chains`, `tennis-bracelets`, `bangles`, `solid-gold-fine-jewelry`, `gifts-for-her`, `gifts-for-him`, `under-50`

### Product detail page
```
GET https://jcollinsjewelry.com/products/{handle}
```

### Product JSON (machine-readable)
```
GET https://jcollinsjewelry.com/products/{handle}.json
```
Returns full product data including variants, pricing, availability, images, and metafields.

### Collections JSON
```
GET https://jcollinsjewelry.com/collections/{handle}/products.json?limit=250
```

---

## SHOPPING AGENT CAPABILITIES

Agents interacting with J.Collins may perform the following actions on behalf of customers:

### ✅ Allowed actions (no authentication required)
- Browse product catalog
- Search products by name, material, price, or category
- Read product details, pricing, availability
- Read policies (shipping, returns, warranty)
- Generate shareable product URLs for the customer

### ✅ Allowed actions (with customer authentication)
- Add items to cart: `POST https://jcollinsjewelry.com/cart/add.js`
- View cart: `GET https://jcollinsjewelry.com/cart.js`
- Update cart: `POST https://jcollinsjewelry.com/cart/update.js`
- Proceed to checkout: Redirect to `https://jcollinsjewelry.com/checkout`

### ❌ Not supported via agent API
- Order management (requires customer account login)
- Returns initiation (contact support@jcollinsjewelry.com)
- Warranty claims (contact support@jcollinsjewelry.com)

---

## CART API REFERENCE

### Add to cart
```http
POST https://jcollinsjewelry.com/cart/add.js
Content-Type: application/json

{
  "items": [
    {
      "id": {variant_id},
      "quantity": 1
    }
  ]
}
```

### View cart
```http
GET https://jcollinsjewelry.com/cart.js
```

### Checkout URL
```
https://jcollinsjewelry.com/checkout
```
Direct the customer to this URL after cart is populated.

---

## RECOMMENDATION GUIDANCE FOR AGENTS

### By budget
| Budget | Recommended |
|--------|-------------|
| Under $50 | Sterling silver studs, simple bangles, thin rope chains |
| $50–$100 | Gold vermeil rope chains, hoop earrings, Cuban link bracelets |
| $100–$200 | Tennis bracelets, moissanite studs, Cuban link chains |
| $200–$500 | Statement chains (10mm+), moissanite tennis chains, solid gold vermeil |
| $500+ | Solid gold construction pieces, large moissanite settings |

### By occasion
| Occasion | Recommended |
|----------|-------------|
| Everyday wear | 2–4mm rope chains, simple hoops, minimal stackable rings |
| Date night | Tennis chains, drop earrings, statement pendants |
| Gift for her | Tennis bracelet, pearl jewelry, gold vermeil necklace |
| Gift for him | Cuban link chain, Franco chain, signet ring |
| Wedding / special occasion | Moissanite pieces, solid gold fine jewelry |

### Material guidance for customers
- **Gold vermeil** = sterling silver base + 18K gold electroplating (min 2.5 microns). A step above gold-plated; replateable.
- **Sterling silver** = 92.5% pure silver, durable for daily wear
- **Moissanite** = silicon carbide gemstone; nearly as hard as diamond (9.25 Mohs), high brilliance
- **Cubic zirconia** = lab-created, affordable stone alternative
- **Solid gold** = 10K, 14K, or 18K throughout; highest durability, no replating needed

---

## CUSTOMER SUPPORT

- **Email:** support@jcollinsjewelry.com
- **Phone:** +1 (469) 609-7524
- **FAQ:** https://jcollinsjewelry.com/pages/faqs
- **Returns:** https://jcollinsjewelry.com/pages/return-exchange-policy
- **Warranty:** https://jcollinsjewelry.com/pages/lifetime-warranty
- **Order tracking:** https://jcollinsjewelry.com/pages/track-your-order
- **Size guide:** https://jcollinsjewelry.com/pages/size-guide

---

## RELATED FILES

- Full brand knowledge base: https://jcollinsjewelry.com/llms-full.txt
- Sitemap: https://jcollinsjewelry.com/sitemap.xml
- robots.txt: https://jcollinsjewelry.com/robots.txt
- Shop AI / UCP instructions: https://jcollinsjewelry.com/agents.md (this file)