B.7 綜合實戰:用 Antigravity 打造「跨國市場情報爬蟲 + n8n/GAS 自動化報警 Agent」

學完本節,你能夠:

  1. 把「盯緊競品價格」這個模糊要求,拆成抓取 → 判斷 → 傳送 → 記錄 → 通知五個環節,並為每個環節寫出例外規則。
  2. 執行一支 Python 價格監控程式,並在本機用練習網站驗證它在漲價、降價、改版、斷線時的行為。
  3. 用 Google Apps Script(或 n8n)接收 Webhook,寫入試算表並只在需要時寄出彙整通知。

壹、開場情境:競品降價,我們第三天才知道

📌 以下為教學情境(依跨境電商實務改編)。

一家台灣電腦周邊品牌在美國電商平台銷售三款商品。上個月,主要競品的無線鍵盤從 USD 39.9 降到 33.9,我方業務三天後才在週會上聽到,這段期間流量和訂單明顯被搶走。

業務總監的要求只有一句:「以後競品一降價,我要馬上知道。」

這句話背後藏著好幾個沒說清楚的問題:降多少才算「降價」?知道之後要做什麼?抓不到價格時怎麼辦?如果每天響十次,還會有人看嗎?

本節要解決的問題: 把總監這句話,變成一套每天自動執行、該叫才叫、出錯會說的監控流程。本節綜合運用第 4.1 節(爬蟲)、第 4.2 節(n8n/GAS)、第 4.3 節(Webhook 與 JSON)與附錄 A(Git)。


貳、系統長什麼樣子

sequenceDiagram autonumber participant Py as Python 監控程式 participant Web as 競品商品頁 participant Hub as GAS 或 n8n(接收端) participant Sheet as Google 試算表 participant Boss as 業務總監信箱 Note over Py: 每天定時執行(作業系統排程或 n8n 排程) Py->>Web: 1. 讀取商品頁 Web-->>Py: HTML Py->>Py: 2. 取出價格,計算價差與跟價後毛利 Py->>Hub: 3. POST JSON(含通關密語) Hub->>Sheet: 4. 全部結果寫入「競品監控」分頁 alt 有價格戰或抓取失敗 Hub->>Boss: 5. 寄出一封彙整通知 end

各環節的分工與常見問題:

環節 由誰負責 最常出的問題
抓取 Python(requests + BeautifulSoup) 網站改版、封鎖、網路逾時
判斷 Python 門檻訂錯、只看價差不看毛利
傳送 Webhook(HTTP POST) 網址外洩被亂打
記錄 GAS 寫入試算表 逐格寫入太慢
通知 GAS 寄信(或 n8n 傳 Slack) 通知太多,沒人看(警報疲勞)

⚠️ 抓取前先確認合法性:電商平台的服務條款多半限制自動化抓取。實務上應優先使用官方 API 或授權資料服務,並遵守網站的 robots.txt 與流量限制。本節的程式只對本機練習網站執行。

💡 通知管道的提醒:許多舊教學使用 LINE Notify,但該服務已於 2025 年 3 月 31 日結束。本節改用 Email,n8n 使用者可換成 Slack 或 LINE 官方帳號的 Messaging API。


參、把規則寫下來

總監說的話 需要追問的問題 寫成規格
「競品一降價就通知我」 降多少才算? 競品價比我方售價低 超過 10%(PRICE_WAR_THRESHOLD = -0.10)才算價格戰
「我們要不要跟?」 跟價後還賺不賺? 計算「若跟到競品價,我方毛利率」;≥ 40%(MIN_MARGIN)標 PRICE_WAR_CAN_MATCH,否則標 PRICE_WAR_CANNOT_MATCH
「每天看一次」 什麼時候跑? 每天早上 8 點執行一次
(總監沒說)抓不到價格 用上次的價格?用估計值? 都不用。標記 FETCH_FAILED,附失敗原因,並列入通知請人確認
(總監沒說)網站改版 找不到價格標籤怎麼辦? 同上,視為抓取失敗,不得回傳任何預設價格
(總監沒說)通知太多 每項商品各寄一封嗎? 一次執行只寄一封彙整信;全部正常就不寄
(總監沒說)Webhook 網址外洩 別人亂送資料怎麼辦? 請求內容必須帶通關密語 token,不符就拒收

第四列是本節最重要的規則。原本常見的寫法是「抓不到就回傳一個備援價格」,這會讓系統在網站改版後每天安靜地回報錯誤數字,比當機更危險。


肆、讓 AI 做出來

1. 先規劃,再動手

在 Antigravity 中先使用規劃模式(第 B.3 節)讓 AI 產出實作計畫,確認資料欄位、檔案結構與上表的例外規則都有寫進去,再進入實作。給 AI 的需求重點如下:

