CCDB Carbon Emission Factor Search

Queries the Carbonstop CCDB emission factor database via directly calling the public HTTP API.

Prerequisites

Zero dependencies. The tool uses a native Node.js script scripts/ccdb-search.mjs with built-in crypto and fetch. No API Key is needed.

Available Tools

This skill comes with a lightweight CLI script scripts/ccdb-search.mjs that can be executed directly.
You can execute it by running node /workspace/skills/skills/ccdb/scripts/ccdb-search.mjs (replace the path with the actual absolute path to the script).

1. Search Emission Factors (Formatted Output)

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

CODEBLOCK0

Parameters:

• * keyword: Search keyword, e.g., "electricity", "cement", "steel", "natural gas"
• INLINECODE6: (Optional) Target language for the search. Defaults to zh. Pass en for English.

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

2. Search Emission Factors (JSON Output)

Purpose: Operates the same as regular search, but returns structured JSON data. Highly recommended for programmatic handling and carbon emission calculations.

CODEBLOCK1

Parameters are identical to formatting search, just append the --json flag.

JSON Return Fields:

3. Compare Multiple Emission Factors

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

CODEBLOCK2

Parameters:

• * --compare: Flag to trigger comparison mode.
• INLINECODE22: List of search keywords, 1-5 items maximum.

Node.js One-Liner (Fallback)

If the script is somehow inaccessible, you can use this standalone Node.js snippet:

CODEBLOCK3

Usage Scenarios & Examples

Scenario 1: Query Emission Factor for a Specific Energy Source

User: What is the carbon emission factor for the Chinese power grid?

→ Action: Execute node /workspace/skills/skills/ccdb/scripts/ccdb-search.mjs "electricity" en or node /workspace/skills/skills/ccdb/scripts/ccdb-search.mjs "中国电网". Find the one corresponding to China and the most recent year.

Scenario 2: Carbon Emission Calculation

User: My company used 500,000 kWh of electricity last year, what is the carbon footprint?

→ Workflow:

1. 1. Search the "electricity" factor (preferably with --json), select China and the latest year.
2. Calculate Carbon Emissions = 500,000 kWh × Factor Value (in kgCO₂e/kWh).

Scenario 3: Comparing Energy Alternatives

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

→ Action: Execute INLINECODE27

Scenario 4: Querying Industry-Specific Data

User: What is the emission factor for the cement industry?

→ Action: Search using "cement".

Important Notes

1. 1. Prioritize China Mainland and the Latest Year: Unless the user specifies another region or year, implicitly prioritize data for China and the most recent year available.
2. Pay Close Attention to Unit Conversion: Different factors might have entirely different units (e.g., kgCO₂/kWh vs. tCO₂/TJ). Always double-check before doing mathematical calculations.
3. Data Authority / Providers: Take note of the publishing institutions (e.g., MEE, IPCC, IEA, EPA).
4. No Results Found? Use Synonyms: If the search yields empty results, attempt to use synonyms (e.g., translate your query, or map "power" → "electricity" → "grid").
5. Always Use JSON for Calculations: The --json format returns highly precise numerical figures that are ideal for programmatic multiplication.