Taiwan Carbon Open Data (Unofficial)

io.github.taux-io由 GitHub 帳號 taux-io 發布v0.2.6更新於 Nov 14, 2026

Unofficial. Taiwan government emission factors for AI: electricity, fuels, refrigerants, inventory.

發布方自己的服務:Carbon Fyi

已驗證Streamable HTTP可網頁執行金融知識與記憶資料與分析

概覽

AI 產生的概覽

非官方服務,讓助理查詢台灣政府公布的排放係數,並進行可追溯、保留版本紀錄的排放量計算。

可以做什麼
  • 檢查服務狀態,並列出所整合的官方資料來源、授權與同步狀態
  • 依關鍵字、類別、類型、年度或單位搜尋排放係數,並查看單一係數的原始紀錄、邊界與使用限制
  • 依年度取得台灣官方電力排放係數,並把口語化的活動或會計科目描述對應到候選係數
  • 計算單筆或多筆活動的排放量,並檢查單位、年度與係數是否可直接計算
  • 建立範疇一、二、三的盤查清冊與小計,並比較兩次計算、拆分活動量與係數變動的影響
  • 列出係數的歷史版本,並查看官方來源是否可能過期或有待審核的差異
適用情境
適合需要依據台灣官方係數、而非憑記憶回答碳足跡或 ESG 問題的情況,也適合把用電、燃料、用水與冷媒等活動資料換算成可重現的排放量與盤查式彙總。
執行需求
遠端 Streamable HTTP 端點,MCP 端點不需註冊或 API 金鑰,全部為唯讀。若要自行在本機開發此專案需 Node 24 以上;同步產品碳足跡資料集需環境部 API 金鑰。
安裝前請注意
這是非官方服務,不是政府網站;結果僅供參考,不構成碳盤查認證或第三方查證。燃料係數以每兆焦耳公告,須由使用者提供低位熱值;冷媒年逸散率與混合冷媒成分比例也須使用者提供。2025 年電力係數依用途有三個數值,服務不會代為選擇。活動描述比對採關鍵字,可能帶出相近項目,需人工確認。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Taiwan Carbon Open Data (Unofficial),將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.taux-io%2Fcarbon-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "taiwan-carbon-open-data-unofficial": {
      "type": "http",
      "url": "https://carbon.taux.io/mcp"
    }
  }
}

README

Taiwan Carbon Open Data(非官方)

台灣碳排係數與碳排計算 MCP。讓 Claude、ChatGPT、Cursor、Codex 等支援 MCP 的 AI 客戶端查詢台灣政府公開的碳排放係數,做可追溯、可重現的排放量計算。

讓 AI 查得到官方碳排係數、算得出排放量,也說得清楚資料來源與計算依據。

這是 taux.io 的非官方公共資料服務,不是政府網站,與資料提供機關沒有隸屬關係。計算結果僅供參考,不構成碳盤查認證、第三方查證或法定合規保證。

目前狀態:已部署在 https://carbon.taux.io。

連線

端點:https://carbon.taux.io/mcp。Streamable HTTP,不需註冊、不需 API Key,唯讀。

bash
claude mcp add --transport http carbon https://carbon.taux.io/mcp

其他客戶端的設定方式見首頁。

目前收錄的資料

類別來源範圍
電力排碳係數經濟部能源署2005–2025。2025 年有三個數值:產業盤查使用 0.466、表燈非營業與包燈用戶 0.471、公用售電業 0.467(公斤CO2e/度)
自來水台灣自來水公司2007–2025(公斤 CO2/度)
自來水臺北自來水事業處2018–2025(公斤 CO2e/度)
燃料燃燒環境部 113 年 2 月 5 日公告固定燃燒 53 種、移動燃燒 5 筆,kg/TJ,分 CO2、CH4、N2O
冷媒等逸散環境部 113 年 2 月 5 日公告含氟氣體的溫暖化潛勢 46 筆;年逸散率由使用者提供;混合冷媒由使用者提供成分比例
產品碳足跡環境部 CFP_P_02透過 API 同步,需要 API 金鑰。實測 1,188 筆,其中 899 筆可計算、289 筆僅供查詢

