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.
pip install upstream-alert
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"
| Category | Examples |
|---|
| 建材 (Construction) | 鋼筋, 合板, 水泥 |
| 機電 (Electrical) | 電線電纜 |
| 能源 (Energy) | 柴油, 汽油, 天然氣 |
| 食品原料 (Food) | 黃豆, 麵粉, 棕櫚油, 砂糖, 咖啡豆 |
| 電子零件 (Electronics) | 晶片 MCU, 被動元件 |
| 包材 (Packaging) | 瓦楞紙箱, PE 膜 |
| 化工 (Chemicals) | 塑膠粒, 工業酒精 |
| 紡織 (Textiles) | 棉紗, 滌綸纖維 |
# 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
from upstream_alert import check_risk
result = check_risk("coffee", country="US")
print(result.score, result.level, result.ai_summary)
Use when the user asks about:
supply chain, risk, CPI, freight, import, export, trade, commodity, price trend, supply disruption, shipping cost, inflation, PMI, economic indicator, commodity price