upstream-alert

name

upstream-alert

description

Supply chain risk monitoring — check CPI, commodity prices, freight rates, trade data, and global news to assess risk for any commodity. Uses Yahoo Finance, FRED, Commodities-API, UN Comtrade, World Bank, NewsData, and Gemini AI. Covers 20 items across 8 categories (construction, energy, food, electronics, packaging, chemicals, textiles, electrical). Bring your own API keys (free tiers available). Trigger keywords: supply chain, risk, CPI, freight, import, export, trade, commodity, price trend, supply disruption, shipping cost, inflation, economic indicator.

upstream-alert — Supply Chain Risk Monitor

Installation

pip install upstream-alert

Environment Variables

Set API keys before use. Only GEMINI_API_KEY is required; World Bank and Yahoo Finance work without keys.

# Required
export GEMINI_API_KEY="your_gemini_key"

# Optional (enables more data sources)
# Yahoo Finance: no key needed — daily commodity futures (copper, aluminum, soybean, cotton, coffee)
# Install with: pip install upstream-alert[yahoo]
export FRED_API_KEY="your_fred_key"
export COMMODITIES_API_KEY="your_commodities_key"
export COMTRADE_API_KEY="your_comtrade_key"
export NEWSDATA_API_KEY="your_newsdata_key"
export FBX_API_KEY="your_fbx_key"

Supported Item Categories (20 items)

Category	Examples
建材 (Construction)	鋼筋, 合板, 水泥
機電 (Electrical)	電線電纜
能源 (Energy)	柴油, 汽油, 天然氣
食品原料 (Food)	黃豆, 麵粉, 棕櫚油, 砂糖, 咖啡豆
電子零件 (Electronics)	晶片 MCU, 被動元件
包材 (Packaging)	瓦楞紙箱, PE 膜
化工 (Chemicals)	塑膠粒, 工業酒精
紡織 (Textiles)	棉紗, 滌綸纖維

Usage

CLI Commands

# Risk check
upstream-alert check "咖啡豆" --country TW

# JSON output
upstream-alert check "semiconductor" --country US -j

# Market pulse
upstream-alert pulse --country JP

# Show data sources
upstream-alert sources

Python API

from upstream_alert import check_risk

result = check_risk("coffee", country="US")
print(result.score, result.level, result.ai_summary)

When to Use

Use when the user asks about:

• Supply chain risks for a product or commodity
• Real-time commodity prices (metals, energy, food, textiles)
• Price trends (CPI, PPI, inflation data)
• Shipping / freight cost trends
• Trade data for imports/exports
• Economic indicators for a country
• News analysis related to supply chain disruptions

Trigger Keywords

supply chain, risk, CPI, freight, import, export, trade, commodity, price trend, supply disruption, shipping cost, inflation, PMI, economic indicator, commodity price