Skip to content

Bhanunamikaze/Agentic-SEO-Skill

Deterministic LLM-first SEO audits for websites, blog posts, and GitHub repositories. Use this when the user asks to "perform SEO analysis", "run SEO audit", "analyze SEO", "check technical SEO", "review schema", "Core Web Vitals", "E-E-A-T", "hreflang", "GEO", "AEO", or GitHub repository SEO optimization. For full/page/repo audits, run bundled scripts for evidence and return prioritized, confidence-labeled fixes.

FileKindSize
SKILL.mdskill md19.4 KB
scripts/__init__.pyscript34 B
scripts/a11y_seo_checker.pyscript3.4 KB
scripts/ai_crawler_policy_matrix.pyscript2.2 KB
scripts/analyze_visual.pyexecutablescript6.5 KB
scripts/anchor_text_audit.pyscript7.7 KB
scripts/answer_block_scanner.pyscript3.9 KB
scripts/article_seo.pyscript27.1 KB
scripts/audit_runner.pyscript3.1 KB
scripts/broken_links.pyscript8.3 KB
scripts/cache_compression_checker.pyscript6.7 KB
scripts/canonical_checker.pyscript3.4 KB
scripts/capture_screenshot.pyexecutablescript4.4 KB
scripts/citation_readiness.pyscript5.1 KB
scripts/collection_page_checker.pyscript4.2 KB
scripts/competitor_gap.pyscript10.2 KB
scripts/content_decay_detector.pyscript6.2 KB
scripts/content_intent_matcher.pyscript5.4 KB
scripts/crawl_audit.pyscript7.2 KB
scripts/critical_request_chain.pyscript4.8 KB
scripts/duplicate_content.pyscript14.0 KB
scripts/eeat_signal_checker.pyscript5.5 KB
scripts/entity_checker.pyscript19.4 KB
scripts/env_loader.pyscript3.6 KB
scripts/external_link_quality.pyscript6.6 KB
scripts/faceted_nav_audit.pyscript3.3 KB
scripts/fetch_page.pyexecutablescript3.6 KB
scripts/finding_verifier.pyscript4.9 KB
scripts/font_audit.pyscript5.9 KB
scripts/freshness_checker.pyscript6.2 KB
scripts/generate_report.pyscript80.7 KB
scripts/github_api.pyscript12.8 KB
scripts/github_community_health.pyscript8.9 KB
scripts/github_competitor_research.pyscript17.2 KB
scripts/github_readme_lint.pyscript14.9 KB
scripts/github_repo_audit.pyscript21.0 KB
scripts/github_search_benchmark.pyscript7.7 KB
scripts/github_seo_report.pyscript32.0 KB
scripts/github_traffic_archiver.pyscript6.3 KB
scripts/github_weekly_scorecard.pyscript4.4 KB
scripts/gsc_checker.pyscript11.4 KB
scripts/hreflang_checker.pyscript24.2 KB
scripts/hreflang_sitemap_validator.pyscript6.4 KB
scripts/image_inventory.pyscript2.8 KB
scripts/image_weight_audit.pyscript4.8 KB
scripts/indexability_matrix.pyscript3.5 KB
scripts/indexnow_checker.pyscript9.4 KB
scripts/internal_links.pyscript10.5 KB
scripts/javascript_render_audit.pyscript2.9 KB
scripts/lcp_subparts.pyscript7.3 KB
scripts/lib/__init__.pyscript46 B
scripts/lib/safe_http.pyscript6.1 KB
scripts/lighthouse_runner.pyscript6.0 KB
scripts/link_profile.pyscript12.5 KB
scripts/llms_txt_checker.pyscript7.5 KB
scripts/llms_txt_generator.pyscript2.9 KB
scripts/local_seo_checker.pyscript3.7 KB
scripts/log_file_analyzer.pyscript6.0 KB
scripts/mobile_render_checker.pyscript6.9 KB
scripts/orphan_pages_from_sitemap.pyscript6.2 KB
scripts/pagespeed.pyscript12.9 KB
scripts/parse_html.pyexecutablescript12.2 KB
scripts/pre_commit_seo_check.shexecutablescript2.9 KB
scripts/product_schema_checker.pyscript4.9 KB
scripts/readability.pyscript14.5 KB
scripts/redirect_backlink_reclaim.pyscript5.7 KB
scripts/redirect_checker.pyscript6.2 KB
scripts/reference_freshness.pyexecutablescript2.9 KB
scripts/repo_docs_site_checker.pyscript5.7 KB
scripts/repo_file_inventory.pyscript3.6 KB
scripts/repo_release_seo.pyscript6.6 KB
scripts/repo_social_preview_checker.pyscript4.1 KB
scripts/repo_topic_suggester.pyscript6.3 KB
scripts/review_schema_checker.pyscript4.0 KB
scripts/rich_results_guard.pyscript3.4 KB
scripts/robots_checker.pyscript7.2 KB
scripts/robots_path_tester.pyscript1.8 KB
scripts/schema_diff.pyscript3.1 KB
scripts/schema_required_props.pyscript8.1 KB
scripts/schema_template_generator.pyscript5.4 KB
scripts/security_headers.pyscript6.8 KB
scripts/seo_common.pyscript14.1 KB
scripts/sitemap_checker.pyscript6.5 KB
scripts/sitemap_generator.pyscript3.4 KB
scripts/social_meta.pyscript8.7 KB
scripts/third_party_script_audit.pyscript4.7 KB
scripts/topical_cluster_mapper.pyscript6.4 KB
scripts/url_quality.pyscript2.5 KB
scripts/validate_schema.pyexecutablescript4.3 KB
scripts/validate_skill_inventory.pyexecutablescript4.8 KB
scripts/video_schema_checker.pyscript3.6 KB
scripts/visual_regression_snapshot.pyscript5.3 KB
scripts/x_robots_header_checker.pyscript2.0 KB

