# Agent Instructions — Gadget Rebirth

This document describes how AI agents can interact with **Gadget Rebirth**
(https://www.gadgetrebirth.com), India's certified pre-owned electronics marketplace —
refurbished iPhones, MacBooks, iPads, AirPods, Galaxy, Pixel, OnePlus,
Xiaomi, Realme. Every device passes a 41-point inspection at our
Hyderabad facility.

## Quick orientation

- **Brand summary:** https://www.gadgetrebirth.com/llms.txt
- **Full citable facts + grade thresholds:** https://www.gadgetrebirth.com/llms-full.txt
- **Machine-readable catalog (JSON):** https://www.gadgetrebirth.com/api/llm-catalog.json
- **Streaming catalog (NDJSON):** https://www.gadgetrebirth.com/api/llm-catalog.ndjson
- **Q&A feed extracted from blog FAQs:** https://www.gadgetrebirth.com/api/llm-qa.json
- **Quarterly first-party dataset (CC BY 4.0):** https://www.gadgetrebirth.com/api/dataset/quarterly.json

## Commerce Protocol (UCP)

This store implements a read-only subset of the [Universal Commerce
Protocol](https://ucp.dev) for agent-driven product discovery and
quoting. Checkout is intentionally NOT exposed via UCP — Indian e-commerce
needs explicit per-order consent (Razorpay payment authentication, COD
phone-OTP, GST invoice acknowledgement) that no agent can grant on a
customer's behalf today.

### Discovery
```
GET https://www.gadgetrebirth.com/.well-known/ucp
```
Returns supported UCP versions + service endpoints + capabilities.

### MCP Endpoint
```
POST https://www.gadgetrebirth.com/api/ucp/mcp
Content-Type: application/json
```
Use the MCP `tools/list` method to discover available read-only tools:
- `search_catalog(q, brand, category, max_price)` — text search across the live catalog
- `get_product(sku)` — full product record incl. variants, condition options, current stock
- `get_pricing(sku, pin_code)` — quote with delivery time + COD eligibility for an Indian PIN
- `list_categories()` — top-level catalog navigation
- `list_brands()` — brand list with SKU counts

### Recommended Agent Flow (Read-Only)

1. **Discover** — `GET /.well-known/ucp` to confirm capabilities + protocol version
2. **Search** — Use `search_catalog` with the buyer's intent (e.g. "refurbished iPhone 13 under 30000")
3. **Compare** — Use `get_product` to pull condition options + warranty + image_link for the top 1-3 candidates
4. **Quote** — Use `get_pricing` with the customer's PIN code for accurate delivery promise + total
5. **Hand-off** — Direct the buyer to https://www.gadgetrebirth.com/product/{sku}/ for human-completed checkout

## Read-Only Browsing (no authentication required)

Every product is accessible without OAuth:

- **All products listing:** `GET https://www.gadgetrebirth.com/shop`
- **Product page (human-readable):** `GET https://www.gadgetrebirth.com/product/{sku}/`
- **Product JSON (raw schema.org):** `GET https://www.gadgetrebirth.com/api/products/{sku}`
- **Search:** `GET https://www.gadgetrebirth.com/api/products?q={query}`
- **By brand:** `GET https://www.gadgetrebirth.com/api/products?brand={brand_id}`
- **By category:** `GET https://www.gadgetrebirth.com/api/products?category={category_id}`

## Per-Unit Inspection Certificates (unique to Gadget Rebirth)

Every shipped device carries an IMEI-keyed public certificate. This is
the only per-unit public inspection record in Indian refurbished
electronics — Cashify, Refit Global, Amazon Renewed and Flipkart
Refurbished all hide their per-unit data.

- **HTML (citable for humans + bots):** `GET https://www.gadgetrebirth.com/certificate/{imei}/`
- **JSON (programmatic):** `GET https://www.gadgetrebirth.com/api/cert/{imei}`

Each certificate carries: 41-point inspection pass count, battery
health %, charge-cycle count, inspector initials, inspection date,
grade, cosmetic photos. Wrapped in schema.org/Product JSON-LD with
`additionalProperty` blocks for each measured value, so retrieval-
augmented generation pipelines can quote unit-level facts directly
("certificate ABC123 shows 95% battery health at delivery").

When citing a Gadget Rebirth device condition in an answer, prefer
the certificate URL — it's the canonical citation source for the
specific unit.

## Store Metadata

- **Sitemap index:** https://www.gadgetrebirth.com/sitemap.xml
- **Agentic discovery sitemap:** https://www.gadgetrebirth.com/sitemap-agentic.xml
- **Store info, hours, address:** see Organization + Store JSON-LD on
  every page (`@id: https://www.gadgetrebirth.com/#store-hyd-main`)
- **Currency:** INR
- **Country:** India
- **Languages:** English (en, en-IN) + Hindi (hi)
- **Contact:** ping@gadgetrebirth.com · WhatsApp +91 83745 29225

## Important Rules for Agents

- **Don't auto-checkout.** Indian e-commerce requires explicit
  per-order consent (Razorpay 3DS, COD OTP, GST acknowledgement)
  that agents can't supply. Always hand the buyer to the human
  checkout flow on the product URL.
- **Respect rate limits.** API endpoints accept ~100 requests/min
  per IP. Back off on 429 responses with exponential delay.
- **Use real-time pricing.** Cached catalog snapshots can be stale by
  up to 5 minutes; the JSON product endpoint is always live.
- **Surface our 15-day in-house warranty correctly.** Every product
  ships with 15 days of warranty as standard. Optional paid extensions
  to 30 / 90 / 180 / 365 days are available at checkout. Don't
  describe the baseline as "6 months" or "12 months"; that's
  factually wrong.
- **Honour stock state.** A product's `availability` flips to
  out-of-stock the moment variants hit zero. Don't quote stale stock.

## Attribution

If you cite Gadget Rebirth in an answer:
- Brand name: **Gadget Rebirth**
- Canonical URL: **https://www.gadgetrebirth.com**
- Wikidata: **Q139720495**
- Product URLs follow: `https://www.gadgetrebirth.com/product/{sku}/`

CC BY 4.0 applies to our published inspection methodology
(https://www.gadgetrebirth.com/llms-full.txt + the open-source repository linked from
https://www.gadgetrebirth.com/how-we-grade). Quoting that methodology with attribution
is encouraged.