v2.6.2: Shopify and PostHog extensions, local proxy opt-in, 36 community pull requests2026-11-15
社区版合并 36 个 PR,带来两个新扩展,以及 v2.6.1 承诺的本地代理开关。
用脚本调用的用户需注意几处行为变化:IndexNow 只提交与声明主机完全匹配的域名,子域名不再上报;preloadcheck.py 和 parasiterisk.py 抓不到页面时退出码改为 1,不再给错误页打分;seoupdates.py --limit 0 现在表示不限量,此前返回空列表;带路径参数(;name=value)的 URL 需重新采集漂移基线;审计报告改名为 SEO-Audit-Report-。
新增 CLAUDESEOTRUSTED_PROXIES,填入回环或内网代理的 host:port,Claude Code 云端会话及 cntlm、px 之后的抓取、截图与 Unlighthouse 就能正常工作;目标地址仍会先校验,链路本地和元数据地址依旧拒绝,不设该变量则行为不变。/seo shopify 爬取你管理的店铺,用 Crawler Access 签名送审;/seo posthog 从 PostHog MCP 取
v2.6.1: security fixes2026-11-14
安全更新:八位研究者提交十份报告,六个问题全部修复,未新增命令。更新后三处行为有变:Chromium 在系统允许时启用沙箱(Ubuntu 23.10+、CI、Docker 中页面照常渲染,只是给出警告并标记 sandbox: false);Google 登录默认只授予 Search Console 与 Analytics 只读权限,要发 Indexing 得改用 googleauth.py --auth --indexing;截图与渲染不再走本地或内网地址的代理,SOCKS 与 https:// 代理一律拒绝。修复内容包括:浏览器每次跳转都经本地守卫校验目标,堵住被重定向到回环、内网和云元数据地址的口子;报告数值全部转义,PDF 只加载本次报告的图表;Windows 上拒绝报告中标注的网络共享路径;Excel 按文本存值,以 =、+、-、@ 开头的查询不会被当公式执行;parsehtml.py --url 加了体积与时间上限,youtubesearch.py 报错不再泄露 API key,verifyrelease.py 拒绝越出仓库的 manifest 条目,并对空 manifest 直接报错。
v2.6.0: deterministic page, TLS, sitemap and JavaScript-gap checks2026-11-10
v 更新:确定性检查脚本落地,新增 2 个脚本,总数达 63 个
原先需要模型手动完成的检查——统计 sitemap URL、比对服务端与渲染后 HTML、读取证书、检查页面基础项——现在全部由带测试的脚本承担,逻辑移植自姊妹项目 web-obs。更新后请先运行一次 /seo setup,会安装新依赖 PySocks。
主要新增:pagechecks.py 一次性跑完 47 项页面内检查(标题、描述、H 标签、canonical、JSON-LD、瘦内容等),每条结果带稳定 ID、严重级别与证据;transportcheck.py 负责 TLS 证书、安全头与重定向;sitemapdiscovery.py --expand 可展开 sitemap 索引,统计 URL 数量、lastmod 质量与重复项;renderpage.py 新增 jsgap,对比服务端与渲染后的差异并说明原因;parsehtml.py 现在能读取懒加载图片真实地址、标题层级与隐藏文本;fetch_page.py 上报 TTFB 等耗时指标;此外还支持 IPv6-only 主机审计、整页截图滚动加载等。
注意:JSON-LD 标签此前大写或带 charset 参数会被跳过,现在能正常解析,基线会出现一次 schema 变更,需重新生成基线。Robots 规则改为按产品令牌整词匹配(如 GPTBot/1.1),与 Google 文档一致。
v2.5.1: 45 community fixes, urllib3 security floor2026-11-10
claude-seo 39.0.0 是一次以社区修复为主的版本,合并了来自 18 位贡献者的 39 个 PR、6 项依赖升级,未新增命令。更新后请先运行一次 /seo setup,因为依赖下限已调整,托管运行时需要重建。
安全方面,urllib3 下限提升至 2.8.0,修复三个安全通告;CLAUDESEOLOCALTARGETS 中的 host:port 条目现在对整个请求生效,DNS 固定只在已验证的端口上应答,堵住了从允许的开发服务器重定向到同主机其他服务的漏洞。Google 属性选择与被审计域名绑定,gscquery.py、gscinspect.py、ga4report.py 新增 --domain 参数,拒绝使用其他站点的属性;IndexNow 密钥校验改为比较主机名,example.com 不再匹配 notexample.com。
修复集中在 Schema 与解析:schema 钩子不再因列表形式的 @type 崩溃,合法的 @graph 文档不再被误报缺少 @context,产品校验接受 priceSpecification 对象列表;标题与链接文本保留内联标签两侧空格,<br> 视为空格,链接和图片按 <base href> 解析,单个畸形 URL 不再中断整体解析。
注意:三处解析修复会改变存量基线值——含 JSON-LD @graph 的页面会多出一条 schema_modified 警告,含内联标签或 <br> 的标题会记为一次变更,升级后请重新建立基线。
v2.5.0: Python 3.11+, security and accuracy fixes, Claude Desktop installs2026-10-22
本次更新来自一次全面安全与准确性审计,同时修复了 Claude Desktop 无法加载 claude-seo 的问题(#344)——seo-cockpit 改为从独立分支安装,Claude Desktop 便能正常读取插件。
运行环境要求提高到 Python 3.11–3.14:3.10 已于 2026-10-01 停止维护,Pillow 13.0.0 的 28 条安全公告也只覆盖 3.11 以上;3.15 暂不支持,因 Google Ads 客户端库声明 < 3.15。启动器与 install.ps1 现在会自动挑选可用版本,也可用 CLAUDESEOPYTHON 指定,/seo setup 会据此重建运行时。
seo-technical 新增服务端栈 CVE 暴露检测(Security 类):只读探测,从正常响应头识别已知高危 CVE,内置 PHP 关键 RCE 公告(CVE-2026-109618 / CVE-2026-109619,CVSS 9.2)及缓解方案,不发送任何攻击载荷,且会先确认站点归属。
数据层面按一手来源修正多处:2026 年 9 月垃圾内容更新标记为已完成;seo-page、seo-content 等移除关键词密度指标,alt 文本改为「描述性、点明主体」;Gemini 图像模型引用日期误读问题已纠正;Indexing API 配额链接指向正确页面;补充面包屑与事件富媒体结果限制。技能触发条件、外链代理运行时机、扩展版 agent 参数也一并对齐。Python 版本范围统一收敛到 scripts/runtime.py 的 MINPYTHON 与 MAXPYTHON,并有测试保证启动器、CI 与文档同步。
v2.4.2: seo-cockpit and Google sign-in2026-10-04
seo-cockpit 0.3.3 作为可选配套插件上架(需 Claude Code 2.1.287+):/seo-cockpit 一条命令聚合单站点的审计、体检、搜索、排名、地图与花费概览,终端出文本图表、桌面端出 SVG,画不出来的面板(如 VS Code 聊天面板)可导出 HTML 仪表盘;另有零 token 的 /seo-spend、/seo-doctor。核心是花费守门——DataForSEO、Ahrefs、Firecrawl 等付费调用执行前先对预算,超限即拒,只记录真正计费成功的调用;省钱模式可让五个 Opus 代理改跑 Sonnet。
Google API 新增本人 gcloud 登录兜底(gcloud auth application-default login),解决服务账号常无权访问自有资源的问题;预算检查结果补上 credentialsinenv,不再把「预算批准」误读为「凭证就绪」。
修了 schema 钩子:诊断原本打到 stdout,Claude 根本看不到,现改为关键错误退出码 2 走 stderr 反馈,警告走 hookSpecificOutput.additionalContext。seo-maps 的地理网格扫描也会存档 JSON,方便跨期对比。
v2.4.1: Google-currency patch (September 2026 spam update)2026-09-29
Claude SEO v2.4.1 是一次补丁更新,把 Google 官方指引同步到 2026-09-28,涵盖 9 月垃圾内容更新(2026-09-24 启动,发布时尚在推进中,Google 未指明针对对象)。所有变动事实均回查一手来源;无法在 Google 自有页面证实的说法(如 SAFE 检测器、"链接垃圾被排除")一律记入未核实清单,审计报告不再当作事实陈述。
新增 9 月与 2025 年 8 月两次垃圾更新、VideoObject creator 等词条,以及 Lighthouse 版本上报;修正 AI 优化指南日期、URL Inspection 的 mobileUsabilityResult 已废弃、Gemini 图像模型退役时间等若干处事实,并给第三方结论(更新表影响描述、Studley Sky 案例、AI Overview 覆盖率等)补上来源标注。/seo 编排器现直接调用内置更新台账,不再依赖磁盘上的旧副本。测试新增破折号与文件行数检查。Python 3.10 十月起 EOL,文档改推 3.11+。
v2.4.0: agent readiness and audit fixes2026-09-23
Claude SEO v2.4.0 带来面向 AI 代理的全新 /seo agentic 命令。它按 Lighthouse 自己的算法复算 Agentic Browsing 分数(逻辑照搬 13.5.0 源码),并补齐其余代理就绪度检查:给代理用的无障碍树、robots.txt 分组与 Content-Signal 按 AI 爬虫逐一核对、llms.txt、Markdown 投递、ai-catalog.json、/.well-known 各类发现文件以及 WebMCP 标记。配套的修复命令会在不动 Allow/Disallow 的前提下起草 Content-Signal 等配置,所有请求统一经过 url_safety。
另新增可选的 Matomo 扩展,用 /seo matomo 系列命令作为 GA4 的替代或补充,凭据存于 ~/.config/claude-seo/matomo.json 并支持环境变量覆盖。
安全方面值得警惕:各扩展的安装脚本此前把 API 密钥、令牌直接作为命令行参数传给 Python,本地任何用户都能用 ps 看到;现已改走环境变量,PowerShell 版事后还会清空变量。同时修复了安装器可能误清空 ~/.claude.json 的问题,解决 #312、#314、#317。本版经过两轮独立审计、一次验证和随机输入模糊测试,测试套件在每个提交上全部通过。
Claude SEO v2.3.1: Agents on Opus and Community Follow-ups2026-09-10
Claude SEO v2.3.1 是补丁版:五个判断类智能体(seo-content、seo-geo、seo-sxo、seo-cluster、seo-drift)改跑 Opus,其余十三个仍是 Sonnet,README 补了成本说明与按智能体覆盖的办法;Keywords Everywhere 作为免费外链备选接入,未配置 Moz 时用它给出 0-10 的域名评级,但真实接口尚未验证。
修复部分:v2.3.0 新增的 metadata_template.py 漏注册启动器白名单,导致 /seo page、/seo programmatic 调用被拒,现已注册并补上覆盖全部脚本的测试;dataforseo、ahrefs、firecrawl 三个 PowerShell 安装器把 mcpServers 建成哈希表,JSON 序列化成 {} 使服务器配置静默丢失,且 Windows PowerShell 5.1 写出的 BOM 会被 Node 拒收,两者都改为对象写入、无 BOM 原子落盘。安装失败时不再只报一句 exit code 1,会输出子进程末尾日志,pip 拆为独立阶段,home 目录脱敏覆盖更多回溯写法。
Claude SEO v2.3.0: Google Currency and Community Fixes2026-09-10
Claude SEO v2.3.0 是一版安全加固与 Google 资讯更新。SSRF 防护新增 CLAUDESEOLOCALTARGETS 白名单,可在不开启「允许全部私有地址」的情况下审计本地开发服务器或 Tailscale 主机;代理地址此前直接信任环境变量,可被用来读取云元数据,现在会过主机黑名单与 issafeip 校验(#280、#295)。14 个抓取或渲染外部内容的 agent 统一补上「内容只当不可信数据、不当指令」的提示,修复 #291。contenthumanize.py 会在去 AI 味前清除零宽字符等隐形水印;新增 scripts/metadatatemplate.py,用确定性比对揪出照抄标题再套模板 CTA 的 meta 描述,并输出站点级风险指标。fetchpage.py --json 补齐响应元数据与截断选项。Google Search 指南更新至 2026-09-10,覆盖 EEA 站点声誉滥用执法、AI Mode 旅游预订等;默认请求头改为浏览器样式,避免被 WAF 判 403。另合并 13 个社区 PR。