大部分 SEO 插件是写给人点鼠标的：后台一个输入框一个开关，一篇文章填四五个字段。站点内容上百条之后，这套流程的瓶颈不是功能不够，而是没有人愿意一条一条填。
这个插件的定位很简单：一套完整的 SEO 输出 + 一把 API Key，让人和 Agent 都能接管。下面只讲它跟同类插件不一样的地方。
特色一：一把 Key，Agent 直接接管全站 SEO
接口根地址 /wp-json/naigou-seo/v1，24 条接口路径 / 30 个动作，覆盖写值、批量写、体检、修复、预览、推送、日志全流程。
外部 AI 拿一把 Key（X-NGSEO-Key / X-Beebee-AI-Key / Bearer / query 四种传法任选）就能干活：
GET /targets 列出缺描述、低分的条目
POST /meta/bulk 一次批量写 100 条
POST /suggest 生成标题 / 描述建议
POST /audit/fix 按类型批量补齐
GET /preview 预览某条目最终输出的 head 与 JSON-LD关键在 GET /schema —— 插件会自描述：字段清单、取值范围、模板变量、全部端点一次性吐出来。Agent 不需要事先读文档，拉一次 schema 就知道能改什么、能填什么值。
统一的目标写法，让 Agent 不用记 WordPress 的复杂结构：
post:123 一篇文章 / 页面 / 任意文章类型
term:category:12 一个分类法词条
ctx:home 虚拟页面（home / search / 404 / author / date）
ctx:ptarchive:post 某类型归档页
ctx:pt_default:post 某类型所有条目的默认值
ctx:tax:category 某分类法所有词条的默认值特色二：零配置识别内容结构
启用后按站点实际注册的文章类型与分类法动态展开，排除 attachment / revision / post_format 这类内部结构。
也就是说：WordPress 原生文章页、WooCommerce 商品、bbPress 论坛帖、主题或插件注册的自定义类型，装完即用，没有一个「先选内容类型再配字段」的向导。编辑器里的 SEO 面板和 REST 接口按同样逻辑自动长出来。
换主题、加插件、注册了新的 post type —— 不用回来改配置。
特色三：四级回退 + 语义化赋值，覆盖不打架
优先级写死成一条链，什么时候生效一目了然：
① 单条内容自己的设置 postmeta / termmeta
② 类型默认 ctx:pt_default:{post_type}
③ 全局模板 settings.tpl[{模板键}]
④ 内置兜底 WordPress 原生标题 + 站点名赋值语义也做了区分，批量操作不会误伤：
- 传值 = 写入覆盖
- 传空串 = 删除该覆盖，回到上层
- 不传 = 保持不动
所以「改全局模板」不会悄悄改掉已发布内容里手填过的标题 —— 这是刻意的设计：已发布的东西不该被模板变更偷偷替换。
模板变量一整套可用：{title} {sitename} {tagline} {sep} {excerpt} {terms} {author} {year} {count} {search} {parent} {page} {type}。
特色四：head 全接管，但不改主题一个文件
<title>同时挂pre_get_document_title/document_title_parts/ 老式wp_title—— 主题声明了title-tag还是自己输出标题，都能接管- meta description / keywords、自指 canonical、
robots（index、follow、max-snippet、max-image-preview 全可调） - Open Graph 全套 +
article:published_time、Twitter Card（含summary_large_image） - JSON-LD 统一进一个
@graph：WebSite + Organization + WebPage + 内容实体 + BreadcrumbList，不是散落五段互不相识的 script
接管是排他的：启用后移除 WP 自带的 rel_canonical 与 wp_robots、停用核心 sitemap。同一时间只能有一个 SEO 插件管 head，这条底线插件自己在文档里写清楚了，不装作能共存。
特色五：sitemap 与 robots.txt 都做完了该做的细节
Sitemap：/sitemap.xml 索引 + 按类型分片，超上限自动 -2 -3；支持 image:loc、lastmod、changefreq、priority；尊重条目 noindex 与类型级开关；版本号 + transient 缓存，发布即失效。
robots.txt：追加模式（保留 WP 默认，末尾补自定义行与 Sitemap）和替换模式两选一；站点设成「不建议搜索引擎索引」时自动交回 WordPress，不抢方向盘。
特色六：重定向带一条「404 跳首页」的默认规则
301 / 302 / 307 / 308 / 410，精确匹配、前缀通配（/old/*）、正则（~^/tag/([0-9]+)/?$）都支持，404 日志按命中排序，一键把热门 404 变成重定向。
默认规则这条细节值得单说：访客打开不存在的页面时 301 回首页，但 CSS / JS / 图片等静态资源缺失时不跳，保持真 404。既不让外链和爬虫撞一堵墙，也不至于排查缺图时被自己的跳转骗过去。
特色七：收录推送不只是一个提交按钮
支持百度普通收录 API、神马接口推送、IndexNow（必应 / Yandex / Seznam / Naver 共用协议）。
- 新文章发布、已发布内容更新时自动推送；noindex 内容不推，同一篇 10 分钟内最多一次
- 后台单条推送 + 批量推最近内容
- 每个引擎的成功与失败原因都进日志，不是「提交成功」四个字了事
- IndexNow 的 key 验证文件
/{key}.txt由插件直接托管，不用碰服务器配置
特色八：体检评分会自己动手补
十项检查，每项 10 分：标题有无与长度、描述有无与长度、焦点词是否在标题/描述/首段、正文长度、配图、URL 别名。
分数低不是重点，重点是能一键补：单条自动补齐，或按内容类型批量补齐 —— 而且只补空缺，不覆盖已有值。
特色九：Lighthouse 预检 + 一键优化，改完立刻看到分数
服务端抓取任意地址，按 Lighthouse 四类口径（性能 / 无障碍 / 最佳实践 / SEO）跑 50 项启发式检查，给预估分和失分项。点「一键优化」：
- 按本次实际失分项批量开启对应开关，然后自动重测，前后分数直接对照
- 覆盖图片懒加载、补 width/height 防 CLS、首图
preload+fetchpriority、第三方域名preconnect、字体display=swap、非关键脚本defer、HTML 压缩、清 emoji/wp-embed/jQuery Migrate 等
这一段的技术前提是全走输出缓冲 + 标准钩子：不写 .htaccess、不写 nginx 配置、不改主题文件，关掉开关即恢复原样。LCP / CLS / TBT 这类必须真实浏览器渲染的指标，插件统一标成「需浏览器」且不计入分母 —— 给的是估算分，不和 PageSpeed Insights 抢权威。
和「装了就忘」型插件的区别
| 常见 SEO 插件 | 奶狗 · 全站 SEO | |
|---|---|---|
| 批量改 SEO 字段 | 后台手填，或买 Pro | 一把 Key + REST，Agent 直接写 |
| 新内容类型 | 要在设置里勾选启用 | 自动识别，零配置 |
| Agent 接入 | 无 | /schema 自描述 + 30 个动作 |
| 改主题文件 | 部分功能需要 | 全程钩子，零改动 |
| 停用后 | 数据可能残留成孤儿 | 值留在 meta/options，重启用原样回来 |
| 404 处理 | 只记录 | 记录 + 默认跳首页（静态资源豁免） |
| 性能优化 | 另一个插件的事 | 内置预检 + 一键优化 + 自动重测 |
插件只通过 WordPress 公开接口（钩子、函数、公开 meta）工作，不修改主题与任何其它插件的文件；自带后台样式，不拉 CDN、不引第三方库；离线自测 366 项，php -l 全绿。
适合谁
- 站点内容多、愿意让 AI 帮忙批量打理 SEO 的人
- 有自定义文章类型（商品、资源、论坛帖）却总被 SEO 插件漏掉的人
- 不想为了一个 meta 描述去装三个插件的人
