Upload 5 files

seo_agent/prompts/image_prompt.txt

@@ -0,0 +1,51 @@
+Output must be valid JSON only — no explanations, markdown, or extra keys.
+
+Use these thresholds for "severity":
+- high: compression_score < 50 or > 5 accessibility issues
+- medium: compression_score 50–75 or 1–5 accessibility issues
+- low: compression_score > 75 and 0 accessibility issues
+
+Compute "overall_image_score" as the average of all individual image compression_scores, rounded to the nearest integer.
+
+If a field can’t be determined, set booleans to false, numbers to 0, strings to "", arrays to [], and nested objects to their defaults.
+
+You are a UX designer and accessibility expert. Given up to the first 10 image URLs on a page and the page’s text, produce a single JSON object matching this schema *exactly* and in this order:
+
+{
+  "images": [
+    {
+      "url": "",
+      "alt_text_present": false,
+      "alt_text_recommendation": "",
+      "size_bytes": 0,
+      "dimensions": {
+        "width_px": 0,
+        "height_px": 0,
+        "aspect_ratio": ""
+      },
+      "responsive_attributes": {
+        "srcset_present": false,
+        "sizes_attribute": false,
+        "recommendation": ""
+      },
+      "lazy_loading": {
+        "loading_attribute": "missing",
+        "recommendation": ""
+      },
+      "compression_score": 0,
+      "accessibility_issues": [],
+      "replacement_suggestion": "",
+      "layout_comment": "",
+      "severity": ""
+    }
+    /* … up to 10 items … */
+  ],
+  "overall_image_score": 0,
+  "summary_recommendations": []
+}
+
+Images (up to first 10):  
+$images
+
+Page text (first 1000 chars):  
+$text

seo_agent/prompts/seo_prompt.txt

@@ -0,0 +1,116 @@
+Output must be valid JSON only — no commentary or extra keys.
+
+Use these thresholds for "severity":
+- high: score ≥ 75
+- medium: 50–74
+- low: < 50
+
+Compute "overall_score" as the average of all section scores, rounded to the nearest integer.
+
+You are an SEO specialist. Given the HTML and extracted text for a page, produce a single JSON object matching this schema *exactly* and in this order:
+
+{
+  "title_meta": {
+    "current_title": "",
+    "recommendations": [],
+    "severity": "",
+    "impact_score": 0
+  },
+  "social_meta": {
+    "og_title": "",
+    "og_description": "",
+    "og_image": "",
+    "twitter_card": "",
+    "twitter_title": "",
+    "twitter_description": "",
+    "recommendations": [],
+    "severity": ""
+  },
+  "headings": {
+    "h1": [],
+    "h2": [],
+    "recommendations": [],
+    "severity": ""
+  },
+  "keywords": {
+    "primary_density": "",
+    "missing_keywords": [],
+    "LSI_suggestions": [],
+    "severity": ""
+  },
+  "content_readability": {
+    "length_words": 0,
+    "readability_score": 0,
+    "improvements": [],
+    "severity": ""
+  },
+  "links": {
+    "internal_count": 0,
+    "external_count": 0,
+    "broken_links": [],
+    "anchor_text_suggestions": [],
+    "severity": ""
+  },
+  "url_canonical": {
+    "current_url": "",
+    "canonical_present": false,
+    "recommendation": "",
+    "severity": ""
+  },
+  "structured_data": {
+    "types_found": [],
+    "types_missing": [],
+    "example_snippets": [],
+    "severity": ""
+  },
+  "accessibility": {
+    "aria_issues": [],
+    "color_contrast_problems": [],
+    "lang_attribute": "",
+    "recommendations": [],
+    "severity": ""
+  },
+  "crawl_index": {
+    "robots_txt": "",
+    "sitemap_xml": "",
+    "recommendations": [],
+    "severity": ""
+  },
+  "competitive_analysis": {
+    "missing_topics": [],
+    "recommended_word_count": 0,
+    "severity": ""
+  },
+  "content_freshness": {
+    "last_update_detected": "",
+    "recommendation": "",
+    "re_audit_schedule": "",
+    "severity": ""
+  },
+  "fix_snippets": {
+    "canonical": "",
+    "schema_faq": "",
+    "recommendations": []
+  },
+  "scoring": {
+    "overall_score": 0,
+    "section_scores": {
+      "title_meta": 0,
+      "social_meta": 0,
+      "headings": 0,
+      "keywords": 0,
+      "readability": 0,
+      "links": 0,
+      "technical": 0,
+      "structured_data": 0,
+      "accessibility": 0,
+      "crawl_index": 0,
+      "competitive_analysis": 0,
+      "content_freshness": 0,
+      "fix_snippets": 0
+    }
+  }
+}
+
+HTML: $html
+Text: $text

