# Mining & Critical Minerals Intelligence — Jenko Analytics (`jenko_systems/mining-critical-minerals-intelligence`) Actor 2-layer mining intelligence engine: supply (USGS critical minerals risk JCM/JBR) and price (JTM technical signal on metals). Premium mode commodity\_full\_intelligence combines both layers with auto bull/bear narrative. - **URL**: https://apify.com/jenko\_systems/mining-critical-minerals-intelligence.md - **Developed by:** [Jenko Systems](https://apify.com/jenko_systems) (community) - **Categories:** News, Automation, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🪨 Mining & Critical Minerals Intelligence — Jenko Analytics **The most complete supply + price intelligence for mining and metals.** Two integrated layers — Supply chain risk and metal Price technical analysis — with Jenko proprietary metrics (JCM, JBR, JTM, JMI), each shipping with **inline formula, calculation breakdown, verdict scale, and benchmark comparisons**. **Status:** v1.0 — 8 modes operational. 4 Jenko metrics fully explained inline. ZERO third-party API keys required. --- ### 🇬🇧 English #### What's new in v1.0 (breaking change from v0.3) Every Jenko proprietary metric now includes inline: - **Formula** (mathematical equation + human-readable form) - **Calculation breakdown** (each component with raw input, weight, contribution, explanation) - **Verdict scale** (5 tiers with plain-English meaning) - **Example comparisons** (real benchmarks for context) - **Natural-language interpretation** of THIS specific score Dashboards now include a single `_methodology` block at the top, explaining the metric once before listing compact rows. #### 8 Available modes **🌟 Premium (1):** - `commodity_full_intelligence` — supply + price 2-in-1 with consolidated bullish/bearish narrative **📈 Price layer (4):** - `metal_technical_signal` — JTM full technical analysis - `metal_investment_thesis` — auto bull/bear narrative - `metal_price_history` — monthly history + stats - `metals_h2h` — two metals side-by-side **🌍 Supply layer (3):** - `commodity_overview` — single commodity + JCM/JBR full - `critical_minerals_dashboard` — JCM ranking with methodology block - `country_mining_profile` — country breakdown #### The 4 Jenko proprietary metrics ##### JCM — Jenko Critical Minerals Risk (0-100) Composite supply chain risk score for a critical mineral. ```` JCM = 0.40·HHI\_score + 0.35·import\_reliance + 0.15·reserves\_runway + 0.10·geopolitical\_flag ``` | Component | Weight | What it measures | |-----------|--------|------------------| | Concentration (HHI) | 40% | Herfindahl-Hirschman of country production shares | | US import reliance | 35% | USGS-reported net US import dependence (%) | | Reserves runway | 15% | Years of reserves at current production rate | | Geopolitical | 10% | Flag if top producer on US adversary list | | Range | Verdict | Meaning | |-------|---------|---------| | 0-25 | MINIMAL | Diversified, secure | | 25-45 | LOW | Multiple producers globally | | 45-60 | MODERATE | Some concentration | | 60-75 | HIGH | Significant risk | | 75-100 | EXTREME | Critical bottleneck | **Benchmark examples:** lithium 17.6 (MINIMAL), tin 55.5 (MODERATE), tungsten 72.1 (HIGH), gallium 91.5 (EXTREME). ##### JBR — Jenko Bottleneck Risk (categorical) Qualitative classification by top producer's share. Returns verdict (DIVERSIFIED → EXTREME_BOTTLENECK) plus flags: SINGLE_POINT_FAILURE, NEAR_MONOPOLY, DUOPOLY. ##### JTM — Jenko Technical Metal Signal (0-100) Composite technical setup for a metal's price series. ``` JTM = 0.30·trend + 0.25·momentum + 0.20·cycle\_position + 0.15·bollinger + 0.10·stochastic ``` Cycle position is **inverse of all-time percentile** — KEY for cyclical commodities, since they mean-revert. | Range | Verdict | |-------|---------| | 75-100 | STRONG_BUY | | 60-75 | ACCUMULATE | | 40-60 | NEUTRAL | | 25-40 | DISTRIBUTE | | 0-25 | SELL | ##### JMI — Jenko Mining Investment Score (0-100) Investment attractiveness combining price momentum + supply chain risk + reserves + strategic demand. ``` JMI = 0.40·price\_momentum + 0.30·supply\_risk + 0.15·reserves\_tightness + 0.15·strategic\_demand ```` Note: price_momentum is **inverted at extremes** — late-cycle blowoffs (YoY > +100%) penalized, mean-reversion territory (YoY < -20%) rewarded. #### Coverage - **14 critical minerals** (USGS MCS 2025): lithium, cobalt, nickel, graphite, rare_earths, copper, uranium, gallium, germanium, tungsten, manganese, platinum_group, tin, antimony, vanadium - **10 metals with prices** (Pink Sheet, 1960+): gold, silver, platinum, copper, aluminum, nickel, iron_ore, lead, zinc, tin #### Usage examples **🌟 Complete intelligence (premium):** ```json {"mode": "commodity_full_intelligence", "commodity": "copper"} ```` **📈 JTM technical signal:** ```json {"mode": "metal_technical_signal", "metal": "gold", "months": 240} ``` **📊 Critical minerals dashboard:** ```json {"mode": "critical_minerals_dashboard", "top_n": 15} ``` #### Pricing - **US$ 5 per 1,000 records** #### Data sources | Source | Coverage | License | |--------|----------|---------| | **USGS Mineral Commodity Summaries 2025** | Production/reserves 14 critical minerals | Public Domain | | **World Bank Pink Sheet** | Monthly prices 10 metals (1960-present) | CC BY 4.0 | #### Disclaimer ⚠️ **NOT financial advice.** JTM and JMI are analytical signals. *** ### 🇧🇷 Português #### O que mudou na v1.0 Cada métrica Jenko agora vem com: - **Fórmula matemática** (equação + tradução humana) - **Decomposição do cálculo** (cada componente com entrada, peso, contribuição, explicação) - **Escala de veredito** (5 tiers com significado) - **Comparações benchmark** (referências reais) - **Interpretação em linguagem natural** desse score específico Dashboards têm `_methodology` único no topo, explicando a métrica uma vez antes da lista. #### 4 Métricas Jenko proprietárias **JCM** — Risco de Critical Minerals (0-100, supply chain)\ **JBR** — Risco de Bottleneck (categórico)\ **JTM** — Sinal Técnico de Metal (0-100, BULLISHNESS)\ **JMI** — Score de Investimento em Mineração (0-100, atratividade) (Mesmas fórmulas da seção English acima.) #### Preço - **US$ 5 por 1.000 records** #### Disclaimer ⚠️ **NÃO é conselho financeiro.** Mercados de metais são voláteis. *** ### 🛠️ Local development ```bash pip install -r requirements.txt echo '{"mode": "commodity_full_intelligence", "commodity": "copper"}' > input.json python -m src.main ``` *** ### 📜 License Source proprietary. Data: USGS (Public Domain), World Bank (CC BY 4.0). Built by [Jenko Systems](https://jenkosystems.com). # Actor input Schema ## `mode` (type: `string`): Analysis mode. Premium: commodity\_full\_intelligence (supply + price). Flagship: metal\_technical\_signal (JTM). ## `commodity` (type: `string`): Commodity name: lithium, cobalt, nickel, graphite, rare\_earths, copper, uranium, gallium, germanium, tungsten, manganese, platinum\_group, tin, antimony, vanadium, gold, silver, platinum, aluminum. ## `metal` (type: `string`): Metal for Pink Sheet price analysis: gold, silver, platinum, copper, aluminum, nickel, iron\_ore, tin, zinc, lead. ## `metal_b` (type: `string`): Second metal for head-to-head comparison. ## `country` (type: `string`): Country name (China, Australia, United States, Chile, Democratic Republic of the Congo, etc). ## `category` (type: `string`): Filter critical\_minerals\_dashboard by category: battery, rare\_earth\_magnet, tech\_semiconductor, industrial, energy. ## `top_n` (type: `integer`): Number of top entries to return. ## `months` (type: `integer`): Months of price history for technical/historical modes. ## Actor input object example ```json { "mode": "commodity_full_intelligence", "commodity": "copper", "metal": "gold", "metal_b": "silver", "country": "China", "category": "battery", "top_n": 15, "months": 240 } ``` # Actor output Schema ## `results` (type: `string`): Dataset with Jenko metric records (JCM, JBR, JTM, JMI) including formula, breakdown, verdict scale, and benchmarks inline. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("jenko_systems/mining-critical-minerals-intelligence").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("jenko_systems/mining-critical-minerals-intelligence").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call jenko_systems/mining-critical-minerals-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jenko_systems/mining-critical-minerals-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Mining & Critical Minerals Intelligence — Jenko Analytics", "description": "2-layer mining intelligence engine: supply (USGS critical minerals risk JCM/JBR) and price (JTM technical signal on metals). Premium mode commodity_full_intelligence combines both layers with auto bull/bear narrative.", "version": "1.0", "x-build-id": "3gqcK7S0WLKugX5KI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jenko_systems~mining-critical-minerals-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jenko_systems-mining-critical-minerals-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jenko_systems~mining-critical-minerals-intelligence/runs": { "post": { "operationId": "runs-sync-jenko_systems-mining-critical-minerals-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jenko_systems~mining-critical-minerals-intelligence/run-sync": { "post": { "operationId": "run-sync-jenko_systems-mining-critical-minerals-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Analysis Mode", "enum": [ "commodity_full_intelligence", "metal_technical_signal", "metal_investment_thesis", "metal_price_history", "metals_h2h", "commodity_overview", "critical_minerals_dashboard", "country_mining_profile" ], "type": "string", "description": "Analysis mode. Premium: commodity_full_intelligence (supply + price). Flagship: metal_technical_signal (JTM).", "default": "commodity_full_intelligence" }, "commodity": { "title": "Commodity", "type": "string", "description": "Commodity name: lithium, cobalt, nickel, graphite, rare_earths, copper, uranium, gallium, germanium, tungsten, manganese, platinum_group, tin, antimony, vanadium, gold, silver, platinum, aluminum." }, "metal": { "title": "Metal (for price modes)", "type": "string", "description": "Metal for Pink Sheet price analysis: gold, silver, platinum, copper, aluminum, nickel, iron_ore, tin, zinc, lead." }, "metal_b": { "title": "Metal B (for h2h)", "type": "string", "description": "Second metal for head-to-head comparison." }, "country": { "title": "Country", "type": "string", "description": "Country name (China, Australia, United States, Chile, Democratic Republic of the Congo, etc)." }, "category": { "title": "Category filter (dashboard)", "type": "string", "description": "Filter critical_minerals_dashboard by category: battery, rare_earth_magnet, tech_semiconductor, industrial, energy." }, "top_n": { "title": "Top N results", "minimum": 3, "maximum": 50, "type": "integer", "description": "Number of top entries to return.", "default": 15 }, "months": { "title": "Months of history", "minimum": 24, "maximum": 600, "type": "integer", "description": "Months of price history for technical/historical modes.", "default": 240 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```