bmad-plus 0.4.0 → 0.4.1

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

@@ -1,109 +0,0 @@
-# Google Search Console Extension — BMAD+ SEO Engine
-
-> Author: Laurent Rochetta | BMAD+ SEO Engine v2.1
-
-## Overview
-
-This extension connects the SEO Engine to Google Search Console API v3 for accessing real organic search performance data. Requires OAuth2 authentication with a Google Cloud project.
-
-## Setup Guide
-
-### 1. Create Google Cloud Project
-1. Go to [Google Cloud Console](https://console.cloud.google.com)
-2. Create a new project or select existing
-3. Enable **Google Search Console API**
-
-### 2. Create OAuth2 Credentials
-1. Go to **APIs & Services > Credentials**
-2. Click **Create Credentials > OAuth 2.0 Client ID**
-3. Application type: **Desktop app**
-4. Download the JSON → save as `credentials.json` in this directory
-
-### 3. First Run
-```bash
-python gsc_client.py --setup
-```
-This opens a browser for OAuth consent. The refresh token is saved to `token.json` for subsequent runs.
-
-### 4. Verify Access
-```bash
-python gsc_client.py --sites
-```
-Should list all verified Search Console properties.
-
-## Commands
-
-```bash
-# List verified sites
-python gsc_client.py --sites
-
-# Top queries (default: 28 days)
-python gsc_client.py --queries https://example.com --days 28
-
-# Top pages by organic traffic
-python gsc_client.py --pages https://example.com --days 28
-
-# Index coverage (errors, valid, excluded)
-python gsc_client.py --coverage https://example.com
-
-# Sitemap status
-python gsc_client.py --sitemaps https://example.com
-
-# Full export (all data, JSON)
-python gsc_client.py --all https://example.com --json > gsc-data.json
-```
-
-## Output Examples
-
-### Queries
-```
-Top Organic Queries (28 days):
-  1. "bmad framework"      — Pos: 3.2, Clicks: 450, CTR: 12.3%, Imp: 3,658
-  2. "ai development tool"  — Pos: 8.1, Clicks: 120, CTR:  3.5%, Imp: 3,428
-  3. "multi-agent coding"   — Pos: 5.4, Clicks:  95, CTR:  7.8%, Imp: 1,218
-```
-
-### Coverage
-```
-Index Coverage:
-  ✅ Valid: 142 pages
-  ⚠️ Valid with warnings: 8 pages
-  ❌ Error: 3 pages
-  ⛔ Excluded: 45 pages (noindex, canonical, etc.)
-```
-
-## Integration with SEO Engine
-
-When this extension is installed, the SKILL.md orchestrator can:
-- Include real organic data in Phase 4 scoring
-- Compare GSC impressions with crawled pages to find content gaps
-- Detect indexed pages with declining CTR → priority optimization targets
-- Cross-reference sitemap URLs with actually indexed pages
-
-## Files
-
-| File | Purpose |
-|------|---------|
-| `EXTENSION.md` | This documentation |
-| `gsc_client.py` | OAuth2 flow + API calls |
-| `requirements.txt` | Python dependencies |
-
-## Dependencies SUPPLÉMENTAIRES
-
-```
-google-auth>=2.0.0
-google-auth-oauthlib>=1.0.0
-google-api-python-client>=2.0.0
-```
-
-## Security Notes
-
-- `credentials.json` — Contains client ID/secret. **Do not commit to Git.**
-- `token.json` — Contains refresh token. **Do not commit to Git.**
-- Add both to `.gitignore`
-
-## Rate Limits
-
-- 1,200 queries per minute per project
-- 25,000 rows per request maximum
-- Data typically 2-3 days delayed

package/oveanet-pack/seo-audit-360/extensions/google-search-console/gsc_client.py

@@ -1,186 +0,0 @@
-#!/usr/bin/env python3
-"""
-Google Search Console Client — OAuth2 API client for organic search data.
-
-Features:
-- OAuth2 flow with credential persistence
-- Query performance data (queries, pages, devices, countries)
-- Index coverage status
-- Sitemap submissions
-
-Author: Laurent Rochetta
-License: MIT
-"""
-
-import argparse
-import json
-import os
-import sys
-from datetime import datetime, timedelta
-
-SCOPES = ["https://www.googleapis.com/auth/webmasters.readonly"]
-CREDENTIALS_FILE = os.path.join(os.path.dirname(__file__), "credentials.json")
-TOKEN_FILE = os.path.join(os.path.dirname(__file__), "token.json")
-
-
-def get_service():
-    """Authenticate and return a Search Console service object."""
-    try:
-        from google.oauth2.credentials import Credentials
-        from google_auth_oauthlib.flow import InstalledAppFlow
-        from googleapiclient.discovery import build
-        from google.auth.transport.requests import Request
-    except ImportError:
-        print(
-            "Error: Missing dependencies. Install:\n"
-            "  pip install google-auth google-auth-oauthlib google-api-python-client",
-            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_FILE} not found.\n"
-                    "Download OAuth2 credentials from Google Cloud Console.\n"
-                    "See EXTENSION.md for setup guide.",
-                    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 build("searchconsole", "v1", credentials=creds)
-
-
-def list_sites(service):
-    """List all verified Search Console properties."""
-    result = service.sites().list().execute()
-    sites = result.get("siteEntry", [])
-    return [{"url": s["siteUrl"], "level": s["permissionLevel"]} for s in sites]
-
-
-def query_performance(service, site_url: str, days: int = 28, dimensions: list = None, row_limit: int = 25):
-    """Query Search Analytics for organic performance data."""
-    if dimensions is None:
-        dimensions = ["query"]
-
-    end_date = datetime.now().date()
-    start_date = end_date - timedelta(days=days)
-
-    body = {
-        "startDate": start_date.isoformat(),
-        "endDate": end_date.isoformat(),
-        "dimensions": dimensions,
-        "rowLimit": row_limit,
-        "dataState": "all",
-    }
-
-    result = service.searchanalytics().query(siteUrl=site_url, body=body).execute()
-    rows = result.get("rows", [])
-
-    return [{
-        "keys": row["keys"],
-        "clicks": row["clicks"],
-        "impressions": row["impressions"],
-        "ctr": round(row["ctr"] * 100, 1),
-        "position": round(row["position"], 1),
-    } for row in rows]
-
-
-def get_sitemaps(service, site_url: str):
-    """Get sitemap submission status."""
-    result = service.sitemaps().list(siteUrl=site_url).execute()
-    sitemaps = result.get("sitemap", [])
-    return [{
-        "path": s["path"],
-        "type": s.get("type", ""),
-        "submitted": s.get("lastSubmitted", ""),
-        "warnings": s.get("warnings", 0),
-        "errors": s.get("errors", 0),
-    } for s in sitemaps]
-
-
-# ── CLI ────────────────────────────────────────────────────────────
-
-def main():
-    parser = argparse.ArgumentParser(
-        description="Google Search Console Client (BMAD+ SEO Engine)"
-    )
-    parser.add_argument("site", nargs="?", help="Site URL (e.g. https://example.com)")
-    parser.add_argument("--setup", action="store_true", help="Run OAuth2 setup flow")
-    parser.add_argument("--sites", action="store_true", help="List verified sites")
-    parser.add_argument("--queries", action="store_true", help="Top queries")
-    parser.add_argument("--pages", action="store_true", help="Top pages")
-    parser.add_argument("--sitemaps", action="store_true", help="Sitemap status")
-    parser.add_argument("--all", action="store_true", help="All data")
-    parser.add_argument("--days", type=int, default=28, help="Days lookback (default: 28)")
-    parser.add_argument("--limit", type=int, default=25, help="Max rows (default: 25)")
-    parser.add_argument("--json", "-j", action="store_true", help="Output as JSON")
-
-    args = parser.parse_args()
-
-    service = get_service()
-
-    if args.setup:
-        print("✅ OAuth2 setup complete. Token saved.")
-        return
-
-    if args.sites:
-        sites = list_sites(service)
-        if args.json:
-            print(json.dumps(sites, indent=2))
-        else:
-            print("\nVerified Sites:")
-            for s in sites:
-                print(f"  {s['url']} ({s['level']})")
-        return
-
-    if not args.site:
-        parser.print_help()
-        return
-
-    if args.queries or args.all:
-        data = query_performance(service, args.site, args.days, ["query"], args.limit)
-        if args.json:
-            print(json.dumps({"queries": data}, indent=2))
-        else:
-            print(f"\nTop Queries ({args.days} days):")
-            for i, row in enumerate(data, 1):
-                q = row["keys"][0]
-                print(f"  {i:2}. \"{q[:50]}\" — Pos: {row['position']}, "
-                      f"Clicks: {row['clicks']:,}, CTR: {row['ctr']}%, Imp: {row['impressions']:,}")
-
-    if args.pages or args.all:
-        data = query_performance(service, args.site, args.days, ["page"], args.limit)
-        if args.json:
-            print(json.dumps({"pages": data}, indent=2))
-        else:
-            print(f"\nTop Pages ({args.days} days):")
-            for i, row in enumerate(data, 1):
-                page = row["keys"][0]
-                print(f"  {i:2}. {page[:60]} — Clicks: {row['clicks']:,}, CTR: {row['ctr']}%")
-
-    if args.sitemaps or args.all:
-        data = get_sitemaps(service, args.site)
-        if args.json:
-            print(json.dumps({"sitemaps": data}, indent=2))
-        else:
-            print(f"\nSitemaps:")
-            for s in data:
-                status = "✅" if s["errors"] == 0 else "❌"
-                print(f"  {status} {s['path']} (type: {s['type']}, errors: {s['errors']})")
-
-
-if __name__ == "__main__":
-    main()

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

@@ -1,4 +0,0 @@
-# Google Search Console Extension — Dependencies
-google-auth>=2.0.0
-google-auth-oauthlib>=1.0.0
-google-api-python-client>=2.0.0

package/oveanet-pack/seo-audit-360/hooks/seo-check.sh

@@ -1,95 +0,0 @@
-#!/bin/bash
-# SEO Pre-Commit Hook — Catches common SEO issues before commit.
-# Install: cp hooks/seo-check.sh .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
-#
-# Author: Laurent Rochetta | BMAD+ SEO Engine
-
-ERRORS=0
-WARNINGS=0
-
-echo "🔎 BMAD+ SEO Pre-Commit Check..."
-
-# Only check staged HTML files
-HTML_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -iE '\.(html|htm|php|jsx|tsx)$')
-
-if [ -z "$HTML_FILES" ]; then
-    echo "  No HTML files staged, skipping SEO check."
-    exit 0
-fi
-
-for FILE in $HTML_FILES; do
-    # Skip node_modules and vendor
-    if echo "$FILE" | grep -qE '(node_modules|vendor|dist|build|\.min\.)'; then
-        continue
-    fi
-
-    CONTENT=$(git show ":$FILE" 2>/dev/null)
-    if [ -z "$CONTENT" ]; then
-        continue
-    fi
-
-    # Check 1: Missing <title> tag
-    if ! echo "$CONTENT" | grep -qi '<title'; then
-        echo "  🔴 $FILE — Missing <title> tag"
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    # Check 2: Empty <title> tag
-    if echo "$CONTENT" | grep -qiE '<title>\s*</title>'; then
-        echo "  🔴 $FILE — Empty <title> tag"
-        ERRORS=$((ERRORS + 1))
-    fi
-
-    # Check 3: Missing meta description
-    if ! echo "$CONTENT" | grep -qi 'name="description"'; then
-        echo "  🟠 $FILE — Missing <meta name=\"description\">"
-        WARNINGS=$((WARNINGS + 1))
-    fi
-
-    # Check 4: Images without alt attribute
-    IMG_NO_ALT=$(echo "$CONTENT" | grep -ciE '<img[^>]*(?!alt)[^>]*>' 2>/dev/null || echo "0")
-    # More reliable: count <img> without alt
-    TOTAL_IMGS=$(echo "$CONTENT" | grep -ci '<img' 2>/dev/null || echo "0")
-    IMGS_WITH_ALT=$(echo "$CONTENT" | grep -ci '<img[^>]*alt=' 2>/dev/null || echo "0")
-    MISSING_ALT=$((TOTAL_IMGS - IMGS_WITH_ALT))
-
-    if [ "$MISSING_ALT" -gt 0 ]; then
-        echo "  🟠 $FILE — $MISSING_ALT image(s) without alt attribute"
-        WARNINGS=$((WARNINGS + 1))
-    fi
-
-    # Check 5: Multiple H1 tags
-    H1_COUNT=$(echo "$CONTENT" | grep -ci '<h1' 2>/dev/null || echo "0")
-    if [ "$H1_COUNT" -gt 1 ]; then
-        echo "  🟡 $FILE — Multiple H1 tags ($H1_COUNT found, should be 1)"
-        WARNINGS=$((WARNINGS + 1))
-    fi
-
-    # Check 6: No H1 tag at all
-    if [ "$H1_COUNT" -eq 0 ]; then
-        echo "  🟠 $FILE — No H1 tag found"
-        WARNINGS=$((WARNINGS + 1))
-    fi
-
-    # Check 7: "Click here" or "Learn more" anchor text
-    BAD_ANCHORS=$(echo "$CONTENT" | grep -ciE '>click here<|>learn more<|>read more<|>here<' 2>/dev/null || echo "0")
-    if [ "$BAD_ANCHORS" -gt 0 ]; then
-        echo "  🟡 $FILE — $BAD_ANCHORS link(s) with generic anchor text (\"click here\", \"learn more\")"
-        WARNINGS=$((WARNINGS + 1))
-    fi
-done
-
-echo ""
-echo "  Results: $ERRORS error(s), $WARNINGS warning(s)"
-
-if [ "$ERRORS" -gt 0 ]; then
-    echo "  ❌ Commit blocked — fix critical SEO issues first!"
-    exit 1
-else
-    if [ "$WARNINGS" -gt 0 ]; then
-        echo "  ⚠️ Commit allowed with warnings — consider fixing these issues."
-    else
-        echo "  ✅ All SEO checks passed!"
-    fi
-    exit 0
-fi