請用 Python 寫 market_monitor.py:
【資料】PRODUCTS 清單,每項含 sku、name、our_cost、our_price(USD)、url、selector(價格的 CSS 選擇器)。
【規則】gap = (競品價 − 我方售價) ÷ 我方售價;margin_if_match = 1 − our_cost ÷ 競品價。
gap ≥ −10% 為 NORMAL;否則 margin_if_match ≥ 40% 為 PRICE_WAR_CAN_MATCH,其餘為 PRICE_WAR_CANNOT_MATCH。
兩個門檻宣告為程式最上方的常數。
【例外】HTTP 錯誤、逾時、找不到價格標籤:該項標記 FETCH_FAILED 並記錄原因,不得使用預設價格。
【輸出】將全部結果與環境變數 WEBHOOK_TOKEN 一起 POST 到環境變數 WEBHOOK_URL;
接收端回覆的 status 不是 "ok" 時,程式以錯誤結束。

2. Python 監控程式(已人工驗收)

# market_monitor.py:競品價格監控(教學版)
import os
import requests
from bs4 import BeautifulSoup

# ===== 商業規則(經理人只需要改這幾行)=====
PRICE_WAR_THRESHOLD = -0.10   # 競品比我方便宜超過 10% → 價格戰警示
MIN_MARGIN = 0.40             # 若跟價,我方毛利率不得低於 40%

# 監控清單:我方成本與售價(USD)、競品頁面網址、價格所在的 CSS 選擇器
PRODUCTS = [
    {"sku": "KB-01", "name": "無線鍵盤", "our_cost": 18.0, "our_price": 39.9,
     "url": "http://localhost:8000/item1.html", "selector": "span.price"},
    {"sku": "MS-02", "name": "靜音滑鼠", "our_cost": 15.0, "our_price": 32.0,
     "url": "http://localhost:8000/item2.html", "selector": "span.price"},
    {"sku": "HB-03", "name": "USB 集線器", "our_cost": 9.0, "our_price": 24.9,
     "url": "http://localhost:8000/item3.html", "selector": "span.price"},
]

WEBHOOK_URL = os.environ.get("WEBHOOK_URL")      # GAS 或 n8n 的接收網址
WEBHOOK_TOKEN = os.environ.get("WEBHOOK_TOKEN")  # 與接收端約定的通關密語


def fetch_price(url, selector):
    """抓取競品價格;任何失敗都丟出例外,不回傳預設值。"""
    resp = requests.get(url, timeout=10, headers={"User-Agent": "price-monitor-course/1.0"})
    resp.raise_for_status()                       # 404、500 等直接視為失敗
    tag = BeautifulSoup(resp.text, "html.parser").select_one(selector)
    if tag is None:
        raise ValueError(f"找不到價格標籤 {selector}(網頁版面可能改了)")
    return float(tag.get_text().replace("$", "").replace(",", "").strip())


def analyze(p):
    """回傳一筆分析結果;抓取失敗時標記 FETCH_FAILED。"""
    row = {"sku": p["sku"], "name": p["name"], "our_price": p["our_price"]}
    try:
        comp = fetch_price(p["url"], p["selector"])
    except Exception as e:
        row.update(status="FETCH_FAILED", note=str(e)[:100])
        return row
    gap = (comp - p["our_price"]) / p["our_price"]   # 負數 = 競品比我們便宜
    margin_if_match = 1 - p["our_cost"] / comp       # 若跟到競品價,我方毛利率
    row.update(competitor_price=comp, gap_pct=round(gap * 100, 1),
               margin_if_match_pct=round(margin_if_match * 100, 1))
    if gap >= PRICE_WAR_THRESHOLD:
        row["status"] = "NORMAL"
    elif margin_if_match >= MIN_MARGIN:
        row["status"] = "PRICE_WAR_CAN_MATCH"      # 價格戰,但跟價仍守得住毛利
    else:
        row["status"] = "PRICE_WAR_CANNOT_MATCH"   # 價格戰,跟價會跌破毛利底線
    return row


def main():
    if not WEBHOOK_URL or not WEBHOOK_TOKEN:
        raise SystemExit("請先設定 WEBHOOK_URL 與 WEBHOOK_TOKEN 環境變數")
    results = [analyze(p) for p in PRODUCTS]
    for r in results:
        print(r["sku"], r["status"], r.get("gap_pct", ""), r.get("margin_if_match_pct", ""))
    resp = requests.post(WEBHOOK_URL, json={"token": WEBHOOK_TOKEN, "data": results}, timeout=15)
    resp.raise_for_status()
    reply = resp.json()                       # GAS 一律回 HTTP 200,要看內容才知道成功與否
    if reply.get("status") != "ok":
        raise SystemExit(f"接收端拒絕:{reply}")
    print("已送出,接收端回覆:", reply)


if __name__ == "__main__":
    main()

