- Home
- Skills
- Marketing & SEO
- Plan 301 Redirects for a Site Migration Without Losing SEO
Works with the AI Agents you already use
Plan 301 Redirects for a Site Migration Without Losing SEO
Before launch: build the old→new 301 map from two URL lists, flag chains/loops/unmatched high-traffic pages, export nginx/Apache/Netlify rules. After launch, run Site Migration QA.
$6
Plan 301 Redirects for a Site Migration Without Losing SEO
Example session with this skill installed
Build a redirect map. old-urls.csv = the 58 listing URLs we renamed in October (with page views where we have them as the clicks column, and old titles for 15 of them); new-urls.csv = our 59 live listings with titles. No existing redirects. Then check the old URLs live before we ship anything.
- Read your context and instructions
- Compiled the plan 301 redirects
- Generated the data export
→ Old URLs: 58 | new URLs: 59 | legacy rules to update: 0
→ Status: DECIDE 32, 301_REVIEW 16, 301 10 | Match types: FUZZY 26, NO_MATCH 32
→ [301/HIGH] /skills/website-project-scope-in-10-minutes-mvp-checklist-risks → /skills/website-project-scope-mvp-checklist-risk-map (FUZZY 0.88, 60 views)
→ [301_REVIEW/MEDIUM] /skills/find-why-your-shopify-store-visitors-don-t-buy → /skills/find-why-shopify-visitors-don-t-buy-cro-audit-fix-list (FUZZY 0.69)
→ [301_REVIEW/MEDIUM] /skills/app-mvp-scope-feature-priority-risk-checklist → /skills/website-project-scope-mvp-checklist-risk-map (FUZZY 0.65): WRONG target per our rename log, written as "# REVIEW (FUZZY 0.65), uncomment after checking: …" so it never went live
→ [DECIDE/MEDIUM] /skills/turn-customer-interviews-into-clear-themes-and-insights → ? (NO_MATCH): valuable URL with no match: recreate the page or choose the closest topic
→ Scored against the real rename log: 10/10 auto-matches right, 15/16 REVIEW right, 26 of the 32 DECIDE rows were merges (2+ old listings folded into one)
→ Wrote redirect-map.csv and 26 rules (10 active, 16 REVIEW commented out) to redirects.nginx.conf, redirects.htaccess, _redirects + 10 old→new pairs to qa-pairs.txt
→ Live check of all 58 old URLs (Redirect Checker): 0 server-side 301s yet (56 = 200 with a generic noindex page, 2 = 404), so every rule is still needed
redirect-map.csv
CSV · data export
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
About this skill
Unlike redirect-map "preflight" checkers that only lint a map you already wrote, this skill builds the map for you: it matches every old URL to its new page from your two URL lists, ranks them by clicks and backlinks, flattens chains, catches loops, and writes nginx, Apache and _redirects rules. Unsure matches are written commented out, so a fuzzy guess never goes live unchecked.
Real run (20 Oct 2026): 58 renamed listing URLs on our own marketplace storefront, mapped against the 59 live ones, then scored against our real rename log:
| Result | Rows | Right target | Wrong |
|---|---|---|---|
| 301, auto-match (active rule) | 10 | 10 | 0 |
| 301_REVIEW (commented out until you check) | 16 | 15 | 1 |
| DECIDE: no safe match, a human picks | 32 | 26 were merges (2+ old pages folded into one) | – |
- Top match: /skills/website-project-scope-in-10-minutes-mvp-checklist-risks → /skills/website-project-scope-mvp-checklist-risk-map (FUZZY 0.88, priority HIGH: 60 views)
- The one wrong guess (FUZZY 0.65) sat in REVIEW, commented out: it never reached the rule files as a live rule
- Live check before shipping, with our Redirect Checker actor: 0 of 58 old URLs had a server-side 301 (56 answered 200 with a generic noindex page, 2 answered 404), so all of the rules were still needed
Works in Claude Code, Cursor and Codex · one Python script, stdlib only, no network, no API keys: it reads only your CSV files · tested on real URL data (the run above, included in the zip) plus a small tutorial example with every status · v1.0.1, updated Oct 2026 · questions answered via Agensi messages within 24h · After launch, test every rule in bulk with our Redirect Checker on Apify (first 20 URLs free): https://apify.com/cygnix_labs/redirect-checker
Migrations lose traffic in predictable ways: old URLs that 404, everything redirected to the homepage, chains through legacy rules, and the occasional loop. Building the map by hand in a spreadsheet takes days and still misses things.
What it does
- Matches old to new URLs by exact URL, normalised path (case, slash, .html/.php, index.*), unique slug, then fuzzy slug + title similarity
- Learns your section changes from confident matches (e.g. /shop/* → /flowers/*) and uses them for the harder ones
- Ranks every URL by clicks and backlinks, so high-value pages are never left unmatched or dumped on the homepage
- Flattens chains through your existing redirects and flags loops before launch
- Writes nginx (location =), Apache (RedirectMatch ^…$) and Netlify / Cloudflare Pages _redirects files: auto-matches active, REVIEW lines commented out with their match type and score
- Gives you a QA list (old-url new-url per line) to test every rule right after launch
How it works
- Export the old URLs (old sitemap, a crawl, GSC Pages with clicks, your backlink tool's top pages) and the new URLs (staging sitemap or crawl). Add your current redirect rules if you have them.
- The script builds redirect-map.csv: old URL, new URL, status (301 / 301_REVIEW / DECIDE / LOOP / NO_REDIRECT), match type, confidence, priority and a note.
- Review the REVIEW and DECIDE rows, highest priority first, then ship the rule file for your server and run the launch-QA checklist.
Who it's for
SEOs, developers and agencies doing a replatform (WordPress → Shopify, Webflow, Next.js), a redesign, a domain or section move, or a slug cleanup. Not for DNS or hosting setup, and it does not crawl sites itself: you give it the URL lists.
Pairs well with (Cygnix Labs, on Agensi)
- Migrate Sites Without Losing SEO: Redirect + Parity Audit (agensi.io/skills/migrate-sites-without-losing-seo-redirect-parity-audit): check content and metadata parity before launch
- Site Migration QA: Redirects, Parity + Traffic Alerts (agensi.io/skills/site-migration-qa-redirects-parity-traffic-alerts): post-launch QA and traffic alerts
- Fix Keyword Cannibalization Using Google Search Console (agensi.io/skills/fix-keyword-cannibalization-using-google-search-console): decide merges before you map them
- Find Orphan Pages and Fix Your Internal Linking (agensi.io/skills/find-orphan-pages-and-fix-your-internal-linking): update internal links to the new URLs
- Find Decaying Pages: GSC Triage + Content Refresh Plan (agensi.io/skills/find-decaying-pages-gsc-triage-content-refresh-plan): re-measure traffic after launch
Before launch → 301 Planner · After launch → Migration QA · Both + client sign-off → Migration Kit.
Run this as live tools: Cygnix SEO MCP clusters keywords, classifies intent, scores titles/meta and drafts briefs right inside Claude, ChatGPT or Cursor. Free key, no install: https://mcp.cygnixlabs.com
Does not crawl sites or fetch URLs: you export the old and new URL lists (sitemaps, a crawl, GSC). Merges (several old pages into one) and pages with no close equivalent come out as DECIDE for a human. Regex and wildcard rules are not generated, only exact one-to-one rules. Test the rules on staging before launch.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 28 days ago