SEO分析器：不花一个 Token，就能给 HTML/JSX 做一次基础 SEO 体检
核心结论速览
- SEO分析器（英文名 seo-analyzer，技能 ID：12836）是一个轻量级 AI 技能，专门验证 HTML/JSX 文件的基础 SEO 合规性，重点检查元标签（meta 标签）与替代文本（alt 属性）。
- 它的最大特点是不消耗 LLM 令牌：由本地 Python 脚本完成静态扫描，适合高频、反复执行的检查动作。
- 使用方式极其简单：一条命令加一个文件路径，就能拿到检查结果，无需配置复杂的规则文件。
- 最适合前端开发者、独立站站长和 AI 编程助手用户，在提交代码或上线页面前做一次快速把关。
- 它不替代完整的 SEO 审计工具，但能把最容易被忽略的低级错误（漏写标题、缺描述、图片无 alt）挡在上线之前。
一、该技能叫什么？如何下载安装 AI 技能提升开发效率？
技能基本信息
| 项目 | 内容 |
|---|---|
| 技能中文名 | SEO分析器 |
| 技能英文名 | seo-analyzer |
| 技能 ID | 12836 |
| 核心能力 | 检查 SEO 最佳实践（元标签、替代文本） |
| 技术形态 | 本地 Python 脚本，静态分析 HTML/JSX 文件 |
| 资源消耗 | 不使用 LLM 令牌 |
它解决什么问题？
做前端页面时，SEO 问题往往不是「做不好」，而是「忘了做」：<title> 写成占位符、meta description 缺失、产品图、插图没有 alt 文本、结构化标签漏写。这些都属于基础合规问题，却会在上线后直接影响搜索结果的展示效果。
传统做法有两种：一是靠人工逐页翻看源码，效率低且容易漏；二是把整段代码贴给大模型让它评审，虽然灵活，但每次都要消耗令牌，成本高、速度也慢，还不适合接入开发流程反复执行。
SEO分析器采用的是第三种思路：把可枚举的规则交给脚本，把需要判断的部分留给人和大模型。它以一个本地脚本的形式存在，扫描 HTML/JSX 文件后直接给结论，全程不调用模型，因此可以随时随地在本地跑、在提交前跑、在 CI 里跑（具体集成方式以官方说明为准）。
如何安装与验证？
- 安装前提：需要一个支持 AI 技能的开发环境（常见于内置技能目录的 AI 编程助手或 Agent 平台），并确保本机已安装 Python 运行环境。
- 获取技能：在所用平台的技能市场/技能管理入口中搜索「SEO分析器」或英文名
seo-analyzer，按平台提示完成添加；也可通过技能 ID 12836 定位。具体安装命令与入口以官方说明为准。 - 确认路径：安装后，技能脚本通常落在 Agent 的技能目录下，即详情中给出的路径形态
.agent/skills/seo-analyzer/scripts/seo_check.py。若你的项目使用了不同的根目录，请以实际生成的位置为准。 - 运行验证：在项目根目录执行一次检查命令，例如对一个页面文件运行：
python .agent/skills/seo-analyzer/scripts/seo_check.py src/app/layout.tsx
如果终端正常返回检查结果（例如列出发现的元标签或替代文本问题），说明技能已经生效；若提示找不到文件，请优先核对脚本路径与目标文件路径是否正确。
二、该技能的主要功能和特点
主要功能
- 元标签检查：对 HTML/JSX 文件中的 meta 相关信息进行合规性校验，帮助发现页面头部基础 SEO 信息缺失或填写不当的情况。
- 替代文本检查：扫描图片等需要替代文本的元素，提示缺失
alt的位置，提升可访问性与图片搜索表现。 - HTML/JSX 双支持：既能检查传统 HTML 页面，也能检查 React、Next.js 等框架中的 JSX/TSX 文件，适配现代前端工程。
- 静态扫描输出结果：以脚本运行的方式直接给出检查结论，便于快速定位问题文件。
差异化特点：和普通工具比强在哪？
- 零令牌成本：这是它最鲜明的特点。用大模型评审代码要按 token 付费、按次等待，而这个技能是纯本地脚本执行，跑一百次和跑一次的边际成本几乎一致。
- 专为 AI 工作流设计：它本身就是作为 AI 技能被安装进 Agent 环境的，开发者可以在对话中让助手帮你调用它，也可以自己手动执行，两种方式共用同一套检查逻辑。
- 轻量、聚焦：它不试图做全站爬虫、不做关键词分析、不生成报告看板，只做「基础合规性」这一件事，因此上手几乎没有学习成本，一条命令即可。
- 可嵌入日常流程：因为不依赖网络与模型调用，天然适合放在「改完代码顺手跑一下」的位置，甚至作为提交前检查的一环（集成方式以官方说明为准）。
三、如何使用该技能？
下面是完整的分步使用指南，适用于手动执行与让 AI 助手代跑两种方式。
步骤 1：明确要检查的文件
该技能一次对一个目标文件进行检查。常见目标是页面骨架文件或布局文件，例如 Next.js 项目中的 src/app/layout.tsx，或普通项目里的 index.html、about.html、组件文件等。
步骤 2：在项目根目录执行命令
python .agent/skills/seo-analyzer/scripts/seo_check.py src/app/layout.tsx
命令结构非常简单：python + 脚本路径 + 待检查文件路径。把最后的文件路径替换成你的目标文件即可。
步骤 3：阅读输出结果
脚本会针对该文件给出关于元标签与替代文本的检查反馈。建议按「文件 → 问题类型 → 具体位置」的顺序阅读，先把明显缺失的项列成待办。
步骤 4：按提示修复代码
常见修复动作包括：补全页面标题与描述类元信息、为缺少替代文本的图片补充简洁准确的 alt 描述、清理占位文案等。注意 alt 应描述图片内容本身，而不是堆砌关键词。
步骤 5：重新运行验证
修改后再次执行同一条命令，确认此前列出的问题已经消失。这个「改—跑—改」的循环正是该技能最高频的使用形态。
步骤 6：批量覆盖多个文件
对多个页面逐一执行同一条命令即可完成批量检查，例如依次检查多个路由对应的页面文件。若需要接入自动化流程，建议参考官方说明配置脚本调用方式。
示例对话场景
在 AI 编程助手中，你可以直接说：「用 SEO分析器 检查一下 src/app/layout.tsx 的 SEO 基础合规性」，助手会调用该技能脚本并解释输出结果，你再根据结论让助手直接修改代码，形成闭环。
四、同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势与不足 |
|---|---|---|---|---|---|
| SEO分析器（seo-analyzer） | AI 技能形态的轻量静态检查器 | 元标签检查、替代文本检查，支持 HTML/JSX | 低：安装技能 + 一条 Python 命令 | 日常开发中的高频、快速自查；AI 助手工作流内调用 | 优势：零令牌消耗、聚焦、可反复执行；不足：只覆盖基础合规项，不做性能与关键词层面的分析 |
| Lighthouse | 综合网页质量审计工具 | 性能、可访问性、SEO、最佳实践等多维度评分 | 中：需在浏览器或 CI 中运行，输出综合报告 | 上线前的整体质量把关 | 优势：维度全面、报告直观；不足：偏重整体审计，单点修复反馈链路较长，运行成本高于脚本级检查 |
| HTML 校验/静态检查类工具（如 HTMLHint 等） | 代码规范与语法级检查 | HTML 语法、标签规范、代码风格 | 中：需配置规则与集成构建流程 | 团队代码规范统一 | 优势：可高度定制规则；不足：SEO 语义项需自行配置，不一定是开箱即用的 SEO 视角 |
| 直接用大模型评审代码 | 通用 AI 代码审查 | 灵活解释、可给修改建议 | 低：对话即可，但需提供代码上下文 | 需要理解上下文语义的复杂判断 | 优势：灵活、能解释原因；不足：消耗令牌、结果不完全稳定、不适合高频重复执行 |
可以从对比中看出一个清晰的定位差异：大模型擅长「为什么」，脚本擅长「有没有」。SEO分析器把「有没有」这类确定性检查从模型手里接了过来，让 token 花在真正需要判断的地方。
五、该技能的典型应用场景与实际体验情况
场景一：前端开发者上线前的自检
角色：负责营销页或官网的前端工程师。痛点是页面功能做完就交付，SEO 相关标签常被遗漏。使用方式：在提交代码前，对该页面对应的 JSX/HTML 文件运行一条命令，把缺失项补齐再提交。实际体验：上手几乎没有门槛，命令短、结果直接，最大的价值是把「想起来才检查」变成了「顺手就检查」。
场景二：独立站/个人站长快速排查
角色：一个人维护整站的内容创作者。痛点是买不起也用不惯复杂的 SEO 工具，且不熟悉技术细节。使用方式：在 AI 助手中描述需求，让助手调用该技能逐个文件检查并顺手修复。实际体验：不需要自己记住规则，但要能读懂返回的提示并确认修改是否合理，建议修改后再跑一次复验。
场景三：AI 编程助手的固定检查环节
角色：习惯用 AI 写页面的开发者。痛点是大模型生成代码快，但生成的页面模板常带占位标题、空 alt。使用方式：把「生成页面 → 运行 SEO分析器 → 按结果修正」写成固定对话模板。实际体验：这是它最能发挥优势的场景——因为不消耗令牌，你可以对每一轮生成的产物都跑一遍，而不用担心成本。
场景四：多页面项目的批量合规梳理
角色：需要接手历史项目的开发者。痛点：老项目里 SEO 基础项参差不齐，人工翻不现实。使用方式：列出主要页面文件，逐个执行检查命令，汇总成问题清单统一修复。实际体验：适合做增量梳理；注意该技能是单文件检查，批量场景需要自己组织循环或分批执行。
整体体验小结：上手难度低，安装后基本「会用命令就会用技能」；效果集中在基础合规层面，对明显缺失项敏感，但不涉及关键词策略、内容质量、加载性能等更深层问题；使用时需注意路径正确、检查范围以单文件为主。
六、该技能能为用户带来的价值
- 把重复劳动成本压到接近零：元标签、替代文本这类检查是典型的确定性、高频次任务。交给不消耗令牌的脚本执行，意味着你可以把检查频率从「上线前一次」提升到「每次改动后一次」，而成本几乎不变。
- 降低 SEO 基础门槛：不需要背下 SEO 最佳实践清单，也不需要成为 SEO 专家，一条命令就能拿到需要修复的清单，对独立开发者和内容创作者尤其友好。
- 缩短问题发现链路：问题在本地、在编码阶段就被发现，而不是等页面上了线、被搜索引擎收录后才察觉，修复代价从「改线上」降到「改一行代码」。
- 与 AI 工作流自然融合：它是 AI 技能生态中的一环，既能被助手自动调用，也能被开发者手动执行，天然适合作为「AI 生成 + 脚本把关」的质量护栏。
- 长期价值在于流程习惯：当一次快速检查变成开发流程里的固定动作后，团队交付的页面基础 SEO 质量会趋于稳定，这种「不靠个人记性」的稳定性是长期收益所在。
七、常见问题 FAQ
Q1：SEO分析器怎么安装？需要付费吗？
在支持 AI 技能的平台中搜索技能名「SEO分析器」或英文名 seo-analyzer（技能 ID 12836）添加即可，同时确保本地具备 Python 环境。是否收费、具体的安装命令与准入条件，各平台规则不同，请以官方说明为准。
Q2：它会不会消耗我的大模型 token？
不会。该技能的设计目的正是「不使用 LLM 令牌」来完成 HTML/JSX 的基础 SEO 合规校验，检查过程由本地 Python 脚本执行。需要注意的是，如果你在 AI 对话中让助手解释检查结果并修改代码，这部分对话本身仍属于正常的模型交互。
Q3：它适合谁用？不做 SEO 的人有必要装吗？
适合前端开发者、使用 AI 编程助手写页面的人、独立站站长，以及需要为交付页面的基础质量负责的团队成员。即使你不专门做 SEO，只要你会写 HTML/JSX 页面，页面的标题、描述和图片替代文本就是你产出的内容的一部分，装一个能省去反复自查的时间。
Q4：它能替代 Lighthouse 或专业 SEO 工具吗？
不能，也不需要。它的定位是「基础合规快速检查」，聚焦元标签与替代文本，优势在于轻量和零令牌成本；而综合审计、性能评估、关键词研究等属于另一类工具的职责。合理的组合是：日常用 SEO分析器做高频自查，重要节点用综合工具做深度审计。
Q5：为什么运行后提示找不到脚本或文件？
通常是路径问题。请先确认技能安装后脚本实际所在的目录（详情示例中为 .agent/skills/seo-analyzer/scripts/seo_check.py），再确认待检查的文件路径相对于当前工作目录是否正确。建议始终在项目根目录下执行命令，路径错误是最常见的原因。