# ecAgent - AI-Powered Shopify Store Management

> Manage your Shopify store with natural language commands

## Core Content

- Home: https://ecagent.ai
- Features: https://ecagent.ai#features
- App: https://app.ecagent.ai
- API Docs: https://catalogcopilot-430016502960.herokuapp.com/docs

## About ecAgent

ecAgent (formerly CatalogCopilot) is an AI-powered platform that helps Shopify merchants
manage their stores through natural language conversations. Built with Claude Sonnet 4
and FastAPI, ecAgent eliminates the complexity of traditional Shopify dashboards by
allowing merchants to use simple commands like "Show me all bags under $500" or
"Increase keyring price by $5".

Our platform is designed for Shopify store owners who want faster, more intuitive
catalog management. Instead of clicking through multiple screens, merchants can
accomplish tasks in seconds using conversational commands or voice input.

Key features include:
- Natural language product search and filtering
- Real-time price and inventory management
- Bulk operations on multiple products at once
- Smart product variant creation (sizes, colors, etc.)
- Image management and reordering
- Voice command support via OpenAI Whisper
- Server-Sent Events (SSE) for real-time progress updates
- Business analytics and insights
- Multi-image upload with progress tracking
- Secure session-based authentication

## Technology Stack

- **Backend:** FastAPI (Python 3.12), uv package manager
- **AI Agent:** Claude Sonnet 4 with function calling
- **Real-time:** Server-Sent Events (SSE) streaming
- **Voice AI:** OpenAI Whisper (DeepInfra) for transcription
- **Shopify:** GraphQL API (version 2025-01)
- **Database:** PostgreSQL (Heroku Essential-0)
- **Architecture:** MCP (Model Context Protocol) with modular mixin design
- **Deployment:** Heroku with automated CI/CD
- **Testing:** Production-only (no local dev environment)

## Current Status

Live production system deployed to Heroku:
- App: https://app.ecagent.ai
- API: https://catalogcopilot-430016502960.herokuapp.com
- Version: v0.11.0 (latest)
- Status: Beta/Waitlist phase
- Demo Store: Black Essentials (Shopify)
- Authentication: Session-based with secure cookies

## Differentiators

Unlike traditional Shopify admin and other management tools:

1. **Natural Language First:** No learning curve - just type what you want
2. **AI-Powered Intelligence:** Claude Sonnet 4 understands context and intent
3. **Real-Time Streaming:** SSE prevents timeouts during complex operations
4. **Voice Commands:** Speak your requests for hands-free management
5. **Bulk Operations:** Update hundreds of products in seconds
6. **Modular Architecture:** 95.2% code reduction through mixin patterns
7. **Production-Ready:** Battle-tested on real Shopify stores

Target market: Shopify merchants managing product catalogs (2M+ stores worldwide).

## Use Cases

**Fashion & Apparel Stores:**
- Bulk price adjustments for seasonal sales
- Inventory updates by size/color variants
- Product visibility management (draft/active/archived)
- Image reordering for seasonal collections

**General Merchandise:**
- Price optimization across categories
- Stock level monitoring and updates
- Product search and filtering
- Analytics on inventory value and pricing

**High-Volume Catalogs:**
- Mass operations on product collections
- Category-wide discount campaigns
- Automated visibility fixes
- Comprehensive store analytics

## Key Features Detail

**Natural Language Commands:**
- "What's the price of the keyring?"
- "Show me all bags under $500"
- "Increase all bag prices by 10%"
- "Set Men's Shoe inventory: 5 Small, 10 Medium, 8 Large"
- "Make the third image primary for Travel Bag"

**MCP Server Tools:**
- search_products / search_all_products
- get_product (fuzzy matching)
- adjust_price / bulk_price_update
- inventory_status / update_inventory
- create_product (with variants)
- reorder_product_images
- fix_product_visibility
- archive_product / unarchive_product
- get_analytics
- apply_discount

**Real-Time Operations:**
- SSE streaming for live progress updates
- Handles complex multi-step operations
- Prevents 30-second timeout errors
- Multi-round tool execution (up to 5 rounds)
- Transparent feedback on each step

**Enhanced Visibility Management:**
- Detect why products aren't visible (draft, unpublished, inventory issues)
- One-click automated fixes
- Archive/unarchive products
- Publication status control
- Inventory tracking enablement

## Contact

- Website: https://ecagent.ai
- App: https://app.ecagent.ai
- Email: contact@ecagent.ai
- API: https://catalogcopilot-430016502960.herokuapp.com
- Documentation: CLAUDE.md, DEPLOYMENT.md in repository

## Recent Updates

**v0.11.0 - SSE Streaming:**
- Added Server-Sent Events for real-time progress updates
- Eliminated timeout errors during complex operations
- Enhanced multi-image upload experience
- Solved GitHub Issue #15

**v0.10.0 - Enhanced Visibility:**
- search_all_products for complete product state visibility
- fix_product_visibility for automated issue resolution
- Archive/unarchive product functionality
- Improved publication management

## Documentation

- CLAUDE.md: Comprehensive technical documentation for AI assistants
- DEPLOYMENT.md: Deployment procedures and Heroku setup
- README.md: Project overview and quick start guide
- TESTING.md: Testing strategies against production Heroku
- CHANGELOG.md: Version history and feature updates
- SSE_DOCUMENTATION_UPDATE_SUMMARY.md: Real-time streaming implementation