---
title: "Usage data 現在可以在 Alchemy CLI 中查詢"
description: "透過 alchemy usage summary 和 alchemy usage timeseries 從終端機取得團隊的 compute 與成本資料。AI agent 也可以透過 Alchemy MCP Server 取得相同的資料。"
---

# Usage data 現在可以在 Alchemy CLI 中查詢

<ImageBlock
  src="https://media.alchemy.com/usage-data.png"
  alt="Alchemy CLI 中的使用數據"
  width={1920}
  height={900}
  priority
/>

用量資料現在可以透過 [Alchemy CLI](https://www.alchemy.com/docs/alchemy-cli#usage) 查詢。你可以直接在終端機拉取團隊的運算與成本資料，包含總量以及隨時間變化的明細。同一份資料也能透過 [Alchemy MCP Server](https://www.alchemy.com/docs/alchemy-mcp-server) 提供給 AI agent 使用，讓 agent 不需要額外整合就能看到你的團隊在消耗什麼資源。

在此之前，要查看用量得登入 [Dashboard](https://dashboard.alchemy.com/) 手動讀圖表，並沒有正規的程式化方式可以取得這些數字。現在有了。

## 你可以做什麼

大部分情況下，兩個指令就夠用。

- `alchemy usage summary` 會給你月初至今、過去 7 天、或過去 30 天的總量，同時以運算單位與美金呈現。
- `alchemy usage timeseries` 會給你同樣的數字，但以時間序列呈現，讓你看出流量與花費在哪個時間點發生變化。

兩者預設都會在終端機中以易讀的圖表呈現。加上 `--json` 就會改成結構化輸出，可以直接串接到腳本、儀表板或告警系統。

<CodeSnippet
  language="bash"
  code={`alchemy usage summary
alchemy usage timeseries`}
/>

若要取得機器可讀的輸出：

<CodeSnippet
  language="bash"
  code={`alchemy usage summary --json
alchemy usage timeseries --json`}
/>

## 用 Dashboard 的方式切分資料

你可以依 network、app、method 或 request type 來分組用量，並針對其中任一項做篩選，藉此回答像是哪個 app 在消耗最多運算量，或哪個 method 在半夜突然暴增之類的問題。用 `--granularity` 選擇以小時或天為單位呈現。這與 Dashboard 的用量檢視功能完全對等，Dashboard 仍是視覺化資料的權威來源。

幾個範例：

<CodeSnippet
  language="bash"
  code={`alchemy usage summary --metrics amount,usd
alchemy usage timeseries --group-by network --granularity day
alchemy usage summary --app-ids <id> --methods eth_getLogs`}
/>

## 讓你的 agent 具備用量意識

同一份用量資料也透過 Alchemy MCP Server 以兩個工具的形式提供：`get_usage_summary` 與 `get_usage_time_series`。把 agent 指向你的 MCP server，它就能把消耗量與成本納入推理的 context 之中，讓負責監控你基礎設施的 agent 也知道這套基礎設施花了多少錢。

如果你已經把 MCP server 接到 Cursor、Claude Code 或 Codex——可參考 [MCP 設定指南](https://www.alchemy.com/docs/alchemy-mcp-server) 或我們的 [MCP 公告](/blog/alchemy-mcp-server)——這些工具就會出現在 Alchemy 其他功能旁邊。如果你想讓 agent 知道如何在程式碼中呼叫 Alchemy API，可以搭配 [Agent Skills](https://www.alchemy.com/docs/alchemy-agent-skills) 使用；而 MCP 則是讓它在對話中取得即時用量資料的方式。

## 適合誰使用

如果你在建構 agent，或只是想要以程式化、可寫腳本的方式掌握團隊的用量，這就是為你準備的。開發過程中監控花費、把用量接進 agent 的 context、自建成本儀表板或預算告警、追查是哪個 network、app 或 method 造成運算量暴增——這些現在都能在你原本工作的地方完成。

## 開始使用

先確認你用的是 Node 22 或以上版本，然後安裝或更新 CLI：

<CodeSnippet
  language="bash"
  code={`npm install -g @alchemy/cli`}
/>

接著執行 `alchemy usage summary`，就能看到你的數字了。旗標與篩選條件可參考 [用量文件](https://www.alchemy.com/docs/alchemy-cli#usage)，或參考我們的 [用 Alchemy CLI 更快完成的 12 件事](/blog/12-things-faster-with-alchemy-cli) 這篇文章，了解完整的指令範圍。

CLI 與 MCP server 中的用量功能，是邁向讓 agent 與開發者都能直接操作的平台的又一步。更新 CLI、跑個指令，並告訴我們你接下來想看到什麼。