Skip to content

Universal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.

10.0 KB
Raw Blame
"""Hostile or malformed input must yield a finding, never a traceback (audit 2026-09-23).

Each case was reproduced by the post-release code audit against the scripts
added or changed on the v2.4.0 branch.
"""

from __future__ import annotations

import json
import sys
from pathlib import Path
from unittest.mock import patch

import pytest

ROOT = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(ROOT / "scripts"))

pytest.importorskip("requests")
pytest.importorskip("bs4")
import agentic_check as ac  # noqa: E402
import keywordseverywhere_api as ke  # noqa: E402
import lighthouse_agentic as la  # noqa: E402
import ucp_check  # noqa: E402

DEEP = "[" * 100000 + "]" * 100000


def _rec(status, text="", headers=None):
    return {"url": "u", "status": status, "headers": headers or {}, "text": text,
            "final_url": "https://e.test/", "error": None}


def test_deeply_nested_catalog_is_a_finding_not_a_crash():
    result = ac.validate_ai_catalog(DEEP)
    assert result["errors"]


def test_deeply_nested_well_known_document_is_a_finding(monkeypatch):
    monkeypatch.setattr(ac, "fetch", lambda url, headers=None: _rec(200, DEEP, {"content-type": "application/json"}))
    checks, _ = ac.audit_well_known("https://e.test")
    assert all(c["status"] == "fail" for c in checks)


def test_json_depth_limit_is_independent_of_stack_size(monkeypatch):
    """300 levels fail and 200 levels pass on every Python and C stack size."""
    too_deep = "[" * 300 + "]" * 300
    shallow = "[" * 200 + "]" * 200
    assert ac.validate_ai_catalog(too_deep)["errors"] == [
        f"malformed JSON: nested deeper than {ac.MAX_JSON_DEPTH} levels"]
    assert ac.validate_ai_catalog(shallow)["errors"] == ["root must be a JSON object"]
    for body, valid in ((too_deep, False), (shallow, True)):
        monkeypatch.setattr(ac, "fetch", lambda url, headers=None, body=body: _rec(
            200, body, {"content-type": "application/json"}))
        checks, data = ac.audit_well_known("https://e.test")
        assert all(row["valid_json"] is valid for row in data.values())


def test_json_depth_scan_skips_brackets_inside_strings():
    from url_safety import json_depth_exceeds
    assert not json_depth_exceeds(json.dumps({"a": "[" * 1000, "b": "{\\\"[[["}))
    assert json_depth_exceeds(json.dumps({"a": [[[]]]}), max_depth=3)
    assert not json_depth_exceeds(json.dumps({"a": [[]]}), max_depth=3)


def test_json_depth_scan_is_linear_on_unterminated_strings():
    import time

    from url_safety import json_depth_exceeds
    start = time.monotonic()
    assert not json_depth_exceeds('"\\' * 1_000_000)
    assert time.monotonic() - start < 2.0


def test_ucp_profile_hostile_shapes_do_not_crash():
    assert ucp_check.parse_profile(DEEP)["issues"]
    profile = {"ucp": {"version": "2026-08-25", "services": {"dev.ucp.shopping": [
        {"version": "2026-08-25", "transport": "rest", "endpoint": {"url": "x"}},
        {"version": "2026-08-25", "transport": "rest", "endpoint": "https://e.test/api"}]},
        "capabilities": {"dev.ucp.shopping.cart": [{"version": "v", "spec": "s", "schema": "s"}]}}}
    parsed = ucp_check.parse_profile(json.dumps(profile))
    assert "endpoint-not-a-string" in parsed["services"][0]["issues"]
    with patch.object(ucp_check, "safe_requests_get") as get, \
         patch.object(ucp_check, "validate_url_strict", return_value=("https://e.test/.well-known/ucp", "1.2.3.4")), \
         patch.object(ucp_check, "probe_endpoint", return_value={"url": "p"}):
        get.return_value.status_code = 200
        get.return_value.content = json.dumps(profile).encode()
        get.return_value.headers = {"Content-Type": "application/json"}
        report = ucp_check.audit_site("https://e.test", probe_endpoints=True)
    assert report["profile_present"]


class _Resp:
    def __init__(self, status, body):
        self.status_code, self._body, self.text = status, body, ""

    def json(self):
        return self._body


@pytest.mark.parametrize("body", [[1, 2], {"results": [1, "x", None]}, {"results": "nope"}])
def test_keywordseverywhere_odd_success_bodies(body):
    with patch.object(ke, "_post", return_value=_Resp(200, body)):
        result = ke.get_rank(["example.com"], "opr_live_testkey")
    assert result["status"] in ("error", "success")
    assert "Traceback" not in json.dumps(result)


def test_keywordseverywhere_never_echoes_a_malformed_key():
    result = ke.get_rank(["example.com"], "SECRETKEY123\n")
    assert "SECRETKEY123" not in json.dumps(result)


@pytest.mark.parametrize("data", [
    {"lighthouseResult": None},
    {"categories": {"agentic-browsing": {"auditRefs": [{"id": "x"}]}}, "audits": {"x": "not-a-dict"}},
    {"categories": {"agentic-browsing": {"auditRefs": [{"id": "x"}]}},
     "audits": {"x": {"scoreDisplayMode": "binary", "score": "high"}}},
])
def test_lighthouse_reader_survives_malformed_results(data):
    report = la.summarize(la.extract_lhr(data), "file")
    assert isinstance(report, dict)


