Yoast SEO Abilities：讓 AI 代理直接改 SEO 設定【2026】

你請 AI 工具檢查網站 SEO，它很快找出問題：有個連結還指向舊的測試站。以前，你還是得自己登入 WordPress 後台，一頁一頁改。

2026 年的 Yoast AI 新功能 Yoast SEO Abilities，讓 AI 代理可以直接動手，讀取並修改你 WordPress 文章的 SEO 欄位。

但能改哪些欄位、改錯了能不能復原，Yoast 幾份官方頁寫得不完全一樣，還有一個測試版正在路上。

這篇照日期，把每一份官方頁講的範圍分開整理，最後給企業主一套安全用法：先唯讀、再小範圍、留紀錄。

💡 讓 AI 代理改設定之前，先知道 AI 搜尋現在怎麼看你的網站。做一次免費 AI 可見度快篩。

重點摘要： Yoast SEO Abilities 讓 AI 工具透過 WordPress 6.9 的 Abilities API，讀寫單篇文章的 SEO 設定，讀取、更新、復原、批次都免費。但官方寫明，復原的前提是 AI 工具仍「holds the changed values in context」（Yoast 2026-09-29 公告, 2026）。對話一結束，舊值就跟著消失。

Yoast SEO Abilities 是什麼？建在 WordPress Abilities API 上的 AI 接口

Yoast SEO Abilities 是 Yoast 把 SEO 欄位登記到 WordPress Abilities API 上的整合，讓 AI 工具能讀取、更新單篇文章的 SEO 資料。Abilities API 則是 WordPress 6.9 推出的標準，讓外掛向外宣告自己能做哪些事（Yoast 開發者文件, 2026-10-20 讀取）。

提到 WordPress AI 外掛，很多人想到的是幫你寫文章的工具。Abilities 不是那一種。它不寫內文，而是讓 AI 去改 canonical、robots、Schema 這類技術設定。

Yoast SEO 本身的基本設定還不熟的話，先看 Yoast SEO 教學；WordPress 跟其他網站系統怎麼選，可以看 CMS 選擇指南。

說明 AI 工具經過標準接口與外掛，去調整網站設定的關係 圖說：AI 工具（對話泡泡）透過 WordPress 的標準接口（轉接頭）連到 Yoast（拼圖），再去調整文章的 SEO 設定（開關）。

WordPress Abilities API 怎麼運作

依 Yoast 開發者文件的說明，Abilities API 由四個部分組成：

組成	做什麼	白話比喻
登記處（registry）	外掛登記自己能做的事，附上結構化的輸入、輸出格式	餐廳的菜單
查詢端點 `/wp-json/wp-abilities/v1/abilities`	任何工具都能列出網站上有哪些能力	翻菜單
執行端點 `/run`	呼叫某一項已登記的能力	點餐窗口
權限檢查	每一項能力都檢查呼叫的人有沒有權限	店員確認你是會員

WordPress 6.9 自己就內建 3 項預設能力：core/get-site-info、core/get-user-info、core/get-environment-info（WordPress 開發者部落格, 2026）。Yoast 做的事，就是把 SEO 相關的能力也登記上去。

WordPress MCP 是什麼

MCP（Model Context Protocol）是一套讓 AI 工具取得外部資料、呼叫外部功能的協定。WordPress MCP Adapter 是「AI Building Blocks for WordPress」計畫的官方套件，負責把 Abilities 轉成 AI 工具可以呼叫的 MCP 工具。

WordPress 開發者部落格舉的例子是，它讓 AI 工具「like Claude Desktop, Claude Code, Cursor, and VS Code」發現並呼叫 WordPress 的能力。Yoast 整合頁的說法更寬：「this works with any MCP-compatible AI client, not just ones Yoast has built a special connection for.」

給工程師的兩個細節：

MCP Adapter 裝好後，會註冊一個預設伺服器 mcp-adapter-default-server，以及 discover-abilities、get-ability-info、execute-ability 三項能力
能力要標上 meta.mcp.public，才會出現在預設伺服器裡

寫這篇時，我們讀了 Yoast 的兩份公告、一份設定教學、一份整合頁、一份開發者文件，加上 WordPress 開發者部落格與 GitHub 上的兩份版本紀錄。讀完發現，每一份講的能力範圍都不一樣，差異跟發布日期有關。所以下面照日期分段，各寫各的原文範圍，不把它們合併成一個結論。

2026 年 4 月初版：AI 只能看 3 種分數

2026-04-28，Yoast 推出連接 WordPress Abilities API 的 connector，原文說它「built to work hand in hand with WordPress 6.9」（Yoast 2026-04-28 公告, 2026）。這一版的 AI 工具只能讀，不能改。

