Skip to content

[Finance Research] Add first-class filings, announcements, and research-report source pipelines #32

Description

@helsome

Background

金融研究不能主要依赖通用 Web Search。真正高可信的研究需要优先使用 公司财报 / 交易所公告 / 监管披露 / Investor Relations 文档,并在可合法接入的情况下补充券商/投行研报。

这些来源与普通网页的语义不同:它们有明确的 issuer、reporting period、filing type、publish time、amendment/version 和 source authority。若只作为普通 URL 丢进搜索结果,会丢失大量金融研究需要的结构。

Related: #20 #22 #23 #29 #30

Requirements

1. Unified research document contract

为金融研究文档定义统一结构,至少包含:

  • document_id
  • canonical instrument / issuer id
  • source type:regulatory filing / exchange announcement / IR document / earnings release / research report / other
  • document subtype:10-K / 10-Q / 8-K / annual report / interim report / announcement 等
  • title
  • published_at / filed_at
  • reporting period(适用时)
  • source authority / publisher
  • canonical URL / provider identity
  • language
  • amendment/version relation(适用时)
  • retrieval/provenance metadata

2. Primary-source connectors

首版至少接入两类真实 primary source,例如:

  • SEC EDGAR;
  • 港交所/交易所公告;
  • 公司 Investor Relations;
  • 其他公开监管披露源。

不同来源通过 adapter 接入统一 research document contract。

3. Research-report adapters

  • 为 sell-side / broker / third-party research report 预留独立 provider adapter;
  • 不把付费内容、无授权全文复制进仓库或 telemetry;
  • provider/licensing 限制必须体现在 capability/metadata 中;
  • 研报观点与公司/监管 primary source 必须保持来源类型可区分。

4. Retrieval behavior

Research Agent 应能按:

  • instrument/company;
  • document type;
  • reporting period;
  • publish date;
  • source authority;

进行检索,并优先把 primary source 用于关键事实验证。

5. Evidence integration

文档内 evidence 应能定位到具体 section/page/span,并进入 #13/#20/#30 的 evidence/citation 体系。

Acceptance Criteria

  • 存在统一 research document schema,不把所有来源简化成 URL + text。
  • 至少两个真实 primary-source connector 接入 production path。
  • 能按公司 + document type + period 查询历史披露。
  • amendment/重复版本不会被当成完全无关文档。
  • Agent 能区分监管披露、公司 IR、新闻和第三方研报。
  • 关键财务事实优先可追踪到 primary source。
  • 至少一份长财报可定位到具体 evidence span/page/section。
  • PR 必须完成一个真实上市公司研究 E2E:同时检索其监管/交易所披露和至少一种其他来源,并在最终回答中展示来源类型和 evidence 跳转。

Non-goals

  • 不要求首版覆盖所有国家交易所。
  • 不绕过付费墙或数据许可限制。
  • 不把第三方研报自动视为比公司/监管原始披露更权威。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

claimedClaimed by a contributor and currently in progress

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions