AGENT SKILL 一日工作坊 · 階梯 6

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

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

10 頁 · 動手為主 serper.dev · 搜尋意圖偵察

今天帶走：一個能查 Google 的 skill。但更重要的是那套模式，換任何 API 都一樣。

學習目標

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

這堂課學什麼

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

學的是通用模式：一個網址、一把 key、一包問題。

你帶走什麼

一個能查 Google 的 skill，叫 serp-checker。

輸入關鍵字，回來前十名與搜尋意圖分析。

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

通用模式

一支 API，就只有三件事

把它想成得來速：開到窗口（網址）、出示會員卡（key）、點餐（問題），它就把答案遞出來。

🌐

① 網址（Endpoint）

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

google.serper.dev/search

🔑

② Key（身份證）

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

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

📦

③ 問題（Request Body）

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

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

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

通用模式 · 關鍵心法

串任何 API 的第一步：把官方文件丟給它

Claude 不會背下每一支 API。把那支 API 的官方文件找出來丟給它，它就照規格做。

① 找到文件

Google 搜「serper api docs」，或到 serper.dev 網站點 Docs / API Reference。每支正規 API 都有這一頁。

② 丟給 AI

把那頁網址貼給 Claude Code，說「去讀這份文件，照它的規格做」。它會自己讀、自己看懂格式。

③ 它照著做

Claude 從文件裡讀出網址、參數、回傳長相，直接寫成能跑的程式。那些技術細節你完全不用看。

為什麼這一步最關鍵？找對文件、餵給 AI，就是串任何 API 的通用鑰匙。文件對了半小時搞定，叫它用猜的就會卡住。

進動手之前，我先講一個最關鍵的觀念。這一頁學會，你以後能串任何 API。

很多人以為 AI 什麼都知道。不是的。Claude 不會背下世界上每一支 API 的規格。serper 長什麼樣、要傳什麼參數，它一開始並不知道。那它怎麼知道？你告訴它去哪裡看，就是那支 API 的官方文件。

三步。第一，找到文件：Google 搜「serper api docs」，或去官網點 Docs。第二，把那頁網址貼給 Claude，跟它說「去讀這份文件，照規格做」。第三，它自己讀完，把網址、參數、回傳格式都讀出來，寫成程式。

記住這句：找對文件、餵給 AI，是串任何 API 的通用鑰匙。今天串 serper 是這樣，明天串 Ahrefs、DataForSEO、任何一支，都是先找文件。文件對了半小時就通；沒有文件叫它用猜的，它會卡住，你也會卡住。

動手前準備 · 環境變數

API key 放哪？一個 .env 檔搞定

key 是密碼，別寫進指令。放進一個叫 .env 的純文字檔就好。它只是文字檔，Mac 和 Windows 一模一樣。

三步放好 key

1

在你的專案資料夾裡，建一個檔名叫 .env 的檔

2

裡面寫一行：SERPER_API_KEY=你的key

3

跟 Claude 說：「讀 .env 拿 API key」

my-project/
├── .env　　← key 放這
└── （你的 skill 檔案）

兩個最常見的疑問

Q：放根目錄還是專案資料夾？

放專案資料夾，就是 Claude Code 現在打開的那個。不是電腦的根目錄。

Q：Windows 要去「系統內容 → 環境變數」設定嗎？

不用。那個又麻煩又容易出錯。我們用 .env 檔，跟 Mac 完全一樣。

最快：直接叫 Claude「在這個資料夾幫我建一個 .env，放這把 key」，它會幫你建好。

記住：key 放專案資料夾的 .env，不寫進指令、不碰系統設定。這樣 key 不外流，Claude 也讀得到。

動手之前還有一件事要先弄好：你的 API key 要放在哪裡。這一頁專門解這個，因為這是最多人卡住、也最多人搞混的地方。

先講結論：key 是你的密碼，不要直接打在給 Claude 的指令裡，也不要寫進程式碼。正確做法是放進一個叫 .env 的純文字檔。這個檔 Mac 跟 Windows 做法一模一樣，因為它就是一個文字檔，不是去動什麼系統設定。

三步。第一，在你的專案資料夾裡建一個檔，檔名就叫點 env。第二，裡面寫一行 SERPER 底線 API 底線 KEY 等號你的 key。第三，跟 Claude 說「讀 .env 拿 API key」。

兩個最常被問的。第一，放哪個資料夾？放專案資料夾，就是你現在用 Claude Code 打開的那個資料夾，不是電腦最外層的根目錄。第二，Windows 的同學特別注意：你不需要去「系統內容、環境變數」那個畫面設定，那個又麻煩又容易錯。我們就用 .env 檔，跟 Mac 一樣。

其實最快的方法：你直接叫 Claude「在這個資料夾幫我建一個 .env，內容是這把 key」，它會幫你建好，你連檔案都不用自己開。

動手 · 10 分鐘

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

# 複製這段，貼給 Claude Code

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

Claude Code 會做什麼

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

你拿到什麼

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

SEO 應用 · 25 分鐘

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

這兩塊是搜尋意圖最直接的線索。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 → 手動看 → 手動記 → 手動猜意圖。現在：輸入關鍵字，全部自動拿回來。

這不是取代你的判斷，是把蒐集資料那一段時間還給你，讓你專心做內容決策。

讓我把 skill 的輸出解讀給你看，這樣你拿到結果不會不知道要怎麼用。

第一層是前十名，這是現況快照。你看前三名是什麼類型的內容，就知道 Google 對這個關鍵字的判讀是什麼。如果前三名都是「推薦型」的文章，你就知道要跟上這個格式。

第二層是 People Also Ask，這是真正的金礦。Google 把用戶問的延伸問題都整理出來了，這就是你下一篇文章的標題素材。

第三層是 skill 幫你歸納的意圖摘要。這 100 字告訴你：這個關鍵字背後的人，他真正想解決什麼問題。你拿這個去決定要不要寫這篇、要怎麼切入。

以前這整套你要花 15 分鐘手動查，現在 skill 幫你做完。你只要做最後的判斷。

進階加碼 · 技術端選做

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

講師示範，不要求全員操作。重點是讓你親眼看到：換一支 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，再叫 Claude「讀 .env 取得 API key」。不用自己打 export，Claude 會處理。

💰

怕額度不夠

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

🚫

API 回 403 錯誤

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

卡關是正常的，不是你的問題。API 整合的卡關點就那幾個，遇到的時候對照這頁就好。

好，最後這一頁是卡關備援。串 API 的時候最容易卡的地方就這三個，我一個一個說。

第一個是 key 沒設好，這是最常見的。做法很簡單：在你的專案資料夾裡建一個 .env 檔，裡面寫 SERPER_API_KEY 等號你的 key。然後告訴 Claude「請讀 .env 取得 API key」。你不用自己去終端機打 export，Claude 知道怎麼處理。

第二個是怕額度。serper 免費 2500 次，今天一天課用下來絕對夠，不用擔心。

第三個是 403 錯誤。遇到這個九成九是 key 貼錯了。回到 serper 網站重新複製，注意不要多帶空格，存回 .env，再跑一次。

卡關是正常的，不是你的問題，也不代表你不適合做這件事。就照這頁的步驟一步一步排除就好。