redirect-manager

/digital-marketing-pro:redirect-manager

脚本位置。 如果您的宿主未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 并列。请使用 Python 3.10 或更高版本运行：python；如果找不到 python，则使用 python3（macOS 和许多 Linux 系统）。

用途

管理网站上的 URL 重定向。创建新的 301/302 重定向，审查现有重定向中的链式跳转和循环，修复失效的重定向路径，并通过已连接的 CMS MCP 部署更改。适用于网站迁移、URL 重组和持续的重定向维护。重定向管理不当是造成 SEO 流量损失最常见的原因之一：链式跳转会稀释链接权益，循环会造成抓取错误，失效的重定向会让此前已编入索引的 URL 返回 404。此命令提供从创建到审查和修复的系统化重定向生命周期管理。

执行门槛（必须遵守——不可跳过）

1. 在触及任何线上规则之前，先将完整预览作为执行摘要展示——列出每一条待创建、更新或移除的重定向，并说明当前状态与拟议状态，以及对全站的影响范围。
2. 用户必须输入 yes（或明确表示批准的等效内容）。任何其他输入——含糊、暗示性、部分批准或未提供批准——都会取消执行。
3. 不得在输入含糊时继续。执行失败后不得自动重试；再次运行前必须由人工审查失败原因。
4. 只有用户输入 yes 后，才记录批准：python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"redirect-manager","platform":"<platform>","content_summary":"<one line from the Execution Summary>","risk_level":"<tier>"}'，然后运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action approve --id {approval_id}。如果任一命令报错，立即停止并报告错误；不得使用其他工具绕过。该记录可证明此操作已执行批准步骤，但无法证明是谁输入了 yes。
5. 执行操作。通过 connector_executor.py 发送的写入请求需要 --approval-id，且仅在存在匹配的、未使用且未过期的记录时才会执行（参见 /digital-marketing-pro:execute-action）。通过已连接的 MCP 服务工具执行的写入不受该代码检查约束：它依赖用户输入的 yes 和宿主的权限提示。之后运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} --data '{"execution_result":"success"}'（或将结果设为 failure）。

所需输入

用户必须提供（或系统会提示用户提供）：

