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 集成