Agent Skill(CLI 工具)¶
下載 FinMind 的 /finmind 指令檔到 Claude Code、Codex、Cursor、Windsurf、Gemini 等 CLI / 編輯器工具,即可用自然語言查詢 FinMind 75+ 種資料集並實際抓取資料,不需要自己組 API 參數。
其他串接方式
- 網頁版 ChatGPT / Claude:用 llms.txt,免安裝。
- 支援 MCP 的工具:用 MCP Server,由工具自動呼叫。
本頁目錄
- 安裝:① 下載 Skill · ② 設定 Token · ③ 使用
- 使用範例:股價、籌碼面、基本面、期貨選擇權、總體經濟、圖表、進階分析
安裝¶
步驟 1: 下載 Skill¶
🍎 macOS / Linux 安裝指令
🪟 Windows(PowerShell)安裝指令
Windows 10/11 已內建 curl.exe,請把上方指令改用下列 PowerShell 版本(注意要打 curl.exe,因為 PowerShell 的 curl 是 Invoke-WebRequest 的別名、語法不同)。
若你用 WSL 或 Git Bash,則上方 macOS / Linux 的指令可直接照用,不需改寫。
步驟 2: 設定 Token¶
至 FinMind 註冊並驗證信箱後,取得 Token。
🍎 macOS / Linux 設定 Token
建議加到 ~/.bashrc 或 ~/.zshrc,這樣每次開終端都會自動載入。
🪟 Windows(PowerShell)設定 Token
PowerShell 不用 export,請改用:
$env:FINMIND_TOKEN="your_token_here" # 僅本次終端有效
setx FINMIND_TOKEN "your_token_here" # 永久保存(需重開終端才生效)
用 WSL 或 Git Bash 的話,export 與 ~/.bashrc 寫法與 macOS / Linux 相同。
步驟 3: 使用¶
在 Claude Code 中輸入 /finmind,後面接你想查詢的內容:
範例¶
以下查詢請在前面加
/finmind。若你用的是 MCP,直接用自然語言提問即可。
股價查詢¶
預期結果:回傳台積電(2330)近一個月的每日股價表格,包含日期、開盤價、最高價、最低價、收盤價、成交量等欄位。

預期結果:分別查詢台積電和鴻海近三個月股價,並以表格呈現兩檔股票的收盤價走勢比較。

籌碼面¶
預期結果:回傳台積電近一週外資、投信、自營商的每日買賣超張數。

預期結果:回傳台積電外資持股張數與持股比例的歷史資料表格。

基本面¶
預期結果:回傳台積電今年度各月份的營收數字。

預期結果:回傳台積電近五年的本益比(PER)、股價淨值比(PBR)、殖利率歷史資料。
期貨選擇權¶
預期結果:回傳台指期貨(TX)近一週的每日開高低收、成交量、未平倉量等資料。

預期結果:回傳台指選擇權(TXO)今日三大法人的多空交易口數與金額。
總體經濟¶
預期結果:回傳近半年 USD/TWD 的每日即期買入、賣出匯率。

預期結果:回傳 FED 近十年的利率調整歷史紀錄。
預期結果:回傳近一年的每日黃金價格。
圖表¶
預期結果:產生台積電近三個月的 K 線圖,包含開高低收、均線與成交量,儲存為圖片檔。

預期結果:產生兩檔股票收盤價的折線比較圖,儲存為圖片檔。

預期結果:產生 USD/TWD 匯率折線圖,儲存為圖片檔。
進階分析¶
預期結果:計算兩檔股票近一年的累積報酬率,並以表格或圖表呈現比較。
預期結果:整理台積電近三年的現金股利、股票股利、除息日、發放日等資訊。
預期結果:回傳今日台股加權指數每 5 秒的即時數值,呈現盤中走勢。