Commodity Profile Generator
Generate comprehensive commodity profiles by orchestrating calls to multiple mineral-claw skills. Profiles cover production data (BGS), trade flows (Comtrade), supply chain risk metrics, recent research, export restriction policies, and web intelligence from news/blog/government sources.
Usage
Full profile:
python3 {baseDir}/scripts/generate_profile.py --commodity "Lithium"
Select sections:
python3 {baseDir}/scripts/generate_profile.py --commodity "Cobalt" --sections production,risk,intel
JSON output:
python3 {baseDir}/scripts/generate_profile.py --commodity "Rare earths" --format json
Parameters
| Parameter |
Description |
Default |
--commodity |
Commodity name (BGS naming) |
Required |
--year |
Target year |
latest available |
--sections |
Comma-separated sections: production, trade, risk, research, policy, intel |
all |
--intel-max-results |
Max web-intel records to process |
20 |
--format |
Output format: summary, json |
summary |
Profile Sections
| Section |
Data Source |
Description |
production |
bgs-production |
Top producers, global output, rankings |
trade |
comtrade-trade |
Import/export flows, major partners |
risk |
supply-chain-analysis |
HHI, NIR, top-3 share, trend |
research |
literature-meta-search |
Recent publications, citation leaders |
policy |
export-restrictions |
Active restrictions, policy changes |
intel |
minerals-news-monitor + minerals-gov-monitor + minerals-web-ingest |
Recent web signals, policy tags, high-confidence findings |
Examples
# Full lithium profile
python3 {baseDir}/scripts/generate_profile.py --commodity "Lithium"
# Cobalt production, risk, and web-intel
python3 {baseDir}/scripts/generate_profile.py --commodity "Cobalt" --sections production,risk,intel
# Graphite profile in JSON
python3 {baseDir}/scripts/generate_profile.py --commodity "Graphite" --format json --year 2022
Notes
- Orchestrates multiple skill scripts (may take 30-90 seconds)
- Some sections may fail if API keys are not set (warnings printed to stderr)
- Trade section requires
UNCOMTRADE_API_KEY
- Research section requires
SERPAPI_KEY for Scholar results
- Intel section requires
requests and beautifulsoup4 in the active Python environment
- Intel ingest can optionally use Firecrawl when
FIRECRAWL_API_KEY is set
- For individual data queries, use source skills directly
1---2name: commodity-profile3description: Generate comprehensive one-page commodity profiles with production, trade, risk, research, policy, and web intelligence data4---56# Commodity Profile Generator78Generate comprehensive commodity profiles by orchestrating calls to multiple mineral-claw skills. Profiles cover production data (BGS), trade flows (Comtrade), supply chain risk metrics, recent research, export restriction policies, and web intelligence from news/blog/government sources.910## Usage1112### Full profile:13```bash14python3 {baseDir}/scripts/generate_profile.py --commodity "Lithium"15```1617### Select sections:18```bash19python3 {baseDir}/scripts/generate_profile.py --commodity "Cobalt" --sections production,risk,intel20```2122### JSON output:23```bash24python3 {baseDir}/scripts/generate_profile.py --commodity "Rare earths" --format json25```2627## Parameters2829| Parameter | Description | Default |30|-----------|-------------|---------|31| `--commodity` | Commodity name (BGS naming) | Required |32| `--year` | Target year | latest available |33| `--sections` | Comma-separated sections: production, trade, risk, research, policy, intel | all |34| `--intel-max-results` | Max web-intel records to process | 20 |35| `--format` | Output format: summary, json | summary |3637## Profile Sections3839| Section | Data Source | Description |40|---------|------------|-------------|41| `production` | bgs-production | Top producers, global output, rankings |42| `trade` | comtrade-trade | Import/export flows, major partners |43| `risk` | supply-chain-analysis | HHI, NIR, top-3 share, trend |44| `research` | literature-meta-search | Recent publications, citation leaders |45| `policy` | export-restrictions | Active restrictions, policy changes |46| `intel` | minerals-news-monitor + minerals-gov-monitor + minerals-web-ingest | Recent web signals, policy tags, high-confidence findings |4748## Examples4950```bash51# Full lithium profile52python3 {baseDir}/scripts/generate_profile.py --commodity "Lithium"5354# Cobalt production, risk, and web-intel55python3 {baseDir}/scripts/generate_profile.py --commodity "Cobalt" --sections production,risk,intel5657# Graphite profile in JSON58python3 {baseDir}/scripts/generate_profile.py --commodity "Graphite" --format json --year 202259```6061## Notes6263- Orchestrates multiple skill scripts (may take 30-90 seconds)64- Some sections may fail if API keys are not set (warnings printed to stderr)65- Trade section requires `UNCOMTRADE_API_KEY`66- Research section requires `SERPAPI_KEY` for Scholar results67- Intel section requires `requests` and `beautifulsoup4` in the active Python environment68- Intel ingest can optionally use Firecrawl when `FIRECRAWL_API_KEY` is set69- For individual data queries, use source skills directly
lamm-mit