ALwrity/docs-site/docs/features/seo-dashboard/individual-tools-guide.md

# Individual SEO Tools Guide

## 🛠️ Overview

This guide covers each of ALwrity's 9 individual SEO analysis tools, how to use them, and when to use each one.

---

## 1. 📝 Meta Description Generator

### What It Does
Generates AI-powered SEO-optimized meta descriptions that:
- Include target keywords naturally
- Stay within optimal length (150-160 characters)
- Include compelling call-to-action
- Improve click-through rates

### When to Use
- Creating new pages
- Updating old pages
- Testing description improvements
- Preparing for social media repurposing

### How to Use
```
1. Go to SEO Dashboard → Meta Description Generator
2. Enter your target keywords (comma-separated)
3. Select tone (Professional, Casual, Friendly, etc.)
4. Choose search intent (Informational, Commercial, Transactional)
5. Select language
6. Click "Generate"
7. Review multiple options
8. Copy and use on your page
```

### Example
```
Input: Keywords: "SEO, content marketing, rankings"
       Tone: Professional
       Intent: Informational

Output:
- "Learn proven SEO & content marketing strategies to boost your rankings. Get actionable tips from industry experts."
- "Master SEO and content marketing to increase organic traffic. Complete guide with practical examples."
- "Discover how SEO and content marketing drive rankings and traffic. Step-by-step strategies for success."
```

### Pro Tips
- ✅ Include primary keyword in first 120 characters
- ✅ Include compelling benefit or question
- ✅ Test multiple descriptions to find best performer
- ✅ Monitor CTR to measure effectiveness

---

## 2. ⚡ PageSpeed Analyzer

### What It Does
Analyzes your page performance using Google PageSpeed Insights API and provides:
- Performance scores (desktop/mobile)
- Core Web Vitals (LCP, FID, CLS)
- Optimization opportunities
- Business impact analysis

### When to Use
- Initial performance baseline
- After making performance improvements
- Before/after optimization comparison
- Competitive performance comparison
- Monthly performance tracking

### How to Use
```
1. Go to SEO Dashboard → PageSpeed Analyzer
2. Enter page URL
3. Select strategy (Desktop or Mobile)
4. Click "Analyze"
5. Wait for analysis (5-8 seconds)
6. Review scores and opportunities
7. Prioritize fixes by impact
```

### Understanding Scores
- **90-100**: Excellent (Good to go)
- **80-89**: Good (Minor improvements available)
- **50-79**: Needs Improvement (Address issues)
- **0-49**: Poor (Critical issues)

### Key Metrics
- **LCP** (Largest Contentful Paint): How fast page loads
- **FID** (First Input Delay): How fast page responds
- **CLS** (Cumulative Layout Shift): Visual stability

### Pro Tips
- ✅ Analyze both desktop and mobile
- ✅ Focus on opportunities with highest impact
- ✅ Optimize images first (biggest impact)
- ✅ Monitor improvements monthly

---

## 3. 🗺️ Sitemap Analyzer

### What It Does
Analyzes your website structure and content strategy:
- URL patterns and organization
- Content distribution across topics
- Publishing frequency and velocity
- Content trends and patterns
- AI-powered strategic insights

### When to Use
- Initial website audit
- Content strategy planning
- Competitive benchmarking
- Quarterly strategy review
- When planning content expansion

### How to Use
```
1. Go to SEO Dashboard → Sitemap Analyzer
2. Enter your sitemap URL (e.g., example.com/sitemap.xml)
3. Choose analysis options:
   - Analyze content trends: Yes/No
   - Analyze publishing patterns: Yes/No
4. Click "Analyze"
5. Wait for analysis (10-15 seconds)
6. Review structure, trends, and recommendations
```

### What You'll Learn
- Total URLs and content volume
- Content distribution by topic
- Publishing frequency
- URL structure quality
- Content freshness
- Growth opportunities
- SEO recommendations

