無料GitHub で公開日本語紹介

stocks

株価や暗号資産の価格を調べ、企業名から銘柄を探せるスキル。Yahoo Financeのデータで過去の値動きや期間の騰落率を確認し、複数銘柄を比較します。

原文原文の説明を見る

Stock quotes, history, search, compare, crypto via Yahoo.

NousResearch/hermes-agent

インストール方法を見る

こんなときに便利

株価や暗号資産の価格確認
企業名から銘柄コードを探したいとき
過去の値動きと騰落率の確認
複数銘柄を並べて比較したいとき

日本語での紹介

できること

株価や暗号資産の価格を取得し、過去の値動きや複数銘柄の比較をまとめます。企業名から銘柄コードを探す検索にも対応します。Yahoo Financeのデータを使い、株価、騰落率、出来高、52週の高値・安値などを確認します。履歴では日ごとの始値・高値・安値・終値と出来高に加え、期間内の最小値、最大値、平均値、騰落率を取得します。

こんなときに便利

気になる企業の株価を確認したいときや、複数銘柄の値動きを並べて見たいときに向いています。履歴の期間は1か月から5年まで選べ、結果はJSONという構造化された形式で出力されます。

使い方の例

「AAPLとMSFTの株価を比較して」
「Teslaの銘柄コードを探して」
「NVDAの過去6か月の値動きを調べて」

注意点

Python 3.8以上が必要です。標準ライブラリだけで動き、基本利用にAPIキーは不要です。Yahoo Financeの非公式APIを使うため、取得制限や仕様変更で失敗する場合があります。時価総額などの欠損を補う用途では、任意のALPHA_VANTAGE_KEYを使えます。読み取り専用で、注文や口座連携には対応しません。

この紹介文は、公開されている SKILL.md をもとに AI（Claude Haiku）が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル（2）

SKILL.md2.7 KB
scripts/stocks_client.py24.3 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Stocks Skill

Read-only market data via Yahoo Finance. Five commands: quote, search, history, compare, crypto. Python stdlib only — no API key, no pip installs. Yahoo's endpoint is unofficial and may rate-limit or change.

When to Use

User asks for a current stock price (AAPL, TSLA, MSFT, ...)
User wants to look up a ticker by company name
User wants OHLCV history or performance over a date range
User wants to compare several tickers side by side
User asks for a crypto price (BTC, ETH, SOL, ...)

Prerequisites

Python 3.8+ stdlib only. Optional: set ALPHA_VANTAGE_KEY to enrich market_cap, pe_ratio, and 52-week levels when Yahoo's crumb-protected fields come back null. Free key: https://www.alphavantage.co/support/#api-key

How to Run

Invoke through the terminal tool. Once installed:

SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py
python $SCRIPT quote AAPL

All output is JSON on stdout — pipe through jq if you want to slice it.

Quick Reference

python $SCRIPT quote AAPL
python $SCRIPT quote AAPL MSFT GOOGL TSLA
python $SCRIPT search "Tesla"
python $SCRIPT history NVDA --range 6mo
python $SCRIPT compare AAPL MSFT GOOGL
python $SCRIPT crypto BTC ETH SOL

Commands

`quote SYMBOL [SYMBOL2 ...]`

Current price, change, change%, volume, 52-week high/low.

`search QUERY`

Find tickers by company name. Returns top 5: symbol, name, exchange, type.

`history SYMBOL [--range RANGE]`

Daily OHLCV plus stats (min, max, avg, total return %). Ranges: 1mo, 3mo, 6mo, 1y, 5y. Default: 1mo.

`compare SYMBOL1 SYMBOL2 [...]`

Side-by-side: price, change%, 52-week performance.

`crypto SYMBOL [SYMBOL2 ...]`

Crypto prices. Pass BTC (the script appends -USD automatically).

Pitfalls

Yahoo Finance's API is unofficial. Endpoints can change or rate-limit without notice — if requests start failing, that's why.
market_cap and pe_ratio may return null on quote when Yahoo's crumb session isn't established. Set ALPHA_VANTAGE_KEY to backfill.
Add a small delay between bulk requests to avoid rate-limiting.
This is read-only — no order placement, no account integration.

Verification

python ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL

Returns a JSON object with symbol: "AAPL" and a numeric price field.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