來源、授權與每一項的限制見 docs/data-sources.md。

兩件容易誤會的事:

  • 燃料沒有「每公升」的官方係數。 環境部公告的是每兆焦耳的係數,計算時要自行提供低位熱值。服務不會假設熱值。
  • 2025 年的電力係數有三個。 組織盤查用 0.466。只給年度不給用途時,服務會三個都回,不會代為選擇。

MCP 工具

ping、list_data_sources、search_emission_factors、match_activity、get_emission_factor、get_electricity_factor、calculate_emissions、calculate_batch、build_inventory、compare_emissions、list_factor_versions、check_factor_updates、get_methodology。

定義在 src/tools.ts;參數說明在 /tools。

要把多筆活動整理成盤查清冊的樣子,用 build_inventory(REST:POST /api/v1/inventory)。它依範疇一、二、三分類,給各範疇小計、範疇一依氣體分列,以及範疇一加二的合計。會誤導的數字不給:混用 CO2 與 CO2e、有項目算不出來、或範疇三含產品碳足跡時,對應的小計或合計會附原因扣住。範疇分類是依係數類型的預設,可逐筆用 scope 覆寫。它只涵蓋你提供的活動,不是完整的盤查。

使用者的說法不是官方係數名稱時(「10 月電費」「塑膠原料採購」),用 match_activity:它回傳候選係數、單位是否相容、適用條件與待確認事項,不會代為選定。ERP 串接時可用它把會計科目對到係數,由人確認後把 factor_id 存起來重複使用。

REST API

與 MCP 共用同一套查詢與計算邏輯(src/service.ts)。全部唯讀。

GET  /api/v1/sourcesGET  /api/v1/factors?query=&category=&factor_type=&year=&unit=&limit=&offset=GET  /api/v1/factors/:id            (可加 ?version=)GET  /api/v1/factors/:id/versionsGET  /api/v1/electricity?year=&usage_type=GET  /api/v1/match?description=&unit=&year=&limit=POST /api/v1/calculatePOST /api/v1/calculate/batchPOST /api/v1/inventoryGET  /api/v1/statusGET  /health
bash
curl -s http://127.0.0.1:8787/api/v1/calculate \  -H 'content-type: application/json' \  -d '{"factor_id":"tw-electricity-2025-industry-inventory","quantity":12000,"quantity_unit":"kWh","year":2025}'# → "emissions_kg":"5592",附係數版本、來源網址與限制說明

失敗的形狀是 { "ok": false, "error": { "code", "message", "details" } }。文件在 /api/docs。

本機開發

需要 Node 24 以上。

bash
npm installnpm run db:local      # 套用 migrations 到本機 D1npm run dev           # http://127.0.0.1:8787npm run seed:local    # 另開終端機:觸發一次排程,把已審核的官方資料寫進本機 D1npm run smoke         # 端到端檢查

資料庫只由排程寫入。seed:local 觸發的排程會匯入已審核資料、向能源署的開放資料 CSV 做一次交叉檢查,並同步 CFP_P_02(沒有金鑰就略過)。要同步 CFP_P_02,把 .dev.vars.example 複製成 .dev.vars 並填入環境部 API 金鑰。

bash
npm test                              # 全部測試,離線npx vitest run test/engine.test.ts    # 單一檔案npm run typechecknpm run dry-run                       # 確認 Worker 能 bundle

測試結果

