finlight

finlight 是什么

finlight 是由 Callbk 团队构建的金融与地缘新闻数据平台，运营主体信息指向德国的 Bartsch und Büyükkakac GbR。它面向开发者、金融科技团队和企业数据项目，重点是通过程序接口交付可检索、可过滤的新闻数据。

产品不是投资建议工具，也不直接替用户决定交易。其价值在于把分散的新闻文章整理成结构化结果，并通过 REST API、WebSocket、Webhook 或 MCP 接入应用与智能助手。

主要功能

结构化金融新闻检索

REST API 接收关键词、时间区间、语言、国家、分类、公司或证券标识等条件，返回文章标题、发布时间、媒体、摘要及相关元数据。它适合搜索历史新闻、构建研究页面、生成批量简报或为应用补充事件上下文。

语言筛选采用两位语言代码并执行精确匹配，未指定时默认英语。需要中文、日文或其他语言时应主动设置，不能把多语言覆盖理解为单次请求自动返回全部语言。

情绪与公司实体标注

增强结果可包含情绪方向、置信度、公司名称、股票代码、交易所、ISIN、行业、分类和国家等字段。用户可据此筛选特定企业、板块或负面事件，但情绪标签属于模型输出，不等于市场涨跌预测。

部分增强字段受套餐限制。请求无权限的能力时，REST 可能返回权限错误，而实时推送也可能直接省略相应字段，因此接入端需要兼容字段缺失。

WebSocket 实时流

WebSocket 适合行情看板、实时告警和低延迟事件处理，客户端连接后按查询、媒体、排除媒体或语言订阅新闻。原始流优先降低延迟，不提供完整的情绪和实体增强。

该能力仅向付费套餐开放，连接存在最长约两小时的基础设施限制。官方 SDK 会自动重连，自建客户端则要实现断线重试、重复消息处理和订阅恢复。

Webhook 事件推送

Webhook 把匹配新闻主动发送到用户的公网安全端点，适合后端任务、工作流平台和无需维持长连接的系统。增强订阅可按公司、国家、分类、实体和更新状态过滤，原始订阅则侧重速度。

接收端应验证 HMAC-SHA256 签名，并正确处理重复投递、乱序、超时和失败重试。Webhook 数量及每期投递额度随套餐变化，超出后需要等待周期重置或升级。

MCP 金融新闻工具

远程 MCP 服务可以把金融新闻检索接入支持 OAuth 2.0 的 AI 客户端和 Agent 框架。用户以自然语言询问企业动态、市场情绪或地缘事件时，客户端可调用结构化新闻工具再组织回答。

MCP 通过动态客户端注册与 PKCE 完成授权，API 密钥在托管授权页面输入，不需要写入客户端配置。MCP 可用于所有套餐，但每次调用会消耗账户的普通 API 请求额度。

自定义信息流与企业部署

企业客户可讨论自定义媒体集合、专属数据处理、私有云或本地部署、定制自然语言处理、翻译和服务等级协议。实际覆盖、延迟、字段、许可与交付方式由企业合同确认。

输入与输出

REST API 使用流程

1. 注册账户，在控制台创建并复制 API 密钥。
2. 根据任务选择官方 SDK 或自行调用 REST 端点。
3. 把密钥放在服务端密钥管理系统，通过指定请求头发送。
4. 先用小范围日期、语言和关键词验证返回字段与分页。
5. 再加入公司、证券、国家、分类或情绪条件缩小结果。
6. 处理权限错误、额度超限、空结果、字段缺失和网络重试。
7. 在控制台观察用量，并按账期请求额度安排缓存与任务频率。

API 密钥不应写入浏览器前端、移动应用包或公开代码仓库。若要向终端用户提供数据，应由自有后端代理请求并实施访问控制。

实时推送接入流程

1. 确认套餐已包含 WebSocket 或 Webhook 及所需额度。
2. 根据是否需要持续低延迟连接选择 WebSocket，按事件触发后端任务则选择 Webhook。
3. 为查询、语言和媒体范围设计足够精确的过滤规则。
4. 对 WebSocket 实现自动重连与去重，对 Webhook 验证签名并快速确认接收。
5. 将原始事件与后续增强结果分开建模，避免假定二者字段完全相同。
6. 监控连接数、推送量、失败率和账期额度，达到阈值前主动降载。

MCP 接入流程

1. 取得 finlight API 密钥并确认账户可正常调用。
2. 在支持远程 MCP 与 OAuth 2.0 的客户端中添加 finlight 服务。
3. 由客户端打开授权页面，在页面中输入密钥并完成 PKCE 授权。
4. 用简单的公司新闻问题测试工具连接与返回格式。
5. 逐步增加日期、媒体、语言、情绪或证券等过滤条件。
6. 检查每次调用的额度消耗，并要求 AI 保留文章时间和发布者上下文。

价格与额度

付费价格不含增值税或当地税费，最终金额可能因地区与结算页面变化。免费版和 Pro Light 当前约覆盖最近一个月，较高套餐提供更深历史范围，具体可查询日期应以账户权限为准。

额度和错误处理

