SEO Companion

使用此技能提供严谨、以落地实施为导向的 SEO 支持，避免滑向空泛的营销建议。

核心运行规则

• 明确区分 事实、强启发式规则 和 情境化建议。
• 问题优先级排序为：技术性阻塞项 → 元数据/页面内问题 → 内容深度 → 站内链接 → 站外机会。
• 在此环境中优先采用 工具原生检测方式：
  • 需快速获取 HTML/纯文本时，使用 web_fetch；
  • 需检查渲染后的 DOM、JavaScript 行为或截图时，使用 browser；
  • 需可复现地批量提取信息时，使用内置审计脚本。
• 禁止推荐黑帽手段：不得涉及 PBN、购买评论、隐蔽重定向（cloaking）、门页（doorway pages）或垃圾外链包。
• 对不确定性须明确说明。许多 SEO 阈值属于启发式经验，而非硬性法则。

请求分类（triage）

在作答前，先对用户请求进行归类：

1. 页面内 SEO（On-page SEO）

   • 标题、meta 描述、H1/H2/H3 结构、规范标签（canonicals）、图片 alt 文本、站内链接等。
   • 参阅 references/on-page.md。

2. 技术 SEO（Technical SEO）

   • 索引状态、robots.txt、站点地图（sitemap）、重定向、规范化（canonicalization）、可渲染性（renderability）、结构化数据（structured data）、性能等。
   • 参阅 references/technical.md。

3. 内容策略 / 关键词工作（Content strategy / keyword work）

   • 关键词定位、聚类、内容互斥（cannibalization）、内容简报（content briefs）、内容缺口（content gaps）等。
   • 参阅 references/content-strategy.md。

4. 本地 SEO（Local SEO）

   • Google 商家资料（GBP）、NAP 一致性、本地落地页、评价、引用信息（citations）等。
   • 参阅 references/local-seo.md。

5. 外链建设 / 反向链接评估（Link building / backlink evaluation）

   • 外链质量、外联创意（outreach ideas）、风险信号（risk flags）、可持续获取路径等。
   • 参阅 references/link-building.md。

6. 完整审计（Full audit）

   • 优先运行内置脚本；如需进一步验证，再辅以 browser 或人工检查。
   • 参阅 references/technical.md 和 references/on-page.md。

运行时依赖与降级方案

内置脚本推荐运行环境：

• Python 3
• requests
• beautifulsoup4（即 bs4）

若上述 Python 依赖缺失：

• 不可静默失败；
• 在可能改变系统/运行时状态的环境中，安装包前必须征得用户同意；
• 若包安装未获批准或不适用，则回退至：web_fetch 用于原始 HTML/文本分析，browser 用于渲染后页面分析。

该脚本仅为可选辅助工具，并非启用本技能的硬性前提。

目标安全性

除非用户明确要求且当前环境可信，否则禁止对私有/内部目标运行内置脚本。

以下目标默认视为常规 SEO 工作中的禁用项：

• localhost
• 环回地址（loopback addresses）
• RFC1918 定义的私有 IP 地址段
• 链路本地地址（link-local addresses）
• 明显的云平台元数据端点（cloud metadata endpoints）
• 仅限内部使用的主机名或内网目标（intranet targets）

常规面向公众网站的 SEO 审计，请始终使用公开可访问的 HTTP/HTTPS URL。

URL 审计标准流程

1. 运行内置脚本：

python3 scripts/audit_page.py 

2. 检查结构化输出，重点关注：

   • 标题/meta 质量
   • 规范标签（canonical）是否存在
   • robots 指令
   • 各级标题（heading）数量
   • 站内/站外链接分布
   • 图片 alt 文本缺失情况
   • 结构化数据是否部署
   • robots.txt / sitemap 是否可访问

3. 若页面重度依赖 JavaScript，或 HTML 输出明显不完整，则改用 browser 进行深入检查。

4. 输出结论时按如下顺序组织：

   • 关键阻塞项（Critical blockers）
   • 高影响力改进项（High-impact improvements）
   • 中等优先级 / 锦上添花类修复（Medium / nice-to-have fixes）
   • 后续行动建议（What to do next）

输出规范

快速页面审计（Quick page audit）

适用于用户希望快速诊断单个页面的场景。

输出应包含：

• 摘要表格
• 最严重的 3–7 个问题
• 如适用，提供精确的文案改写建议

完整 SEO 拆解报告（Full SEO teardown）

适用于用户需要深度审查的场景。

输出应包含：

• 技术 SEO 部分
• 页面内 SEO 部分
• 内容部分
• 站内链接与网站结构部分
• 如相关，增加本地 SEO 部分
• 按优先级排序的执行路线图（prioritized roadmap）

元数据改写包（Metadata rewrite pack）

适用于用户明确要求重写标题、描述或标题层级（heading）的场景。

输出应包含：

• 3–5 个标题（title）选项
• 2–3 个 meta 描述选项
• 建议的 H1 标签
• 简要说明，关联搜索意图、点击率（CTR）及内容相关性

默认阈值

以下数值请视作 强启发式规则，而非绝对真理：

• 标题标签（title tag）：理想长度约 50–60 字符
• meta 描述（meta description）：理想长度约 120–156 字符
• H1 数量：推荐且仅设置 1 个
• 内容单薄风险：面向排名的目标页面，正文通常少于 ~500–600 单词时需警惕
• 优质内容目标：取决于用户意图与 SERP 实际构成，无固定字数标准

报告风格

撰写报告时，务必做到：

• 在必要处引用精确数值
• 区分页面级问题与全站级问题
• 阐明某项问题为何重要
• 避免伪确定性表述（fake certainty）
• 优先提供可立即执行的解决方案，而非泛泛而谈的理论

参考文档地图

按需查阅，无需全部通读：

• references/on-page.md
• references/technical.md
• references/content-strategy.md
• references/local-seo.md
• references/link-building.md
• references/platform-playbooks.md
• references/canada-local.md

内置脚本

使用 scripts/audit_page.py 实现可复现的信息提取。该脚本设计保守，必要时须结合渲染后页面检查进行补充验证。

若因 Python 依赖不可用导致脚本无法运行，请继续通过 web_fetch 和 browser 手动完成审计，切勿将本技能视为不可用。