ccdb

Original：🇨🇳 Chinese

Translated

1 scripts

CCDB Carbon Emission Factor Search Tool. Based on Carbonstop's CCDB database, query carbon emission factor data via ccdb-mcp-server. Supports keyword-based carbon emission factor search, retrieval of structured JSON data, and multi-keyword comparison. **Use this Skill when**: (1) Users query carbon emission factors (e.g., "power emission factor", "cement carbon emission", "natural gas emission coefficient", etc.) (2) Users need to calculate carbon emissions (require querying factors first then multiplying by activity volume) (3) Users need to compare carbon emission factors of different energy sources/materials (4) Users mention "CCDB", "carbon emission factor", "emission coefficient", "carbon footprint", "LCA", "emission factor" (5) Need to query carbon emission factor data for specific countries/regions and specific years

6installs

Sourcecarbonstop/skills

Added on2026-03-26

NPX Install

npx skill4agent add carbonstop/skills ccdb

SKILL.md Content (Chinese)

View Translation Comparison →

CCDB Carbon Emission Factor Search

Call Carbonstop's CCDB carbon emission factor database via ccdb-mcp-server.

Prerequisites

Global installation of ccdb-mcp-server is required:

bash

npm install -g ccdb-mcp-server

No API Key required, it's a public interface.

Available Tools

Bridge to

ccdb-mcp

CLI via

mcporter

in stdio mode, exposing 3 MCP tools:

1. search_factors — Search Carbon Emission Factors (Formatted Output)

Purpose: Search carbon emission factors by keyword, return human-readable formatted text.

bash

mcporter call ccdb-mcp --stdio -- search_factors '{"name":"电力","lang":"zh"}'

Parameters:

Parameter	Type	Required	Description
`name`	string	✅	Search keyword, e.g., "electricity", "cement", "steel", "natural gas"
`lang`	`"zh"` \| `"en"`	❌	Search language, default `zh`

Returns: Formatted text including factor value, unit, applicable region, year, publishing institution, etc.

2. search_factors_json — Search Carbon Emission Factors (JSON Output)

Purpose: Same as search_factors, but returns structured JSON suitable for programmatic processing and carbon emission calculation.

bash

mcporter call ccdb-mcp --stdio -- search_factors_json '{"name":"电力","lang":"zh"}'

Parameters are the same as

search_factors

.

Returned JSON Field Explanation:

Field	Description
`name`	Factor name
`factor`	Emission factor value
`unit`	Unit (e.g., kgCO₂e/kWh)
`countries`	Applicable countries/regions
`year`	Publication year
`institution`	Publishing institution
`specification`	Specification description
`description`	Description
`sourceLevel`	Factor level
`business`	Industry category
`documentType`	Document type

3. compare_factors — Multi-Keyword Carbon Emission Factor Comparison

Purpose: Compare carbon emission factors for up to 5 keywords simultaneously, for horizontal comparison of different energy sources/materials.

bash

mcporter call ccdb-mcp --stdio -- compare_factors '{"keywords":["电力","天然气","煤炭"],"lang":"zh"}'

Parameters:

Parameter	Type	Required	Description
`keywords`	string[]	✅	List of search keywords, 1-5 items
`lang`	`"zh"` \| `"en"`	❌	Search language, default `zh`

Calling Methods

This Skill bridges ccdb-mcp-server via

mcporter

CLI in stdio mode:

bash

# General format
mcporter call ccdb-mcp --stdio -- <tool_name> '<json_arguments>'

If

mcporter

hasn't configured ccdb-mcp yet, register first:

bash

mcporter add ccdb-mcp --command "ccdb-mcp" --args "--stdio"

Alternative Solution (directly use npx, no mcporter required):

bash

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"agent","version":"1.0.0"}}}' | npx -y ccdb-mcp-server --stdio 2>/dev/null

Or use the direct HTTP call script below (recommended, most lightweight).

Direct Call Script (Recommended · No MCP Server Installation Required)

The Skill comes with a lightweight CLI script

scripts/ccdb-search.mjs

, which directly calls CCDB's public HTTP API without any dependencies.

Search Factors (Formatted Output)

bash

node /workspace/skills/ccdb/scripts/ccdb-search.mjs "电力"
node /workspace/skills/ccdb/scripts/ccdb-search.mjs "cement" en

Search Factors (JSON Output, Suitable for Calculation)

bash

node /workspace/skills/ccdb/scripts/ccdb-search.mjs "电力" zh --json

Multi-Keyword Comparison

bash

node /workspace/skills/ccdb/scripts/ccdb-search.mjs --compare 电力 天然气 柴油
node /workspace/skills/ccdb/scripts/ccdb-search.mjs --compare 电力 天然气 --json

Node.js One-Liner (Alternative)

bash

node -e "const c=require('crypto'),n=process.argv[1],s=c.createHash('md5').update('mcp_ccdb_search'+n).digest('hex');fetch('https://gateway.carbonstop.com/management/system/website/searchFactorDataMcp',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({sign:s,name:n,lang:'zh'})}).then(r=>r.json()).then(d=>console.log(JSON.stringify(d,null,2)))" "电力"

Usage Scenarios & Examples

Scenario 1: Query Emission Factor of a Certain Energy Source

User: What is the carbon emission factor of China's power grid?

→ Search with keyword

"electricity"

or

"China Power Grid"

, filter for China region and latest year

Scenario 2: Carbon Emission Calculation

User: My company used 500,000 kWh of electricity last year, how much carbon emission is that?

→ Steps:

Search for
```
"electricity"
```
factor, select China and latest year
Carbon Emission = 500000 kWh × Factor Value (kgCO₂e/kWh)

Scenario 3: Comparison of Different Energy Sources

User: Compare the carbon emission factors of electricity, natural gas and diesel

→ Use

compare_factors

, keywords =

["electricity", "natural gas", "diesel"]

Scenario 4: Specific Industry Query

User: Carbon emission factor of the cement industry

→ Search for

"cement"

Notes

Prioritize factors from mainland China and the latest year (unless user specifies other regions)
Pay attention to unit conversion for factor values: Different factors may have different units (e.g., kgCO₂/kWh vs tCO₂/TJ)
Authority of data sources: Focus on publishing institutions (e.g., Ministry of Ecology and Environment, IPCC, IEA, etc.)
When no results are found: Try synonyms (e.g., "电" → "电力" → "电网" → "electricity")
Use JSON version for calculation scenarios:
```
search_factors_json
```
returns precise numerical values suitable for calculation

ccdb

NPX Install

Tags

SKILL.md Content (Chinese)

CCDB Carbon Emission Factor Search

Prerequisites

Available Tools

1. search_factors — Search Carbon Emission Factors (Formatted Output)

2. search_factors_json — Search Carbon Emission Factors (JSON Output)

3. compare_factors — Multi-Keyword Carbon Emission Factor Comparison

Calling Methods

Direct Call Script (Recommended · No MCP Server Installation Required)

Search Factors (Formatted Output)

Search Factors (JSON Output, Suitable for Calculation)

Multi-Keyword Comparison

Node.js One-Liner (Alternative)

Usage Scenarios & Examples

Scenario 1: Query Emission Factor of a Certain Energy Source

Scenario 2: Carbon Emission Calculation

Scenario 3: Comparison of Different Energy Sources

Scenario 4: Specific Industry Query

Notes