Communitygithub.com

arunacharya1603/seo-工程

审计、规划、实施、测试并维护适用于跨框架和行业的网站及 Web 应用的可持续 SEO。涵盖技术 SEO、索引与爬取、关键词与内容策略、元数据、结构化数据、性能、内链、本地 SEO、电商、国际化 SEO、迁移、分析及 AI 搜索可见性。始终先审计,验证最新指南,保护生产环境,绝不承诺排名。

seo-工程 是什么?

这是一项专为开发者与 AI 代理设计的综合搜索引擎优化(SEO)技能,适用于 Claude Code、Cursor 或 Codex 等平台。其核心任务是通过确保网页对搜索引擎可发现、可理解、有资格被收录、对用户可信、技术上可靠并与业务成果关联,来帮助项目获得相关、可持续的有机流量。该技能要求进行严格的审计优先原则:在实施任何更改前,必须检查仓库和已部署的网站,保留现有正确的配置和 SEO 权益。它强调以用户为中心、基于证据的优化,而非无意义的关键词堆砌或清单完成。工作流程系统性地覆盖了从发现项目目标、建立基线、爬取网站到对问题进行优先级排序的七大步骤。该技能在处理技术问题(如可爬取性、索引、规范链接、重定向、JavaScript 渲染和站点地图)时,始终遵循不可协商的原则,例如绝不捏造证据、绝不承诺排名、绝不推荐垃圾技术(如隐藏文本或链接方案)。此外,它明确分离可爬取性、索引能力、排名、搜索结果呈现和转化这些不同问题,确保修改最小化、可逆,并尊重现有代码架构。最终,该技能生成一份详细的诊断报告和分级修复计划(从 P0 关键到 P3 低优先级/机会),并强调报告不确定性,当外部访问或凭证不可用时,提供安全的手动检查建议。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add arunacharya1603/seo-engineering

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

SEO 工程技能

使命

帮助项目通过使有用的页面可发现、可理解、符合搜索条件、对用户可信、技术上可靠并与业务成果相关联,来赢得相关、可持续的有机流量和优质访问。

此技能与项目无关。请根据实际的业务、受众、市场、CMS/框架、托管环境、搜索引擎和用户请求进行调整。不要在检查前假设项目是 Next.js、博客、电商、本地企业或特定领域。

没有哪项技术能保证被索引、获得富媒体搜索结果、AI 引用、流量、潜在客户或排名位置。 搜索引擎自行决定是否以及如何爬取、索引和排名页面。要精确区分哪些是经过测试的,哪些是推断的。

不可协商的运营原则

  1. 先审计,后编辑。 检查仓库,并在允许的情况下检查已部署的网站。识别哪些功能已经生效。保留正确的配置和已有的 SEO 资产。
  2. 以人为本,证据驱动。 优化应基于访问者的任务和业务相关性,而不是关键词密度、任意的内容量或清单完成度。
  3. 以最新文档为准。 对于受搜索功能、Schema 资格、垃圾政策、API、爬虫或工具变更影响的主张,请查询官方、最新的搜索引擎文档。优先参考 Google Search Central、Bing Webmaster 文档以及官方框架/平台文档。社区文章可能提供假设,但不能覆盖官方指南。
  4. 最小化、可逆的变更。 只做解决已验证问题所需的最小实现。未经明确授权,不要重构无关代码、更改域名/DNS/名称服务器、轮换凭证、删除验证令牌、更改托管或将更改部署到生产环境。
  5. 绝不捏造证据。 不要编造关键词量、排名难度、外链、流量、竞争对手、索引状态、性能指标、作者资质、评论、结构化数据事实或成功的测试结果。
  6. 不承诺排名,不推荐垃圾技术。 不要推荐伪装、隐藏关键词文本、关键词堆砌、跳转页面、大规模低价值内容、链接方案、虚假评论、误导性 Schema 或主要目的是操纵排名的自动化内容。
  7. 分离关注点。 可爬取性、索引能力、排名、搜索结果呈现和转化是不同的。修改相关层面,而不是声称一项技术变更可以解决所有问题。
  8. 保护敏感数据安全。 不要在报告、提交、日志或生成的示例中暴露秘密、API 密钥、客户信息、分析标识符或私人页面。
  9. 尊重现有架构。 在选择实施方式之前,了解技术栈、命名约定、路由模型和部署流程。优先采用既有的项目模式,而不是引入新的依赖项。
  10. 清晰报告不确定性。 如果外部访问、凭证、网络访问或生产测试不可用,请说明哪些内容尚未验证,并提供安全的手动检查建议。

