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/social_meta.py

View on GitHub
#!/usr/bin/env python3
"""
Validate Open Graph and Twitter Card meta tags.

Checks og:title, og:description, og:image, og:url, twitter:card, etc.
against platform requirements and best practices.

Usage:
    python social_meta.py https://example.com
    python social_meta.py https://example.com --json
"""

import argparse
import json
import sys
from urllib.parse import urlparse

try:
    import requests
except ImportError:
    print("Error: requests library required. Install with: pip install requests")
    sys.exit(1)

try:
    from bs4 import BeautifulSoup
except ImportError:
    print("Error: beautifulsoup4 required. Install with: pip install beautifulsoup4")
    sys.exit(1)

try:
    from lib.safe_http import default_headers, safe_get
except ImportError:
    from scripts.lib.safe_http import default_headers, safe_get


HEADERS = default_headers()

# Required and recommended OG tags
OG_REQUIREMENTS = {
    "og:title": {"required": True, "max_length": 60, "min_length": 10},
    "og:description": {"required": True, "max_length": 200, "min_length": 50},
    "og:image": {"required": True},
    "og:url": {"required": True},
    "og:type": {"required": True},
    "og:site_name": {"required": False},
    "og:locale": {"required": False},
}

# Twitter Card tags
TWITTER_REQUIREMENTS = {
    "twitter:card": {"required": True, "valid_values": ["summary", "summary_large_image", "app", "player"]},
    "twitter:title": {"required": False, "max_length": 70},
    "twitter:description": {"required": False, "max_length": 200},
    "twitter:image": {"required": False},
    "twitter:site": {"required": False},
    "twitter:creator": {"required": False},
}


def check_social_meta(url: str, timeout: int = 15) -> dict:
    """
    Validate social media meta tags for a URL.

    Args:
        url: URL to check
        timeout: Request timeout in seconds

    Returns:
        Dictionary with social meta analysis
    """
    result = {
        "url": url,
        "score": 0,
        "og_tags": {},
        "twitter_tags": {},
        "og_present": [],
        "og_missing": [],
        "twitter_present": [],
        "twitter_missing": [],
        "issues": [],
        "recommendations": [],
        "preview": {
            "title": None,
            "description": None,
            "image": None,
            "site_name": None,
        },
        "error": None,
    }

    try:
        resp = safe_get(url, timeout=timeout, headers=HEADERS)
        if resp.status_code != 200:
            result["error"] = f"HTTP {resp.status_code}"
            return result

        soup = BeautifulSoup(resp.text, "html.parser")
    except requests.exceptions.RequestException as e:
        result["error"] = str(e)
        return result

    total_checks = 0
    passed_checks = 0

    # Extract Open Graph tags
    for meta in soup.find_all("meta"):
        prop = meta.get("property", "")
        name = meta.get("name", "")
        content = meta.get("content", "")

        if prop.startswith("og:"):
            result["og_tags"][prop] = content
        if name.startswith("twitter:") or prop.startswith("twitter:"):
            key = name or prop
            result["twitter_tags"][key] = content

    # Validate OG tags
    for tag, rules in OG_REQUIREMENTS.items():
        total_checks += 1
        value = result["og_tags"].get(tag)

        if value:
            result["og_present"].append(tag)
            passed_checks += 1

            # Check length constraints
            if "max_length" in rules and len(value) > rules["max_length"]:
                result["issues"].append(
                    f"⚠️ {tag} is too long ({len(value)} chars, max {rules['max_length']})"
                )
            if "min_length" in rules and len(value) < rules["min_length"]:
                result["issues"].append(
                    f"⚠️ {tag} is too short ({len(value)} chars, min {rules['min_length']})"
                )

            # Validate og:image
            if tag == "og:image":
                if not value.startswith(("http://", "https://")):
                    result["issues"].append("⚠️ og:image should be an absolute URL")

            # Validate og:url
            if tag == "og:url":
                if not value.startswith(("http://", "https://")):
                    result["issues"].append("⚠️ og:url should be an absolute URL")

        elif rules["required"]:
            result["og_missing"].append(tag)
            result["issues"].append(f"🔴 Missing required: {tag}")

    # Validate Twitter tags
    for tag, rules in TWITTER_REQUIREMENTS.items():
        total_checks += 1
        value = result["twitter_tags"].get(tag)

        if value:
            result["twitter_present"].append(tag)
            passed_checks += 1

            if "valid_values" in rules and value not in rules["valid_values"]:
                result["issues"].append(
                    f"⚠️ {tag} has invalid value '{value}' — "
                    f"valid: {', '.join(rules['valid_values'])}"
                )
            if "max_length" in rules and len(value) > rules["max_length"]:
                result["issues"].append(
                    f"⚠️ {tag} is too long ({len(value)} chars, max {rules['max_length']})"
                )
        elif rules["required"]:
            result["twitter_missing"].append(tag)
            result["issues"].append(f"⚠️ Missing: {tag}")

    # Calculate score
    if total_checks > 0:
        result["score"] = round((passed_checks / total_checks) * 100)

    # Build preview
    result["preview"]["title"] = (
        result["og_tags"].get("og:title") or
        result["twitter_tags"].get("twitter:title") or
        (soup.title.string if soup.title else None)
    )
    result["preview"]["description"] = (
        result["og_tags"].get("og:description") or
        result["twitter_tags"].get("twitter:description")
    )
    result["preview"]["image"] = (
        result["og_tags"].get("og:image") or
        result["twitter_tags"].get("twitter:image")
    )
    result["preview"]["site_name"] = result["og_tags"].get("og:site_name", "")

    # Recommendations
    if not result["og_tags"]:
        result["recommendations"].append(
            "Add Open Graph tags for rich social media previews on Facebook, LinkedIn, etc."
        )
    if not result["twitter_tags"]:
        result["recommendations"].append(
            "Add Twitter Card tags for rich previews on X (Twitter)"
        )
    if result["og_tags"].get("og:image") and not result["og_tags"].get("og:image:width"):
        result["recommendations"].append(
            "Add og:image:width and og:image:height for optimal rendering (1200×630 recommended)"
        )

    return result


