| name | global-stock-analysis |
| description | Global stock analysis (US, China & EU stock markets, technicals, fundamentals, etc) powered by NASDAQ's official data provider Alpha Vantage. 全球股票分析（包括美股、A股和欧洲股市、技术面分析、基本面分析等）。 Use when this capability is needed. |
| metadata | {"author":"alphavantage"} |
Global Stock Analysis
Use these workflows to research stocks, evaluate companies, read technical signals, and monitor macro conditions — all from the terminal.
Tutorial
Watch the end-to-end installation tutorial, from procuring a fresh Mac VM (or Mac mini), to installing OpenClaw, to installing and using the skill: https://www.youtube.com/watch?v=Z6DjYKN4uos
Setup
- Install:
pip install marketdata-cli or uv tool install marketdata-cli --force or run directly with uvx marketdata-cli
- Set API key (one of):
export ALPHAVANTAGE_API_KEY=your_key- Add
ALPHAVANTAGE_API_KEY=your_key to a .env file
- Pass
-k your_key on each command
Get a free key at https://www.alphavantage.co/support/#api-key
Workflows
1. Quick Stock Lookup
Get a snapshot of where a stock is right now — price, recent history, and news.
marketdata-cli global_quote AAPL
marketdata-cli time_series_daily AAPL
marketdata-cli news_sentiment --tickers AAPL
marketdata-cli time_series_intraday AAPL --interval 5min
2. Fundamental Analysis
Evaluate a company's financial health: overview, financials, earnings, dividends, and insider activity.
See fundamentals.md for the full step-by-step guide.
3. Technical Analysis
Assess trend, momentum, volatility, and volume signals.
See technicals.md for the full step-by-step guide.
4. Macro & Market Overview
Check economic conditions, commodities, market movers, and upcoming events.
See macro.md for the full step-by-step guide.
5. Sector / Multi-Stock Comparison
Compare fundamentals or technicals across multiple tickers by running the same commands for each symbol:
marketdata-cli company_overview AAPL
marketdata-cli company_overview MSFT
marketdata-cli company_overview GOOGL
See comparison.md for more examples.
6. Forex & Crypto
Exchange rates and price history for currencies and cryptocurrencies.
See forex-crypto.md for the full step-by-step guide.
7. Options Chain
Inspect US options chains, greeks, and put/call sentiment — realtime or historical.
marketdata-cli realtime_options AAPL
marketdata-cli realtime_options AAPL --require_greeks --expiration 2026-06-19
marketdata-cli realtime_options_fmv AAPL --expiration 2026-06-19
marketdata-cli realtime_put_call_ratio SPY
marketdata-cli historical_options AAPL --date 2024-01-15
marketdata-cli historical_put_call_ratio SPY --date 2024-01-15
See options.md for the full step-by-step guide.
Quick Reference
Run marketdata-cli --help for the full list of 100+ commands, or marketdata-cli <command> --help for any specific command.
| Flag | Description |
|---|
-k, --api-key | API key (overrides env var) |
-v, --verbose | Enable verbose logging |
-h, --help | Show help for any command |
- Most stock commands accept a positional SYMBOL argument (e.g.,
marketdata-cli global_quote AAPL)
- Forex commands use
--from_symbol / --to_symbol or --from_currency / --to_currency
- Technical indicators default to
daily interval if not specified
Source: alphavantage/alpha_vantage_mcp — distributed by TomeVault.