### Pro Tips
- ✅ Run monthly to track content growth
- ✅ Compare with competitors' sitemaps
- ✅ Use insights to plan content strategy
- ✅ Track publishing velocity to maintain consistency

---

## 4. 🖼️ Image Alt Text Generator

### What It Does
Generates SEO-optimized alt text for images using AI vision:
- Describes image content accurately
- Incorporates target keywords naturally
- Optimizes for accessibility (WCAG compliance)
- Improves search image rankings

### When to Use
- Publishing new content with images
- Updating old content without alt text
- Optimizing for image search
- Accessibility compliance
- Before archiving images

### How to Use

#### Option 1: Upload Image
```
1. Go to SEO Dashboard → Image Alt Text Generator
2. Click "Upload Image"
3. Select image from computer
4. Enter context (optional): What the image is about
5. Enter keywords (optional): Keywords to include
6. Click "Generate Alt Text"
7. Review and copy results
```

#### Option 2: Image URL
```
1. Go to SEO Dashboard → Image Alt Text Generator
2. Click "Analyze by URL"
3. Paste image URL
4. Enter context (optional)
5. Enter keywords (optional)
6. Click "Generate Alt Text"
7. Review and copy results
```

### Example
```
Image: Product photo of blue laptop

AI-Generated Alt Text:
- "Blue laptop with ergonomic design on white background"
- "Dell XPS 13 laptop opened showing keyboard and screen"
- "Professional laptop for developers - blue aluminum design"
```

### Pro Tips
- ✅ Keep alt text concise (under 125 characters)
- ✅ Include brand/product name when relevant
- ✅ Describe the image, not the context
- ✅ Use keywords naturally, don't stuff
- ✅ Update all old images gradually

---

## 5. 📱 OpenGraph Generator

### What It Does
Creates platform-specific social media tags for:
- Facebook sharing optimization
- Twitter cards
- LinkedIn preview
- Pinterest optimization
- Other social platforms

### When to Use
- Creating new content
- Updating existing pages for social
- Before launching social media campaign
- To improve social sharing appearance
- When content isn't sharing well

### How to Use
```
1. Go to SEO Dashboard → OpenGraph Generator
2. Enter page URL
3. Enter title hint (optional)
4. Enter description hint (optional)
5. Select platform (General, Facebook, Twitter, LinkedIn, Pinterest)
6. Click "Generate Tags"
7. Copy HTML code to page
```

### Platforms Covered
- **General**: Works across all platforms
- **Facebook**: Optimized for Facebook sharing
- **Twitter**: Twitter Card format
- **LinkedIn**: LinkedIn sharing optimization
- **Pinterest**: Pinterest Pin optimization

### Example Output
```html
<!-- Generated OpenGraph Tags -->
<meta property="og:title" content="10 Content Marketing Strategies for 2024">
<meta property="og:description" content="Learn proven strategies to boost your content marketing ROI. Get actionable tips and templates.">
<meta property="og:image" content="https://example.com/images/content-strategy.jpg">
<meta property="og:url" content="https://example.com/article/content-marketing">
<meta property="og:type" content="article">
<meta property="og:site_name" content="Example Site">
```

### Pro Tips
- ✅ Use high-quality images (1200x630px minimum)
- ✅ Test on each platform before publishing
- ✅ Keep descriptions concise (200 characters max)
- ✅ Use consistent branding across platforms

---

## 6. 📄 On-Page SEO Analyzer

### What It Does
Comprehensive page-level SEO analysis covering:
- Meta tags optimization
- Content quality and relevance
- Keyword optimization
- Internal linking analysis
- Image SEO optimization
- Mobile friendliness
- Accessibility compliance

### When to Use
- Before publishing new pages
- Optimizing existing pages
- Improving underperforming pages
- Competitive page comparison
- SEO audit preparation

### How to Use
```
1. Go to SEO Dashboard → On-Page SEO Analyzer
2. Enter page URL
3. Enter target keywords (optional)
4. Select options:
   - Analyze images: Yes/No
   - Analyze content quality: Yes/No
5. Click "Analyze"
6. Wait for analysis (8-12 seconds)
7. Review scores and recommendations
8. Implement changes
```

