Critical Minerals Supply Chain Monitor

Monitor critical mineral supply chain risks using USGS, Federal Register, and OECD data. Real-time risk scoring, regulatory compliance tracking, and country dependency analysis.

Features

1. Mineral Risk Score (mineral_risk_score)

Calculate comprehensive risk scores (0-100) for individual minerals:

• Concentration Index: Production concentration across top producers
• Geopolitical Risk: Country-level political/sanctions risk
• Substitutability: Ease of switching to alternative materials
• Mitigation Strategies: Actionable recommendations

Supported minerals: Lithium, Cobalt, Nickel, Rare Earth Elements, Copper, Manganese, Tungsten, Vanadium, Graphite, Beryllium, and more.

2. Supply Chain Scan (supply_chain_scan)

Batch analyze multiple minerals (or all if empty):

• Risk categorization (CRITICAL / HIGH / MODERATE / LOW)
• Summary statistics and average risk score
• Sorted results by risk level

3. High-Risk Minerals (high_risk_minerals)

Quick identification of CRITICAL and HIGH risk minerals:

• Filtered results for immediate attention
• Full analysis data for each high-risk mineral

4. Regulatory Monitor (regulatory_monitor)

Track Federal Register documents for critical minerals:

• Real-time regulatory changes
• Filter by department (Commerce, Defense, Interior, EPA)
• Abstract summaries and publication dates
• Direct links to official documents

5. Regulatory Scan (regulatory_scan)

Monitor regulations across multiple minerals simultaneously:

• Batch regulatory tracking
• Error handling for unavailable minerals
• Consolidated view of compliance requirements

6. Country Dependency (country_dependency)

Analyze mineral production by country:

• List of minerals a country produces
• Estimated global production share
• Geopolitical risk assessment
• Top applications by mineral

7. Compare Countries (compare_countries)

Comparative analysis across multiple nations:

• Production concentration metrics
• Risk level comparison
• Top minerals by country
• Supply chain vulnerability assessment

8. Concentration Analysis (concentration_analysis)

Deep-dive into supply concentration risk:

• Herfindahl-Hirschman Index (HHI)
• Risk producer identification
• Concentration level classification
• Individual producer risk profiles

Input Parameters

For Single Mineral Analysis

{
  "tool": "mineral_risk_score",
  "mineral": "lithium"
}

For Batch Mineral Analysis

{
  "tool": "supply_chain_scan",
  "minerals": ["lithium", "cobalt", "nickel"]
}

For Country Analysis

{
  "tool": "country_dependency",
  "country": "China"
}

For Regulatory Tracking

{
  "tool": "regulatory_monitor",
  "mineral": "rare-earths"
}

Output Format

All outputs include:

• success: Boolean indicating successful analysis
• timestamp: ISO 8601 timestamp of analysis
• Tool-specific data fields

Example mineral risk score output:

{
  "success": true,
  "mineral": "Lithium",
  "riskScore": 92,
  "riskLevel": "CRITICAL",
  "analysis": {
    "concentrationIndex": 85,
    "geopoliticalRisk": 45,
    "substitutability": 25,
    "criticalityScore": 92
  },
  "topProducers": ["China", "Australia", "Chile", "Argentina", "Zimbabwe"],
  "uses": ["Batteries", "Ceramics", "Glass", "Pharmaceuticals"],
  "mitigations": [
    "Diversify supply chains away from top 2-3 producers",
    "Invest in recycling and circular economy solutions",
    "Support R&D for substitute materials",
    "Implement supply chain visibility and traceability",
    "Develop long-term contracts with stable suppliers"
  ],
  "timestamp": "2024-03-27T10:30:00.000Z"
}

Data Sources & Attribution

USGS Mineral Commodity Summaries

• Source: https://minerals.usgs.gov/minerals/pubs/commodity/
• License: Public Domain (U.S. Government)
• Data: Production statistics, uses, top producers, substitutability
• Attribution: U.S. Geological Survey (USGS)

Federal Register

• Source: https://www.federalregister.gov/api/v1/
• License: Public Domain (U.S. Government)
• Data: Regulatory documents, policy announcements, compliance notices
• Attribution: Federal Register (GPO)

OECD Data

• Source: https://data-explorer.oecd.org/
• License: Creative Commons Attribution 4.0 International (CC BY 4.0)
• Data: Economic indicators, trade statistics, policy research
• Attribution Required: © OECD. All rights reserved. https://www.oecd.org/

Pricing

Pay-per-use model: $0.05 USD per successful analysis

• One charge per Actor run regardless of tool selected
• No charge for failed runs
• Bulk analysis covered by single charge

Use Cases

1. Supply Chain Risk Management: Monitor dependencies on specific countries
2. Investment Due Diligence: Score critical mineral exposure for portfolio companies
3. Policy Compliance: Track regulatory changes affecting supply chains
4. Strategic Sourcing: Identify alternative suppliers and materials
5. Geopolitical Intelligence: Monitor sanctions and supply disruption risks

Technical Stack

• Runtime: Node.js 20
• Framework: Apify SDK v3
• API Clients: Axios for HTTP requests
• Deployment: Docker (Apify Platform)

Error Handling

• Timeouts: 30-second timeout on external API calls with graceful degradation
• Invalid Inputs: Clear error messages for missing required parameters
• API Failures: Fallback suggestions when Federal Register API unavailable
• No charge on error: Failed runs don't incur billing

Development

# Install dependencies
npm install

# Run locally
npm start

# Build for Apify
apify push --force

Contributing

Report issues or suggest improvements via Apify Actor forum.

License

Apache License 2.0

---

Last Updated: March 2024 Version: 1.0.0