ccdb

CCDB Carbon Emission Factor Search Tool. Based on the Carbonstop CCDB database, it queries carbon emission factor data directly via a lightweight script. Sup...

Security Scan

The skill's code and instructions are consistent with a lightweight CCDB emission-factor search tool that queries Carbonstop's public API and does not request unrelated credentials or system access.

Purpose & Capability

Name/description match the included Node script and SKILL.md. All required behavior (search, JSON output, compare) is implemented by the script and the external API it calls; no unrelated permissions or credentials are requested.

Instruction Scope

Runtime instructions and the script only instruct calling the Carbonstop API with search keywords and formatting results. They do not read local files, request environment secrets, or send data to unexpected endpoints. The SKILL.md does recommend defaulting to China/latest-year when unspecified, which is a functional heuristic but within scope.

Install Mechanism

No install spec (instruction-only) and included script is small and self-contained. There are no downloads from third-party URLs or archives to extract.

Credentials

The skill declares no environment variables, no credentials, and the code does not access hidden env vars or config paths. The only network destination is the Carbonstop gateway used for its stated purpose.

Persistence & Privilege

Skill is not always-enabled and does not request elevated persistence or modify other skills or system-wide settings. Autonomous invocation is allowed (platform default) but not combined with other concerning privileges.

Assessment

This skill appears to do exactly what it says: it sends your search keywords to Carbonstop's public API and returns emission-factor data. It does not require credentials or access to your files. Before installing, consider: (1) queries and keywords are transmitted to an external service (avoid sending proprietary or sensitive strings), (2) the skill's source/homepage is not provided here—if provenance matters, review the script in your environment or ask the publisher for a repo, and (3) ensure your agent runtime has a Node version with global fetch if you plan to run the included script locally.

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.

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

Parameters:

• keyword: Search keyword, e.g., "electricity", "cement", "steel", "natural gas"
• lang: (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.

node /workspace/skills/skills/ccdb/scripts/ccdb-search.mjs "electricity" en --json

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

JSON Return Fields:

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 details
description	Additional description
sourceLevel	Factor source level
business	Industry sector
documentType	Document/Source type

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.

node /workspace/skills/skills/ccdb/scripts/ccdb-search.mjs --compare 电力 天然气 柴油
node /workspace/skills/skills/ccdb/scripts/ccdb-search.mjs --compare electricity "natural gas" en
node /workspace/skills/skills/ccdb/scripts/ccdb-search.mjs --compare electricity "natural gas" --json

Parameters:

• --compare: Flag to trigger comparison mode.
• keywords: 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:

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:'en'})}).then(r=>r.json()).then(d=>console.log(JSON.stringify(d,null,2)))" "electricity"

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. 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 node /workspace/skills/skills/ccdb/scripts/ccdb-search.mjs --compare "electricity" "natural gas" "diesel" en

Scenario 4: Querying Industry-Specific Data

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

→ Action: Search using "cement".

Important Notes

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.