讓 Claude Code 讀懂即時加密數據：Surf Skill 與 CLI 串接教學
Surf 是為 AI Agent 打造的加密數據工具，支援市場價格、鏈上資料、社群訊號、錢包分析與預測市場。本篇會介紹 Surf Skill、CLI 與 API 的差異，並示範如何把 Surf 串接進 Claude Code，建立可重複使用的 Web3 投研流程。
AI 工具與應用
5/29/2026
為什麼通用型 AI 做不好 Web3 投研？
主流 AI 工具如 ChatGPT、Claude 已經能透過 Web Search 查找即時資訊，但在 Web3 投研裡，「能搜尋」不等於「能分析」。
加密市場需要的是即時、結構化、可交叉驗證的資料。你可能要同時檢查代幣價格、DEX 流動性、資金費率、錢包持倉、DeFi positions、社群聲量與 TVL 變化。這些資料分散在不同平台，也不是一般 AI 透過搜尋網頁就能穩定取得。
所以通用 AI 的限制，不是它不會寫分析，而是它缺少可靠的加密數據入口、沒有可查詢的資料來源，而 Surf 就是要解決這個問題。
ChatGPT（通用型 AI）以及 Surf 比較表
Surf：AI Agent 的加密貨幣數據層
Surf 可以理解成 AI 驅動的加密貨幣數據層。
它把 Web3 常用資料整理成 AI 可以調用的工具，讓 Claude Code 這類 Agent 能查詢市場價格、鏈上資料、錢包資訊、社群訊號、DeFi 指標與預測市場資料，再整理成表格、摘要或研究報告。
Surf 的價值不只是讓 AI 回答得更完整，而是讓 AI 接觸更接近一手資料的分析素材。
Surf 串接的資料種類（節錄）
Skill、CLI、API 該怎麼選？
除了本文主軸的 Skill、CLI 與 API，Surf 也提供 Studio 網頁端，適合先體驗官方與社群做好的 Agent / workflow。不過本文目標是讓 Claude Code 直接讀取加密數據，因此會以 Skill 與 CLI 介紹為主。
Surf Skill：適合 Claude Code / Cursor / Codex
適合人群：在使用 Claude Code、Cursor、Codex 等 AI Coding Agent 的人。
安裝 Skill 之後，你不用記住每個 endpoint，也不用手動組查詢參數。你可以直接用自然語言提出需求，AI Agent 會自己判斷該使用哪個 Surf 指令，再把結果整理成表格、摘要或研究筆記。
Surf CLI：適合腳本與自動化流程
適合人群：需要穩定查詢資料、串接到腳本或自動化流程裡的使用者。
如果你想定時抓市場資料、追蹤錢包變化，或把查詢結果輸出成 JSON 再交給其他工具處理，CLI 會比 Skill 更適合。
Chat API / Data API：適合產品整合
適合人群：想把 Surf 接進產品、後端服務、研究平台或內部工具
Chat API 比較接近自然語言問答，Data API 則偏向結構化資料查詢。只想先讓 Claude Code 具備 Web3 投研能力的話，從 Skill 或 CLI 開始就夠了。
安裝教學：五分鐘串連 Surf
免費額度與 API Key
目前 Surf CLI 不設定 API Key 也能開始試用，每個 IP 每天有 30 個免費 credits。
可以先確認工具是否符合你的工作流，如果需要更多額度，可以到 agents.asksurf.ai 登入 Dashboard，產生 API Key 後再回到本地端， Terminal 輸入 surf auth --api-key sk-your-key-here 儲存。
Surf 付費方案比較
方法一：用 Surf Skill 串接 Claude Code
如果你想讓 Claude Code 直接使用 Surf，建議先安裝 Surf CLI。
1. CLI 安裝指令如下：curl -fsSL <https://downloads.asksurf.ai/cli/releases/install.sh> | sh
2. 安裝後先確認版本：surf version
3. 接著安裝 Surf Skill：npx skills add asksurf-ai/surf-skills --skill surf
完成後，你就可以在 Claude Code 裡用自然語言提出需求，例如：「請使用 Surf 查詢 ETH 目前價格」、「24 小時漲跌幅與主要市場狀態，整理成 Markdown 表格」，或是「 UNI 代幣現在的前面幾大持有者是誰？」等。
方法二：用 Surf CLI 建立自動化流程
如果你不需要 AI 對話介面，只想在終端機裡快速查資料，可以直接使用 Surf CLI。
1. 安裝指令：curl -fsSL <https://downloads.asksurf.ai/cli/releases/install.sh> | sh
2. 安裝完成後，查看可用指令：surf list-operations -g
3. 查詢特定指令用法：surf market-price --help
4. 測試查詢 BTC 即時價格：surf market-price --symbol BTC
5. 如果你要把結果交給 AI Agent 後續處理，建議使用 JSON 輸出：surf market-price --symbol BTC -o json -f body.data
直接問 Surf 如何只用 market-price 這個指令
實戰演練：把 Claude Code 變成投研助手
安裝 Surf Skill 之後，你不需要記住每個 command 的完整格式。比較簡單的用法，是直接用問題描述你想查什麼，再讓 Claude Code 判斷該呼叫哪個 Surf 指令。
官方範例大致可以分成幾類：市場與交易所、錢包與代幣、預測市場、社群與新聞、Onchain SQL，以及空投與人物搜尋。下面先用三個最常見的投研場景示範。
實戰一：查詢市場與交易所狀態
第一個案例先從市場資料開始。這類查詢很適合測試 Surf Skill 是否安裝成功，因為問題簡單，回傳結果也容易檢查。
範例 Prompt：「請使用 Surf 查詢 BTC 目前價格、Top 10 cryptocurrencies by market cap、BTC futures open interest，以及 BTC-USDT 在 Binance 的 order book depth，整理成 Markdown 表格，最後補一段市場狀態摘要。」
Surf 回傳的市場狀態摘要
這個案例會使用到官方範例裡的 market-price、market-ranking、market-futures 和 exchange-depth 指令。你可以觀察 Claude Code 是否能把不同來源的市場資料整理在一起，並清楚區分「Surf 回傳的數據」和「AI 做出的市場解讀」。
Surf 回傳的 BTC 價格
實戰二：分析錢包與代幣資料
第二個案例適合展示 Surf 在鏈上資料上的用途。官方範例裡，錢包與代幣相關查詢包含 portfolio breakdown、wallet transactions、token holders、DEX trades 和 tokenomics。
範例 Prompt：「請使用 Surf 查詢錢包 C7gAAbE2JqyEkhv9d4PWBrwprHehgTq875cXcrqyNTwq 的 portfolio breakdown，並整理它的主要資產、最近 24 小時交易紀錄，以及是否有值得注意的大額變動。」
Surf 回傳的指定錢包狀態
這個案例對應 wallet-detail 和 wallet-history 指令。重點不是讓 AI 猜測錢包主人是誰，而是把持倉、交易與變動整理成可讀格式。
如果你想把分析對象從錢包換成代幣，也可以使用這類 Prompt：「請使用 Surf 查詢 UNI 目前前幾大持有者，以及過去 7 天的 DEX trades，整理出持有人集中度與交易活動變化。」
Surf 回傳的 UNI 代幣主要持倉地址
實戰三：追蹤社群、新聞與鏈上事件
第三個案例可以放在比較接近投研流程前期的位置。很多 Web3 的投資機會一開始不是出現在價格圖上，而是先出現在社群討論、新聞事件、空投消息或鏈上活動裡。
範例 Prompt：「請使用 Surf 查詢過去一週 LINK 的社群關注度變化、過去 24 小時和 Ethereum 相關的最新 tweets 與 news feed，並整理出目前市場主要討論方向。」
Surf 回傳的 LINK 代幣社群關注度
這個案例用到 social-mindshare、search-social-posts 和 news-feed 指令。對於投資者，好的輸出不應該直接告訴你「該買哪個」，而是幫你整理現在市場在討論什麼、討論熱度是否升高，以及有哪些新事件值得追蹤。
如果你想進一步查鏈上資料，可以用 Onchain SQL 類型的問題：「請使用 Surf 用 SQL 查詢過去 7 天以太坊上 USDC 的每日轉帳總量，並整理成表格。」
Surf 回傳的以太坊上 USDC 轉帳總量
使用 Surf 時要注意什麼？
Surf 可以讓 AI 更容易取得加密數據，但資料不等於結論。
使用時最重要的是三件事：先確認資料時間與欄位，再分清楚哪些是 Surf 回傳的原始資料，哪些是 Claude Code 做出的解讀。至於勝率、PnL、策略績效這類高階指標，通常需要拿到原始交易資料後再二次計算，不適合只看單次查詢結果就下判斷。
簡單說，Surf 讓 AI 更接近投研工作流，但最後的判斷仍然要回到資料驗證。
結語：在資訊爆炸中，用 AI 建立你的數據護城河
Web3 的資訊量太大，單靠手動刷社群、看圖表、開多個資料網站，很容易被雜訊牽著走。AI Agent 的價值，不只是幫你把文章摘要得更短，而是把查詢、整理、比對與輸出報告變成可重複的流程。
Surf Skill 和 Surf CLI 的意義就在這裡。它讓 Claude Code 不只會寫文字，也能開始接觸即時加密數據。當你的 AI 能查市場、看錢包、比對社群聲量與鏈上指標，你就能把更多時間花在判斷資料背後的脈絡上。
未來的 Web3 投研，不會只是誰看得比較久，而是誰能更快建立一套可靠的資料驗證流程。Surf 不會替你做決策，但它可以讓你的 AI 更接近一個真正能協助研究的工作台。
⚠️ 免責聲明：本文僅供教育及資訊用途，不構成任何投資建議。加密貨幣市場涉及高風險，請在參與前充分了解相關風險並自行判斷。
更多 AI 工具實戰教學，歡迎持續追蹤 Chainlab，並訂閱 Chainlab YouTube 頻道。