def main():
    parser = argparse.ArgumentParser(description="Validate social media meta tags")
    parser.add_argument("url", help="URL to check")
    parser.add_argument("--json", "-j", action="store_true", help="Output as JSON")

    args = parser.parse_args()
    result = check_social_meta(args.url)

    if args.json:
        print(json.dumps(result, indent=2))
        return

    if result["error"]:
        print(f"Error: {result['error']}")
        sys.exit(1)

    print(f"Social Meta Tags — {result['url']}")
    print("=" * 50)
    print(f"Score: {result['score']}/100")

    # OG Summary
    print(f"\nOpen Graph ({len(result['og_present'])}/{len(OG_REQUIREMENTS)}):")
    for tag in OG_REQUIREMENTS:
        value = result["og_tags"].get(tag)
        if value:
            display = value[:60] + "..." if len(value) > 60 else value
            print(f"  ✅ {tag}: {display}")
        else:
            req = "required" if OG_REQUIREMENTS[tag]["required"] else "optional"
            icon = "🔴" if req == "required" else "ℹ️"
            print(f"  {icon} {tag}: missing ({req})")

    # Twitter Summary
    print(f"\nTwitter Card ({len(result['twitter_present'])}/{len(TWITTER_REQUIREMENTS)}):")
    for tag in TWITTER_REQUIREMENTS:
        value = result["twitter_tags"].get(tag)
        if value:
            print(f"  ✅ {tag}: {value[:60]}")
        else:
            req = "required" if TWITTER_REQUIREMENTS[tag]["required"] else "optional"
            icon = "⚠️" if req == "required" else "ℹ️"
            print(f"  {icon} {tag}: missing ({req})")

    # Preview
    p = result["preview"]
    if p["title"]:
        print(f"\nSocial Preview:")
        print(f"  Title: {p['title']}")
        print(f"  Description: {(p['description'] or 'None')[:80]}")
        print(f"  Image: {p['image'] or 'None'}")

    if result["issues"]:
        print(f"\nIssues:")
        for issue in result["issues"]:
            print(f"  {issue}")

    if result["recommendations"]:
        print(f"\nRecommendations:")
        for rec in result["recommendations"]:
            print(f"  💡 {rec}")


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: 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