核心用法
yahooclaw 是一款专注于全球金融市场数据查询的 OpenClaw 技能，通过与 Yahoo Finance API 深度集成，为用户提供股票实时行情、历史数据回溯、公司财务指标分析及股息分红信息等多维度功能。用户可通过自然语言或结构化调用方式，快速获取指定股票代码的当前价格、涨跌幅、成交量等实时行情；查询指定周期的历史走势数据（支持 1天至10年等多种时间跨度）；检索公司基本面信息如市值、市盈率、市净率等关键财务指标；以及获取股息分红历史记录。该技能支持全球主要市场，包括美股（如 AAPL、TSLA）、港股（如 0700.HK）及A股（如 600519.SS）等多种代码格式，满足跨市场投资分析需求。
显著优点
数据覆盖全面：依托 Yahoo Finance 这一全球知名的金融数据平台，覆盖股票、基金、指数等多元化资产类别，数据更新及时且稳定性高。使用门槛低：无需申请 API Key 即可使用基础功能，降低了普通投资者的数据获取门槛；同时支持 OpenClaw 原生集成，开发者可快速嵌入现有工作流。多市场兼容：原生支持美股、港股、A股等不同市场的股票代码格式，自动适配市场规则，无需额外配置。代码质量可靠：采用模块化架构与 ES6 规范，代码结构清晰，经过静态与动态双重安全检测，未发现高危安全风险。开源透明：MIT 许可证开源，源代码可审计，便于用户自主验证功能实现。
潜在缺点与局限性
数据延迟问题：Yahoo Finance 免费数据存在约15分钟延迟，无法满足高频交易或实时套利场景需求。请求频率限制：免费 API 存在访问频次上限，大量并发查询可能触发限流机制，影响使用体验。依赖外部服务：核心功能完全依赖 Yahoo Finance 及 yahoofinance2 npm 包，若第三方服务变更接口或停止维护，将导致功能中断。T3来源可信度：由个人开发者维护，虽代码开源可审计，但长期维护承诺与商业级 SLA 保障相对有限。数据使用限制：Yahoo Finance 数据仅供个人及研究用途，商业应用存在合规风险。错误处理简化：当前错误处理以基础异常捕获为主，对网络超时、API 变更等边缘场景的恢复能力有待增强。
适合的目标群体
该技能最适合以下用户群体：个人投资者与股票研究者：需要快速查询持仓股价、分析历史走势、对比财务指标的日常投资场景；财经内容创作者：撰写市场分析文章时需要实时数据支撑；金融科技开发者：构建投资组合分析、选股工具等应用的原型开发阶段；学生与研究人员：进行金融市场实证研究、量化策略回测等学术用途；轻量级量化爱好者：需要低成本获取结构化金融数据进行策略验证。不适合高频交易员、机构投资者及对数据实时性要求极高的专业场景。
使用风险
外部依赖风险：yahoo-finance2 依赖包若出现安全漏洞或停止维护，将影响功能稳定性，建议定期运行 npm audit 检查。API 服务变更：Yahoo Finance 可能调整免费接口策略或增加反爬机制，存在服务不可用风险。网络与限流：跨境网络波动可能导致请求失败，高频调用易触发限流，建议实现本地缓存与重试机制。数据合规：需严格遵守 Yahoo Finance 服务条款，禁止将数据用于商业产品或再分发。输入验证：虽依赖库已做基础处理，建议在使用层对股票代码格式进行预校验，减少无效请求。来源信誉监控：关注作者 GitHub 活跃度，建议 fork 后自主维护关键项目。