• 重定向操作：要执行的操作——create（设置新的重定向）、audit（扫描所有现有重定向以查找问题）、fix（解决审查中发现的链式跳转、循环和失效目标），或 bulk-import（从 CSV 或 Google Sheet 导入重定向映射，用于网站迁移）。可以串联多个操作（例如，先审查再修复）
• 源 URL：用于 create 和 bulk-import——应进行重定向的 URL。可以是确切 URL、带通配符的 URL 模式（例如，/old-blog/* 重定向到 /blog/*），也可以是用于复杂匹配的正则表达式模式。对于 audit 和 fix，系统会自动从 CMS 中发现源 URL
• 目标 URL：用于 create 和 bulk-import——用户和搜索引擎应被引导至的目标 URL。必须是有效且可访问、返回 200 状态码的 URL。对于 bulk-import，需在导入文件中以源 URL-目标 URL 对的形式提供
• 重定向类型：301（永久——用于永久 URL 变更、域名迁移、升级到 HTTPS 和 URL 重组）或 302（临时——用于 A/B 测试、季节性内容、维护页面或地理重定向）。如果未指定，默认为 301
• CMS 平台：wordpress 或 webflow——必须已连接对应的 CMS MCP 服务。对于 WordPress，请指定重定向管理方式：Redirection 插件、RankMath redirects、Yoast Premium redirects 或直接使用 .htaccess。对于 Webflow，将使用原生重定向 API

Process

1. 加载品牌背景信息：读取 ~/.claude-marketing/brands/_active-brand.json，获取当前启用的品牌标识，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、目标市场的合规规则（skills/context-engine/compliance-rules.md）和行业背景信息。另请检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中是否有指南；如有，请加载其中的限制要求。检查 ~/.claude-marketing/sops/ 中是否有代理机构的 SOP。如果不存在品牌，请询问：“先设置品牌吗（/digital-marketing-pro:brand-setup）？”——或者使用默认设置继续。
2. 对于 create：验证源 URL 和目标 URL：确认源 URL 存在或之前已编入索引（检查 GSC 中的历史数据），验证目标 URL 可访问且返回 200 状态码，检查源 URL 是否已设置重定向以避免重复，并检查拟议的重定向是否会形成重定向链（源 URL 重定向到中间 URL，而该中间 URL 又重定向到其他位置）。对于批量导入，验证导入文件中的每一对源 URL 和目标 URL，并在继续操作前标记所有问题。
3. 对于 audit：爬取所有现有重定向：查询 CMS API，获取所有已配置的重定向规则。对于每条重定向，沿着完整重定向路径跟进，直至最终目标位置。检测重定向链（超过 1 次跳转，例如，A 重定向到 B，B 重定向到 C）、循环（A 重定向到 B，B 又重定向到 A，或更长的循环路径）、指向 4xx 或 5xx 错误页面的重定向、浪费爬取预算的重定向到重定向模式、协议混用的重定向（HTTP 到 HTTPS 再到 HTTP），以及查询参数处理过度的重定向。
4. 对于 fix：解决检测到的问题：对于重定向链，将第一条重定向更新为直接指向最终目标 URL，以消除中间跳转。对于循环，找到正确的最终目标并更新或移除造成循环的规则，以打破循环。对于失效目标，找到正确且可访问的目标位置（检查 URL 变更、存档内容或替代页面）并更新重定向；如果没有明确目标，则标记为需要人工审核。对于重复项，移除冗余规则，保留创建时间最新或匹配最具体的规则。
5. 设置审批关卡：列出所有拟议的重定向变更，并说明当前状态和拟议状态——要创建的新重定向（源 URL、目标 URL、类型）、链路修复（当前路径与简化后的路径，以及减少的跳转次数）、循环处理（已打破的循环及新目标），以及失效目标更新（旧的失效目标与新的有效目标）。评估风险：单条重定向创建或小规模修复（少于 10 项）为 medium；批量导入、迁移规模的变更（超过 10 条重定向）或任何现有重定向规则的删除为 high。
6. 通过 CMS MCP 执行：获批后，通过连接的 CMS MCP 部署重定向变更。对于 WordPress：通过 Redirection 插件 REST API（优先使用，便于日志记录和监控）、RankMath 重定向模块、Yoast Premium 重定向管理器，或直接修改 .htaccess（最后手段，须先备份）创建或更新规则。对于 Webflow：迁移时使用支持批量操作的原生 301 重定向 API。处理 CMS 特定限制——Webflow 仅支持 301、WordPress 插件特定的规则格式，以及不同的模式匹配语法。
7. 部署后验证：向每个已创建或修改的重定向源 URL 发送 HTTP 请求，测试重定向，并确认响应代码（301 或 302）及最终目标位置符合规范。对于链路修复，验证重定向现在可通过一次跳转解析到目标。对于循环修复，验证重定向能够到达 200 页面。报告所有验证失败，以便立即调查。
8. 通过 seo-executor.py 记录所有变更：记录每项重定向变更的时间戳、操作类型（创建、更新、删除）、源 URL、目标 URL、重定向类型、先前状态（适用于更新和修复）、所用的 CMS 平台和方法、验证结果以及回滚说明。对于批量操作，保存完整的变更前重定向状态，以便需要时完整回滚。

输出

结构化的重定向管理报告，包含：

• 重定向变更确认：每个已创建、更新或移除的重定向，包括源 URL、目标 URL、重定向类型（301/302）、执行的操作（新建、修复链式重定向、解决循环、更新目标），以及修改前后的状态
• 审计报告：扫描的重定向总数、发现的链式重定向（包含跳转次数和完整路径）、发现的循环（包含循环路径）、发现的失效目标（包含 HTTP 状态码）、发现的重复项，以及整体重定向健康评分（以干净的单跳重定向占比表示）
• 验证结果：对每个已部署的重定向进行 HTTP 响应测试，包括确认的源 URL、收到的响应码（301/302）、到达的最终目标 URL、跳转次数，以及通过/失败状态。任何失败都会突出显示，并附上诊断详情
• 执行日志条目：带时间戳的记录，包含完整的重定向变更元数据、CMS API 响应、用于回滚的变更前状态快照、审批引用和验证结果，供审计追踪

使用的 Agent

• seo-specialist — 重定向分析，包括链式重定向检测、循环识别和失效目标诊断；根据 GSC 历史数据和实时状态检查验证 URL；规划批量重定向操作；根据使用场景推荐重定向类型（301 与 302）；以及制定重定向整合的链接权益保留策略
• execution-coordinator — 通过 WordPress（Redirection 插件 API、RankMath 重定向、Yoast Premium 重定向、.htaccess 管理）和 Webflow（支持批量操作的原生重定向 API）执行 CMS MCP 操作；根据重定向数量和变更类型进行风险评估，并执行审批工作流；捕获变更前状态以支持回滚；进行 HTTP 验证测试；以及记录包含完整审计追踪的执行日志