YahooClaw - Yahoo Finance API Integration
🔒 Security
- - ✅ No shell command execution
- ✅ All API calls use HTTPS
- ✅ Rate limiting implemented
- ✅ Open source and auditable
- ⚠️ API keys must be set via environment variables
- ℹ️ Uses in-memory caching for performance (no database)
Overview
YahooClaw is an OpenClaw skill that integrates Yahoo Finance API, providing real-time stock data queries, financial analysis, historical stock prices, and more.
Permissions
Required Permissions
- - ✅ Network Access: Yahoo Finance API (HTTPS)
- ✅ File Access: Local SQLite database storage (optional caching)
- ❌ No Admin/Root Privileges Required
- ❌ No System Command Execution
- ❌ No Access to User Privacy Data
Data Flow
- - Stock Data: Yahoo Finance API → Local Processing → Return Results
- No user data uploaded
- Temporary caching only (optional)
Use Cases
1. Real-time Stock Quotes
CODEBLOCK0
2. Company Information
CODEBLOCK1
3. Historical Data
CODEBLOCK2
4. Financial Metrics
CODEBLOCK3
5. Dividends
CODEBLOCK4
Usage Examples
Basic Usage
CODEBLOCK5
OpenClaw Integration
CODEBLOCK6
API Parameters
getQuote(symbol)
- - symbol: Stock code (e.g., AAPL, TSLA, 0700.HK)
- Returns: Real-time stock price, change, volume, etc.
getHistory(symbol, period)
- - symbol: Stock code
- period: Time period (1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max)
- Returns: Historical stock price data
getCompanyInfo(symbol)
- - symbol: Stock code
- Returns: Company information, market cap, P/E ratio, P/B ratio, etc.
getDividends(symbol)
- - symbol: Stock code
- Returns: Dividend history
Environment Variables
CODEBLOCK7
Notes
- 1. Data Delay: Yahoo Finance real-time data may have 15-minute delay
- Rate Limiting: Control request frequency to avoid rate limits
- HK/A-Shares: Supports HK stocks (0700.HK), A-shares (600519.SS), etc.
- Error Handling: Network issues or invalid codes will return error messages
Troubleshooting
Common Issues
- 1. Failed to Get Data
- Check network connection
- Verify stock code format
- Check Yahoo Finance service status
- 2. Data Delay
- This is normal, Yahoo Finance real-time data has delay
- Consider using paid API for truly real-time data
- 3. A-Share/HK Stock Code Format
- A-Shares: 600519.SS (Moutai)
- HK Stocks: 0700.HK (Tencent)
- US Stocks: AAPL (Apple)
Resources
Changelog
v1.0.0 (2026-03-12)
- - ✅ Security improvements
- ✅ Removed all test/debug files
- ✅ Fixed unicode characters
- ✅ Updated documentation
- ✅ Production ready
v0.1.0 (2026-03-09)
- - ✅ Initial release
- ✅ Real-time stock quotes
- ✅ Historical data queries
- ✅ Company information queries
- ✅ Dividend queries
- ✅ OpenClaw integration
License
MIT License
Author
PocketAI for Leo - OpenClaw Community
YahooClaw - Yahoo Finance API 集成
🔒 安全性
- - ✅ 不执行Shell命令
- ✅ 所有API调用均使用HTTPS
- ✅ 已实施速率限制
- ✅ 开源且可审计
- ⚠️ API密钥必须通过环境变量设置
- ℹ️ 使用内存缓存提升性能（无需数据库）
概述
YahooClaw是一个集成Yahoo Finance API的OpenClaw技能，提供实时股票数据查询、财务分析、历史股价等功能。
权限
所需权限
- - ✅ 网络访问：Yahoo Finance API（HTTPS）
- ✅ 文件访问：本地SQLite数据库存储（可选缓存）
- ❌ 无需管理员/根权限
- ❌ 不执行系统命令
- ❌ 不访问用户隐私数据
数据流
- - 股票数据：Yahoo Finance API → 本地处理 → 返回结果
- 不上传用户数据
- 仅临时缓存（可选）
使用场景
1. 实时股票报价
查询AAPL股价
特斯拉现在多少钱
NVDA最新股价
2. 公司信息
苹果市值是多少
微软的市盈率
谷歌的营收数据
3. 历史数据
显示过去30天AAPL股价
特斯拉上个月的走势
4. 财务指标
苹果的资产负债表
腾讯的利润表
5. 股息
AAPL的股息是多少
哪些股票股息率高
使用示例
基本用法
javascript
const YahooClaw = require(./src/yahoo-finance.js);
// 获取实时股票报价
const quote = await YahooClaw.getQuote(AAPL);
console.log(quote);
// 获取历史数据
const history = await YahooClaw.getHistory(TSLA, 1mo);
console.log(history);
// 获取公司信息
const info = await YahooClaw.getCompanyInfo(MSFT);
console.log(info);
OpenClaw集成
javascript
// 在OpenClaw代理中调用
const result = await tools.yahooclaw.getQuote({symbol: AAPL});
API参数
getQuote(symbol)
- - symbol：股票代码（例如：AAPL、TSLA、0700.HK）
- 返回：实时股价、涨跌幅、成交量等
getHistory(symbol, period)
- - symbol：股票代码
- period：时间周期（1d、5d、1mo、3mo、6mo、1y、2y、5y、10y、ytd、max）
- 返回：历史股价数据
getCompanyInfo(symbol)
- - symbol：股票代码
- 返回：公司信息、市值、市盈率、市净率等
getDividends(symbol)
环境变量
bash
可选：Alpha Vantage API（备用数据源）
获取地址：https://www.alphavantage.co/support/#api-key
ALPHA
VANTAGEAPI
KEY=yourapi
keyhere
可选：缓存数据库路径
DATABASE_PATH=./yahooclaw.db
注意事项
- 1. 数据延迟：Yahoo Finance实时数据可能有15分钟延迟
- 速率限制：控制请求频率以避免触发限制
- 港股/A股：支持港股（0700.HK）、A股（600519.SS）等
- 错误处理：网络问题或无效代码将返回错误信息
故障排除
常见问题
- 1. 获取数据失败
- 检查网络连接
- 验证股票代码格式
- 检查Yahoo Finance服务状态
- 2. 数据延迟
- 属于正常现象，Yahoo Finance实时数据存在延迟
- 如需真正实时数据，可考虑使用付费API
- 3. A股/港股代码格式
- A股：600519.SS（贵州茅台）
- 港股：0700.HK（腾讯）
- 美股：AAPL（苹果）
资源
更新日志
v1.0.0（2026-03-12）
- - ✅ 安全性改进
- ✅ 移除所有测试/调试文件
- ✅ 修复Unicode字符
- ✅ 更新文档
- ✅ 生产就绪
v0.1.0（2026-03-09）
- - ✅ 初始版本发布
- ✅ 实时股票报价
- ✅ 历史数据查询
- ✅ 公司信息查询
- ✅ 股息查询
- ✅ OpenClaw集成
许可证
MIT许可证
作者
PocketAI for Leo - OpenClaw社区
