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

{
  "baseQuery": "climate change effects",
  "searchIntent": "research",
  "generateVariations": 3,
  "testQueries": false
}

Documentation Search

{
  "baseQuery": "React hooks",
  "searchIntent": "documentation",
  "excludeTerms": ["stackoverflow", "reddit"],
  "generateVariations": 5
}

Academic Paper Search

{
  "baseQuery": "machine learning algorithms",
  "searchIntent": "academic",
  "fileType": "pdf",
  "timeRange": "year",
  "generateVariations": 3,
  "testQueries": true
}

Site-Specific Search

{
  "baseQuery": "best practices",
  "searchIntent": "specific_site",
  "targetSite": "github.com",
  "mustIncludeTerms": ["javascript"],
  "generateVariations": 4
}

📈 Output Structure

Each optimized query includes:

{
  "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! 🎯