4 月這份公告，列出 AI 工具可以從最近的文章讀到這些：

「SEO scores and focus keyphrases」
「Readability scores」
「Inclusive language scores」

到了 9 月 29 日的公告，Yoast 回顧 4 月版本時是這樣寫的：「Since its release in April, Yoast SEO already registers three abilities with WordPress’s Abilities API: SEO scores, readability scores, and inclusive language scores for your most recently modified posts.」

有沒有發現？4 月的公告寫了 focus keyphrases，9 月的回顧只寫 3 種分數。兩份都是官方原文，這裡照錄，不判斷哪一份對。

9 月的回顧也講了 4 月版的限制：AI 工具當時「had no standardized way to read the underlying fields or change them」。也就是說，AI 看得到分數，但看不到分數背後的欄位，更不能修改。

現在的開發者文件，仍然把這 3 項分數能力標為唯讀。白話講，這個階段的 AI 只能看成績單，不能動手改作業。

9 月更新與 28.7 正式版：AI 可以讀、也可以改哪些欄位

2026-09-29 的 Yoast 公告，讓 AI 工具第一次可以修改 SEO 欄位：canonical、robots flags、cornerstone、schema type 四項技術設定（Yoast 2026-09-29 公告, 2026）。標題與描述可以改，則是 2026-10-13 的 28.7 正式版才寫進版本紀錄。

2026-09-29 公告：新增讀取與 4 項可寫欄位

這份公告加了三樣東西：

讀取能力 yoast-seo/get-post-seo-data：回傳 title、meta description、robots flags、schema type、canonical、social previews 與分數；可以用文章 ID、永久連結或標題搜尋找到文章
可寫欄位：原文是「Core technical settings are now writable from your AI tool: canonical, robots flags, cornerstone, and schema type.」
批次操作：get、update、filter 可以一次套用到多篇文章，逐篇回傳結果

請注意，9/29 這份可寫清單只有 4 項技術欄位，沒有列標題與描述。

焦點關鍵字則刻意鎖住。原文：「Your focus keyphrase stays read-only. You always set it yourself, and it is never generated for you.」官方的理由是，自動改掉它「could invalidate content briefs or marketing workflows」，還會讓之後所有的分析都跟著失準。

2026-10-13 的 28.7 正式版：加入標題與描述

Yoast SEO 28.7 的版本紀錄標示「Release date: 2026-10-13」，Enhancements 只有一條：「Allows agents to update titles and descriptions via the respective Yoast Ability.」（GitHub：Yoast SEO 28.7, 2026）

我們在 2026-10-20 讀取 GitHub 公開 API，28.7 標為正式版（prerelease=false），發佈時間是 2026-10-13，也是當天為止最新的正式版。

設定教學頁現在列的完整清單

2026-10-20 讀取的 Yoast 設定教學頁，列了 11 項 AI 可以更新的欄位，並寫明「The update Ability only changes the fields you provide. Other SEO data remains unchanged.」只會改你指定的欄位，其他不動。

把三份文件並排看，差別就很清楚了。下表每一欄只填該份文件自己列出的範圍：

欄位	2026-09-29 公告	28.7 版本紀錄（2026-10-13）	設定教學頁（2026-10-20 讀取）
Canonical URL	列為可寫	—	列為可更新
Robots 設定（noindex、nofollow 等）	列為可寫	—	列為可更新
Cornerstone content	列為可寫	—	列為可更新
Schema 類型	列為可寫（schema type）	—	列為可更新（Schema page type、Schema article type）
SEO title、Meta description	沒有列在可寫清單	原文寫 titles and descriptions	列為可更新
Open Graph title、description	沒有列在可寫清單	原文寫 titles and descriptions	列為可更新
X/Twitter title、description	沒有列在可寫清單	原文寫 titles and descriptions	列為可更新
焦點關鍵字	唯讀	—	讀取清單有，更新清單沒有

表中的破折號，代表那份版本紀錄只講新增的部分，這一列不在它的範圍內。Schema 類型怎麼選、各代表什麼，可以看 Schema 結構化資料指南。

所以，不是 9 月起就能改標題。依官方文件，標題與描述可寫，是在 28.7 才出現。

整合頁的說法又是另一種寫法：可以改「canonical URL, robots flags, cornerstone status, and schema type. You can also update titles and descriptions, including for social previews. Your focus keyphrase stays read-only.」

開發者文件的分法：3 項唯讀分數＋2 項單篇 SEO 資料