2026-11-13 在開發機上的結果:

  • npm test:8 個檔案、243 項測試全部通過。
  • npm run typecheck、npm run dry-run:通過。
  • npm run smoke(本機 wrangler dev 與本機 D1):24 項檢查全部通過,包含兩個 MCP 協定版本的 initialize、tools/list、tools/call,以及 REST 計算。12,000 kWh 的 2025 年產業用電算出 5,592 kgCO2e,係數 0.466 讀自資料庫。
  • 同一次排程向能源署開放資料 CSV 做了真實的交叉檢查:CSV 的 21 個年度與已審核資料一致。
  • 引擎重現了環境部《溫室氣體排放量盤查作業指引 113 年版》的柴油與天然氣算例,各氣體到小數第四位相符。
  • 以環境部會員金鑰在本機做了真實的 CFP_P_02 同步:1,188 筆全部匯入,金鑰沒有出現在狀態端點或日誌。
  • 正式環境:npm run smoke -- https://carbon.taux.io 目前 25 項(2026-11-13)檢查全部通過。第一次排程從 Cloudflare 連上了能源署與環境部,交叉檢查一致,CFP_P_02 同步 1,188 筆。
  • 透過 claude.ai 的 MCP 連接器對正式環境實際呼叫工具:三個示範問句共六次呼叫,結果與預期一致,包含冷媒缺少計算依據時回 missing_refrigerant_basis。紀錄在 docs/claude-directory-submission.md 的「連接器實測紀錄」。
  • 限流有兩層,都實測過:zone 的 WAF 規則擋平行洪水(平行 300 次中 193 次得到 429),Worker 內的限流擋單一連線的失控迴圈。WAF 規則與 twse-mcp 共用計數。見 docs/deployment.md 的「限流」。
  • 網站已用無頭 Chrome 檢查三個語系、手機與桌面寬度、深淺色共 12 種組合(無水平捲動、對比足夠),並目視看過截圖。

正式環境另有每日自動檢查(對照表、冒煙測試、MCP Registry 條目),失敗時會開 issue,見 docs/deployment.md。

沒有驗證的事:

  • AI 用戶端在對話中的行為。連接器實測是直接呼叫工具,而且執行測試的 AI 事先知道流程。全新的對話收到自然語言的問句時會不會自己選對工具、會不會先問缺少的資料,沒有驗證過。
  • Claude 以外的用戶端(ChatGPT、Cursor、Codex)沒有連線測試過。
  • 網站沒有在實體手機上看過。

已完成與未完成

已完成:

  • Worker、MCP Server(13 個工具,無狀態,兩個協定版本)、REST API、D1 schema 與 migration。
  • 精確十進位計算引擎:單位檢查、年度規則、燃料熱值路徑、批次合計條件、比較拆解。
  • 係數版本管理:內容改變時保留舊版本,可用 factor_id 加 factor_version 重現過去的計算。
  • 資料同步:已審核資料匯入、能源署 CSV 交叉檢查、CFP_P_02 同步程式與異常防護。
  • 三語首頁、工具說明、API 文件、llms.txt、llms-full.txt、sitemap、robots、JSON-LD。
  • 限流、body 上限、CORS 白名單、拒絕 JSON-RPC 批次。

未完成或待驗證:

  • 用詞對照只涵蓋常見品項。 match_activity 靠 src/concepts.ts 的對照表把「塑膠原料」「電費」「公務車加油」對到候選係數;表裡沒有的說法(例如差旅、住宿)對不到。比對的是名稱裡的字,所以「聚丙烯」也會帶出「聚丙烯腈棉」,要由使用者確認。以包、瓶、片等件數計的係數只能查、不能算。
  • 用水以外的擴充來源(運輸、廢棄物):沒有找到邊界明確的官方結構化係數,未收錄。
  • 環境部公告的附表二製程與附表三的廢水、廢棄物:它們是公式與參數,不是可直接計算的係數。R-22 與碳氫冷媒不在官方表內,無法計算。
  • 政府檔案(能源署 PDF、環境部公告)的重製授權未能在官方頁面確認。

隱私

不需帳號、不設 Cookie、不記錄你問的內容與工具參數。Cloudflare 保存連線中繼資料最長 7 天。完整內容見 https://carbon.taux.io/privacy 與 PRIVACY.md。

授權

