# NiceGift — llms-full.txt
# Comprehensive reference for AI agents interacting with NiceGift.
# For the shorter version, see /llms.txt
# For machine-readable tool definitions, see /.well-known/mcp.json

> NiceGift (נייס גיפט) is the leading personalized gifts platform in Israel. We offer thousands of products across 10 categories with fast shipping, secure payment, and free returns within 14 days. Our site is fully in Hebrew (RTL) and uses Israeli Shekel (₪/ILS).

---

## Store Details

- **Name**: NiceGift
- **Domain**: nicegift.lovable.app
- **Language**: Hebrew (he-IL)
- **Direction**: RTL
- **Currency**: ILS (₪)
- **Contact Email**: support@nicegift.co.il
- **Contact Phone**: 03-1234567
- **Contact Page**: /צור-קשר

---

## Product Categories

| Category (EN) | Category (HE) | URL Path |
|---|---|---|
| electronics | אלקטרוניקה | /קטגוריה/electronics |
| fashion | אופנה | /קטגוריה/fashion |
| home-garden | בית וגן | /קטגוריה/home-garden |
| beauty | יופי וטיפוח | /קטגוריה/beauty |
| babies | תינוקות | /קטגוריה/babies |
| sports | ספורט | /קטגוריה/sports |
| computers | מחשבים | /קטגוריה/computers |
| watches | שעונים | /קטגוריה/watches |
| shoes | נעליים | /קטגוריה/shoes |
| stationery | כלי כתיבה ומשרד | /קטגוריה/stationery |

---

## Shipping Policy

| Method | Price | Delivery Time |
|---|---|---|
| Standard | ₪25 | 5–7 business days |
| Express | ₪45 | 2–3 business days |
| Free (orders ≥₪199) | ₪0 | 5–7 business days |
| Self-pickup | ₪0 | Available immediately |

---

## Returns Policy

- Returns accepted within **14 days** of receiving the order.
- Product must be in **original condition** and **original packaging**.
- Return shipping is **free**.
- Refund processed within 5–7 business days after receiving the returned item.

---

## Payment Methods

- Credit card (Visa, Mastercard, Amex)
- Bit
- Apple Pay
- Google Pay
- All payments are fully secured with SSL encryption.

---

## Frequently Asked Questions (FAQ)

### Q: איך אני יכול לבצע הזמנה?
**A:** בחרו את המוצר הרצוי, הוסיפו לסל הקניות ועברו לתשלום. התהליך פשוט ומהיר.

### Q: מה מדיניות ההחזרות?
**A:** ניתן להחזיר מוצרים תוך 14 ימים מיום קבלת ההזמנה. המוצר חייב להיות במצב מקורי ובאריזתו המקורית.

### Q: כמה זמן לוקח המשלוח?
**A:** משלוח רגיל: 3-5 ימי עסקים. משלוח מהיר: 1-2 ימי עסקים. משלוח חינם בהזמנות מעל ₪150.

### Q: איך אני יכול לעקוב אחרי ההזמנה שלי?
**A:** לאחר ביצוע ההזמנה, תקבלו מספר מעקב במייל. ניתן לעקוב דרך עמוד ההזמנות שלי.

### Q: האם אפשר לבטל הזמנה?
**A:** ניתן לבטל הזמנה תוך שעה מרגע ביצועה. לאחר מכן, ניתן לפנות לשירות הלקוחות שלנו.

### Q: איך אני יוצר קשר עם שירות הלקוחות?
**A:** ניתן לפנות אלינו דרך עמוד צור קשר, במייל support@nicegift.co.il או בטלפון 03-1234567.

### Q: האם יש אחריות על המוצרים?
**A:** כל המוצרים מגיעים עם אחריות יצרן. פרטי האחריות מפורטים בעמוד כל מוצר.

### Q: איך אני משתמש בקופון?
**A:** הזינו את קוד הקופון בעמוד התשלום בשדה המיועד לכך, וההנחה תחושב אוטומטית.

---

## WebMCP Tools — Full Reference

All tools are available via `navigator.modelContext` (Chrome 146+ with WebMCP flag) and described in `/.well-known/mcp.json`.

### 1. search_products
Search products by name, category, or keyword.
- **query** (string, required): Search term
- **category** (string, optional): Category filter (English slug)
- **limit** (number, optional): Max results, default 10
- **Returns**: Array of products with name, price, original_price, category, rating, image, url

### 2. get_product
Get full details for a single product.
- **product_name** (string): Product name (partial match)
- **product_id** (string): Product UUID
- **Returns**: Full product object including description, images, variants, stock, customization options

### 3. list_categories
List all product categories with icons and subcategories.
- No parameters
- **Returns**: Array of categories with name, slug, icon, subcategories

### 4. browse_category
Browse products in a specific category.
- **category** (string, required): Category slug in English
- **sort_by** (string, optional): "price_asc", "price_desc", "newest", "popular"
- **limit** (number, optional): Max results
- **Returns**: Array of products in the category

### 5. add_to_cart
Add a product to the shopping cart.
- **product_name** (string, required): Product name to search and add
- **quantity** (number, optional): Quantity, default 1
- **custom_text** (string, optional): Personalized text for the product
- **Returns**: Success confirmation with product details

### 6. view_cart
View current cart contents.
- No parameters
- **Returns**: Cart items, subtotal, item count