def test_lighthouse_reader_accepts_a_bom_file(tmp_path, monkeypatch, capsys):
    fixture = (ROOT / "tests/fixtures/lighthouse_agentic_13_5_psi.json").read_text(encoding="utf-8")
    path = tmp_path / "report.json"
    path.write_text("" + fixture, encoding="utf-8")
    monkeypatch.setattr(sys, "argv", ["lighthouse_agentic.py", "--from-json", str(path), "--json"])
    with pytest.raises(SystemExit) as exc:
        la.main()
    assert exc.value.code == 0
    assert json.loads(capsys.readouterr().out)["fraction"]["display"] == "4/4"


def test_agentic_decoder_matches_the_shared_decoder_on_utf16():
    body = "Café".encode("utf-16-le")
    body = b"\xff\xfe" + body[2:]
    assert ac._decode(body, "text/html") == "Café"


# Second verification pass (same day): remaining crash shapes and robots edge cases.

def test_ucp_list_transport_is_an_issue_not_a_crash():
    profile = {"ucp": {"version": "2026-08-25", "services": {"dev.ucp.shopping": [
        {"version": "2026-08-25", "transport": ["rest"], "endpoint": "https://e.test/a"}]},
        "capabilities": {"dev.ucp.shopping.cart": [{"version": "v", "spec": "s", "schema": "s"}]}}}
    parsed = ucp_check.parse_profile(json.dumps(profile))
    assert "unknown-transport" in parsed["services"][0]["issues"]


def test_keywordseverywhere_deep_json_success_body():
    class Deep(_Resp):
        def json(self):
            return json.loads(DEEP)
    with patch.object(ke, "_post", return_value=Deep(200, None)):
        result = ke.get_rank(["example.com"], "opr_live_testkey")
    assert result["status"] == "error"


@pytest.mark.parametrize("category", [
    {"auditRefs": None}, {"auditRefs": ["x", 3]}, ["not", "a", "dict"],
])
def test_lighthouse_malformed_category_shapes(category):
    report = la.summarize(la.extract_lhr({"categories": {"agentic-browsing": category},
                                          "audits": {}}), "file")
    assert isinstance(report, dict)


def test_robots_colon_only_line_ends_a_user_agent_block_in_both_tools():
    import agentic_fix as af
    robots = "User-agent: A\n: junk\nUser-agent: B\nDisallow: /\n"
    draft = af.add_content_signal(robots, "search=yes")["robots_txt"]
    groups = ac.parse_robots(draft)["groups"]
    assert all(g["content_signal"] for g in groups), draft


def test_robots_unicode_line_separator_inside_a_comment_stays_a_comment():
    import agentic_fix as af
    robots = "User-agent: *\n# note
Disallow: /\nAllow: /\n"
    draft = af.add_content_signal(robots, "search=yes")["robots_txt"]
    assert "
" in draft  # the comment is not split into a live rule
    parsed = ac.parse_robots(robots)
    assert ac.is_allowed(ac.select_group(parsed, "GPTBot")["rules"], "/")


# Found by a random-shape fuzz after the second verification pass.

def test_ard_non_string_type_is_an_error():
    catalog = {"specVersion": "1.0", "entries": [{"identifier": "urn:air:p:n", "displayName": "d",
                                                  "type": ["application/ai-catalog+json"], "url": "u"}]}
    assert "'type' must be a string" in " ".join(ac.validate_ai_catalog(json.dumps(catalog))["errors"])


def test_lighthouse_non_string_audit_id_is_ignored():
    lhr = {"categories": {"agentic-browsing": {"auditRefs": [{"id": ["x"]}, {"id": "y"}]}},
           "audits": {"y": {"scoreDisplayMode": "binary", "score": 1}}}
    assert la.calculate_fraction(la.extract_lhr(lhr))["display"] == "1/1"


def test_seeded_shape_fuzz_never_raises():
    """Random JSON shapes through every parser of site- or API-controlled data.

    A longer run of this fuzz (5 seeds x 3000 shapes) found two crash sites after
    both audit passes; this seeded slice keeps them from coming back.
    """
    import random

    rng = random.Random(20260923)
    keys = ["ucp", "version", "services", "capabilities", "transport", "endpoint", "spec",
            "schema", "categories", "agentic-browsing", "auditRefs", "audits", "id", "score",
            "scoreDisplayMode", "group", "details", "items", "value", "results", "error",
            "specVersion", "entries", "identifier", "displayName", "type", "url", "data",
            "representativeQueries", "trustManifest", "lighthouseResult", "collections"]

    def rnd(depth=0):
        roll = rng.random()
        if depth > 4 or roll < 0.3:
            return rng.choice([None, True, 0, 1.5, "x", "", [], {}, ["a"], {"k": [1]}])
        if roll < 0.6:
            return [rnd(depth + 1) for _ in range(rng.randint(0, 3))]
        return {rng.choice(keys): rnd(depth + 1) for _ in range(rng.randint(0, 4))}

    for _ in range(400):
        obj = rnd()
        for wrapped in (obj, {"ucp": obj}, {"specVersion": "1.0", "entries": [obj]},
                        {"categories": {"agentic-browsing": {"auditRefs": obj}}, "audits": {"a": obj}},
                        {"lighthouseResult": {"categories": {"agentic-browsing": obj}}}):
            raw = json.dumps(wrapped)
            ac.validate_ai_catalog(raw)
            ucp_check.parse_profile(raw)
            la.explain(la.extract_lhr(wrapped))
            la.summarize(la.extract_lhr(wrapped), "fuzz")
            with patch.object(ke, "_post", return_value=_Resp(200, wrapped)):
                ke.get_rank(["example.com"], "opr_live_testkey")