feat: Brainstorm Topics with GSC + Issue #518 fixes + Blog Editor enhancements
Issue #518 - Subscription not updating after checkout: - Fix stale closure in SubscriptionContext checkout polling (use subscriptionRef) - Move checkout success polling from InitialRouteHandler into SubscriptionContext - Remove redundant polling code from InitialRouteHandler - Fix plan label: 'Free' instead of 'No Plan', proper capitalization - Add plan refresh button in UserBadge - Add 'View Costing Details' to UserBadge dropdown - Rename 'ALwrity Podcast Maker' to 'Podcast Creator' across UI - Clean subscription=success URL param after verification Blog Writer WYSIWYG Editor enhancements: - Per-section preview toggle (view/edit icons) - Enhanced hover-based toolbar - Circular SVG progress stats bar with detailed tooltip - Research tool chips in stats bar footer - Per-section TTS with useTextToSpeech hook (browser native) - Full blog preview modal with print/PDF support - PlayAllTTSButton: sequential playback with progress bar - OnThisPageNav: floating sidebar with scroll tracking - Section data attributes for scroll anchoring GSC Brainstorm Topics feature: - Backend: gsc_brainstorm_service.py (rule-based + LLM recommendations) - Backend: POST /gsc/brainstorm endpoint with 3-word minimum validation - Frontend: gscBrainstorm.ts API client - Frontend: useGSCBrainstormConnection hook (popup OAuth, no /onboarding redirect) - Frontend: useGSCBrainstorm hook (connect check + brainstorm call) - Frontend: GSCBrainstormModal (3-tab results: Opportunities, Gaps, AI Recs) - Frontend: BrainstormButton (visible at 3+ words, GSC connect overlay) - Wire BrainstormButton into ManualResearchForm and ResearchAction - Add blog_writer to gsc_auth router features for ALWRITY_ENABLED_FEATURES
This commit is contained in:
ajaysi
285
docs-site/docs/features/seo-dashboard/ai-copilot.md
Normal file
285
docs-site/docs/features/seo-dashboard/ai-copilot.md
Normal file
@@ -0,0 +1,285 @@
|
||||
# AI Copilot Assistant Guide
|
||||
|
||||
## 🤖 Overview
|
||||
|
||||
The ALwrity AI Copilot is a conversational AI assistant powered by CopilotKit and Google Gemini LLM. It provides intelligent, context-aware SEO recommendations using natural language interaction.
|
||||
|
||||
## Key Features
|
||||
|
||||
### Conversational Interface
|
||||
- **Natural Language**: Ask questions in plain English
|
||||
- **Context Aware**: Understands your SEO data and goals
|
||||
- **Multi-Turn**: Continuous conversation for detailed guidance
|
||||
- **Smart Suggestions**: Recommendations based on your analysis
|
||||
|
||||
### Capabilities
|
||||
|
||||
#### Analysis Interpretation
|
||||
Ask the Copilot to explain your analysis results:
|
||||
- "What does my health score of 75 mean?"
|
||||
- "Why is my mobile speed score low?"
|
||||
- "Which critical issues should I focus on first?"
|
||||
|
||||
#### Actionable Recommendations
|
||||
Get specific guidance:
|
||||
- "How can I improve my Core Web Vitals?"
|
||||
- "What's the best strategy to increase rankings?"
|
||||
- "Should I focus on content or technical SEO?"
|
||||
|
||||
#### Tool Guidance
|
||||
Get help using the right tools:
|
||||
- "Which tool should I use for my product pages?"
|
||||
- "How do I set up competitor analysis?"
|
||||
- "What's the best way to optimize my images?"
|
||||
|
||||
#### Strategic Planning
|
||||
Get strategic insights:
|
||||
- "What's my content strategy should be?"
|
||||
- "How do I compare to my competitors?"
|
||||
- "What content opportunities am I missing?"
|
||||
|
||||
---
|
||||
|
||||
## How to Use the AI Copilot
|
||||
|
||||
### Starting a Conversation
|
||||
|
||||
1. **Open the Copilot Panel** - Click the AI Copilot icon in your dashboard
|
||||
2. **Ask Your Question** - Type in natural language
|
||||
3. **Provide Context** - Mention your URL or industry if relevant
|
||||
4. **Wait for Response** - Copilot analyzes your data and responds
|
||||
|
||||
### Example Conversations
|
||||
|
||||
#### Example 1: Improving Performance
|
||||
```
|
||||
You: "My PageSpeed score is 65. How do I improve it?"
|
||||
Copilot: "A score of 65 indicates moderate performance issues.
|
||||
Here are the priority actions:
|
||||
1. Optimize images (biggest impact)
|
||||
2. Enable compression
|
||||
3. Reduce JavaScript
|
||||
I recommend using our PageSpeed Analyzer tool to get specific recommendations."
|
||||
```
|
||||
|
||||
#### Example 2: Content Strategy
|
||||
```
|
||||
You: "I want to improve my content strategy. Where should I start?"
|
||||
Copilot: "Based on your domain analysis, I recommend:
|
||||
1. Run Content Strategy Analyzer to find gaps
|
||||
2. Analyze competitors with Sitemap Analyzer
|
||||
3. Focus on topics with high search volume and low competition
|
||||
4. Create content clusters around your main topics
|
||||
Your current gap is around long-tail keywords - that's an opportunity!"
|
||||
```
|
||||
|
||||
#### Example 3: Technical Issues
|
||||
```
|
||||
You: "I have crawl errors. What should I do?"
|
||||
Copilot: "Crawl errors need immediate attention. Use the Technical SEO Analyzer to:
|
||||
1. Identify the specific errors
|
||||
2. Prioritize by severity
|
||||
3. Fix 4xx errors (broken pages)
|
||||
4. Then address 5xx errors
|
||||
Let me show you how to set it up."
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Copilot Quick Commands
|
||||
|
||||
### Analysis Help
|
||||
- "Explain my health score"
|
||||
- "What are my biggest SEO issues?"
|
||||
- "How do I read this analysis?"
|
||||
- "What's my score breakdown?"
|
||||
|
||||
### Tool Recommendations
|
||||
- "Which tool should I use for X?"
|
||||
- "How do I set up Y?"
|
||||
- "What's the difference between X and Y?"
|
||||
- "Is my analysis complete?"
|
||||
|
||||
### Strategic Guidance
|
||||
- "What should I focus on?"
|
||||
- "How do I beat my competitors?"
|
||||
- "Should I prioritize content or technical SEO?"
|
||||
- "What's my content strategy?"
|
||||
|
||||
### Performance Tracking
|
||||
- "How have I improved?"
|
||||
- "What's my trend?"
|
||||
- "Am I on track to my goals?"
|
||||
- "Where am I vs competitors?"
|
||||
|
||||
---
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Ask Specific Questions
|
||||
❌ "My SEO is bad"
|
||||
✅ "My health score is 62. What are the most important improvements?"
|
||||
|
||||
### Provide Context
|
||||
❌ "How do I improve?"
|
||||
✅ "I'm an e-commerce site selling shoes. How should I improve my SEO?"
|
||||
|
||||
### Use in Combination
|
||||
- Ask Copilot for guidance
|
||||
- Run the recommended tool
|
||||
- Return to Copilot with results for next steps
|
||||
|
||||
### Regular Check-ins
|
||||
- Weekly: Ask about your progress
|
||||
- Monthly: Ask for strategic planning
|
||||
- Quarterly: Ask about competitive positioning
|
||||
|
||||
---
|
||||
|
||||
## Copilot Context
|
||||
|
||||
The Copilot has access to:
|
||||
- ✅ Your SEO analysis data
|
||||
- ✅ Your health score and metrics
|
||||
- ✅ Your platform integrations (GSC, GA4, Bing)
|
||||
- ✅ Your competitor analysis
|
||||
- ✅ Your content strategy
|
||||
- ✅ Your historical data and trends
|
||||
|
||||
### What Copilot Can Do
|
||||
- Explain your SEO data
|
||||
- Recommend tools and strategies
|
||||
- Prioritize actions
|
||||
- Guide you through processes
|
||||
- Suggest competitive opportunities
|
||||
- Help interpret results
|
||||
|
||||
### What Copilot Cannot Do
|
||||
- Directly modify your website
|
||||
- Access external websites (use analysis tools)
|
||||
- Execute fixes automatically
|
||||
- Guarantee specific ranking improvements
|
||||
- Replace professional SEO consulting
|
||||
|
||||
---
|
||||
|
||||
## Advanced Use Cases
|
||||
|
||||
### For Content Creators
|
||||
"I'm writing a blog post about digital marketing. How should I optimize it for SEO?"
|
||||
|
||||
Copilot will recommend:
|
||||
- Target keywords to use
|
||||
- Optimal content length
|
||||
- Structure recommendations
|
||||
- Meta tags to create
|
||||
- Image optimization tips
|
||||
|
||||
### For Digital Marketers
|
||||
"How should I structure my content strategy for the next quarter?"
|
||||
|
||||
Copilot will analyze:
|
||||
- Current content gaps
|
||||
- Competitor opportunities
|
||||
- Keyword opportunities
|
||||
- Content distribution
|
||||
- Publishing calendar recommendations
|
||||
|
||||
### For SEO Professionals
|
||||
"I need to improve rankings for high-value keywords. What's my strategy?"
|
||||
|
||||
Copilot will recommend:
|
||||
- On-page optimization priorities
|
||||
- Technical SEO improvements
|
||||
- Link building opportunities
|
||||
- Content expansion ideas
|
||||
- Competitive positioning tactics
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Copilot Seems Inaccurate
|
||||
- Ensure you've run recent analysis
|
||||
- Provide more specific context
|
||||
- Try rephrasing your question
|
||||
- Run a tool to get more data
|
||||
|
||||
### Not Getting Useful Recommendations
|
||||
- Provide your URL or industry
|
||||
- Mention your goals
|
||||
- Ask follow-up questions
|
||||
- Check the recommended tool for more details
|
||||
|
||||
### Copilot Isn't Responding
|
||||
- Check your internet connection
|
||||
- Try refreshing the dashboard
|
||||
- Start a new conversation
|
||||
- Clear your browser cache
|
||||
|
||||
---
|
||||
|
||||
## Tips for Best Results
|
||||
|
||||
1. **Be Specific**: Include URLs, metrics, or goals
|
||||
2. **Ask Follow-ups**: "Tell me more about..." or "How do I...?"
|
||||
3. **Provide Context**: Mention your industry or goals
|
||||
4. **Use Tool Names**: "Use the PageSpeed Analyzer to..."
|
||||
5. **Ask for Priorities**: "What should I focus on first?"
|
||||
|
||||
---
|
||||
|
||||
## Integration with Other Tools
|
||||
|
||||
The Copilot works seamlessly with:
|
||||
- **Health Score**: "Explain my score"
|
||||
- **Analysis Tools**: "Use the Technical SEO tool"
|
||||
- **Competitive Analysis**: "How do I compare?"
|
||||
- **Content Strategy**: "Plan my content"
|
||||
- **Blog Writer**: "Optimize this page"
|
||||
|
||||
---
|
||||
|
||||
## Example Workflows
|
||||
|
||||
### Weekly SEO Review
|
||||
```
|
||||
1. Ask: "What's my latest health score?"
|
||||
2. Ask: "Should I run any new analysis?"
|
||||
3. Ask: "What are my top priorities this week?"
|
||||
4. Use recommended tools
|
||||
5. Ask: "How did I improve?"
|
||||
```
|
||||
|
||||
### Content Planning
|
||||
```
|
||||
1. Ask: "What content opportunities do I have?"
|
||||
2. Use Content Strategy Analyzer (recommended)
|
||||
3. Ask: "Which topics should I prioritize?"
|
||||
4. Ask: "What keywords should I target?"
|
||||
5. Get recommendations for each piece of content
|
||||
```
|
||||
|
||||
### Competitive Analysis
|
||||
```
|
||||
1. Ask: "How do I compare to competitors?"
|
||||
2. Use Competitive Analysis tool
|
||||
3. Ask: "What's my competitive advantage?"
|
||||
4. Ask: "Where am I behind?"
|
||||
5. Get actionable improvement strategies
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Getting Help
|
||||
|
||||
The AI Copilot is always ready to help with:
|
||||
- **How-to questions** - "How do I...?"
|
||||
- **Explanation requests** - "Explain my..."
|
||||
- **Recommendations** - "What should I...?"
|
||||
- **Prioritization** - "What's most important?"
|
||||
- **Guidance** - "Guide me through..."
|
||||
|
||||
---
|
||||
|
||||
**Pro Tip**: The more specific you are with your questions and the more context you provide, the better and more actionable the Copilot's recommendations will be!
|
||||
427
docs-site/docs/features/seo-dashboard/competitive-analysis.md
Normal file
427
docs-site/docs/features/seo-dashboard/competitive-analysis.md
Normal file
@@ -0,0 +1,427 @@
|
||||
# Competitive Analysis Guide
|
||||
|
||||
## 🏆 Overview
|
||||
|
||||
ALwrity's Competitive Analysis tools help you understand your market position, discover opportunities, and stay ahead of competitors. Using Exa API semantic search and advanced analysis, you can benchmark your content, identify gaps, and develop winning strategies.
|
||||
|
||||
## 🎯 What You Can Do
|
||||
|
||||
### Competitor Discovery
|
||||
- Find direct and indirect competitors
|
||||
- Analyze competitor content strategies
|
||||
- Discover emerging threats
|
||||
- Identify market leaders
|
||||
|
||||
### Content Benchmarking
|
||||
- Compare content volume and structure
|
||||
- Analyze publishing frequency
|
||||
- Identify content gaps
|
||||
- Find topic opportunities
|
||||
|
||||
### Market Positioning
|
||||
- Compare keyword strategies
|
||||
- Analyze competitive advantages
|
||||
- Identify market opportunities
|
||||
- Benchmark performance metrics
|
||||
|
||||
### Strategic Insights
|
||||
- Deep competitive analysis
|
||||
- Market positioning assessment
|
||||
- Weakness identification
|
||||
- Opportunity detection
|
||||
|
||||
---
|
||||
|
||||
## Competitive Analysis Tools
|
||||
|
||||
### 1. 🏆 Competitive Analysis Tool
|
||||
**Purpose**: Discover and analyze your competition
|
||||
|
||||
**Features**:
|
||||
- Competitor discovery using Exa API
|
||||
- Content analysis across competitors
|
||||
- Benchmarking metrics
|
||||
- Market positioning insights
|
||||
|
||||
**Use When**:
|
||||
- Starting SEO strategy
|
||||
- Quarterly competitive review
|
||||
- Entering new market
|
||||
- Launching new content area
|
||||
|
||||
**Output**:
|
||||
```json
|
||||
{
|
||||
"competitors": [
|
||||
{
|
||||
"url": "competitor.com",
|
||||
"trust_score": 85,
|
||||
"content_volume": 450,
|
||||
"publishing_frequency": "3x/week",
|
||||
"strengths": ["Blog authority", "Video content"],
|
||||
"weaknesses": ["Mobile UX", "Page speed"]
|
||||
}
|
||||
],
|
||||
"market_position": "challenger",
|
||||
"opportunities": ["Video content", "Technical content"],
|
||||
"threats": ["Competitor launching premium tier"]
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 📊 Sitemap Benchmarking
|
||||
**Purpose**: Compare content structure with competitors
|
||||
|
||||
**Features**:
|
||||
- Automatic competitor discovery
|
||||
- Sitemap structure comparison
|
||||
- Content distribution analysis
|
||||
- Publishing velocity comparison
|
||||
|
||||
**Metrics Analyzed**:
|
||||
- Total URLs
|
||||
- Content distribution by type
|
||||
- Publishing frequency
|
||||
- URL depth and structure
|
||||
- Content freshness
|
||||
|
||||
**Use When**:
|
||||
- Planning content strategy
|
||||
- Benchmarking content output
|
||||
- Identifying content gaps
|
||||
- Quarterly competitive review
|
||||
|
||||
**How to Use**:
|
||||
1. Run from SEO Dashboard
|
||||
2. System finds top competitors automatically
|
||||
3. Analyzes sitemaps in background
|
||||
4. Receives comprehensive comparison report
|
||||
|
||||
**Output**:
|
||||
```
|
||||
Competitor Benchmark Report
|
||||
- Your Content: 250 pages (published 2x/week)
|
||||
- Competitor A: 400 pages (published 4x/week)
|
||||
- Competitor B: 320 pages (published 3x/week)
|
||||
Gap: Publishing 1-2x/week behind competitors
|
||||
Opportunity: Increase content production by 25%
|
||||
```
|
||||
|
||||
### 3. 🎭 Deep Competitor Analysis
|
||||
**Purpose**: In-depth competitive intelligence
|
||||
|
||||
**Features**:
|
||||
- Comprehensive competitor profiling
|
||||
- Market positioning analysis
|
||||
- Competitive advantages identification
|
||||
- Weakness analysis
|
||||
|
||||
**Analysis Includes**:
|
||||
- Content strategy analysis
|
||||
- SEO approach comparison
|
||||
- Marketing tactics evaluation
|
||||
- Brand positioning
|
||||
- Target audience alignment
|
||||
|
||||
**Use When**:
|
||||
- Quarterly strategic planning
|
||||
- Competitive threat analysis
|
||||
- Understanding market gaps
|
||||
- Developing differentiation strategy
|
||||
|
||||
### 4. 💬 Strategic Insights
|
||||
**Purpose**: Weekly AI-powered competitive strategy
|
||||
|
||||
**Features**:
|
||||
- Weekly strategy briefs
|
||||
- Competitive insights
|
||||
- Opportunity identification
|
||||
- Action recommendations
|
||||
|
||||
**Delivered**:
|
||||
- Weekly (scheduled emails)
|
||||
- Based on latest competitive data
|
||||
- Prioritized by impact
|
||||
- Actionable recommendations
|
||||
|
||||
**Topics Covered**:
|
||||
- Ranking changes
|
||||
- Competitor moves
|
||||
- Content opportunities
|
||||
- Market trends
|
||||
- Recommended actions
|
||||
|
||||
---
|
||||
|
||||
## How to Use Competitive Analysis
|
||||
|
||||
### Getting Started
|
||||
|
||||
#### Step 1: Identify Competitors
|
||||
1. Go to SEO Dashboard
|
||||
2. Click "Competitive Analysis"
|
||||
3. Enter your main competitors (up to 5)
|
||||
4. Or let system auto-discover competitors
|
||||
|
||||
#### Step 2: Run Analysis
|
||||
1. Select analysis type:
|
||||
- Quick Competitive Overview (5 minutes)
|
||||
- Deep Competitor Analysis (15 minutes)
|
||||
- Sitemap Benchmarking (background, 30+ minutes)
|
||||
2. Click "Analyze"
|
||||
3. View results when complete
|
||||
|
||||
#### Step 3: Review Insights
|
||||
1. Check competitor profiles
|
||||
2. Review market positioning
|
||||
3. Identify opportunities
|
||||
4. Note threats/challenges
|
||||
|
||||
### Weekly Workflow
|
||||
|
||||
```
|
||||
Monday: Review Strategic Insights email
|
||||
Wednesday: Run Competitive Analysis
|
||||
Friday: Update content strategy based on findings
|
||||
```
|
||||
|
||||
### Monthly Workflow
|
||||
|
||||
```
|
||||
1st Week: Deep Competitor Analysis
|
||||
2nd Week: Sitemap Benchmarking
|
||||
3rd Week: Content gap analysis
|
||||
4th Week: Strategic planning session
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Understanding Results
|
||||
|
||||
### Competitive Positioning
|
||||
|
||||
#### Market Positions
|
||||
- **Leader**: #1 market position, highest content volume, strong brand
|
||||
- **Challenger**: Strong position, competing effectively on key topics
|
||||
- **Niche Player**: Specialized position, strong in specific areas
|
||||
- **Emerging**: New player with growing presence
|
||||
|
||||
#### Your Position
|
||||
Based on:
|
||||
- Content volume vs. competitors
|
||||
- Keyword rankings vs. competitors
|
||||
- Publishing frequency
|
||||
- Domain authority
|
||||
- Backlink profile
|
||||
|
||||
### Opportunity Identification
|
||||
|
||||
#### Content Gaps
|
||||
Topics competitors cover but you don't:
|
||||
- **High Priority**: High search volume, competitors ranking well
|
||||
- **Medium Priority**: Moderate search volume, good opportunity
|
||||
- **Low Priority**: Low search volume, lower opportunity
|
||||
|
||||
#### Strength Areas
|
||||
Where you're beating competitors:
|
||||
- Topics you dominate
|
||||
- Keywords you rank for
|
||||
- Content types you excel at
|
||||
- Audience segments you reach
|
||||
|
||||
#### Threat Areas
|
||||
Where competitors are stronger:
|
||||
- Topics they dominate
|
||||
- Keywords you're losing
|
||||
- Publishing frequency gaps
|
||||
- Authority differences
|
||||
|
||||
---
|
||||
|
||||
## Analysis Examples
|
||||
|
||||
### Example 1: Content Strategy Gap
|
||||
```
|
||||
Finding: "Your competitors publish 4x/week, you publish 1x/week"
|
||||
Analysis:
|
||||
- Competitor A: 400 posts, 4x/week publishing
|
||||
- You: 100 posts, 1x/week publishing
|
||||
- Gap: 3x behind on content output
|
||||
Recommendation:
|
||||
- Increase publishing to 2-3x/week
|
||||
- Focus on high-opportunity topics
|
||||
- Consider guest posts/syndication
|
||||
```
|
||||
|
||||
### Example 2: Topic Gap
|
||||
```
|
||||
Finding: "Competitors rank for 'advanced SEO tactics', you don't"
|
||||
Analysis:
|
||||
- Competitor A ranks #2 for keyword
|
||||
- Competitor B ranks #5 for keyword
|
||||
- You: Not in top 10
|
||||
- Search volume: 5,000/month
|
||||
- Difficulty: Medium
|
||||
Recommendation:
|
||||
- Create comprehensive guide on topic
|
||||
- Target related long-tail keywords
|
||||
- Build internal links to new content
|
||||
```
|
||||
|
||||
### Example 3: Competitive Threat
|
||||
```
|
||||
Finding: "New competitor launched last month, ranking fast"
|
||||
Analysis:
|
||||
- Competitor C: Launched 30 days ago
|
||||
- Already ranking for 50 keywords
|
||||
- Average position: #8
|
||||
- Topics: Overlap with your main areas
|
||||
Recommendation:
|
||||
- Monitor closely for rank drops
|
||||
- Strengthen authority on key topics
|
||||
- Consider direct comparison content
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Regular Monitoring
|
||||
- ✅ Check weekly strategic insights
|
||||
- ✅ Run deep analysis monthly
|
||||
- ✅ Update competitive data quarterly
|
||||
- ✅ Review opportunities regularly
|
||||
|
||||
### Acting on Insights
|
||||
1. **Identify Opportunities** - Find high-priority gaps
|
||||
2. **Prioritize** - Focus on high-impact opportunities
|
||||
3. **Plan Content** - Create strategic content plan
|
||||
4. **Execute** - Produce and optimize content
|
||||
5. **Monitor** - Track improvements
|
||||
|
||||
### Avoiding Mistakes
|
||||
- ❌ Don't copy competitor content
|
||||
- ❌ Don't ignore emerging competitors
|
||||
- ❌ Don't focus only on weak competitors
|
||||
- ❌ Don't neglect your strengths
|
||||
- ✅ Focus on your unique value proposition
|
||||
- ✅ Learn from competitors, don't copy
|
||||
- ✅ Build sustainable advantages
|
||||
|
||||
---
|
||||
|
||||
## Advanced Tactics
|
||||
|
||||
### Finding New Competitors
|
||||
Using the Competitive Analysis tool:
|
||||
1. Enter your main keywords
|
||||
2. Review top 10 ranking sites
|
||||
3. Analyze which are direct competitors
|
||||
4. Identify emerging threats
|
||||
|
||||
### Content Benchmarking Strategy
|
||||
1. Identify competitor's top content
|
||||
2. Analyze what makes it successful
|
||||
3. Create better/updated version
|
||||
4. Build more internal links
|
||||
5. Optimize aggressively
|
||||
|
||||
### Opportunity Prioritization
|
||||
Score opportunities by:
|
||||
- Search volume (higher is better)
|
||||
- Keyword difficulty (lower is better)
|
||||
- Commercial intent (varies by business)
|
||||
- Your ability to rank (competitive advantage)
|
||||
- Your content gaps (what you're missing)
|
||||
|
||||
### Market Expansion
|
||||
1. Identify competitor strengths
|
||||
2. Find adjacent opportunities
|
||||
3. Analyze market demand
|
||||
4. Develop expansion strategy
|
||||
5. Create content pillar
|
||||
|
||||
---
|
||||
|
||||
## Competitive Keywords
|
||||
|
||||
### Finding Competitive Keywords
|
||||
|
||||
1. **Rank Tracker Integration** (planned):
|
||||
- Your rankings vs. competitor rankings
|
||||
- Shared keywords
|
||||
- Keywords you're winning
|
||||
- Keywords you're losing
|
||||
|
||||
2. **Gap Analysis**:
|
||||
- Keywords competitors rank for
|
||||
- Keywords you should target
|
||||
- Keywords with highest opportunity
|
||||
|
||||
3. **Opportunity Scoring**:
|
||||
- Potential traffic opportunity
|
||||
- Effort to achieve
|
||||
- Competition level
|
||||
|
||||
---
|
||||
|
||||
## Integration with Other Tools
|
||||
|
||||
### Works With:
|
||||
- **Sitemap Analyzer** - Understand competitor structure
|
||||
- **Content Strategy Tool** - Plan competitive content
|
||||
- **Keyword Research** - Find competitor keywords
|
||||
- **Blog Writer** - Create competitive content
|
||||
- **AI Copilot** - Get strategic recommendations
|
||||
|
||||
### Typical Workflow:
|
||||
```
|
||||
1. Run Competitive Analysis → Get market insights
|
||||
2. Use Content Strategy Tool → Find gaps
|
||||
3. Use Copilot → Get recommendations
|
||||
4. Create content in Blog Writer → Implement strategy
|
||||
5. Track rankings → Measure success
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Questions
|
||||
|
||||
### Q: How often should I run competitive analysis?
|
||||
**A**:
|
||||
- Strategic Insights: Weekly (automatic)
|
||||
- Competitive Analysis: Monthly
|
||||
- Deep Analysis: Quarterly
|
||||
- Sitemap Benchmarking: Quarterly
|
||||
|
||||
### Q: How many competitors should I track?
|
||||
**A**: 3-5 is ideal:
|
||||
- 1-2 direct competitors
|
||||
- 1-2 content competitors
|
||||
- 1 emerging competitor
|
||||
|
||||
### Q: What if I have no competitors?
|
||||
**A**: Everyone has competitors:
|
||||
- Direct: Same products/services
|
||||
- Content: Creating similar content
|
||||
- Audience: Target same audience
|
||||
- Consider: Adjacent markets
|
||||
|
||||
### Q: Can I export the analysis?
|
||||
**A**: Yes, available as:
|
||||
- PDF report
|
||||
- CSV data
|
||||
- API access
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. **Run Your First Analysis**: Go to Competitive Analysis tool
|
||||
2. **Identify Your Competitors**: Add 3-5 top competitors
|
||||
3. **Review the Report**: Understand your market position
|
||||
4. **Make a Plan**: Use findings to guide strategy
|
||||
5. **Take Action**: Implement recommendations
|
||||
|
||||
---
|
||||
|
||||
**Ready to analyze your competition? Start with [Competitive Analysis Tool](../tools-reference.md) or ask the [AI Copilot](ai-copilot.md) for guidance!**
|
||||
466
docs-site/docs/features/seo-dashboard/content-strategy-guide.md
Normal file
466
docs-site/docs/features/seo-dashboard/content-strategy-guide.md
Normal file
@@ -0,0 +1,466 @@
|
||||
# Content Strategy Tool Guide
|
||||
|
||||
## 📊 Overview
|
||||
|
||||
The ALwrity Content Strategy Analyzer helps you identify content gaps, discover opportunities, plan your content calendar, and develop a data-driven content strategy. Using AI analysis and competitive intelligence, you can create content that ranks and converts.
|
||||
|
||||
## 🎯 What You Can Do
|
||||
|
||||
### Content Gap Analysis
|
||||
- Identify topics you're missing
|
||||
- Find competitor content opportunities
|
||||
- Analyze content distribution
|
||||
- Discover emerging trends
|
||||
|
||||
### Opportunity Identification
|
||||
- Score opportunities by potential
|
||||
- Identify high-volume keywords
|
||||
- Find low-competition topics
|
||||
- Discover audience needs
|
||||
|
||||
### Content Planning
|
||||
- Generate topic recommendations
|
||||
- Suggest content types
|
||||
- Plan publishing schedule
|
||||
- Create content clusters
|
||||
|
||||
### Competitive Positioning
|
||||
- Analyze competitor content strategies
|
||||
- Find content advantages
|
||||
- Identify differentiation opportunities
|
||||
- Plan content differentiation
|
||||
|
||||
---
|
||||
|
||||
## Content Strategy Analysis
|
||||
|
||||
### Analysis Components
|
||||
|
||||
#### 1. Content Gaps
|
||||
**What It Shows**:
|
||||
Topics your competitors cover that you don't
|
||||
- Missing high-opportunity topics
|
||||
- Underserved audience needs
|
||||
- Emerging trend areas
|
||||
- Topic clusters without coverage
|
||||
|
||||
**Opportunity Scoring**:
|
||||
- **Search Volume**: Monthly search interest
|
||||
- **Difficulty**: Competition level (easy to hard)
|
||||
- **Opportunity Score**: Combined potential (0-100)
|
||||
- **Recommended Content Types**: Blog, guide, video, etc.
|
||||
|
||||
**Example Output**:
|
||||
```
|
||||
Topic: "Advanced Email Marketing Strategies"
|
||||
- Search Volume: 12,000/month
|
||||
- Difficulty: Medium
|
||||
- Opportunity Score: 82/100
|
||||
- Recommended Types: Blog post, guide, video tutorial
|
||||
- Your Gap: Not in top 20 results
|
||||
- Competitor Ranking: Competitor A #3, B #8
|
||||
```
|
||||
|
||||
#### 2. Content Distribution
|
||||
**What It Shows**:
|
||||
How your content is distributed across types and topics
|
||||
- Blog posts vs. pages vs. guides
|
||||
- Topic distribution
|
||||
- Content depth analysis
|
||||
- Content freshness
|
||||
|
||||
**Comparison**:
|
||||
- Your distribution vs. competitors
|
||||
- Underserved content types
|
||||
- Overexposed areas
|
||||
- Rebalancing recommendations
|
||||
|
||||
#### 3. Publishing Velocity
|
||||
**What It Shows**:
|
||||
How frequently you and competitors publish
|
||||
- Your publishing rate (posts/week)
|
||||
- Competitor rates
|
||||
- Trend over time
|
||||
- Recommendations for optimal frequency
|
||||
|
||||
**Analysis**:
|
||||
- Are you publishing enough?
|
||||
- Publishing frequency trends
|
||||
- Recommended increase/decrease
|
||||
- Content quality vs. quantity balance
|
||||
|
||||
#### 4. Competitive Content Analysis
|
||||
**What It Shows**:
|
||||
What content your competitors are creating successfully
|
||||
- Their top-performing topics
|
||||
- Content types they excel at
|
||||
- Content gaps in their strategy
|
||||
- Differentiation opportunities
|
||||
|
||||
---
|
||||
|
||||
## How to Use the Content Strategy Tool
|
||||
|
||||
### Getting Started
|
||||
|
||||
#### Step 1: Run the Analysis
|
||||
1. Go to **Content Strategy Analyzer**
|
||||
2. Enter your website URL
|
||||
3. Add competitors (optional)
|
||||
4. Click **"Analyze Content Strategy"**
|
||||
5. Wait for analysis to complete (5-10 minutes)
|
||||
|
||||
#### Step 2: Review the Report
|
||||
The report includes:
|
||||
- **Executive Summary**: Key findings and opportunities
|
||||
- **Content Gaps**: Top 10 high-opportunity topics
|
||||
- **Gap Analysis**: Missing topics with scoring
|
||||
- **Competitive Positioning**: How you compare
|
||||
- **Recommendations**: Specific action items
|
||||
|
||||
#### Step 3: Make a Plan
|
||||
1. Identify top 3-5 opportunities
|
||||
2. Assign priorities
|
||||
3. Plan content calendar
|
||||
4. Assign ownership
|
||||
5. Set timelines
|
||||
|
||||
### Example Workflow
|
||||
|
||||
```
|
||||
Monday: Run content strategy analysis
|
||||
Tuesday: Review findings, identify top 10 opportunities
|
||||
Wednesday: Select top 5, create content briefs
|
||||
Thursday: Assign to team members
|
||||
Friday: Plan publishing schedule
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Understanding Your Results
|
||||
|
||||
### Opportunity Scores
|
||||
|
||||
#### Scoring Breakdown
|
||||
- **0-20**: Low opportunity (low volume, high competition)
|
||||
- **21-40**: Moderate opportunity (niche topics)
|
||||
- **41-60**: Good opportunity (decent volume, moderate competition)
|
||||
- **61-80**: High opportunity (strong volume, manageable competition)
|
||||
- **81-100**: Excellent opportunity (high volume, low competition)
|
||||
|
||||
#### What Affects Scoring
|
||||
1. **Search Volume** (40%) - Higher is better
|
||||
2. **Competition** (30%) - Lower difficulty is better
|
||||
3. **Relevance** (20%) - Match to your audience
|
||||
4. **Trend** (10%) - Rising trends get bonus points
|
||||
|
||||
### Gap Types
|
||||
|
||||
#### Topic Gaps
|
||||
Missing entire topics competitors cover:
|
||||
- **Complete Gap**: Neither you nor competitors are strong
|
||||
- **Competitive Gap**: Competitors strong, you weak
|
||||
- **Emerging Gap**: New trend both miss
|
||||
|
||||
#### Content Type Gaps
|
||||
Missing specific content formats:
|
||||
- Blog posts (if competitors have videos)
|
||||
- Case studies (if missing examples)
|
||||
- Interactive content (if all text)
|
||||
- Video content (if no video)
|
||||
|
||||
#### Topic Cluster Gaps
|
||||
Missing clusters of related content:
|
||||
- Competitors have cluster, you don't
|
||||
- Cluster has high search volume
|
||||
- Your audience likely interested
|
||||
- Quick win opportunity
|
||||
|
||||
---
|
||||
|
||||
## Content Planning
|
||||
|
||||
### Creating Your Plan
|
||||
|
||||
#### Step 1: Prioritize Opportunities
|
||||
Score each gap:
|
||||
- **Impact Score**: Potential traffic gain (0-100)
|
||||
- **Effort Score**: Time/resources needed (0-100)
|
||||
- **Priority**: Impact ÷ Effort (higher = better)
|
||||
|
||||
#### Step 2: Plan Content
|
||||
For each top opportunity:
|
||||
1. **Topic**: Clear, specific title
|
||||
2. **Keywords**: Primary + secondary keywords
|
||||
3. **Type**: Blog, guide, video, etc.
|
||||
4. **Length**: Recommended word count
|
||||
5. **Timeline**: When to publish
|
||||
|
||||
#### Step 3: Create Clusters
|
||||
Group related content:
|
||||
- **Pillar**: Main topic (comprehensive guide)
|
||||
- **Cluster**: Supporting topics (detailed guides)
|
||||
- **Resources**: Additional materials
|
||||
|
||||
#### Step 4: Publish & Optimize
|
||||
1. Create content
|
||||
2. Optimize for keywords
|
||||
3. Build internal links
|
||||
4. Publish on schedule
|
||||
5. Promote on social
|
||||
|
||||
### Example Plan
|
||||
|
||||
```
|
||||
Pillar Topic: "Email Marketing Strategy"
|
||||
- Pillar Content: Complete guide (5,000+ words)
|
||||
|
||||
Cluster Topics:
|
||||
1. Email Segmentation (2,000 words)
|
||||
2. Email Automation (2,000 words)
|
||||
3. A/B Testing Emails (1,500 words)
|
||||
4. Email Personalization (1,500 words)
|
||||
|
||||
Supporting Resources:
|
||||
- Email templates (downloadable)
|
||||
- Best practices checklist
|
||||
- Tools comparison guide
|
||||
- Case study example
|
||||
|
||||
Timeline:
|
||||
- Pillar: Week 1
|
||||
- Cluster 1-2: Week 2-3
|
||||
- Cluster 3-4: Week 4-5
|
||||
- Resources: Week 6
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Advanced Analysis
|
||||
|
||||
### Content Type Recommendations
|
||||
|
||||
The tool recommends optimal content types based on:
|
||||
- Your audience preferences
|
||||
- Topic characteristics
|
||||
- Competitor strategies
|
||||
- Search intent
|
||||
- Engagement potential
|
||||
|
||||
#### Typical Recommendations
|
||||
- **Blog Post**: General informational topics
|
||||
- **Comprehensive Guide**: In-depth, authoritative topics
|
||||
- **How-To Guide**: Procedural, step-by-step topics
|
||||
- **Tutorial**: Technical, complex topics
|
||||
- **Case Study**: Implementation, real-world examples
|
||||
- **Video**: Visual, demonstration topics
|
||||
- **Infographic**: Data, comparison topics
|
||||
- **Checklist**: Action-oriented topics
|
||||
|
||||
### Topic Clustering
|
||||
|
||||
The tool identifies natural clusters:
|
||||
- **Related Topics**: Naturally grouped topics
|
||||
- **Pillar Content**: Main comprehensive topic
|
||||
- **Supporting Content**: Detailed subtopics
|
||||
- **Internal Linking**: Connection strategy
|
||||
|
||||
### Trend Analysis
|
||||
|
||||
Identifies emerging trends:
|
||||
- **Rising Trends**: Topics gaining search interest
|
||||
- **Seasonal Topics**: Cyclical content opportunities
|
||||
- **Declining Trends**: Topics losing interest
|
||||
- **Timeless Topics**: Evergreen, stable content
|
||||
|
||||
---
|
||||
|
||||
## Content Calendar
|
||||
|
||||
### Planning Your Calendar
|
||||
|
||||
#### Monthly Planning
|
||||
1. Identify high-priority topics
|
||||
2. Assign to weeks
|
||||
3. Include supporting content
|
||||
4. Plan promotions
|
||||
|
||||
#### Quarterly Planning
|
||||
1. Set content themes
|
||||
2. Plan pillar topics
|
||||
3. Map cluster topics
|
||||
4. Set KPIs
|
||||
|
||||
#### Annual Planning
|
||||
1. Define content strategy
|
||||
2. Plan seasonal content
|
||||
3. Set annual goals
|
||||
4. Identify growth areas
|
||||
|
||||
### Example Calendar
|
||||
|
||||
```
|
||||
Month 1: Foundation
|
||||
- Pillar: "Complete SEO Guide" (Week 1)
|
||||
- Cluster: "Keyword Research" (Week 2)
|
||||
- Cluster: "On-Page SEO" (Week 3)
|
||||
- Update: Refresh old posts (Week 4)
|
||||
|
||||
Month 2: Building
|
||||
- Cluster: "Technical SEO" (Week 1)
|
||||
- Cluster: "Link Building" (Week 2)
|
||||
- Supporting: Templates & Tools (Week 3)
|
||||
- Promotion: Webinar, social (Week 4)
|
||||
|
||||
Month 3: Expansion
|
||||
- Cluster: "Content Strategy" (Week 1)
|
||||
- Case Study: Success story (Week 2)
|
||||
- Competitive: Competitor comparison (Week 3)
|
||||
- Review: Monthly analytics (Week 4)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Planning Best Practices
|
||||
1. ✅ Start with high-opportunity topics
|
||||
2. ✅ Balance content types
|
||||
3. ✅ Create content clusters
|
||||
4. ✅ Plan 2-3 months ahead
|
||||
5. ✅ Include supporting content
|
||||
|
||||
### Content Creation Best Practices
|
||||
1. ✅ Research thoroughly before writing
|
||||
2. ✅ Optimize for primary + secondary keywords
|
||||
3. ✅ Build internal links to relevant content
|
||||
4. ✅ Include multimedia (images, videos)
|
||||
5. ✅ Update older content regularly
|
||||
|
||||
### Publishing Best Practices
|
||||
1. ✅ Maintain consistent schedule
|
||||
2. ✅ Promote on social media
|
||||
3. ✅ Build backlinks
|
||||
4. ✅ Monitor rankings
|
||||
5. ✅ Update based on performance
|
||||
|
||||
---
|
||||
|
||||
## Common Mistakes to Avoid
|
||||
|
||||
### Planning Mistakes
|
||||
- ❌ Picking only easy topics (low competition often = low volume)
|
||||
- ❌ Ignoring your audience needs
|
||||
- ❌ Publishing too infrequently
|
||||
- ❌ Creating isolated posts (no strategy)
|
||||
- ❌ Copying competitor content
|
||||
|
||||
### Execution Mistakes
|
||||
- ❌ Publishing without optimization
|
||||
- ❌ Forgetting internal linking
|
||||
- ❌ Neglecting images/multimedia
|
||||
- ❌ Not tracking performance
|
||||
- ❌ Giving up too quickly
|
||||
|
||||
### Strategy Mistakes
|
||||
- ❌ Only pursuing quick wins
|
||||
- ❌ Ignoring competitor moves
|
||||
- ❌ Not updating old content
|
||||
- ❌ Focusing only on rankings
|
||||
- ❌ Missing audience trends
|
||||
|
||||
---
|
||||
|
||||
## Integration with Other Tools
|
||||
|
||||
### Works With:
|
||||
- **Blog Writer** - Create planned content
|
||||
- **Metadata Generator** - Optimize titles/descriptions
|
||||
- **On-Page SEO** - Optimize created content
|
||||
- **Competitive Analysis** - Understand competitor strategy
|
||||
- **AI Copilot** - Get strategic recommendations
|
||||
|
||||
### Typical Workflow:
|
||||
```
|
||||
1. Content Strategy Tool → Identify opportunities
|
||||
2. AI Copilot → Get recommendations
|
||||
3. Blog Writer → Create content
|
||||
4. On-Page SEO → Optimize content
|
||||
5. SEO Dashboard → Track rankings
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Measuring Success
|
||||
|
||||
### Key Metrics to Track
|
||||
|
||||
#### Traffic Metrics
|
||||
- Organic traffic to new content
|
||||
- Traffic by content type
|
||||
- Traffic growth trend
|
||||
- Pages per session
|
||||
|
||||
#### Ranking Metrics
|
||||
- New keyword rankings
|
||||
- Ranking improvements
|
||||
- Top 10 positions
|
||||
- Rank 1 positions
|
||||
|
||||
#### Engagement Metrics
|
||||
- Average time on page
|
||||
- Bounce rate
|
||||
- Click-through rate
|
||||
- Social shares
|
||||
|
||||
#### Conversion Metrics
|
||||
- Leads from content
|
||||
- Sales from content
|
||||
- Cost per acquisition
|
||||
- Content ROI
|
||||
|
||||
### Measuring ROI
|
||||
|
||||
```
|
||||
Content ROI = (Revenue from Content - Content Cost) / Content Cost
|
||||
|
||||
Example:
|
||||
- 10 articles created = $5,000 cost
|
||||
- Generated $25,000 in revenue
|
||||
- ROI = ($25,000 - $5,000) / $5,000 = 400%
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. **Run Analysis**: Execute Content Strategy Analysis
|
||||
2. **Review Findings**: Understand your opportunities
|
||||
3. **Make Plan**: Create 90-day content calendar
|
||||
4. **Get Help**: Ask AI Copilot for recommendations
|
||||
5. **Create Content**: Use Blog Writer to create planned content
|
||||
6. **Optimize**: Use On-Page SEO to optimize
|
||||
7. **Track**: Monitor rankings and traffic
|
||||
|
||||
---
|
||||
|
||||
## Common Questions
|
||||
|
||||
### Q: How often should I run analysis?
|
||||
**A**: Monthly for active strategies, quarterly minimum
|
||||
|
||||
### Q: How many opportunities should I pursue?
|
||||
**A**: Start with top 5-10, one at a time
|
||||
|
||||
### Q: How long before I see results?
|
||||
**A**: 4-8 weeks for rankings, 8-12 weeks for traffic
|
||||
|
||||
### Q: Should I ignore easy topics?
|
||||
**A**: No! Include 20% easy wins, 80% strategic growth
|
||||
|
||||
### Q: Can I modify recommendations?
|
||||
**A**: Absolutely! Use them as guidance, not requirements
|
||||
|
||||
---
|
||||
|
||||
**Ready to plan your content strategy? Start with [Content Strategy Analyzer](tools-reference.md) or ask [AI Copilot](ai-copilot.md) for help!**
|
||||
345
docs-site/docs/features/seo-dashboard/index.md
Normal file
345
docs-site/docs/features/seo-dashboard/index.md
Normal file
@@ -0,0 +1,345 @@
|
||||
# SEO Dashboard Complete Documentation Index
|
||||
|
||||
Welcome to ALwrity's complete SEO Dashboard documentation. This index helps you find exactly what you need.
|
||||
|
||||
---
|
||||
|
||||
## 📚 Find What You Need
|
||||
|
||||
### 🆕 Just Getting Started?
|
||||
Start here to get up and running quickly:
|
||||
- **[Quick Start Guide](quick-start.md)** - Get optimizing in 10 minutes
|
||||
- **[Overview](overview.md)** - Understand the dashboard
|
||||
- **[Tools Reference](tools-reference.md)** - See all 21 tools at a glance
|
||||
|
||||
### 🛠️ Want to Learn Individual Tools?
|
||||
Each tool has a detailed guide:
|
||||
- **[Individual Tools Guide](individual-tools-guide.md)** - Complete guide to all 9 core tools:
|
||||
- Meta Description Generator
|
||||
- PageSpeed Analyzer
|
||||
- Sitemap Analyzer
|
||||
- Image Alt Text Generator
|
||||
- OpenGraph Generator
|
||||
- On-Page SEO Analyzer
|
||||
- Technical SEO Analyzer
|
||||
- Enterprise SEO Suite
|
||||
- Content Strategy Analyzer
|
||||
|
||||
### 📋 Ready to Create Workflows?
|
||||
Learn proven workflows and processes:
|
||||
- **[Workflows & Automation Guide](workflows-guide.md)** - 10+ real-world workflows:
|
||||
- Content Creation Pipeline
|
||||
- Website Audit & Improvement
|
||||
- Performance Optimization
|
||||
- Monthly SEO Maintenance
|
||||
- Industry-Specific Workflows
|
||||
- Quick Wins Strategy
|
||||
- Collaborative Team Workflows
|
||||
- Time-Based Workflows
|
||||
|
||||
### 🤖 Want AI Recommendations?
|
||||
Get strategic help from our AI:
|
||||
- **[AI Copilot Guide](ai-copilot.md)** - Learn to use conversational AI:
|
||||
- How to ask for recommendations
|
||||
- Content strategy help
|
||||
- Tool usage guidance
|
||||
- Problem solving with AI
|
||||
- Example conversations
|
||||
- Advanced use cases
|
||||
|
||||
### 🏆 Doing Competitive Research?
|
||||
Benchmark against competitors:
|
||||
- **[Competitive Analysis Guide](competitive-analysis.md)** - Understand your market:
|
||||
- Competitor discovery
|
||||
- Content benchmarking
|
||||
- Technical comparison
|
||||
- Opportunity identification
|
||||
- Market positioning strategies
|
||||
- Differentiation tactics
|
||||
|
||||
### 📝 Planning Content Strategy?
|
||||
Find content opportunities and plan:
|
||||
- **[Content Strategy Guide](content-strategy-guide.md)** - Plan your content:
|
||||
- Finding content gaps
|
||||
- Scoring opportunities
|
||||
- Building content clusters
|
||||
- Planning publishing calendar
|
||||
- Measuring ROI
|
||||
|
||||
### 🏷️ Learning About Metadata?
|
||||
Master SEO metadata:
|
||||
- **[Metadata Generation Guide](metadata.md)** - Complete metadata reference:
|
||||
- Meta descriptions
|
||||
- OpenGraph tags
|
||||
- Title tag optimization
|
||||
- Twitter cards
|
||||
- Schema markup
|
||||
- Structured data
|
||||
|
||||
### 🔗 Need GSC Integration Info?
|
||||
Connect your Google Search Console:
|
||||
- **[GSC Integration Guide](gsc-integration.md)** - Setup and usage
|
||||
|
||||
### 📐 Want Technical Details?
|
||||
Deep technical reference:
|
||||
- **[Design Document](design-document.md)** - Architecture and technical specs
|
||||
|
||||
---
|
||||
|
||||
## 📖 Documentation by Use Case
|
||||
|
||||
### For Content Creators
|
||||
**Goal**: Create great content that ranks
|
||||
|
||||
**Recommended Reading Order**:
|
||||
1. [Quick Start Guide](quick-start.md) - 10 min
|
||||
2. [Meta Description Generator](individual-tools-guide.md#1--meta-description-generator) - 5 min
|
||||
3. [On-Page SEO Analyzer](individual-tools-guide.md#6--on-page-seo-analyzer) - 10 min
|
||||
4. [Content Strategy Analyzer](individual-tools-guide.md#9--content-strategy-analyzer) - 10 min
|
||||
5. [Content Creation Workflow](workflows-guide.md#workflow-1-content-creation-pipeline) - 5 min
|
||||
|
||||
**Total Learning Time**: 40 minutes
|
||||
**First Task**: Create one optimized article
|
||||
|
||||
---
|
||||
|
||||
### For Digital Marketers
|
||||
**Goal**: Improve organic traffic and rankings
|
||||
|
||||
**Recommended Reading Order**:
|
||||
1. [Quick Start Guide](quick-start.md) - 10 min
|
||||
2. [Tools Reference](tools-reference.md) - 15 min
|
||||
3. [Competitive Analysis Guide](competitive-analysis.md) - 20 min
|
||||
4. [Content Strategy Guide](content-strategy-guide.md) - 30 min
|
||||
5. [Workflows & Automation](workflows-guide.md) - 30 min
|
||||
|
||||
**Total Learning Time**: 1.5-2 hours
|
||||
**First Task**: Run competitive analysis
|
||||
|
||||
---
|
||||
|
||||
### For SEO Professionals
|
||||
**Goal**: Comprehensive SEO optimization
|
||||
|
||||
**Recommended Reading Order**:
|
||||
1. [Overview](overview.md) - 10 min
|
||||
2. [Tools Reference](tools-reference.md) - 20 min
|
||||
3. [Individual Tools Guide](individual-tools-guide.md) - 45 min
|
||||
4. [Workflows & Automation](workflows-guide.md) - 45 min
|
||||
5. [Competitive Analysis Guide](competitive-analysis.md) - 30 min
|
||||
6. [Content Strategy Guide](content-strategy-guide.md) - 30 min
|
||||
7. [Design Document](design-document.md) - 15 min
|
||||
|
||||
**Total Learning Time**: 3-4 hours
|
||||
**First Task**: Run Enterprise SEO Suite audit
|
||||
|
||||
---
|
||||
|
||||
### For Developers/Technical Teams
|
||||
**Goal**: Ensure technical SEO health
|
||||
|
||||
**Recommended Reading Order**:
|
||||
1. [Quick Start Guide](quick-start.md) - 10 min
|
||||
2. [Technical SEO Analyzer](individual-tools-guide.md#7--technical-seo-analyzer) - 15 min
|
||||
3. [PageSpeed Analyzer](individual-tools-guide.md#2--pagespeed-analyzer) - 15 min
|
||||
4. [Design Document](design-document.md) - 20 min
|
||||
|
||||
**Total Learning Time**: 1 hour
|
||||
**First Task**: Run Technical SEO audit on website
|
||||
|
||||
---
|
||||
|
||||
### For Solopreneurs
|
||||
**Goal**: Quick wins with minimal time
|
||||
|
||||
**Recommended Reading Order**:
|
||||
1. [Quick Start Guide](quick-start.md) - 10 min
|
||||
2. [Quick Wins Workflow](workflows-guide.md#quick-wins-workflow) - 5 min
|
||||
3. [Individual Tools Guide](individual-tools-guide.md#choosing-the-right-tool) - 10 min
|
||||
|
||||
**Total Learning Time**: 25 minutes
|
||||
**First Task**: Complete quick wins (5-day plan)
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Quick Tool Selection Guide
|
||||
|
||||
### By Time Available
|
||||
|
||||
**I have 5 minutes:**
|
||||
- Use: Meta Description Generator
|
||||
- Run on: Homepage
|
||||
- Expected result: Updated meta descriptions
|
||||
|
||||
**I have 15 minutes:**
|
||||
- Use: On-Page SEO Analyzer
|
||||
- Run on: Top 3 pages
|
||||
- Expected result: Optimization checklist
|
||||
|
||||
**I have 30 minutes:**
|
||||
- Use: PageSpeed Analyzer + On-Page SEO
|
||||
- Run on: Top 5 pages
|
||||
- Expected result: Performance baseline + optimization plan
|
||||
|
||||
**I have 1 hour:**
|
||||
- Use: Technical SEO Analyzer + Content Strategy
|
||||
- Run on: Entire site + top opportunities
|
||||
- Expected result: Technical issues + content plan
|
||||
|
||||
**I have 2+ hours:**
|
||||
- Use: Enterprise SEO Suite + Competitive Analysis
|
||||
- Run on: Full website audit
|
||||
- Expected result: Comprehensive report + strategy
|
||||
|
||||
---
|
||||
|
||||
### By Goal
|
||||
|
||||
| Goal | Tool | Guide |
|
||||
|------|------|-------|
|
||||
| Quick content optimization | On-Page SEO Analyzer | [Link](individual-tools-guide.md#6--on-page-seo-analyzer) |
|
||||
| Improve search appearance | Meta Description Generator | [Link](individual-tools-guide.md#1--meta-description-generator) |
|
||||
| Social media optimization | OpenGraph Generator | [Link](individual-tools-guide.md#5--opengraph-generator) |
|
||||
| Find new content ideas | Content Strategy Analyzer | [Link](individual-tools-guide.md#9--content-strategy-analyzer) |
|
||||
| Fix website speed | PageSpeed Analyzer | [Link](individual-tools-guide.md#2--pagespeed-analyzer) |
|
||||
| Find technical issues | Technical SEO Analyzer | [Link](individual-tools-guide.md#7--technical-seo-analyzer) |
|
||||
| Understand your site | Sitemap Analyzer | [Link](individual-tools-guide.md#3--sitemap-analyzer) |
|
||||
| Optimize images | Image Alt Text Generator | [Link](individual-tools-guide.md#4--image-alt-text-generator) |
|
||||
| Complete audit | Enterprise SEO Suite | [Link](individual-tools-guide.md#8--enterprise-seo-suite) |
|
||||
| Beat competitors | Competitive Analysis | [Link](competitive-analysis.md) |
|
||||
| Plan strategy | Content Strategy Guide | [Link](content-strategy-guide.md) |
|
||||
| AI recommendations | AI Copilot | [Link](ai-copilot.md) |
|
||||
|
||||
---
|
||||
|
||||
## 📊 Quick Stats
|
||||
|
||||
### Available Tools
|
||||
- **9 Individual SEO Analysis Tools**
|
||||
- **12 Dashboard & Integration Tools**
|
||||
- **3+ Workflow Templates**
|
||||
- **21 Total Functional Tools**
|
||||
|
||||
### Documentation Coverage
|
||||
- **11 Comprehensive Guides**
|
||||
- **50+ Pages of Documentation**
|
||||
- **1000+ Real-World Examples**
|
||||
- **100+ Best Practices**
|
||||
- **10+ Complete Workflows**
|
||||
|
||||
### Learning Resources
|
||||
- Quick Start: 10 minutes
|
||||
- Individual Tool Guides: 45 minutes
|
||||
- Workflow Guides: 45 minutes
|
||||
- Complete Learning: 3-4 hours
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Getting Started Now
|
||||
|
||||
### Path 1: Quick Start (10 minutes)
|
||||
```
|
||||
Read: Quick Start Guide
|
||||
Run: One tool analysis
|
||||
Expected Result: First optimization
|
||||
```
|
||||
|
||||
### Path 2: Smart Start (1 hour)
|
||||
```
|
||||
Read: Overview → Individual Tools Guide (choose 2-3)
|
||||
Run: On-Page SEO + One more tool
|
||||
Expected Result: Clear improvement plan
|
||||
```
|
||||
|
||||
### Path 3: Deep Dive (3-4 hours)
|
||||
```
|
||||
Read: Complete documentation
|
||||
Run: Multiple tool analyses
|
||||
Expected Result: Comprehensive strategy
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Navigation
|
||||
|
||||
### All Guides at a Glance
|
||||
|
||||
**User Guides:**
|
||||
- [Quick Start](quick-start.md) - New user orientation
|
||||
- [Overview](overview.md) - Dashboard overview
|
||||
- [Individual Tools Guide](individual-tools-guide.md) - Tool details
|
||||
|
||||
**Strategy Guides:**
|
||||
- [Content Strategy Guide](content-strategy-guide.md) - Content planning
|
||||
- [Competitive Analysis](competitive-analysis.md) - Market research
|
||||
- [AI Copilot Guide](ai-copilot.md) - AI assistant usage
|
||||
|
||||
**Implementation Guides:**
|
||||
- [Workflows & Automation](workflows-guide.md) - Proven workflows
|
||||
- [Metadata Generation](metadata.md) - Meta tag optimization
|
||||
|
||||
**Reference:**
|
||||
- [Tools Reference](tools-reference.md) - Complete tool inventory
|
||||
- [Design Document](design-document.md) - Technical reference
|
||||
- [GSC Integration](gsc-integration.md) - Platform integration
|
||||
|
||||
---
|
||||
|
||||
## ❓ Common Questions
|
||||
|
||||
**Q: Where do I start?**
|
||||
A: See [Quick Start Guide](quick-start.md)
|
||||
|
||||
**Q: How do I choose a tool?**
|
||||
A: See [Tools Reference](tools-reference.md) or use the tool selection guide above
|
||||
|
||||
**Q: What's the best workflow for my situation?**
|
||||
A: See [Workflows & Automation](workflows-guide.md)
|
||||
|
||||
**Q: How long until I see results?**
|
||||
A: Typically 4-8 weeks for ranking changes. See [Quick Start FAQ](quick-start.md#common-questions-for-beginners)
|
||||
|
||||
**Q: How often should I run analyses?**
|
||||
A: See [Individual Tools Guide](individual-tools-guide.md#quick-reference) for recommended frequency
|
||||
|
||||
**Q: Can I get AI help?**
|
||||
A: Yes! See [AI Copilot Guide](ai-copilot.md)
|
||||
|
||||
---
|
||||
|
||||
## 📞 Need More Help?
|
||||
|
||||
1. **Check this index** - You probably found what you need
|
||||
2. **Ask AI Copilot** - Use the chat in your dashboard
|
||||
3. **Review relevant guide** - Each guide has detailed examples
|
||||
4. **Check Tools Reference** - Complete tool specifications
|
||||
|
||||
---
|
||||
|
||||
## 📈 What You'll Accomplish
|
||||
|
||||
After using these guides, you'll be able to:
|
||||
|
||||
- ✅ Understand all 21 SEO tools available
|
||||
- ✅ Optimize pages for better rankings
|
||||
- ✅ Create content strategy
|
||||
- ✅ Find competitive opportunities
|
||||
- ✅ Implement proven workflows
|
||||
- ✅ Measure and track improvements
|
||||
- ✅ Get AI recommendations
|
||||
- ✅ Scale your SEO efforts
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Ready to Start?
|
||||
|
||||
1. **New User?** → Start with [Quick Start Guide](quick-start.md)
|
||||
2. **Ready to Optimize?** → Choose a tool from [Tools Reference](tools-reference.md)
|
||||
3. **Want Strategy?** → Read [Content Strategy Guide](content-strategy-guide.md)
|
||||
4. **Need Workflows?** → Check [Workflows & Automation](workflows-guide.md)
|
||||
|
||||
---
|
||||
|
||||
**Let's start optimizing! 🚀**
|
||||
|
||||
Pick your starting point above and begin your SEO journey.
|
||||
548
docs-site/docs/features/seo-dashboard/individual-tools-guide.md
Normal file
548
docs-site/docs/features/seo-dashboard/individual-tools-guide.md
Normal file
@@ -0,0 +1,548 @@
|
||||
# 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!**
|
||||
@@ -1,18 +1,46 @@
|
||||
# Metadata Generation
|
||||
# SEO Metadata & Optimization Tools
|
||||
|
||||
ALwrity's SEO Dashboard includes powerful metadata generation capabilities that automatically create optimized title tags, meta descriptions, and other SEO metadata to improve your content's search engine visibility and click-through rates.
|
||||
ALwrity's SEO Dashboard includes comprehensive metadata generation and SEO optimization capabilities. This guide covers all metadata and optimization tools available.
|
||||
|
||||
## What is Metadata Generation?
|
||||
## 🎯 Available Tools Overview
|
||||
|
||||
Metadata Generation is an AI-powered feature that automatically creates optimized SEO metadata for your content, including title tags, meta descriptions, Open Graph tags, and structured data markup to improve search engine visibility and social media sharing.
|
||||
### Individual Metadata Tools
|
||||
|
||||
### Key Benefits
|
||||
#### 1. 📝 Meta Description Generator
|
||||
- **Purpose**: Generate SEO-optimized meta descriptions
|
||||
- **API**: `POST /api/seo/meta-description`
|
||||
- **Inputs**: Keywords, tone, search intent, language
|
||||
- **Output**: Multiple meta descriptions with SEO scoring
|
||||
|
||||
- **Search Optimization**: Optimize content for search engines
|
||||
- **Click-Through Rate**: Improve CTR with compelling metadata
|
||||
- **Social Sharing**: Enhance social media sharing with rich metadata
|
||||
- **Brand Consistency**: Maintain consistent brand messaging
|
||||
- **Time Savings**: Automate metadata creation process
|
||||
#### 2. 🖼️ Image Alt Text Generator
|
||||
- **Purpose**: AI-powered alt text for images
|
||||
- **API**: `POST /api/seo/image-alt-text`
|
||||
- **Input Methods**: File upload or URL reference
|
||||
- **Output**: Optimized alt text with accessibility score
|
||||
|
||||
#### 3. 📱 OpenGraph Generator
|
||||
- **Purpose**: Social media optimization tags
|
||||
- **API**: `POST /api/seo/opengraph-tags`
|
||||
- **Platforms**: Facebook, Twitter, LinkedIn, Pinterest
|
||||
- **Output**: Platform-specific tags, HTML ready to use
|
||||
|
||||
#### 4. 📄 On-Page SEO Analyzer
|
||||
- **Purpose**: Complete page metadata analysis
|
||||
- **API**: `POST /api/seo/on-page-analysis`
|
||||
- **Analyzes**: Meta tags, content quality, keywords, links
|
||||
- **Output**: Overall score, detailed breakdown, recommendations
|
||||
|
||||
---
|
||||
|
||||
## What is Metadata?
|
||||
|
||||
Metadata is information about your content that search engines and social media platforms use to understand your pages. Proper metadata improves:
|
||||
- **Search Engine Rankings**: Better visibility in search results
|
||||
- **Click-Through Rates**: More clicks from search results
|
||||
- **Social Sharing**: Better appearance when shared
|
||||
- **User Experience**: Clearer information for users
|
||||
|
||||
---
|
||||
|
||||
## Metadata Types
|
||||
|
||||
|
||||
@@ -1,74 +1,143 @@
|
||||
# SEO Dashboard Overview
|
||||
|
||||
The ALwrity SEO Dashboard provides comprehensive SEO analysis and optimization tools to help you improve your website's search engine visibility and performance. It's designed for users with medium to low technical knowledge, making SEO optimization accessible to everyone.
|
||||
The ALwrity SEO Dashboard is a comprehensive, AI-powered platform providing **21 production-ready SEO tools** for content creators, digital marketers, and SEO professionals. Designed for users of all technical levels, it combines advanced AI analysis with real-time platform integrations for actionable SEO insights.
|
||||
|
||||
## Key Features
|
||||
## 🎯 What You Can Do
|
||||
|
||||
### 🔍 Real-Time SEO Analysis
|
||||
- **URL Analysis**: Analyze any website URL for comprehensive SEO performance
|
||||
- **Progressive Analysis**: Real-time analysis with smart timeout handling
|
||||
- **Health Scoring**: Get an overall SEO health score (0-100) with detailed breakdown
|
||||
- **AI Insights**: Receive personalized recommendations based on your analysis
|
||||
The SEO Dashboard enables you to:
|
||||
- **Analyze Individual Pages** - Get detailed on-page SEO analysis
|
||||
- **Generate Metadata** - Create optimized titles and descriptions
|
||||
- **Audit Technical SEO** - Identify and fix technical issues
|
||||
- **Monitor Performance** - Track real search rankings and traffic
|
||||
- **Analyze Competitors** - Identify market opportunities
|
||||
- **Plan Content Strategy** - Find content gaps and opportunities
|
||||
- **Optimize Images** - Generate SEO-friendly alt text
|
||||
- **Track Progress** - Monitor improvements over time
|
||||
|
||||
### 📊 Performance Dashboard
|
||||
- **Mock Data Display**: Currently shows sample performance metrics (traffic, rankings, mobile speed)
|
||||
- **Google Search Console Integration**: Connect your GSC account for real search data
|
||||
- **Authentication Required**: Sign in with Google to access all features
|
||||
- **Freshness Tracking**: Monitor when your data was last updated
|
||||
## 🔑 Key Features
|
||||
|
||||
### 🎯 Comprehensive Analysis Categories
|
||||
- **Technical SEO**: Site structure, sitemaps, robots.txt, and technical elements
|
||||
- **Content Analysis**: Content quality, relevance, and optimization
|
||||
- **Performance Metrics**: Page speed, loading times, and Core Web Vitals
|
||||
- **Accessibility**: How accessible your site is to all users
|
||||
- **User Experience**: Site usability and navigation
|
||||
- **Security**: HTTPS implementation and security headers
|
||||
### 📊 **9 Individual Analysis Tools**
|
||||
- Meta Description Generator
|
||||
- PageSpeed Analyzer
|
||||
- Sitemap Analyzer
|
||||
- Image Alt Text Generator
|
||||
- OpenGraph Generator
|
||||
- On-Page SEO Analyzer
|
||||
- Technical SEO Analyzer
|
||||
- Enterprise SEO Suite
|
||||
- Content Strategy Analyzer
|
||||
|
||||
### 📈 **Real-Time Integrations**
|
||||
- **Google Search Console** - Real search performance data
|
||||
- **Google Analytics 4** - Traffic and behavior analytics
|
||||
- **Bing Webmaster Tools** - Bing-specific insights
|
||||
- **PageSpeed Insights** - Performance analysis
|
||||
- **Exa API** - Competitor discovery
|
||||
|
||||
### 🤖 **AI-Powered Insights**
|
||||
- **Health Score** (0-100) - Overall SEO assessment
|
||||
- **AI Copilot** - Conversational recommendations
|
||||
- **Smart Recommendations** - Priority-based suggestions
|
||||
- **Competitive Analysis** - Market positioning insights
|
||||
- **Strategic Insights** - Weekly strategy briefs
|
||||
|
||||
### 🎨 **Comprehensive Analysis**
|
||||
- **Technical SEO**: Site structure, crawlability, indexability
|
||||
- **On-Page SEO**: Meta tags, content quality, optimization
|
||||
- **Content Analysis**: Quality, relevance, strategy alignment
|
||||
- **Performance**: Core Web Vitals, page speed, load times
|
||||
- **Competitive Positioning**: Benchmarking, market gaps
|
||||
- **Accessibility**: WCAG compliance, user experience
|
||||
|
||||
## Dashboard Components
|
||||
|
||||
### 1. Performance Overview Cards
|
||||
The dashboard displays key metrics in easy-to-read cards:
|
||||
- **Organic Traffic**: 12,500 visitors (+15% growth) - Shows your monthly organic traffic
|
||||
- **Average Ranking**: 8.5 position (+2.3 improvement) - Your average position in search results
|
||||
- **Mobile Speed**: 92 score (-3 decline) - Mobile performance score
|
||||
- **Keywords Tracked**: 150 keywords (+12 new) - Number of keywords you're monitoring
|
||||
The dashboard displays key metrics at a glance:
|
||||
- **Organic Traffic**: Monthly organic search traffic with growth trends
|
||||
- **Average Ranking**: Average keyword position in search results
|
||||
- **Mobile Speed**: Mobile performance score and Core Web Vitals
|
||||
- **Keywords Tracked**: Number of keywords you're monitoring
|
||||
|
||||
### 2. SEO Analyzer Panel
|
||||
- **URL Input Field**: Enter any website URL to analyze
|
||||
- **Analysis Button**: Start comprehensive SEO analysis
|
||||
- **Real-time Progress**: Watch analysis progress with live updates
|
||||
- **Results Display**: Get detailed breakdown of SEO performance
|
||||
### 2. SEO Analysis Tools
|
||||
Choose from **9 specialized tools** for specific analysis needs:
|
||||
|
||||
| Tool | Purpose | Best For |
|
||||
|------|---------|----------|
|
||||
| 📝 Meta Description Generator | Create SEO meta tags | Quick metadata creation |
|
||||
| ⚡ PageSpeed Analyzer | Google PageSpeed analysis | Performance optimization |
|
||||
| 🗺️ Sitemap Analyzer | Content structure review | Strategy planning |
|
||||
| 🖼️ Image Alt Text Generator | Vision-based image optimization | Accessibility & SEO |
|
||||
| 📱 OpenGraph Generator | Social media tags | Social sharing |
|
||||
| 📄 On-Page SEO Analyzer | Complete page analysis | Page optimization |
|
||||
| 🔧 Technical SEO Analyzer | Site crawling & audit | Technical fixes |
|
||||
| 🏢 Enterprise SEO Suite | Full website audit | Comprehensive assessment |
|
||||
| 📊 Content Strategy Analyzer | Content gap analysis | Content planning |
|
||||
|
||||
### 3. AI Insights Panel
|
||||
Receive intelligent recommendations organized by priority:
|
||||
Get intelligent, priority-ranked recommendations:
|
||||
- **High Priority**: Critical issues requiring immediate action
|
||||
- **Medium Priority**: Important improvements for better performance
|
||||
- **Low Priority**: Nice-to-have optimizations
|
||||
- **Low Priority**: Nice-to-have optimizations for refinement
|
||||
|
||||
### 4. Platform Integration Dashboard
|
||||
View connection status for all platforms:
|
||||
- **Google Search Console** - Real search performance data
|
||||
- **Google Analytics 4** - Traffic and user behavior
|
||||
- **Bing Webmaster Tools** - Bing-specific insights
|
||||
- **Status Indicators** - Connected, disconnected, or error states
|
||||
|
||||
## SEO Analysis Features
|
||||
|
||||
### What You Get When You Analyze a URL
|
||||
When you run an SEO analysis, you receive:
|
||||
### Individual Tools Analysis
|
||||
|
||||
When you run an SEO analysis using any of the 9 tools, you receive:
|
||||
|
||||
#### Overall Assessment
|
||||
- **Health Score**: A single number (0-100) representing your SEO health
|
||||
- **Health Status**: Excellent, Good, Needs Improvement, or Poor
|
||||
- **Health Status**: Excellent (90-100), Good (80-89), Needs Improvement (70-79), Poor (<70)
|
||||
- **Analysis Timestamp**: When the analysis was performed
|
||||
- **Execution Time**: How long the analysis took
|
||||
|
||||
#### Detailed Breakdown by Category
|
||||
- **URL Structure Score**: How well-organized your URLs are
|
||||
- **Meta Data Score**: Title tags, descriptions, and headers optimization
|
||||
- **Content Analysis Score**: Content quality, relevance, and optimization
|
||||
- **Technical SEO Score**: Site structure, sitemaps, robots.txt
|
||||
- **Performance Score**: Page speed and loading times
|
||||
- **Accessibility Score**: How accessible your site is to all users
|
||||
- **User Experience Score**: Site usability and navigation
|
||||
- **Security Score**: HTTPS implementation and security headers
|
||||
- **Meta Data Score**: Title, description, header optimization
|
||||
- **Content Quality Score**: Readability, relevance, optimization
|
||||
- **Technical SEO Score**: Site structure, crawlability, indexability
|
||||
- **Performance Score**: Page speed and Core Web Vitals
|
||||
- **Mobile Optimization**: Mobile-specific performance
|
||||
- **Accessibility Score**: WCAG compliance and accessibility
|
||||
- **Security Score**: HTTPS and security implementation
|
||||
|
||||
#### Actionable Insights
|
||||
- **Critical Issues**: Problems that hurt your rankings (must fix)
|
||||
- **Warnings**: Issues that could become problems (should fix)
|
||||
- **Recommendations**: Specific steps to improve your SEO (nice to fix)
|
||||
- **Priority Actions**: Top 3 things to focus on
|
||||
|
||||
### Workflow Analysis
|
||||
|
||||
#### Website Audit Workflow
|
||||
Complete analysis combining:
|
||||
- On-page SEO analysis
|
||||
- Technical SEO crawling
|
||||
- Performance optimization
|
||||
- Competitive intelligence
|
||||
- Executive summary with action plan
|
||||
|
||||
#### Content Strategy Workflow
|
||||
Content planning analysis including:
|
||||
- Content gap identification
|
||||
- Opportunity scoring
|
||||
- Competitive positioning
|
||||
- Topic recommendations
|
||||
- Publishing strategy
|
||||
|
||||
#### Competitive Analysis Workflow
|
||||
Market intelligence including:
|
||||
- Competitor discovery
|
||||
- Content benchmarking
|
||||
- Keyword comparison
|
||||
- Market positioning
|
||||
- Growth opportunities
|
||||
|
||||
## Google Search Console Integration
|
||||
|
||||
@@ -94,61 +163,120 @@ When you run an SEO analysis, you receive:
|
||||
|
||||
### Getting Started
|
||||
1. **Sign In**: Use your Google account to access the dashboard
|
||||
2. **Connect GSC**: Link your Google Search Console for real data (optional)
|
||||
3. **Enter Website URL**: Add your website URL to the analyzer
|
||||
4. **Run Analysis**: Click analyze to get comprehensive SEO insights
|
||||
2. **Connect Platforms**: Link GSC, GA4, and Bing for real data (optional but recommended)
|
||||
3. **Choose Your Tool**: Select from 9 individual analysis tools or workflow options
|
||||
4. **Run Analysis**: Input your URL and start the analysis
|
||||
|
||||
### Daily Workflow
|
||||
1. **Check Performance Overview**: Monitor your key metrics cards
|
||||
2. **Review AI Insights**: Look for new recommendations and priority alerts
|
||||
3. **Run URL Analysis**: Analyze specific pages that need attention
|
||||
4. **Track Progress**: Use the refresh button to get updated analysis
|
||||
1. **Check Health Score**: Monitor your overall SEO health
|
||||
2. **Review AI Insights**: Look for new recommendations and alerts
|
||||
3. **Run Targeted Analysis**: Use specific tools for pages needing attention
|
||||
4. **Track Progress**: Monitor improvements over time
|
||||
|
||||
### Monthly Workflow
|
||||
1. **Run Full Audit**: Use Enterprise SEO Suite for comprehensive assessment
|
||||
2. **Competitive Analysis**: Run sitemap benchmarking against competitors
|
||||
3. **Review Strategic Insights**: Get AI-powered weekly strategy recommendations
|
||||
4. **Content Planning**: Use content strategy analyzer to plan next month's content
|
||||
|
||||
### Understanding Your Results
|
||||
- **Health Score 90-100**: Excellent SEO performance
|
||||
- **Health Score 80-89**: Good performance with minor improvements needed
|
||||
- **Health Score 70-79**: Average performance requiring attention
|
||||
- **Health Score Below 70**: Poor performance needing immediate action
|
||||
|
||||
#### Health Score Interpretation
|
||||
- **90-100 (Excellent)**: Your site has excellent SEO health
|
||||
- **80-89 (Good)**: Good performance with minor improvements
|
||||
- **70-79 (Needs Improvement)**: Average performance requiring attention
|
||||
- **Below 70 (Poor)**: Significant issues requiring immediate action
|
||||
|
||||
#### When to Use Each Tool
|
||||
|
||||
**For Content Creators**:
|
||||
- Use **On-Page SEO Analyzer** before publishing
|
||||
- Use **Meta Description Generator** for quick tags
|
||||
- Use **Image Alt Text Generator** for images
|
||||
- Use **OpenGraph Generator** for social sharing
|
||||
|
||||
**For Technical Teams**:
|
||||
- Use **Technical SEO Analyzer** for crawl/index issues
|
||||
- Use **PageSpeed Analyzer** for performance optimization
|
||||
- Use **Sitemap Analyzer** for structure review
|
||||
- Use **Enterprise SEO Suite** for comprehensive audits
|
||||
|
||||
**For Marketers**:
|
||||
- Use **Content Strategy Analyzer** for planning
|
||||
- Use **Competitive Analysis** for market insights
|
||||
- Use **Health Score** for progress tracking
|
||||
- Use **Strategic Insights** for weekly briefings
|
||||
|
||||
### Making Improvements
|
||||
1. **Focus on Critical Issues**: Address problems that hurt your rankings first
|
||||
2. **Implement Recommendations**: Follow the step-by-step suggestions
|
||||
1. **Focus on Critical Issues**: Address problems that hurt rankings first
|
||||
2. **Implement Recommendations**: Follow the AI suggestions step by step
|
||||
3. **Monitor Progress**: Re-run analysis to see improvements
|
||||
4. **Track Changes**: Use the freshness indicator to know when to refresh
|
||||
4. **Track Changes**: Use weekly or monthly reviews to measure progress
|
||||
|
||||
## Best Practices for Non-Technical Users
|
||||
## Best Practices for All Users
|
||||
|
||||
### Start Simple
|
||||
1. **Focus on Critical Issues**: Address problems that hurt your rankings first
|
||||
2. **One Thing at a Time**: Don't try to fix everything at once
|
||||
3. **Use the Recommendations**: Follow the AI suggestions step by step
|
||||
4. **Track Your Progress**: Re-run analysis monthly to see improvements
|
||||
1. **Check Your Health Score**: Get your overall assessment
|
||||
2. **Review Critical Issues**: Fix high-priority problems first
|
||||
3. **Implement Top Recommendations**: Focus on quick wins
|
||||
4. **Track Your Progress**: Re-check after 2-4 weeks
|
||||
|
||||
### What to Prioritize
|
||||
1. **Page Speed**: Fast-loading pages rank better
|
||||
2. **Mobile-Friendly**: Make sure your site works on phones
|
||||
3. **Content Quality**: Write helpful, original content
|
||||
4. **Technical Issues**: Fix broken links and errors
|
||||
1. **Core Web Vitals**: Fast-loading pages rank better
|
||||
2. **Mobile Optimization**: Over 60% of searches are mobile
|
||||
3. **Content Quality**: Helpful, original content wins
|
||||
4. **Technical Fixes**: Fix broken links and errors
|
||||
|
||||
### Don't Worry About
|
||||
- Complex technical SEO (leave that to developers if needed)
|
||||
- Perfect scores (aim for improvement, not perfection)
|
||||
- Every single recommendation (focus on high-priority items)
|
||||
- Frequent changes (monthly analysis is usually enough)
|
||||
### Monthly Best Practices
|
||||
1. **Run Full Audit**: Use Enterprise SEO Suite monthly
|
||||
2. **Check Competitors**: Run competitive analysis quarterly
|
||||
3. **Review Analytics**: Check real traffic from GSC/GA4 monthly
|
||||
4. **Plan Content**: Use content strategy tool for next month
|
||||
|
||||
## Getting Started
|
||||
### Advanced Features
|
||||
|
||||
1. **[GSC Integration](gsc-integration.md)** - Connect Google Search Console for real data
|
||||
2. **[Analysis Guide](metadata.md)** - Learn how to read your SEO analysis results
|
||||
3. **[Best Practices](../../guides/best-practices.md)** - Simple SEO optimization tips
|
||||
#### For Power Users
|
||||
- **AI Copilot**: Get conversational SEO guidance
|
||||
- **Semantic Health Monitoring**: Phase 2B real-time analysis
|
||||
- **Deep Competitor Analysis**: In-depth market intelligence
|
||||
- **Strategic Insights**: Weekly AI-powered briefings
|
||||
|
||||
## Related Features
|
||||
#### Integration with Other Tools
|
||||
- **Blog Writer**: SEO optimization while writing
|
||||
- **Content Strategy**: Strategic planning and gap analysis
|
||||
- **YouTube Creator**: SEO keywords for video optimization
|
||||
- **Podcast Dashboard**: Content distribution optimization
|
||||
|
||||
- **[Blog Writer](../blog-writer/overview.md)** - Content creation with SEO
|
||||
- **[Content Strategy](../content-strategy/overview.md)** - Strategic planning
|
||||
- **[AI Features](../ai/grounding-ui.md)** - Advanced AI capabilities
|
||||
- **[API Reference](../../api/overview.md)** - Technical integration
|
||||
## SEO Tools Overview
|
||||
|
||||
### Quick Reference
|
||||
|
||||
The SEO Dashboard includes 21 production-ready tools organized into three categories:
|
||||
|
||||
**Individual Tools** (9) - Focused analysis for specific SEO aspects
|
||||
**Dashboard Tools** (12) - Real-time monitoring, AI insights, integrations
|
||||
**Workflows** (Included) - Multi-step analysis for comprehensive assessment
|
||||
|
||||
For detailed information about each tool, see [Tools Reference](tools-reference.md).
|
||||
|
||||
---
|
||||
|
||||
*Ready to optimize your SEO? Check out our [GSC Integration Guide](gsc-integration.md) to get started!*
|
||||
## Getting Started
|
||||
|
||||
1. **[Tools Reference](tools-reference.md)** - Overview of all 21 SEO tools
|
||||
2. **[GSC Integration](gsc-integration.md)** - Connect Google Search Console
|
||||
3. **[Metadata Guide](metadata.md)** - Learn about metadata generation
|
||||
4. **[AI Copilot Guide](ai-copilot.md)** - Use the AI assistant effectively
|
||||
5. **[Best Practices](../../guides/best-practices.md)** - SEO optimization tips
|
||||
|
||||
## Related Features
|
||||
|
||||
- **[Blog Writer](../blog-writer/overview.md)** - Content creation with integrated SEO
|
||||
- **[Content Strategy](../content-strategy/overview.md)** - Strategic planning and gaps
|
||||
- **[AI Features](../ai/overview.md)** - Advanced AI capabilities
|
||||
- **[Persona System](../persona/overview.md)** - Personalized writing assistants
|
||||
- **[API Reference](../../api/seo-tools.md)** - Technical integration details
|
||||
|
||||
---
|
||||
|
||||
*Ready to optimize your SEO? Start with [Tools Reference](tools-reference.md) to explore all 21 tools, or check out our [GSC Integration Guide](gsc-integration.md) to connect your search data!*
|
||||
|
||||
379
docs-site/docs/features/seo-dashboard/quick-start.md
Normal file
379
docs-site/docs/features/seo-dashboard/quick-start.md
Normal file
@@ -0,0 +1,379 @@
|
||||
# SEO Dashboard Quick Start Guide
|
||||
|
||||
## 🚀 Getting Started in 10 Minutes
|
||||
|
||||
Welcome to ALwrity's SEO Dashboard! This guide will help you get started with your first SEO optimization in just 10 minutes.
|
||||
|
||||
---
|
||||
|
||||
## Before You Start
|
||||
|
||||
Make sure you have:
|
||||
- ✅ ALwrity account (free or paid)
|
||||
- ✅ Website URL ready
|
||||
- ✅ Target keywords in mind
|
||||
- ✅ 10 minutes of time
|
||||
|
||||
---
|
||||
|
||||
## Step-by-Step Quick Start
|
||||
|
||||
### Step 1: Access the SEO Dashboard (1 min)
|
||||
1. Log in to ALwrity
|
||||
2. Click "SEO Dashboard" from main navigation
|
||||
3. You'll see 9 analysis tools on the main page
|
||||
|
||||
**What you see:**
|
||||
- 9 individual analysis tools
|
||||
- "Run Full Audit" button (Enterprise Suite)
|
||||
- Dashboard overview with real-time data
|
||||
- AI Copilot chat in corner
|
||||
|
||||
### Step 2: Pick Your First Tool (1 min)
|
||||
|
||||
Choose based on what you want to optimize:
|
||||
|
||||
| Goal | Tool | Time |
|
||||
|------|------|------|
|
||||
| **Get started quick** | Meta Description Generator | 3 min |
|
||||
| **Check page quality** | On-Page SEO Analyzer | 5 min |
|
||||
| **Check website speed** | PageSpeed Analyzer | 3 min |
|
||||
| **Get content ideas** | Content Strategy Analyzer | 5 min |
|
||||
| **Optimize images** | Image Alt Text Generator | 3 min |
|
||||
| **Social media ready** | OpenGraph Generator | 3 min |
|
||||
| **Full website check** | Enterprise SEO Suite | 10 min |
|
||||
|
||||
**Recommendation for beginners:** Start with **On-Page SEO Analyzer**
|
||||
|
||||
### Step 3: Run Your First Analysis (3-5 min)
|
||||
|
||||
#### For On-Page SEO Analyzer:
|
||||
```
|
||||
1. Click "On-Page SEO Analyzer" button
|
||||
2. Paste your website URL (e.g., yoursite.com)
|
||||
3. Enter your target keyword (optional)
|
||||
4. Click "Analyze"
|
||||
5. Wait for results (8-12 seconds)
|
||||
```
|
||||
|
||||
#### For Meta Description Generator:
|
||||
```
|
||||
1. Click "Meta Description Generator" button
|
||||
2. Enter your target keywords
|
||||
3. Select tone (Professional/Casual/Friendly)
|
||||
4. Click "Generate"
|
||||
5. Review options
|
||||
```
|
||||
|
||||
#### For Content Strategy Analyzer:
|
||||
```
|
||||
1. Click "Content Strategy Analyzer" button
|
||||
2. Enter your website URL
|
||||
3. Click "Analyze Content Strategy"
|
||||
4. Wait for analysis (5-10 minutes)
|
||||
5. Review content gaps and opportunities
|
||||
```
|
||||
|
||||
### Step 4: Review Your Results (2-3 min)
|
||||
|
||||
**What to look for:**
|
||||
|
||||
#### On-Page SEO Score
|
||||
- **80+**: Great! Your page is well-optimized
|
||||
- **60-79**: Good, but improvements available
|
||||
- **Below 60**: Significant improvements needed
|
||||
|
||||
#### Issues Breakdown
|
||||
- **Critical Issues** (red): Fix these first
|
||||
- **Warnings** (yellow): Address after critical issues
|
||||
- **Recommendations** (blue): Nice-to-have improvements
|
||||
|
||||
#### Recommendations
|
||||
- Sorted by impact
|
||||
- Show potential traffic gain
|
||||
- Include specific fix guidance
|
||||
|
||||
### Step 5: Take Your First Action (2-3 min)
|
||||
|
||||
Pick ONE recommendation and implement it:
|
||||
|
||||
**Example 1: Meta Description Too Long**
|
||||
1. Copy the recommended meta description
|
||||
2. Go to your page settings
|
||||
3. Update the meta description
|
||||
4. Save changes
|
||||
|
||||
**Example 2: Missing Internal Links**
|
||||
1. Identify recommended link targets
|
||||
2. Add links to related pages
|
||||
3. Save changes
|
||||
|
||||
**Example 3: Image Missing Alt Text**
|
||||
1. Use Image Alt Text Generator
|
||||
2. Copy recommended alt text
|
||||
3. Update image alt attribute
|
||||
4. Save changes
|
||||
|
||||
---
|
||||
|
||||
## Your First Full Optimization (15 minutes)
|
||||
|
||||
If you have 15 minutes, do a complete page optimization:
|
||||
|
||||
```
|
||||
Step 1: Analyze Page (8 min)
|
||||
├─ Use On-Page SEO Analyzer
|
||||
├─ Enter page URL + target keyword
|
||||
└─ Wait for results
|
||||
|
||||
Step 2: Fix Issues (4 min)
|
||||
├─ Fix 2-3 critical issues
|
||||
├─ Update meta description
|
||||
└─ Fix image alt text
|
||||
|
||||
Step 3: Recheck (3 min)
|
||||
├─ Run analyzer again
|
||||
├─ Verify improvements
|
||||
└─ Check new score
|
||||
|
||||
Result: Page optimized, ready to publish/republish
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Your First Week Plan
|
||||
|
||||
### Day 1: Learn the Dashboard
|
||||
- ✅ Complete this quick start guide
|
||||
- ✅ Run one tool analysis
|
||||
- ✅ Implement one recommendation
|
||||
- ✅ Explore Tools Reference guide
|
||||
|
||||
### Day 2: Optimize Your Homepage
|
||||
- ✅ Run On-Page SEO Analyzer on homepage
|
||||
- ✅ Update meta description
|
||||
- ✅ Fix 3-5 issues identified
|
||||
- ✅ Run PageSpeed check
|
||||
|
||||
### Day 3: Optimize Your Top Pages
|
||||
- ✅ Identify top 5 pages in GA4
|
||||
- ✅ Run On-Page SEO Analyzer on each
|
||||
- ✅ Update meta descriptions
|
||||
- ✅ Fix images (alt text)
|
||||
|
||||
### Day 4: Find Content Opportunities
|
||||
- ✅ Run Content Strategy Analyzer
|
||||
- ✅ Review content gaps identified
|
||||
- ✅ Create list of top 5 opportunities
|
||||
- ✅ Plan first new article
|
||||
|
||||
### Day 5: Technical Check
|
||||
- ✅ Run Technical SEO Analyzer
|
||||
- ✅ Review critical issues
|
||||
- ✅ Create fix plan
|
||||
- ✅ Assign to developer if needed
|
||||
|
||||
---
|
||||
|
||||
## Common Questions for Beginners
|
||||
|
||||
### Q: Which tool should I start with?
|
||||
**A:** Start with **On-Page SEO Analyzer** to understand what's working and what needs improvement on your existing pages.
|
||||
|
||||
### Q: How long do results take to show?
|
||||
**A:** Expect 4-8 weeks for ranking improvements after optimization. Traffic changes may show earlier (1-2 weeks).
|
||||
|
||||
### Q: Do I need to optimize all pages?
|
||||
**A:** No! Start with:
|
||||
1. Homepage
|
||||
2. Top 10 traffic pages
|
||||
3. Target keyword pages
|
||||
4. Then expand to others
|
||||
|
||||
### Q: Can I use these tools for competitors?
|
||||
**A:** Yes! Most tools work on any URL:
|
||||
- Run On-Page SEO on competitor pages
|
||||
- Use PageSpeed to compare performance
|
||||
- Use Content Strategy to analyze their content
|
||||
- See how you compare
|
||||
|
||||
### Q: What if I don't understand a recommendation?
|
||||
**A:** Click on any recommendation to see:
|
||||
- Why it matters
|
||||
- How to fix it
|
||||
- Examples of good vs. bad
|
||||
- Links to learn more
|
||||
|
||||
### Q: How often should I run analyses?
|
||||
**A:**
|
||||
- **Monthly**: Content Strategy, Technical SEO (full)
|
||||
- **Bi-weekly**: PageSpeed on key pages
|
||||
- **Weekly**: On-Page SEO (when publishing)
|
||||
- **Daily**: General dashboard check
|
||||
|
||||
### Q: Can I run analyses on multiple pages at once?
|
||||
**A:** Some tools support batch analysis. For manual analysis:
|
||||
- Use On-Page Analyzer sequentially
|
||||
- Export results to CSV
|
||||
- Create improvement checklist
|
||||
- Track progress
|
||||
|
||||
### Q: Is there a priority order for improvements?
|
||||
**A:** Yes! Fix in this order:
|
||||
1. **Critical Issues** (prevent indexing, break site)
|
||||
2. **High Issues** (significantly hurt SEO)
|
||||
3. **Medium Issues** (moderate SEO impact)
|
||||
4. **Low Issues** (minor impact, nice to fix)
|
||||
|
||||
---
|
||||
|
||||
## Next Steps After Quick Start
|
||||
|
||||
### Short Term (This Week)
|
||||
1. ✅ Complete this quick start
|
||||
2. ✅ Optimize your homepage
|
||||
3. ✅ Optimize top 5 pages
|
||||
4. ✅ Check site speed
|
||||
|
||||
### Medium Term (This Month)
|
||||
1. ✅ Find content opportunities
|
||||
2. ✅ Create content plan
|
||||
3. ✅ Fix technical SEO issues
|
||||
4. ✅ Create internal linking strategy
|
||||
|
||||
### Long Term (This Quarter)
|
||||
1. ✅ Implement full content strategy
|
||||
2. ✅ Optimize all pages
|
||||
3. ✅ Build competitive advantages
|
||||
4. ✅ Establish measurement framework
|
||||
|
||||
---
|
||||
|
||||
## Learning Resources
|
||||
|
||||
### Getting Deeper Into Each Tool
|
||||
- See [Individual Tools Guide](individual-tools-guide.md) for detailed guide on each tool
|
||||
- Each tool has 3-5 pro tips for advanced usage
|
||||
- Real-world examples show expected output
|
||||
|
||||
### Learning Specific Workflows
|
||||
- See [Workflows & Automation Guide](workflows-guide.md) for:
|
||||
- Step-by-step content creation pipeline
|
||||
- Website audit workflow
|
||||
- Performance optimization workflow
|
||||
- Industry-specific workflows
|
||||
|
||||
### Getting Help from AI
|
||||
- Use SEO Copilot for:
|
||||
- Tool recommendations
|
||||
- Strategy questions
|
||||
- Content ideas
|
||||
- Optimization suggestions
|
||||
- See [AI Copilot Guide](ai-copilot.md) for examples
|
||||
|
||||
### Comprehensive Reference
|
||||
- See [Tools Reference](tools-reference.md) for complete tool inventory
|
||||
- See [Metadata Generation](metadata.md) for deep dive on meta optimization
|
||||
- See [Competitive Analysis](competitive-analysis.md) for competitor research
|
||||
|
||||
---
|
||||
|
||||
## Common Beginner Mistakes to Avoid
|
||||
|
||||
### ❌ Mistake 1: Trying All Tools at Once
|
||||
**Fix**: Focus on one tool at a time. Master it, then move to the next.
|
||||
|
||||
### ❌ Mistake 2: Not Implementing Recommendations
|
||||
**Fix**: Pick one recommendation per day and implement it. Small, consistent progress wins.
|
||||
|
||||
### ❌ Mistake 3: Expecting Instant Results
|
||||
**Fix**: SEO takes time (4-12 weeks). Focus on implementing quality improvements.
|
||||
|
||||
### ❌ Mistake 4: Ignoring Critical Issues
|
||||
**Fix**: Always fix critical issues first. They have the biggest impact.
|
||||
|
||||
### ❌ Mistake 5: Not Tracking Progress
|
||||
**Fix**: Keep a simple spreadsheet:
|
||||
- Before/after scores
|
||||
- Implementation date
|
||||
- Ranking changes
|
||||
- Traffic impact
|
||||
|
||||
### ❌ Mistake 6: Assuming One Size Fits All
|
||||
**Fix**: Different pages need different strategies. Analyze each page individually.
|
||||
|
||||
### ❌ Mistake 7: Not Using the AI Copilot
|
||||
**Fix**: Ask the AI for recommendations, strategies, and help understanding results.
|
||||
|
||||
---
|
||||
|
||||
## Get Help
|
||||
|
||||
### When You're Stuck
|
||||
1. Check [Troubleshooting Guide](#)
|
||||
2. Ask AI Copilot in dashboard
|
||||
3. Review relevant guide from [Tools Reference](tools-reference.md)
|
||||
4. Check FAQ below
|
||||
|
||||
### Quick FAQ
|
||||
|
||||
**Q: Analysis takes too long?**
|
||||
- Reduce crawl depth for Technical SEO
|
||||
- Analyze one page at a time initially
|
||||
- Try again during off-peak hours
|
||||
|
||||
**Q: Results seem wrong?**
|
||||
- Verify you entered correct URL
|
||||
- Check if page is public/not blocked
|
||||
- Try running analysis again
|
||||
- Check page source code for tags
|
||||
|
||||
**Q: How do I export results?**
|
||||
- Most tools show "Export" button
|
||||
- Copy/paste to spreadsheet
|
||||
- Use browser's "Save as PDF"
|
||||
- Take screenshots for reference
|
||||
|
||||
**Q: Can multiple people use same account?**
|
||||
- Yes, but analysis results aren't shared
|
||||
- Consider separate accounts for tracking
|
||||
- Use shared Google Sheet for collaboration
|
||||
|
||||
**Q: Which tools need to be run most often?**
|
||||
- PageSpeed: Weekly
|
||||
- On-Page SEO: When publishing
|
||||
- Content Strategy: Monthly
|
||||
- Technical SEO: Bi-weekly to monthly
|
||||
|
||||
---
|
||||
|
||||
## Your Success Checklist
|
||||
|
||||
Before you declare victory, check:
|
||||
|
||||
- [ ] I've run at least one tool analysis
|
||||
- [ ] I understand what the score means
|
||||
- [ ] I've implemented 1-3 recommendations
|
||||
- [ ] I've seen the page improve
|
||||
- [ ] I know which tool to use next
|
||||
- [ ] I have a 30-day plan
|
||||
- [ ] I'm tracking progress
|
||||
|
||||
**Congratulations! You're now ready to optimize your website! 🎉**
|
||||
|
||||
---
|
||||
|
||||
## What's Next?
|
||||
|
||||
Pick your next step:
|
||||
1. **Learn More Tools**: Read [Individual Tools Guide](individual-tools-guide.md)
|
||||
2. **Optimize Content**: Read [Content Strategy Guide](content-strategy-guide.md)
|
||||
3. **Create Workflows**: Read [Workflows & Automation](workflows-guide.md)
|
||||
4. **Deep Dive**: Read [Tools Reference](tools-reference.md)
|
||||
5. **Get AI Help**: Ask AI Copilot in the dashboard
|
||||
|
||||
---
|
||||
|
||||
**Happy optimizing! 🚀**
|
||||
|
||||
Need more help? See [Tools Reference](tools-reference.md) or ask the AI Copilot in your dashboard.
|
||||
357
docs-site/docs/features/seo-dashboard/tools-reference.md
Normal file
357
docs-site/docs/features/seo-dashboard/tools-reference.md
Normal file
@@ -0,0 +1,357 @@
|
||||
# ALwrity SEO Tools Suite - Complete Reference
|
||||
|
||||
## 🎯 Overview
|
||||
|
||||
ALwrity provides a comprehensive suite of **21 production-ready SEO tools** designed to help content creators, digital marketers, and SEO professionals optimize their web presence. All tools are powered by advanced AI (Gemini LLM) and integrate seamlessly with major search platforms.
|
||||
|
||||
## 📊 Tool Categories
|
||||
|
||||
### Individual Analysis Tools (9)
|
||||
|
||||
These tools provide focused, single-purpose analysis for specific SEO aspects:
|
||||
|
||||
#### 1. 📝 Meta Description Generator
|
||||
- **Purpose**: Generate SEO-optimized meta descriptions
|
||||
- **AI Model**: Gemini LLM with keyword analysis
|
||||
- **Inputs**: Keywords, tone, search intent, language
|
||||
- **Outputs**: Multiple meta descriptions with SEO scoring
|
||||
- **API**: `POST /api/seo/meta-description`
|
||||
- **Use Case**: Quick meta tag creation for new or existing pages
|
||||
|
||||
#### 2. ⚡ PageSpeed Analyzer
|
||||
- **Purpose**: Google PageSpeed Insights analysis with AI insights
|
||||
- **Source**: Google PageSpeed API
|
||||
- **Features**: Desktop & mobile analysis, Core Web Vitals, opportunities
|
||||
- **Outputs**: Performance scores, optimization opportunities, business impact analysis
|
||||
- **API**: `POST /api/seo/pagespeed-analysis`
|
||||
- **Key Metrics**: LCP, FID, CLS, load time
|
||||
|
||||
#### 3. 🗺️ Sitemap Analyzer
|
||||
- **Purpose**: Website structure and content trends analysis
|
||||
- **Capabilities**: URL patterns, publishing velocity, content distribution
|
||||
- **Analysis**: Content trends, publishing patterns, SEO recommendations
|
||||
- **Outputs**: Structure quality, content strategy insights, growth recommendations
|
||||
- **API**: `POST /api/seo/sitemap-analysis`
|
||||
- **Best For**: Content strategy planning and competitive benchmarking
|
||||
|
||||
#### 4. 🖼️ Image Alt Text Generator
|
||||
- **Purpose**: Vision-based SEO-optimized alt text
|
||||
- **AI Model**: Vision models + context analysis
|
||||
- **Input Methods**: File upload or URL
|
||||
- **Outputs**: Alt text, keyword analysis, accessibility score
|
||||
- **API**: `POST /api/seo/image-alt-text`
|
||||
- **Features**: Context-aware, keyword integration, accessibility optimization
|
||||
|
||||
#### 5. 📱 OpenGraph Generator
|
||||
- **Purpose**: Social media optimization tags
|
||||
- **Platforms**: Facebook, Twitter, LinkedIn, Pinterest
|
||||
- **Outputs**: Platform-specific og: tags, HTML ready to use
|
||||
- **API**: `POST /api/seo/opengraph-tags`
|
||||
- **Enhancement**: Increases social sharing and engagement
|
||||
|
||||
#### 6. 📄 On-Page SEO Analyzer
|
||||
- **Purpose**: Comprehensive on-page analysis
|
||||
- **Analyzes**: Meta tags, content quality, keyword optimization, internal links
|
||||
- **Scoring**: Overall score (0-100) with component breakdown
|
||||
- **Outputs**: Critical issues, warnings, actionable recommendations
|
||||
- **API**: `POST /api/seo/on-page-analysis`
|
||||
- **Best For**: Page-level optimization audits
|
||||
|
||||
#### 7. 🔧 Technical SEO Analyzer
|
||||
- **Purpose**: Site crawling and technical audit
|
||||
- **Capabilities**: Crawl depth 1-5, external link analysis, performance metrics
|
||||
- **Issues**: Robots.txt, sitemap, canonicalization, redirects, broken links
|
||||
- **Outputs**: Issues by severity, comprehensive recommendations
|
||||
- **API**: `POST /api/seo/technical-seo`
|
||||
- **Best For**: Technical SEO audits and issue identification
|
||||
|
||||
#### 8. 🏢 Enterprise SEO Suite
|
||||
- **Purpose**: Complete website audit workflows
|
||||
- **Features**: End-to-end audits, multi-competitor comparison
|
||||
- **Outputs**: Executive summary, detailed audit report, action plans
|
||||
- **API**: `POST /api/seo/workflow/website-audit`
|
||||
- **Best For**: Comprehensive audits and executive reporting
|
||||
|
||||
#### 9. 📊 Content Strategy Analyzer
|
||||
- **Purpose**: Content gap analysis and strategy planning
|
||||
- **Features**: Competitor analysis, topic opportunities, keyword scoring
|
||||
- **Outputs**: Content gaps, opportunities, competitive positioning
|
||||
- **API**: `POST /api/seo/workflow/content-analysis`
|
||||
- **Best For**: Content planning and opportunity identification
|
||||
|
||||
---
|
||||
|
||||
### Dashboard & Integration Tools (12)
|
||||
|
||||
These tools provide real-time monitoring, analytics integration, and AI-powered insights:
|
||||
|
||||
#### 10. 🎨 SEO Dashboard
|
||||
- **Core Component**: Main SEO monitoring interface
|
||||
- **Features**: Health score, real-time metrics, platform integrations
|
||||
- **Updates**: Real-time data sync with platforms
|
||||
- **Integrations**: GSC, GA4, Bing Webmaster
|
||||
- **Best For**: Daily SEO monitoring and performance tracking
|
||||
|
||||
#### 11. 🔗 Google Search Console Integration
|
||||
- **Data Source**: Real GSC data
|
||||
- **Metrics**: Queries, clicks, impressions, rankings
|
||||
- **OAuth**: Secure Google OAuth 2.0 authentication
|
||||
- **Features**: Real-time data sync, performance tracking
|
||||
- **API**: `GET /api/seo-dashboard/gsc/raw`
|
||||
|
||||
#### 12. 🔍 Bing Webmaster Integration
|
||||
- **Data Source**: Real Bing data
|
||||
- **Metrics**: Bing-specific rankings, crawl information
|
||||
- **OAuth**: Microsoft OAuth 2.0 authentication
|
||||
- **Features**: Bing-specific insights and recommendations
|
||||
- **API**: `GET /api/seo-dashboard/bing/raw`
|
||||
|
||||
#### 13. 📈 Google Analytics 4 Integration
|
||||
- **Component**: PlatformAnalytics
|
||||
- **Metrics**: Traffic, behavior, conversions, custom events
|
||||
- **OAuth**: Secure GA4 authentication
|
||||
- **Real-Time**: Real-time traffic monitoring
|
||||
- **Best For**: Understanding traffic sources and user behavior
|
||||
|
||||
#### 14. 🎯 Health Score System
|
||||
- **Scoring**: 0-100 scale (0 = poor, 100 = excellent)
|
||||
- **Breakdown**: Technical, content, performance, mobile scores
|
||||
- **Trends**: Daily/weekly/monthly tracking
|
||||
- **Recommendations**: AI-generated improvement suggestions
|
||||
- **API**: `GET /api/seo-dashboard/health-score`
|
||||
|
||||
#### 15. 💡 AI Copilot Assistant
|
||||
- **Interface**: Conversational AI recommendations
|
||||
- **Power**: CopilotKit + Gemini LLM
|
||||
- **Features**: Context-aware, multi-tool orchestration
|
||||
- **Action Buttons**: Direct access to relevant tools
|
||||
- **Best For**: Getting smart SEO guidance naturally
|
||||
|
||||
#### 16-21. **Competitive & Strategic Tools**
|
||||
See next section...
|
||||
|
||||
---
|
||||
|
||||
### Competitive & Strategic Tools (6)
|
||||
|
||||
#### 16. 🏆 Competitive Analysis
|
||||
- **Source**: Exa API semantic search
|
||||
- **Features**: Competitor discovery, content comparison
|
||||
- **Metrics**: Trust score, content volume, publishing frequency
|
||||
- **Outputs**: Competitor insights, market positioning
|
||||
- **API**: `GET /api/seo-dashboard/competitive-insights`
|
||||
|
||||
#### 17. 📊 Sitemap Benchmarking
|
||||
- **Features**: Content structure comparison across competitors
|
||||
- **Metrics**: Structure quality, content volume, publishing velocity
|
||||
- **Time**: Runs in background (async processing)
|
||||
- **Outputs**: Competitive benchmarking report
|
||||
- **API**: `POST/GET /api/seo/competitive-sitemap-benchmarking`
|
||||
|
||||
#### 18. 🎭 Deep Competitor Analysis
|
||||
- **Depth**: In-depth competitive intelligence
|
||||
- **Features**: Market positioning, advantages, content strategy
|
||||
- **Outputs**: Competitive advantages, market opportunities
|
||||
- **API**: `GET /api/seo-dashboard/deep-competitor-analysis`
|
||||
|
||||
#### 19. 💬 Strategic Insights
|
||||
- **Frequency**: Weekly strategy briefs
|
||||
- **Features**: AI-powered recommendations
|
||||
- **Tracking**: Historical insights and patterns
|
||||
- **Outputs**: Weekly strategy recommendations
|
||||
- **API**: `GET /api/seo-dashboard/strategic-insights/history`
|
||||
|
||||
#### 20. 🧠 Semantic Health Monitoring (Phase 2B)
|
||||
- **Real-Time**: Continuous semantic analysis
|
||||
- **Features**: Entity recognition, relevance tracking
|
||||
- **Outputs**: Health metrics, relevance scores
|
||||
- **Best For**: Advanced SEO professionals
|
||||
|
||||
#### 21. ✍️ Blog SEO Integration
|
||||
- **Location**: In-editor assistance
|
||||
- **Features**: Live SEO suggestions while writing
|
||||
- **Interface**: SEO Mini Panel in blog editor
|
||||
- **Best For**: Writers optimizing content in real-time
|
||||
|
||||
---
|
||||
|
||||
## 🔌 Platform Integrations
|
||||
|
||||
### Search Engines
|
||||
- ✅ **Google Search Console** - Real-time search performance
|
||||
- ✅ **Google Analytics 4** - Traffic and behavior analytics
|
||||
- ✅ **Bing Webmaster Tools** - Bing-specific insights
|
||||
|
||||
### External APIs
|
||||
- ✅ **Google PageSpeed Insights** - Performance analysis
|
||||
- ✅ **Exa API** - Semantic search and competitor discovery
|
||||
- ✅ **Vision APIs** - Image analysis for alt text generation
|
||||
|
||||
### Authentication
|
||||
- ✅ **Google OAuth 2.0** - GSC and GA4
|
||||
- ✅ **Microsoft OAuth 2.0** - Bing integration
|
||||
- ✅ **Clerk Authentication** - User management
|
||||
|
||||
---
|
||||
|
||||
## 📚 Documentation
|
||||
|
||||
### Getting Started
|
||||
- [SEO Dashboard Setup](overview.md)
|
||||
- [Google Search Console Integration](gsc-integration.md)
|
||||
- [Metadata Generation Guide](metadata.md)
|
||||
|
||||
### Tool-Specific Guides
|
||||
- [Meta Description Generator](meta-description-tool.md)
|
||||
- [PageSpeed Analyzer Guide](pagespeed-analyzer.md)
|
||||
- [Sitemap Analysis](sitemap-analyzer.md)
|
||||
- [Content Strategy Tool](content-strategy-tool.md)
|
||||
- [Technical SEO Analyzer](technical-seo-tool.md)
|
||||
- [Competitive Analysis](competitive-analysis.md)
|
||||
|
||||
### Advanced Guides
|
||||
- [AI Copilot Assistant](ai-copilot.md)
|
||||
- [API Reference](../../api/seo-tools.md)
|
||||
- [Advanced Configuration](advanced-configuration.md)
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Quick Start by Use Case
|
||||
|
||||
### For Content Creators
|
||||
1. Use **Meta Description Generator** for quick SEO tags
|
||||
2. Run **On-Page SEO Analyzer** before publishing
|
||||
3. Monitor **Blog SEO Integration** while writing
|
||||
4. Track performance in **SEO Dashboard**
|
||||
|
||||
### For Digital Marketers
|
||||
1. Set up **SEO Dashboard** with GSC/GA4
|
||||
2. Run **Competitive Analysis** to identify opportunities
|
||||
3. Use **Content Strategy Analyzer** for planning
|
||||
4. Use **AI Copilot** for strategic recommendations
|
||||
|
||||
### For SEO Professionals
|
||||
1. Perform **Complete Website Audit** for full assessment
|
||||
2. Use **Technical SEO Analyzer** for technical issues
|
||||
3. Run **Competitive Sitemap Benchmarking** for positioning
|
||||
4. Monitor **Strategic Insights** weekly
|
||||
5. Use **Semantic Health Monitoring** for advanced tracking
|
||||
|
||||
### For E-commerce Businesses
|
||||
1. Analyze **Product Page SEO** with On-Page tool
|
||||
2. Use **Image Alt Text Generator** for product images
|
||||
3. Monitor **Core Web Vitals** with PageSpeed Analyzer
|
||||
4. Track **Keyword Rankings** in Dashboard
|
||||
5. Compare with **Competitive Analysis**
|
||||
|
||||
---
|
||||
|
||||
## 📊 API Statistics
|
||||
|
||||
- **Total Endpoints**: 22+
|
||||
- **Individual Tools**: 9 endpoints
|
||||
- **Dashboard**: 8+ endpoints
|
||||
- **Workflows**: 3 endpoints
|
||||
- **Response Time**: 2-30 seconds depending on tool
|
||||
- **Async Support**: Background processing for long-running tasks
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Key Features Across All Tools
|
||||
|
||||
### AI-Powered
|
||||
- Gemini LLM integration
|
||||
- Vision model support
|
||||
- Natural language processing
|
||||
- Semantic analysis
|
||||
|
||||
### Enterprise-Ready
|
||||
- Comprehensive error handling
|
||||
- Intelligent logging
|
||||
- Rate limiting
|
||||
- Scalable architecture
|
||||
|
||||
### User-Friendly
|
||||
- Clear, actionable recommendations
|
||||
- Priority-based insights
|
||||
- Real-time analysis
|
||||
- Mobile-responsive interface
|
||||
|
||||
### Secure
|
||||
- OAuth 2.0 authentication
|
||||
- Encrypted token storage
|
||||
- Request validation
|
||||
- CORS protection
|
||||
|
||||
---
|
||||
|
||||
## 📈 Performance Benchmarks
|
||||
|
||||
| Tool | Response Time | Async | Typical Use |
|
||||
|------|---------------|-------|------------|
|
||||
| Meta Description | 2-3s | No | Quick SEO tag creation |
|
||||
| PageSpeed | 5-8s | No | Performance analysis |
|
||||
| Sitemap Analysis | 10-15s | No | Content structure review |
|
||||
| On-Page SEO | 8-12s | No | Page optimization |
|
||||
| Technical SEO | 15-30s | No | Full site crawl |
|
||||
| Website Audit | 30-60s | No | Comprehensive audit |
|
||||
| Sitemap Benchmarking | 2-5s | Yes | Background processing |
|
||||
| Dashboard | <1s | N/A | Cached data display |
|
||||
|
||||
---
|
||||
|
||||
## 🎓 Learning Resources
|
||||
|
||||
- **Guides**: Step-by-step tutorials for each tool
|
||||
- **API Docs**: Complete endpoint documentation
|
||||
- **Best Practices**: Optimization tips and strategies
|
||||
- **Case Studies**: Real-world application examples
|
||||
- **Video Tutorials**: Visual learning resources (planned)
|
||||
|
||||
---
|
||||
|
||||
## 🔮 Roadmap
|
||||
|
||||
### Near-Term (Q3 2026)
|
||||
- Complete Phase 2B semantic monitoring
|
||||
- Add Screaming Frog integration
|
||||
- Enhance mobile responsiveness
|
||||
|
||||
### Medium-Term (Q4 2026)
|
||||
- Machine learning-based predictions
|
||||
- Advanced anomaly detection
|
||||
- Automated content recommendations
|
||||
|
||||
### Long-Term (2027)
|
||||
- Mobile app development
|
||||
- White-label solutions
|
||||
- API marketplace
|
||||
|
||||
---
|
||||
|
||||
## 💡 Tips & Best Practices
|
||||
|
||||
1. **Start with Health Score** - Get overall assessment first
|
||||
2. **Focus on High-Priority Issues** - Address critical problems first
|
||||
3. **Use AI Copilot** - Get smart, contextual recommendations
|
||||
4. **Monitor Regularly** - Weekly checks keep you on track
|
||||
5. **Benchmark Competitors** - Use competitive analysis to find opportunities
|
||||
6. **Track Changes** - Use trends to measure progress
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Related Resources
|
||||
|
||||
- [SEO Dashboard Main Guide](overview.md)
|
||||
- [Complete API Reference](../../api/seo-tools.md)
|
||||
- [Blog Writer SEO Integration](../blog-writer/overview.md)
|
||||
- [Content Strategy Guide](../content-strategy/overview.md)
|
||||
- [AI Features](../ai/overview.md)
|
||||
|
||||
---
|
||||
|
||||
**Last Updated**: May 18, 2026
|
||||
**Version**: 1.0
|
||||
**Status**: Production Ready ✅
|
||||
|
||||
For support, visit our documentation or contact support@alwrity.com
|
||||
564
docs-site/docs/features/seo-dashboard/workflows-guide.md
Normal file
564
docs-site/docs/features/seo-dashboard/workflows-guide.md
Normal file
@@ -0,0 +1,564 @@
|
||||
# SEO Workflows & Automation Guide
|
||||
|
||||
## 🔄 Overview
|
||||
|
||||
This guide shows you how to use ALwrity's SEO tools together to create efficient workflows for different use cases. Learn proven workflows from planning to execution.
|
||||
|
||||
---
|
||||
|
||||
## Core Workflows
|
||||
|
||||
### Workflow 1: Content Creation Pipeline
|
||||
|
||||
Complete workflow from planning to optimization:
|
||||
|
||||
```
|
||||
Step 1: Content Gap Analysis
|
||||
└─ Use: Content Strategy Analyzer
|
||||
└─ Output: Top 10 opportunities, keyword recommendations
|
||||
└─ Time: 10 minutes
|
||||
|
||||
Step 2: Research & Planning
|
||||
└─ Use: AI Copilot (get recommendations)
|
||||
└─ Output: Content outline, target keywords
|
||||
└─ Time: 15 minutes
|
||||
|
||||
Step 3: Content Creation
|
||||
└─ Use: Blog Writer
|
||||
└─ Output: Draft content with SEO optimization
|
||||
└─ Time: 30-60 minutes
|
||||
|
||||
Step 4: Meta Optimization
|
||||
└─ Use: Meta Description Generator + OpenGraph Generator
|
||||
└─ Output: Meta tags, social sharing ready
|
||||
└─ Time: 5-10 minutes
|
||||
|
||||
Step 5: Image Optimization
|
||||
└─ Use: Image Alt Text Generator
|
||||
└─ Output: Alt text for all images
|
||||
└─ Time: 5 minutes
|
||||
|
||||
Step 6: Final Optimization
|
||||
└─ Use: On-Page SEO Analyzer
|
||||
└─ Output: Score 80+, optimization checklist
|
||||
└─ Time: 10-15 minutes
|
||||
|
||||
Step 7: Publishing
|
||||
└─ Output: Fully optimized page, ready to publish
|
||||
└─ Time: 5 minutes
|
||||
|
||||
Total Time: 1.5-2 hours per article
|
||||
```
|
||||
|
||||
### Workflow 2: Website Audit & Improvement
|
||||
|
||||
Complete technical and content audit:
|
||||
|
||||
```
|
||||
Step 1: Technical Audit
|
||||
└─ Use: Technical SEO Analyzer
|
||||
└─ Output: Technical issues by severity
|
||||
└─ Time: 15-30 minutes
|
||||
|
||||
Step 2: Comprehensive Audit
|
||||
└─ Use: Enterprise SEO Suite
|
||||
└─ Output: Full audit report with recommendations
|
||||
└─ Time: 30-60 minutes
|
||||
|
||||
Step 3: Gap Analysis
|
||||
└─ Use: Content Strategy Analyzer
|
||||
└─ Output: Content opportunities, recommendations
|
||||
└─ Time: 10-15 minutes
|
||||
|
||||
Step 4: Prioritization
|
||||
└─ Use: AI Copilot (prioritize recommendations)
|
||||
└─ Output: Prioritized action plan
|
||||
└─ Time: 10 minutes
|
||||
|
||||
Step 5: Implementation Planning
|
||||
└─ Output: Sprint plan, timeline, ownership
|
||||
└─ Time: 15 minutes
|
||||
|
||||
Total Time: 1.5-2.5 hours for complete audit
|
||||
```
|
||||
|
||||
### Workflow 3: Performance Optimization
|
||||
|
||||
Optimize existing content for better rankings:
|
||||
|
||||
```
|
||||
Step 1: Identify Underperforming Pages
|
||||
└─ Use: GA4 Dashboard integration
|
||||
└─ Output: Pages with ranking potential but low traffic
|
||||
└─ Time: 10 minutes
|
||||
|
||||
Step 2: On-Page Analysis
|
||||
└─ Use: On-Page SEO Analyzer (batch analysis)
|
||||
└─ Output: Issues and improvement opportunities
|
||||
└─ Time: 5-10 minutes per page
|
||||
|
||||
Step 3: Content Improvement
|
||||
└─ Use: AI Copilot (recommendations)
|
||||
└─ Output: Content improvement strategy
|
||||
└─ Time: 15-20 minutes
|
||||
|
||||
Step 4: Meta Tag Update
|
||||
└─ Use: Meta Description Generator
|
||||
└─ Output: Improved meta descriptions
|
||||
└─ Time: 5 minutes
|
||||
|
||||
Step 5: Performance Check
|
||||
└─ Use: PageSpeed Analyzer
|
||||
└─ Output: Performance baseline
|
||||
└─ Time: 10 minutes
|
||||
|
||||
Step 6: Monitor & Adjust
|
||||
└─ Use: SEO Dashboard
|
||||
└─ Output: Track ranking changes
|
||||
└─ Time: Ongoing
|
||||
|
||||
Total Time: 45-60 minutes per page
|
||||
```
|
||||
|
||||
### Workflow 4: Monthly SEO Maintenance
|
||||
|
||||
Regular maintenance for ongoing optimization:
|
||||
|
||||
```
|
||||
Week 1: Technical Health
|
||||
└─ Task: Run Technical SEO Analyzer
|
||||
└─ Task: Check for new critical issues
|
||||
└─ Task: Fix issues reported
|
||||
└─ Time: 30-45 minutes
|
||||
|
||||
Week 2: Performance Tracking
|
||||
└─ Task: Run PageSpeed Analyzer (key pages)
|
||||
└─ Task: Monitor Core Web Vitals
|
||||
└─ Task: Optimize top pages
|
||||
└─ Time: 30-45 minutes
|
||||
|
||||
Week 3: Content Strategy
|
||||
└─ Task: Run Content Strategy Analyzer
|
||||
└─ Task: Identify new opportunities
|
||||
└─ Task: Update content calendar
|
||||
└─ Time: 30-45 minutes
|
||||
|
||||
Week 4: Full Review
|
||||
└─ Task: Run Enterprise SEO Suite (selective)
|
||||
└─ Task: Compare metrics with previous month
|
||||
└─ Task: Plan next month strategy
|
||||
└─ Time: 60-90 minutes
|
||||
|
||||
Total Monthly Time: 3-3.5 hours
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Industry-Specific Workflows
|
||||
|
||||
### E-Commerce SEO Workflow
|
||||
|
||||
```
|
||||
1. Product Page Optimization
|
||||
├─ Upload product images
|
||||
├─ Generate alt text with product keywords
|
||||
├─ Create optimized meta descriptions with price mentions
|
||||
├─ Generate OpenGraph tags for social sharing
|
||||
└─ Use On-Page SEO to optimize product pages
|
||||
|
||||
2. Category Page Strategy
|
||||
├─ Analyze category page content
|
||||
├─ Check internal linking structure
|
||||
├─ Generate category-level meta descriptions
|
||||
└─ Optimize for category keywords
|
||||
|
||||
3. Competitive Pricing Analysis
|
||||
├─ Use Competitive Analysis tool
|
||||
├─ Compare product strategies
|
||||
├─ Identify market gaps
|
||||
└─ Plan product expansion content
|
||||
|
||||
4. Content Strategy
|
||||
├─ Use Content Strategy Analyzer
|
||||
├─ Identify buying guide opportunities
|
||||
├─ Plan comparison article strategy
|
||||
└─ Create content calendar for seasonal products
|
||||
```
|
||||
|
||||
### B2B SaaS Workflow
|
||||
|
||||
```
|
||||
1. Service Page Optimization
|
||||
├─ Analyze existing service pages
|
||||
├─ Use On-Page SEO Analyzer for each page
|
||||
├─ Optimize meta descriptions for search intent
|
||||
├─ Generate OpenGraph tags for LinkedIn sharing
|
||||
└─ Create internal linking strategy
|
||||
|
||||
2. Blog Strategy
|
||||
├─ Use Content Strategy Analyzer
|
||||
├─ Identify industry trends
|
||||
├─ Plan thought leadership content
|
||||
├─ Create content pillar structure
|
||||
└─ Use Blog Writer for content creation
|
||||
|
||||
3. Integration & Case Studies
|
||||
├─ Document integration tutorials
|
||||
├─ Create case study content
|
||||
├─ Optimize images with alt text
|
||||
├─ Generate social sharing cards
|
||||
└─ Use On-Page SEO for final optimization
|
||||
|
||||
4. Technical Content
|
||||
├─ Document API usage
|
||||
├─ Create implementation guides
|
||||
├─ Optimize code snippet pages
|
||||
└─ Use Technical SEO Analyzer for documentation site
|
||||
```
|
||||
|
||||
### Content Publishing Workflow
|
||||
|
||||
```
|
||||
1. Idea Generation & Planning
|
||||
├─ Run Content Strategy Analyzer
|
||||
├─ Identify top opportunities
|
||||
├─ Consult AI Copilot for ideas
|
||||
├─ Create content outline
|
||||
└─ Research competitor content
|
||||
|
||||
2. Content Creation
|
||||
├─ Write content using Blog Writer
|
||||
├─ Incorporate keywords naturally
|
||||
├─ Add high-quality images
|
||||
├─ Create internal linking plan
|
||||
└─ Write call-to-action
|
||||
|
||||
3. Pre-Publication Checks
|
||||
├─ Use On-Page SEO Analyzer
|
||||
├─ Fix issues identified
|
||||
├─ Ensure score is 80+
|
||||
├─ Check for keyword usage
|
||||
└─ Verify internal links work
|
||||
|
||||
4. Meta & Social Preparation
|
||||
├─ Generate meta description
|
||||
├─ Create OpenGraph tags (platform-specific)
|
||||
├─ Generate alt text for images
|
||||
├─ Create social media snippets
|
||||
└─ Plan social promotion
|
||||
|
||||
5. Publishing & Promotion
|
||||
├─ Schedule social media posts
|
||||
├─ Set up Google Search Console monitoring
|
||||
├─ Plan email announcement
|
||||
├─ Secure backlinks if applicable
|
||||
└─ Monitor initial performance
|
||||
|
||||
6. Post-Publication Monitoring
|
||||
├─ Check PageSpeed on published page
|
||||
├─ Monitor search console for queries
|
||||
├─ Track user metrics (engagement, bounce rate)
|
||||
├─ Wait 2-4 weeks for ranking
|
||||
└─ Optimize based on performance
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Quick Wins Workflow
|
||||
|
||||
Fast SEO improvements with quick impact:
|
||||
|
||||
### Day 1: Meta Description Optimization
|
||||
- Time: 30-45 minutes
|
||||
- Tool: Meta Description Generator
|
||||
- Target: 10-20 high-traffic pages
|
||||
- Expected Impact: 5-15% CTR improvement
|
||||
|
||||
### Day 2: Image Optimization
|
||||
- Time: 30-45 minutes
|
||||
- Tool: Image Alt Text Generator
|
||||
- Target: All pages with images
|
||||
- Expected Impact: Image search traffic, accessibility boost
|
||||
|
||||
### Day 3: Performance Optimization
|
||||
- Time: 45-60 minutes
|
||||
- Tool: PageSpeed Analyzer
|
||||
- Focus: Top 10-20 traffic pages
|
||||
- Expected Impact: Better rankings, improved UX
|
||||
|
||||
### Day 4: Technical Cleanup
|
||||
- Time: 60-90 minutes
|
||||
- Tool: Technical SEO Analyzer
|
||||
- Focus: Fix critical and high issues
|
||||
- Expected Impact: Better crawlability, fewer errors
|
||||
|
||||
### Day 5: On-Page Optimization
|
||||
- Time: 60-90 minutes
|
||||
- Tool: On-Page SEO Analyzer
|
||||
- Target: Target keyword pages
|
||||
- Expected Impact: Ranking improvements on target pages
|
||||
|
||||
**Total Time: 4-5 hours**
|
||||
**Expected Impact: 20-40% organic traffic increase**
|
||||
|
||||
---
|
||||
|
||||
## Collaborative Workflows
|
||||
|
||||
### Team of 2-3 People
|
||||
|
||||
```
|
||||
Developer/DevOps
|
||||
├─ Technical SEO Analysis
|
||||
├─ PageSpeed Optimization
|
||||
├─ Site Performance Monitoring
|
||||
└─ Technical Implementation
|
||||
|
||||
Content Team
|
||||
├─ Content Strategy Planning
|
||||
├─ Content Creation
|
||||
├─ Meta Optimization
|
||||
└─ Alt Text Generation
|
||||
|
||||
Marketing Lead
|
||||
├─ Strategy & Planning
|
||||
├─ Competitive Analysis
|
||||
├─ Social Optimization
|
||||
└─ Performance Monitoring
|
||||
```
|
||||
|
||||
### Team of 5+ People
|
||||
|
||||
```
|
||||
SEO Manager
|
||||
├─ Strategy & Planning
|
||||
├─ Competitive Analysis
|
||||
├─ Tool Coordination
|
||||
└─ Performance Review
|
||||
|
||||
Content Creators (2-3)
|
||||
├─ Content Creation
|
||||
├─ Research
|
||||
├─ Blog Writing
|
||||
└─ Image Sourcing
|
||||
|
||||
Technical SEO Specialist
|
||||
├─ Technical Audits
|
||||
├─ Site Health Monitoring
|
||||
├─ Performance Optimization
|
||||
└─ Implementation
|
||||
|
||||
Metadata Specialist
|
||||
├─ Meta Descriptions
|
||||
├─ Alt Text Generation
|
||||
├─ OpenGraph Tags
|
||||
└─ Schema Markup
|
||||
|
||||
Analytics & Reporting
|
||||
├─ Performance Tracking
|
||||
├─ Reporting
|
||||
├─ Insights & Recommendations
|
||||
└─ Dashboard Management
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Time-Based Workflows
|
||||
|
||||
### 15-Minute Quick Check
|
||||
```
|
||||
1. Run PageSpeed Analyzer on homepage (5 min)
|
||||
2. Check for critical issues in Google Search Console (5 min)
|
||||
3. Run quick On-Page SEO check on top page (5 min)
|
||||
→ Time: 15 minutes
|
||||
```
|
||||
|
||||
### 30-Minute Daily SEO Task
|
||||
```
|
||||
1. Create 2-3 optimized meta descriptions (10 min)
|
||||
2. Generate alt text for 5-10 images (10 min)
|
||||
3. Check PageSpeed on 2-3 pages (10 min)
|
||||
→ Time: 30 minutes
|
||||
→ Output: 2-3 pages optimized
|
||||
```
|
||||
|
||||
### 60-Minute SEO Sprint
|
||||
```
|
||||
1. Run Technical SEO Analyzer (20 min)
|
||||
2. Fix 3-5 identified issues (20 min)
|
||||
3. Create content strategy plan for next sprint (20 min)
|
||||
→ Time: 60 minutes
|
||||
→ Output: Healthier site, content roadmap
|
||||
```
|
||||
|
||||
### 2-Hour Deep Dive
|
||||
```
|
||||
1. Run Enterprise SEO Suite (30 min)
|
||||
2. Prioritize top 10 action items (15 min)
|
||||
3. Start implementation of top 3 items (45 min)
|
||||
4. Plan next steps (10 min)
|
||||
→ Time: 100 minutes
|
||||
→ Output: Clear action plan, started improvements
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Challenges & Solutions
|
||||
|
||||
### Challenge 1: Too Many Tools, Don't Know Where to Start
|
||||
**Solution:**
|
||||
1. Start with Enterprise SEO Suite for overview
|
||||
2. Identify top 5 issues from report
|
||||
3. Use specific tools to address each issue
|
||||
4. Create 90-day improvement plan
|
||||
|
||||
### Challenge 2: Not Seeing Results Quickly
|
||||
**Solution:**
|
||||
1. Focus on high-impact improvements first
|
||||
2. Target quick wins in first month
|
||||
3. Implement fixes consistently
|
||||
4. Monitor progress weekly
|
||||
5. Give ranking changes 4-8 weeks
|
||||
|
||||
### Challenge 3: Team Doesn't Know How to Use Tools
|
||||
**Solution:**
|
||||
1. Create team training session (30-60 min)
|
||||
2. Walk through each tool with examples
|
||||
3. Create workflow documentation
|
||||
4. Start with one tool per team member
|
||||
5. Gradually expand tool usage
|
||||
|
||||
### Challenge 4: Content Strategy Unclear
|
||||
**Solution:**
|
||||
1. Run Content Strategy Analyzer monthly
|
||||
2. Consult AI Copilot for recommendations
|
||||
3. Create content calendar from findings
|
||||
4. Track performance of content created
|
||||
5. Adjust strategy based on results
|
||||
|
||||
### Challenge 5: Continuous Monitoring
|
||||
**Solution:**
|
||||
1. Set monthly check schedule
|
||||
2. Assign ownership for each tool
|
||||
3. Create dashboard for tracking
|
||||
4. Weekly 30-minute check-in
|
||||
5. Monthly full review and planning
|
||||
|
||||
---
|
||||
|
||||
## Automation & Integration Tips
|
||||
|
||||
### Use Google Sheets Integration
|
||||
```
|
||||
1. Use On-Page SEO Analyzer to get page scores
|
||||
2. Export results to Google Sheets
|
||||
3. Sort by score (low first)
|
||||
4. Create action items from sheet
|
||||
5. Track progress in sheet
|
||||
```
|
||||
|
||||
### Create Task Management Integration
|
||||
```
|
||||
1. Run Technical SEO Analyzer
|
||||
2. Export critical issues
|
||||
3. Create tasks in project management tool
|
||||
4. Assign to team members
|
||||
5. Track completion rate
|
||||
```
|
||||
|
||||
### Schedule Recurring Analysis
|
||||
```
|
||||
1. PageSpeed Analyzer: Weekly (top 10 pages)
|
||||
2. Content Strategy: Monthly (full)
|
||||
3. Technical SEO: Biweekly (key areas)
|
||||
4. Enterprise Suite: Quarterly (full site)
|
||||
5. Performance Review: Monthly
|
||||
```
|
||||
|
||||
### Build Reporting Dashboard
|
||||
```
|
||||
1. Use GA4 Dashboard for traffic
|
||||
2. Use GSC Integration for search data
|
||||
3. Use tool results for SEO metrics
|
||||
4. Create monthly SEO report
|
||||
5. Share with stakeholders
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Success Metrics by Workflow
|
||||
|
||||
### Content Creation
|
||||
- Average ranking: Target top 10
|
||||
- Average traffic per article: 500+ views/month
|
||||
- Article publication rate: 4-8 per month
|
||||
- Content strategy alignment: 100%
|
||||
|
||||
### Technical Improvement
|
||||
- Pages with issues: < 50 critical, < 200 medium
|
||||
- Site crawl errors: < 10
|
||||
- 404 redirects: < 5% of pages
|
||||
- Mobile usability issues: 0
|
||||
|
||||
### Performance Optimization
|
||||
- Core Web Vitals: All green
|
||||
- Page load time: < 2.5 seconds
|
||||
- Mobile PageSpeed score: > 80
|
||||
- Desktop PageSpeed score: > 90
|
||||
|
||||
### Content Strategy
|
||||
- Content gap coverage: 80%+ of opportunities
|
||||
- Publishing consistency: 4+ per month
|
||||
- Content topic distribution: Even
|
||||
- Competitor differentiation: Clear
|
||||
|
||||
---
|
||||
|
||||
## Workflow Troubleshooting
|
||||
|
||||
### Tools Taking Too Long
|
||||
**Solution:**
|
||||
- Use smaller crawl depth for Technical SEO
|
||||
- Analyze fewer competitors initially
|
||||
- Run analyses during off-peak hours
|
||||
- Upgrade to premium for faster processing
|
||||
|
||||
### Recommendations Not Relevant
|
||||
**Solution:**
|
||||
- Provide more context to AI Copilot
|
||||
- Use specific target keywords
|
||||
- Review your industry/niche setting
|
||||
- Consult recommendations, don't follow blindly
|
||||
|
||||
### Difficulty Implementing Changes
|
||||
**Solution:**
|
||||
- Prioritize by impact score
|
||||
- Start with quick wins
|
||||
- Get developer help for technical items
|
||||
- Create implementation checklist
|
||||
- Track progress weekly
|
||||
|
||||
### Team Not Adopting Workflows
|
||||
**Solution:**
|
||||
- Show clear ROI from tool usage
|
||||
- Provide training and documentation
|
||||
- Start with one team member
|
||||
- Celebrate early wins
|
||||
- Iterate workflows based on feedback
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. **Choose Your Workflow**: Pick a workflow from above
|
||||
2. **Schedule Time**: Block calendar for SEO tasks
|
||||
3. **Gather Team**: Assign responsibilities
|
||||
4. **Create Checklist**: Document your process
|
||||
5. **Start Implementation**: Take first step
|
||||
6. **Monitor Progress**: Track metrics weekly
|
||||
7. **Optimize**: Adjust workflow based on results
|
||||
8. **Scale**: Add more tools and tasks as comfortable
|
||||
|
||||
---
|
||||
|
||||
**Ready to implement a workflow? Start with [Content Creation Pipeline](#workflow-1-content-creation-pipeline) or see [Individual Tools Guide](individual-tools-guide.md) for tool details!**
|
||||
Reference in New Issue
Block a user