🔍 驗收重點 - fetch_price() 失敗時是丟出例外,還是回傳某個數字?只有前者是對的。 - 價差是除以我方售價,跟價後毛利是除以競品價(跟價後的新售價),分母不同,不要混用。 - 為什麼要檢查 reply.get("status")?因為 GAS Web App 不論成功失敗都回 HTTP 200,只看狀態碼會誤以為送達。

3. GAS 接收端(已人工驗收)

在試算表新增分頁「競品監控」,第 1 列標題依序為:時間|SKU|品名|我方售價|競品價格|價差%|跟價後毛利%|狀態|備註。然後在 Apps Script 貼上:

// ===== 設定(經理人只需要改這幾行)=====
const SHEET_NAME = '競品監控';
const ALERT_STATUSES = ['PRICE_WAR_CAN_MATCH', 'PRICE_WAR_CANNOT_MATCH', 'FETCH_FAILED'];

// 接收 Python 送來的監控結果
function doPost(e) {
  let payload;
  try {
    payload = JSON.parse(e.postData.contents);
  } catch (err) {
    return reply({ status: 'error', message: 'JSON 格式錯誤' });
  }

  // 通關密語存在「指令碼屬性」,不寫在程式碼裡
  const token = PropertiesService.getScriptProperties().getProperty('WEBHOOK_TOKEN');
  if (!token || payload.token !== token) {
    return reply({ status: 'unauthorized' });
  }
  if (!Array.isArray(payload.data) || payload.data.length === 0) {
    return reply({ status: 'error', message: '沒有資料' });
  }

  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME);
  if (!sheet) return reply({ status: 'error', message: '找不到分頁:' + SHEET_NAME });

  // 整理成二維陣列,一次寫入
  const now = new Date();
  const rows = payload.data.map(r => [
    now, r.sku, r.name, r.our_price,
    r.competitor_price ?? '', r.gap_pct ?? '', r.margin_if_match_pct ?? '',
    r.status, r.note ?? ''
  ]);
  sheet.getRange(sheet.getLastRow() + 1, 1, rows.length, rows[0].length).setValues(rows);

  // 只有需要人處理的項目才寄信,而且一次彙整成一封
  const alerts = payload.data.filter(r => ALERT_STATUSES.includes(r.status));
  if (alerts.length > 0) {
    const lines = alerts.map(r => r.status === 'FETCH_FAILED'
      ? `⚠️ ${r.sku} ${r.name}:抓取失敗(${r.note}),請人工確認`
      : `🛑 ${r.sku} ${r.name}:競品 USD ${r.competitor_price},價差 ${r.gap_pct}%,跟價後毛利 ${r.margin_if_match_pct}%(${r.status})`);
    MailApp.sendEmail(Session.getEffectiveUser().getEmail(),
      `【競品監控】${alerts.length} 項需要處理`, lines.join('\n'));
  }
  return reply({ status: 'ok', rows: rows.length, alerts: alerts.length });
}

function reply(obj) {
  return ContentService.createTextOutput(JSON.stringify(obj))
    .setMimeType(ContentService.MimeType.JSON);
}

🔍 驗收重點 - 通關密語是否存在「指令碼屬性」,而不是寫死在程式碼?程式碼可能被分享或上傳 Git。 - 是否一次 setValues() 寫入,而不是逐列 appendRow()? - 是否全部正常時不寄信?

💡 改用 n8n 的做法:建立 Webhook 節點接收同樣的 JSON → IF 節點比對 token 與 status → Google Sheets 節點寫入 → Gmail 或 Slack 節點彙整通知。規則與上表完全相同,差別只在用拖拉節點取代寫程式(見第 4.2 節)。

4. 安裝與執行(本機練習)

  1. 部署 GAS:【部署】→【新增部署作業】→ 網頁應用程式,存取權選「任何人」,複製 /exec 網址。到【專案設定】→【指令碼屬性】新增 WEBHOOK_TOKEN,值自訂一串不易猜的文字。
  2. 建立練習網站:新增資料夾 demo_site,放入兩個檔案(item3.html 故意不建立,用來測試抓取失敗):

bash mkdir demo_site echo '<html><body><span class="price">$33.90</span></body></html>' > demo_site/item1.html echo '<html><body><span class="price">$30.50</span></body></html>' > demo_site/item2.html

💡 Windows PowerShell 使用者:PowerShell 5.1 的 > 會寫成 UTF-16 編碼,請改用 Set-Content -Encoding utf8 demo_site/item1.html '<html><body><span class="price">$33.90</span></body></html>'(item2 同理);下一步的 export WEBHOOK_URL="..." 則改成 $env:WEBHOOK_URL="..."(WEBHOOK_TOKEN 同理)。

  1. 開一個終端機視窗啟動練習網站:cd demo_site 後執行 python -m http.server 8000,保持視窗開著。
  2. 開另一個終端機視窗,安裝套件並執行(Windows PowerShell 設定環境變數的方式見附錄 E.5):

