Google Prompter Agent AI-Powered Google Search Query Optimization | Advanced Search Operators This actor uses OpenAI's GPT-4 to intelligently craft optimized Google search queries using advanced search operators. It provides true AI-powered query optimization that understands context, intent, and applies the most effective search strategies. Perfect for researchers, SEO professionals, and anyone who wants to master Google search. ## 🎯 What It Does The Google Prompter Agent takes your basic search query and uses artificial intelligence to transform it into multiple highly optimized variations. Unlike rule-based systems, it uses GPT-4 to understand your search intent and contextually apply the most effective Google search operators for maximum results. ## 🔍 Comprehensive Search Operators The actor utilizes all major Google search operators: ### Basic Operators - "" - Exact phrase matching - OR / | - Alternative terms - AND - Required terms - - - Exclude terms - * - Wildcard matching - () - Group searches ### Content Location - intitle: / allintitle: - Words in page title - inurl: / allinurl: - Words in URL - intext: / allintext: - Words in page content ### Site & Domain - site: - Search specific website - related: - Find related sites ### File Types - filetype: / ext: - Search for specific file types ### Date Filtering - before: / after: - Date range filtering ### Special Operators - define: - Get definitions - cache: - View cached pages - source: - News from specific sources - weather: / stocks: / map: / movie: - Specialized searches ## 🚀 Key Features - 🤖 AI-Powered Optimization: Uses OpenAI's GPT-4 for intelligent, contextual query optimization - 🧠 Intent Understanding: AI analyzes your search intent and applies the most effective strategies - 📊 Multiple Variations: Generates 1-10 AI-optimized query variations per request - 🔬 Query Execution: Optional real-time execution with Google Search using Apify's Google Search Scraper - 📈 AI Confidence Scoring: Each query gets an AI-generated confidence score - 📝 Intelligent Explanations: AI provides detailed explanations of optimization strategies - 🎯 Context Awareness: Considers target sites, file types, and user preferences intelligently - 🎛️ Advanced Filtering: Time ranges, must-include/exclude terms, file types, and more - 📋 Professional Output: Structured dataset with multiple views for analysis ## 🔧 Setup Requirements OpenAI API Key: This actor requires an OpenAI API key to function. 1. Visit OpenAI Platform 2. Create an account or sign in 3. Generate a new API key 4. Add the key to the openaiApiKey input field Note: The actor uses GPT-4 for optimal results. Ensure your OpenAI account has access to GPT-4 and sufficient credits. Google Search Integration: When query execution is enabled, this actor uses Apify's Google Search Scraper to execute the optimized queries and retrieve actual search results with full metadata including titles, links, descriptions, and more. ## 📥 Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | openaiApiKey | String | - | Required: Your OpenAI API key for AI optimization | | baseQuery | String | - | Your basic search query to optimize | | searchIntent | Select | general | Type of results you're looking for | | targetSite | String | "" | Specific website to search (for site-specific intent) | | fileType | Select | "" | File type to search for (pdf, doc, etc.) | | timeRange | Select | "" | Filter by time period | | customDateAfter | String | "" | Custom start date (YYYY-MM-DD) | | customDateBefore | String | "" | Custom end date (YYYY-MM-DD) | | excludeTerms | Array | [] | Terms to exclude from results | | mustIncludeTerms | Array | [] | Terms that must be included | | generateVariations | Integer | 3 | Number of query variations (1-10) | | maxResults | Integer | 10 | Maximum search results per query when execution is enabled (1-100) | | enrichmentLevel | Integer | 5 | AI knowledge enrichment level (0-10): 0=no enrichment, 5=moderate, 10=maximum | | executeQueries | Boolean | false | Execute queries with Google Search and retrieve full results | | verbose | Boolean | false | Enable detailed logging | ## 🎯 Search Intent Options - General: Basic optimization for general searches - Research: Targets academic sources, studies, and authoritative content - Documentation: Finds official docs, guides, and technical documentation - News: Focuses on recent news and current events - Academic: Searches for papers, journals, and scholarly content - Shopping: Optimizes for product searches, reviews, and e-commerce - Images/Videos: Media-focused search optimization - Files: Searches for specific document types - Specific Site: Searches within a particular website ## 🧠 AI Knowledge Enrichment Levels The enrichmentLevel parameter (0-10) controls how much AI knowledge is added to your queries: | Level | Description | Example Enhancement | |-------|-------------|-------------------| | 0 | No enrichment | "Jordan Maxwell" → "Jordan Maxwell" | | 1-2 | Minimal | "Jordan Maxwell" → "Jordan Maxwell" OR "Russell Pine" | | 3-4 | Light | "Jordan Maxwell" → "Jordan Maxwell" OR "Russell Pine" occult | | 5-6 | Moderate | "Jordan Maxwell" OR "Russell Pine" occult researcher symbolism | | 7-8 | Strong | "Jordan Maxwell" OR "Russell Pine" occult researcher symbolism astrotheology "secret societies" | | 9-10 | Maximum | "Jordan Maxwell" OR "Russell Pine" occult researcher symbolism astrotheology "secret societies" "religious mythology" esoteric "ancient mysteries" | Benefits of Higher Enrichment: - Finds more comprehensive results - Includes related concepts you might not think of - Uses alternative names and terminology - Adds domain-specific jargon and context When to Use Lower Enrichment: - Very specific searches - When you want only exact matches - Technical or scientific queries where precision matters ## 📊 Example Usage ### Basic Research Query json { "baseQuery": "climate change effects", "searchIntent": "research", "generateVariations": 3, "testQueries": false } ### Documentation Search json { "baseQuery": "React hooks", "searchIntent": "documentation", "excludeTerms": ["stackoverflow", "reddit"], "generateVariations": 5 } ### Academic Paper Search json { "baseQuery": "machine learning algorithms", "searchIntent": "academic", "fileType": "pdf", "timeRange": "year", "generateVariations": 3, "testQueries": true } ### Site-Specific Search json { "baseQuery": "best practices", "searchIntent": "specific_site", "targetSite": "github.com", "mustIncludeTerms": ["javascript"], "generateVariations": 4 } ## 📈 Output Structure Each optimized query includes: json { "id": "unique-id", "query": "optimized search query with operators", "operators": ["site:", "intitle:", "OR"], "intent": "research", "confidence": 0.85, "explanation": "Why this query was generated and what it targets", "actualResults": 1250, "topResultTitles": ["Title 1", "Title 2", "Title 3"], "tested": true, "timestamp": "2024-01-01T00:00:00.000Z" } ## 🎨 Output Views ### Optimized Queries View - Clean table showing all generated queries - Confidence scores and explanations - Operators used and result counts - Perfect for comparing different approaches ### Summary View - High-level overview of the optimization process - Total variations generated - Average confidence scores - All operators used across variations ## 🔧 Advanced Features ### Query Testing When testQueries is enabled, the actor: 1. Runs each optimized query through Google Search 2. Counts actual results returned 3. Captures top result titles 4. Provides real performance data ### Smart Filtering - Time Ranges: Recent results, custom date ranges - Include/Exclude: Fine-tune what appears in results - File Types: Target specific document formats - Site Targeting: Focus on particular domains ### Intent-Based Optimization Different search intents use different optimization strategies: - Research: Targets .edu, .org, PDFs, and academic keywords - Documentation: Focuses on official docs, guides, and API references - News: Emphasizes recent content and reputable news sources - Academic: Prioritizes peer-reviewed content and scholarly sources ## 🚀 Use Cases - SEO Research: Find content gaps and optimization opportunities - Academic Research: Locate scholarly sources and papers - Competitive Analysis: Discover what competitors are doing - Content Discovery: Find authoritative sources on any topic - Technical Documentation: Locate official guides and references - Market Research: Gather industry insights and trends ## 🔗 Integration Perfect for: - Research Workflows: Streamline information gathering - SEO Tools: Enhance keyword research and content discovery - Academic Projects: Find authoritative sources quickly - Content Creation: Discover comprehensive source material - Competitive Intelligence: Uncover competitor strategies ## 🎓 Learning Google Search This actor serves as an educational tool for mastering Google search operators. Each generated query includes explanations of why specific operators were chosen, helping you learn advanced search techniques. ## 📝 Tips for Best Results 1. Be Specific: More specific base queries lead to better optimizations 2. Choose Right Intent: Select the search intent that matches your goals 3. Use Testing: Enable query testing to see real performance data 4. Experiment: Try different intents for the same query to see variations 5. Learn from Explanations: Read the explanations to understand the optimization logic The Google Prompter Agent transforms anyone into a Google search expert, helping you find exactly what you need with precision and efficiency! 🎯