工作流程概览

对于重大的 SEO 任务,请遵循以下顺序:

  1. 了解网站和业务。
  2. 建立基线并检查实现。
  3. 根据需要研究最新的搜索引擎要求。
  4. 生成优先排序的诊断和方案。
  5. 仅实施经授权的必要更改。
  6. 运行相关测试并检查实际的渲染/部署行为。
  7. 报告更改内容、证据、剩余风险和监控步骤。

对于重点请求(例如,改进一个标题标签),仅使用此工作流程的相关部分,但仍需检查副作用并避免做出未经证实的声明。

1. 发现项目及其目标

在建议代码前,先检查仓库和部署线索。确定以下适用项:

  • 业务/网站目的、受众、提供的服务、盈利模式、主要转化以及地理/语言目标。
  • 网站类型:信息型、内容发布者、SaaS、市场平台、电商、本地企业、作品集、文档、论坛、发布者或混合型。
  • 框架/CMS 及版本、路由器、渲染策略、内容来源、包管理器、构建/lint/测试命令以及现有 SEO 库。
  • 托管/CDN/边缘计算设置、域名变体、重定向、环境配置以及预发布与生产环境。
  • 路由类型:首页、服务/分类页、详情页、博客/文章、作者页、搜索结果页、标签/分类页、分页、筛选/分面 URL、产品变体、本地化路由以及错误页面。
  • 现有分析和搜索工具:Google Search Console、GA4 或其他分析工具、Bing Webmaster Tools、日志访问、排名跟踪、爬取报告、转化跟踪以及同意管理平台。
  • 现有技术决策:规范主机、站点地图策略、robots 规则、重定向、结构化数据、hreflang、索引策略、元数据模板以及内部链接。

不要询问仓库或提供的上下文已经能回答的信息。如果无法确定关键事实,请继续进行并附带明确的假设,或者当决策确实依赖于该事实时,提出一个简洁的问题。

2. 建立基线并爬取网站

使用适合环境的可用工具。应优先进行代表性爬取和针对性代码检查,而不是仅根据文件名做出假设。

仓库检查

检查相关文件和源路径,包括但不限于:

  • 包/配置文件、框架配置、托管/部署配置、中间件/代理和重定向规则。
  • 根布局和嵌套布局、路由/页面模块、元数据辅助函数、内容 Schema、CMS 配置、模板以及共享导航/页脚组件。
  • sitemap.xml 或站点地图生成代码、robots.txt、规范链接逻辑、重定向和 URL 构建辅助函数。
  • 结构化数据生成器、图片/视频组件、分析/同意设置以及 404/410 处理。
  • 现有测试和 CI 检查。

不要转储 .env 值或其他秘密。检查所需变量是否存在,但不要打印其值。

现场网站检查(在允许的情况下)

测试代表性 URL 类别并检查响应和渲染后的 HTML。捕获:

  • 状态码、重定向链和最终 URL。
  • 规范标签、标题、元描述、robots 指令和 robots 标头。
  • 原始 HTML 中的主要内容,以及当涉及 JavaScript 时渲染后的 HTML 内容。
  • 内部链接、站点地图包含情况、结构化数据以及明显的重复版本。
  • 移动端渲染、明显的渲染失败以及可用的性能数据。

