【免费下载链接】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 是面向 Claude Code 的通用 SEO 技能包其seo-technical子代理专职对给定 URL 执行技术 SEO 审计覆盖可爬取性、可索引性、安全性、URL 结构、移动端、Core Web Vitals、结构化数据、JavaScript 渲染与 IndexNow 协议九大维度。本文以 agents/seo-technical.md 为骨架结合其对应的 seo-technical skill、底层渲染与安全源码及测试用例完整讲解该代理的抓取工作流、审计清单、评分输出与可选 Google/DataForSEO 集成读完即可在 Claude Code 中复现一整套可落地、可验证的技术 SEO 审计流程。一、子代理定位与审计工作流seo-technical是一个通过 frontmatter 定义行为的 Claude Code 子代理定义见 agents/seo-technical.md模型sonnet最大交互轮次 20工具集Read、Bash、Write、Glob、GrepWrite 用于输出报告与数据文件职责给定一个或一组 URL 后依次完成页面抓取、robots.txt 与 sitemap 检查、meta/canonical/安全头分析、URL 结构与重定向链评估、移动端友好性评估、Core Web Vitals 潜在问题标记、JavaScript 渲染需求核查最终输出结构化审计报告。审计工作流的标准执行顺序为抓取页面并分析 HTML 源码检查 robots.txt 与 sitemap 可用性分析 meta 标签、canonical 标签与安全响应头评估 URL 结构及重定向链基于 HTML/CSS 分析评估移动端友好性从源码检查中标记潜在的 Core Web Vitals 问题核查 JavaScript 渲染需求。同一职责在 skill 侧还有一份人类可读的完整版清单 skills/seo-technical/SKILL.mdv2.2.0MIT 许可子代理与 skill 共用同一套 9 大类别框架两者可以互为参考。二、页面抓取管线v2.0.0render_page 三模式技术 SEO 审计的第一步是拿到页面真实可分析的内容。claude-seo 自 v2.0.0 起将无头渲染统一收口到python3 scripts/render_page.py替代此前各子代理各自用fetch_page.py抓原始 HTML 的做法——旧方式在 SPA 上会产生假阴性空div idroot、源码中无 schema、无正文内容。2.1 三种抓取模式模式行为适用场景auto先做原始抓取仅当检测到 SPA 壳时才启动 Playwright 渲染默认模式成本最低的正确行为always无论静态还是动态页面都用 Playwright 渲染需要拿到 JS 执行后的 DOM、accessibility tree 时never只取原始 HTML等价于旧版fetch_page.py纯静态页面快速检查典型调用方式与子代理文档中给出的命令一致# 默认 autoSPA 才渲染 python3 scripts/render_page.py URL --mode auto --json # 强制渲染 python3 scripts/render_page.py URL --mode always # 跳过 Playwright只拿原始 HTML python3 scripts/render_page.py URL --mode never # 写入完整 HTML 文件 python3 scripts/render_page.py URL --output page.html--json输出的是经过截断的摘要content、raw_content、extracted_text均有限长避免 Agent 经 stdio 传递数 MB HTML需要完整 HTML 时使用--output或在代码中直接导入render_page.render_page()。2.2 JSON 摘要字段与内容提取返回结果是一个字典即“结果形状契约”8 个子代理共享该 API测试见 tests/test_render_page.py字段含义url重定向后的最终 URLstatus_code主文档 HTTP 状态码contentJS 执行后的 HTMLpost-render DOMraw_contentJS 执行前的 HTML服务器响应is_spa原始 HTML 是否呈 hydration 壳特征extracted_texttrafilatura 去样板后的正文提取可能为 Nonepublication_datehtmldate 识别的 ISO 8601 发布日期可能为 Noneheaders主文档响应头redirect_chain{url, status_code}列表console_errors浏览器控制台错误字符串列表render_engineplaywright-chromium或 Nonerender_ms渲染阶段耗时毫秒mode_usedrendered或rawerror错误信息或 Noneextracted_text与publication_date分别由 trafilatura 与 htmldate 提供二者是可选依赖未安装时优雅降级为 None测试见 tests/test_render_page.py。2.3 SPA 检测启发式auto 模式的核心auto模式是否会触发 Playwright 取决于_is_spa()启发式函数scripts/render_page.py。它检查两类信号hydration 壳签名div idroot/div、div id__next、div idapp、div id__nuxt、data-svelte-h、astro-island、you need to enable javascript/please enable javascript等覆盖 ReactCRA/Vite/Remix、Next.js、Vue、Nuxt、Svelte、Astro islands 及 noscript 提示模式薄 body 兜底body内去标签后的可见文本少于 100 字符即判为 SPA。该阈值特意调校到不误伤example.com这类极简信息页约 125 字符避免在 auto 模式下做冗余渲染。参数化测试覆盖了上述全部正向与负向样本tests/test_render_page.py并验证了never模式即使检测到 SPA 壳也不会启动渲染tests/test_render_page.py。2.4 其他 CLI 选项render_page.py还支持--viewportdesktop/laptop/tablet/mobile预设见源码VIEWPORTS、--timeout-ms默认 15000、--block image|media|font|stylesheet按资源类型拦截以加速、--no-extract跳过 trafilatura/htmldate以及--a11y-tree捕获 Playwright accessibility tree 快照会强制进入渲染模式。渲染后还有 500ms 的延迟等待以允许延后 hydrationdeferred islands、useEffect 链并收集控制台错误供审计参考。三、安全第一url_safety 的 SSRF 与 DNS 重绑定防护子代理文档明确要求绝不直接对用户提供的 URL 调用requests.get所有网络入口必须先经 scripts/url_safety.py 校验。这是 claude-seo 的统一安全基座validate_url_strict(url)通过socket.getaddrinfo解析主机名校验每一个 A 记录均为公网 IP返回(normalized_url, pinned_ipv4)任何一个非公网 IP 都抛URLSafetyErrorsafe_requests_get()在 DNS 固定pinning上下文内执行requests.get期间socket.getaddrinfo被临时替换重定向目标等任何其他主机名解析也必须通过公网 IP 校验硬屏蔽主机名单涵盖localhost、metadata.google.internal、metadata.azure.com、metadata.ec2.internal、169.254.169.254、fd00:ec2::254等各云厂商 metadata 端点规范化处理 IPv4 混淆形式2130706433、0x7f000001、0177.0.0.1、前导零点分形式等防止以数字字面量绕过 IP 范围检查。对 Playwright 浏览器抓取Chromium 自行解析 DNS无法在 Python 层固定make_safe_playwright_route_handler()作为纵深防御在page.route(**/*, handler)中拦截每个子资源请求并重新校验目标 IP私有地址一律route.abort()。测试用例覆盖了127.0.0.1、10.0.0.7、169.254.169.254、混淆 IP 及 FQDN 形式 metadata 域名的拦截tests/test_render_page.py。四、九大审计类别详解4.1 可爬取性Crawlability检查点包括robots.txt 是否存在、语法是否有效、是否误拦截关键资源XML sitemap 是否存在、是否在 robots.txt 中声明、格式是否有效noindex 标签是有意还是误加重要页面距离首页的点击深度是否在 3 跳以内关键内容是否依赖 JS 执行对超过 1 万页的大型站点评估爬取预算效率。AI 爬虫管理2025–2026 重点AI 公司正在大规模爬取网页用于模型训练与 AI 搜索在 robots.txt 中管理这些爬虫已成为技术 SEO 的关键议题。已知 AI 爬虫及 token 见下表源自 skills/seo-technical/SKILL.md爬虫公司robots.txt token用途GPTBotOpenAIGPTBot模型训练ChatGPT-UserOpenAIChatGPT-User实时浏览ClaudeBotAnthropicClaudeBot模型训练PerplexityBotPerplexityPerplexityBot搜索索引 训练BytespiderByteDanceBytespider模型训练Google-ExtendedGoogleGoogle-ExtendedGemini 训练非搜索CCBotCommon CrawlCCBot开放数据集关键区分屏蔽Google-Extended只阻止 Gemini 训练用途不影响Google 搜索索引与 AI Overviews它们走Googlebot屏蔽GPTBot阻止 OpenAI 训练但不阻止ChatGPT 通过浏览引用你的内容走ChatGPT-User。约 3–5% 的网站已启用针对 AI 的 robots.txt 规则。选择性拦截示例允许搜索索引、拦截 AI 训练爬虫# Allow search indexing, block AI training crawlers User-agent: GPTBot Disallow: / User-agent: Google-Extended Disallow: / User-agent: Bytespider Disallow: / # Allow all other crawlers (including Googlebot for search) User-agent: * Allow: /建议在屏蔽前先想清楚 AI 可见性策略——被 AI 系统引用会带来品牌曝光与推荐流量。完整的 AI 可见性优化可交叉参考seo-geoskill。4.2 可索引性Indexability检查 canonical 标签是否自引用、与 noindex 是否冲突重复内容近似重复、参数 URL、www 与非 www 版本每类页面类型的瘦内容字数下限分页relnext/prev 或 load-more 模式多语言/多地区站点的 hreflang 正确性以及消耗爬取预算的索引膨胀index bloat。hreflang 的深入校验按跨技能委派约定交给seo-hreflang子技能处理见 agents/seo-technical.md 的 Cross-Skill Delegation 一节。4.3 安全性Security检查 HTTPS 是否强制、SSL 证书是否有效、有无混合内容以及以下安全头Content-Security-Policy (CSP)Strict-Transport-Security (HSTS)X-Frame-OptionsX-Content-Type-OptionsReferrer-Policy对高安全级别站点额外检查是否已加入 HSTS preload 列表。注意抓取阶段拿到的headers响应头字段正好是这部分审计的数据来源。4.4 URL 结构URL Structure干净 URL描述性、连字符分隔、内容页不携带查询参数层级符合站点架构逻辑的目录结构重定向无重定向链最多 1 跳永久移动用 301URL 长度超过 100 字符即标记尾斜杠全局保持一致。render_page返回的redirect_chain{url, status_code}列表可直接用于评估重定向跳数与跳转类型。4.5 移动端优化Mobile Optimization响应式设计viewport meta 标签、响应式 CSS触控目标最小 48×48px 且间距 8px字体大小基础字号最小 16px无横向滚动移动优先索引截至 2024 年 7 月 5 日Google 的移动优先索引已 100% 完成Google 现在完全使用移动版 Googlebot user-agent 爬取并索引所有网站。务必确保移动版本包含全部关键内容、结构化数据与 meta 标签。4.6 Core Web Vitals当前阈值2026 年口径与 skills/seo/references/cwv-thresholds.md 一致指标GoodNeeds ImprovementPoorLCPLargest Contentful Paint2.5s2.5–4s4sINPInteraction to Next Paint200ms200–500ms500msCLSCumulative Layout Shift0.10.1–0.250.25重要事实INP 已于 2024 年 3 月 12 日取代 FIDFID 于 2024 年 9 月 9 日从所有 Chrome 工具CrUX API、PageSpeed Insights、Lighthouse中完全移除。INP 是唯一的交互性指标任何输出中都不应再引用 FID。评估口径为真实用户数据的75 分位field data from CrUXGoogle 在页面级与来源origin级同时评估。Core Web Vitals 是平局决胜性质的排名信号当竞争对手内容质量相近时影响最大。阈值自定义以来未变过可忽略 SEO 博客中所谓“阈值收紧”的说法。LCP 子部分诊断2025 年 2 月 CrUX 新增子部分度量内容目标TTFB首字节时间服务器响应800msResource Load DelayTTFB 到资源请求开始尽量小Resource Load TimeLCP 资源下载耗时视资源大小Element Render Delay资源加载到渲染完成尽量小总 LCP TTFB Resource Load Delay Resource Load Time Element Render Delay。常用瓶颈定位与优化优先级LCP 对感知性能影响最大压缩 hero 图、WebP/AVIF、preload、消除阻塞渲染的 CSS/JS、TTFB200ms 时用边缘 CDN、字体用font-display: swapCLS 是最常见的用户体验问题图片/iframe 预留宽高、动态注入内容预留空间INP 对交互型应用最重要主线程长任务拆分为 50ms 片段、防抖事件、DOM 元素 1500 个需警惕、第三方脚本抢占主线程。性能工具层面注意Lighthouse 是实验室工具必须与 CrUX 现场数据交叉验证CrUX Vis 已于 2025 年 11 月取代旧版 CrUX Dashboard。4.7 结构化数据Structured Data检测 JSON-LD首选、Microdata、RDFa 三种格式并按 Google 支持的类型做校验。深度分析由seo-schemaskill 负责此处只做检测与初步验证。值得注意的 2025 年 12 月 Google 更新要点见下文 4.8通过 JS 注入的结构化数据可能被延迟处理电商 Product 等时效敏感型标记应放入初始服务端 HTML。4.8 JavaScript 渲染JavaScript Rendering检查内容在初始 HTML 中是否可见、是否依赖 JS识别 CSR客户端渲染与 SSR服务端渲染标记 React、Vue、Angular 等可能导致索引问题的 SPA 框架如适用则验证动态渲染dynamic rendering配置。Google 2025 年 12 月 JavaScript SEO 文档更新关键澄清Canonical 冲突若原始 HTML 中的 canonical 与 JS 注入的不同Google 可能采用两者中的任意一个。必须保证服务端 HTML 与 JS 渲染输出中的 canonical 完全一致noindex 与 JS若原始 HTML 含meta namerobots contentnoindex而 JS 将其移除Google仍可能遵循原始 HTML 的 noindex。请直接在初始 HTML 响应中下发正确的 robots 指令非 200 状态码Google不会在返回非 200 状态码的页面上执行 JavaScript。错误页上经 JS 注入的内容或 meta 标签对 Googlebot 不可见JS 中的结构化数据经 JS 注入的 Product、Article 等结构化数据可能被延迟处理时效敏感的结构化数据应包含在初始服务端 HTML 中。最佳实践把关键 SEO 元素canonical、meta robots、结构化数据、title、meta description放进初始服务端 HTML而不是依赖 JS 注入。4.9 IndexNow 协议检查站点是否支持 IndexNowBing、Yandex、Naver 消费同一开放端点Google 截至 2026 年不消费该协议因此它特指非 Google 引擎的索引信号。仓库提供了现成提交脚本 scripts/indexnow_submit.pypython3 scripts/indexnow_submit.py \ --host example.com \ --key abcd1234… \ --key-location https://example.com/abcd1234.txt \ --urls https://example.com/new-post https://example.com/updated-page # 或从文件按行读取 URL python3 scripts/indexnow_submit.py \ --host example.com --key abcd1234… --key-location https://… \ --urls-file changed.txt设置三步走生成 32 字符主机密钥 → 将密钥文件放到站点根目录https://example.com/key.txt文件内容即密钥本身IndexNow 会爬取一次以证明主机所有权→ 传密钥与密钥位置给脚本或设置INDEXNOW_KEY、INDEXNOW_KEY_LOCATION环境变量。脚本内置了与 IndexNow 规范一致的校验批次上限 10000 个 URL、密钥长度 8–128 字符、所有 URL 必须属于声明主机拒绝跨主机提交、每个 URL 经url_safety.validate_url_strict校验以防私有 IP 混入对应测试见 tests/test_technical_depth.py。verify_key_published()还提供密钥发布预检避免“密钥文件内容与密钥不匹配导致后续提交被静默拒绝”的常见配置错误。五、面向未来的 Agent-Friendly PagesAI Agent不只是 AI 摘要器正通过三条通道阅读网站视觉模型看截图、原始 HTML/DOM、以及可访问性树accessibility tree——三者中最干净的信号。审计标准真实button/a而非div onclick、label 关联、交互目标尺寸、模板间布局稳定性、cursor: pointer正确性详见 skills/seo-technical/references/agent-friendly-pages.md。仓库提供了自动化扫描命令# 用 Playwright 渲染并捕获 accessibility tree然后评分 python3 scripts/agent_ux_check.py https://example.com --jsonagent_ux_check.py强制以modealways调用render_page()并开启extract_accessibilityTruescripts/agent_ux_check.py其评分逻辑0–100包括每个div onclick扣 5 分上限 20、无语义 landmarks 扣 10、无label[for]的输入每个扣 4上限 20、无 accessible name 的交互节点每个扣 3上限 20、rolegeneric占比超 50% 扣 10。HTML 侧统计真实按钮/锚点/div onclick组件/语义 landmarks/无标签输入accessibility tree 侧统计总节点、交互节点、未命名交互元素与rolegeneric占比。需要说明的是Agent-UX 相关标准如 WebMCP尚处早期审计姿态是把发现作为“机会”而非“失败”不要用满分门槛卡审计结果。WebMCP类似 Claude/Anthropic 生态中的 MCP、但运行在页面层面的站点直连 Agent 标准提案目前只有早期预览广泛采用预计不早于 2027 年报告中作为前瞻信号提及即可不应把“没有 WebMCP 支持”作为发现项。六、可选集成DataForSEO 与 Google API6.1 DataForSEO若配置了 DataForSEO MCP 工具可用on_page_instant_pages做真实页面分析状态码、页面耗时、坏链、页面检查用on_page_lighthouse获取 Lighthouse 审计性能、无障碍、SEO 分数用domain_analytics_technologies_domain_technologies做技术栈检测。6.2 Google API配置 Google API 凭据后可将 CWV 从“实验室估算”升级为“真实现场数据”# PSI CrUX 现场数据替代纯实验室估算 python3 scripts/pagespeed_check.py url --json # 25 周 CWV 趋势 python3 scripts/crux_history.py url --json # 逐 URL 的真实索引状态 python3 scripts/gsc_inspect.py url --json三个脚本的实现要点scripts/pagespeed_check.py 组合 PageSpeed Insights v5Lighthouse 实验室分析与 CrUX API真实用户现场数据内置CWV_THRESHOLDSLCP good 2500ms / poor 4000ms、INP good 200ms / poor 500ms、CLS good 0.1 / poor 0.25rate_metric()将指标评为 good/needs-improvement/poor并抽取 opportunity含预计节省毫秒数、diagnostics、failed audits 与具体问题资源明细scripts/crux_history.py 通过 CrUX History API 拉取最多 25 周的时间序列detect_trends()以“最近 4 周均值 vs 最早 4 周均值”判断每项指标为 improving/stable/degrading变化幅度 5% 视为 stable——对 CWV 而言负变化即改善scripts/gsc_inspect.py 通过 Search Console URL Inspection API 返回索引裁决verdict、coverage state、robots.txt 状态、Google 与用户 canonical 是否匹配googleCanonical userCanonical、富结果检测注意配额为每站点 600 QPM / 2000 QPD批量模式默认 1 秒间隔。这些真实数据源恰好补足了错误处理表中“CrUX 数据不可用”的常见场景低流量站点无 CrUX 数据时用 Lighthouse 实验室数据作代理指标。七、异常处理矩阵场景处理动作URL 不可达报告连接错误与状态码建议核对 URL、检查 DNS 解析、确认站点公网可访问robots.txt 未找到注明根域未检测到 robots.txt建议创建含适当指令的 robots.txt其余类别继续审计未配置 HTTPS标记为严重问题报告是否无重定向地以 HTTP 服务、是否存在混合内容、SSL 证书缺失/过期Core Web Vitals 数据不可用注明 CrUX 无数据低流量站点常见建议用 Lighthouse 实验室数据作为代理并建议提升流量后再测八、审计输出与持久化契约审计最终必须输出结构化报告包含每个类别的 pass/fail 状态技术评分0–100按优先级排列的问题清单Critical → High → Medium → Low带实现细节的具体建议。skill 侧给出了标准报告骨架Technical Score: XX/100、九行类目明细表Category / Status / Scorestatus 取值 pass/warn/fail、四档问题分组Critical 立即修复 / High 一周内 / Medium 一月内 / Low 纳入 backlog。在编排器audit orchestrator提供了output_dir时代理必须遵循持久化契约将可爬取性、可索引性、安全性、URL、移动端、渲染与 Agent-UX 发现写入output_dir/findings/technical.md同时产出兼容 JSON 的结构化发现并入audit-data.json的 Technical SEO 类别下。这套契约保证了同一站点在不同子代理technical/content/schema/geo/local/ecommerce/hreflang/images 等 8 个共用渲染管线的子代理审计后发现项可以统一归集、机器可读、可被后续流程消费。九、测试保障与使用前提seo-technical抓取管线的正确性有测试用例背书tests/test_render_page.pySPA 启发式的正反向样本、模式分发逻辑auto 对静态页保持 raw、never 即使遇 SPA 壳也不渲染、always 缺 Playwright 时给出清晰报错、SSRF 预检委托、非法参数防御性返回以及结果字典字段完整性契约。需要拉起 Chromium 的测试在无 Playwright 环境中会自动跳过标记为 skipped 而非 failed。使用前提与限制需要明确渲染模式依赖playwright与 Chromium 浏览器pip install -r requirements.txt playwright install chromiumtrafilatura 与 htmldate 为可选增强Google API 集成需要配置GOOGLE_API_KEYPSI/CrUX或 OAuth 凭据GSC并遵守各自配额PSI 240 QPM / 25000 QPDCrUX 150 QPMURL Inspection 600 QPM / 2000 QPD浏览器抓取存在 Chromium 内部解析器的残余 DNS 重绑定风险已由 route 层拦截兜底并记录于 SECURITY.md。结语seo-technical子代理是一套把“技术 SEO 审计”工业化的完整方案render_page.py解决 SPA 时代的抓取盲区url_safety.py守住 SSRF 底线九大审计类别对齐 Google 现行口径INP 取代 FID、移动优先索引 100% 完成、2025 年 12 月 JS SEO 澄清AI 爬虫管理与 Agent-Friendly Pages 前瞻覆盖了 2025–2026 的新战场而 DataForSEO/Google API 可选集成让 CWV 与索引状态从估算变为真实数据。以 agents/seo-technical.md 为起点配合 skills/seo-technical/SKILL.md 与 skills/seo/references/cwv-thresholds.md 等参考资料即可在 Claude Code 中开箱复现这一整套可运行、可验证、可沉淀为报告文件的技术 SEO 审计流水线。赞分享【免费下载链接】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点击查看免费下载相关推荐面向 AI 搜索的 GEO 技术 SEO 审计指南以 geo-seo-claude 的 geo-technical 智能体为实战框架面向 AI 搜索的 GEO 技术 SEO 审计指南以 geo seo claude 的 geo technical 智能体为实战框架 导读 本文基于 geoAI 技能AI 应用搜索引擎数据分析ag-kit 仓库 SEO 基础技能E-E-A-T、Core Web Vitals 与可执行的站点审计实践ag kit 仓库 SEO 基础技能E E A T、Core Web Vitals 与可执行的站点审计实践 本文以 .agents/skills/seo fu人工智能AI 技能AI 插件claude-seo 全站 SEO 审计实战指南并行子代理编排、健康评分与 PDF 报告生成claude seo 全站 SEO 审计实战指南并行子代理编排、健康评分与 PDF 报告生成 导读 本文基于 claude seo 仓库中的 seo audi上一篇告别等待text-generation-webui革命性模型热切换技术全解析下一篇终极指南如何专业验证Qwen大语言模型的输出质量与一致性创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
【免费下载链接】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 是面向 Claude Code 的通用 SEO 技能包其seo-technical子代理专职对给定 URL 执行技术 SEO 审计覆盖可爬取性、可索引性、安全性、URL 结构、移动端、Core Web Vitals、结构化数据、JavaScript 渲染与 IndexNow 协议九大维度。本文以 agents/seo-technical.md 为骨架结合其对应的 seo-technical skill、底层渲染与安全源码及测试用例完整讲解该代理的抓取工作流、审计清单、评分输出与可选 Google/DataForSEO 集成读完即可在 Claude Code 中复现一整套可落地、可验证的技术 SEO 审计流程。一、子代理定位与审计工作流seo-technical是一个通过 frontmatter 定义行为的 Claude Code 子代理定义见 agents/seo-technical.md模型sonnet最大交互轮次 20工具集Read、Bash、Write、Glob、GrepWrite 用于输出报告与数据文件职责给定一个或一组 URL 后依次完成页面抓取、robots.txt 与 sitemap 检查、meta/canonical/安全头分析、URL 结构与重定向链评估、移动端友好性评估、Core Web Vitals 潜在问题标记、JavaScript 渲染需求核查最终输出结构化审计报告。审计工作流的标准执行顺序为抓取页面并分析 HTML 源码检查 robots.txt 与 sitemap 可用性分析 meta 标签、canonical 标签与安全响应头评估 URL 结构及重定向链基于 HTML/CSS 分析评估移动端友好性从源码检查中标记潜在的 Core Web Vitals 问题核查 JavaScript 渲染需求。同一职责在 skill 侧还有一份人类可读的完整版清单 skills/seo-technical/SKILL.mdv2.2.0MIT 许可子代理与 skill 共用同一套 9 大类别框架两者可以互为参考。二、页面抓取管线v2.0.0render_page 三模式技术 SEO 审计的第一步是拿到页面真实可分析的内容。claude-seo 自 v2.0.0 起将无头渲染统一收口到python3 scripts/render_page.py替代此前各子代理各自用fetch_page.py抓原始 HTML 的做法——旧方式在 SPA 上会产生假阴性空div idroot、源码中无 schema、无正文内容。2.1 三种抓取模式模式行为适用场景auto先做原始抓取仅当检测到 SPA 壳时才启动 Playwright 渲染默认模式成本最低的正确行为always无论静态还是动态页面都用 Playwright 渲染需要拿到 JS 执行后的 DOM、accessibility tree 时never只取原始 HTML等价于旧版fetch_page.py纯静态页面快速检查典型调用方式与子代理文档中给出的命令一致# 默认 autoSPA 才渲染 python3 scripts/render_page.py URL --mode auto --json # 强制渲染 python3 scripts/render_page.py URL --mode always # 跳过 Playwright只拿原始 HTML python3 scripts/render_page.py URL --mode never # 写入完整 HTML 文件 python3 scripts/render_page.py URL --output page.html--json输出的是经过截断的摘要content、raw_content、extracted_text均有限长避免 Agent 经 stdio 传递数 MB HTML需要完整 HTML 时使用--output或在代码中直接导入render_page.render_page()。2.2 JSON 摘要字段与内容提取返回结果是一个字典即“结果形状契约”8 个子代理共享该 API测试见 tests/test_render_page.py字段含义url重定向后的最终 URLstatus_code主文档 HTTP 状态码contentJS 执行后的 HTMLpost-render DOMraw_contentJS 执行前的 HTML服务器响应is_spa原始 HTML 是否呈 hydration 壳特征extracted_texttrafilatura 去样板后的正文提取可能为 Nonepublication_datehtmldate 识别的 ISO 8601 发布日期可能为 Noneheaders主文档响应头redirect_chain{url, status_code}列表console_errors浏览器控制台错误字符串列表render_engineplaywright-chromium或 Nonerender_ms渲染阶段耗时毫秒mode_usedrendered或rawerror错误信息或 Noneextracted_text与publication_date分别由 trafilatura 与 htmldate 提供二者是可选依赖未安装时优雅降级为 None测试见 tests/test_render_page.py。2.3 SPA 检测启发式auto 模式的核心auto模式是否会触发 Playwright 取决于_is_spa()启发式函数scripts/render_page.py。它检查两类信号hydration 壳签名div idroot/div、div id__next、div idapp、div id__nuxt、data-svelte-h、astro-island、you need to enable javascript/please enable javascript等覆盖 ReactCRA/Vite/Remix、Next.js、Vue、Nuxt、Svelte、Astro islands 及 noscript 提示模式薄 body 兜底body内去标签后的可见文本少于 100 字符即判为 SPA。该阈值特意调校到不误伤example.com这类极简信息页约 125 字符避免在 auto 模式下做冗余渲染。参数化测试覆盖了上述全部正向与负向样本tests/test_render_page.py并验证了never模式即使检测到 SPA 壳也不会启动渲染tests/test_render_page.py。2.4 其他 CLI 选项render_page.py还支持--viewportdesktop/laptop/tablet/mobile预设见源码VIEWPORTS、--timeout-ms默认 15000、--block image|media|font|stylesheet按资源类型拦截以加速、--no-extract跳过 trafilatura/htmldate以及--a11y-tree捕获 Playwright accessibility tree 快照会强制进入渲染模式。渲染后还有 500ms 的延迟等待以允许延后 hydrationdeferred islands、useEffect 链并收集控制台错误供审计参考。三、安全第一url_safety 的 SSRF 与 DNS 重绑定防护子代理文档明确要求绝不直接对用户提供的 URL 调用requests.get所有网络入口必须先经 scripts/url_safety.py 校验。这是 claude-seo 的统一安全基座validate_url_strict(url)通过socket.getaddrinfo解析主机名校验每一个 A 记录均为公网 IP返回(normalized_url, pinned_ipv4)任何一个非公网 IP 都抛URLSafetyErrorsafe_requests_get()在 DNS 固定pinning上下文内执行requests.get期间socket.getaddrinfo被临时替换重定向目标等任何其他主机名解析也必须通过公网 IP 校验硬屏蔽主机名单涵盖localhost、metadata.google.internal、metadata.azure.com、metadata.ec2.internal、169.254.169.254、fd00:ec2::254等各云厂商 metadata 端点规范化处理 IPv4 混淆形式2130706433、0x7f000001、0177.0.0.1、前导零点分形式等防止以数字字面量绕过 IP 范围检查。对 Playwright 浏览器抓取Chromium 自行解析 DNS无法在 Python 层固定make_safe_playwright_route_handler()作为纵深防御在page.route(**/*, handler)中拦截每个子资源请求并重新校验目标 IP私有地址一律route.abort()。测试用例覆盖了127.0.0.1、10.0.0.7、169.254.169.254、混淆 IP 及 FQDN 形式 metadata 域名的拦截tests/test_render_page.py。四、九大审计类别详解4.1 可爬取性Crawlability检查点包括robots.txt 是否存在、语法是否有效、是否误拦截关键资源XML sitemap 是否存在、是否在 robots.txt 中声明、格式是否有效noindex 标签是有意还是误加重要页面距离首页的点击深度是否在 3 跳以内关键内容是否依赖 JS 执行对超过 1 万页的大型站点评估爬取预算效率。AI 爬虫管理2025–2026 重点AI 公司正在大规模爬取网页用于模型训练与 AI 搜索在 robots.txt 中管理这些爬虫已成为技术 SEO 的关键议题。已知 AI 爬虫及 token 见下表源自 skills/seo-technical/SKILL.md爬虫公司robots.txt token用途GPTBotOpenAIGPTBot模型训练ChatGPT-UserOpenAIChatGPT-User实时浏览ClaudeBotAnthropicClaudeBot模型训练PerplexityBotPerplexityPerplexityBot搜索索引 训练BytespiderByteDanceBytespider模型训练Google-ExtendedGoogleGoogle-ExtendedGemini 训练非搜索CCBotCommon CrawlCCBot开放数据集关键区分屏蔽Google-Extended只阻止 Gemini 训练用途不影响Google 搜索索引与 AI Overviews它们走Googlebot屏蔽GPTBot阻止 OpenAI 训练但不阻止ChatGPT 通过浏览引用你的内容走ChatGPT-User。约 3–5% 的网站已启用针对 AI 的 robots.txt 规则。选择性拦截示例允许搜索索引、拦截 AI 训练爬虫# Allow search indexing, block AI training crawlers User-agent: GPTBot Disallow: / User-agent: Google-Extended Disallow: / User-agent: Bytespider Disallow: / # Allow all other crawlers (including Googlebot for search) User-agent: * Allow: /建议在屏蔽前先想清楚 AI 可见性策略——被 AI 系统引用会带来品牌曝光与推荐流量。完整的 AI 可见性优化可交叉参考seo-geoskill。4.2 可索引性Indexability检查 canonical 标签是否自引用、与 noindex 是否冲突重复内容近似重复、参数 URL、www 与非 www 版本每类页面类型的瘦内容字数下限分页relnext/prev 或 load-more 模式多语言/多地区站点的 hreflang 正确性以及消耗爬取预算的索引膨胀index bloat。hreflang 的深入校验按跨技能委派约定交给seo-hreflang子技能处理见 agents/seo-technical.md 的 Cross-Skill Delegation 一节。4.3 安全性Security检查 HTTPS 是否强制、SSL 证书是否有效、有无混合内容以及以下安全头Content-Security-Policy (CSP)Strict-Transport-Security (HSTS)X-Frame-OptionsX-Content-Type-OptionsReferrer-Policy对高安全级别站点额外检查是否已加入 HSTS preload 列表。注意抓取阶段拿到的headers响应头字段正好是这部分审计的数据来源。4.4 URL 结构URL Structure干净 URL描述性、连字符分隔、内容页不携带查询参数层级符合站点架构逻辑的目录结构重定向无重定向链最多 1 跳永久移动用 301URL 长度超过 100 字符即标记尾斜杠全局保持一致。render_page返回的redirect_chain{url, status_code}列表可直接用于评估重定向跳数与跳转类型。4.5 移动端优化Mobile Optimization响应式设计viewport meta 标签、响应式 CSS触控目标最小 48×48px 且间距 8px字体大小基础字号最小 16px无横向滚动移动优先索引截至 2024 年 7 月 5 日Google 的移动优先索引已 100% 完成Google 现在完全使用移动版 Googlebot user-agent 爬取并索引所有网站。务必确保移动版本包含全部关键内容、结构化数据与 meta 标签。4.6 Core Web Vitals当前阈值2026 年口径与 skills/seo/references/cwv-thresholds.md 一致指标GoodNeeds ImprovementPoorLCPLargest Contentful Paint2.5s2.5–4s4sINPInteraction to Next Paint200ms200–500ms500msCLSCumulative Layout Shift0.10.1–0.250.25重要事实INP 已于 2024 年 3 月 12 日取代 FIDFID 于 2024 年 9 月 9 日从所有 Chrome 工具CrUX API、PageSpeed Insights、Lighthouse中完全移除。INP 是唯一的交互性指标任何输出中都不应再引用 FID。评估口径为真实用户数据的75 分位field data from CrUXGoogle 在页面级与来源origin级同时评估。Core Web Vitals 是平局决胜性质的排名信号当竞争对手内容质量相近时影响最大。阈值自定义以来未变过可忽略 SEO 博客中所谓“阈值收紧”的说法。LCP 子部分诊断2025 年 2 月 CrUX 新增子部分度量内容目标TTFB首字节时间服务器响应800msResource Load DelayTTFB 到资源请求开始尽量小Resource Load TimeLCP 资源下载耗时视资源大小Element Render Delay资源加载到渲染完成尽量小总 LCP TTFB Resource Load Delay Resource Load Time Element Render Delay。常用瓶颈定位与优化优先级LCP 对感知性能影响最大压缩 hero 图、WebP/AVIF、preload、消除阻塞渲染的 CSS/JS、TTFB200ms 时用边缘 CDN、字体用font-display: swapCLS 是最常见的用户体验问题图片/iframe 预留宽高、动态注入内容预留空间INP 对交互型应用最重要主线程长任务拆分为 50ms 片段、防抖事件、DOM 元素 1500 个需警惕、第三方脚本抢占主线程。性能工具层面注意Lighthouse 是实验室工具必须与 CrUX 现场数据交叉验证CrUX Vis 已于 2025 年 11 月取代旧版 CrUX Dashboard。4.7 结构化数据Structured Data检测 JSON-LD首选、Microdata、RDFa 三种格式并按 Google 支持的类型做校验。深度分析由seo-schemaskill 负责此处只做检测与初步验证。值得注意的 2025 年 12 月 Google 更新要点见下文 4.8通过 JS 注入的结构化数据可能被延迟处理电商 Product 等时效敏感型标记应放入初始服务端 HTML。4.8 JavaScript 渲染JavaScript Rendering检查内容在初始 HTML 中是否可见、是否依赖 JS识别 CSR客户端渲染与 SSR服务端渲染标记 React、Vue、Angular 等可能导致索引问题的 SPA 框架如适用则验证动态渲染dynamic rendering配置。Google 2025 年 12 月 JavaScript SEO 文档更新关键澄清Canonical 冲突若原始 HTML 中的 canonical 与 JS 注入的不同Google 可能采用两者中的任意一个。必须保证服务端 HTML 与 JS 渲染输出中的 canonical 完全一致noindex 与 JS若原始 HTML 含meta namerobots contentnoindex而 JS 将其移除Google仍可能遵循原始 HTML 的 noindex。请直接在初始 HTML 响应中下发正确的 robots 指令非 200 状态码Google不会在返回非 200 状态码的页面上执行 JavaScript。错误页上经 JS 注入的内容或 meta 标签对 Googlebot 不可见JS 中的结构化数据经 JS 注入的 Product、Article 等结构化数据可能被延迟处理时效敏感的结构化数据应包含在初始服务端 HTML 中。最佳实践把关键 SEO 元素canonical、meta robots、结构化数据、title、meta description放进初始服务端 HTML而不是依赖 JS 注入。4.9 IndexNow 协议检查站点是否支持 IndexNowBing、Yandex、Naver 消费同一开放端点Google 截至 2026 年不消费该协议因此它特指非 Google 引擎的索引信号。仓库提供了现成提交脚本 scripts/indexnow_submit.pypython3 scripts/indexnow_submit.py \ --host example.com \ --key abcd1234… \ --key-location https://example.com/abcd1234.txt \ --urls https://example.com/new-post https://example.com/updated-page # 或从文件按行读取 URL python3 scripts/indexnow_submit.py \ --host example.com --key abcd1234… --key-location https://… \ --urls-file changed.txt设置三步走生成 32 字符主机密钥 → 将密钥文件放到站点根目录https://example.com/key.txt文件内容即密钥本身IndexNow 会爬取一次以证明主机所有权→ 传密钥与密钥位置给脚本或设置INDEXNOW_KEY、INDEXNOW_KEY_LOCATION环境变量。脚本内置了与 IndexNow 规范一致的校验批次上限 10000 个 URL、密钥长度 8–128 字符、所有 URL 必须属于声明主机拒绝跨主机提交、每个 URL 经url_safety.validate_url_strict校验以防私有 IP 混入对应测试见 tests/test_technical_depth.py。verify_key_published()还提供密钥发布预检避免“密钥文件内容与密钥不匹配导致后续提交被静默拒绝”的常见配置错误。五、面向未来的 Agent-Friendly PagesAI Agent不只是 AI 摘要器正通过三条通道阅读网站视觉模型看截图、原始 HTML/DOM、以及可访问性树accessibility tree——三者中最干净的信号。审计标准真实button/a而非div onclick、label 关联、交互目标尺寸、模板间布局稳定性、cursor: pointer正确性详见 skills/seo-technical/references/agent-friendly-pages.md。仓库提供了自动化扫描命令# 用 Playwright 渲染并捕获 accessibility tree然后评分 python3 scripts/agent_ux_check.py https://example.com --jsonagent_ux_check.py强制以modealways调用render_page()并开启extract_accessibilityTruescripts/agent_ux_check.py其评分逻辑0–100包括每个div onclick扣 5 分上限 20、无语义 landmarks 扣 10、无label[for]的输入每个扣 4上限 20、无 accessible name 的交互节点每个扣 3上限 20、rolegeneric占比超 50% 扣 10。HTML 侧统计真实按钮/锚点/div onclick组件/语义 landmarks/无标签输入accessibility tree 侧统计总节点、交互节点、未命名交互元素与rolegeneric占比。需要说明的是Agent-UX 相关标准如 WebMCP尚处早期审计姿态是把发现作为“机会”而非“失败”不要用满分门槛卡审计结果。WebMCP类似 Claude/Anthropic 生态中的 MCP、但运行在页面层面的站点直连 Agent 标准提案目前只有早期预览广泛采用预计不早于 2027 年报告中作为前瞻信号提及即可不应把“没有 WebMCP 支持”作为发现项。六、可选集成DataForSEO 与 Google API6.1 DataForSEO若配置了 DataForSEO MCP 工具可用on_page_instant_pages做真实页面分析状态码、页面耗时、坏链、页面检查用on_page_lighthouse获取 Lighthouse 审计性能、无障碍、SEO 分数用domain_analytics_technologies_domain_technologies做技术栈检测。6.2 Google API配置 Google API 凭据后可将 CWV 从“实验室估算”升级为“真实现场数据”# PSI CrUX 现场数据替代纯实验室估算 python3 scripts/pagespeed_check.py url --json # 25 周 CWV 趋势 python3 scripts/crux_history.py url --json # 逐 URL 的真实索引状态 python3 scripts/gsc_inspect.py url --json三个脚本的实现要点scripts/pagespeed_check.py 组合 PageSpeed Insights v5Lighthouse 实验室分析与 CrUX API真实用户现场数据内置CWV_THRESHOLDSLCP good 2500ms / poor 4000ms、INP good 200ms / poor 500ms、CLS good 0.1 / poor 0.25rate_metric()将指标评为 good/needs-improvement/poor并抽取 opportunity含预计节省毫秒数、diagnostics、failed audits 与具体问题资源明细scripts/crux_history.py 通过 CrUX History API 拉取最多 25 周的时间序列detect_trends()以“最近 4 周均值 vs 最早 4 周均值”判断每项指标为 improving/stable/degrading变化幅度 5% 视为 stable——对 CWV 而言负变化即改善scripts/gsc_inspect.py 通过 Search Console URL Inspection API 返回索引裁决verdict、coverage state、robots.txt 状态、Google 与用户 canonical 是否匹配googleCanonical userCanonical、富结果检测注意配额为每站点 600 QPM / 2000 QPD批量模式默认 1 秒间隔。这些真实数据源恰好补足了错误处理表中“CrUX 数据不可用”的常见场景低流量站点无 CrUX 数据时用 Lighthouse 实验室数据作代理指标。七、异常处理矩阵场景处理动作URL 不可达报告连接错误与状态码建议核对 URL、检查 DNS 解析、确认站点公网可访问robots.txt 未找到注明根域未检测到 robots.txt建议创建含适当指令的 robots.txt其余类别继续审计未配置 HTTPS标记为严重问题报告是否无重定向地以 HTTP 服务、是否存在混合内容、SSL 证书缺失/过期Core Web Vitals 数据不可用注明 CrUX 无数据低流量站点常见建议用 Lighthouse 实验室数据作为代理并建议提升流量后再测八、审计输出与持久化契约审计最终必须输出结构化报告包含每个类别的 pass/fail 状态技术评分0–100按优先级排列的问题清单Critical → High → Medium → Low带实现细节的具体建议。skill 侧给出了标准报告骨架Technical Score: XX/100、九行类目明细表Category / Status / Scorestatus 取值 pass/warn/fail、四档问题分组Critical 立即修复 / High 一周内 / Medium 一月内 / Low 纳入 backlog。在编排器audit orchestrator提供了output_dir时代理必须遵循持久化契约将可爬取性、可索引性、安全性、URL、移动端、渲染与 Agent-UX 发现写入output_dir/findings/technical.md同时产出兼容 JSON 的结构化发现并入audit-data.json的 Technical SEO 类别下。这套契约保证了同一站点在不同子代理technical/content/schema/geo/local/ecommerce/hreflang/images 等 8 个共用渲染管线的子代理审计后发现项可以统一归集、机器可读、可被后续流程消费。九、测试保障与使用前提seo-technical抓取管线的正确性有测试用例背书tests/test_render_page.pySPA 启发式的正反向样本、模式分发逻辑auto 对静态页保持 raw、never 即使遇 SPA 壳也不渲染、always 缺 Playwright 时给出清晰报错、SSRF 预检委托、非法参数防御性返回以及结果字典字段完整性契约。需要拉起 Chromium 的测试在无 Playwright 环境中会自动跳过标记为 skipped 而非 failed。使用前提与限制需要明确渲染模式依赖playwright与 Chromium 浏览器pip install -r requirements.txt playwright install chromiumtrafilatura 与 htmldate 为可选增强Google API 集成需要配置GOOGLE_API_KEYPSI/CrUX或 OAuth 凭据GSC并遵守各自配额PSI 240 QPM / 25000 QPDCrUX 150 QPMURL Inspection 600 QPM / 2000 QPD浏览器抓取存在 Chromium 内部解析器的残余 DNS 重绑定风险已由 route 层拦截兜底并记录于 SECURITY.md。结语seo-technical子代理是一套把“技术 SEO 审计”工业化的完整方案render_page.py解决 SPA 时代的抓取盲区url_safety.py守住 SSRF 底线九大审计类别对齐 Google 现行口径INP 取代 FID、移动优先索引 100% 完成、2025 年 12 月 JS SEO 澄清AI 爬虫管理与 Agent-Friendly Pages 前瞻覆盖了 2025–2026 的新战场而 DataForSEO/Google API 可选集成让 CWV 与索引状态从估算变为真实数据。以 agents/seo-technical.md 为起点配合 skills/seo-technical/SKILL.md 与 skills/seo/references/cwv-thresholds.md 等参考资料即可在 Claude Code 中开箱复现这一整套可运行、可验证、可沉淀为报告文件的技术 SEO 审计流水线。赞分享【免费下载链接】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点击查看免费下载相关推荐面向 AI 搜索的 GEO 技术 SEO 审计指南以 geo-seo-claude 的 geo-technical 智能体为实战框架面向 AI 搜索的 GEO 技术 SEO 审计指南以 geo seo claude 的 geo technical 智能体为实战框架 导读 本文基于 geoAI 技能AI 应用搜索引擎数据分析ag-kit 仓库 SEO 基础技能E-E-A-T、Core Web Vitals 与可执行的站点审计实践ag kit 仓库 SEO 基础技能E E A T、Core Web Vitals 与可执行的站点审计实践 本文以 .agents/skills/seo fu人工智能AI 技能AI 插件claude-seo 全站 SEO 审计实战指南并行子代理编排、健康评分与 PDF 报告生成claude seo 全站 SEO 审计实战指南并行子代理编排、健康评分与 PDF 报告生成 导读 本文基于 claude seo 仓库中的 seo audi上一篇告别等待text-generation-webui革命性模型热切换技术全解析下一篇终极指南如何专业验证Qwen大语言模型的输出质量与一致性创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
