SEO Keywords
SEO Keywords
Overview
The SEO Keywords module provides comprehensive keyword research, analysis, and management tools to optimize your content's search engine performance. It leverages advanced algorithms including TF-IDF (Term Frequency-Inverse Document Frequency) analysis to help you identify optimal keywords, analyze keyword density, and discover content opportunities for better search rankings.
Accessing SEO Keywords
Navigation Path: Dashboard > SEO System > SEO Keywords
Required Permission: blog.view
URL: /admin/seo/keywords
Key Features
- Keyword Research Tools: Advanced keyword analysis and suggestion algorithms
- TF-IDF Analysis: Scientific approach to keyword density optimization
- Keyword Gap Analysis: Identify posts missing focus keywords
- Density Analysis: Monitor keyword density across all content
- Usage Statistics: Track keyword performance and usage patterns
- Related Keywords: Discover semantically related keyword opportunities
- Bulk Operations: Manage keywords across multiple posts efficiently
- Competition Analysis: Understand internal keyword competition
Main Interface
Page Header
The keywords page provides:
- Page Title: "Keyword Research" with management subtitle
- Refresh Button: Update data and clear caches
- Real-time Statistics: Live keyword usage metrics
Statistics Dashboard
Four key metrics provide keyword usage overview:
Total Keywords
- Display: Count of unique focus keywords in use
- Purpose: Shows keyword diversity across content
- Icon: Key symbol indicating keyword management
Posts with Keywords
- Display: Number of posts with assigned focus keywords
- Coverage Percentage: Percentage of total posts with keywords
- Purpose: Tracks keyword assignment progress
Missing Keywords
- Display: Count of posts without focus keywords
- Purpose: Identifies optimization opportunities
- Action: Direct link to posts needing keywords
Keyword Gaps
- Display: Number of content gaps identified
- Purpose: Shows opportunities for new content
- Analysis: Based on keyword research algorithms
Keyword Research Tools
Top Keywords Analysis
Table showing most frequently used focus keywords:
Columns
- Keyword: The focus keyword text with tag icon
- Usage Count: Number of posts using this keyword (with badge)
- Actions: Research button for detailed analysis
Features
- Usage Tracking: Monitor which keywords are most popular
- Research Access: Click "Research" for detailed keyword analysis
- Visual Indicators: Color-coded badges for usage frequency
Keyword Research Modal
Detailed analysis popup for individual keywords:
Research Data
- Usage Statistics: How many posts use this keyword
- Related Posts: List of posts targeting this keyword
- Related Keywords: Semantically similar keyword suggestions
- Competition Analysis: Internal competition assessment
Analysis Features
- Similarity Scoring: Algorithm-based keyword relationship analysis
- Usage Patterns: Historical usage trends
- Optimization Suggestions: Recommendations for keyword strategy
Keyword Gap Analysis
Missing Keywords Table
Identifies posts without focus keywords:
Columns
- Post Title: Title of the post missing keywords
- Category: Content category with badge styling
- Actions: "Edit Post" link for immediate optimization
Strategic Value
- Quick Wins: Easy optimization opportunities
- Coverage Improvement: Increase keyword assignment percentage
- SEO Enhancement: Improve overall content optimization
Gap Identification Algorithm
The system identifies gaps by:
- Database Query: Posts with NULL focus_keyword field
- Category Analysis: Distribution of gaps across categories
- Priority Scoring: Based on post performance and potential
Keyword Density Analysis
Density Distribution
Visual breakdown of keyword density across content:
Density Categories
- Optimal (1-3%): Green - Ideal keyword density range
- Too Low (<1%): Yellow - Insufficient keyword presence
- Too High (>3%): Red - Risk of keyword stuffing
- Average Density: Blue - Overall content average
Analysis Algorithm
Keyword Density = (Keyword Count / Total Word Count) × 100
Optimization Guidelines
- Target Range: 1-3% for optimal SEO performance
- Natural Usage: Keywords should appear naturally in content
- Avoid Stuffing: Excessive density can harm rankings
Advanced Keyword Analysis
TF-IDF Analysis
Term Frequency-Inverse Document Frequency analysis for keyword optimization:
TF-IDF Components
- Term Frequency (TF): How often a keyword appears in a document
- Inverse Document Frequency (IDF): How rare the keyword is across all documents
- TF-IDF Score: Combined score indicating keyword importance
Applications
- Keyword Suggestions: Identify important terms in content
- Content Optimization: Optimize existing content for better keywords
- Competitive Analysis: Compare keyword usage across posts
BM25 Relevance Scoring
Advanced relevance algorithm for keyword analysis:
BM25 Features
- Relevance Scoring: Measure how well content matches keywords
- Document Length Normalization: Account for content length variations
- Saturation Handling: Prevent over-optimization penalties
Optimization Suggestions
- Content Improvements: Specific recommendations for keyword usage
- Placement Optimization: Where to place keywords for maximum impact
- Semantic Enhancement: Related terms to improve content relevance
Keyword Research Functions
Keyword Suggestions API
Automated keyword extraction from content:
Input Parameters
- Content: Text content to analyze
- Limit: Number of keyword suggestions to return (default: 10)
Output
- Ranked Keywords: Keywords sorted by TF-IDF importance
- Relevance Scores: Numerical scores for each keyword
- Usage Recommendations: How to implement suggested keywords
Related Keywords Discovery
Find semantically related keywords:
Similarity Algorithm
Similarity = Intersection(Words1, Words2) / Union(Words1, Words2)
Features
- Semantic Analysis: Find conceptually related terms
- Usage Patterns: How related keywords are used across content
- Opportunity Identification: Gaps in related keyword coverage
Keyword Performance Tracking
Usage Statistics
Monitor keyword performance across content:
Metrics Tracked
- Usage Count: How many posts use each keyword
- Performance Correlation: Relationship between keywords and SEO scores
- Trend Analysis: Keyword usage patterns over time
Competition Analysis
Understand internal keyword competition:
Competition Metrics
- Internal Competition: How many posts target the same keyword
- Difficulty Assessment: Estimated optimization difficulty
- Cannibalization Risk: Potential for keyword cannibalization
Keyword Prominence Analysis
Placement Analysis
Analyze where keywords appear in content:
Prominence Factors
- In Title: Keyword presence in post title
- In Meta Description: Keyword in meta description
- In First Paragraph: Keyword in opening content
- In Headings: Keyword in H1-H6 tags
Optimization Recommendations
- Title Optimization: Include keywords in titles when natural
- Meta Description: Ensure keywords appear in meta descriptions
- Content Structure: Place keywords in prominent content positions
Bulk Keyword Operations
Mass Keyword Assignment
Efficiently manage keywords across multiple posts:
Bulk Operations
- Keyword Assignment: Add keywords to multiple posts
- Keyword Updates: Change keywords across related content
- Gap Filling: Automatically suggest keywords for posts without them
Batch Analysis
Analyze multiple posts simultaneously:
Analysis Features
- Density Checking: Bulk keyword density analysis
- Prominence Review: Check keyword placement across posts
- Optimization Scoring: Bulk SEO score impact assessment
API Endpoints
Keyword Analysis API
Programmatic access to keyword analysis:
Available Endpoints
- POST /admin/seo/keywords/analyze: Analyze keywords for specific post
- POST /admin/seo/keywords/suggestions: Get keyword suggestions for content
- POST /admin/seo/keywords/research: Research specific keyword data
Request/Response Format
{
"keyword": "example keyword",
"density": 2.5,
"prominence": {
"in_title": true,
"in_meta_description": false,
"in_first_paragraph": true,
"in_headings": false
},
"relevance": 0.85,
"suggestions": ["related keyword 1", "related keyword 2"]
}
Troubleshooting
Common Issues
No Keywords Displayed
Symptoms: Empty keyword tables or zero statistics
Solutions:
- Verify blog posts have focus keywords assigned
- Check that posts are published (not draft status)
- Ensure database contains blog post data
- Run keyword analysis if no data exists
Incorrect Density Calculations
Symptoms: Unexpected keyword density percentages
Solutions:
- Verify content contains the specified keywords
- Check for HTML tags affecting word count
- Ensure keyword matching is case-insensitive
- Review content for hidden or encoded characters
Research Modal Not Loading
Symptoms: Keyword research popup fails to load data
Solutions:
- Check browser console for JavaScript errors
- Verify CSRF token is properly set
- Ensure API endpoints are accessible
- Check server logs for backend errors
Slow Keyword Analysis
Symptoms: Long delays when analyzing keywords
Solutions:
- Check database performance and indexing
- Verify TF-IDF corpus cache is functioning
- Optimize content processing algorithms
- Consider reducing analysis scope for large datasets
Performance Issues
Large Corpus Processing
Problem: Slow analysis with many blog posts
Solutions:
- Implement corpus caching (3600 seconds default)
- Use database indexing on keyword fields
- Consider background processing for large analyses
- Optimize TF-IDF calculations with efficient algorithms
Memory Usage
Problem: High memory consumption during analysis
Solutions:
- Process content in chunks for large posts
- Implement garbage collection in analysis loops
- Use streaming for large dataset operations
- Optimize data structures for memory efficiency
Best Practices
Keyword Strategy
Research Process
- Content Analysis: Start with existing content analysis
- Gap Identification: Find posts missing keywords
- Density Optimization: Adjust keyword density to optimal range
- Prominence Enhancement: Improve keyword placement
- Performance Monitoring: Track keyword effectiveness
Keyword Selection
- Relevance First: Choose keywords relevant to content
- Search Intent: Match keywords to user search intent
- Competition Balance: Consider internal competition levels
- Long-tail Focus: Target specific, less competitive phrases
Optimization Workflow
Systematic Approach
- Audit Current Keywords: Review existing keyword assignments
- Fill Gaps: Add keywords to posts without them
- Optimize Density: Adjust content for optimal keyword density
- Enhance Prominence: Improve keyword placement in key areas
- Monitor Performance: Track SEO score improvements
Content Enhancement
- Natural Integration: Include keywords naturally in content
- Semantic Richness: Use related keywords for context
- User Experience: Prioritize readability over keyword density
- Regular Updates: Refresh keywords based on performance data
Technical Optimization
Algorithm Configuration
- TF-IDF Parameters: Tune algorithm parameters for your content
- BM25 Settings: Adjust relevance scoring parameters
- Cache Management: Optimize caching for performance
- Database Indexing: Ensure proper indexing for keyword queries
Integration with Other Modules
SEO Dashboard
- Keyword Metrics: Dashboard displays keyword-related statistics
- Performance Correlation: Keywords impact overall SEO scores
- Recommendation Engine: Keywords inform optimization suggestions
Content Optimization
- Keyword Suggestions: Optimization module uses keyword research
- Density Analysis: Content optimization considers keyword density
- Prominence Scoring: Keyword placement affects optimization scores
Blog Management
- Editor Integration: Keyword analysis available in post editor
- Focus Keyword Field: Direct keyword assignment in post forms
- SEO Preview: Real-time keyword analysis during editing
Future Enhancements
Advanced Research
- External APIs: Integration with Google Keyword Planner, SEMrush
- Trend Analysis: Keyword popularity trends over time
- Seasonal Patterns: Identify seasonal keyword opportunities
AI-Powered Features
- Smart Suggestions: AI-powered keyword recommendations
- Content Generation: Keyword-optimized content suggestions
- Semantic Analysis: Advanced natural language processing
Competitive Intelligence
- Competitor Keywords: Analyze competitor keyword strategies
- Market Gaps: Identify underserved keyword opportunities
- Ranking Tracking: Monitor keyword ranking performance
Related Modules
- SEO Dashboard: Central hub for SEO monitoring and management
- SEO Analytics: Performance tracking and detailed reporting
- Content Optimization: AI-powered content optimization tools
- Blog Management: Blog post creation and editing
- Blog SEO Integration: Per-post SEO analysis integration
Quick Links
Need More Help?
Our comprehensive documentation covers everything from basic setup to advanced configurations. Check out these additional resources: