Skip to content

nexscope-ai/nexscope-ecommerce-skills / ecommerce-geo-score-check

ecommerce.geo-score-check

Verified

Score an ecommerce URL for SEO + GEO readiness and AI citation visibility. Triggers on "geo score", "SEO + GEO score", "check ecommerce GEO", "Amazon/Shopify GEO", "GEO readiness audit". Covers product pages, store pages, marketplace listings, category pages, and homepages, scored from crawlable evidence (not live AI polling).

FileKindSize
.nexscope-manifest.jsonconfig218 B
SKILL.mdskill md14.9 KB
geo-ai-visibility-report-optimized.htmlother86.9 KB
geo-eval-ecommerce/assets/config.jsonconfig388 B
geo-eval-ecommerce/assets/prompts/evaluator.mdmarkdown7.8 KB
geo-eval-ecommerce/profiles/_template/product.mdmarkdown914 B
geo-eval-ecommerce/profiles/_template/queries.csvother1.7 KB
geo-eval-ecommerce/profiles/_template/query_rules.mdmarkdown1.3 KB
geo-eval-ecommerce/profiles/airscape-planetary-design-kilo-coffee-st/product.mdmarkdown1.9 KB
geo-eval-ecommerce/profiles/airscape-planetary-design-kilo-coffee-st/queries.csvother3.2 KB
geo-eval-ecommerce/profiles/airscape-planetary-design-kilo-coffee-st/query_rules.mdmarkdown525 B
geo-eval-ecommerce/profiles/aisi-hair-ombre-blonde-wig-glueless-curl/product.mdmarkdown1.2 KB
geo-eval-ecommerce/profiles/aisi-hair-ombre-blonde-wig-glueless-curl/queries.csvother2.6 KB
geo-eval-ecommerce/profiles/aisi-hair-ombre-blonde-wig-glueless-curl/query_rules.mdmarkdown428 B
geo-eval-ecommerce/profiles/apple-macbook-air-13-m5-2026/product.mdmarkdown1.4 KB
geo-eval-ecommerce/profiles/apple-macbook-air-13-m5-2026/queries.csvother2.3 KB
geo-eval-ecommerce/profiles/apple-macbook-air-13-m5-2026/query_rules.mdmarkdown746 B
geo-eval-ecommerce/profiles/boat-neck-sleeveless-tank-top-shirred-wa/product.mdmarkdown1.1 KB
geo-eval-ecommerce/profiles/boat-neck-sleeveless-tank-top-shirred-wa/queries.csvother2.5 KB
geo-eval-ecommerce/profiles/boat-neck-sleeveless-tank-top-shirred-wa/query_rules.mdmarkdown761 B
geo-eval-ecommerce/profiles/coffee-canister/product.mdmarkdown1.4 KB
geo-eval-ecommerce/profiles/coffee-canister/queries.csvother1.3 KB
geo-eval-ecommerce/profiles/coffee-canister/query_rules.mdmarkdown356 B
geo-eval-ecommerce/profiles/hanging-egg-swing-chair-with-stand-white/product.mdmarkdown1.1 KB
geo-eval-ecommerce/profiles/hanging-egg-swing-chair-with-stand-white/queries.csvother2.7 KB
geo-eval-ecommerce/profiles/hanging-egg-swing-chair-with-stand-white/query_rules.mdmarkdown766 B
geo-eval-ecommerce/profiles/iphone-17-pro/product.mdmarkdown1.4 KB
geo-eval-ecommerce/profiles/iphone-17-pro/queries.csvother2.1 KB
geo-eval-ecommerce/profiles/iphone-17-pro/query_rules.mdmarkdown731 B
geo-eval-ecommerce/profiles/nike-shox-r4-se-fade/product.mdmarkdown1.3 KB
geo-eval-ecommerce/profiles/nike-shox-r4-se-fade/queries.csvother2.3 KB
geo-eval-ecommerce/profiles/nike-shox-r4-se-fade/query_rules.mdmarkdown738 B
geo-eval-ecommerce/profiles/ninja-10-in-1-double-oven-with-flexdoor-/product.mdmarkdown1.8 KB
geo-eval-ecommerce/profiles/ninja-10-in-1-double-oven-with-flexdoor-/queries.csvother2.7 KB
geo-eval-ecommerce/profiles/ninja-10-in-1-double-oven-with-flexdoor-/query_rules.mdmarkdown764 B
geo-eval-ecommerce/profiles/rare-beauty/product.mdmarkdown1.5 KB
geo-eval-ecommerce/profiles/rare-beauty/queries.csvother1.6 KB
geo-eval-ecommerce/profiles/rare-beauty/query_rules.mdmarkdown1.1 KB
geo-eval-ecommerce/profiles/rhode-peptide-lip-tint-sweet-pea/product.mdmarkdown1.2 KB
geo-eval-ecommerce/profiles/rhode-peptide-lip-tint-sweet-pea/queries.csvother2.3 KB
geo-eval-ecommerce/profiles/rhode-peptide-lip-tint-sweet-pea/query_rules.mdmarkdown750 B
geo-eval-ecommerce/profiles/roc-inflatable-stand-up-paddle-board-10f/product.mdmarkdown1.5 KB
geo-eval-ecommerce/profiles/roc-inflatable-stand-up-paddle-board-10f/queries.csvother2.7 KB
geo-eval-ecommerce/profiles/roc-inflatable-stand-up-paddle-board-10f/query_rules.mdmarkdown781 B
geo-eval-ecommerce/profiles/skullcandy-crusher-evo-wireless-headphon/product.mdmarkdown1.2 KB
geo-eval-ecommerce/profiles/skullcandy-crusher-evo-wireless-headphon/queries.csvother2.4 KB
geo-eval-ecommerce/profiles/skullcandy-crusher-evo-wireless-headphon/query_rules.mdmarkdown760 B
geo-eval-ecommerce/scripts/__init__.pyscript0 B
geo-eval-ecommerce/scripts/_next_steps.pyscript5.1 KB
geo-eval-ecommerce/scripts/api_capture_runner.pyscript9.0 KB
geo-eval-ecommerce/scripts/api_client_base.pyscript8.2 KB
geo-eval-ecommerce/scripts/cli.pyscript10.0 KB
geo-eval-ecommerce/scripts/evaluator.pyscript6.9 KB
geo-eval-ecommerce/scripts/html_report.pyscript39.8 KB
geo-eval-ecommerce/scripts/loader.pyscript4.4 KB
geo-eval-ecommerce/scripts/normalizer.pyscript3.0 KB
geo-eval-ecommerce/scripts/preaggregate.pyscript7.0 KB
geo-eval-ecommerce/scripts/profile_builder.pyscript9.5 KB
geo-eval-ecommerce/scripts/send_report_email.pyscript4.4 KB
geo-eval-ecommerce/scripts/task_builder.pyscript2.9 KB
geo-eval-ecommerce/scripts/test_raw_api.pyscript2.6 KB
geo-eval-report-tool.jsscript7.8 KB
references/report-template.htmlother22.7 KB

geo-eval-ecommerce/scripts/loader.py

View on GitHub
"""Load configuration and queries."""

import csv
import json
from datetime import date
from pathlib import Path


CURRENT_YEAR = str(date.today().year)


class AppConfig:
    """App runtime configuration."""
    def __init__(self, profile, engines, engine_configs=None, runs_dir="data/runs",
                 api_parallel=4, eval_parallel=4, eval_batch_size=3, subagent_parallelism=2,
                 capture_timeout_ms=60000, eval_timeout_s=120, eval_max_retries=2,
                 engine_concurrency=None, base_dir=None):
        self.profile = profile
        self.engines = engines
        self.engine_configs = engine_configs or {}
        self.runs_dir = Path(runs_dir)
        self.api_parallel = api_parallel
        self.eval_parallel = eval_parallel
        self.eval_batch_size = eval_batch_size
        self.subagent_parallelism = subagent_parallelism
        self.capture_timeout_ms = capture_timeout_ms
        self.eval_timeout_s = eval_timeout_s
        self.eval_max_retries = eval_max_retries
        self.engine_concurrency = engine_concurrency or {}
        self.base_dir = base_dir or Path(".")


class Query:
    """Single evaluation query."""
    def __init__(self, id, query, category="", user_persona="", notes=""):
        self.id = id
        self.query = query
        self.category = category
        self.user_persona = user_persona
        self.notes = notes


def load_config(base_dir=None):
    """Load config.json and return AppConfig."""
    base_dir = Path(base_dir) if base_dir else Path(".")
    config_path = base_dir / "config.json"
    if not config_path.exists():
        raise FileNotFoundError(f"Config not found: {config_path}")

    raw = json.loads(config_path.read_text(encoding="utf-8"))

    engines = raw.get("engines", [])
    if isinstance(engines, list) and engines and isinstance(engines[0], dict):
        engine_names = [e["name"] for e in engines]
        engine_configs = {e["name"]: e for e in engines}
    elif isinstance(engines, list):
        engine_names = engines
        engine_configs = {}
    else:
        engine_names = []
        engine_configs = {}

    return AppConfig(
        profile=raw.get("profile", ""),
        engines=engine_names,
        engine_configs=engine_configs,
        runs_dir=raw.get("runs_dir", "data/runs"),
        api_parallel=int(raw.get("api_parallel", 4)),
        eval_parallel=int(raw.get("eval_parallel", 4)),
        eval_batch_size=int(raw.get("eval_batch_size", 3)),
        subagent_parallelism=int(raw.get("subagent_parallelism", 2)),
        capture_timeout_ms=int(raw.get("capture_timeout_ms", 60000)),
        eval_timeout_s=int(raw.get("eval_timeout_s", 120)),
        eval_max_retries=int(raw.get("eval_max_retries", 2)),
        engine_concurrency=raw.get("engine_concurrency", {}),
        base_dir=base_dir,
    )


def load_queries(config, profile=None):
    """Load queries from profiles/{profile}/queries.csv with {{year}} injection."""
    profile_name = profile or config.profile
    csv_path = config.base_dir / "profiles" / profile_name / "queries.csv"
    if not csv_path.exists():
        raise FileNotFoundError(f"queries.csv not found: {csv_path}")

    queries = []
    with csv_path.open("r", encoding="utf-8", newline="") as f:
        for row in csv.DictReader(f):
            query_id = (row.get("id") or "").strip()
            query_text = (row.get("query") or "").strip()
            if not query_id or not query_text:
                continue
            # Inject current year
            query_text = query_text.replace("{{year}}", CURRENT_YEAR)
            queries.append(Query(
                id=query_id,
                query=query_text,
                category=(row.get("category") or "").strip(),
                user_persona=(row.get("user_persona") or "").strip(),
                notes=(row.get("notes") or "").strip(),
            ))
    return queries


def load_product_info(config, profile=None):
    """Load product.md for the given profile."""
    profile_name = profile or config.profile
    path = config.base_dir / "profiles" / profile_name / "product.md"
    if path.exists():
        return path.read_text(encoding="utf-8")
    return ""


def filter_queries(queries, ids=None, category=None):
    """Filter queries by ID list or category."""
    if ids:
        id_set = set(ids)
        return [q for q in queries if q.id in id_set]
    if category:
        return [q for q in queries if q.category == category]
    return queries
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall