# SEO Content Analyzer for OpenCart 3.x

An OpenCart extension that analyzes product and category content quality for SEO using OpenAI API.

## Features

- **AI-Powered SEO Analysis**: Uses OpenAI's GPT model to analyze content quality
- **Multi-language Support**: Checks titles and descriptions in all configured languages
- **Easy Integration**: Adds "Check SEO Quality" button to product and category edit forms
- **Actionable Suggestions**: Provides specific recommendations to improve SEO quality
- **Comprehensive Checks**: Analyzes titles, meta titles, descriptions, meta descriptions, and keywords

## What Gets Analyzed

The extension analyzes the following fields for each language:
- Product/Category Name
- Meta Title
- Description
- Meta Description
- Meta Keywords

## Analysis Results

The AI provides:
- **Overall Score**: SEO quality rating out of 10
- **Issues Found**: List of specific problems
- **Language-Specific Suggestions**: Actionable recommendations for each language

## File Structure

```
upload/
├── admin/
│ ├── controller/extension/module/
│ │ ├── seo_analyzer.php (Main controller and settings)
│ │ └── seo_analyzer_event.php (Event handler for button injection)
│ ├── model/extension/module/
│ │ └── seo_analyzer.php (OpenAI API integration)
│ ├── view/
│ │ ├── template/extension/module/
│ │ │ └── seo_analyzer.twig (Settings page template)
│ │ └── javascript/
│ │ └── seo_analyzer.js (Frontend functionality)
│ └── language/en-gb/extension/module/
│ └── seo_analyzer.php (English language file)
install.xml (Modification file for OpenCart)
```

## Requirements

- OpenCart 3.x
- PHP 7.0 or higher
- cURL extension enabled
- Valid OpenAI API account with credits

## Troubleshooting

**Button not appearing:**
- Make sure the extension is installed and enabled
- Check that modifications are refreshed in Extensions → Modifications
- Clear OpenCart cache

**Analysis not working:**
- Verify your OpenAI API key is correct
- Check that your server can make outbound HTTPS requests
- Ensure you have credits in your OpenAI account
- Check PHP error logs for detailed error messages

**No suggestions displayed:**
- Make sure you have content in at least one language
- Check browser console for JavaScript errors
- Verify the AJAX request is successful in browser developer tools

## API Costs

This extension uses OpenAI's GPT-4o-mini model. Each analysis costs approximately:
- 0.15 cents per 1000 tokens for input
- 0.60 cents per 1000 tokens for output

Typical analysis cost: $0.001 - $0.005 per request

## Support

For issues, questions, or suggestions, please contact the extension developer.

## License

This extension is provided as-is for OpenCart 3.x installations.

## Version History

- **1.0.0** - Initial release
- OpenAI integration
- Multi-language support
- Product and category analysis
- Settings page with API key configuration