mars-tw/open-seo-advisor-skill

開源、可攜、不綁定單一廠商的全域 SEO 顧問技能 - 蒸餾 SEO 權威方法論，協助任何產業做 SEO 健檢、修復、內容產出

Open SEO Advisor – 是什么

Open SEO Advisor 是一个开源 CLI 工具，也是 AI 编码代理（如 Claude Code、Codex、OpenCode）的技能。它将一系列 SEO 相关工作流——站点健康检查、技术修复、安全审计、内容生成、WordPress 插件骨架搭建、广告活动建议，甚至一个协调多个 AI 助手角色的“矩阵”——整合到一个命令行界面中，可本地运行或由 AI 代理调用。

核心功能（“七种模式”）

模式	功能
顾问	扫描整个站点，生成通俗易懂的报告和优先级待办清单。
工程师	检测并提出技术 SEO 问题的修复建议，如 `sitemap.xml`、`robots.txt`、规范标签、`hreflang` 等。
安全	检查与 SEO 相关的安全风险（暴露的文件、过时的 CMS、恶意重定向、HTTPS 问题）。
内容撰写	调用 LLM（Claude、OpenAI GPT 或本地模型）生成符合最佳实践的 SEO 友好内容。
插件开发	为 SEO 导向的 WordPress 插件或其他 CMS 扩展生成初始代码。
Meta 广告	分析 Meta（Facebook/Instagram）广告账户并输出一次预演优化方案；任何实际支出操作均需明确确认才能执行。
图像素材	使用可配置的图像提供者（默认为 OpenAI DALL-E）生成广告、文章或社交帖子用的图像资产。

高级“AI 矩阵”协调器

除了各个独立模式外，该工具还提供一个 matrix 命令，接受单一业务目标（例如 “推广新产品并增加咨询量”）。内部控制器（名为 NORA）将任务分配给 26 个 AI 角色代理（战略、营销、销售、财务、法律等）。每个角色调用相应模式，系统将输出聚合为单一交付成果。高风险步骤（如发布或支出资金）始终需要手动确认。

如何使用

独立 CLI – 安装包后，直接运行 seo-advisor 命令。示例：
```
seo-advisor audit consultant --url https://example.com --out ./report
```
此命令将生成四个报告（Markdown、JSON、HTML 和初学者友好摘要）。
AI 代理技能 – 将仓库克隆到 OpenCode 或 Codex 的技能目录中。然后可以向代理发出提示：

“使用 $open‑seo‑advisor，带我建立一个包含 GPT 图像与沉浸式滚动动画的购物网站，优先使用免费主机。” 代理将引导你完成品牌定义、故事板、GPT 图像生成、站点骨架搭建和部署选择（Cloudflare、Firebase、GCP Cloud Run）。
离线站点构建器 – seo-advisor website init 命令会创建一个静态站点骨架、图像提示列表和部署配置文件。你仍需自行运行 LLM/图像 API 并添加任何电商逻辑。

仓库实际包含的内容

Python 包（scripts/）：暴露 seo-advisor 入口点。
文档：涵盖快速入门、架构、模式特定细节和功能地图。
示例演示：使用 GPT 生成图像的沉浸式叙事站点（“叶之家”和“工笔画”演示）。这些是 no-index 的演示页面，仅用于说明。
CI 工作流 和 Apache-2.0 许可证。

限制与验证说明（如 README 所述）

CLI 仅执行 离线分析；除非你明确批准写入/部署步骤，否则不会修改实时站点。
生成的 GPT 图像、多页电商流程和支付集成 未自动化；代理必须在骨架构建后调用相应 API。
SEO 影响（排名、AI 搜索引用）必须在站点上线并被索引后测量；该工具只能保证元数据、规范标签等正确设置。
演示站点以 noindex,follow 提供，不作为生产就绪示例。

哪些人可能用得上？

SEO 顾问：希望拥有可复现、可脚本化的审计，可交由 LLM 生成报告的人。
开发 SEO 友好静态或 WordPress 站点的开发者：希望使用单一工具同时搭建内容和结构的人。
AI 代理平台用户（OpenCode、Claude Code、Codex）：寻找即用型“技能”，让代理协调 SEO、内容和营销任务的人。
小企业：希望在控制成本的前提下尝试 AI 生成内容和图像的人（工具默认使用只读、免费层级 API）。

快速入门检查清单

运行平台特定的安装脚本（install.sh 或 install.ps1）。
执行 seo-advisor 并回答交互式提示，或运行特定模式如 seo-advisor audit consultant --url https://your‑site.com。
审查生成的报告；手动处理任何 P0–P3 项目，或让 AI 代理继续工作流。
准备就绪后，使用 seo-advisor website 命令搭建站点，然后通过所选主机部署。

贡献与社区

本项目欢迎贡献：新连接器（如支持更多 CMS）、额外分析器、语言本地化，或对 AI 矩阵逻辑的改进。请参阅 CONTRIBUTING.md 了解设置说明，以及问题追踪器中的开放任务。

总结：Open SEO Advisor 是一个真正的、AI 增强的 SEO 工具包，可作为普通 CLI 运行，也可作为 AI 编码代理的技能使用。它专注于审计、修复建议和内容生成，而非提供全功能电商平台。