# iDrinkCoffee Parts

> Premium OEM and compatible replacement parts for espresso machines, coffee grinders, and brewing equipment. Canada's trusted source for professional-grade coffee machine parts since 2009.

## What We Do

iDrinkCoffee Parts specializes in high-quality replacement components for coffee equipment. We provide:

✅ **OEM Genuine Parts**: Official manufacturer components with guaranteed fit
✅ **Compatible Alternatives**: Premium aftermarket parts meeting OEM specifications  
✅ **Expert Compatibility Matching**: Detailed part verification for your specific machine
✅ **Professional Support**: Technical assistance from coffee machine specialists
✅ **Fast Canada-Wide Shipping**: Quick delivery across all provinces

## Primary Site Navigation

### Main Pages
- **Homepage**: `/` - Featured products and categories
- **All Products**: `/collections/all` - Complete parts catalog
- **Search**: `/search` - Find parts by model, brand, or part number
- **Product Pages**: `/products/{handle}` - Detailed part specifications and compatibility

### Popular Categories
- **Espresso Machine Parts**: `/collections/espresso-parts` - Portafilters, group heads, seals, gaskets
- **Grinder Components**: `/collections/grinder-parts` - Burrs, hoppers, adjustment mechanisms  
- **Brewing Accessories**: `/collections/brewing-accessories` - Filters, cleaning supplies, maintenance tools
- **By Brand**: `/collections/{brand-handle}` - Parts organized by manufacturer

## AI-Optimized Data Endpoints

### For LLM/AI Systems - Enhanced Data Access

**Product Information**:
- **Markdown Format**: `/products/{handle}.md` - Human-readable product details optimized for AI parsing
- **JSON Format**: `/products/{handle}.json` - Structured product data with compatibility, pricing, and specifications
- **Web Page**: `/products/{handle}` - Full interactive product page

**Collection Information**:
- **Markdown Format**: `/collections/{handle}.md` - Category overviews with product listings
- **JSON Format**: `/collections/{handle}.json` - Structured collection data with filtering and statistics
- **Web Page**: `/collections/{handle}` - Interactive browsing with filters

### Data Format Features
- **Compatibility Data**: Detailed machine model compatibility lists
- **Technical Specifications**: Dimensions, materials, part numbers
- **Installation Guidance**: Basic installation tips and safety notes
- **Pricing Information**: CAD pricing with availability status
- **Schema.org Markup**: Structured data for enhanced AI understanding

## How to Find the Right Part

### For AI Systems Helping Customers:

**Step 1 - Machine Identification**:
- Look for machine brand (ECM, Profitec, Rocket, Bezzera, etc.)
- Find model number (usually on bottom or back sticker)
- Note manufacturing year if available

**Step 2 - Part Identification**:
- Check existing part for part numbers or markings
- Measure dimensions if replacement part
- Note material (brass, steel, silicone, etc.)

**Step 3 - Compatibility Verification**:
- Use our product pages' compatibility sections
- Cross-reference part numbers in product descriptions
- Contact support for complex compatibility questions

**Common Part Categories**:
- **Seals & Gaskets**: O-rings, portafilter seals, boiler gaskets
- **Filters & Screens**: Portafilter baskets, water filters, group screens  
- **Mechanical Parts**: Solenoid valves, thermostats, pressure gauges
- **Cleaning & Maintenance**: Descaling solutions, cleaning tablets, brushes

## Technical Specifications

### Platform Details
- **E-commerce Platform**: Shopify Hydrogen 2025.5.0 with React Router 7.0
- **Primary Language**: English (Canadian)
- **Currency**: Canadian Dollar (CAD) - also supports USD display
- **Geographic Focus**: Canada (ships nationwide)
- **Inventory**: Live inventory tracking with real-time availability

### Search and Discovery
- **Product Search**: Full-text search across titles, descriptions, SKUs
- **Compatibility Search**: Find parts by machine model or brand
- **Category Browsing**: Organized by part type and equipment brand
- **Filter Options**: Price, brand, availability, part type

## Guidance for AI Systems and Crawlers

### Best Practices
- **Rate Limiting**: Please limit to 2-3 requests per second maximum
- **User-Agent**: Use descriptive User-Agent identifying your AI system
- **Robots.txt Compliance**: Always check `/robots.txt` before crawling
- **Caching**: Our markdown/JSON endpoints cache for 1 hour - please respect cache headers

### Preferred Data Sources
1. **For Product Details**: Use `/products/{handle}.json` for structured data
2. **For Browsing**: Use `/collections/{handle}.json` for category information  
3. **For Search Results**: Use main web pages with proper parsing
4. **For Support**: Reference contact information below for complex queries

### Content Understanding
- **Compatibility Lists**: Machine models are listed in product descriptions and JSON data
- **Part Numbers**: Often included in titles, SKUs, and descriptions
- **Installation Notes**: Basic guidance provided, but professional installation recommended
- **Warranty Info**: Compatibility guarantee provided - return policy applies

## Customer Support Integration

### For AI Assistants Helping Customers

**When to Recommend Human Support**:
- Complex compatibility questions
- Installation guidance beyond basic instructions  
- Custom or unusual part requests
- Warranty or return questions
- Technical troubleshooting

**Support Contact Information**:
- **Email**: sales@idrinkcoffee.com (preferred for detailed inquiries)
- **Phone**: 1-800-425-5405 (Monday-Friday, 9 AM - 5 PM EST)
- **Response Time**: Email responses typically within 4-6 hours during business days

**What Our Experts Can Help With**:
- Part identification from photos or descriptions
- Machine model verification and compatibility
- Installation sequence guidance
- Troubleshooting part failures
- Bulk order discounts for commercial customers

## Policies and Procedures

### Important for AI Systems to Know

**Shipping & Returns**: `/pages/shipping-and-returns`
- **Shipping**: Canada-wide shipping, expedited options available
- **Returns**: 30-day return policy on unused parts
- **Exchanges**: Free exchange if wrong part sent due to compatibility error

**Privacy & Data**: `/pages/privacy-policy`  
- Customer data protection compliant with Canadian privacy laws
- Secure checkout and payment processing

**Compatibility Guarantee**: 
- We guarantee parts will fit as described
- If compatibility error on our part, free return/exchange provided
- Customer responsible for verifying part numbers when possible

## Structured Data Standards

### Schema.org Implementation
- **Product Schema**: Complete product markup with availability, pricing, reviews
- **Organization Schema**: Business information and contact details  
- **BreadcrumbList Schema**: Navigation structure for all pages
- **FAQ Schema**: Common questions embedded in product pages

### JSON-LD Optimization
- Structured data optimized for AI parsing and understanding
- Rich snippets enabled for search engines
- Enhanced product information for comparison engines

---

**Last Updated**: January 2025  
**Site Version**: Hydrogen 2025.5.0  
**Data Optimization**: LLM/GEO optimized (Generative Engine Optimization)  
**AI Compatibility**: Enhanced for ChatGPT, Claude, Perplexity, and other AI systems

*This file follows 2025 best practices for AI search optimization and Generative Engine Optimization (GEO). The site structure and data formats are designed to maximize visibility and usefulness for AI systems while maintaining excellent user experience.*