GitHunt
CR

craigdanielk/shopify-url-redirect-migration-toolkit

Config-driven CLI toolkit for CMS-to-Shopify URL redirect migrations. Supports Magento, WordPress, TYPO3, Drupal, CSV, Wayback Machine discovery, multi-market locales, chain flattening, and 5-layer validation.

301-redirectcms-migrationecommercemagento-to-shopifypython-cliredirect-managerseo-migrationshopifyurl-mappingurl-redirectwayback-machinewordpress-to-shopify

URL Migration Toolkit

Config-driven CLI tool for mapping URLs between CMS platforms (Magento, WordPress, TYPO3) and Shopify, generating redirect CSVs for zero-downtime domain migrations.

Quick Start

# Install
uv sync

# Create a new migration project
uv run migrate init --name my-migration

# Edit config.yaml with your source/target details, then:
uv run migrate fetch            # Pull data from source + target APIs
uv run migrate map              # Generate redirect mappings
uv run migrate validate         # Validate before upload

Features

  • Multi-strategy matching: exact handle, SKU, fuzzy name (SequenceMatcher), partial substring, regex pattern rules
  • Config-driven: domains, slug transforms, page mappings, matcher order — all in config.yaml
  • 4-layer validation: CSV format, target existence, redirect chains, local testing
  • Platform-agnostic fetchers: Magento (OAuth 1.0), Shopify (Admin API), plain CSV import
  • Loop detection: graph-based cycle detection on redirect maps before upload

Installation

Requires Python 3.11+ and uv.

git clone https://github.com/r17-ventures/url-migration-toolkit.git
cd url-migration-toolkit
uv sync

Usage

1. Scaffold a project

uv run migrate init --name my-store

Creates a directory with standard subdirectories and a config.yaml template.

2. Configure

Edit config.yaml — see config.example.yaml for full reference.

3. Fetch data

uv run migrate fetch --config config.yaml

4. Map URLs

uv run migrate map --config config.yaml

5. Validate

uv run migrate validate --config config.yaml     # All layers
uv run migrate validate csv                       # CSV format only
uv run migrate validate targets                   # Target existence only
uv run migrate validate live                      # Live redirect chains
uv run migrate validate local                     # Local testing guide

Config Reference

See config.example.yaml for all available options.

Development

uv sync --all-extras
uv run pytest tests/ --cov=migrate
uv run ruff check src/

License

MIT

Languages

Python100.0%

Contributors

CR
Created February 11, 2026
Updated February 16, 2026
craigdanielk/shopify-url-redirect-migration-toolkit | GitHunt