⌂ 總覽
Agent Skill 一日工作坊 · 階梯 6 / 11

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

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

封面＋10 頁 · 動手為主 serper.dev · 搜尋意圖偵察 帶走一個能查 Google 的 skill

學習目標

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

讓 Skill 呼叫外部 API，把外面世界的即時資料拉進來。學的是通用模式：一個網址、一把 key、一包問題。

這堂課學什麼

讓 Skill 主動打電話出去拿資料。那通電話就叫 API 呼叫。它不再只靠自己的知識回答，能把即時的外部資料拉進來。

你帶走什麼

一個能查 Google 的 skill，叫 serp-checker。輸入關鍵字，回來前十名與搜尋意圖分析。

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

通用模式

一支 API，就只有三件事

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

① 網址　Endpoint

告訴系統你要打哪一個窗口。google.serper.dev/search 就是 serper 的得來速窗口。

② Key　身份證

證明你有資格用這個服務。serper 免費 2500 次查詢，今天絕對夠用。

③ 問題　Request Body

你要問什麼、查什麼地區、要幾筆。用 JSON 格式包好，一起送出去。

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

通用模式 · 關鍵心法

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

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

1
找到文件

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

2
丟給 AI

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

3
它照著做

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

找對文件、餵給 AI，就是串任何 API 的通用鑰匙。文件對了半小時搞定，叫它用猜的就會卡住。

動手前準備 · 環境變數

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

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

1
建一個 .env
在你的專案資料夾裡，建一個檔名叫 .env 的檔。
2
寫一行 key
裡面寫：SERPER_API_KEY=你的key
3
叫 Claude 讀
跟 Claude 說：「讀 .env 拿 API key」，它會自己處理。
# 專案資料夾長這樣 my-project/ ├── .env　　← key 放這 └── （你的 skill 檔案）
Q：放根目錄還是專案資料夾？
放專案資料夾，就是 Claude Code 現在打開的那個。不是電腦的根目錄。
Q：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 回傳前十名的標題＋網址。一個可以馬上用的工具。

注意指令裡那一段 「key 放在 .env」。這就是上一頁設好的那個檔，告訴 Claude 你的 key 在哪，不是叫你去終端機打指令。

SEO 應用 · 25 分鐘

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

這兩塊是搜尋意圖最直接的線索。serper 都幫你抓回來了，讓 skill 接著分析。

# 升級你剛做的 serp-checker 把 serp-checker 升級。 除了前十名，也抓 People Also Ask 的問題 和 Related Searches 的延伸關鍵字。 然後幫我分析： 這個關鍵字的搜尋意圖是什麼？ 使用者真正想知道的是什麼？ 給我一段 100 字的意圖摘要 ＋ 一張延伸關鍵字清單。
People Also Ask
別人也問。Google 收集的延伸問題，點出使用者背後還沒解決的疑惑。
Related Searches
相關搜尋。這個話題的延伸地圖，直接變成你的延伸關鍵字清單。

貼完就跑：輸入任何關鍵字，意圖摘要與延伸清單一次回來。

產出解讀

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

1
前十名　競品現況
前面排的是哪種內容類型？看三個就知道這關鍵字的「遊戲規則」。前三名都是推薦型，你就知道要跟上這個格式。
2
People Also Ask　使用者的疑問地圖
Google 收集的延伸問題，直接點出使用者背後還沒解決的疑惑。這就是你下一篇文章的標題素材。
3
意圖摘要＋延伸關鍵字　Skill 幫你歸納
Claude 讀完前兩層，寫成 100 字意圖分析，直接拿來決定要不要寫、要怎麼切入。

原本要開 Google → 手動看 → 手動記 → 手動猜意圖。現在：輸入關鍵字，全部自動拿回來。

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

進階加碼 · 技術端選做

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

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

三件事serper.dev（你剛做完的）DataForSEO（示範）
網址google.serper.dev/searchapi.dataforseo.com/v3/...
KeySERPER_API_KEYDATAFORSEO_KEY
問題查關鍵字的 Google 搜尋結果查月搜量、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 整合的卡關點就那幾個，遇到的時候對照這頁就好。