SEO
by addyosmani / web-quality-skills
Optimize for search engine visibility and ranking.
Follows every redirect hop for a list of URLs to find chains, loops, mixed 301 and 302 use, and redirects that end in errors or contradict the canonical.
Listed ·Updated
AGENT ROLE: Autonomous redirect-integrity agent. Manually walk each URL's redirect chain (never auto-follow), record every hop, classify problems, and emit the JSON in references/output.schema.json.
Produce the exact hop-by-hop redirect path for each input URL, and flag the issues that leak link equity or waste crawl: multi-hop chains, loops, temporary redirects that should be permanent, redirects ending on errors, and final-URL/canonical mismatches.
urls (REQUIRED string[]): URLs to trace (typically old/migrated URLs).max_hops (OPTIONAL, default 10): loop/over-length guard.check_canonical (OPTIONAL bool, default true): GET the final 200 URL and compare its canonical.expected_permanent (OPTIONAL bool, default true): treat 302/307 in a settling chain as a warning.seoskills-redirect-mapper/1.0.HEAD; IF a hop returns 405/501 for HEAD THEN retry that hop with GET.scripts/redirect_map.py --urls a,b,c.status + Location, resolving relative Location against the current URL, appending a hop, until a non-3xx status or max_hops.STEP 1 — WALK: start at the input URL. At each step record {url, status, location}. Resolve Location (may be relative). Advance to it.
STEP 2 — TERMINATE when: status is non-3xx (final), OR a URL repeats (LOOP), OR hop count > max_hops (TOO_LONG).
STEP 3 — CLASSIFY (collect all that apply):
OK_DIRECT: 0 hops, final 200.CHAIN: hops ≥ 2 before final 200 → equity/crawl waste; recommend pointing the source directly at the final URL.LOOP: a URL repeats → broken.TOO_LONG: exceeded max_hops → treat as loop-like.TEMPORARY_REDIRECT: any 302/303/307 in a chain that appears permanent → should likely be 301/308.MIXED_STATUS: chain mixes permanent and temporary codes.ENDS_NON_200: final status ≥ 400 (redirect to a dead page).PROTOCOL_DOWNGRADE: an https→http hop.CANONICAL_MISMATCH (if check_canonical): final 200 URL's canonical ≠ final URL.
STEP 4 — EMIT one record per input URL with the full hops array, final_url, final_status, hop_count, and issues.429/503 THEN backoff 2^attempt (max 3) on that hop; IF persistent THEN terminate that URL's walk with issues:["FETCH_FAILED"] and whatever hops were collected.status:0 for that hop and stop that URL; do not abort the batch.Location header is missing on a 3xx THEN terminate with issue="MALFORMED_REDIRECT".TEMPORARY_REDIRECT is a warning, not an error, unless expected_permanent=true.One JSON object per references/output.schema.json. No prose.
scripts/redirect_map.py — manual per-hop tracer with classification.references/output.schema.json — output contract.Not using the CLI? Copy the SKILL.md and paste it straight into ChatGPT, Claude, or any agent.