Technical SEO

Redirect Mapper

/redirect-map

Build redirect maps for site migrations, URL restructures, and domain changes. Matches old URLs to new destinations based on content similarity.

Get this skill

Install all free SEO skills with one command:

curl -fsSL https://raw.githubusercontent.com/ccforseo/seo-skills/main/install.sh | bash

Or install this skill manually:

$ git clone https://github.com/ccforseo/seo-skills.git
$ cp -r seo-skills/redirect-mapper ~/.claude/skills/redirect-mapper
View on GitHubFree · MIT License · 8 skills included

What it does

Redirect Mapper is a Claude Code command that automates redirect planning for site migrations and URL restructures. It takes a list of old URLs and new URLs, then uses content similarity and URL pattern matching to generate 301 redirect rules. The skill outputs server-ready redirect configurations for Nginx, Apache, Vercel, Netlify, or Cloudflare.

Key features

  • Matches old URLs to new destinations by content similarity
  • Generates redirect rules for Nginx, Apache, Vercel, and Netlify
  • Detects redirect chains and loops before implementation
  • Handles bulk URL mapping from CSV input
  • Flags URLs with no clear match for manual review

How to use Redirect Mapper

  1. Provide your URL lists

    Type /redirect-map and supply a list of old URLs (or a crawl export) and new URLs. CSV, text files, or pasted lists all work.

  2. Review the matches

    The skill shows each old URL mapped to its best new destination with a confidence score. Review low-confidence matches manually.

  3. Export redirect rules

    Choose your server platform and the skill outputs ready-to-deploy redirect rules you can paste into your configuration.

When to use it

Site migration from one domain to another

Restructuring URL paths after a CMS change

Consolidating duplicate content under canonical URLs

Cleaning up legacy redirect chains

Frequently asked questions

What server formats does the Redirect Mapper support?

It generates redirect rules for Nginx, Apache (.htaccess), Vercel (vercel.json), Netlify (_redirects), and Cloudflare Workers. Specify your platform when running the command.

How does the Redirect Mapper match old URLs to new ones?

It compares page titles, content similarity, and URL path structure to find the best match. When multiple candidates exist, it ranks them by confidence score and flags ambiguous matches for manual review.

Can the Redirect Mapper detect redirect chains?

Yes. It checks your existing redirects and flags chains (A redirects to B, B redirects to C) so you can point A directly to C. This reduces redirect hops and preserves link equity.

How many redirects can the Redirect Mapper process at once?

There is no hard limit. It processes CSV files with thousands of URLs. For very large migrations (10,000+ URLs), process in batches of 2,000-5,000 for best results.

Related skills

Technical SEO

Site Audit

/seo-audit

Run a full technical SEO audit from your terminal. Checks crawlability, indexation issues, meta tags, page speed signals, and site structure in one pass.

Technical SEO

Broken Link Checker

/broken-links

Find all broken internal and external links on your site. Reports 404s, 5xx errors, timeout links, and redirect chains with their source pages.

Technical SEO

Internal Link Mapper

/internal-links

Map your site's internal link structure and find opportunities to strengthen topical clusters. Identifies orphan pages, weak hubs, and missing contextual links.

Technical SEO

Sitemap Auditor

/sitemap-audit

Validate your XML sitemap for errors, missing pages, and inconsistencies. Checks lastmod dates, priorities, URL counts, and cross-references against actual crawlable pages.

Get all 50 skills

The SEO Command Center includes every skill in this library plus Python data fetchers, CLAUDE.md configs, and report templates. One-time purchase.

Browse all skills