SXO 搜索体验优化
通过反向分析 Google SERP，发现页面类型与搜索意图的错配，并把排名问题转化为可执行的用户体验改进。
技能要求使用 SSRF-safe 渲染、DataForSEO 调用前确认成本，并规定失败时报告限制，显示出一定的权限与外部影响意识；但未在本技能中完整说明页面数据流、第三方搜索数据处理、凭据隔离、回滚或结果来源归因，因此扣分。
流程、分类规则、错误处理和质量清单较完整，且依赖多个脚本与参考文件；但本次仅静态阅读，未执行关键路径，且无法确认脚本参数、WebSearch 能力和各引用文件在该修订中均可复现，因此不超过静态上限并扣分。
触发词、目标用户输入、命令变体和输出结构明确，覆盖 SERP 分析、用户故事、画像和线框场景；但非适用边界、中文输出支持及大陆网络对 Google/WebSearch 依赖的可达性未充分说明，因此扣分。
具备 front matter、MIT 许可证、版本号、分层参考文档、命令表、示例输出、错误处理和限制提示；但本技能缺少独立安装说明、FAQ、变更记录、维护责任和更新路径，部分治理信息依赖仓库级文件，因此扣分。
目标是把实时 SERP 信号转化为页面类型判断、缺口分析、画像评分和可执行线框，理论上直接服务 SEO 决策；但核心结果依赖实时抓取和搜索，静态材料没有提供该技能关键路径的可验证产出证据，因此按静态上限保守扣分。
分类标准、评分方法和信号来源均有可审计文本，README 还声称有测试与主要来源依据；但给定材料未提供针对 seo-sxo 关键路径的测试结果、第三方复核或可复现样例，且方法中的 SERP 观察无法由静态读取独立验证，因此扣分。
- 核心分析依赖 Google/WebSearch、目标 URL 抓取和可选 DataForSEO；网络不可达、反爬或地区差异可能使结果不完整。
- 技能要求至少分析 5 个 SERP 结果，但未定义搜索结果快照、地区、语言、设备和时间，结果可重复性有限。
- 未在技能文档中明确声明敏感页面内容、查询词及第三方 API 数据的保存、脱敏和生命周期策略。
- README 的测试与安全声明属于仓库级上下文，不能证明 seo-sxo 本身的关键输出已被测试。
这个 Skill 能做什么，适合哪些场景？
这是 claude-seo 仓库中的单个 SXO 技能，专注于搜索体验优化，而不是完整的技术 SEO 审计。它抓取并解析目标页面，分析关键词的 Google 搜索结果页，判断页面类型是否符合 SERP 共识，并从用户故事与 persona 视角评估页面。输出包括 SERP 格局、页面类型匹配结论、用户故事、七维差距评分、persona 评分和优先行动建议。它适合已经具备基础 SEO 优化、但仍无法理解页面为何不排名的团队。
使用 scripts/render_page.py 以自动模式抓取目标 URL，再用 scripts/parse_html.py 提取标题、H1、meta description、标题层级、字数、结构化数据、CTA 和媒体元素。没有提供关键词时，它根据 title 与 H1 的重叠内容提取主关键词。随后通过 WebSearch 分析最多 10 个有机结果及 SERP 特征，包括页面类型、内容格式、权威度、结构化数据、媒体信号、PAA、广告、相关搜索、本地包、购物结果和 AI Overview。它依据页面类型分类规则检测错配，结合 SERP 信号生成 3-5 个用户故事，并从页面类型、内容深度、UX、Schema、媒体、权威信号和新鲜度七个维度计算 0-100 的 SXO Gap Score。它还会从 SERP 意图信号推导 4-7 个 persona，按相关性、清晰度、信任和行动四项评分；在 wireframe 命令下生成当前状态与目标状态的语义 HTML 线框。
- SEO 顾问面对一个技术指标良好但长期不排名的页面时，用 SERP 共识判断问题是否是页面类型错配。
- 内容团队准备围绕一个关键词重构页面时，用 PAA、广告文案和相关搜索提炼用户故事与内容结构。
- 产品或增长团队优化落地页时，用 persona 评分找出清晰度、信任信号或 CTA 的具体缺口。
- UX 与 SEO 团队需要交付可执行改版方案时，用 wireframe 模式生成带具体占位内容的 IST/SOLL 页面结构。
这个 Skill 有哪些优点和局限？
- 聚焦传统技术 SEO 审计容易忽略的页面类型与搜索意图匹配问题。
- 把 PAA、广告文案、相关搜索和 AI Overview 等 SERP 信号转化为用户故事和改进建议。
- 提供可区分的 SXO Gap Score，并明确它不同于 SEO Health Score。
- 支持 persona 级别的相关性、清晰度、信任和行动评分，以及具体改进建议。
- 依赖目标 URL 可访问、页面抓取和 WebSearch；抓取失败或搜索结果少时，结论会受限。
- 重度依赖滚动触发 hydration、用户交互后加载内容或第三方组件的页面，可能产生噪声。
- DataForSEO、Firecrawl 和 Banana 等扩展属于整个仓库的可选能力，不能视为本技能默认提供的功能。
- SKILL.md 要求使用 Claude Code 风格的 /seo 命令；迁移到其他客户端需要调整触发方式和工具调用。
如何安装这个 Skill？
该技能位于仓库的 skills/seo-sxo/SKILL.md。README 提供的集合安装方式是：在 Claude Code 中运行 /plugin marketplace add AgriciDaniel/claude-seo，然后运行 /plugin install claude-seo@agricidaniel-claude-seo；或者执行 git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git，再运行 bash claude-seo/install.sh。README 未单独说明只安装 seo-sxo 子目录的步骤。运行环境要求 Python 3.10+；仓库说明 Playwright Chromium 可用于 SPA 渲染。
如何使用这个 Skill？
在 Claude Code 中触发 /seo sxo <url> 进行完整 SXO 分析，或使用 /seo sxo <url> <keyword> 指定关键词。使用 /seo sxo wireframe <url> 生成 IST/SOLL 线框，使用 /seo sxo personas <url> 仅执行 persona 评分。若没有提供且无法从页面提取关键词，技能会要求提供目标关键词。DataForSEO 可选：若相关 MCP 工具可用，技能要求先估算成本并确认，再使用实时 SERP 数据；否则使用 WebSearch 并注明精度降低。
这个 Skill 与同类方案有什么区别？
与只检查可抓取性、速度和结构化数据的传统技术 SEO 审计相比，本技能重点判断页面是否符合目标关键词的 SERP 页面类型、内容格式和用户需求。它也不同于 Screaming Frog 或 Ahrefs Site Audit 这类完整爬虫或商业审计工具；本技能的范围是单个页面的 SERP 反向分析、用户故事、persona 评分和线框建议。