開發者文件並不是說只有 3 項唯讀能力。它的分法是兩組：

3 項唯讀的 Analysis scores：最近修改文章的 SEO、可讀性、包容性用語分數
2 項 Post's SEO data：一項讀取單篇 SEO 資料，一項更新單篇 SEO 資料

這些能力都可以在 /wp-json/wp-abilities/v1/abilities?category=yoast-seo 查到。每一項能力也會宣告三種行為標註：Read-only（唯讀）、Destructive（可能具破壞性）、Idempotent（重複呼叫不會多改）。

說明有些欄位只能讀、有些可以改、焦點關鍵字被鎖住 圖說：眼鏡代表只能讀的欄位，鉛筆代表可以改的欄位，被鎖住的那一張是焦點關鍵字。

28.8 測試版新增的開關類能力（測試版，正式版未發布）

以下是 Yoast SEO 28.8 RC 測試版的內容，截至 2026-10-21 正式版尚未發布，正式版內容可能不同。28.8-RC1 在 GitHub 標為 prerelease，發佈時間 2026-10-13（GitHub：Yoast SEO 28.8-RC1, 2026）。

RC1 的版本紀錄新增了 7 類能力，讓 AI 代理可以：

開關 llms.txt 功能
開關 XML sitemaps 功能
開關 Open Graph data 功能
開關 X card data 功能
開關 Schema Framework 功能
開關 Schema Aggregator 功能
更新 Site representation 設定

這是一個方向上的轉變。正式版的能力都是改單篇文章；RC1 這幾項是整站功能的開關，影響的範圍從一篇變成整個網站。

llms.txt 和 XML Sitemap 被 AI 一鍵關掉之前，最好先弄懂它們在做什麼：可以看 llms.txt 設定指南與 Sitemap SEO 指南。

RC1 另外還有兩點：

Yoast WooCommerce SEO 的 WooCommerce 商品圖 AI alt text 生成，bulk editor 新增 Image alt text 分頁
原文「Sets the minimum supported WordPress version to 7.0.」也就是 RC1 把最低支援的 WordPress 版本設為 7.0

我們在 2026-10-21 讀取 GitHub 公開 API，28.8-RC2（2026-10-16）與 RC3（2026-10-19）只有 Non user facing 項目；RC4（2026-10-20）修了兩個錯誤：schema 彙整端點從 Site features 頁存設定時，啟用時間沒有被記下來；存 Yoast SEO 設定後，AI 功能的免費試用被誤當成已經開始（GitHub：Yoast SEO 28.8-RC4）。三版都沒有新增或移除能力。

怎麼設定 Yoast SEO Abilities？官方步驟與權限需求

設定 Yoast SEO Abilities 需要三樣東西：啟用 Yoast SEO 的 WordPress 網站、支援 WordPress Abilities API 與 MCP 的 AI 工具，以及足夠的帳號權限（Yoast 說明：How to set up and use Yoast SEO Abilities, 2026-10-20 讀取）。開發者文件另外列了兩個前置條件。

需求	出處
WordPress 網站已安裝並啟用 Yoast SEO	設定教學頁
支援 WordPress Abilities API 與 MCP 的 AI 工具	設定教學頁
帳號要能進進階 SEO 設定、能編輯要處理的文章	設定教學頁
WordPress 6.9 以上	開發者文件
Indexables 已啟用並完整建立	開發者文件

還有一步要看清楚。9/29 公告寫的是「Connect your own LLM subscription to Yoast first.」也就是先把你自己的 LLM 訂閱接到 Yoast；接好之後，到 Yoast SEO → Integrations，找新的 AI & agentic 分組。整合頁的介紹則寫「using your own LLM」。

設定教學頁的需求清單，是從網站、AI 工具、權限三項講起。要不要先接 LLM 訂閱，請以你外掛後台的實際畫面為準。

官方的 4 個連線步驟

設定教學頁先講明「The exact steps depend on the AI tool you’re using.」每個 AI 工具的畫面不同，大方向是這 4 步：

步驟	官方說明	白話
1	打開 AI 工具的連線設定，找新增 connection、plugin 或 MCP server 的選項	去 AI 工具的設定頁，找新增連線的地方
2	加入你的 WordPress 網站，可能需要網址與授權	告訴 AI 工具你的網站在哪
3	依提示授權連線	同意讓 AI 工具動你的網站
4	開新對話，請 AI 確認已連上網站	問它一句有沒有連上，確認成功

第 4 步的官方範例，是用 ChatGPT 問它有沒有連上某個網站。

