prestashop-ai-kit

# PrestaShop AI Kit A complete toolkit for managing a PrestaShop 9 e-commerce store with AI agents. Built with Claude Code, MCP (Model Context Protocol), and Cowork autonomous agents. > **Article**: [Building an AI-Powered E-Commerce Pipeline with PrestaShop and Claude](https://www.linkedin.com/pulse/building-ai-powered-e-commerce-pipeline-prestashop-claude-mehdi-berk) ## What This Does This kit connects Claude Code to your PrestaShop store and automates daily operations: - **Product Research**: AI agent finds trending products for dropshipping daily - **Product Listing**: AI agent creates optimized listings with descriptions, SEO, and images - **Order Management**: AI agent pulls orders and generates fulfillment spreadsheets - **Infrastructure**: SSH tunnels, auto-sync, deploy scripts, dynamic DNS ## Architecture ``` Local (Windows) Remote Server +------------------+ +------------------+ | Claude Code | HTTPS/SSH | PrestaShop 9 | | + MCP Server +-------------->| + Webservice API | | + Cowork Agents | | + MySQL | +--------+---------+ +--------+---------+ | | v v +------------------+ +------------------+ | GitHub Repo +<--- auto ---->| auto-sync.sh | | (main branch) | sync | (cron, 5 min) | +------------------+ +------------------+ ``` See [docs/architecture.md](docs/architecture.md) for the full system diagram. ## Requirements | Component | Version | Purpose | |-----------|---------|---------| | PrestaShop | 9.x | E-commerce platform | | Python | 3.10+ | MCP server runtime | | uv | latest | Python package manager | | Claude Code | latest | AI assistant CLI/IDE | | Git | 2.x+ | Version control and deployment | | SSH | any | Server access and tunneling | | PHP | 8.1+ | Image uploader on server | ## Quick Start 1. **Clone this repo** ```bash git clone https://github.com/YOUR_USER/prestashop-ai-kit.git cd prestashop-ai-kit ``` 2. **Configure credentials** ```bash cp .env.example .env # Edit .env with your PrestaShop API keys and database credentials ``` 3. **Set up the MCP server** ```bash cd mcp-server uv sync uv run src/prestashop_mcp/server.py ``` 4. **Register in Claude Code** — add the MCP server to your settings 5. **Deploy tools to server** — copy `image-uploader.php` and server scripts See [SETUP.md](SETUP.md) for the complete step-by-step guide. ## Project Structure ``` prestashop-ai-kit/ ├── mcp-server/ # MCP server (Python) for PrestaShop API │ ├── src/ # Server source code │ └── pyproject.toml # Dependencies ├── cowork-agents/ # Autonomous agent instruction files │ ├── agent1-product-researcher.md │ ├── agent2-product-lister.md │ ├── agent3-order-manager.md │ └── criteria-template.md ├── infrastructure/ # Server and local infrastructure scripts │ ├── ssh-config-template # SSH config for server access │ ├── deploy.sh # Manual deployment script │ ├── auto-sync.sh # Cron-based auto-pull on server │ ├── sync-check.sh # Check if server is in sync with Git │ ├── start-tunnel.ps1 # Start SSH tunnel for MySQL │ ├── setup-scheduled-tasks.ps1 # Windows Task Scheduler setup │ └── update-duckdns.ps1 # Dynamic DNS updater ├── prestashop-tools/ # Tools deployed to the PrestaShop server │ ├── image-uploader.php # Server-side image upload endpoint │ └── gitignore-prestashop # .gitignore template for PrestaShop ├── docs/ # Documentation │ ├── architecture.md # Full system architecture diagram │ ├── admin-api-status.md # PrestaShop 9 API endpoint status │ └── troubleshooting.md # Common issues and fixes ├── claude-context/ # Claude Code context templates ├── .env.example # Environment variable template ├── SETUP.md # Detailed setup guide └── README.md # This file ``` ## Documentation - [SETUP.md](SETUP.md) — Full setup guide (infrastructure, API, MCP, agents) - [docs/architecture.md](docs/architecture.md) — System architecture and data flows - [docs/admin-api-status.md](docs/admin-api-status.md) — Which PrestaShop 9 API endpoints work - [docs/troubleshooting.md](docs/troubleshooting.md) — Common issues and solutions ## Cowork Agents | Agent | Role | Frequency | |-------|------|-----------| | Product Researcher | Finds trending dropshipping products | Daily | | Product Lister | Creates optimized store listings | After research | | Order Manager | Generates fulfillment spreadsheets | Daily | Each agent's instructions are in [cowork-agents/](cowork-agents/). Customize the store name, URLs, and criteria before use. ## License MIT