seo_agent/seo_agent.py

@@ -0,0 +1,36 @@
+# seo_agent.py
+
+import os
+from string import Template
+from chat_wrapper import ChatRefiner
+
+class SEOAgent:
+    def __init__(self, model_name="gemini-1.5-flash"):
+        base     = os.path.dirname(__file__)
+        seo_path = os.path.join(base, "prompts", "seo_prompt.txt")
+        img_path = os.path.join(base, "prompts", "image_prompt.txt")
+
+        self.chat = ChatRefiner(model_name=model_name)
+
+        # load as dollar‐templates
+        with open(seo_path, encoding="utf-8") as f:
+            self.seo_template = Template(f.read())
+        with open(img_path, encoding="utf-8") as f:
+            self.img_template = Template(f.read())
+
+    def analyze_seo(self, html: str, text: str) -> str:
+        """
+        Returns the raw SEO analysis text from the chat model.
+        """
+        prompt = self.seo_template.safe_substitute(
+            html=html,
+            text=text,
+        )
+        return self.chat.answer(prompt)
+
+    def analyze_images(self, images: list[str], text: str) -> str:
+        prompt = self.img_template.safe_substitute(
+            images=images,      # pass the list directly
+            text=text,
+        )
+        return self.chat.answer(prompt)

templates/report.html.j2