### What You Get
- **Overall Score**: 0-100 rating
- **Meta Tags Analysis**: Title, description, headers
- **Content Analysis**: Quality, relevance, keyword usage
- **Technical Analysis**: Links, images, structure
- **Performance Metrics**: Load time, mobile friendly
- **Critical Issues**: Must-fix problems
- **Warnings**: Should-fix issues
- **Recommendations**: Nice-to-fix suggestions

### Pro Tips
- ✅ Target 80+ score before publishing
- ✅ Fix critical issues first
- ✅ Use primary keyword in title and first 100 words
- ✅ Include related keywords naturally
- ✅ Build internal links to related pages

---

## 7. 🔧 Technical SEO Analyzer

### What It Does
Comprehensive technical SEO audit including:
- Site crawling (customizable depth)
- Robots.txt analysis
- Sitemap validation
- Canonicalization audit
- Redirect chain detection
- Broken link identification
- Mobile usability analysis
- Performance metrics

### When to Use
- Initial technical SEO audit
- After major site changes
- When experiencing ranking drops
- Quarterly SEO maintenance
- Before large campaigns

### How to Use
```
1. Go to SEO Dashboard → Technical SEO Analyzer
2. Enter site URL
3. Set crawl depth (1-5)
   - 1: Homepage only
   - 3: Recommended starting point
   - 5: Comprehensive crawl
4. Select options:
   - Include external links: Yes/No
   - Analyze performance: Yes/No
5. Click "Analyze"
6. Wait for crawl (15-30 seconds depending on depth)
7. Review issues by severity
8. Prioritize fixes
```

### Issue Severity Levels
- **Critical**: Prevent indexing, hurt rankings
- **High**: Significantly impact SEO
- **Medium**: Minor SEO impact
- **Low**: Good to fix, lower priority

### Typical Issues Found
- Crawl errors (4xx, 5xx)
- Redirect chains
- Broken internal links
- Missing meta tags
- Duplicate content
- Mobile usability issues
- Page speed problems
- Missing structured data

### Pro Tips
- ✅ Fix critical issues immediately
- ✅ Address high priority issues weekly
- ✅ Maintain regular monitoring schedule
- ✅ Use redirects for moved content
- ✅ Keep crawl depth moderate for large sites

---

## 8. 🏢 Enterprise SEO Suite

### What It Does
Complete website SEO audit combining:
- All on-page analysis
- Technical SEO crawling
- Competitive analysis
- Performance optimization
- Executive summary with action plan
- Prioritized recommendations

### When to Use
- Comprehensive website audit
- Quarterly/annual SEO review
- Before major campaigns
- Competitive analysis
- Strategic planning

### How to Use
```
1. Go to SEO Dashboard → Enterprise SEO Suite
2. Enter website URL
3. Add competitors (optional, up to 5)
4. Enter target keywords (optional)
5. Select workflow type:
   - Comprehensive (Full audit)
   - Quick (Major areas only)
   - Competitive (Competitor focus)
6. Click "Run Audit"
7. Wait for completion (30-60 seconds)
8. Review comprehensive report
```

### Report Contents
- **Executive Summary**: High-level findings
- **Overall Score**: 0-100 rating with breakdown
- **Critical Issues**: Top problems to fix
- **Technical Analysis**: Full technical audit
- **Content Analysis**: Content quality insights
- **Competitive Comparison**: How you compare
- **Recommendations**: Prioritized action items
- **Implementation Timeline**: Suggested timeframe

### Pro Tips
- ✅ Run quarterly for ongoing monitoring
- ✅ Use competitive analysis to benchmark
- ✅ Focus on high-impact recommendations first
- ✅ Track improvements over time
- ✅ Use as strategic planning foundation

---

## 9. 📊 Content Strategy Analyzer