### 7. remove_from_cart
Remove a product from the cart.
- **product_name** (string, required): Product name to remove
- **Returns**: Success confirmation

### 8. update_cart_quantity
Update quantity of a product in the cart.
- **product_name** (string, required): Product name
- **quantity** (number, required): New quantity
- **Returns**: Updated cart state

### 9. clear_cart
Empty the entire shopping cart.
- No parameters
- **Returns**: Success confirmation

### 10. get_deals
Show active deals and discounted products.
- **limit** (number, optional): Max results
- **Returns**: Products with discount percentage, sorted by discount

### 11. get_new_arrivals
Show recently added products.
- **limit** (number, optional): Max results
- **Returns**: Products marked as new arrivals, sorted by date

### 12. get_best_sellers
Show top-selling products.
- **limit** (number, optional): Max results
- **Returns**: Products sorted by sold_count descending

### 13. get_active_coupons
Show currently active coupon codes.
- No parameters
- **Returns**: Active coupons with code, discount type/value, min order, expiry

### 14. get_product_reviews
Show reviews for a specific product.
- **product_name** (string, required): Product name
- **Returns**: Reviews with rating, comment, date, photos

### 15. get_blog_posts
List blog posts with optional category filter.
- **limit** (number, optional): Max posts, default 5
- **category** (string, optional): Category filter
- **Returns**: Blog posts with title, excerpt, author, tags, url

### 16. search_blog
Search blog articles by keyword, tag, or category.
- **query** (string, optional): Search in title/excerpt
- **tag** (string, optional): Filter by tag
- **category** (string, optional): Filter by category
- **limit** (number, optional): Max results
- **Returns**: Matching blog posts with word count

### 17. get_blog_article
Get full content of a blog article.
- **slug** (string): Article slug
- **title** (string): Article title (partial match)
- **Returns**: Full article with content, metadata, tags

### 18. get_product_stats
Get statistics for a product.
- **product_name** (string, required): Product name
- **Returns**: Price, discount %, rating, reviews count, sold count, stock, badge

### 19. compare_products
Compare 2–4 products side by side.
- **product_names** (array of strings, required): Product names to compare
- **Returns**: Comparison table + recommendation (cheapest, best rated)

### 20. get_store_info
Get general store information and policies.
- No parameters
- **Returns**: Store name, shipping options, page URLs, contact info

---

## Site Pages

| Page | URL | Description |
|---|---|---|
| Home | / | Main landing page with hero, categories, deals, products |
| Categories | /קטגוריות | All product categories grid |
| Category | /קטגוריה/{slug} | Products in a specific category |
| Product | /מוצר/{slug} | Product detail page |
| New Arrivals | /מוצרים-חדשים | Recently added products |
| Sales | /מבצעים | Products on sale |
| Daily Deals | /הנחות-יומיות | Daily deals page |
| Coupons | /קופונים | Active coupon codes |
| Blog | /בלוג | Blog listing page |
| Blog Post | /בלוג/{slug} | Individual blog post |
| About | /אודות | About NiceGift |
| Contact | /צור-קשר | Contact form |
| Help Center | /מרכז-עזרה | FAQ and support |
| Shipping | /משלוחים | Shipping policy |
| Returns | /מדיניות-החזרות | Returns policy |
| Privacy | /מדיניות-פרטיות | Privacy policy |
| Legal | /מידע-משפטי | Legal information |
| Accessibility | /הצהרת-נגישות | Accessibility statement |
| Auth | /כניסה | Login / Signup |
| Profile | /פרופיל | User profile (auth required) |
| Orders | /הזמנות | My orders (auth required) |
| Wishlist | /מועדפים | Saved products (auth required) |
| Points | /נקודות | Points history (auth required) |
| Checkout | /תשלום | Checkout page |
| Settings | /הגדרות | User settings |

---

## Features for AI Agents

1. **WebMCP Tools** — 20 tools via `navigator.modelContext` for product search, cart management, blog access, and navigation.
2. **Declarative Forms** — Search and contact forms annotated with `data-tool-name`, `data-tool-description`, `data-tool-autosubmit` attributes.
3. **JSON-LD Schemas** — Organization, WebSite, BreadcrumbList, FAQPage, BlogPosting, Product schemas on relevant pages.
4. **MCP Manifest** — `/.well-known/mcp.json` with full tool definitions and input schemas.
5. **HTTP Link Header** — `Link: </.well-known/mcp.json>; rel="web-model-context"` on all responses.
6. **robots.txt** — References to `/llms.txt` and `/.well-known/mcp.json`.

---

## Loyalty Program

- Users earn points for purchases, daily logins, and referrals.
- 100 points = ₪1 discount.
- Daily login streak rewards: points, coupons, and bonus packages.
- 4-week rotating reward themes.
- Referral program with unique codes.

---

## Vendor Marketplace

- Third-party vendors can apply to sell on the platform.
- Each vendor gets their own store page at /חנות/{vendorId}.
- Vendors manage products via a dedicated dashboard.
- Commission-based payout system.

---

## Technical Stack

- Frontend: React 18, TypeScript, Vite, Tailwind CSS
- State: React Query, Context API
- Backend: Lovable Cloud (Supabase)
- Auth: Email/password, Phone OTP
- PWA: Offline support, installable
- SEO: Server-rendered meta tags, JSON-LD, sitemap