程式碼以 MIT 授權。資料屬各提供機關,標示政府資料開放授權條款-第1版者依該條款利用(https://data.gov.tw/license)。

來源:README.md,提交 9440f2e

工具

13

ping

Ping

Check that the service is up. Returns status, service name, version and server time. 確認服務狀態,回傳狀態、服務名稱、版本與伺服器時間。

無需輸入參數。

list_data_sources

List data sources

List the official Taiwan government sources behind this service, with dataset codes, URLs, licence, sync status and how many factors each holds. 列出本服務整合的官方資料來源:資料集代碼、網址、授權、同步狀態與係數數量。

無需輸入參數。

search_emission_factors

Search emission factors

Search official Taiwan emission factors by keyword, category, type, year or unit. Returns factor IDs to pass to get_emission_factor and calculate_emissions. Covers electricity, tap water, fuel combustion, refrigerants and other fluorinated gases (GWP values), and product carbon footprint factors; returns an explicit not-found message rather than a near match. Refrigerant blends such as R-410A are not listed: pass their components as refrigerant_blend to calculate_emissions, calculate_batch, compare_emissions or build_inventory. 以關鍵字、類別、類型、年度或單位搜尋台灣官方排放係數,回傳的係數 ID 可交給 get_emission_factor 與 calculate_emissions。目前收錄電力、自來水、燃料燃燒、冷媒等含氟氣體(溫暖化潛勢)與產品碳足跡;查不到會明確說明,不會給相近的替代品。R-410A 這類混合冷媒不在表內,請把成分以 refrigerant_blend 交給 calculate_emissions、calculate_batch、compare_emissions 或 build_inventory 計算。

輸入參數unityearlimitqueryoffsetcategoryfactor_type

match_activity

Match activity to candidate factors

Map an activity or ledger-account description (for example an electricity bill, fleet fuel, or a plastic resin purchase) plus an optional unit to candidate official factors. Returns candidates with unit compatibility, applicability conditions and the questions the user must answer; it never picks one. Use this when the user's wording is not an official factor name, then confirm with the user before calling calculate_emissions. The term mapping is curated by this service, not official. 把活動或會計科目的描述(例如電費、公務車加油、塑膠原料採購)與單位對到候選的官方係數,回傳每筆的單位相容性、適用條件與需要使用者回答的問題;不會代為選定。使用者的說法不是官方係數名稱時用這個工具,並在呼叫 calculate_emissions 之前先向使用者確認。用詞對照是本服務整理的,不是官方資料。

輸入參數unityearlimitdescription必填

get_emission_factor

Get emission factor

Get one factor in full by ID: the original government record, unit, applicable year, boundary, official source, version, whether it can be used for calculation directly, and usage limits. Find the ID with search_emission_factors first. 依係數 ID 取得完整資訊:官方原始紀錄、單位、適用年度、計算邊界、官方來源、版本、是否可直接計算與使用限制。請先用 search_emission_factors 找到 ID。

輸入參數versionfactor_id必填

get_electricity_factor

Get electricity factor

Get Taiwan's official electricity emission factor (kgCO2e/kWh) for a given year, published by the Energy Administration. From the 2025 factor year there are three values by usage; earlier years have one. Never substitutes another year: if the year is missing it says so and lists the years available. 查詢經濟部能源署公布的指定年度電力排碳係數(公斤CO2e/度)。114 年度(2025)起依用途有三個數值,之前每年一個。不會以其他年度代替:該年度沒有資料時會明說並列出可用年度。

輸入參數year必填usage_type

calculate_emissions

Calculate emissions

Calculate emissions for one activity: activity data × an official factor from the database. Checks units, the applicable year and whether the factor may be used for calculation, and returns the formula, kg and tonnes, the factor version and the source URL. Returns a clear error instead of guessing when the unit is incompatible, the year does not match or required data is missing (fuel factors need a user-supplied lower heating value; refrigerants need the basis of the quantity). A refrigerant blend such as R-410A can be calculated by passing refrigerant_blend with the user-supplied composition instead of factor_id. 計算單一活動的排放量:活動數據 × 資料庫中的官方係數。會檢查單位、適用年度與係數是否可用於計算,回傳公式、公斤與公噸、係數版本與來源網址。單位不相容、年度不符或缺少必要資料時(燃料係數需要使用者提供低位熱值,冷媒需要說明數量的依據)回傳明確錯誤,不會猜測。混合冷媒(如 R-410A)可不給 factor_id,改以 refrigerant_blend 提供使用者確認過的成分比例。

輸入參數yearquantity必填factor_idquantity_unit必填factor_versionoptional_contextrefrigerant_blend

calculate_batch

Calculate batch

Calculate several activities at once, each with its own factor and source. A total is given only when every item succeeded and the items share a gas basis and boundary type; otherwise the reason is stated. An item may be a refrigerant blend such as R-410A: pass refrigerant_blend with the user-supplied composition instead of factor_id; it stays one row in the results, and its components count toward the total. 批次計算多筆活動,逐筆回傳結果與來源。只有全部成功、氣體基礎與邊界類型一致時才提供合計,否則說明不提供的原因。混合冷媒(如 R-410A)的項目可不給 factor_id,改以 refrigerant_blend 提供使用者確認過的成分比例;結果仍是一筆一列,合計時以各成分計入。

輸入參數items必填

build_inventory

Build GHG inventory summary

Calculate several activities and arrange the results as a greenhouse gas inventory: grouped into Scope 1 (direct), Scope 2 (purchased energy) and Scope 3 (other indirect), with a subtotal per scope, Scope 1 by gas, and a Scope 1+2 total. Subtotals and totals are withheld, with the reason, when items mix CO2 and CO2e, when an item could not be calculated, or when Scope 3 holds product carbon footprints that may overlap Scopes 1 and 2. The scope assignment is this service's default by factor type and can be overridden per item. Covers only the activities supplied; it is not a complete or verified inventory. 計算多筆活動並整理成溫室氣體盤查清冊的形式:分為範疇一(直接排放)、範疇二(能源間接)、範疇三(其他間接),提供各範疇小計、範疇一依氣體分列,以及範疇一加二的合計。項目混用 CO2 與 CO2e、有項目算不出來、或範疇三含可能與範疇一、二重疊的產品碳足跡時,不提供對應的小計或合計並說明原因。範疇分類是本服務依係數類型的預設,可逐筆覆寫。只涵蓋你提供的活動,不是完整或經查證的盤查。

輸入參數items必填inventory_year

compare_emissions

Compare emissions

Compare two calculations (for example two years). Separates the effect of changed activity data from the effect of a changed factor, and flags when the calculation method differs so the difference is not read as an actual reduction. Either side may be a refrigerant blend such as R-410A (refrigerant_blend with the user-supplied composition instead of factor_id). Two blends with the same components are split component by component; blends with different components, or a blend against a single factor, get only the difference, because a blend has no official factor of its own. 比較兩筆計算(例如不同年度)。區分活動量改變與排放係數改變的影響;計算方法不同時會標示,避免把差異誤讀為實際減碳成效。兩邊都可以是混合冷媒(如 R-410A,以 refrigerant_blend 提供使用者確認過的成分比例,不給 factor_id)。成分相同的兩個混合冷媒逐成分拆解;成分不同,或單一係數對混合冷媒,只回差額,因為混合冷媒沒有官方公布的單一係數。

輸入參數baseline必填comparison必填

list_factor_versions

List factor versions

List every recorded version of one factor, newest first. Old versions are kept so past calculations can be reproduced. 列出指定係數的所有歷史版本(新的在前)。舊版本會保留,讓過去的計算可以重現。

輸入參數factor_id必填

check_factor_updates

Check factor updates

Show the sync status of each official source: when it was last checked, whether the data may be stale, and whether a difference from the official data is waiting for review. Read-only; it cannot trigger a sync or write anything. 查看各官方來源的同步狀態:最近檢查時間、資料是否可能過期、是否有與官方資料不一致而待審核的項目。唯讀,不能觸發同步或寫入。

無需輸入參數。

get_methodology

Get methodology

Explain the calculation methods, scope, data limits and official references. Read this before interpreting results or combining different kinds of factors. 說明計算方法、適用範圍、資料限制與官方依據。解讀結果或合併不同類型的係數之前請先閱讀。

輸入參數topic

版本歷史

2
  1. v0.2.6最新Nov 14, 2026
  2. v0.2.3Nov 13, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Carbon 整合