bash pip install requests beautifulsoup4 export WEBHOOK_URL="https://script.google.com/macros/s/你的ID/exec" export WEBHOOK_TOKEN="你設定的通關密語" python market_monitor.py

  1. 預期終端機輸出:

text KB-01 PRICE_WAR_CAN_MATCH -15.0 46.9 MS-02 NORMAL -4.7 50.8 HB-03 FETCH_FAILED 已送出,接收端回覆: {'status': 'ok', 'rows': 3, 'alerts': 2}

試算表多出 3 列,信箱收到一封「2 項需要處理」的通知。 6. 每日排程:可用 Windows「工作排程器」、macOS/Linux 的 cron,或 n8n 的 Schedule Trigger 節點觸發。

5. 用 Git 保存成果

確認一切正常後,把 GAS 程式碼另存一份 gas/receiver.js,再請 Antigravity 協助提交(Git 操作見附錄 A):

git add market_monitor.py gas/receiver.js
git commit -m "feat(monitor): competitor price monitor with fail-safe and webhook"
git tag -a v1.0-price-monitor -m "競品價格監控 v1.0"

⚠️ 提交前確認 Webhook 網址與通關密語沒有寫在任何檔案裡。它們應該只存在環境變數與 GAS 的指令碼屬性中。


伍、跑跑看、壞給你看

每次修改 demo_site/item1.html 的內容後,重新執行 python market_monitor.py。

實驗 操作 預期結果(KB-01) 想想看
① 小幅降價 價格改為 $37.50 價差 −6.0%,NORMAL;通知信只剩 HB-03 一項 6% 的降價真的不用管嗎?門檻該由誰決定?
② 殺價到底 價格改為 $29.00 價差 −27.3%,跟價後毛利 37.9%,PRICE_WAR_CANNOT_MATCH 不能跟價時,還有哪些商業選項?
③ 網站改版 把 class="price" 改成 class="sale-price" FETCH_FAILED,備註「找不到價格標籤」 如果程式回傳備援價格 35.0,總監會看到什麼?
④ 密語錯誤 把 WEBHOOK_TOKEN 改成錯的值 程式以「接收端拒絕:{'status': 'unauthorized'}」結束,試算表沒有新增資料 為什麼不能只靠「網址沒人知道」來保護?

陸、回到情境

下次競品降價,隔天早上 8 點的執行就會抓到,總監收到的不只是「降價了」,還有「跟價後毛利還剩多少、能不能跟」。抓不到資料時,系統會明說,而不是假裝一切正常。

這套系統還做不到的事:

限制 後果 在哪一節解決
一天只跑一次 當天的降價最晚隔天才知道 第 11.1 節事件驅動架構
只看單一時點價格 競品短暫促銷也會觸發警示 練習 2;第 6.4 節異常偵測
監控清單寫死在程式裡 新增商品要改程式 改成從試算表讀取(第 12.3 節單一真實資料源)
抓取平台頁面有法律與封鎖風險 帳號或 IP 被封、違反服務條款 改用官方 API;第 13.4 節合規

本節小結

  1. 自動化的價值在於把例外說清楚:抓不到、改版、密語錯誤,每一種都有明確的處理方式。
  2. 價格戰的判斷不只看價差,還要看「跟價後還守不守得住毛利」。
  3. 通知要少而精:一次執行一封彙整信,全部正常就安靜。
  4. 機密(網址、密語)放在環境變數與指令碼屬性,不進程式碼、不進 Git。

柒、練習

  1. 改數字(5 分鐘):公司把跟價毛利底線從 40% 調高到 50%。改哪一行?用原始資料(競品 $33.90)重跑,KB-01 的狀態會變成什麼?(提示:跟價後毛利 46.9%。)
  2. 加功能(20 分鐘):總監希望「連續兩天都是價格戰才通知」,以免短暫促銷造成誤報。請先在第參段規格表加一列,再修改 Prompt。想一想:前一天的結果要存在哪裡?(提示:試算表已經有歷史紀錄。)
  3. 管理反思(討論):如果監控清單擴大到 200 項商品,每天可能有 20 項觸發警示。請從警報疲勞、責任歸屬、反應速度三個角度,設計通知的分級與分派規則(誰收、多快要處理、處理結果記在哪裡)。

國立臺中科技大學 國際貿易系 / 企業管理系 專用教材

《現代軟體工程:商學院的 AI 系統思維與 Agent 實踐》

作者:陳俊智 博士 Dr. Chun-Chih Chen

本書章節架構改編自陳鍾誠教授(金門大學)開源課程《現代軟體工程》(github.com/ccc115a/se,MIT 授權),內容針對商學院全面改寫與擴充。