用 Claude Code 自動化 WooCommerce：庫存警示、商品描述生成、批次更新（2026）

管理 WooCommerce 有一件事很矛盾：你買了 Claude Pro，但遇到要自動化的任務，還是打開 n8n 拖拉流程。

其實 Claude Code 本身就可以直接串接 WooCommerce。不需要另開一個自動化工具，不需要維護伺服器，用自然語言下指令就能完成庫存查詢、商品描述生成、批次更新。這篇把三個最常用的場景從頭走一遍。

延伸閱讀：Claude Code 完整教學

---

為什麼選 Claude Code，不用 n8n？

n8n 擅長的是「搬資料」——把 A 的資料搬到 B，按條件分流，定時執行。這些它做得很穩。但只要任務涉及「理解文字、生成內容、判斷語意」，n8n 就做不到了，因為它沒有語言理解能力。

Claude Code 的核心優勢恰好在這裡：

① 理解語意：看到商品名稱「手工皮革鑰匙圈」，Claude 知道要在描述裡帶入「質感、耐用、禮物首選」這類賣點，n8n 的 HTTP node 不會。

② 自然語言下指令：你不需要學 n8n 的 node 設定，直接打「幫我把所有沒有描述的商品生成 SEO 描述」，Claude Code 會自己想辦法執行。

③ 不需要額外維護：n8n 自架需要 VPS，cloud 版要訂閱。Claude Code 是你本來就在用的工具，不多一個維護負擔。

---

Claude Code 串接 WooCommerce 的三個機制

在進入場景前，先了解 Claude Code 裡哪些功能負責哪些事：

機制	觸發方式	用途
/loop / Schedule	定時自動執行	每天查庫存、定期同步資料
Sub-agents	並行委派	批次處理大量商品
Hooks	事件自動觸發	新增商品後自動生成描述並上架

這三個機制可以單獨用，也可以組合。

---

準備工作：5 分鐘設定環境

取得 WooCommerce API 金鑰

進入 WordPress 後台：WooCommerce → 設定 → 進階 → REST API → 建立金鑰

填入描述名稱（例如 claude-code），權限選「讀寫」，生成後記下：

• Consumer Key（ck_ 開頭）
• Consumer Secret（cs_ 開頭）

金鑰只顯示一次，生成後立刻存好。

在專案根目錄建立 .env

WC_URL=https://your-store.com
WC_KEY=ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
WC_SECRET=cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Claude Code 的腳本和指令都可以讀取這個環境變數，不需要每次輸入。

確認 Claude Code 已安裝

claude --version

沒安裝的話先看：Claude Code 安裝教學

---

場景一：每天早上自動查庫存 + 警示

這個場景最簡單，5 分鐘設定完，之後完全不用管。

方法 A：/loop 定時查詢（會話要開著）

在 Claude Code 終端機輸入：

/loop 24h 查詢 WooCommerce 庫存，環境變數在 .env，找出庫存低於 10 件的商品，整理成清單，用 Telegram Bot 發到我的群組

Claude Code 每 24 小時自動執行一次，流程：

① 讀取 .env 取得 WooCommerce API 金鑰
② GET /wp-json/wc/v3/products?manage_stock=true&per_page=100 查詢商品庫存
③ 篩選 stock_quantity < 10 的商品
④ 整理成訊息格式，用 Telegram Bot API 推送

收到的通知大概長這樣：

⚠️ 庫存警示（2026-04-06 09:00）

以下商品庫存偏低：
• 手工皮革鑰匙圈（黑色）× 3
• 帆布環保購物袋（米白）× 7
• 香氛蠟燭禮盒組 × 5

請確認補貨計畫。

方法 B：Desktop 排程（電腦關著也能跑）

/schedule daily at 9am 查 WooCommerce 庫存並通知

設定完 Claude Code 會建立一個本機排程任務，即使 Claude Code 會話關掉，只要電腦開著就會自動執行。

門檻設定建議

不是所有商品都適合用同一個門檻。快速週轉的商品（例如食品、日用品），門檻設 15-20 件；慢銷品（手工訂製、季節限定），設 3-5 件就夠。可以在指令裡告訴 Claude Code 依分類動態調整：

查庫存時，食品分類門檻 15，其他分類門檻 5

---

場景二：AI 批次生成商品 SEO 描述

這個場景是 Claude Code 對 WooCommerce 最有差異化的地方。假設你有 100 個商品，描述欄位都是空的，一個個手寫要花幾天。Claude Code 可以在 10 分鐘內跑完。

一句話下指令

讀取 WooCommerce 所有 description 為空的商品，根據商品名稱、分類和標籤，
用 SEO 優化的台灣繁體中文幫每個商品生成 150-200 字的描述，
重點帶入商品用途、目標族群、使用場景，
然後透過 REST API 批次更新回去

Claude Code 的執行流程：

① GET /wp-json/wc/v3/products?per_page=100 取得商品清單
② 篩選 description === "" 的商品
③ 對每個商品呼叫 Claude API，生成描述
④ PUT /wp-json/wc/v3/products/{id} 更新描述
⑤ 回報完成數量