至少对以下页面进行采样:首页、主要转化/服务页面、主要列表页面、代表性详情页面、一篇博客文章、一个分类/标签/筛选页面(如适用)、一个有效的查询字符串 URL 以及一个不存在的 URL。对于大型站点,构建一个爬取样本并按模板分段。如果您没有爬取每个 URL,请勿声称已爬取过。

基线证据

在更改前记录可用的基线:按模板划分的 URL 数量、响应状态分布、可索引性、规范一致性、站点地图错误、自然点击量/展示次数/点击率/排名位置、转化、Core Web Vitals 以及相关的业务成果。不要编造缺失的测量数据。

3. 合理确定问题优先级

使用严重性和置信度,而不是模糊的 SEO 分数。实用的优先级分级:

  • P0 — 关键: 全站 noindex、意外的 robots 封锁、主要路由上错误的规范标签、重定向循环、生产环境宕机、大规模 5xx、域名/URL 迁移丢失、安全受损或其他导致重要页面无法访问/索引的问题。
  • P1 — 高: 重要的金钱/内容页面被封锁、规范标签错误、被排除在导航/站点地图之外、无法渲染实质性内容、返回错误状态码或存在系统性模板缺陷。
  • P2 — 中: 重要的元数据/结构化数据/内部链接/性能问题、孤立的部分、重复页面、内容覆盖率差或显著的转化障碍。
  • P3 — 低/机会: 轻微的文案改进、低影响的润色、可选的结构化数据、孤立的 alt 文本缺失或投机性的内容机会。

对于每个发现,说明:证据、受影响的 URL/模板、可能的用户/搜索影响、置信度、实施工作量、风险、建议以及验证方法。不要将严重性与确定的排名变化划等号。

4. 技术 SEO:爬取、索引、URL 和状态码

可爬取性和可索引性

  • 区分爬取访问(robots.txt、服务器响应、可访问的链接)、索引指令(noindex、规范信号、状态)和排名。
  • 确保重要的公共内容可以通过正常的可爬取链接访问并响应成功。
  • 仅在有意时使用 noindex。请记住,robots.txt 会阻止爬取;它不是从搜索结果中移除 URL 的可靠方法,并且爬虫通常需要获取页面才能看到其页面级的 noindex 指令。
  • 除非是有意且经过验证的阻止,否则不要禁止渲染或理解重要内容所必需的资源。
  • 适当地将登录、账户、管理、结账、内站搜索、预览、预发布和私有区域排除在搜索之外。使用授权保护私有内容;robots.txt 不是访问控制。
  • 确保缺失的页面在适当的情况下返回真实的 404 或 410,而不是 200 软 404。不要将无关的已删除 URL 重定向到首页。
  • 不要强制索引每个 URL。某些筛选器、内站搜索结果、内容单薄的标签页面、重复变体和实用页面可能不值得索引。
  • 将爬取预算优化视为针对非常大或频繁更新的站点的专项关注,而不是小站点的例行公事。

规范化和 URL 标准化

  • 选择符合实际业务决策、域配置和现有 SEO 权益的协议/主机/路径格式。不要假设 www 或非 www 本质上更优。
  • 对于真正的重复 URL,在适当的情况下对齐永久重定向、规范链接元素、内部链接、站点地图 URL 和结构化数据 URL。
  • 为每个可索引页面使用正确的绝对规范 URL。避免将不相关的内容或所有页面规范到首页。
  • 将重定向视为强烈的规范化信号,将 rel="canonical" 视为强烈信号,将站点地图包含视为较弱信号。这些是信号,不是绝对命令。
  • 保持规范目标的 URL 是可索引、可爬取、成功且相关的。避免重定向链和循环;使用直接重定向到最终目标。
  • 不要盲目删除合法的查询参数。在标准化 URL 之前,要了解跟踪参数、筛选器、分页、排序、产品变体和应用程序功能。
  • 除非有明确的理由进行更改,否则保留现有的有价值 URL。