scripts/product_schema_checker.py

View on GitHub
#!/usr/bin/env python3
"""Check Product and ProductGroup JSON-LD for ecommerce rich-result readiness."""

from __future__ import annotations

import argparse
import json
from typing import Any

from schema_required_props import extract_schema_documents, find_schema_nodes
from seo_common import issue, print_json_or_text


VALID_AVAILABILITY = {
    "https://schema.org/InStock",
    "https://schema.org/OutOfStock",
    "https://schema.org/PreOrder",
    "https://schema.org/BackOrder",
    "https://schema.org/LimitedAvailability",
    "InStock",
    "OutOfStock",
    "PreOrder",
    "BackOrder",
}


def as_list(value: Any) -> list[Any]:
    if value is None:
        return []
    return value if isinstance(value, list) else [value]


def check_offer(offer: dict[str, Any], path: str) -> list[dict[str, Any]]:
    issues = []
    if not offer.get("price") and not offer.get("lowPrice"):
        issues.append(issue("error", "Offer is missing price or lowPrice", evidence=path))
    if not offer.get("priceCurrency"):
        issues.append(issue("error", "Offer is missing priceCurrency", evidence=path))
    availability = offer.get("availability")
    if not availability:
        issues.append(issue("warning", "Offer is missing availability", evidence=path))
    elif availability not in VALID_AVAILABILITY:
        issues.append(issue("warning", "Offer availability should use a Schema.org ItemAvailability URL", evidence=path))
    if not offer.get("url"):
        issues.append(issue("info", "Offer is missing url", evidence=path))
    if not offer.get("shippingDetails"):
        issues.append(issue("info", "Offer is missing shippingDetails", evidence=path))
    if not offer.get("hasMerchantReturnPolicy"):
        issues.append(issue("info", "Offer is missing hasMerchantReturnPolicy", evidence=path))
    return issues


def check_product_schema(documents: list[Any]) -> dict[str, Any]:
    rows = []
    issues = []
    product_rows = find_schema_nodes(documents, "Product") + find_schema_nodes(documents, "ProductGroup")
    for row in product_rows:
        node = row["node"]
        row_issues = []
        for prop in ("name", "image", "description"):
            if not node.get(prop):
                severity = "error" if prop == "name" else "warning"
                row_issues.append(issue(severity, f"Product is missing {prop}", evidence=row["path"]))
        if "Product" in row["types"] and not node.get("offers"):
            row_issues.append(issue("error", "Product is missing offers", evidence=row["path"]))
        if "ProductGroup" in row["types"]:
            for prop in ("productGroupID", "variesBy", "hasVariant"):
                if not node.get(prop):
                    row_issues.append(issue("error", f"ProductGroup is missing {prop}", evidence=row["path"]))
        if not node.get("sku") and not node.get("gtin") and not node.get("mpn"):
            row_issues.append(issue("warning", "Product is missing sku/gtin/mpn identifier", evidence=row["path"]))
        if not node.get("brand"):
            row_issues.append(issue("info", "Product is missing brand", evidence=row["path"]))
        for index, offer in enumerate(as_list(node.get("offers"))):
            if isinstance(offer, dict):
                row_issues.extend(check_offer(offer, f"{row['path']}.offers[{index}]"))
        for index, variant in enumerate(as_list(node.get("hasVariant"))):
            if isinstance(variant, dict):
                if not variant.get("offers"):
                    row_issues.append(issue("error", "Product variant is missing offers", evidence=f"{row['path']}.hasVariant[{index}]"))
                for offer_index, offer in enumerate(as_list(variant.get("offers"))):
                    if isinstance(offer, dict):
                        row_issues.extend(check_offer(offer, f"{row['path']}.hasVariant[{index}].offers[{offer_index}]"))
        rows.append({"path": row["path"], "types": row["types"], "issues": row_issues})
        issues.extend(row_issues)
    return {"products": len(product_rows), "rows": rows, "issues": issues}


def main() -> None:
    parser = argparse.ArgumentParser(description="Check Product/ProductGroup JSON-LD")
    parser.add_argument("source", help="URL, HTML file, or JSON-LD file")
    parser.add_argument("--timeout", type=int, default=15)
    parser.add_argument("--json", "-j", action="store_true", help="Output JSON")
    args = parser.parse_args()
    documents, meta = extract_schema_documents(args.source, timeout=args.timeout)
    result = check_product_schema(documents)
    result.update({"source": args.source, "final_url": meta["final_url"]})
    lines = [f"Product schema check for {args.source}", f"Products: {result['products']}  Issues: {len(result['issues'])}"]
    lines.extend(f"[{item['severity']}] {item['message']} {item.get('evidence') or ''}" for item in result["issues"][:30])
    print_json_or_text(result, args.json, lines)


if __name__ == "__main__":
    main()
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: 471kUpdated 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: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated 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