免费在 GitHub 公开中文介绍

stocks

查询股票和加密资产价格，按公司名称查找证券代码，并利用Yahoo Finance数据查看历史走势、区间涨跌幅和成交量，对比多只股票。

原文查看原文说明

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

NousResearch/hermes-agent

集成工具Yahoo Finance

AI 评分100分/ 100 查看安装方法

适用场景

查询股票和加密资产价格
按公司名称查找证券代码
查看历史走势和区间涨跌幅
并排比较多只股票

中文介绍

功能

获取股票和加密资产价格，汇总历史走势并比较多只股票，也可按公司名称搜索证券代码。使用Yahoo Finance数据，查询股价、涨跌幅、成交量及52周最高价和最低价。历史数据包含每日开盘价、最高价、最低价、收盘价和成交量，以及所选期间的最小值、最大值、平均值和涨跌幅。

适用场景

适合查询关注公司的股价，或并排查看多只股票的价格变化。历史查询可选择一个月至五年的时间范围，结果以JSON这一结构化格式输出。

使用示例

“比较AAPL和MSFT的股价。”
“查找Tesla的证券代码。”
“查询NVDA过去六个月的价格走势。”

注意事项

需要Python 3.8或更高版本，仅使用标准库，基本功能无需API密钥。由于使用Yahoo Finance非官方API，可能因请求限制或规则变更而获取失败。可选的ALPHA_VANTAGE_KEY可用于补充市值等缺失数据。该技能只读取数据，不支持下单或连接账户。

本介绍由 AI（OpenAI Codex）根据公开的 SKILL.md 撰写。准确的规格请查看下方原文。

客观评估

AI 仅根据 SKILL.md 的内容，从 4 个方面进行了评估。星标数和热度不计入评估。

指令清晰度能否看出何时使用、做什么: A良好明确说明了价格查询、搜索、历史、比较和加密资产五项命令及用途。
步骤具体性步骤、输入输出和示例是否具体: A良好提供了各命令的参数、时间范围、JSON输出字段和验证示例。
安全性发送数据、删除文件、执行命令等是否有说明: A良好说明了外部数据来源，并明确仅查询数据，不下单或连接账户。
安装难易度所需工具和 API 密钥是否少且有说明: A良好仅需Python 3.8或更高版本，基本使用无需密钥，并提供可选密钥的申请地址。

总分按每项 A=25 分、B=15 分、C=5 分相加。由 AI（OpenAI Codex）于 2026年10月19日评估。仅供参考，安装前请同时查看原文。

如果您认为评估有误，请申请复核

包含的文件（2）

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

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

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.

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能