★ FEATURED ARTICLE 【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址https://gitcode.com/GitHub_Trending/cl/claude-seo点击查看免费下载导读本文围绕 claude-seo 仓库中的 SXOSearch Experience Optimization搜索体验优化子代理 agents/seo-sxo.md 及其配套技能 skills/seo-sxo/SKILL.md 展开。SXO 的核心命题是为什么技术优化做到 95 分的页面仍然无法排名——答案往往不是技术问题而是该页面根本不是 Google 为这个关键词所奖励的页面类型。读完本文你将掌握一套完整的 SXO 方法论从 SPA 感知、SSRF 防护的页面抓取与解析到 SERP 反向分析、8 类页面类型分类、页面类型错配评级、用户故事推导、7 维差距评分、人设评分再到可选的 IST/SOLL 线框生成以及如何与 DataForSEO、E-E-A-T、Schema、本地 SEO 等其他子技能协同。1. SXO 子代理的定位与核心洞察1.1 子代理是什么在 claude-seo 中seo-sxo同时以两种形态存在Agent 形态agents/seo-sxo.md 定义了一个可被编排器调用的 SXO 分析员角色标注model: sonnet、maxTurns: 20可用工具为 Read、Bash、WebFetch、WebSearch、Glob、Grep、Write。Skill 形态skills/seo-sxo/SKILL.md 提供用户可直接调用的/seo sxo命令族版本号为 2.2.0user-invocable: true参数提示为url [keyword]。两者的分工是Agent 面向编排器audit orchestrator提供结构化的审计输出Skill 面向用户在 Claude Code 会话中交互式执行。两者共享同一套执行流水线和 skills/seo-sxo/references/ 下的四份方法论参考文档。1.2 核心洞察页面类型错配Page-Type MismatchSXO 与传统 SEO 审计的根本区别在于视角SEO Health Score 技术合规度可抓取性、速度、Schema 等衡量页面是否被机器理解。SXO Gap Score 页面与 SERP 期望的契合度衡量页面是否值得为这个关键词排名。一个页面的 SEO 可以拿到 95 分、SXO 却只有 30 分——技术完美但战略错位。最典型的场景当 Google 为某个关键词展示 8 个产品页和 2 个对比页时无论这篇博客写得多么优化它都很难挤进前十因为它属于错误的页面类型。这正是 SXO 要回答的核心问题基于 Google 在 SERP 中实际奖励的内容这个页面配得上这个关键词的排名吗2. 目标页面获取SPA 感知且 SSRF 防护的渲染链路SXO 分析的起点是拿到目标页面的真实渲染结果。Agent 文档明确要求两条命令而不是直接 curlpython3 scripts/render_page.py url --mode auto --json python3 scripts/parse_html.py url2.1 为什么必须使用 render_page.pyscripts/render_page.py 是 claude-seo 共享的无头渲染器其设计动机见模块 docstring非常明确v2.0.0 之前只有seo-visual使用 Playwright其余子代理抓取原始 HTML在 SPA 上会产生大量假阴性——div idroot为空、源码里没有 Schema、没有正文。SXO 的搜索体验评分恰恰需要渲染后的 DOM因为用户看到的就是 JS 产出的内容文档进一步建议--mode always让首屏分析above-the-fold与用户人设实际遭遇的内容一致。三种模式的语义模式行为适用场景auto先原始抓取检测到 SPA shell 时才启动 Playwright默认成本最低且行为正确always即使静态 HTML 也强制渲染SXO 首屏/体验分析推荐never仅原始 HTML等价于旧的fetch_page.py纯源码级检查SPA 检测逻辑见 scripts/render_page.py_SPA_SHELL_PATTERNS覆盖 Reactdiv idroot、__next、Vue/Nuxt#app、__nuxt、Sveltedata-svelte-h、Astro islands 以及 please enable javascript 提示此外还会在body可见文本不足 100 字符时判定为 JS 渲染内容阈值刻意调得保守避免误判 example.com 这类极简静态页。--json输出会返回结构化字段raw_contentJS 执行前、contentJS 执行后、is_spa、extracted_text经 trafilatura 去样板后的正文、publication_date经 htmldate 识别。为避免把数 MB HTML 灌进 stdioJSON 模式会对content、raw_content、extracted_text做截断见 scripts/render_page.py。CLI 还支持--viewportdesktop/laptop/tablet/mobile、--timeout-ms默认 15000、--block image|media|font|stylesheet加速渲染、--no-extract跳过后处理、--a11y-tree捕获 Playwright 无障碍树会强制渲染。2.2 SSRF 与 DNS 重绑定防护Agent 文档强调never call requests.get directly on user-supplied URLs。所有 URL 必须经过 scripts/url_safety.py 的validate_url_strict()预检该函数用socket.getaddrinfo解析域名并核对每个 A 记录均为公网 IP拒绝私网、环回、保留、链路本地、组播、未指定地址见is_safe_ip返回(normalized_url, pinned_ipv4)。由于 Chromium 内部自行解析 DNS、无法在 Python 层做 DNS 固定Playwright 路径采用双重防御预检 make_safe_playwright_route_handler()拦截每个子资源请求并中止解析到非公网 IP 的请求见 scripts/url_safety.py 的 Limitations 说明与 scripts/render_page.py 的调用处。对 requests 路径则提供safe_requests_get/safe_requests_head/safe_requests_session在 DNS 固定的上下文管理器内完成请求OS 解析器只会看到预检通过的 IP。2.3 解析目标页面的 SEO 元素scripts/parse_html.py 基于 BeautifulSoup 提取title、meta description、canonical、H1/H2/H3 层级并标记 ≤3 字符或纯数字的疑似计数器标题、图片含懒加载方式识别native/perfmatters/ewww/js-generic/none见 scripts/parse_html.py、内外部链接、JSON-LD Schema自动展平graph、hreflang、可见文本字数剔除 script/style/nav/footer/header 后统计见 scripts/parse_html.py。SXO 分析员基于这些元素确认页面类型、title、H1、meta description、标题结构、字数、Schema、CTA、媒体。若未提供关键词则从 title 与 H1 的重叠词推导主关键词。3. SERP 反向分析Backwards Analysis读 Google 的奖励信号反向分析的含义是不猜 Google 想要什么而是从 SERP 现有赢家的共同特征反推 Google 正在奖励什么。第 2 步要求用 WebSearch 搜索目标关键词然后逐条记录对前 10 条自然结果记录每个结果的URL 与域名权威层级品牌站 / 垂直权威站 / 未知站页面类型用下述 8 类分类法归类内容格式长文、列表、教程、对比、工具、视频字数估算从摘要长度与页面结构推断Schema 类型从 SERP 特征推断评分、FAQ、HowTo媒体信号视频轮播、图片包、缩略图。同时记录 SERP 特征区块精选摘要段落/列表/表格/视频People Also Ask提取全部可见问题广告顶部与底部计数并分析广告文案主题相关搜索全部提取知识面板 / 本地包 / 购物结果AI Overview 的存在及其引用来源类型。最后计算SERP 共识主导页面类型60% 为强共识40–60% 为混合40% 为碎片化、内容深度期望平均字数层级、Schema 期望最常见的结构化数据类型、媒体期望视频是否必需、图片是否关键。3.1 8 类页面类型分类法分类法完整定义在 skills/seo-sxo/references/page-type-taxonomy.md。每个页面无论目标页还是 SERP 结果必须归入且仅归入一类信号冲突时选择主信号最强的类型。8 类概览类型主信号典型 SERP 指示必备元素常见错配Landing Page单一价值主张 hero、醒目 CTA、定价区、证言、精简导航品牌词、高广告密度、指向 /pricing 的站点链接首屏主 CTA、信任徽章、至少 1 条证言、WebSite/SoftwareApplication Schema博客做落地页词CRITICAL服务页缺 CTA 聚焦HIGHBlog Post作者署名、发布日期、正文 800 词、评论区、/blog/ 面包屑精选摘要、PAA ≥4 问、结果域名多样、摘要含日期Article/BlogPosting Schema、作者实体、datePublished/dateModified、≥1 张带 alt 图产品页做信息词HIGH落地页做 how-to 词CRITICALProduct Page价格、加购/购买按钮、多角度商品图、规格、带星评论、SKU购物结果/商品轮播、价格库存评分富摘要、标题含 buy/shopProduct Schemaname/price/availability/review、高清图、清晰定价、购买 CTA博客做产品词CRITICAL用户想买却给对比页MEDIUMHybrid服务内容教育内容与 CTA 混排、learn more 与 get started 并列品牌词与信息词混合、FAQ Schema 与 SoftwareApplication Schema 并存FAQPage/HowTo 产品 Schema、教育与商业双 CTA纯博客缺产品整合HIGH纯落地页缺教育深度MEDIUMService Page服务方法论/流程、案例研究、团队资历、咨询 CTA、行业术语本地包、near me 相关搜索、agency 域名Service/ProfessionalService Schema、流程描述、案例/证言、联系方式博客做服务词HIGH定制咨询服务用产品页MEDIUMComparison Page标题/URL 含 vs/versus、对比矩阵表、优缺点、side-by-sidevs 相关搜索、多个备选 PAA、评测站域名G2/Capterra/TrustRadius对比表、各选项优缺点、明确推荐、ItemList/Table Schema用户要对比却给单品页HIGH无结构对比的博客HIGHLocal Page实体地址、Google Maps 嵌入、统一 NAP、服务区域、路线/到访区本地包地图3 条、near me 相关搜索、GBP 卡片、本地目录域名LocalBusiness Schema正确子类型、完整 NAP、地理坐标、营业时间、嵌入地图缺本地信号的服务页HIGH[服务] in [城市] 用博客CRITICALTool / Interactive输入框、计算器/生成器界面、滑块/下拉/开关、结果输出区、工具优先极简文案SERP 出现工具/计算器、相关搜索含 calculator/generator/checker、PAA 极少用户想做而非读WebApplication/SoftwareApplication Schema、首屏可用工具、明确输入输出流、基础功能无登录墙用户想要工具却给博客CRITICAL落地页缺交互元素HIGH分类优先级多信号冲突时按序裁决工具 本地除非工具为主 对比 产品 落地页 服务页 混合 博客默认兜底。4. 页面类型错配检测SXO 的核心结论第 3 步将目标页用同一套分类法归类与 SERP 主导类型比对按四级评级目标类型SERP 期望严重度建议Blog PostProduct PagesCRITICAL新建独立产品页Blog PostComparisonHIGH重构为带矩阵的对比页ProductInformationalHIGH增加教育内容层Landing PageTool/CalculatorHIGH构建交互工具组件Service PageLocal ResultsMEDIUM增加本地信号 LocalBusiness Schema类型匹配-ALIGNED聚焦内容深度与 UX若 SERP 碎片化无主导类型则记录为差异化机会——这正是反向分析的隐藏价值当 Google 自己都未形成共识时一个定义清晰、深度到位的页面反而可以定义该关键词的赢家模板。错配一旦存在就是本次分析的 PRIMARY finding必须放在报告最前面。5. 用户故事推导从信号到意图5.1 五类信号源skills/seo-sxo/references/user-story-framework.md 规定每条用户故事必须引用具体的 SERP 信号禁止无证据猜测。信号源及其揭示的意图PAA 问题→ 知识缺口与顾虑。按主题聚类定义类what is 认知阶段、流程类how to 考虑阶段、评估类is X worth it、对比类X vs Y 决策阶段、风险类is X safe。广告文案主题→ 商业触发点与异议处理。常见模式免费试用强调顾虑承诺、trusted-by 计数顾虑信任、价格锚定顾虑成本、速度宣称顾虑时间。若无广告说明该词偏信息型、商业意图低。相关搜索→ 搜索旅程。 for beginners / pricing 收窄[词] alternatives 不满信号[词] vs [对手] 对比决策阶段[词] reviews 购买前寻求信任。精选摘要格式→ 期望的答案结构。段落简明定义列表步骤/排行表格结构化对比视频可视化演示无摘要Google 未定形机会。AI Overview→ Google 认可的权威综合。被引用来源该主题上 Google 信任的权威信号若目标页未被引用说明其内容不匹配 Google 的综合模型。5.2 用户故事模板对每个信号簇生成一条用户故事3–5 条覆盖至少两个旅程阶段认知、考虑、决策As a [persona derived from signal], I want to [goal derived from query intent], because [emotional driver from ad copy / PAA tone], but Im blocked by [barrier derived from PAA questions / related searches].5.3 情感状态与障碍类型映射情感状态映射PAA 出现 Is X safe / legitimate / scam → 怀疑相关搜索大量对比 → 选择过载PAA 被 How to [基础任务] 主导 → 困惑/受挫高广告密度 购物结果 → 准备购买Best [X] for [use case] → 谨慎评估[X] not working → 对现有方案不满。障碍类型每条都必须能在页面层面给出解法信息缺口 → 首屏给出完整答案信任缺口 → 社会证明、资历、保证对比疲劳 → 明确差异化或推荐价格敏感 → 透明定价与价值论证技术困惑 → 分步指南、演示或工具时间压力 → 速胜内容、快速解决。示例推导关键词 project management software完整示例见参考文档由 PAA cheapest、相关搜索 small business、广告 free forever 推导出SMB 主的价格敏感故事由相关搜索 Asana vs Monday vs ClickUp 与 PAA is Monday better than Asana 推导出评估者的对比疲劳故事由广告 set up in 5 minutes 与 PAA do I need PM software for small team 推导出非技术管理者的技术困惑故事。每条故事都标注了来源信号。6. 七维差距分析SXO Gap Score第 5 步把目标页与 SERP 期望在 7 个维度上逐一对比满分 100维度对比内容分值页面类型Page Type目标类型 vs SERP 主导类型0–15内容深度Content Depth字数、标题层级、主题覆盖0–15UX 信号UX SignalsCTA 清晰度、首屏内容、移动端布局0–15Schema 标记Schema Markup现有 vs 期望的结构化数据0–15媒体丰富度Media Richness图片、视频、交互元素 vs SERP 常态0–15权威信号Authority SignalsE-E-A-T 标记、社会证明、资历0–15新鲜度Freshness最后更新、日期信号、内容时效0–10每个分数必须附带具体证据引用页面实际内容不能只给数字。分数越低差距越大越高越契合——注意 SXO Gap Score 的方向语义与常规健康分相反。7. 人设评分从多重视角审视页面7.1 人设推导skills/seo-sxo/references/persona-scoring.md 要求从 SERP 意图信号推导 4–7 个人设不发明无人设证据的人设。来源包括PAA 问题簇 → 新手/技术评估者广告文案分群 → 预算买家/企业买家相关搜索主题 → 研究者/对比购物者SERP 结果类型 → 视觉学习者/数据驱动分析师精选摘要格式 → 速答寻求者。人设卡片格式每条含 Role、Goal、Emotional state、Journey stage、Key questions、SERP evidence。7.2 四维评分细则每维 25 分每人设 100 分相关性 Relevance0–25页面是否回应此人的具体需求。21–25 直接命中主要目标16–20 覆盖主题但缺人设化深度11–15 仅沾边需自行推导6–10 提到主题但服务他人0–5 完全无关。评分信号关键词与人设目标对齐、人设相关区块如为 SMB 人设设 for small businesses 板块的存在。清晰度 Clarity0–25此人能否在 10 秒内找到答案。21–25 首屏可见16–20 在页面上但需滚动11–15 存在但埋没于长文6–10 需拼凑多个区块0–5 找不到答案直接跳出。评分信号标题与人设问题对齐、可扫描性列表/表格/加粗、目录与锚点跳转。信任 Trust0–25页面是否提供此人所需的信任信号。21–25 多个直接相关的信任信号16–20 有通用信号但不针对人设11–15 有信号但有缺口6–10 极少信号感到不确定0–5 无信号甚至损害信任。评分信号同类用户证言、相关认证、安全徽章面向风险厌恶者、匹配行业/规模的案例研究、作者专业度。行动 Action0–25此人是否有清晰的下一步。21–25 清晰且低摩擦的人设化 CTA16–20 CTA 存在但泛化11–15 有下一步但不醒目6–10 单一 CTA 不匹配旅程阶段0–5 死胡同。评分信号CTA 与旅程阶段匹配认知期 learn more vs 决策期 buy now、摩擦度免费试用 vs 销售电话、放置位置、为不同准备程度提供替代路径。7.3 分数解读与优先级区间评级含义80–100Excellent服务良好仅需微调60–79Good相关但有明显缺口40–59Needs Work部分服务需显著改进0–39Critical Mismatch彻底失败需大改或新建页面聚合与排序按预估搜索量占比加权SERP 70% 信息意图则加权信息型人设广告主导则加权商业型有本地包则加权本地人设。修复优先级最弱且搜索量权重最高的人设 最大机会→所有维度中得分最低的跨人设共性 系统性问题→Critical Mismatch 人设 根本页面类型问题。建议必须具体到区块名、CTA 文案与放置位置。8. 可选步骤IST/SOLL 线框生成仅当调用/seo sxo wireframe url时执行模板见 skills/seo-sxo/references/wireframe-templates.md。流程从已解析的页面结构生成IST现状线框基于 SERP 共识页面类型 差距分析发现 人设评分弱点生成SOLL目标线框。三条核心原则超具体占位符不是 Add a CTA here而是 Add pricing CTA with annual savings badge below hero, linking to /pricing#enterprise移动优先假设 375px 视口首屏约 600px 内必须承载该页面类型最关键元素语义化 HTML以 HTML5 元素输出区块大纲与注释。参考文档按 8 类页面类型分别给出 SOLL 模板骨架例如 Landing Page 为header(logo3-4 链接主CTA) → hero(H1副标题CTA信任行) → social-proof → features(3 块回应 PAA) → how-it-works(3 步) → testimonial → pricing(2-3 档推荐高亮年付切换) → faq(5-7 条 PAAFAQPage Schema) → final-cta。同时提供糟糕 vs 具体的占位符对照表确保生成结果可直接交给前端落地。9. 命令一览与 DataForSEO 集成9.1 用户命令命令用途/seo sxo url完整 SXO 分析自动从页面推导关键词/seo sxo url keyword针对指定关键词的完整 SXO 分析/seo sxo wireframe url生成带具体占位符的 IST/SOLL 线框/seo sxo personas url仅做人设评分跳过 SERP 分析9.2 DataForSEO 集成若环境中存在 DataForSEO MCP 工具任何 API 调用前先做成本估算并与用户确认用google_organic_serp获取精确 SERP 数据排名、特征、摘要用keyword_data获取搜索量与竞争度DataForSEO 不可用时回退 WebSearch并在输出中注明精度降低。参考 extensions/dataforseo/docs/DATAFORSEO-SETUP.md 可了解该扩展的接入方式。10. 标准输出格式与错误处理10.1 完整 SXO 分析模板## SXO Analysis: [URL] ### Target Keyword: [keyword] ### 1. SERP Landscape - Dominant page type: [type] ([confidence]% consensus) - SERP features: [list] - Content depth norm: [word count range] - Schema expectation: [types] ### 2. Page-Type Alignment - Your page type: [type] - SERP expects: [type] - Verdict: [ALIGNED | MISMATCH (severity)] - Impact: [explanation] ### 3. User Stories (derived from SERP signals) [3-5 user stories with source signals] ### 4. Gap Analysis (SXO Score: XX/100) [7-dimension breakdown table] ### 5. Persona Scores [4-7 persona cards with 4-dimension scores] ### 6. Priority Actions [Ranked list: fix mismatch first, then weakest persona gaps] ### 7. Limitations [What could not be assessed, data source notes]输出规则SXO 分数与 SEO Health Score 完全分离、始终标注为 SXO Gap Score有错配则置顶必须包含 Limitations 小节诚实说明哪些内容无法评估最后提供 Generate a PDF report? Use/seo google report。10.2 错误处理矩阵错误处理URL 抓取失败报告错误建议检查 URL 可访问性无关键词且检测不到请用户提供目标关键词WebSearch 结果 5 条用现有数据继续注明样本有限SERP 全为广告无自然结果标注高商业性 SERP仅分析广告文案目标页为 JS 渲染注明局限使用可用 HTML 内容DataForSEO 成本超阈值回退 WebSearch 并通知用户11. 跨技能协同与持久化输出11.1 跨技能推荐SXO 不试图解决一切问题发现问题后按表转交发现转交人设评分暴露 E-E-A-T 缺口/seo content深度 E-E-A-T 审计缺少 Schema 类型/seo schema生成SERP 检测到本地意图/seo local做 GBP 分析内容深度不足/seo page深度页面分析抓取中发现问题/seo technical全面审计图片/媒体缺口/seo images优化对应的子代理定义见 agents/seo-content.md、agents/seo-schema.md、agents/seo-local.md、agents/seo-technical.md 等。11.2 审计持久化当编排器提供output_dir时写入output_dir/findings/sxo.mdSERP 意图、页面类型错配、用户故事、人设与 UX 差距发现audit-data.json中 Search Experience 类目下的结构化 JSON 兼容发现。12. 交付前质量清单两份文档Agent 与 Skill都内置了交付前核查合并如下目标 URL 经由scripts/render_page.py --mode auto抓取而非裸 curl/fetch页面类型归类使用了 taxonomy 参考文档至少分析了 5 条 SERP 结果每条用户故事引用了具体的 SERP 信号作为证据人设评分包含具体改进建议错配严重度已明确评级SXO 分数明确标注为独立于 SEO Health ScoreLimitations 小节存在且诚实在相关处包含跨技能推荐结语把 SXO 纳入常规审计循环SXO 的价值不在于取代传统技术审计而在于补上技术满分却排不上去这一盲区。它通过 agents/seo-sxo.md 中定义的流水线——安全渲染目标页 → SERP 反向分析 → 8 类页面类型归类 → 错配评级 → 信号驱动的用户故事 → 7 维 Gap Score → 4–7 人设多视角评分→ 可选线框——把Google 奖励什么与页面提供了什么之间的差距变成可量化、可排优先级、可落地的行动计划。在每次 SEO 健康分审计的同时运行 SXO 分析并同时报告两个分数例如 95 SEO 30 SXO你就能从为什么排不上去走向它值得排上去的页面形态是什么。赞分享【免费下载链接】claude-seoUniversal SEO skill for Claude Code. 26 sub-skills 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.项目地址https://gitcode.com/GitHub_Trending/cl/claude-seo点击查看免费下载相关推荐Calibre格式转换10分钟上手4步转出第一本电子书再批量处理42篇Calibre格式转换10分钟上手4步转出第一本电子书再批量处理42篇 你下载的PDF正文全是硬换行重排不了Calibre是免费开源的电子书管理器它的桌面应用CLIclaude-seo 单页面深度 SEO 分析seo-page 技能的检查清单、评分体系与底层实现claude seo 单页面深度 SEO 分析seo page 技能的检查清单、评分体系与底层实现 导读 本文基于 claude seo 开源仓库中的 seoclaude-seo SXO Wireframe 模板实战以 IST/SOLL 模式对齐 SERP 页面类型期望claude seo SXO Wireframe 模板实战以 IST/SOLL 模式对齐 SERP 页面类型期望 本文是一份关于 claude seo 开源项上一篇Parcel零配置Web构建工具的全面解析下一篇7步打造超级浏览器Firefox Scripts解锁自定义新境界创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