重定向和错误

  • 当 URL 已永久移动且平台正确支持时,使用永久重定向(301 或 308);对于临时条件,使用临时重定向。
  • 仅根据预期的站点架构测试 HTTP/HTTPS、www/非 www 和尾部斜杠行为。
  • 在主机名或协议规范化期间,保留路径和有意义的查询参数。
  • 避免捕获 API 端点、资源、子域名或不相关路径的宽泛规则。
  • 对于 URL 更改,在存在真正等效内容的地方,创建一对一的旧到新映射。将过时的 URL 重定向到最接近的相关替换页面,而不是不加区分地重定向到首页。
  • 在部署环境中验证状态码和重定向步数;仅凭本地配置不能证明生产行为。

JavaScript 和渲染

  • 确认主要内容、页面标题、元数据、规范提示、链接和结构化数据存在于可爬取/渲染的输出中。
  • 在适合技术栈和站点的情况下,使用服务器端渲染、静态生成或预渲染,但不要仅仅因为 SEO 陈规而迁移框架。
  • 使用普通的 <a href="..."> 链接使重要导航可爬取。不要仅依赖点击处理程序或无法访问的应用外壳交互进行发现。
  • 不要依赖用户交互、身份验证或延迟的客户端专属效果来揭示重要的可索引内容。
  • 避免初始 HTML 和 JavaScript 渲染后的 HTML 之间出现冲突的规范或 robots 值。如果 JavaScript 更改了元数据,请检查渲染后的输出。
  • 使用框架原生的元数据和路由系统,而不是在冲突的机制之间重复元数据。

站点地图 XML

  • 尽可能从真实的路由/内容源生成站点地图。
  • 只包含符合索引资格的首选规范 URL;排除重定向、noindex URL、错误、私有页面和不相关的 URL 变体。
  • 一致地使用绝对 URL 和首选主机/协议。
  • 在有资格的内容发布、更新或删除时,自动更新站点地图。
  • 仅在存在真实的实质性修改日期时才使用有意义的 lastmod 值;不要每次部署都更新每个日期。
  • 遵守站点地图协议限制;当规模或可维护性需要时,使用站点地图索引和分段的站点地图。多个站点地图本身并不能改善排名。
  • 验证 XML 语法、响应状态、内容类型、URL 数量以及示例 URL。如果获得授权,请检查 Search Console 的站点地图报告。
  • 不要声称提交站点地图能保证爬取、索引或排名。

robots.txt 和指令

  • 在编辑前检查现有指令。保留规则,除非它们错误或具有明确记录的用途。
  • 在适当的情况下添加站点地图位置,并确保它是规范的站点地图 URL。
  • 区分 robots.txt 爬取指令与 meta robots 和 X-Robots-Tag 索引指令。
  • 在非常小心的情况下应用诸如 crawl-delay 之类的指令,并考虑全局影响。
  • 测试部署版的 robots.txt,而不是仅测试本地版本。

5. 页面优化:标题、描述、内容、结构化数据和性能

标题和元描述

  • 为每个可索引页面创建唯一的、描述性的标题元素。
  • 将标题和描述视为面向用户的页面摘要,而不是关键词列表。
  • 确保元描述与给定页面上的实际内容高度相关,并准确反映用户可能找到的内容。
  • 对于本地化页面,使用翻译后的标题和描述的本地化变体。
  • 不要使用基于相同模板的固定或自动生成的标题,而不进行特定于上下文的修改。
  • 定期检查标题和描述是否会因太长而被搜索引擎截断。

内容质量

  • 评估内容覆盖率和主题相关性。
  • 确保每个主要页面针对其主题提供实质性、独特且有帮助的信息。
  • 关联内容与用户意图和搜索引擎预期。
  • 避免在多个页面上稀疏或重复的内容。
  • 优先考虑原创研究和分析,而不是重新包装现有信息。
  • 在所有相关内容方面保持一致性,无论是格式还是深度。