### What It Does
Content planning and strategy analysis including:
- Content gap identification
- Opportunity scoring
- Competitive content analysis
- Topic recommendations
- Content type suggestions
- Publishing strategy recommendations

### When to Use
- Content calendar planning
- Finding content opportunities
- Competitive content analysis
- Q quarterly strategy planning
- Content expansion planning

### How to Use
```
1. Go to SEO Dashboard → Content Strategy Analyzer
2. Enter your website URL
3. Add competitors (optional)
4. Enter target keywords (optional)
5. Select analysis options
6. Click "Analyze Content Strategy"
7. Wait for analysis (5-10 minutes)
8. Review content gaps and opportunities
9. Plan your content calendar
```

### What You'll Learn
- **Content Gaps**: Topics you're missing
- **Opportunity Scoring**: Potential of each gap
- **Competitive Content**: What competitors rank for
- **Topic Clusters**: Related topics to group
- **Publishing Recommendations**: How often to publish
- **Content Type Suggestions**: Blog, video, guide, etc.

### Output Analysis
- Top 10 opportunities (scored 0-100)
- Your content distribution
- Competitor strategies
- Recommended content types
- Publishing frequency suggestions
- Content calendar recommendations

See [Content Strategy Guide](content-strategy-guide.md) for detailed usage.

### Pro Tips
- ✅ Focus on high-scoring opportunities first
- ✅ Create content clusters around pillars
- ✅ Balance quick wins with strategic goals
- ✅ Update calendar monthly with new analysis
- ✅ Track performance of recommended content

---

## Choosing the Right Tool

### For Content Creators
| Goal | Tool |
|------|------|
| Quick meta tags | Meta Description Generator |
| Social media sharing | OpenGraph Generator |
| Image optimization | Image Alt Text Generator |
| Page optimization | On-Page SEO Analyzer |
| Performance | PageSpeed Analyzer |

### For Marketers
| Goal | Tool |
|------|------|
| Content planning | Content Strategy Analyzer |
| Competitive analysis | Competitive Analysis |
| Website structure | Sitemap Analyzer |
| Full audit | Enterprise SEO Suite |
| Technical health | Technical SEO Analyzer |

### For SEO Professionals
| Goal | Tool |
|------|------|
| Comprehensive audit | Enterprise SEO Suite |
| Technical issues | Technical SEO Analyzer |
| Content opportunities | Content Strategy Analyzer |
| Page optimization | On-Page SEO Analyzer |
| Performance tracking | PageSpeed Analyzer |

---

## Quick Reference

### Tool Comparison Table

| Tool | Speed | Depth | Use Case | Best Time |
|------|-------|-------|----------|-----------|
| Meta Description | 2-3s | Quick | Meta tags | Before publishing |
| PageSpeed | 5-8s | Medium | Performance | Monthly check |
| Sitemap | 10-15s | Medium | Strategy | Quarterly |
| Image Alt Text | 3-5s | Quick | Images | While writing |
| OpenGraph | 2-3s | Quick | Social | Before publishing |
| On-Page SEO | 8-12s | Deep | Pages | Before publishing |
| Technical SEO | 15-30s | Very Deep | Site crawl | Monthly |
| Enterprise Suite | 30-60s | Very Deep | Full audit | Quarterly |
| Content Strategy | 5-10 min | Deep | Planning | Monthly |

---

## Integration Tips

Use these tools in combination:
1. **Content Planning** → Content Strategy Analyzer
2. **Page Creation** → Blog Writer
3. **Meta Optimization** → Meta Description + OpenGraph
4. **Image Optimization** → Image Alt Text Generator
5. **Page Optimization** → On-Page SEO Analyzer
6. **Performance** → PageSpeed Analyzer
7. **Technical Health** → Technical SEO Analyzer
8. **Full Audit** → Enterprise SEO Suite

---

**Ready to start? Pick a tool from the list above and get started, or explore the [Tools Reference](tools-reference.md) for complete tool overview!**