AGENT SKILL 一日工作坊 · 階梯 6

Skill 串外部 API，把外面世界拉進來

一支 API 只有三件事：一個網址、一把 key、一包問題。學會 serper.dev，你就學會了所有 API 的通用模式。

⏱ 約 30 分鐘 8 頁 · 動手為主 serper.dev · 搜尋意圖偵察
今天帶走：一個能查 Google 搜尋結果的 skill。更重要的是那個模式，串任何 API 都是這四步。

學習目標

學會這個模式，串任何 API 都一樣

這堂課學什麼

Skill 能呼叫外部 API，把外面世界的即時資料拉進來。

你會看到串 API 的通用模式：一個網址、一把 key、一包問題，全部都是這樣。

你帶走什麼

一個能查 Google 搜尋結果的 skill，叫 serp-checker。

輸入一個關鍵字，就回來前十名的標題和網址，加上搜尋意圖分析。

最重要的一句話：今天你串的是 serper。明天你要串哪一支 API，方法完全一樣。網址換掉、key 換掉、問題換掉，就這三件事。

通用模式

一支 API，就只有三件事

把外部服務想成一個得來速視窗：你開到窗口旁邊（網址）、出示會員卡（API key）、點餐（傳問題），它就把你要的東西遞出來（JSON 答案）。

🌐

① 網址（Endpoint）

告訴系統你要打哪一個窗口。

google.serper.dev/search

🔑

② Key（身份證）

證明你有資格用這個服務。

serper 免費 2500 次查詢，今天絕對夠用。

📦

③ 問題（Request Body）

你要問什麼、查什麼地區、要幾筆。

JSON 格式包好，一起送出去。

所有 API 都是這個模式。今天你串 serper，明天換任何一支，學到的是同一件事。

動手 · 10 分鐘

對 Claude Code 說這句話，skill 就長出來了

# 複製這段，貼給 Claude Code

我有一把 serper.dev 的 API key （放在環境變數 SERPER_API_KEY）。
幫我做一個 skill 叫 serp-checker，
輸入一個關鍵字，
就呼叫 serper 查 Google 台灣的前十名，
列出每一名的標題和網址。

Claude Code 會做什麼

自動寫出呼叫 serper API 的程式、建好 skill 結構、把 key 從環境變數讀進來，你什麼 code 都不用寫。

你拿到什麼

輸入「SEO 工具推薦」，skill 回傳前十名的標題 + 網址。一個可以馬上用的工具。

SEO 應用 · 25 分鐘

serper 的金礦不是前十名，是別人也問和相關搜尋

People Also Ask（別人也問）和 Related Searches（相關搜尋）是搜尋意圖最直接的線索。serper 都幫你抓回來了，我們讓 skill 幫你分析。

# 升級你剛做的 serp-checker

把 serp-checker 升級。
除了前十名，也抓 People Also Ask 的問題
和 Related Searches 的延伸關鍵字。

然後幫我分析：
這個關鍵字的搜尋意圖是什麼？
使用者真正想知道的是什麼？
給我一段 100 字的意圖摘要
+ 一張延伸關鍵字清單。
貼完就跑：把這段指令貼給 Claude Code，它會自動升級你剛建的 serp-checker。輸入任何關鍵字，意圖摘要與延伸清單一次回來。

產出解讀

skill 給你三層資料，從現象到意圖

1
前十名（競品現況）

現在排名前面的是什麼內容類型？資訊型？商業型？看三個就知道這個關鍵字的「遊戲規則」。

2
People Also Ask（使用者的疑問地圖）

Google 收集到的延伸問題。這些問題直接告訴你：使用者在這個搜尋背後還有哪些尚未解決的疑惑。

3
意圖摘要 + 延伸關鍵字（Skill 幫你歸納）

Claude 讀完以上兩層，幫你寫成 100 字的意圖分析。你不用手動消化，直接拿來決定要不要寫這篇。

原本要開 Google → 手動看 → 手動記 → 手動猜意圖。現在：輸入關鍵字，全部自動拿回來。
這不是取代你的判斷，是把蒐集資料那一段時間還給你，讓你專心做內容決策。

進階加碼 · 技術端選做

串第二支 API，方法一模一樣

這一段是講師示範，不要求全員操作。重點不是 DataForSEO，是讓你親眼看到：換一支 API，就只是換三個東西。

serper.dev（你剛做完的）

網址google.serper.dev/search
KeySERPER_API_KEY
問題查關鍵字的 Google 搜尋結果

DataForSEO（示範）

網址api.dataforseo.com/v3/...
KeyDATAFORSEO_KEY
問題查月搜量、CPC、競爭度
# 技術端選做：搜量查詢 skill

我有 DataForSEO 帳號（key 放在 DATAFORSEO_KEY）。
幫我做一個 skill，輸入一批關鍵字，
查每個的月搜量、CPC、競爭度，
輸出成表格。

卡關備援

串 API 最容易卡的三個點，解法都在這裡

🔐

Key 沒設好（最常見）

把 key 放進專案的 .env 檔案：SERPER_API_KEY=你的key，然後告訴 Claude：「請讀 .env 取得 API key」。不需要自己去終端機打 export，Claude 會處理。

💰

怕額度不夠

serper 免費提供 2500 次查詢。今天整天課用下來，絕對足夠。不需要付費升級。

🚫

API 回 403 錯誤

通常是 key 貼錯了，或是複製時多帶了空格。回到 serper 控制台重新複製一次，貼進 .env 存檔，再跑一次。

卡關是正常的，不是你的問題。API 整合的卡關點就那幾個，遇到的時候對照這頁就好。
Agent Skill 工作坊 · 階梯 6 · 串外部 API（serper）