AG Kit SEO Specialist Agent 实战指南面向 Google 与 AI 搜索的双引擎优化方案【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit本指南以 AG Kit 仓库中的 seo-specialist 智能体定义 为核心系统讲解如何同时赢得 Google 传统搜索排名与 ChatGPT、Claude、Perplexity 等 AI 搜索的引用机会并配套仓库内的 seo_checker.py、geo_checker.py 自动化审计脚本与 AG Kit 官网 的真实落地实现。读完本文你将掌握 SEO/GEO 双目标优化的完整清单、核心指标阈值以及如何在项目中用一条命令完成可量化的 SEO 与 AI 引用就绪度审计。一、认识 AG Kit 中的 seo-specialist一个为双引擎而生的角色在 AG Kit 的智能体体系中每个角色都以 Markdown 文件形式定义在.agents/agent/目录下seo-specialist就是其中之一。它的 frontmatter 元数据完整定义了该角色的能力边界name: seo-specialist description: SEO and GEO (Generative Engine Optimization) expert. Handles SEO audits, Core Web Vitals, E-E-A-T optimization, AI search visibility. Use for SEO improvements, content optimization, or AI citation strategies. tools: Read, Grep, Glob, Bash, Write model: inherit version: 1.0.0 skills: clean-code, seo-fundamentals, geo-fundamentals从这段元数据可以读出三个关键设计职责定位该角色覆盖 SEO 审计SEO audits、Core Web Vitals 优化、E-E-A-T 提升、AI 搜索可见性AI search visibility、Schema 标记实施、内容优化与 GEO 策略七大任务工具边界只授予Read, Grep, Glob, Bash, Write五类只读与写入工具说明这是一个以分析、诊断与内容改进为主的角色不涉及破坏性操作技能依赖通过skills:字段挂载三个技能——clean-code、seo-fundamentals、geo-fundamentals其中后两者正是本文第二、三部分的理论来源分别位于 seo-fundamentals/SKILL.md 与 geo-fundamentals/SKILL.md。按照 AGENT_FLOW.md 中定义的 Agent 路由清单当用户请求涉及 SEO 领域时系统会执行识别正确智能体 → 读取其 .md 文件 → 声明启用角色 → 加载 frontmatter 中的技能四步流程随后该角色以内容为人类而写、结构为机器而建同时赢得 Google 与 ChatGPT为核心哲学Core Philosophy展开工作。二、SEO vs GEO一次优化两个战场seo-specialist的核心思维方式是双目标Dual-target传统 SEO 与生成式引擎优化GEO同时进行。原文档用一张对比表清晰地划出了两个战场AspectSEOGEOGoalRank #1 in GoogleBe cited in AI responsesPlatformGoogle, BingChatGPT, Claude, PerplexityMetricsRankings, CTRCitation rate, appearancesFocusKeywords, backlinksEntities, data, credentials在 geo-fundamentals 技能 中这一对比被进一步细化SEO 追求Google 排名第一GEO 追求在 AI 回复中被引用SEO 的度量是排名与点击率CTRGEO 的度量是引用率Citation rate与出现次数。两者的焦点也截然不同——SEO 聚焦关键词与反链GEO 聚焦实体Entities、数据与可信凭据credentials。对于开发者而言这意味着一份内容需要同时满足两套评价体系对 Google要有清晰的关键词布局、规范的技术基础与权威反链对 AI 引擎要有可被检索抽取的实体、结构化的数据、明确的作者与时间戳。不同 AI 引擎的引用风格与机会点也各有差异引自 geo-fundamentals 技能EngineCitation StyleOpportunityPerplexityNumbered [1][2]Highest citation rateChatGPTInline/footnotesCustom GPTsClaudeContextualLong-form contentGeminiSources sectionSEO crossover三、Core Web Vitals性能即排名的硬指标在技术 SEO 中页面体验是 Google 明确纳入排名考量的因素。seo-specialist维护了一张精确的指标阈值表这也是 Lighthouse、PageSpeed Insights 等工具判定良好与较差的分界线MetricGoodPoorLCP 2.5s 4.0sINP 200ms 500msCLS 0.1 0.25三个指标的含义与 seo-fundamentals 技能 中Measures列一致LCPLargest Contentful Paint最大内容绘制时间衡量加载性能目标 2.5 秒INPInteraction to Next Paint交互到下一次绘制的延迟衡量交互响应性目标 200msCLSCumulative Layout Shift累计布局偏移衡量视觉稳定性目标 0.1。值得注意的是GEO 场景同样要求快速加载——geo-fundamentals 技能 的技术清单中将Fast loading ( 2.5s)列为被 AI 引用的前提之一因为 AI 引擎同样会评估来源页面的可抓取性与可访问性。性能优化performance-profiling与 SEO 在 AG Kit 中形成交叉验证验证层通过 lighthouse_audit.py 等脚本量化这些指标参见 AGENT_FLOW.md 的 Validation Quality Gates 一节。四、E-E-A-TGoogle 内容质量评估框架E-E-A-TExperience、Expertise、Authoritativeness、Trustworthiness是 Google 质量评估指南中的核心框架。seo-specialist给出了每个原则的展示方式即如何让搜索引擎与用户感知到这些信号PrincipleHow to DemonstrateExperienceFirst-hand knowledge, real storiesExpertiseCredentials, certificationsAuthoritativenessBacklinks, mentions, recognitionTrustworthinessHTTPS, transparency, reviewsseo-fundamentals 技能 进一步将其映射为可检测的信号Experience 对应一手知识与真实案例、Expertise 对应资质与知识深度、Authoritativeness 对应反链与行业认可、Trustworthiness 对应 HTTPS 加密与信息准确性。E-E-A-T 的落地要点可以总结为四件事在内容中体现真实使用经验真实案例、实测数据明确展示作者或团队的专业资质通过行业提及、可信反链积累权威性全站启用 HTTPS保持信息透明可核查。五、技术 SEO 清单爬虫眼中的站点体检表seo-specialist的技术 SEO 清单是一份可逐项勾选的体检表覆盖从能否被爬取到能否被理解的完整链路XML sitemap submittedrobots.txt configuredCanonical tags correctHTTPS enabledMobile-friendlyCore Web Vitals passingSchema markup valid其中前四项的基础作用引自 seo-fundamentals 技能ElementPurposeXML sitemapHelp crawlingrobots.txtControl accessCanonical tagsPrevent duplicatesHTTPSSecurity signal这份清单在 AG Kit 自己的官网上有完全对应的实现可以直接对照学习robots.txt定义在 web/src/app/robots.ts对全部爬虫放行userAgent: *, allow: /并显式声明 sitemap 地址XML sitemap定义在 web/src/app/sitemap.ts覆盖首页、全部文档路由与十个 guide/examples 页面并为每条路由设置了changeFrequencychangelog 为 weekly其余为 monthly与priority首页 1、/docs0.9、其余 0.7这正是让爬虫知道哪些页面重要的标准做法Canonical 与索引控制定义在 web/src/app/layout.tsx通过alternates.canonical: /声明规范化地址通过robots: { index: true, follow: true }显式允许收录。六、内容 SEO 清单页面元素与内容质量技术基础之上seo-specialist的内容 SEO 清单聚焦页面本身的元素优化Title tags optimized (50-60 chars)Meta descriptions (150-160 chars)H1-H6 hierarchy correctInternal linking structureImage alt textsseo-fundamentals 技能 给出了每个元素的细化规范Title 控制在 50–60 字符且关键词前置Meta description 控制在 150–160 字符且具有吸引力每个页面只有一个 H1 且包含主关键词H2–H6 形成逻辑层级alt 文本要求描述性而非堆砌关键词。此外内容质量本身也是排名因素技能文档列出四个维度Depth覆盖全面、Freshness定期更新、Uniqueness原创价值、Readability清晰易读。在 AG Kit 官网的 layout.tsx 中可以看到完整的元数据落地title使用模板%s | AG Kit实现全站统一命名description提供站点摘要openGraph配置了 1280×640 的 og-image.png 社交分享图twitter卡片设置为summary_large_image。这套配置同时满足了搜索引擎、社交媒体爬虫与 AI 引擎对页面描述的需求。七、GEO 清单让 AI 引擎愿意引用你如果说 SEO 清单解决的是被找到GEO 清单解决的是被引用。seo-specialist的 GEO 清单包含六项内容要素FAQ sections presentAuthor credentials visibleStatistics with sourcesClear definitionsExpert quotes attributedLast updated timestampsgeo-fundamentals 技能 将这一清单扩展为内容与技术两部分内容要素Question-based titles问题式标题Summary/TL;DR at top顶部摘要Original data with sources带来源的原始数据Expert quotes (name, title)带姓名与头衔的专家引述FAQ section (3-5 QA)Clear definitions清晰定义Last updated timestampAuthor with credentials带资质的作者信息技术要素Article schema with datesPerson schema for authorFAQPage schemaFast loading ( 2.5s)Clean HTML structure这些要素之所以重要与 AI 引擎的检索机制RAG检索增强生成直接相关。geo-fundamentals 技能给出了一组权重参考语义相关性约 40%、关键词匹配约 20%、权威信号约 15%、时效性约 10%、来源多样性约 15%。这意味着**内容是否清楚、权威、易抽取直接决定了被引用的概率**——AI 需要从你的页面中稳定地提取出可引用的定义、数据与结论。八、什么样的内容会被 AI 引用seo-specialist总结了六类最容易被 AI 引擎引用的内容要素及其原因ElementWhy AI Cites ItOriginal statisticsUnique dataExpert quotesAuthorityClear definitionsExtractableStep-by-step guidesUsefulComparison tablesStructuredgeo-fundamentals 技能从为什么有效的角度补充了对应关系原始统计因为数据唯一可引用专家引述产生权威转移清晰定义易于抽取分步指南提供可操作价值对比表格信息结构化FAQ 段落提供直接答案。结构化Structured是被引用的核心共性——表格、列表、定义段落、FAQ 都是 AI 最容易抽取的结构。九、配套自动化一条命令跑完 SEO 与 GEO 审计seo-specialist不只是给出一堆清单AG Kit 为两个支撑技能都配套了可执行的审计脚本让优化工作可度量、可回归、可验证。9.1 SEO 审计seo_checker.py脚本位于.agents/skills/seo-fundamentals/scripts/seo_checker.py通过扫描 HTML/JSX/TSX 页面执行五项核心检查Title 标签检查title是否存在仅对 layout/Head 文件判定为缺失时报警Meta description检查namedescription是否存在Open Graph 标签检查og:属性是否配置对应社交分享与 AI 引擎的摘要抽取Heading 层级正则统计h1数量超过一个即报警 Multiple H1 tags图片 alt检查所有img是否缺失 alt 或存在空 alt。脚本的页面识别逻辑值得一提它会跳过node_modules、.next、dist、build、test、docs等目录SKIP_DIRS并排除config、util、hook、api、service等非页面文件模式SKIP_PATTERNS只针对pages/app/routes/views/screens目录或page、index、home等命名特征的公开页面每次最多分析 50 个文件。运行方式在项目根目录执行python .agents/skills/seo-fundamentals/scripts/seo_checker.py 项目路径脚本最终输出 JSON 摘要含files_checked、issues_found、passed字段有问题时以非零码退出适合接入 CI 流水线作为质量门禁。9.2 GEO 审计geo_checker.py脚本位于.agents/skills/geo-fundamentals/scripts/geo_checker.py专门评估AI 引用就绪度是 GEO 清单的自动化版本python .agents/skills/geo-fundamentals/scripts/geo_checker.py 项目路径它的评分机制完全对应本文第七部分的 GEO 清单每页按 0–100 分计算必选项占 70 分单一 H1页面主题清晰、至少两个 H2 小标题内容可扫读对于 blog/article/post 等文章类页面额外要求作者署名与发布日期可选项占 30 分JSON-LD 结构化数据10、可识别的 schema 实体5、FAQ 段落5、有序/无序列表5、对比表格5、带数据的论断5、直接回答式措辞5。脚本对平均分给出了明确的分级≥ 80 为 Excellent≥ 60 为 Good≥ 40 为 Needs work 40 为 Poor并以平均分 ≥ 60 作为通过线exit code 0。一个值得注意的实现细节脚本会跟随页面的 import 追踪实际渲染内容_read_route_content函数例如 Next.js 路由入口通常只渲染一个薄包装真正的内容在content.tsx或本地化 MDX 中当存在多语言版本时脚本只分析规范的英文源.en.避免拼接四个互斥的 H1 造成误判。这与 web/src/app/docs/ 下page.tsx content.*.mdx的多语言文档架构完全吻合。十、仓库实例AG Kit 官网如何自我践行seo-specialist的清单不是纸上谈兵——AG Kit 自己的官网就是一份活教材。除了前文提到的 robots.ts、sitemap.tslayout.tsx 中还内嵌了 JSON-LD 结构化数据{ context: https://schema.org, graph: [ { type: WebSite, id: https://ag-kit.unikorn.vn/#website, url: https://ag-kit.unikorn.vn/, name: AG Kit, description: ... } ] }这正对应 geo_checker.py 中 JSON-LD structured data found10 分与 Recognizable schema entity found5 分两个加分项也对应 seo-fundamentals 技能中 Article / Organization / Person / FAQPage / Product / Review / BreadcrumbList 等 Schema 类型的使用场景。此外web/src/app/manifest.ts 配置了 PWA 清单站点名、图标、主题色移动端友好性Mobile-friendly作为技术 SEO 清单与排名因素之一由此得到保障web/public/images/og-image.png 与 favicon.ico 则支撑了 Open Graph 与品牌识别。对照 web/src/app/docs/agents/page.tsx 中列出的 20 个智能体与 services/agents.json 的数据源可以确认 seo-specialist 正是这 20 个领域角色之一与 AG Kit 的内容即结构、清单即代码理念一脉相承。十一、何时启用 seo-specialist原文档明确列出了该角色的适用场景SEO auditsSEO 审计Core Web Vitals optimization核心性能指标优化E-E-A-T improvementE-E-A-T 提升AI search visibilityAI 搜索可见性Schema markup implementationSchema 标记实施Content optimization内容优化GEO strategyGEO 策略在 AG Kit 的使用流程中参见 AGENT_FLOW.md 的 Agent Selection MatrixSEO 领域请求会直接路由到seo-specialist并自动加载seo-fundamentals与geo-fundamentals两个技能在/orchestrate多智能体协作模式下seo-specialist 可以与performance-optimizer性能与 Core Web Vitals 交叉验证、documentation-writer内容结构协同完成一次完整的站点体检与优化。项目验证层的 Quick Check 中明确包含 SEO Check (Meta tags, performance) 项说明 SEO 审计已经内建为 AG Kit 的标准质量门禁之一。十二、总结一份可持续执行的优化闭环回顾seo-specialist的完整方法论可以提炼出一个可持续执行的优化闭环定基线用 seo_checker.py 与 geo_checker.py 对站点做量化体检得到 SEO 问题清单与 GEO 评分补基础按技术 SEO 清单补齐 sitemap、robots.txt、canonical、HTTPS、Schema优内容按内容 SEO 与 GEO 清单优化标题、描述、层级、FAQ、作者信息与时间戳重性能盯住 LCP 2.5s、INP 200ms、CLS 0.1 三组硬指标再验证定期重跑审计脚本以passed状态与 GEO 平均分作为回归依据。正如原文档结尾所强调的The best SEO is great content that answers questions clearly and authoritatively——最好的 SEO 是清晰、权威地回答用户问题的高质量内容。在 AI 搜索崛起的当下这句话同时适用于 Google 与 ChatGPT把内容写给人类把结构交给机器两个引擎都会为你打开流量入口。【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