不會寫程式能自己設定嗎？整合頁 FAQ 的回答是「No, but connecting an AI tool can be a technical step or have technical implications, so you or a developer on your team will likely handle it.」不必是開發者，但多半要有技術背景的人處理。

WordPress MCP Adapter 的兩種連線方式

這段是給工程師的重點。依 WordPress 開發者部落格，連線方式看網站在哪裡：

方式	適用	需要準備
STDIO	本機的 WordPress 開發環境	本機裝好 WP-CLI
HTTP	公開上線的 WordPress 網站	透過 `@automattic/mcp-wordpress-remote` 代理，本機要有 Node.js；驗證用 WordPress application passwords 或自訂 OAuth

文章作者在 2026-02-12 的留言回覆裡另外寫到，自架站目前「isn’t an available OAuth solution, so you’re reliant on JWT Tokens or Application Passwords」。

權限：兩份官方頁的寫法

權限的部分，Yoast 兩份頁面的措辭不一樣，照錄如下：

官方頁	原文
Abilities 整合頁	「By default, only users with admin-level access to your Yoast SEO settings can use these abilities.」
設定教學頁	「users need the appropriate advanced metadata capability, and access is further restricted to posts they are allowed to edit.」

9/29 公告則寫「Access follows native WordPress capability checks. There is no separate permission system to learn.」權限沿用 WordPress 本身的帳號權限，沒有另一套。

實際哪些帳號能用，請在你自己的網站上確認。設定教學頁也提醒：「Make sure you understand what permissions you’re granting before you approve the connection.」

這句提醒我們很有感。2026-09 我們讀過開源工具 claude-seo 的原始碼並評估，結論是不安裝：它會在 Claude Code 裡新增大量技能與代理，每次寫檔都觸發檢查。授權之前先弄清楚工具會拿到什麼、會做什麼，比裝完再拆省事得多。其他 SEO／GEO 開源工具的盤點，寫在開源 SEO／GEO 工具整理。

權限、帳號、復原流程不確定怎麼規劃？

讓 AI 代理動網站之前，帳號要開多大的權限、改之前要留哪些紀錄，最好先想清楚。AI SEO Hacker 的 WordPress 站 SEO 健檢諮詢，可以幫你先把關。

👉 LINE 免費諮詢：@006ljkda

風險與復原：官方說可以復原的前提是什麼

Yoast 官方說，透過 Abilities API 做的修改可以復原，但前提是 AI 工具仍「holds the changed values in context」，也就是 AI 還記得改之前的值（Yoast 2026-09-29 公告, 2026）。對話一結束，舊值就跟著消失。

這段原文很重要，完整照錄：

「Any change made through the WordPress Abilities API can be rolled back, as long as your AI tool holds the changed values in context. In practice, read a post’s SEO data before you update it. Then stay in that session while you review the result. Once the context is gone, the previous value goes with it, so treat the read call as part of the write.」

翻成白話是三句話：

改之前，先讓 AI 讀出這篇文章原本的 SEO 資料
檢查修改結果時，留在同一個對話裡，不要關掉
對話的上下文一消失，原本的值也就找不回來

整合頁的標語寫「Always reversible」與「Undo any change while in context」，這兩句要跟上面那段一起讀。「while in context」就是那個前提。

開發者文件還有一個細節。行為標註裡的 Destructive 欄位如果是 null，原文是「When null, the ability makes no claim either way, so a client should treat it as potentially destructive.」沒有標明的，就當作可能具破壞性。

28.8 測試版的整站開關，風險又更大一層。這是我們依能力範圍做的推論：改錯一篇文章的 canonical，影響的是一頁；關掉整站的 XML sitemaps 或 Schema 功能，影響的是整個網站。

WordPress 官方的安全建議也值得照做，原文三句：

「Use dedicated users for MCP access」：MCP 連線用專用帳號，正式站建立權限受限的專用角色
「Prefer read-only abilities for public MCP endpoints」：公開的連線端點，優先只開唯讀能力
「start small. Begin by exposing a few non-destructive, read-only abilities」：從少數不具破壞性的唯讀能力開始

對照一下手動的做法：單篇 noindex 原本是在文章編輯器的 Advanced 分頁設定，步驟寫在 Yoast SEO 設定教學的 noindex 段落。手動改，你看得到改之前的畫面；讓 AI 改，就要靠紀錄。

企業主該怎麼用 Yoast AI？先唯讀、再小範圍、留紀錄

我們建議企業主分三步用 Yoast SEO Abilities：先只讓 AI 讀資料，再挑幾篇小範圍修改，每次修改都另外留紀錄。這是本站建議，不是 Yoast 官方規定；依據是官方寫明的復原前提：AI 要在上下文裡記得舊值（Yoast 2026-09-29 公告, 2026）。

