stock_data

核心功能与用法

stock_data 技能通过 Simplywall.st 平台获取全球上市股票的综合性数据，覆盖股价、估值分析、财务报表、股息信息和投资评级等维度。用户只需提供股票代码（如 ADRO、AAPL）即可调用，支持印尼(IDX)、美股(NASDAQ/NYSE)、澳大利亚(ASX)、英国(LSE)、加拿大(TSX)、新加坡(SGX)等主流交易所。

典型使用场景：

• 查询实时股价与近期涨跌（7日/1年回报率）
• 估值判断：PE、PB、PEG 比率及内在价值折价率
• 财务健康度：ROE、ROA、资产负债率等关键指标
• 股息分析：收益率、支付率、连续支付年限
• Simplywall.st 特色"雪花图"评分（价值、成长、过往表现、财务健康、股息五维度）

显著优点

1. 数据来源权威：直接对接 S&P Global Market Intelligence，机构级数据质量
2. 估值模型可视化：提供"内在价值折扣"和 overvalued/undervalued 判断，降低专业门槛
3. 多维度评分：Snowflake 五维评分直观呈现公司综合画像
4. 全球覆盖：支持印尼本土及国际主流市场，满足多元化投资需求
5. 分析师预期整合：包含盈利增长预测和覆盖分析师数量

局限性与风险

• 时效性限制：价格数据每日更新，非实时行情；快速波动市场可能存在延迟
• 估值模型黑箱："内在价值"基于 Simplywall.st proprietary 模型，方法论不透明，不宜作为唯一决策依据
• 地域合规风险：印尼用户查询境外股票可能涉及外汇管制、税务申报等合规问题
• 数据完整性：部分小盘股或新兴市场股票可能存在数据缺失
• API 依赖：需配置 ZAI_API_KEY，服务可用性受第三方平台制约

适合人群

• 个人投资者进行初步筛选和快速基本面扫盲
• 需对比多市场股票表现的跨境投资者
• 对估值分析感兴趣但缺乏专业金融建模能力的用户

不适用：高频交易、实时套利、专业级量化策略开发

安全与风险提示

⚠️ 技能明确标注 "Use as guide only, not investment advice"（仅供参考，不构成投资建议）。用户应结合自身风险承受能力，交叉验证关键数据，并注意区分历史表现与未来预期的不确定性。印尼市场用户特别需关注 IDX 与境外市场的交易规则差异。

核心用法

stock_data 是一款面向全球股票市场的数据获取工具，用户只需提供股票代码（如 ADRO、AAPL）即可快速获取全面的投资分析数据。支持印尼IDX、美国NASDAQ/NYSE、澳大利亚ASX、英国LSE、加拿大TSX、新加坡SGX等多个交易所，覆盖全球主要资本市场。

该技能采用多层级数据架构，输出结构包含：公司基本信息（名称、描述、成立时间）、实时价格与收益率、估值指标（市盈率P/E、市净率P/B、PEG、内在价值折溢价）、财务健康度（ROE、ROA、资产负债率）、股息分析（收益率、支付率、派息年限）、分析师预测（盈利增长、覆盖机构数量）以及Simplywall.st独家的"雪花图"评分系统。用户可通过自然语言查询，如"ADRO估值如何"、"苹果P/E多少"或"TLKM股息收益率"，系统自动解析意图并返回结构化数据。

显著优点

数据源权威可靠：底层数据来自S&P Global Market Intelligence，经由Simplywall.st专业金融平台整合，估值模型采用其专利的内在价值计算方法论，具备专业投资参考价值。

多维分析视角：不同于单一价格查询工具，该技能整合了估值、财务、股息、预测四大维度，配合可视化雪花评分（1-6分制），帮助用户快速识别优质标的。

全球化覆盖：支持7大交易所、数万只股票的实时数据，特别对新兴市场（如印尼IDX）有良好支持，满足跨境投资需求。

结构化输出：返回标准JSON格式，便于Agent进行二次加工、对比分析或生成可视化报告，适合构建自动化投研工作流。

潜在缺点与局限性

非实时行情数据：价格数据为日线级别更新，无法满足高频交易或实时盯盘需求，盘中波动无法及时反映。

依赖外部服务稳定性：核心功能依赖Z.AI API进行网页抓取，若该服务中断或Simplywall.st页面结构变更，将导致数据获取失败。当前采用正则表达式解析HTML，存在页面改版导致解析失效的结构性风险。

无投资建议属性：虽提供"undervalued/overvalued"标签，但明确声明"仅供参考，不构成投资建议"，缺乏个性化风险评估和资产配置建议。

环境配置门槛：需要用户自行配置ZAI_API_KEY环境变量，对非技术用户存在一定使用门槛。

数据深度有限：不包含技术面指标（K线形态、成交量分析）、期权链数据、机构持仓明细等进阶信息，难以满足专业量化分析需求。

适合的目标群体

个人投资者：需要快速获取海外/新兴市场股票基本面信息的中文用户，特别是关注印尼股市（IDX）的投资者。

财经内容创作者：需要批量获取标准化股票数据用于撰写分析文章、制作图表的自媒体运营者。

初级投研人员：需要建立股票筛选模型、进行跨市场估值对比的资管行业新人或金融专业学生。

企业财务部门：需要监控竞品公司、供应商或投资标的财务健康状况的上市公司IR团队。

Agent开发者：需要为金融类Agent集成权威股票数据能力的开发者，可作为投研Agent的基础数据层组件。

使用风险提醒

性能风险：依赖外部API网络调用，响应延迟通常在1-3秒，高并发场景下可能触发速率限制，不适合构建实时行情推送服务。

数据准确性风险：估值标签基于历史财务数据和分析师预测模型，无法反映突发政策变化、黑天鹅事件或市场情绪突变，2021年Archegos爆仓等案例表明模型风险始终存在。

合规风险提示：部分司法管辖区对金融数据传播有严格监管，商业使用前需确认符合当地证券法规；同时需注意Simplywall.st数据的使用授权范围。

依赖项风险：核心依赖aiohttp库，虽当前无已知CVE，但建议持续关注安全公告；Python版本升级时需验证异步兼容性。