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.

2.5 KB
Raw Blame
#!/usr/bin/env node
"use strict";

const { spawnSync } = require("child_process");
const path = require("path");

// Same list as valid_extensions in validate-schema.py. The hook fires on every
// Edit and Write, so skip the Python probe for files that cannot hold JSON-LD.
const SCHEMA_FILE_EXTENSIONS = [".html", ".htm", ".jsx", ".tsx", ".vue", ".svelte", ".php", ".ejs"];

// The skip belongs to the schema hook only; any other hook script always runs.
const SCHEMA_HOOK_SCRIPT = "validate-schema.py";

function isSchemaHook(hookScript) {
  return path.basename(hookScript) === SCHEMA_HOOK_SCRIPT;
}

function cannotHoldSchema(filePath) {
  // An unsubstituted "${tool_input.file_path}" leaves the path to the stdin event.
  if (!filePath || filePath.includes("${")) {
    return false;
  }
  const lower = filePath.toLowerCase();
  return !SCHEMA_FILE_EXTENSIONS.some((ext) => lower.endsWith(ext));
}

function stripWrappingQuotes(value) {
  return value.replace(/^["']|["']$/g, "");
}

function pythonCandidates() {
  const candidates = [];
  if (process.env.CLAUDE_SEO_PYTHON) {
    candidates.push({
      label: "CLAUDE_SEO_PYTHON",
      exe: stripWrappingQuotes(process.env.CLAUDE_SEO_PYTHON),
      args: [],
    });
  }
  candidates.push(
    { label: "py -3", exe: "py", args: ["-3"] },
    { label: "python3", exe: "python3", args: [] },
    { label: "python", exe: "python", args: [] },
  );
  return candidates;
}

function isStoreStubOutput(text) {
  return /Microsoft Store|WindowsApps|App execution alias|was not found/i.test(text);
}

function probe(candidate) {
  const script = "import sys; print(sys.executable); print(sys.version.split()[0])";
  const result = spawnSync(candidate.exe, [...candidate.args, "-c", script], {
    encoding: "utf8",
  });
  const output = `${result.stdout || ""}\n${result.stderr || ""}`;
  return result.status === 0 && Boolean((result.stdout || "").trim()) && !isStoreStubOutput(output);
}

function main() {
  const [, , hookScript, ...hookArgs] = process.argv;
  if (!hookScript || (isSchemaHook(hookScript) && cannotHoldSchema(hookArgs[0]))) {
    process.exit(0);
  }

  for (const candidate of pythonCandidates()) {
    if (!probe(candidate)) {
      continue;
    }
    const result = spawnSync(candidate.exe, [...candidate.args, hookScript, ...hookArgs], {
      stdio: "inherit",
    });
    if (result.error) {
      continue;
    }
    process.exit(result.status === null ? 1 : result.status);
  }

  console.error(
    "Claude SEO hook could not find Python. Tried CLAUDE_SEO_PYTHON, py -3, python3, python.",
  );
  process.exit(1);
}

main();