diff --git a/README.md b/README.md index a3f7f35..f3fb012 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,27 @@ # Trending Keywords App with Opportunity Scoring -A web application that identifies globally trending keywords with high search volume but low competition, and generates ChatGPT-friendly prompts for article creation based on those keywords. +A web application that identifies real-time trending keywords from Google Trends with high search volume but low competition, and generates ChatGPT-friendly prompts for article creation based on those keywords. ## Features +- **Real-time Google Trends Integration**: Fetches current trending topics directly from Google Trends API - **Dynamic Keyword Opportunity Scoring**: Identifies keywords with high search volume but low result count, providing content creation opportunities -- **Multiple Data Sources**: Fetches trending topics from Wikipedia, Google Trends (simulated), and emerging research topics -- **Detailed Metrics Display**: Shows opportunity score, search volume, result count, and competition level for each keyword +- **Advanced Metrics**: Includes Search Relevance (SR) and Difficulty Rating (DR) for better keyword evaluation +- **Color-Coded Quality Indicators**: Green highlighting for high-opportunity keywords +- **Caching Mechanism**: Optimizes performance by reducing API calls with a 30-minute cache +- **Timestamp Display**: Shows when trending data was last updated - **ChatGPT Prompt Generation**: Creates optimized article prompts based on selected keywords and their metrics - **Copy to Clipboard**: One-click copying of generated prompts for easy use with ChatGPT - **Responsive Design**: Works on desktop and mobile devices ## Technical Implementation -- **Frontend-Only Architecture**: Pure HTML, CSS, and JavaScript implementation that runs entirely in the browser +- **Google Trends API Integration**: Real-time data fetching with fallback mechanisms - **Opportunity Scoring Algorithm**: Uses a weighted average of normalized search volume and inverse normalized result count -- **API Integration**: Fetches real-time trending topics from the Wikipedia API with fallback options +- **Color-Coding System**: + - Green: High-quality keywords (score > 70) + - Yellow/Orange: Medium-quality keywords (score 50-70) + - Red: Low-quality keywords (score < 50) - **Asynchronous Data Processing**: Handles multiple data sources and enrichment processes efficiently ## How to Use @@ -33,12 +39,14 @@ A web application that identifies globally trending keywords with high search vo trending-keywords-app/ ├── index.html # Main HTML structure ├── styles.css # CSS styling -└── app.js # JavaScript functionality +├── app.js # JavaScript functionality +└── trends-api.js # Google Trends API integration with caching ``` ## Future Enhancements -- Integration with additional trending topic APIs +- Historical trend analysis +- Keyword clustering by topic +- Export functionality for selected keywords - User accounts to save favorite keywords and prompts -- Advanced filtering options for keyword discovery -- Custom prompt templates for different content types \ No newline at end of file +- Advanced filtering options for keyword discovery \ No newline at end of file