bmad-plus 0.4.0 → 0.4.1

package/oveanet-pack/seo-audit-360/agent/seo-scout.md

@@ -1,171 +0,0 @@
-# SEO Scout — Technical Scanner Agent
-
-> *"I see everything search engines see — and what they don't."*
-
-## Identity
-
-You are **Scout**, the technical reconnaissance agent of the BMAD+ SEO Engine. You crawl, fetch, inspect, and photograph websites to produce raw technical intelligence for the audit pipeline.
-
-## Roles
-
-You operate in 3 switchable roles:
-
-### Role: Crawler
-**Trigger**: Site discovery, multi-page analysis, sitemap exploration
-- Fetch pages with proper HTTP handling (redirects, cookies, timeouts)
-- Parse robots.txt and XML sitemaps to discover the site structure
-- Perform recursive link-following (configurable depth, default: 2 levels, max 25 pages)
-- Detect rendering architecture: SSR vs CSR vs ISR vs hybrid
-- Compare responses between standard UA and Googlebot UA to detect dynamic rendering / prerender services
-- Track redirect chains (flag chains >1 hop)
-
-### Role: Inspector
-**Trigger**: Technical audit, security check, infrastructure analysis
-- Analyze 9 technical SEO categories (see checklist below)
-- Extract HTTP headers and security configuration
-- Evaluate URL structure, canonical setup, and pagination
-- Check hreflang implementation (self-referencing, return tags, x-default)
-- Detect IndexNow protocol support
-- Identify JavaScript rendering dependencies
-
-### Role: Photographer
-**Trigger**: Visual audit, above-the-fold analysis, mobile check
-- Capture viewport screenshots (mobile: 375×812, desktop: 1440×900)
-- Analyze above-the-fold content (CTA visibility, hero element, text readability)
-- Detect layout issues (horizontal scroll, overlapping elements)
-- Verify touch target sizes (minimum 48×48px with 8px spacing)
-
----
-
-## Technical Inspection Checklist (9 Categories)
-
-### 1. Crawlability
-- [ ] robots.txt exists, is valid, doesn't block critical resources
-- [ ] XML sitemap exists, referenced in robots.txt, valid format
-- [ ] Important pages reachable within 3 clicks of homepage
-- [ ] No unintentional noindex/nofollow directives
-- [ ] Crawl budget efficiency (for sites >10K pages)
-- [ ] AI crawler access status (GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot, ChatGPT-User, Bytespider, CCBot, Google-Extended, anthropic-ai, cohere-ai, Applebot-Extended)
-
-### 2. Indexability
-- [ ] Canonical tags: self-referencing, no conflicts with noindex
-- [ ] No duplicate content signals (www/non-www, HTTP/HTTPS, trailing slash)
-- [ ] Pagination handled (rel=next/prev or infinite scroll with indexable URLs)
-- [ ] No index bloat (unnecessary pages wasting crawl budget)
-- [ ] Parameter URLs properly managed
-
-### 3. Security
-- [ ] HTTPS enforced with valid SSL certificate, no mixed content
-- [ ] HSTS enabled (Strict-Transport-Security header)
-- [ ] Content-Security-Policy (CSP) present
-- [ ] X-Frame-Options set
-- [ ] X-Content-Type-Options: nosniff
-- [ ] Referrer-Policy configured
-- [ ] HSTS preload list inclusion (for high-security sites)
-
-### 4. URL Structure
-- [ ] Clean, descriptive, hyphenated URLs
-- [ ] Logical hierarchy reflecting site architecture
-- [ ] No redirect chains (max 1 hop via 301)
-- [ ] URL length reasonable (<100 characters)
-- [ ] Consistent trailing slash usage
-
-### 5. Mobile Optimization
-- [ ] Viewport meta tag present and correct
-- [ ] Responsive CSS (no fixed widths breaking mobile)
-- [ ] Touch targets ≥48×48px with ≥8px spacing
-- [ ] Base font size ≥16px
-- [ ] No horizontal scroll
-- [ ] Mobile-first indexing awareness (100% rollout since July 5, 2024)
-
-### 6. Core Web Vitals (Source Inspection)
-Inspect HTML/CSS for signals. Use PageSpeed Insights API when available.
-
-| Metric | Good | Needs Work | Poor |
-|--------|------|------------|------|
-| **LCP** (Largest Contentful Paint) | ≤2.5s | 2.5–4.0s | >4.0s |
-| **INP** (Interaction to Next Paint) | ≤200ms | 200–500ms | >500ms |
-| **CLS** (Cumulative Layout Shift) | ≤0.1 | 0.1–0.25 | >0.25 |
-
-> **INP replaced FID on March 12, 2024.** FID was fully removed from all Chrome tools on September 9, 2024. Never reference FID.
-
-**LCP Subparts** (for diagnosis):
-| Subpart | Description | Target |
-|---------|-------------|--------|
-| TTFB | Server response time | <800ms |
-| Resource Load Delay | Time from TTFB to resource request | Minimize |
-| Resource Load Time | Download time for LCP resource | Size-dependent |
-| Element Render Delay | Time from loaded to painted | Minimize |
-
-**Common bottlenecks to detect from source**:
-- Unoptimized hero images (no WebP/AVIF, no preload, no lazy-load above fold)
-- Render-blocking CSS/JS (no defer/async, no critical CSS inline)
-- Excessive third-party scripts (analytics, chat widgets, ads)
-- DOM size >1,500 elements (INP concern)
-- Images without width/height dimensions (CLS concern)
-- Web fonts without font-display: swap
-
-### 7. Structured Data (Detection Only)
-- [ ] JSON-LD blocks detected (count and types)
-- [ ] Microdata detected
-- [ ] RDFa detected
-- [ ] Pass findings to **Judge** agent for validation
-
-### 8. JavaScript Rendering
-- [ ] Content visible in raw HTML vs requires JS execution
-- [ ] SPA framework detection (React, Vue, Angular, Svelte, Next.js, Nuxt)
-- [ ] Dynamic rendering setup (Prerender.io, Rendertron)
-- [ ] Google Dec 2025 JS SEO guidance compliance:
-  - Canonical tags identical between server HTML and JS output
-  - No noindex in raw HTML that JS removes
-  - Structured data in initial HTML (not JS-injected for time-sensitive markup)
-  - Non-200 pages: Google does NOT render JS
-
-### 9. IndexNow Protocol
-- [ ] IndexNow API key file present at root
-- [ ] Supported engines: Bing, Yandex, Naver, Seznam
-- [ ] Recommend implementation for faster non-Google indexing
-
----
-
-## Output Format
-
-```markdown
-## 🔎 Scout Report — Technical Analysis
-
-### Site: [URL]
-### Business Type: [Detected type]
-### Pages Crawled: [N]
-### Rendering: [SSR/CSR/Hybrid]
-
-### Technical Score: XX/100
-
-| Category | Status | Score | Issues |
-|----------|--------|-------|--------|
-| Crawlability | ✅/⚠️/❌ | XX/100 | N |
-| Indexability | ✅/⚠️/❌ | XX/100 | N |
-| Security | ✅/⚠️/❌ | XX/100 | N |
-| URL Structure | ✅/⚠️/❌ | XX/100 | N |
-| Mobile | ✅/⚠️/❌ | XX/100 | N |
-| Core Web Vitals | ✅/⚠️/❌ | XX/100 | N |
-| Structured Data | ✅/⚠️/❌ | XX/100 | N |
-| JS Rendering | ✅/⚠️/❌ | XX/100 | N |
-| IndexNow | ✅/⚠️/❌ | XX/100 | N |
-
-### 🔴 Critical Issues
-### 🟠 High Priority
-### 🟡 Medium Priority  
-### 🟢 Low Priority
-```
-
-## Python Toolkit
-
-Use these scripts from `scripts/` directory:
-- `seo_fetch.py <url>` — Fetch with SSRF protection, redirect tracking, multi-UA
-- `seo_parse.py <file.html> --url <base>` — Extract meta, headings, links, schema, word count
-- `seo_crawl.py <url> --depth 2 --max 25` — Recursive crawler with sitemap discovery
-- `seo_screenshot.py <url> --viewport mobile` — Playwright screenshot capture
-
-## Auto-Activation Triggers
-
-Activate Scout when detecting keywords: "crawl", "technical SEO", "robots.txt", "sitemap", "Core Web Vitals", "page speed", "mobile optimization", "security headers", "redirect", "IndexNow", "screenshot"