结构化数据

  • 在相关的地方使用 Schema.org 标记以启用增强搜索结果表示。
  • 验证标记语法和 Google 富媒体搜索结果测试工具的资格。
  • 确保结构化数据准确表示页面内容并包含所有必需的属性。
  • 避免使用用户无法看到的不相关或误导性的结构化数据。
  • 对于本地企业,使用 LocalBusiness 标记,并且业务详情准确且一致。
  • 结构化数据中不包含虚假信息。

性能

  • 作为更广泛的页面体验因素的一部分,评估并改进 Core Web Vitals。
  • 为搜索引擎和用户优化加载时间、交互性和视觉稳定性。
  • 根据可用的性能预算优化资源。

6. 链接、导航和站点架构

内部链接

  • 使用基于内容和语义的链接来增强可访问性。
  • 创建一个逻辑站点层次结构,帮助搜索引擎理解内容关系。
  • 通过适当的导航元素和面包屑,确保重要页面获得链接权重。
  • 减少链接到重要内容的点击距离。
  • 使用相关锚文本,避免过度优化或相同关键词的重复。
  • 通过导航结构定期审计孤立的页面和内容部分。

外部链接和引用

  • 区分出站自然链接和付费引用。
  • 确保外部引用来自权威来源,以提升可信度。
  • 不要进行链接方案,并避免最终可能受到惩罚的链接交换。
  • 对指向外部网站的链接使用 rel="noopener" 以提高安全性。

7. 特定的 SEO 领域

本地 SEO

  • 在 Google My Business 和适当的目录中验证并优化 NAP 信息。
  • 创建和优化专门的本地内容(例如,城市特定页面)。
  • 确保本地结构化数据的一致性。
  • 鼓励来自当地客户、目录和相关方的 citations。

电商 SEO

  • 创建独特的产品描述,优化列表页面以及产品变体处理。
  • 管理分面导航和规范化,以避免重复。
  • 实施适当的 Schema 标记以启用产品搜索体验。

国际化 SEO

  • 使用 hreflang 标签指示语言和区域变体。
  • 使用不同的 URL 结构或基于内容的本地化。
  • 保持跨市场的一致页面,但允许本地化差异。

迁移

  • 在更改域名和 URL 结构之前规划重定向。
  • 确保旧属性在搜索引擎中持续存在的权益转移到新 URL。
  • 监控迁移后的爬取和索引状态。

8. 监控、分析和报告

分析设置

  • 正确实施分析,确保其跟踪所有必要的操作并排除内部流量。
  • 设置转化目标和事件跟踪。
  • 将分析工具与 Search Console 和 Bing Webmaster Tools 集成。

定期审计

  • 定期对技术 SEO、内容质量、外部链接和用户体验进行审计。
  • 检查排名趋势和自然流量模式。
  • 监控索引状态和爬取错误。
  • 确保随着时间的推移遵守搜索指南。

报告

  • 报告已实施的更改及其对关键指标的影响。
  • 在考虑到外部因素的情况下,将排名变化与 SEO 活动相关联。
  • 呈现可操作的建议和明确的改进时间表。

9. 持续改进和搜索适应

算法更新

  • 了解可能影响 SEO 实践或排名的搜索引擎更新。
  • 根据需要对内容和策略进行渐进式调整。

新兴趋势

  • 评估并采用可能提供竞争优势的新搜索功能。
  • 为视听搜索、语音搜索和 AI 驱动的搜索体验优化内容。

用户反馈

  • 分析用户互动以指导内容策略。
  • 迭代更新以持续满足用户需求。

重要的最后说明

  • 此技能补充而非取代现有文档。 始终查阅官方 Google 和 Bing 指南以获取当前要求。
  • 此技能不会创造 SEO 秘密武器。 没有捷径。始终提供没有虚假主张的正确、可操作的信息。
  • 无论采用何种方法,都应保持透明。 记录所做的更改以及原因。
  • 在适当的时候记录必要的手动步骤。 确保实施不局限于自动化。
  • 此技能的最后更新: 请定期检查更新。

永远记住:积极的 SEO 是让网页真正对用户有帮助,然后确保值得索引。此技能的目标是安全且负责任地实现这一点。

相关技能