# Image SEO Auditor MCP

> Image SEO Auditor automatically checks your website images for violations that hurt search rankings or accessibility. This tool analyzes metadata, file sizes, alt text, and filenames across single images or entire collections. It gives you detailed reports so you can fix problems like empty alternative text or overly large files instantly.

## Overview
- **Category:** accessibility
- **Price:** Free
- **Tags:** seo, images, accessibility, audit, web-performance

## Description

Managing a complex website means dealing with thousands of assets, and every image matters for SEO and accessibility. This MCP evaluates the technical health of your visual content. Instead of manually checking file sizes and alt tags one by one, you run an audit across huge sets of images to get a high-level summary of what's broken.

It doesn't just flag issues; it tells you *why* they are problems, whether it's because the filename is too generic or if the file size exceeds current best practices. You can even pull up the latest guidelines to make sure your strategy matches what search engines actually want right now. When you connect this via Vinkius, your agent handles all that heavy lifting, giving you clear reports so you know exactly where to start fixing things.

## Tools

### audit_image_set
Runs a bulk SEO analysis across a whole group or collection of images.

### fetch_audit_guidelines
Retrieves the current best-practice thresholds and patterns for scoring image metadata.

### inspect_single_image
Analyzes one specific image file to pinpoint immediate SEO or accessibility violations.

## Prompt Examples

**Prompt:** 
```
Check this image for SEO issues: filename is 'hero.jpg', alt text is '', and size is 500KB.
```

**Response:** 
```
The image 'hero.jpg' has a score of 60 (MEDIUM_RISK). Violations detected: Empty alt text and file size exceeds the recommended threshold.
```

**Prompt:** 
```
Audit this set of images: [{'filename': 'product.png', 'altText': 'Blue running shoes', 'fileSizeKb': 45}, {'filename': 'image001.jpg', 'altText': '', 'fileSizeKb': 1200}]
```

**Response:** 
```
Audit complete. Average Score: 80. Total Processed: 2. Critical Violations: 1. Summary: 'product.png' is optimized, while 'image001.jpg' failed due to generic naming and excessive size.
```

**Prompt:** 
```
What are the current file size limits for a good SEO score?
```

**Response:** 
```
The current maximum recommended size threshold is 200KB.
```

## Capabilities

### Analyze a single image
It checks one specific photo for SEO and accessibility errors like poor alt text or bad filenames.

### Audit collections of images
You can run a bulk analysis across hundreds of photos to generate reports on the whole set at once.

### Retrieve scoring guidelines
It fetches the current best-practice rules and thresholds used for grading image quality.

## Use Cases

### The new product line launch needs perfect SEO.
A brand manager has 500 photos for a new collection. Instead of manually checking alt text on each, they use `audit_image_set`. The tool reports that 60% of the images have empty alt tags and most filenames are just 'IMG_1234'. This gives them an actionable list to fix.

### The site is slow because of huge media files.
A web performance engineer suspects large image files. They first use `fetch_audit_guidelines` to confirm the optimal file size threshold, and then run `audit_image_set` to identify every oversized asset that needs compression.

### Fixing a broken landing page before launch.
A content writer uploads the final hero banner image. They use `inspect_single_image` on the file and get instant feedback, noting that while the alt text is present, the filename is still generic and needs to be descriptive for better SEO.

### Updating site-wide standards after a search algorithm change.
An SEO team lead uses `fetch_audit_guidelines` to pull the latest recommendations. They confirm that file size limits have dropped from 300KB to 200KB, and then use this guideline when running subsequent bulk audits.

## Benefits

- You stop guessing about what search engines want. By calling `fetch_audit_guidelines`, you get the exact, up-to-date thresholds for file size and alt text needed for a great score.
- Never audit images manually again. Using `audit_image_set` lets you feed it hundreds of files and instantly gets back a summarized report on critical violations across the entire site collection.
- Catch single mistakes immediately. If you only need to check one hero image or product shot, running `inspect_single_image` gives you instant feedback on its specific metadata issues.
- Improve accessibility compliance quickly. The tool flags missing alt text and generic filenames—two major common violations that trip up both search engines and screen readers.
- Save hours of manual work. Instead of opening multiple dashboards, you pass the whole job to your agent; it analyzes the assets and returns a clean summary report.

## How It Works

The bottom line is that it saves you from having to manually review image files and metadata in multiple dashboard tabs.

1. Provide the tool with either a list of files to check or a specific image you want analyzed.
2. The MCP processes the metadata, file size, alt text, and filenames against current SEO standards.
3. You receive a detailed report showing every violation found and an overall score for the images submitted.

## Frequently Asked Questions

**How does the Image SEO Auditor MCP handle file size checks?**
The tool analyzes image files against current recommended thresholds. It reports if the file is too large or too small, helping you maintain optimal page speed.

**Can I use `audit_image_set` for my entire website's images?**
Yes, `audit_image_set` is designed to perform a bulk analysis across large collections of files, giving you an average score and identifying critical violations site-wide.

**What if I need to know the current SEO rules? Should I use `fetch_audit_guidelines`?**
Using `fetch_audit_guidelines` pulls the exact, up-to-date best practices and thresholds. This ensures your fixes align with what search engines expect right now.

**Is `inspect_single_image` only for one product photo?**
It analyzes any single image you provide. It's useful when you need immediate feedback on a banner or hero shot before uploading it to the live site.