第一步：先唯讀，讓 AI 出報告

先只讓 AI 讀分數與欄位。開發者文件的官方範例裡，就有這類只讀不改的請求：請 AI 看最近文章的 SEO 分數有什麼規律、查某個網址的文章是不是設為可被索引。

這一步完全不改網站，就能先找出問題頁。

第二步：小範圍，一次改幾篇

確定 AI 讀得正確，再挑幾篇測試修改，例如 canonical 或 noindex。每次改之前，先請 AI 讀出原本的值；改完後，留在同一個對話裡檢查結果。

開發者文件有一個批次範例，請 AI 找出某個主題的所有文章，再把其中沒有自訂 SEO 標題的全部設成 noindex。這類請求一次影響很多頁，風險最高。我們建議先在測試站試過，再用在正式站。

第三步：留紀錄，不要只靠對話記憶

官方的復原靠的是對話記憶，而對話記憶不是備份。所以每次修改，都把 AI 讀到的原始值和修改後的值，另外存一份到你自己的文件或試算表。

改完之後，到 Google Search Console 確認那些頁面的索引狀態，做法在 Google Search Console 教學；改完要檢查哪些技術項目，可以對照技術 SEO 檢查清單。

帳號的部分，不要直接把你自己的管理員帳號交給 AI 工具。開一個專用帳號，給到 Yoast 要求的權限就好，不要多給。

想知道除了 Yoast 之外還有哪些 AI SEO 工具，可以看 AI SEO 工具整理。

說明讓 AI 代理改設定時要留下紀錄 圖說：每次讓 AI 改設定，都記下改了什麼、什麼時候改的，出錯時才找得回原本的值。

常見問題 FAQ

Yoast SEO Abilities 要付費嗎？

Yoast 整合頁 FAQ 寫明免費：讀取、核心 SEO 欄位更新、復原與批次操作，都包含在 Yoast SEO 裡，不另收費。不過 2026-09-29 公告寫到，要先把你自己的 LLM 訂閱接到 Yoast，LLM 訂閱的費用則依各 AI 服務而定。

AI 會改我的焦點關鍵字嗎？

不會。2026-09-29 公告與整合頁都寫明，焦點關鍵字對 AI 工具是唯讀的，一律由你自己設定，不會自動產生。官方的理由是，自動改掉焦點關鍵字可能打亂內容規劃，也會讓後續所有的分析失準。

AI 改錯了能復原嗎？

可以，但有前提。官方寫明，只有 AI 工具還在上下文裡記得修改前的值，才能復原。做法是改之前先讀出原始資料，檢查結果時留在同一個對話；對話一結束，舊值就跟著消失。建議另外存一份修改紀錄。

哪些 AI 工具可以用 Yoast AI 的 Abilities？

Yoast 整合頁寫的是任何支援 MCP 的 AI client 都可以，不限 Yoast 特別串接的那幾個。官方舉過的例子有 Claude Desktop、Claude Code、Cursor、VS Code，設定教學頁的範例則用 ChatGPT。實際能不能連，以各 AI 工具自己的說明為準。

Yoast SEO Abilities 需要哪個 WordPress 版本？

Yoast 開發者文件寫的前置條件是 WordPress 6.9 以上，而且 Indexables 要啟用並完整建立。另外，28.8-RC1 測試版把最低支援版本設為 WordPress 7.0；截至 2026-10-21，28.8 正式版尚未發布，正式版的版本要求以發布當時的官方說明為準。

Yoast SEO Abilities 上手前，先確認這 4 件事

Yoast SEO Abilities 的讀取、更新、復原與批次功能都免費（Yoast Abilities 整合頁, 2026-10-20 讀取），門檻不在價格，而在設定與權限。開始之前，先確認這 4 件事：

版本：WordPress 6.9 以上、Indexables 已建立；正在用的是正式版還是測試版
帳號：AI 工具用的是專用帳號，權限只給到需要的範圍
範圍：先只開讀取，確定 AI 讀得正確再改
紀錄：每次修改都另存原始值與修改後的值

AI 能幫你改欄位，但要改哪一頁、為什麼改，還是要有人判斷。

🎯 AI 能改欄位，判斷還是要有人做

改什麼、為什麼改、改完怎麼驗收，都需要對 SEO 與 GEO 的整體判斷。AI SEO Hacker 可以幫你顧好網站的 SEO 與 GEO，從技術設定到內容規劃，LINE 聊聊你的網站狀況。

👉 LINE 免費諮詢：@006ljkda｜填寫需求表單