feat: rebuild analyzer for SaaS SEO audits

Author: hlixli

.dockerignore

@@ -0,0 +1,12 @@
+.git
+.github
+.venv
+__pycache__
+.pytest_cache
+.mypy_cache
+.ruff_cache
+htmlcov
+tests
+*.pyc
+.env*
+!.env.example

.env.example

@@ -0,0 +1,27 @@
+# Optional shared secret for X-API-Key. Leave empty behind an authenticated gateway.
+SEO_API_KEY=
+
+# Fetch safety and resource budgets.
+SEO_FETCH_TIMEOUT_SECONDS=12
+SEO_MAX_RESPONSE_BYTES=3000000
+SEO_MAX_REDIRECTS=5
+SEO_MAX_CONCURRENT_FETCHES=8
+SEO_ALLOW_PRIVATE_HOSTS=false
+SEO_ALLOWED_PORTS=80,443
+SEO_USER_AGENT=SaaSSEOAnalyzer/2.0 (+https://github.com/hlibsuslov/SEO-Analyzer-API)
+SEO_ROBOTS_USER_AGENT=SaaSSEOAnalyzer
+
+# Cache and crawl limits.
+SEO_CACHE_TTL_SECONDS=300
+SEO_CACHE_MAX_ENTRIES=512
+SEO_MAX_SITE_PAGES=100
+
+# Optional Google PageSpeed Insights integration. It is off by default because it
+# consumes an external quota and makes analysis slower.
+SEO_ENABLE_PAGESPEED=false
+SEO_PAGESPEED_API_KEY=
+SEO_PAGESPEED_TIMEOUT_SECONDS=60
+
+# Comma-separated browser origins. Empty means no CORS middleware is installed.
+SEO_CORS_ORIGINS=
+SEO_LOG_LEVEL=INFO

.github/ISSUE_TEMPLATE/api_change.yml

@@ -13,6 +13,10 @@ body:
     attributes:
       label: Endpoint
       options:
+        - /v1/analyze
+        - /v1/site-audit
+        - /v1/compare
+        - /v1/opportunities
         - /analyze
         - /quick-score
         - /metadata
@@ -49,6 +53,11 @@ body:
     id: impact
     attributes:
       label: Impact & migration (if breaking)
+  - type: textarea
+    id: methodology
+    attributes:
+      label: Scoring or methodology impact
+      description: Explain whether historical scores or schema consumers would change.
   - type: textarea
     id: extra
     attributes:

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,5 +1,5 @@
 name: "🐞 Bug report"
-description: "Report a reproducible problem in Ultimate SEO Analyzer API"
+description: "Report a reproducible problem in SaaS SEO Analyzer API"
 title: "[Bug]: <short summary>"
 labels: ["bug"]
 assignees: []
@@ -13,6 +13,10 @@ body:
     attributes:
       label: Affected endpoint
       options:
+        - /v1/analyze
+        - /v1/site-audit
+        - /v1/compare
+        - /v1/opportunities
         - /analyze
         - /quick-score
         - /metadata
@@ -23,7 +27,7 @@ body:
     id: target_url
     attributes:
       label: URL being analyzed (if applicable)
-      description: Provide a real URL you tested with
+      description: Provide a public URL only if it contains no private or sensitive data
       placeholder: "https://example.com"
   - type: dropdown
     id: client
@@ -32,7 +36,7 @@ body:
       options:
         - cURL
         - Postman
-        - RapidAPI Playground
+        - OpenAPI /docs
         - Node.js (fetch/axios)
         - Python (requests/httpx)
         - Other
@@ -42,7 +46,7 @@ body:
       label: Steps to reproduce
       description: Include precise steps and a request snippet if possible.
       placeholder: |
-        1. Call POST /analyze with body: {...}
+        1. Call GET /v1/analyze?url=...
         2. Observe response 500
         3. ...
       render: bash

.github/ISSUE_TEMPLATE/config.yml

@@ -1,11 +1,11 @@
 blank_issues_enabled: false
 contact_links:
   - name: "💬 Ask a question / General discussion"
-    url: "https://github.com/KovalDenys1/SEO-Analyzer-API/discussions/categories/general"
+    url: "https://github.com/hlibsuslov/SEO-Analyzer-API/discussions"
     about: "Use Discussions for Q&A, troubleshooting, and open ideas."
   - name: "👋 Welcome / Introductions"
-    url: "https://github.com/KovalDenys1/SEO-Analyzer-API/discussions/categories/welcome"
+    url: "https://github.com/hlibsuslov/SEO-Analyzer-API/discussions"
     about: "Say hi and share how you plan to use the API."
   - name: "🔐 Security vulnerability"
-    url: "https://github.com/KovalDenys1/SEO-Analyzer-API/security/policy"
+    url: "https://github.com/hlibsuslov/SEO-Analyzer-API/security/policy"
     about: "Please report security issues via our Security Policy, not public issues."

.github/ISSUE_TEMPLATE/docs.yml

@@ -1,5 +1,5 @@
 name: "📝 Documentation update"
-description: "Propose changes to README, Wiki, or RapidAPI docs"
+description: "Propose changes to README, API, methodology, strategy, or security docs"
 title: "[Docs]: <short summary>"
 labels: ["documentation"]
 assignees: []
@@ -14,13 +14,11 @@ body:
       label: Documentation area
       options:
         - README
-        - Wiki (Home)
-        - Wiki (Getting Started)
-        - Wiki (Endpoints)
-        - Wiki (Examples)
-        - Wiki (FAQ)
-        - Wiki (Changelog)
-        - RapidAPI docs
+        - API guide
+        - Scoring methodology
+        - SaaS SEO playbook
+        - Security model
+        - Changelog
         - Other
     validations:
       required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -1,5 +1,5 @@
 name: "✨ Feature request"
-description: "Suggest an idea or improvement for Ultimate SEO Analyzer API"
+description: "Suggest an improvement for SaaS SEO Analyzer API"
 title: "[Feature]: <short summary>"
 labels: ["enhancement"]
 assignees: []
@@ -22,9 +22,9 @@ body:
       label: Proposed solution
       description: Describe your solution. Include endpoint shape, parameters, and response fields if applicable.
       placeholder: |
-        New endpoint: /quick-score
-        Params: url, includeSuggestions=true
-        Response: { score: 92, ... }
+        New endpoint: /v1/example
+        Input: { ... }
+        Response: { "schema_version": "2.0", ... }
       render: JSON
     validations:
       required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,35 +1,31 @@
-# Pull Request Template
+# Pull request
 
-## 📋 Description
-Please include a summary of the change and the related issue.  
-Link the issue with: Closes #ISSUE_NUMBER
+## Description
 
-## ✅ Type of change
-Select the relevant option(s):
+Summarize the user-visible result, related issue, security/resource implications, and any methodology or schema change.
+
+## Type of change
 
 - [ ] 🐞 Bug fix (non-breaking change which fixes an issue)
 - [ ] ✨ New feature (non-breaking change which adds functionality)
 - [ ] 🧩 API change (may include breaking changes)
 - [ ] 📝 Documentation update
 - [ ] 🔧 Refactor / code style update
 - [ ] ⚡ Performance improvement
-- [ ] ✅ Other (please describe):
-
-## 🔍 Checklist
-- [ ] My code follows the project style guidelines (PEP8, black/flake8).
-- [ ] I have tested my changes locally (`uvicorn main:app --reload`).
-- [ ] I have updated the documentation (README, Wiki, or RapidAPI examples if needed).
-- [ ] I have added/updated tests (if applicable).
-- [ ] I have added a clear commit message and PR title.
+- [ ] Security or resource-boundary improvement
+- [ ] Other (please describe)
 
-## 🧪 How Has This Been Tested?
-Describe the tests you ran to verify your changes. Provide instructions so we can reproduce.
+## Checklist
 
-- Test A
-- Test B
+- [ ] `ruff check .` and `ruff format --check .` pass.
+- [ ] `mypy seo_analyzer` passes.
+- [ ] `pytest --cov --cov-report=term-missing` passes.
+- [ ] Network work, loops, payloads, and returned evidence remain bounded.
+- [ ] New findings include evidence, remediation, confidence, and tests.
+- [ ] Scoring/API changes update methodology, docs, and versioning where needed.
+- [ ] No secrets, private target data, or unsupported ranking claims are included.
 
-## 📸 Screenshots (if applicable)
-Add screenshots or response samples to help explain the changes.
+## How has this been tested?
+Describe the tests you ran to verify your changes. Provide instructions so we can reproduce.
 
-## 📎 Additional context
-Add any other context, links, or references about the pull request here.
+Include exact commands and any relevant public test URLs. Add response samples only after removing sensitive data.

.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      python-dependencies:
+        patterns: ["*"]
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      actions:
+        patterns: ["*"]
+  - package-ecosystem: docker
+    directory: /
+    schedule:
+      interval: weekly

.github/workflows/ci.yml

@@ -0,0 +1,56 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - run: python -m pip install --upgrade pip
+      - run: python -m pip install -e '.[dev]'
+      - run: ruff check .
+      - run: ruff format --check .
+      - run: mypy seo_analyzer
+      - run: pytest --cov --cov-report=term-missing --cov-report=xml
+      - if: matrix.python-version == '3.14'
+        run: pip-audit
+
+  package:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+      - run: python -m pip install --upgrade build pip
+      - run: python -m build
+      - run: python -m pip install dist/*.whl
+      - run: python -c "from seo_analyzer.api import create_app; assert create_app().title"
+
+  container:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: docker/setup-buildx-action@v4
+      - uses: docker/build-push-action@v7
+        with:
+          context: .
+          push: false
+          tags: saas-seo-analyzer:test
+          cache-from: type=gha
+          cache-to: type=gha,mode=max