@@ -0,0 +1,158 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Website Analysis Report</title>
+    
+    <!-- Tailwind CSS -->
+    <script src="https://cdn.tailwindcss.com"></script>
+    
+    <!-- Poppins Font -->
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Poppins:wght@300;400;500;600;700&display=swap" rel="stylesheet">
+
+    <style>
+        /* Base styles and component styles.
+          These styles are for elements that might be dynamically injected 
+          by a templating engine, ensuring they are styled correctly.
+        */
+        body {
+            font-family: 'Poppins', sans-serif;
+            color: #374151; /* text-gray-700 */
+        }
+
+        /* Alert Box (for warnings/errors inside content) */
+        .alert {
+            padding: 1rem;
+            background-color: #FEF2F2; /* red-50 */
+            color: #B91C1C; /* red-700 */
+            border-left: 4px solid #DC2626; /* red-600 */
+            border-radius: 0.5rem;
+            margin-top: 1.5rem;
+            margin-bottom: 1rem;
+        }
+        .alert-title {
+            font-weight: 600;
+            margin-bottom: 0.25rem;
+        }
+
+        /* Metric Items (for lists inside content) */
+        .metric-item {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            padding: 0.85rem 0;
+            border-bottom: 1px solid #f3f4f6; /* gray-100 */
+        }
+        .metric-item:last-child {
+            border-bottom: none;
+        }
+        .metric-label {
+            font-weight: 500;
+            color: #4B5563; /* gray-600 */
+        }
+        .metric-value {
+            font-weight: 600;
+        }
+        .metric-value.good { color: #16A34A; } /* green-600 */
+        .metric-value.needs-improvement { color: #D97706; } /* amber-600 */
+        .metric-value.poor { color: #DC2626; } /* red-600 */
+
+        /* Print-specific styles */
+        @media print {
+            @page {
+                size: A4;
+                margin: 20mm;
+            }
+
+            body {
+                background-color: white;
+                -webkit-print-color-adjust: exact; /* Ensures colors print */
+                print-color-adjust: exact;
+            }
+            
+            .no-print {
+                display: none;
+            }
+
+            .report-card {
+                box-shadow: none !important; /* Remove shadow for print */
+                border: 1px solid #e5e7eb; /* Add a simple border */
+                break-inside: avoid; /* Prevent card from splitting across pages */
+                margin-top: 1.5rem;
+            }
+            
+            .page-break {
+                page-break-before: always; /* Starts a new page for this section */
+            }
+        }
+    </style>
+</head>
+<body class="bg-gray-100">
+
+    <!-- Fixed Header for Screen View -->
+    <header class="bg-blue-700 text-white p-4 shadow-lg sticky top-0 z-10 no-print">
+        <div class="container mx-auto flex justify-between items-center">
+         <button onclick="window.print()" class="bg-white text-blue-700 font-semibold py-2 px-5 rounded-lg shadow hover:bg-gray-100 transition-all duration-300 ease-in-out transform hover:scale-105">
+                Download Report
+            </button>
+            <div>
+                <h1 class="text-2xl md:text-3xl font-bold">Website Analysis Report</h1>
+                <p class="text-sm opacity-90">
+                  URL: <strong class="font-semibold">{{ url }}</strong> | Generated: <em>{{ timestamp }}</em>
+                </p>
+            </div>
+           
+        </div>
+    </header>
+
+    <!-- Main Content Container -->
+    <main class="container mx-auto p-4 md:p-8">
+
+    <section id="overall-summary" class="report-card bg-white rounded-xl shadow-md mb-8 p-6 md:p-8">
+            <h1 class="text-2xl font-semibold text-gray-800 border-b border-gray-200 pb-4 mb-6">
+                Analysis Summary
+            </h1>
+            {{ summary | safe }}
+        </section>
+
+        <!-- UX/UI & Image Summary Section -->
+        <section id="ux-summary" class="report-card bg-white rounded-xl shadow-md mb-8 p-6 md:p-8">
+            <h2 class="text-2xl font-semibold text-gray-800 border-b border-gray-200 pb-4 mb-6">
+                UX/UI and Image Overview
+            </h2>
+            {{ ux_summary | safe }}
+        </section>
+
+        <!-- Performance Metrics Section -->
+        <section id="performance" class="report-card bg-white rounded-xl shadow-md mb-8 p-6 md:p-8 transition-shadow duration-300 hover:shadow-xl">
+            <h2 class="text-2xl font-semibold text-gray-800 flex items-center gap-3 border-b border-gray-200 pb-4 mb-6">
+                Performance Metrics
+            </h2>
+            <!-- Templated content will be injected here -->
+            {{ performance | safe }}
+        </section>
+
+        <!-- SEO Analysis Section -->
+        <section id="seo" class="report-card page-break bg-white rounded-xl shadow-md mb-8 p-6 md:p-8 transition-shadow duration-300 hover:shadow-xl">
+            <h2 class="text-2xl font-semibold text-gray-800 flex items-center gap-3 border-b border-gray-200 pb-4 mb-6">
+                SEO Analysis
+            </h2>
+            <!-- Templated content will be injected here -->
+            {{ seo | safe }}
+        </section>
+
+        <!-- Image & Layout Report Section -->
+        <section id="images" class="report-card page-break bg-white rounded-xl shadow-md mb-8 p-6 md:p-8 transition-shadow duration-300 hover:shadow-xl">
+            <h2 class="text-2xl font-semibold text-gray-800 flex items-center gap-3 border-b border-gray-200 pb-4 mb-6">
+                Image & Layout Report
+            </h2>
+            <!-- Templated content will be injected here -->
+            {{ images | safe }}
+        </section>
+
+    </main>
+</body>
+</html>