B.7 綜合實戰:用 Antigravity 打造「跨國市場情報爬蟲 + n8n/GAS 自動化報警 Agent」
學完本節,你能夠:
- 把「盯緊競品價格」這個模糊要求,拆成抓取 → 判斷 → 傳送 → 記錄 → 通知五個環節,並為每個環節寫出例外規則。
- 執行一支 Python 價格監控程式,並在本機用練習網站驗證它在漲價、降價、改版、斷線時的行為。
- 用 Google Apps Script(或 n8n)接收 Webhook,寫入試算表並只在需要時寄出彙整通知。
壹、開場情境:競品降價,我們第三天才知道
📌 以下為教學情境(依跨境電商實務改編)。
一家台灣電腦周邊品牌在美國電商平台銷售三款商品。上個月,主要競品的無線鍵盤從 USD 39.9 降到 33.9,我方業務三天後才在週會上聽到,這段期間流量和訂單明顯被搶走。
業務總監的要求只有一句:「以後競品一降價,我要馬上知道。」
這句話背後藏著好幾個沒說清楚的問題:降多少才算「降價」?知道之後要做什麼?抓不到價格時怎麼辦?如果每天響十次,還會有人看嗎?
本節要解決的問題: 把總監這句話,變成一套每天自動執行、該叫才叫、出錯會說的監控流程。本節綜合運用第 4.1 節(爬蟲)、第 4.2 節(n8n/GAS)、第 4.3 節(Webhook 與 JSON)與附錄 A(Git)。
貳、系統長什麼樣子
各環節的分工與常見問題:
| 環節 | 由誰負責 | 最常出的問題 |
|---|---|---|
| 抓取 | 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. 安裝與執行(本機練習)
- 部署 GAS:【部署】→【新增部署作業】→ 網頁應用程式,存取權選「任何人」,複製
/exec網址。到【專案設定】→【指令碼屬性】新增WEBHOOK_TOKEN,值自訂一串不易猜的文字。 - 建立練習網站:新增資料夾
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同理)。
- 開一個終端機視窗啟動練習網站:
cd demo_site後執行python -m http.server 8000,保持視窗開著。 - 開另一個終端機視窗,安裝套件並執行(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
- 預期終端機輸出:
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 節合規 |
本節小結
- 自動化的價值在於把例外說清楚:抓不到、改版、密語錯誤,每一種都有明確的處理方式。
- 價格戰的判斷不只看價差,還要看「跟價後還守不守得住毛利」。
- 通知要少而精:一次執行一封彙整信,全部正常就安靜。
- 機密(網址、密語)放在環境變數與指令碼屬性,不進程式碼、不進 Git。
柒、練習
- 改數字(5 分鐘):公司把跟價毛利底線從 40% 調高到 50%。改哪一行?用原始資料(競品 $33.90)重跑,KB-01 的狀態會變成什麼?(提示:跟價後毛利 46.9%。)
- 加功能(20 分鐘):總監希望「連續兩天都是價格戰才通知」,以免短暫促銷造成誤報。請先在第參段規格表加一列,再修改 Prompt。想一想:前一天的結果要存在哪裡?(提示:試算表已經有歷史紀錄。)
- 管理反思(討論):如果監控清單擴大到 200 項商品,每天可能有 20 項觸發警示。請從警報疲勞、責任歸屬、反應速度三個角度,設計通知的分級與分派規則(誰收、多快要處理、處理結果記在哪裡)。