Create app.py

app.py

@@ -0,0 +1,628 @@
+import gradio as gr
+import openai
+import anthropic
+import json
+import os
+from typing import Dict, Any
+
+class SEOAgent:
+    def __init__(self):
+        self.seo_tasks = {
+            "Keyword Research & Analysis": {
+                "description": "Research short-tail and long-tail keywords with competition analysis",
+                "prompt": """You are an expert SEO strategist with 15 years of experience. Your task is to conduct thorough keyword research.
+
+CONTEXT: You must think in first principles - understanding user intent, search behaviour, and market dynamics.
+
+TASK: Analyse the provided topic/industry and deliver actionable keyword insights.
+
+METHODOLOGY:
+1. Identify 10-15 high-value short-tail keywords (1-2 words)
+2. Generate 20-30 long-tail keywords (3+ words) with commercial intent
+3. Categorise keywords by search intent (informational, navigational, commercial, transactional)
+4. Estimate search volumes and competition levels
+5. Identify keyword gaps competitors might be missing
+
+OUTPUT FORMAT:
+- Primary Keywords (short-tail)
+- Long-tail Opportunities
+- Intent Classification
+- Competition Analysis
+- Content Gap Opportunities
+- Recommended Focus Keywords (top 5 with rationale)
+
+CONSTRAINTS:
+- Use British English
+- Be direct and actionable
+- Consider second-order effects (how these keywords impact overall strategy)
+- Think about third-order consequences (long-term brand positioning)
+
+Industry/Topic: {user_input}"""
+            },
+            
+            "Technical SEO Audit": {
+                "description": "Detailed technical analysis and recommendations",
+                "prompt": """You are a technical SEO specialist with deep expertise in website architecture and search engine mechanics.
+
+FIRST PRINCIPLES THINKING: Search engines need to crawl, understand, and index content efficiently.
+
+TASK: Conduct a thorough technical SEO analysis for the provided website.
+
+AUDIT FRAMEWORK:
+1. Site Architecture Assessment
+   - URL structure evaluation
+   - Internal linking analysis
+   - Navigation hierarchy review
+
+2. Technical Performance
+   - Page speed factors
+   - Core Web Vitals considerations
+   - Mobile responsiveness issues
+
+3. Indexation Analysis
+   - Crawl accessibility
+   - XML sitemap structure
+   - Robots.txt configuration
+
+4. On-page Technical Elements
+   - Meta tag optimisation
+   - Schema markup opportunities
+   - Header tag hierarchy
+
+SECOND-ORDER CONSIDERATIONS:
+- How technical issues impact user experience
+- Effect on conversion rates and business metrics
+
+THIRD-ORDER CONSEQUENCES:
+- Long-term search visibility implications
+- Brand credibility and trust factors
+
+OUTPUT STRUCTURE:
+- Critical Issues (immediate fixes required)
+- Moderate Priority Items
+- Enhancement Opportunities
+- Implementation Roadmap (30/60/90 days)
+
+Website URL: {user_input}"""
+            },
+            
+            "Content Strategy Development": {
+                "description": "Create a detailed content strategies aligned with SEO goals",
+                "prompt": """You are a content strategist who understands the intersection of user needs, search behaviour, and business objectives.
+
+FIRST PRINCIPLES: Content must solve user problems whilst achieving business goals through search visibility.
+
+OBJECTIVE: Develop a detailed content strategy for the specified industry/niche.
+
+STRATEGIC FRAMEWORK:
+1. Audience Analysis
+   - Primary and secondary personas
+   - Content consumption patterns
+   - Pain points and information needs
+
+2. Content Pillars
+   - Core topic areas
+   - Supporting subtopics
+   - Content cluster strategy
+
+3. Content Types & Formats
+   - Blog posts, guides, resources
+   - Video, infographic, interactive content
+   - Gated vs. ungated content strategy
+
+4. Editorial Calendar Planning
+   - Publishing frequency recommendations
+   - Seasonal content opportunities
+   - Evergreen vs. trending content balance
+
+SECOND-ORDER EFFECTS:
+- How content supports different funnel stages
+- Cross-promotional opportunities
+- Social media amplification potential
+
+THIRD-ORDER IMPLICATIONS:
+- Brand authority building
+- Industry thought leadership positioning
+- Long-term organic traffic growth
+
+DELIVERABLES:
+- Content Pillar Framework
+- 30 Content Ideas with SEO Focus
+- Editorial Calendar Template
+- Content Performance KPIs
+- Resource Requirements
+
+Industry/Business Focus: {user_input}"""
+            },
+            
+            "Competitor SEO Analysis": {
+                "description": "Analyse competitor strategies and identify opportunities",
+                "prompt": """You are a competitive intelligence analyst specialising in SEO strategy evaluation.
+
+ANALYTICAL APPROACH: Reverse-engineer successful competitor strategies whilst identifying market gaps.
+
+MISSION: Conduct a detailed competitor analysis to uncover strategic opportunities.
+
+ANALYSIS FRAMEWORK:
+1. Competitor Identification
+   - Direct competitors
+   - Indirect/industry competitors
+   - Aspirational competitors (different sectors, similar strategies)
+
+2. Content Strategy Analysis
+   - Top-performing content types
+   - Content gap identification
+   - Publishing patterns and frequency
+
+3. Keyword Strategy Evaluation
+   - Keyword overlap analysis
+   - Competitor-unique keywords
+   - Ranking position comparisons
+
+4. Technical Strategy Assessment
+   - Site architecture approaches
+   - User experience patterns
+   - Technical advantages/disadvantages
+
+5. Link Building Strategy Review
+   - Backlink profile analysis
+   - Link acquisition patterns
+   - Authority building approaches
+
+SECOND-ORDER CONSIDERATIONS:
+- Market positioning implications
+- Resource allocation insights
+- Timing and opportunity windows
+
+THIRD-ORDER STRATEGY:
+- Long-term competitive differentiation
+- Market leadership positioning
+- Industry disruption opportunities
+
+OUTPUT STRUCTURE:
+- Competitor Landscape Overview
+- Strategic Strengths & Weaknesses
+- Opportunity Matrix
+- Recommended Actions (immediate, short-term, long-term)
+- Competitive Differentiation Strategy
+
+Competitor Domain(s) or Industry: {user_input}"""
+            },
+            
+            "Link Building Strategy": {
+                "description": "Develop detailed link acquisition strategies",
+                "prompt": """You are a digital PR and link building expert with proven success in building high-authority backlink profiles.
+
+CORE PRINCIPLE: Quality links come from creating genuine value and building authentic relationships.
+
+OBJECTIVE: Design a detailed link building strategy for the specified website/industry.
+
+STRATEGIC APPROACH:
+1. Link Opportunity Audit
+   - Industry-relevant websites
+   - Competitor backlink analysis
+   - Broken link opportunities
+   - Resource page inclusions
+
+2. Content-Led Link Building
+   - Linkable asset creation
+   - Digital PR campaign ideas
+   - Industry research and surveys
+   - Expert roundup opportunities
+
+3. Relationship Building Framework
+   - Industry influencer identification
+   - Partnership opportunities
+   - Guest posting prospects
+   - Podcast appearance possibilities
+
+4. Technical Link Strategies
+   - Internal linking optimisation
+   - Link reclamation opportunities
+   - Brand mention conversion
+   - Competitor link replication
+
+SECOND-ORDER EFFECTS:
+- Brand awareness and visibility
+- Referral traffic generation
+- Industry relationship development
+
+THIRD-ORDER BENEFITS:
+- Market authority establishment
+- Long-term partnership development
+- Crisis communication network
+
+DELIVERABLES:
+- Target Website List (50+ prospects)
+- Outreach Email Templates
+- Content Campaign Ideas
+- Monthly Link Building Calendar
+- Success Metrics and KPIs
+
+Website/Industry: {user_input}"""
+            },
+            
+            "Local SEO Optimisation": {
+                "description": "Optimise for local search visibility and conversions",
+                "prompt": """You are a local SEO specialist who understands how local businesses win in their geographic markets.
+
+FUNDAMENTAL TRUTH: Local search success requires consistent NAP data, authentic reviews, and genuine community engagement.
+
+TASK: Create a detailed local SEO strategy for the specified business.
+
+OPTIMISATION FRAMEWORK:
+1. Google Business Profile Excellence
+   - Profile completion and optimisation
+   - Category selection strategy
+   - Photo and video content plan
+   - Regular posting schedule
+
+2. Local Citation Building
+   - Core citation sources identification
+   - Industry-specific directories
+   - NAP consistency audit
+   - Citation cleanup requirements
+
+3. Review Management Strategy
+   - Review acquisition campaigns
+   - Response strategy for all reviews
+   - Reputation monitoring system
+   - Customer feedback integration
+
+4. Local Content Strategy
+   - Location-specific content creation
+   - Community event participation
+   - Local partnership opportunities
+   - Geo-targeted keyword integration
+
+5. Technical Local SEO
+   - Schema markup implementation
+   - Location page optimisation
+   - Mobile-first considerations
+   - Local link building
+
+SECOND-ORDER IMPACT:
+- Customer trust and credibility
+- Foot traffic and phone call increases
+- Local market dominance
+
+LONG-TERM VISION:
+- Community brand recognition
+- Market leadership position
+- Sustainable competitive advantage
+
+OUTPUT:
+- Local SEO Audit Results
+- Google Business Profile Action Plan
+- Citation Building Strategy
+- Review Management System
+- Local Content Calendar
+
+Business Name/Location: {user_input}"""
+            },
+            
+            "Performance Analysis & Reporting": {
+                "description": "Analyse SEO performance and create actionable insights",
+                "prompt": """You are a data analyst who transforms SEO metrics into business intelligence and strategic recommendations.
+
+DATA PHILOSOPHY: Numbers tell stories, but insights drive decisions and business growth.
+
+OBJECTIVE: Analyse SEO performance data and provide actionable strategic recommendations.
+
+ANALYSIS FRAMEWORK:
+1. Traffic & Ranking Analysis
+   - Organic traffic trends
+   - Keyword ranking movements
+   - Click-through rate analysis
+   - Impression and position data
+
+2. Conversion & Business Impact
+   - Goal completion analysis
+   - Revenue attribution to organic search
+   - Lead quality assessment
+   - Customer lifetime value correlation
+
+3. Technical Performance Review
+   - Site speed impact on rankings
+   - Core Web Vitals performance
+   - Mobile usability metrics
+   - Crawl error identification
+
+4. Content Performance Evaluation
+   - Top-performing content identification
+   - Content gap analysis
+   - User engagement metrics
+   - Social sharing patterns
+
+SECOND-ORDER INSIGHTS:
+- User behaviour pattern recognition
+- Seasonal trend identification
+- Competitive position changes
+
+STRATEGIC IMPLICATIONS:
+- Resource allocation recommendations
+- Priority setting for improvements
+- ROI optimisation opportunities
+
+REPORTING STRUCTURE:
+- Executive Summary (key wins and challenges)
+- Performance Metrics Dashboard
+- Trend Analysis and Insights
+- Recommended Actions with Timeline
+- Projected Impact Assessment
+
+Website/Data Period: {user_input}"""
+            },
+            
+            "Site Architecture Planning": {
+                "description": "Design optimal website structure for SEO and user experience",
+                "prompt": """You are a website architect who designs structures that serve both users and search engines effectively.
+
+ARCHITECTURAL PRINCIPLE: Great site structure makes information findable, understandable, and actionable.
+
+CHALLENGE: Design optimal website architecture for the specified project requirements.
+
+PLANNING FRAMEWORK:
+1. Information Architecture Design
+   - Content categorisation and hierarchy
+   - User journey mapping
+   - Navigation structure planning
+   - URL structure strategy
+
+2. SEO-Friendly Architecture
+   - Internal linking strategy
+   - Category and tag organisation
+   - Breadcrumb navigation planning
+   - XML sitemap structure
+
+3. User Experience Integration
+   - Mobile-first design considerations
+   - Page load speed optimisation
+   - Conversion path optimisation
+   - Accessibility compliance
+
+4. Technical Implementation
+   - CMS structure recommendations
+   - Database architecture considerations
+   - Caching strategy integration
+   - CDN implementation planning
+
+SECOND-ORDER CONSIDERATIONS:
+- Content scalability requirements
+- Future expansion possibilities
+- Integration with existing systems
+
+LONG-TERM VISION:
+- Sustainable growth accommodation
+- Maintenance and update efficiency
+- Competitive advantage creation
+
+DELIVERABLES:
+- Site Architecture Diagram
+- URL Structure Guidelines
+- Navigation Design Recommendations
+- Internal Linking Strategy
+- Technical Implementation Roadmap
+
+Project Requirements: {user_input}"""
+            }
+        }
+
+    def call_openai(self, api_key: str, prompt: str, user_input: str) -> str:
+        try:
+            client = openai.OpenAI(api_key=api_key)
+            formatted_prompt = prompt.format(user_input=user_input)
+            
+            response = client.chat.completions.create(
+                model="gpt-4o",  # Latest GPT model
+                messages=[
+                    {"role": "system", "content": "You are an expert SEO professional. Follow the prompt instructions precisely. Use British English, be direct and actionable, think in first principles, and consider second and third-order consequences."},
+                    {"role": "user", "content": formatted_prompt}
+                ],
+                max_tokens=2000,
+                temperature=0.7
+            )
+            
+            return response.choices[0].message.content
+            
+        except Exception as e:
+            return f"OpenAI API Error: {str(e)}"
+
+    def call_claude(self, api_key: str, prompt: str, user_input: str) -> str:
+        try:
+            client = anthropic.Anthropic(api_key=api_key)
+            formatted_prompt = prompt.format(user_input=user_input)
+            
+            message = client.messages.create(
+                model="claude-3-5-sonnet-20241022",  # Latest Claude model
+                max_tokens=2000,
+                temperature=0.7,
+                system="You are an expert SEO professional. Follow the prompt instructions precisely. Use British English, be direct and actionable, think in first principles, and consider second and third-order consequences.",
+                messages=[
+                    {
+                        "role": "user",
+                        "content": formatted_prompt
+                    }
+                ]
+            )
+            
+            return message.content[0].text
+            
+        except Exception as e:
+            return f"Claude API Error: {str(e)}"
+
+def create_interface():
+    seo_agent = SEOAgent()
+    
+    def process_seo_task(openai_key, claude_key, selected_task, user_input, selected_model):
+        if not user_input.strip():
+            return "❌ **Error**: Please provide input for your SEO task."
+        
+        if not openai_key.strip() and not claude_key.strip():
+            return "❌ **Error**: Please provide at least one API key (OpenAI or Claude)."
+        
+        if selected_task not in seo_agent.seo_tasks:
+            return "❌ **Error**: Invalid task selection."
+        
+        task_info = seo_agent.seo_tasks[selected_task]
+        prompt = task_info["prompt"]
+        
+        # Format the output header
+        result = f"""# 🚀 SEO Agent Results
+        
+## Task: {selected_task}
+**Model Used**: {selected_model}
+**Input**: {user_input[:100]}{"..." if len(user_input) > 100 else ""}
+
+---
+
+"""
+        
+        try:
+            if selected_model == "OpenAI GPT-4o" and openai_key.strip():
+                ai_response = seo_agent.call_openai(openai_key, prompt, user_input)
+            elif selected_model == "Claude 3.5 Sonnet" and claude_key.strip():
+                ai_response = seo_agent.call_claude(claude_key, prompt, user_input)
+            else:
+                return "❌ **Error**: Selected model requires corresponding API key."
+            
+            result += ai_response
+            
+        except Exception as e:
+            result += f"❌ **Processing Error**: {str(e)}"
+        
+        return result
+    
+    # Create Gradio interface
+    with gr.Blocks(
+        title="SEO Agent - Professional SEO Analysis Tool",
+        theme=gr.themes.Soft(),
+        css="""
+        .gradio-container {
+            max-width: 1200px !important;
+        }
+        .task-description {
+            background: #f8f9fa;
+            border-left: 4px solid #007bff;
+            padding: 15px;
+            margin: 10px 0;
+            border-radius: 5px;
+        }
+        """
+    ) as demo:
+        
+        gr.Markdown("""
+        # 🎯 SEO Agent - Professional SEO Analysis Tool
+        
+        **Transform your SEO strategy with AI-powered insights**
+        
+        This tool provides expert-level SEO analysis across eight core areas professional SEO executives handle daily. Each task uses carefully crafted prompts designed to produce optimal results.
+        
+        ---
+        """)
+        
+        with gr.Row():
+            with gr.Column(scale=1):
+                gr.Markdown("## 🔑 API Configuration")
+                openai_key = gr.Textbox(
+                    label="OpenAI API Key",
+                    type="password",
+                    placeholder="sk-proj-...",
+                    info="Required for GPT-4o analysis"
+                )
+                claude_key = gr.Textbox(
+                    label="Claude API Key", 
+                    type="password",
+                    placeholder="sk-ant-...",
+                    info="Required for Claude 3.5 Sonnet analysis"
+                )
+                
+                selected_model = gr.Radio(
+                    choices=["OpenAI GPT-4o", "Claude 3.5 Sonnet"],
+                    label="Select AI Model",
+                    value="OpenAI GPT-4o",
+                    info="Choose your preferred AI model"
+                )
+                
+            with gr.Column(scale=2):
+                gr.Markdown("## 📋 SEO Task Selection")
+                
+                task_choices = list(seo_agent.seo_tasks.keys())
+                selected_task = gr.Dropdown(
+                    choices=task_choices,
+                    label="Select SEO Task",
+                    value=task_choices[0],
+                    info="Choose the SEO analysis you need"
+                )
+                
+                # Dynamic task description
+                task_description = gr.Markdown(
+                    value=f"**{seo_agent.seo_tasks[task_choices[0]]['description']}**",
+                    elem_classes=["task-description"]
+                )
+                
+                def update_task_description(task):
+                    return f"**{seo_agent.seo_tasks[task]['description']}**"
+                
+                selected_task.change(
+                    fn=update_task_description,
+                    inputs=[selected_task],
+                    outputs=[task_description]
+                )
+        
+        with gr.Row():
+            with gr.Column():
+                user_input = gr.Textbox(
+                    label="Your Input",
+                    placeholder="Enter your website URL, industry, topic, or specific requirements...",
+                    lines=4,
+                    info="Provide relevant details for your selected SEO task"
+                )
+                
+                analyze_btn = gr.Button(
+                    "🔍 Analyse",
+                    variant="primary",
+                    size="lg"
+                )
+        
+        with gr.Row():
+            with gr.Column():
+                output = gr.Markdown(
+                    label="SEO Analysis Results",
+                    value="Results will appear here after analysis...",
+                    height=600
+                )
+        
+        # Button click handler
+        analyze_btn.click(
+            fn=process_seo_task,
+            inputs=[openai_key, claude_key, selected_task, user_input, selected_model],
+            outputs=[output]
+        )
+        
+        gr.Markdown("""
+        ---
+        
+        ## 🎯 Available SEO Tasks
+        
+        1. **Keyword Research & Analysis** - Detailed keyword strategy development
+        2. **Technical SEO Audit** - Complete technical analysis and recommendations  
+        3. **Content Strategy Development** - Strategic content planning aligned with SEO goals
+        4. **Competitor SEO Analysis** - Competitive intelligence and opportunity identification
+        5. **Link Building Strategy** - Authority-building link acquisition strategies
+        6. **Local SEO Optimisation** - Local search visibility and conversion optimisation
+        7. **Performance Analysis & Reporting** - Data-driven insights and strategic recommendations
+        8. **Site Architecture Planning** - Optimal website structure for SEO and UX
+        
+        **Note**: This tool requires either an OpenAI or Claude API key. Results are generated in real-time and formatted for immediate use in your SEO strategy.
+        """)
+    
+    return demo
+
+if __name__ == "__main__":
+    demo = create_interface()
+    demo.launch(
+        server_name="0.0.0.0",
+        server_port=7860,
+        share=True
+    )