AGENT SKILL

yfinance

Access Yahoo Finance data — stock prices, history, financials, options, dividends, news, and market screeners

License 许可
MIT
最近更新
2026-06-07
Stars
★ 0
Forks
1

01 前言 Front Matter

name
yfinance
description
Access Yahoo Finance data — stock prices, history, financials, options, dividends, news, and market screeners

03 SKILL.md 正文

YFinance MCP Server

Access real-time and historical financial data from Yahoo Finance. This MCP server provides 12 tools covering stock prices, company fundamentals, analyst recommendations, options chains, dividends, market movers, and news.

Available Tools

Stock Data (7 tools)

tool_get_stock_price — Current Price & Trading Metrics

tool_get_stock_price(symbol: "AAPL")
tool_get_stock_price(symbol: "BBCA.JK")

Returns: current price, change %, open, day high/low, volume, 52-week range, market cap, P/E, dividend yield, direction (▲/▼).

tool_get_stock_info — Company Details

tool_get_stock_info(symbol: "MSFT")

Returns: sector, industry, full name, market cap, P/E, P/B, profit margins, revenue growth, analyst price targets, business description.

tool_get_history — Historical OHLCV Data

tool_get_history(symbol: "AAPL", period: "1mo", interval: "1d")
tool_get_history(symbol: "BBCA.JK", period: "1y", interval: "1wk")
tool_get_history(symbol: "BTC-USD", period: "5y", interval: "1mo")
  • period: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
  • interval: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo

tool_get_financials — Financial Statements

tool_get_financials(symbol: "AAPL", statement_type: "income", quarterly: false)
tool_get_financials(symbol: "MSFT", statement_type: "balance_sheet", quarterly: true)
tool_get_financials(symbol: "GOOG", statement_type: "all")
  • statement_type: income, balance_sheet, cash_flow, all

tool_get_recommendations — Analyst Ratings

tool_get_recommendations(symbol: "TSLA")

Returns: recommendation trends (strongBuy, buy, hold, sell, strongSell), price targets (low, mean, median, high), and recent upgrades/downgrades.

tool_get_options — Options Chain

tool_get_options(symbol: "AAPL")
tool_get_options(symbol: "TSLA", expiration: "2025-03-21")

Returns: calls and puts with strike, last price, bid, ask, volume, open interest, implied volatility. Lists available expiration dates.

tool_get_dividends — Dividend History

tool_get_dividends(symbol: "JNJ")
tool_get_dividends(symbol: "BBCA.JK")

Returns: current yield, ex-date, payment rate, and historical dividend payments.


Market Analysis (3 tools)

tool_compare_stocks — Side-by-Side Comparison

tool_compare_stocks(symbols: "AAPL,MSFT,GOOG")
tool_compare_stocks(symbols: "BBCA.JK BBRI.JK BMRI.JK")

Compares up to 10 stocks on: price, change %, market cap, P/E, dividend yield, margins, revenue growth, analyst rating. Symbols can be comma or space separated.

tool_get_market_movers — Top Movers

tool_get_market_movers(mover_type: "gainers")
tool_get_market_movers(mover_type: "losers")
tool_get_market_movers(mover_type: "most_active")

tool_screen_stocks — Stock Screener

tool_screen_stocks(sector: "Technology", min_market_cap: 1000000000)
tool_screen_stocks(max_pe_ratio: 15, min_dividend_yield: 0.03)
tool_screen_stocks(sector: "Healthcare", exchange: "NMS")

All filters are optional and combinable:

  • sector: Technology, Healthcare, Financial Services, Energy, etc.
  • min_market_cap: in USD (e.g., 1000000000 = $1B)
  • max_pe_ratio: max trailing P/E (e.g., 25)
  • min_dividend_yield: as decimal (e.g., 0.03 = 3%)
  • exchange: NMS (NASDAQ), NYQ (NYSE), etc.

Search & News (2 tools)

tool_search_stocks — Find Tickers

tool_search_stocks(query: "Apple", max_results: 5)
tool_search_stocks(query: "semiconductor ETF")
tool_search_stocks(query: "bank indonesia")

Searches stocks, ETFs, mutual funds, indices by name, ticker, or keyword.

tool_get_news — Latest News

tool_get_news(symbol: "AAPL", max_items: 5)
tool_get_news(symbol: "TSLA")