• 每个 REST 请求消耗一次月度请求额度，计数在账期开始时重置。
• 短时间突发限制按十秒窗口控制，仅在定义了该限制的套餐执行。
• WebSocket 同时连接数和分发量、Webhook 投递量分别计费或限额。
• 超出请求或突发限制会返回额度错误，客户端应退避而不是高频重试。
• 当前响应不提供自动提示等待时间或剩余额度的标准头信息。
• 控制台用量图按日汇总，实际限制仍实时执行，因此图表可能存在显示滞后。

SDK、GitHub 与开源状态

八种客户端代码均公开并采用 MIT 许可证，便于审查、修改和商用集成。该许可证只适用于 SDK 代码，不能据此认定托管新闻平台、数据集合、增强模型或第三方文章开源。

适合用户与场景

• 金融科技开发者：为终端、研究产品或客户门户补充实时新闻。
• 量化与交易团队：把新闻事件接入内部监控和特征工程，但不能把文章情绪当成唯一信号。
• 企业情报团队：持续跟踪公司、行业、竞争对手和监管动态。
• 风险团队：监控地缘政治、政策、供应链和负面公司事件。
• AI 应用团队：通过 MCP 为智能助手提供可过滤的当前金融新闻。
• 内容与数据团队：按语言、国家和分类构建经授权的专题信息流。

优势

• REST、流式连接、事件推送和 MCP 覆盖不同应用架构。
• 结果包含情绪、公司标识和分类，减少部分实体整理工作。
• 免费层可验证接口和数据格式，升级前便于做技术试验。
• 八种官方 SDK 均有明确 MIT 许可，语言覆盖较完整。
• 付费层公开请求、Webhook 和 WebSocket 的主要额度。

能力边界与限制

• 免费层新闻延迟约 12 小时，不适合实时告警或即时交易场景。
• 原始实时流以延迟优先，不包含完整情绪与公司实体增强。
• 模型情绪与实体置信度可能出错，需要用原文和其他数据复核。
• 新闻覆盖随媒体、语言、地区和授权变化，不能保证每个事件或发布者都有数据。
• 平台不保证特定媒体的持续可用或固定交付时间。
• 没有标准剩余额度响应头时，调用方要自行计数并结合控制台监控。
• 历史范围、文章全文和增强字段均可能受套餐与内容许可限制。

版权、商用与退款

API 访问许可限于个人使用或内部商业用途，且不可转让、再许可或转售。不得通过多账户绕过额度、逆向工程接口、未经许可重新发布受版权保护的文章，或以该 API 建立竞争性新闻分发服务。

第三方文章仍归原发布者所有，展示或分发时应明确标注发布者，并在适用时提供原文章入口。是否可保存全文、训练模型、面向客户再分发或用于付费产品，应同时核对发布者许可和企业合同。

付费订阅和自动续费原则上不退款，取消只阻止未来扣费，当前周期权益会持续至期末。重复扣款、错误支付或法律强制权利属于可能例外，升级前应先用免费层验证数据、字段和性能。

隐私与安全

finlight 会处理账户姓名、邮箱、用量、IP、浏览器与设备、通信记录和产品行为数据。服务使用欧洲区域云基础设施，同时接入支付、邮件、分析、行为监测与错误追踪供应商，跨境传输可采用标准合同条款等保障。

• API 密钥应只保存在服务端，并按最小权限、轮换和日志脱敏原则管理。
• Webhook 应验证签名，公网接收端还需实施访问控制、重放防护和监控。
• 账户可申请删除，但税务、争议处理或其他法律义务可能要求继续保留部分记录。
• 产品不面向 16 岁以下用户，涉及未成年人数据的项目不应直接使用。
• 隐私政策不替代企业客户所需的数据处理协议、安全附件和供应商审查。

常见问题

finlight 是投资建议或自动交易工具吗？

不是。它提供金融新闻与结构化元数据，投资判断、风险控制和交易执行仍由用户自己的系统与专业人员负责。

免费版是真正的实时新闻吗？

不是。Launchpad 免费层每月有 5000 次请求，但新闻约延迟 12 小时，实时数据需选择付费方案。

MCP 是否需要额外购买？

MCP 对所有套餐开放，不单独收费，但调用会计入账户的普通 API 请求额度。免费层的延迟和字段限制同样适用。

WebSocket 与 Webhook 有什么区别？

WebSocket 适合持续低延迟连接，Webhook 适合把匹配事件推送到后端端点。两者额度、连接管理和失败处理方式不同。

情绪分析在所有套餐都提供吗？

不是。免费层和 Pro Light 不含情绪增强，Pro Standard、Pro Scale 及相应企业方案才提供该能力。

finlight 是开源产品吗？

托管平台未确认开源。八种官方客户端 SDK 采用 MIT 许可证，但这不包括平台代码、新闻数据和增强模型。

付费后可以退款吗？

一般不可以。付费订阅与续费原则上不退款，取消后保留至账期结束；重复扣款或法律规定的退款权可能例外。

可以重新发布 API 返回的文章吗？

不能仅凭 API 订阅获得重新发布权。第三方文章版权属于原发布者，公开展示需署名，全文再分发还要取得相应许可。

总结

finlight 适合需要用接口、实时流、事件推送或 MCP 获取金融新闻的开发者和企业团队。结构化实体与情绪数据能够缩短集成时间，但实时性、历史范围和增强字段明显受套餐约束。

正式上线前应先用免费层验证数据覆盖，再确认付费额度、版权许可、密钥安全、重试和监控设计。面向交易或客户分发的项目还需要独立的数据质量控制和法律审查。