zhtyyx/codex-seo

选用指南

AI 根据 README 整理 · 2026/10/28 15:01:28

使用方式

在 Codex CLI 中使用 `$seo` 命令调用，例如 `$seo audit <url>` 进行全站审计。

查看 README 依据

git clone --depth 1 https://github.com/zhtyyx/codex-seo.git bash codex-seo/install.sh ``` Windows（PowerShell）： ```powershell git clone --depth 1 https://github.com/zhtyyx/codex-seo.git powershell -ExecutionPolicy Bypass -File codex-seo\install.ps1 ``` 安装器会把技能复制到 `~/.agents/skills/`（Codex 从这里发现用户技能），并创建带无头浏览器的隔离 Python 运行时。不碰系统全局环境，卸载用 `bash uninstall.sh`。 **第一次审计：** ```bash codex # 启动 Codex CLI $seo audit https://example.com # 全站审计，输出按优先级排好的行动计划 $seo page https://example.com/pricing # 单页深度分析

$seo geo https://example.com # AI 搜索就绪度 $seo schema https://example.com # 检测并生成结构化数据 ``` ## 命令 在 Codex CLI 里用 `$` 提及技能即可调用，例如 `$seo audit https://example.com`（自然语言说「帮我做一次 SEO 审计，网址是 …」也可以）。主要命令组： <details> <summary><b>审计与规划</b></summary> <ul><li><code>$seo setup</code>：创建或刷新隔离 Python 运行时和 Chromium</li><li><code>$seo doctor</code>：只读体检，不改动系统</li><li><code>$seo audit &lt;url&gt;</code>：全站审计，全部专家角色</li><li><code>$seo page &lt;url&gt;</code>：单页深度分析</li><li><code>$seo plan &lt;type&gt;</code>：按行业做战略规划（saas、local、ecommerce、publisher、agency）</li></ul> </details> <details>

部署要求

需要支持 skills 的 OpenAI Codex CLI 和 Python 3.11 到 3.14。

查看 README 依据

给它任何一个网站，它会跑一次完整的 SEO 审计，然后交给你一份按优先级排好序的行动计划。它检查的内容和一个合格的 SEO 顾问一样： - **技术 SEO**：可抓取性、收录、sitemap、robots.txt、重定向、页面速度和 Core Web Vitals - **内容质量**：E-E-A-T（经验、专业、权威、可信）、薄页面、主题覆盖 - **结构化数据**：发现、校验并生成 Schema.org 标记 - **AI 搜索（GEO）**：你的页面被 Google AI Overviews、AI Mode、ChatGPT、Perplexity、Gemini 引用的可能性 - **本地与电商 SEO**：Google Business Profile、评价、地图包、商品页和多语言站点 Codex SEO 由 26 个子技能和 19 个专家角色剧本组成。一次完整审计会依次走过每个分析角色（技术、内容、结构化数据、速度、AI 搜索等），每个角色的发现都会落盘留证。每条建议都会说明它为什么重要、你怎么验证它生效。 ## 安装 需要带 skills 支持的 [OpenAI Codex CLI](https://developers.openai.com/codex)，以及 Python 3.11 到 3.14。 ```bash

已知限制

没有 Google API key 时，Core Web Vitals 为实验估算，收录状态由页面推断；关键内容靠滚动或点击加载的页面结果可能有噪音。

查看 README 依据

<summary><b>数据会离开我的电脑吗？</b></summary> Codex SEO 跑在 Codex CLI 里，被分析的页面和数据会发送给你 Codex 会话背后的 OpenAI 模型，和你在 Codex 里做的其他事一样。报告以文件形式保存在你本机。除非你自己接入扩展或 API，没有任何 SEO 服务或第三方看到你的数据。除被审计网站外，部分检查会读取 Wikipedia、Reddit、Common Crawl 等公开来源。完整清单见 [PRIVACY.md](PRIVACY.md)。 </details> <details> <summary><b>须知：要求、边界与卸载</b></summary> **要求**：OpenAI Codex CLI 与 Python 3.11 到 3.14，`$seo setup` 会装无头浏览器。 **全站审计的成本**：`$seo audit` 在主会话里跑 17 个角色，token 消耗高于单页检查，用的是你 Codex 会话配置的模型。 **边界**：没有 Google API key 时，Core Web Vitals 是实验估算、收录状态由页面推断。关键内容靠滚动或点击才加载的页面，结果可能有噪音。 **卸载**：`bash uninstall.sh` 移除技能。 </details>