Docs
    Shopify AI Product OptimizerUpdated Jul 13, 2026MD

    AI Product SEO Optimizer

    Markdown file

    README.md

    AI Product SEO Optimizer

    A Shopify app that uses AI to automatically analyze and optimize product listings for SEO and agentic commerce readiness.

    Start here (daily workflow)

    • Handoff / where we left off: docs/HANDOFF.md
    • Docs index: docs/README.md
    • Runbook: docs/RUNBOOK.md
    • Changelog: CHANGELOG.md

    Features

    • Product SEO Analysis: Comprehensive analysis of product titles, descriptions, meta tags, and more
    • AI-Powered Suggestions: Generate optimized content using OpenAI/Anthropic models
    • Keyword Landing Pages: Create SEO-optimized landing pages for specific keywords
    • Automation: Configure automatic optimization based on triggers and rules
    • Full Audit Trail: Complete change history with one-click revert

    Tech Stack

    • Framework: Remix (React Router) with TypeScript
    • UI: Shopify Polaris + App Bridge
    • Database: PostgreSQL with Prisma ORM
    • Queue: BullMQ with Redis
    • AI: OpenAI GPT-4 / Anthropic Claude
    • API: Shopify GraphQL Admin API (2026-01)

    Getting Started

    Prerequisites

    • Node.js 20+
    • PostgreSQL database
    • Redis server
    • Shopify Partner account
    • OpenAI API key (or Anthropic)

    Installation

    1. Clone the repository:
    git clone https://github.com/your-org/shopify-ai-product-optimizer.git
cd shopify-ai-product-optimizer
    1. Install dependencies:
    npm install
    1. Copy environment variables:
    cp .env.example .env
    1. Configure your .env file with:
    • Shopify API credentials
    • Database connection string
    • Redis connection details
    • AI provider API keys
    1. Set up the database:
    npm run db:generate
npm run db:push
    1. Start development:
    npm run dev

    Running the Worker

    In a separate terminal:

    npm run worker:dev

    Project Structure

    ├── app/                    # Remix app
│   ├── routes/            # Route handlers
│   ├── lib/               # Shared utilities
│   ├── shopify.server.ts  # Shopify app config
│   └── db.server.ts       # Database client
├── worker/                 # Background job processor
│   ├── processors/        # Job handlers
│   └── services/          # Shared services
├── prisma/                 # Database schema
├── docs/                   # Documentation
│   ├── spikes/            # Technical research
│   └── app-store/         # App Store materials
└── extensions/            # Shopify extensions (future)

    Configuration

    Shopify App Config (shopify.app.toml)

    Key settings:

    • scopes: OAuth permissions
    • webhooks: Event subscriptions
    • embedded: Must be true for admin apps

    Environment Variables

    See .env.example for all required variables.

    Development

    Commands

    • npm run dev - Start dev server with Shopify CLI
    • npm run worker:dev - Start worker in watch mode
    • npm run build - Build for production
    • npm run db:studio - Open Prisma Studio
    • npm run lint - Run ESLint
    • npm run typecheck - Run TypeScript checks

    API Version

    This app uses Shopify API version 2026-01 for:

    • Concurrent bulk operations (up to 5)
    • Modern bulkOperation(id:) queries
    • Latest GraphQL schema

    Deployment

    Requirements

    • Node.js 20+ hosting (Vercel, Render, Railway, etc.)
    • PostgreSQL database
    • Redis instance
    • Separate worker process

    Steps

    1. Deploy the Remix app
    2. Deploy the worker separately
    3. Configure environment variables
    4. Set up database migrations
    5. Update shopify.app.toml with production URLs

    Contributing

    1. Fork the repository
    2. Create a feature branch
    3. Make your changes
    4. Run tests and linting
    5. Submit a pull request

    License

    MIT License - see LICENSE file for details