SuperAPI AI 工具集

finnhub

数据与分析

查看项目

更新于 10-16 00:26

技能介绍

用途:Finnhub 提供股票、外汇和加密货币的实时价格等金融数据 API,供开发者与投资者构建市场行情跟踪与金融分析应用。官方文档见 https://finnhub.io/docs/api。本技能通过 Membrane CLI 与 Finnhub 交互,由 Membrane 自动处理认证与凭证刷新,使用户专注于集成逻辑。

主要能力:该技能可访问的 Finnhub 数据领域包括股票 K 线、公司简介、公司新闻、实时报价、分析师推荐趋势、目标价、股票代码列表、财报日历、电话会议记录、记录情绪、并购、股权结构和供应链。可用的预置操作包括:List Stock Symbols(按交易所获取股票代码)、Get General News(按 general、forex、crypto、merger 分类获取市场新闻)、Get Earnings Calendar(按日期范围获取财报日历与 EPS 预估及实际值)、Search Symbols、Get Basic Financials(52 周高低、市盈率、beta、市值等指标)、Get Company Peers、Get Price Target、Get Recommendation Trends、Get Company News、Get Stock Candles(OHLCV 历史数据)、Get Company Profile、Get Quote(美股实时报价)。

使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。认证:membrane login --tenant --clientName=<agentType>,可能打开浏览器或打印授权 URL;无头环境需请用户打开 URL 完成登录后执行 membrane login complete <code>。加 --json 可获得机器可读输出。查找或创建连接:membrane connection ensure "https://finnhub.io/" --json,用户在浏览器完成认证;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至不再为 BUILDING。状态含义:READY 可继续;CLIENT_ACTION_REQUIRED 需用户或代理执行 clientAction 描述的动作;CONFIGURATION_ERROR 或 SETUP_FAILED 需查看 error 字段。搜索操作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json,结果含 id、name、description、inputSchema、outputSchema。运行操作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参用 --input '{"key": "value"}' --json,结果在 output 字段。代理请求:当预置操作不覆盖用例时,可用 membrane request CONNECTION_ID /path/to/endpoint 直接向 Finnhub API 发送请求,Membrane 自动补全基础 URL 并注入认证头,支持凭证过期时透明刷新。常用选项包括 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam。

适用场景与限制:适合需要程序化获取 Finnhub 金融数据、行情报价、财报日历、分析师观点、公司基本面与新闻等信息的开发与投资分析场景。建议优先使用 Membrane 预置操作,其内置认证、分页与错误处理;在编写自定义 API 调用前先用 action list 发现现有操作。不要向用户索取 API 密钥或令牌,应通过创建连接由 Membrane 在服务端管理完整认证生命周期,不在本地保存密钥。资料未提供具体收费、价格、速率限制与数据覆盖范围的细节。