package/oveanet-pack/seo-audit-360/agent.yaml

@@ -1,70 +0,0 @@
-name: seo-audit-360
-version: 2.0.0
-author: Laurent Rochetta
-brand: Oveanet × Laurent Rochetta
-description: >
-  SEO Engine v2.0 — Complete SEO audit system with 3 multi-role agents,
-  6-phase workflow, Python toolkit, and PageSpeed perfection loop.
-  Covers technical SEO, E-E-A-T, schema validation, GEO (AI search),
-  Core Web Vitals, and auto-fix generation.
-
-agents:
-  - id: seo-scout
-    name: Scout
-    file: agent/seo-scout.md
-    roles: [crawler, inspector, photographer]
-    description: Technical scanner — crawl, fetch, inspect, screenshot
-
-  - id: seo-judge
-    name: Judge
-    file: agent/seo-judge.md
-    roles: [content-expert, schema-master, geo-analyst]
-    description: Content & AI analyst — E-E-A-T, schema, GEO
-
-  - id: seo-chief
-    name: Chief
-    file: agent/seo-chief.md
-    roles: [scorer, strategist, reporter]
-    description: Strategist & reporter — scoring, action plans, monitoring
-
-scripts:
-  - seo_fetch.py
-  - seo_parse.py
-  - seo_crawl.py
-  - seo_screenshot.py
-
-references:
-  - ref/cwv-thresholds.md
-  - ref/schema-catalog.md
-  - ref/eeat-criteria.md
-  - ref/geo-signals.md
-  - ref/quality-gates.md
-  - ref/schema-templates.json
-
-workflow: templates/seo-audit-workflow.md
-
-commands:
-  - /seo full <url>
-  - /seo quick <url>
-  - /seo technical <url>
-  - /seo content <url>
-  - /seo geo <url>
-  - /seo schema <url>
-  - /seo images <url>
-  - /seo hreflang <url>
-  - /seo pagespeed <url>
-  - /seo plan <type>
-  - /seo fix
-  - /seo history
-  - /seo compare
-
-platforms: [bmad, claude, gemini, opencode, codex]
-
-dependencies:
-  required:
-    - python >= 3.10
-  optional:
-    - requests (pip install requests)
-    - beautifulsoup4 (pip install beautifulsoup4)
-    - lxml (pip install lxml)
-    - playwright (pip install playwright && playwright install chromium)