Returns: title, publisher, link, publish time, and thumbnail for each article.


Supported Markets

This server works with any ticker supported by Yahoo Finance:

Market Examples
US Stocks AAPL, MSFT, GOOG, TSLA, AMZN
Indonesia (IDX) BBCA.JK, BBRI.JK, TLKM.JK, BMRI.JK
Japan (TSE) 7203.T (Toyota), 6758.T (Sony)
UK (LSE) SHEL.L, AZN.L, HSBA.L
Hong Kong (HKEX) 0700.HK (Tencent), 9988.HK (Alibaba)
ETFs SPY, QQQ, VTI, VOO, ARKK
Crypto BTC-USD, ETH-USD, SOL-USD
Indices ^GSPC (S&P 500), ^IXIC (NASDAQ), ^JKSE (IDX)
Forex USDIDR=X, EURUSD=X, GBPUSD=X

Common Usage Patterns

Investment Research

  1. tool_search_stocks → find the ticker
  2. tool_get_stock_info → understand the company
  3. tool_get_financials → analyze fundamentals
  4. tool_get_recommendations → check analyst sentiment
  5. tool_get_history → review price trends

Portfolio Monitoring

  1. tool_compare_stocks → compare your holdings
  2. tool_get_stock_price → check current prices
  3. tool_get_news → stay updated on each position

Market Discovery

  1. tool_get_market_movers → find trending stocks
  2. tool_screen_stocks → filter by criteria
  3. tool_get_stock_info → deep dive on candidates

Installation

Quick Install (install.sh)

The included install.sh automates everything — uv setup, Python 3.12 venv, package install, mcporter config, and OpenClaw skill registration:

# Clone the repository on your server
git clone https://github.com/rizkydwicmt/yfinance-mcp-server.git
cd yfinance-mcp-server

# Run the installer
chmod +x install.sh
./install.sh

The installer will:

  1. ✅ Check for pyproject.toml in the project directory
  2. ✅ Install uv if not already present
  3. ✅ Create a Python 3.12 virtual environment
  4. ✅ Install yfinance-mcp-server + all dependencies
  5. ✅ Verify all 12 tools load correctly
  6. ✅ Add yfinance to your mcporter config (auto-detected)
  7. ✅ Install SKILL.md to OpenClaw skills directory

Environment Variables

Customize the installer behavior with environment variables:

# Change project location
YFINANCE_PROJECT_DIR=/opt/mcp/yfinance ./install.sh

# Use a different Python version
YFINANCE_PYTHON_VERSION=3.11 ./install.sh

# Custom venv location
YFINANCE_VENV_DIR=/opt/venvs/yfinance ./install.sh

# Specify mcporter config path
MCPORTER_CONFIG=/etc/clawd/mcporter.json ./install.sh

# Custom OpenClaw directory
CLAWD_DIR=/opt/clawd ./install.sh

# Skip mcporter / skill steps
SKIP_MCPORTER=true ./install.sh
SKIP_SKILL=true ./install.sh

Manual Install

# 1. Clone repository
git clone https://github.com/rizkydwicmt/yfinance-mcp-server.git
cd yfinance-mcp-server

# 2. Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 3. Create venv + install
uv venv .venv --python 3.12
uv pip install -e . --python .venv/bin/python

# 4. Add to mcporter.json
# {"mcpServers": {"yfinance": {"command": "/path/to/.venv/bin/yfin-mcp"}}}

# 5. Install skill
mkdir -p ${CLAWD_DIR}/skills/yfinance
cp SKILL.md ${CLAWD_DIR}/skills/yfinance/SKILL.md

Verify

# Check tools load
mcporter --config ${CLAWD_DIR}/config/mcporter.json list yfinance --schema

# Live test
mcporter --config ${CLAWD_DIR}/config/mcporter.json call yfinance.tool_get_stock_price symbol=AAPL

04 同仓库更多 Skills

javimosch
javimosch/open-claw-skills

crowd-prompting

A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.

★ 0
javimosch
javimosch/open-claw-skills

ceaser

Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).

★ 0
javimosch
javimosch/open-claw-skills

ceaser-send

Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.

★ 0
javimosch
javimosch/open-claw-skills

dilemm-ai

Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).

★ 0
javimosch
javimosch/open-claw-skills

moldium

Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.

★ 0
javimosch
javimosch/open-claw-skills

arxiv-paper-reviews

Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.

★ 0