虎鯨網站助理是一套用來管理 WordPress 的全域 CLI 工具，安裝完成後，在終端機的任何資料夾都能直接使用 orca-wp。你不需要切換到專案目錄，也不用在指令前面輸入 python。
這篇不是教你從零開發程式，而是給已取得虎鯨網站助理的使用者看的操作手冊。從安裝執行檔、連接 WordPress，到文章、圖片、SEO、分類、標籤與快取管理，我會用日常工作最常碰到的順序帶你走一次。
先記住一件事：虎鯨網站助理的指令就是
orca-wp。它已經封裝成全域 CLI，不再使用舊版的原始碼啟動方式。
虎鯨網站助理可以幫你做什麼？
它把 WordPress 後台常見操作整理成可以重複執行、也能讀回驗證的命令。你可以自己在終端機操作，也可以讓 Codex、Claude Code 等 AI Agent 透過「虎鯨網站助理」Skill 使用。
| 工作類型 | 可處理內容 | 適合情境 |
|---|---|---|
| 文章與頁面 | 查詢、新增草稿、更新、發布 | SEO 寫文、舊文維護、批次整理 |
| 分類與標籤 | 新增、修改、匯出與整理描述 | 內容架構與站內主題管理 |
| 媒體與封面 | 上傳圖片、查媒體、指定精選圖片 | 文章封面與產品圖片 |
| SEO 與 Schema | SEO 標題、描述、焦點關鍵字、FAQ | Rank Math 與結構化資料 |
| 多站台 | 同一台電腦管理多個 WordPress | 品牌、客戶與多語網站 |
| 快取與維護 | Elementor、WP Rocket、Cloudflare、Redis | 更新後前台仍看到舊內容 |
部分進階功能需要站台安裝對應的虎鯨外掛或開通模組。若指令顯示缺少外掛或版本不符，先不要自行安裝來路不明的套件，可以聯絡 [email protected] 確認。
為什麼虎鯨網站助理沒有先選擇 WordPress MCP？
不是 MCP 不好，而是 MCP 本身只是 AI 與工具溝通的協定。WordPress 端實際能讓 AI 做多少事，仍取決於站台註冊了哪些 Abilities，以及外掛有沒有把這些能力開放給 MCP。
WordPress 的 Abilities API 已進入核心，官方的 MCP Adapter 可以把已註冊的 Ability 轉成 MCP 工具。不過官方文件也寫得很清楚：Ability 必須先由核心、外掛或佈景主題註冊，並設定為可透過 MCP 使用，AI 才能發現與執行。WordPress 7.0 增加了用戶端 Abilities API，但這不代表所有後台操作會自動變成完整的 MCP 工具。
換句話說，核心架構已經有了，實際操作覆蓋率仍要靠各外掛繼續補。一般文章讀寫可能比較容易串接，但 Rank Math SEO、FAQ Schema、WPML、多媒體、Elementor、快取、GSC 與虎鯨自有外掛設定，不一定會在每個 WordPress MCP Server 裡提供相同工具。
| 比較 | 直接使用 WordPress MCP | 虎鯨網站助理 CLI |
|---|---|---|
| 能力來源 | 取決於已註冊並公開的 Abilities | 已封裝 WordPress REST API 與虎鯨模組 |
| 目前覆蓋範圍 | 不同站台與 MCP Server 差異較大 | 每個命令、參數與需求版本都能明確查詢 |
| 錯誤排除 | 要同時檢查 MCP、Ability、權限與外掛 | 可直接在終端執行並看到 HTTP 與站台診斷 |
| 批次與多站 | 要看 Server 是否另外實作 | 使用固定命令與 --site 管理 |
| 未來整合 | 適合做 AI 的標準連接層 | 可作為底層穩定操作介面，再由 MCP 呼叫 |
我們目前的選擇是「先把 WordPress 操作做完整，再接 MCP」，不是排斥 MCP。等站台 Abilities 與外掛支援更齊全，MCP 很適合成為 AI Agent 的標準入口；現在先用全域 CLI，使用者會比較容易判斷指令做了什麼、操作哪個網站，以及結果是否真的寫入。
開始前要準備什麼？
- 虎鯨提供的 macOS 執行檔，並確認是 Apple Silicon 或 Intel 版本。
- WordPress 網址、使用者名稱與 Application Password。
- 該帳號具備工作所需權限；日常寫文不一定要使用最高管理員。
- 知道這個站台在工具中的簡短名稱，例如
myblog。
Application Password 是 WordPress 專門提供給外部工具的獨立憑證，不是你的後台登入密碼。還不熟悉設定方式，可以先看WordPress Application Password 完整教學。
步驟一：安裝全域 orca-wp 指令
下面以 Apple Silicon 版本為例。實際檔名會隨版本更新，如果你拿到的是 Intel 版，請把檔名換成對應的 x86_64 檔案。
chmod +x ~/Downloads/orca-wp-1.2.1-macos-arm64
sudo mv ~/Downloads/orca-wp-1.2.1-macos-arm64 /usr/local/bin/orca-wp
orca-wp --help看到指令列表就代表安裝完成。因為已經放到系統的執行路徑，之後不管終端機目前在哪個資料夾，都直接輸入 orca-wp，不必先 cd 到工具目錄。
出現 command not found 怎麼辦？
which orca-wp
echo $PATH如果 which orca-wp 沒有顯示路徑，通常是檔案尚未移到 /usr/local/bin，或這個目錄不在目前的 PATH。先確認檔案位置，不要重複安裝多份。
步驟二：在 WordPress 建立 Application Password
- 登入 WordPress 後台。
- 進入「使用者 → 個人資料」。
- 找到「應用程式密碼」。
- 名稱可以填「虎鯨網站助理」。
- 新增後先留在這個畫面，密碼只會完整顯示一次。
首次輸入憑證建議由你本人在本機終端完成。不要把 Application Password 貼進 AI 對話、文章草稿、Skill 或截圖裡。
步驟三：把 WordPress 站台加入虎鯨網站助理
orca-wp site add myblogmyblog 是你自己取的站台代號。接著依畫面輸入網站網址、使用者名稱與 Application Password。設定會儲存在本機的 ~/.config/orca-wp/config.json，不在文章資料夾或網站程式碼裡。
orca-wp site list
orca-wp check-connection --site myblog
orca-wp site-info --site myblogcheck-connection 會檢查 REST API、文章讀取、內容權限與站台設定。這一步通過後再開始寫入，不要只看到站台出現在清單就當成連線完成。
日常使用：先查詢，再修改
虎鯨網站助理的操作原則很簡單：先確認目標，再寫入；寫入後，再讀回。尤其同時管理多個網站時，每一條命令都建議加上 --site，不要只依賴目前啟用的站台。
查看文章
orca-wp list --site myblog
orca-wp list --status draft --per-page 20 --site myblog
orca-wp get 123 --site myblog
orca-wp get --slug "article-slug" --site myblog建立草稿與發布
orca-wp new \
--title "文章標題" \
--slug "english-slug" \
--excerpt "文章摘要" \
--content "<!-- wp:paragraph --><p>文章內容</p><!-- /wp:paragraph -->" \
--status draft \
--site myblog
orca-wp publish 123 --site myblog預設先建立草稿。確認標題、英文網址、分類、封面與前台預覽後，再執行 publish。如果文章由 AI 產生，內容應使用 Gutenberg 區塊格式，不要直接貼一大段 Markdown。
分類、標籤、封面與 SEO
orca-wp categories --site myblog
orca-wp tags --site myblog
orca-wp upload ~/Desktop/cover.jpg --site myblog
orca-wp set-featured-image 123 456 --site myblog
orca-wp update-seo 123 \
--title "SEO 標題" \
--desc "Meta Description" \
--keywords "主要關鍵字,次要關鍵字" \
--site myblog媒體上傳成功，不代表已經套用成精選圖片。123 是文章 ID，456 是媒體 ID，設定後仍要讀回文章或打開前台確認封面。
更新後前台還是舊內容
orca-wp flush-wp-rocket --post-id 123 --site myblog
orca-wp flush-elementor-cache --site myblog
orca-wp flush-cloudflare --site myblog快取要在確認 WordPress 已經存入新內容後才清。若後台根本沒有更新成功，反覆清快取也不會解決問題。
搭配 AI Skill 的推薦工作流程
Skill 已加入「虎鯨網站助理」這個產品詞。之後不必要求 AI 臨時寫 REST API 程式，可以直接用產品名稱交代任務：
請使用虎鯨網站助理操作
myblog。先搜尋是否已有相同主題，建立 Gutenberg 草稿，設定英文 slug、摘要、既有分類、標籤、封面與 Rank Math SEO。完成後讀回文章 ID、狀態和精選圖片，開啟前台預覽；沒有我的確認，不要公開發布。
- AI 先讀站台與既有文章，避免重複內容。
- SEO Skill 處理搜尋意圖、文章結構與內部連結。
- 去 AI 味與個人風格 Skill 完成文字整理。
- 虎鯨網站助理建立 WordPress 草稿並寫入欄位。
- 讀回文章、SEO、Schema 與封面設定。
- 用瀏覽器檢查桌機和手機畫面。
- 你確認後，才執行公開發布。
如果你想看純瀏覽器操作的版本，可以搭配Codex Computer Use 操作 WordPress 教學；想理解 MCP、REST API 與 AI Agent 的分工，可以閱讀WordPress MCP 目前支援哪些操作。
使用虎鯨網站助理要注意的安全原則
- 憑證自己輸入：Application Password 不貼進 AI 對話。
- 明確指定站台：多站環境一律使用
--site myblog。 - 草稿優先：新增文章預設用
--status draft。 - 批次操作先預覽：支援
--dry-run的功能先模擬，再正式執行。 - 刪除與取代要確認：看到
--yes通常代表這是不能隨便執行的動作。 - 成功訊息不是前台驗收：寫入後仍要讀回資料並檢查公開網址。
設定檔保存在你的電腦上，但仍應限制檔案權限：
chmod 600 ~/.config/orca-wp/config.json常見錯誤怎麼排除？
| 狀況 | 常見原因 | 處理方式 |
|---|---|---|
command not found | 執行檔不在 PATH | 用 which orca-wp 確認位置 |
| 401 或 403 | 帳號、Application Password、權限或防火牆限制 | 重新確認憑證並執行 check-connection |
| Cloudflare 522 | 來源主機暫時無回應 | 稍後重試並確認主機狀態，不要連續寫入 |
| 提示缺少外掛 | 進階功能尚未開通 | 依提示確認所需版本或聯絡虎鯨 |
| 後台已更新、前台沒變 | 頁面或 CDN 快取 | 確認資料已寫入後，再清除對應快取 |
給第一次使用者的建議
第一次不要直接拿正式文章做批次修改。先用測試草稿跑過「連線、建立、讀回、設定封面、預覽」這五件事，確定站台權限與快取流程都正常，再逐步增加 SEO、Schema、多語或 WooCommerce 操作。
虎鯨網站助理的價值，不只是少點幾次 WordPress 後台，而是把每次操作變成可以重複、可以檢查，也能交給 AI Skill 執行的工作流程。你仍然保留最後發布與高風險操作的決定權。
常見問題 FAQ
既然 WordPress 有 MCP，為什麼還需要虎鯨網站助理？
MCP 要執行的能力仍需由 WordPress 核心或外掛先註冊並公開。目前不同站台的支援範圍不一致，SEO、WPML、Elementor、快取與虎鯨模組未必都有現成 MCP 工具。虎鯨網站助理先把這些操作封裝成可驗證的 CLI，未來也能再由 MCP 作為連接層呼叫。
虎鯨網站助理需要會 Python 嗎？
不需要。工具已封裝成全域 CLI，安裝後直接使用 orca-wp。一般使用者不必進入原始碼目錄，也不需要在指令前輸入 Python。
為什麼每一條命令都建議加上 --site？
虎鯨網站助理可以管理多個 WordPress。明確指定站台能避免 AI、多個終端機或並行任務誤用目前啟用的站台，尤其更新與發布時更重要。
Application Password 會被送到 AI 嗎？
工具從本機設定檔讀取憑證，不代表憑證會自動送進 AI 對話。但 AI 工具可能取得命令或工作目錄等上下文，因此首次註冊站台與輸入密碼仍建議由使用者在本機終端完成。
可以讓 AI 寫完直接發布嗎？
可以做到，但不建議作為預設。先建立草稿、讀回欄位、檢查封面與前台版面，再由使用者確認發布，比完全自動公開更穩妥。
為什麼有些指令會提示缺少外掛？
文章與 WordPress 核心功能可直接使用 REST API；SEO、Schema、WPML、GSC 或特定 WooCommerce 功能可能需要對應外掛與版本。CLI 會提示需求，部分模組只提供虎鯨客戶安裝或開通。
虎鯨網站助理可以管理多個網站嗎？
可以。每個網站使用不同站台代號，透過 orca-wp site list 查看，再在命令後加上 --site 站台代號 明確指定目標。