package/oveanet-pack/seo-audit-360/checklist.md

@@ -1,140 +0,0 @@
-# SEO/GEO 360° Audit Checklist
-
-## Usage
-Use this checklist as a template for any website audit. Copy it to your project's output folder and check items as you go.
-
----
-
-## 1. Technical SEO
-- [ ] `robots.txt` exists and is correctly configured
-- [ ] `sitemap.xml` exists with all pages, `lastmod`, `changefreq`, `priority`
-- [ ] Sitemap includes `xhtml:link` hreflang alternates (if multilingual)
-- [ ] Canonical URLs present on all pages
-- [ ] Hreflang tags for each language variant
-- [ ] Meta robots: `index, follow, max-image-preview:large, max-snippet:-1`
-- [ ] HTTPS enforced
-- [ ] No render-blocking resources (fonts preloaded, CSS inlined or local)
-- [ ] Mobile viewport meta tag present
-- [ ] Favicon present (SVG preferred, fallback PNG)
-- [ ] 404 error page exists
-- [ ] Page load time < 3 seconds
-
-## 2. On-Page SEO
-- [ ] `<title>` tag: 50-60 chars, contains primary keyword, unique per page
-- [ ] `<meta description>`: 150-160 chars, contains CTA, unique per page
-- [ ] `<meta keywords>`: relevant long-tail keywords
-- [ ] `<meta author>`: present
-- [ ] Single `<h1>` per page, descriptive, keyword-rich
-- [ ] Logical H2-H6 hierarchy
-- [ ] Images: `alt` tags, `width`/`height`, `loading="lazy"`, WebP format
-- [ ] Internal linking between pages
-- [ ] External links: `rel="noopener"` on `target="_blank"`
-- [ ] Content length adequate (300+ words for landing pages)
-
-## 3. Schema.org / Structured Data
-- [ ] Primary schema type (Organization/LocalBusiness/ProfessionalService)
-- [ ] Service schema for each service offered
-- [ ] FAQPage schema with real Q&As (minimum 5 questions)
-- [ ] WebPage schema (datePublished, dateModified, inLanguage)
-- [ ] BreadcrumbList schema
-- [ ] Person schema for founder/team (if applicable)
-- [ ] Review/AggregateRating schema (if applicable)
-- [ ] Validated with Google Rich Results Test
-
-## 4. GEO (Generative Engine Optimization)
-- [ ] `llms.txt` file at site root with structured business info
-- [ ] Content uses clear headings with question-based format
-- [ ] FAQ section with expandable answers
-- [ ] Concise, factual content per section (answers visible without interaction)
-- [ ] AI crawlers allowed in `robots.txt`:
-  - [ ] GPTBot
-  - [ ] ChatGPT-User
-  - [ ] PerplexityBot
-  - [ ] ClaudeBot
-  - [ ] Google-Extended
-- [ ] Content freshness: `dateModified` in schema, visible update dates
-- [ ] E-E-A-T signals: author credentials, "About" info, LinkedIn links
-- [ ] Tested queries in ChatGPT, Perplexity, and Gemini
-
-## 5. Local SEO
-- [ ] Geo meta tags: `geo.region`, `geo.placename`, `geo.position`, `ICBM`
-- [ ] NAP (Name, Address, Phone/Email) in footer
-- [ ] `<address>` HTML element used
-- [ ] Schema includes `geo` (GeoCoordinates), `areaServed`, `address`
-- [ ] Google Business Profile created and optimized
-- [ ] Local keywords in title, description, and H1
-- [ ] Citations on directories (Pages Jaunes, Google Maps, etc.)
-
-## 6. Accessibility
-- [ ] Skip navigation link
-- [ ] `aria-hidden="true"` on decorative SVGs and elements
-- [ ] `aria-label` on `<section>` and `<nav>` elements
-- [ ] `aria-pressed` on toggle buttons
-- [ ] Color contrast WCAG AA (4.5:1 minimum)
-- [ ] Keyboard-navigable form elements
-- [ ] `<html lang>` attribute set correctly (dynamic for multilingual)
-- [ ] `prefers-reduced-motion` media query support
-
-## 7. Social & Sharing
-- [ ] Open Graph: `og:title`, `og:description`, `og:image`, `og:url`, `og:type`
-- [ ] `og:site_name` present
-- [ ] `og:locale` with `og:locale:alternate` for other languages
-- [ ] `og:image` dimensions 1200×630px
-- [ ] Twitter Card: `twitter:card` (summary_large_image)
-- [ ] Social preview tested with sharing debugger tools
-
-## 8. Multilingual SEO (if applicable)
-- [ ] `<html lang>` dynamic based on selected language
-- [ ] Bilingual `<title>` and `<meta description>` (via server-side logic)
-- [ ] Hreflang tags for each page × each language
-- [ ] `x-default` hreflang set
-- [ ] Schema.org `description` in correct language
-- [ ] OG tags in correct language (`og:locale`)
-- [ ] Sitemap includes hreflang alternates per URL
-- [ ] Language preference persisted (localStorage/cookie)
-- [ ] Auto-detection of browser language (`navigator.language`)
-- [ ] Legal pages (Privacy, Terms) translated
-
-## 9. Content & Keywords
-- [ ] Primary keyword identified per page
-- [ ] Long-tail keyword variants in content
-- [ ] Location-based keywords (city, region, country)
-- [ ] Service-specific keywords
-- [ ] Competitor keyword gap analysis
-- [ ] Content matches search intent (informational, transactional, navigational)
-
-## 10. PageSpeed 100% — Performance Perfection Loop
-> Reference: See `pagespeed-playbook.md` for complete technique catalog with code examples.
-
-### Performance (Impact-Ordered)
-- [ ] Self-hosted fonts (woff2) — no Google CDN
-- [ ] Font preload with `fetchpriority="high"` for critical weight
-- [ ] `font-display: swap` on all `@font-face` rules
-- [ ] ALL CSS inlined in production HTML (zero render-blocking)
-- [ ] `.htaccess` cache headers: 1yr for static assets, 1hr for HTML
-- [ ] Gzip/Brotli compression enabled (mod_deflate)
-- [ ] ALL `<img>` tags have explicit `width` and `height` attributes
-- [ ] Below-fold images have `loading="lazy"`
-- [ ] LCP image has `fetchpriority="high"`
-- [ ] Third-party scripts use `async defer`
-- [ ] CLS = 0 (no layout shifts during load)
-
-### Accessibility (WCAG AA)
-- [ ] ALL text/background combos ≥ 4.5:1 contrast ratio
-- [ ] White text on orange backgrounds replaced with dark text (#1a0800)
-- [ ] Dim/muted text on dark backgrounds brightened to ≥ #a0b0b8
-- [ ] Badge text with transparency backgrounds ≥ #d4dde3
-- [ ] Checked: CTA buttons, active nav states, badges, footer, form labels, tags
-
-### Best Practices
-- [ ] No console errors from own code
-- [ ] Third-party console errors documented as known limitations
-- [ ] All external links have `rel="noopener noreferrer"`
-- [ ] All resources loaded over HTTPS
-
-### Anti-Patterns (NEVER DO)
-- [ ] ❌ Never use `media="print" onload` for CSS (causes CLS 0.936)
-- [ ] ❌ Never load fonts from external CDN without local fallback
-- [ ] ❌ Never leave `<img>` tags without width/height dimensions
-- [ ] ❌ Never fix contrast issues one at a time (batch ALL at once)
-

package/oveanet-pack/seo-audit-360/extensions/google-analytics/EXTENSION.md

@@ -1,79 +0,0 @@
-# Google Analytics 4 Extension — BMAD+ SEO Engine
-
-> Author: Laurent Rochetta | BMAD+ SEO Engine v2.1
-
-## Overview
-
-This extension connects to Google Analytics 4 (GA4) Data API for organic traffic analysis. Uses the same OAuth2 credentials as the Search Console extension.
-
-## Setup Guide
-
-### Prerequisites
-- Google Cloud project with **GA4 Data API** enabled
-- OAuth2 credentials (same `credentials.json` as GSC extension)
-- GA4 property ID (find in GA4 Admin > Property Settings)
-
-### First Run
-```bash
-python ga4_client.py --setup --property 123456789
-```
-
-## Commands
-
-```bash
-# Organic traffic overview
-python ga4_client.py --organic https://example.com --property 123456789 --days 30
-
-# Top organic landing pages
-python ga4_client.py --landing https://example.com --property 123456789 --days 30
-
-# Conversions from organic
-python ga4_client.py --conversions https://example.com --property 123456789 --days 30
-
-# Full export
-python ga4_client.py --all https://example.com --property 123456789 --json > ga4-data.json
-```
-
-## Output Examples
-
-### Organic Traffic
-```
-Organic Traffic (30 days):
-  Sessions:       12,450
-  Users:           8,230
-  New Users:       6,120
-  Engagement Rate: 72.3%
-  Avg Duration:    2m 45s
-  Bounce Rate:     36.1%
-```
-
-### Top Landing Pages
-```
-Top Organic Landing Pages:
-  1. /blog/ai-development    — 2,340 sessions, 78% engagement
-  2. /                        — 1,850 sessions, 65% engagement
-  3. /features               — 1,120 sessions, 82% engagement
-```
-
-## Integration with SEO Engine
-
-When installed, the SEO Engine can:
-- Correlate crawled pages with actual organic traffic
-- Identify high-traffic pages that need SEO optimization
-- Track organic conversion attribution
-- Detect pages with high impressions but low engagement (content quality issues)
-
-## Dependencies
-
-Same Google Auth libraries as GSC extension:
-```
-google-auth>=2.0.0
-google-auth-oauthlib>=1.0.0
-google-analytics-data>=0.18.0
-```
-
-## Security Notes
-
-- Uses same `credentials.json` and `token.json` as GSC extension
-- GA4 property ID is not sensitive but should be stored per-project
-- Add credentials to `.gitignore`

package/oveanet-pack/seo-audit-360/extensions/google-analytics/ga4_client.py

@@ -1,200 +0,0 @@
-#!/usr/bin/env python3
-"""
-Google Analytics 4 Client — GA4 Data API client for organic traffic analysis.
-
-Features:
-- Organic traffic metrics (sessions, users, engagement)
-- Landing page performance
-- Conversion attribution
-- Custom date ranges
-
-Author: Laurent Rochetta
-License: MIT
-"""
-
-import argparse
-import json
-import os
-import sys
-from datetime import datetime, timedelta
-
-SCOPES = ["https://www.googleapis.com/auth/analytics.readonly"]
-CREDENTIALS_FILE = os.path.join(os.path.dirname(__file__), "..", "google-search-console", "credentials.json")
-TOKEN_FILE = os.path.join(os.path.dirname(__file__), "..", "google-search-console", "token.json")
-
-
-def get_client(property_id: str):
-    """Authenticate and return a GA4 BetaAnalyticsData client."""
-    try:
-        from google.oauth2.credentials import Credentials
-        from google_auth_oauthlib.flow import InstalledAppFlow
-        from google.auth.transport.requests import Request
-        from google.analytics.data_v1beta import BetaAnalyticsDataClient
-        from google.analytics.data_v1beta.types import (
-            DateRange, Dimension, Metric, RunReportRequest, FilterExpression,
-            Filter,
-        )
-    except ImportError:
-        print(
-            "Error: Missing dependencies. Install:\n"
-            "  pip install google-auth google-auth-oauthlib google-analytics-data",
-            file=sys.stderr,
-        )
-        sys.exit(1)
-
-    creds = None
-    if os.path.exists(TOKEN_FILE):
-        creds = Credentials.from_authorized_user_file(TOKEN_FILE, SCOPES)
-
-    if not creds or not creds.valid:
-        if creds and creds.expired and creds.refresh_token:
-            creds.refresh(Request())
-        else:
-            if not os.path.exists(CREDENTIALS_FILE):
-                print(f"Error: credentials.json not found. See EXTENSION.md for setup.", file=sys.stderr)
-                sys.exit(1)
-            flow = InstalledAppFlow.from_client_secrets_file(CREDENTIALS_FILE, SCOPES)
-            creds = flow.run_local_server(port=0)
-
-        with open(TOKEN_FILE, "w") as f:
-            f.write(creds.to_json())
-
-    return BetaAnalyticsDataClient(credentials=creds), property_id
-
-
-def run_organic_report(client, property_id: str, days: int = 30) -> dict:
-    """Get organic traffic overview."""
-    from google.analytics.data_v1beta.types import (
-        DateRange, Metric, RunReportRequest, FilterExpression, Filter,
-    )
-
-    end_date = datetime.now().date()
-    start_date = end_date - timedelta(days=days)
-
-    request = RunReportRequest(
-        property=f"properties/{property_id}",
-        date_ranges=[DateRange(start_date=start_date.isoformat(), end_date=end_date.isoformat())],
-        metrics=[
-            Metric(name="sessions"),
-            Metric(name="totalUsers"),
-            Metric(name="newUsers"),
-            Metric(name="engagementRate"),
-            Metric(name="averageSessionDuration"),
-            Metric(name="bounceRate"),
-        ],
-        dimension_filter=FilterExpression(
-            filter=Filter(
-                field_name="sessionDefaultChannelGroup",
-                string_filter=Filter.StringFilter(value="Organic Search"),
-            )
-        ),
-    )
-
-    response = client.run_report(request)
-
-    if not response.rows:
-        return {"error": "No organic data available for this period"}
-
-    row = response.rows[0]
-    return {
-        "sessions": int(row.metric_values[0].value),
-        "users": int(row.metric_values[1].value),
-        "new_users": int(row.metric_values[2].value),
-        "engagement_rate": round(float(row.metric_values[3].value) * 100, 1),
-        "avg_duration_seconds": round(float(row.metric_values[4].value)),
-        "bounce_rate": round(float(row.metric_values[5].value) * 100, 1),
-    }
-
-
-def run_landing_page_report(client, property_id: str, days: int = 30, limit: int = 20) -> list:
-    """Get top organic landing pages."""
-    from google.analytics.data_v1beta.types import (
-        DateRange, Dimension, Metric, RunReportRequest, FilterExpression, Filter,
-        OrderBy,
-    )
-
-    end_date = datetime.now().date()
-    start_date = end_date - timedelta(days=days)
-
-    request = RunReportRequest(
-        property=f"properties/{property_id}",
-        date_ranges=[DateRange(start_date=start_date.isoformat(), end_date=end_date.isoformat())],
-        dimensions=[Dimension(name="landingPage")],
-        metrics=[
-            Metric(name="sessions"),
-            Metric(name="engagementRate"),
-            Metric(name="averageSessionDuration"),
-        ],
-        dimension_filter=FilterExpression(
-            filter=Filter(
-                field_name="sessionDefaultChannelGroup",
-                string_filter=Filter.StringFilter(value="Organic Search"),
-            )
-        ),
-        order_bys=[OrderBy(metric=OrderBy.MetricOrderBy(metric_name="sessions"), desc=True)],
-        limit=limit,
-    )
-
-    response = client.run_report(request)
-
-    return [{
-        "page": row.dimension_values[0].value,
-        "sessions": int(row.metric_values[0].value),
-        "engagement_rate": round(float(row.metric_values[1].value) * 100, 1),
-        "avg_duration": round(float(row.metric_values[2].value)),
-    } for row in response.rows]
-
-
-# ── CLI ────────────────────────────────────────────────────────────
-
-def main():
-    parser = argparse.ArgumentParser(
-        description="Google Analytics 4 Client (BMAD+ SEO Engine)"
-    )
-    parser.add_argument("--property", "-p", required=True, help="GA4 Property ID")
-    parser.add_argument("--organic", action="store_true", help="Organic traffic overview")
-    parser.add_argument("--landing", action="store_true", help="Top landing pages")
-    parser.add_argument("--all", action="store_true", help="All reports")
-    parser.add_argument("--days", type=int, default=30, help="Days lookback (default: 30)")
-    parser.add_argument("--limit", type=int, default=20, help="Max rows (default: 20)")
-    parser.add_argument("--json", "-j", action="store_true", help="Output as JSON")
-    parser.add_argument("--setup", action="store_true", help="Run OAuth2 setup")
-
-    args = parser.parse_args()
-
-    client, property_id = get_client(args.property)
-
-    if args.setup:
-        print("✅ OAuth2 setup complete for GA4.")
-        return
-
-    if args.organic or args.all:
-        data = run_organic_report(client, property_id, args.days)
-        if args.json:
-            print(json.dumps({"organic": data}, indent=2))
-        else:
-            print(f"\nOrganic Traffic ({args.days} days):")
-            if "error" in data:
-                print(f"  {data['error']}")
-            else:
-                mins = data["avg_duration_seconds"] // 60
-                secs = data["avg_duration_seconds"] % 60
-                print(f"  Sessions:       {data['sessions']:,}")
-                print(f"  Users:          {data['users']:,}")
-                print(f"  New Users:      {data['new_users']:,}")
-                print(f"  Engagement:     {data['engagement_rate']}%")
-                print(f"  Avg Duration:   {mins}m {secs}s")
-                print(f"  Bounce Rate:    {data['bounce_rate']}%")
-
-    if args.landing or args.all:
-        pages = run_landing_page_report(client, property_id, args.days, args.limit)
-        if args.json:
-            print(json.dumps({"landing_pages": pages}, indent=2))
-        else:
-            print(f"\nTop Organic Landing Pages:")
-            for i, p in enumerate(pages, 1):
-                print(f"  {i:2}. {p['page'][:55]} — {p['sessions']:,} sessions, {p['engagement_rate']}% engagement")
-
-
-if __name__ == "__main__":
-    main()

package/oveanet-pack/seo-audit-360/extensions/google-analytics/requirements.txt

@@ -1,4 +0,0 @@
-# Google Analytics 4 Extension — Dependencies
-google-auth>=2.0.0
-google-auth-oauthlib>=1.0.0
-google-analytics-data>=0.18.0