生成結果範例（輸入：手工皮革鑰匙圈）：

採用頭層牛皮手工壓紋製作，每一條都有自然的皮革紋路與獨特手感。適合送給在意生活品質的朋友，或自用搭配皮夾、包包，提升整體質感。尺寸輕巧，機場報到、停車取票都方便攜帶。皮革會隨時間使用氧化變色，形成專屬於你的包漿效果，愈用愈有味道。

這段描述自然帶入了「頭層牛皮、手工、質感、禮物」等潛在搜尋關鍵字，不是硬塞。

用 Sub-agents 加速批次處理

100 個商品依序處理，每個要等 API 回應，加起來可能要 10-15 分鐘。啟用 Sub-agents 可以並行：

用 sub-agents 並行處理商品描述生成，每個 agent 負責 25 個商品，共 4 個 agent 同時跑

Claude Code 會同時啟動 4 個 sub-agent，每個各自負責 25 個商品的描述生成和 API 更新。速度理論上快 3-4 倍。

注意：並行呼叫 WooCommerce REST API 時，建議每個請求間隔 0.5-1 秒，避免觸發伺服器的 rate limit。告訴 Claude Code：每個 API 請求之間暫停 0.8 秒。

---

場景三：用 Hooks 在新增商品時自動觸發上架

前兩個場景是「手動下指令」或「定時執行」，這個場景是最省力的：你在本地建立商品資料檔案，Claude Code 自動幫你上架到 WooCommerce 並生成描述。完全不需要手動操作。

設定 Hook（.claude/settings.json）

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write",
      "hooks": [{
        "type": "command",
        "command": "node scripts/wc-auto-upload.js \"$CLAUDE_TOOL_INPUT_FILE_PATH\""
      }]
    }]
  }
}

這個 Hook 的意思：只要 Claude Code 使用 Write 工具寫入檔案，就自動執行 wc-auto-upload.js。

wc-auto-upload.js 腳本邏輯

// 判斷是否為商品資料檔案
const filePath = process.argv[2];
if (!filePath?.includes('/products/')) process.exit(0);

// 讀取商品資料（YAML 或 JSON 格式）
// 呼叫 Claude API 生成 SEO 描述
// POST /wp-json/wc/v3/products 上架商品
// 回填 WooCommerce 商品 ID 到本地檔案

完整腳本約 80 行，主要邏輯分四塊：讀檔、生成描述、上架、回填 ID。設定完成後，你只需要在 products/ 目錄下建立商品 YAML 檔，其他事情都自動搞定。

---

三個場景難度與投報比

場景	設定難度	長期效益	建議優先順序
庫存警示（/loop）	★☆☆ 5 分鐘	每天省 15 分鐘	① 先做
批次描述生成	★★☆ 10 分鐘	100 商品省 3 小時	② 次做
Hooks 自動上架	★★★ 1-2 小時	長期最高效	③ 穩定後做

---

Claude Code vs n8n：WooCommerce 自動化怎麼選？

比較項目	Claude Code	n8n
學習曲線	低（自然語言）	中（需學 node 設定）
維護成本	低（不需伺服器）	中高（自架需 VPS）
AI 理解能力	強（語意理解、文案生成）	無
視覺化流程	無	強
適合場景	需要 AI 介入的任務	純資料搬運、複雜條件分流
費用	Claude Pro（月費）或 API 費用	免費自架或 n8n.cloud 訂閱

兩者不是非此即彼。如果你已經有 n8n，用 n8n 做 Webhook 接收 + 資料搬運，Claude Code 負責需要 AI 的環節（文案生成、異常判斷），搭配起來效果更好。

---

常見問題

Q：Claude Code 的 /loop 排程可靠嗎？

可靠，但前提是 Claude Code 會話要保持開著。如果你會關閉終端機，建議改用 Desktop 排程（需要電腦開著）或 Cloud 排程（最穩定，最小間隔 1 小時，電腦不需要開）。

Q：批次呼叫 WooCommerce API 會不會被限速？

WooCommerce REST API 預設沒有嚴格的 rate limit，但宿主伺服器（Cloudways、Zeabur 等）可能有。建議每個請求間隔 0.5-1 秒，批次量大時分成多次執行。告訴 Claude Code 加入間隔即可，不需要改程式碼。

Q：商品描述生成的品質夠用嗎？

取決於商品名稱和分類資訊的完整度。商品名稱越具體，生成結果越準確。建議先跑 5-10 個商品看效果，確認語氣和關鍵字對了之後再批次跑。如果需要品牌一致的語氣，可以在指令裡加入品牌語氣說明。

Q：這個方法適合多大規模的店？

商品數在 500 以下的小電商最適合。商品量更大建議先整理到 Notion 商品資料庫做分批管理，參考：Notion 管理 WooCommerce。

Q：不會寫程式也能用嗎？

場景一和場景二完全不需要寫程式，用自然語言下指令就好。場景三的 Hooks 需要一個 JS 腳本，可以讓 Claude Code 幫你生成這個腳本，告訴它你的需求即可。

---

想了解更多 Claude Code 進階用法，或預約 WooCommerce 自動化顧問服務：WooCommerce 顧問服務