核心用法
Finnhub Skill 是一个纯文档型的 API 集成工具，旨在帮助用户快速接入 Finnhub 金融数据服务。用户需先在 finnhub.io 注册获取 API 密钥，通过环境变量 FINNHUB_API_KEY 配置后即可使用。该 Skill 涵盖了六大核心功能模块：实时股票报价（Quote）、公司新闻（Company News）、公司概况（Profile）、财务报表（Financials）、市场数据（Market Data）以及交易信号（Trading Signals）。
典型使用流程包括：通过 /search 查找股票代码，使用 /quote 获取实时价格，结合 /company-news 分析新闻情绪，调用 /stock/financials-reported 查阅财务数据，并可利用 /indicator 进行技术分析。对于深度研究，还支持在 SEC 备案文件（10-K、10-Q 等）中搜索特定关键词。
显著优点
数据全面性：覆盖全球主要交易所的实时行情、历史数据、基本面信息和技术指标，一站式满足多元需求。成本优势：Finnhub 提供免费套餐（60 请求/分钟），降低个人投资者和小型团队的入门门槛。权威数据源：直接对接官方金融数据服务商，数据质量与合规性有保障。零代码风险：该 Skill 仅包含 Markdown 文档说明，无实际执行代码，完全透明可审计。灵活集成：支持多种使用场景，从简单的股价监控到复杂的量化策略研究均可胜任。
潜在缺点与局限性
功能受限：免费版存在严格的速率限制（60 请求/分钟），且部分高级功能（如 RSI、MACD 等技术指标、形态识别）需付费订阅。数据延迟：实时数据可能存在秒级延迟，不适合高频交易场景。外部依赖：完全依赖 Finnhub 服务的稳定性，若对方 API 变更或宕机，功能将受影响。无执行能力：该 Skill 本身仅为文档指引，实际调用需用户自行实现或依赖 Agent 框架封装。地域限制：部分市场数据可能因监管要求存在覆盖盲区。
适合的目标群体
个人投资者：需要快速获取股价、新闻和财报进行日常投资决策。量化研究者：需要结构化金融数据用于策略回测和模型构建。金融分析师：需要批量查询公司基本面数据撰写研究报告。开发者：需要集成金融数据 API 构建投资工具或应用。教育工作者：需要真实市场数据用于金融课程教学演示。
使用风险
API 密钥泄露风险：若环境变量配置不当，可能导致密钥泄露，建议严格遵循最小权限原则。合规风险：金融数据使用需遵守 Finnhub 服务条款及当地证券法规，禁止用于非法内幕交易或市场操纵。数据准确性风险：尽管 Finnhub 为知名服务商，但仍建议交叉验证关键投资决策数据。速率超限风险：高频调用易触发限流，导致服务中断，需实现合理的重试和缓存机制。服务连续性风险：第三方 API 存在服务变更或终止可能，建议设计数据备份方案。