etf-listing-discovery

name	etf-listing-discovery
description	Discover listed, pending, filed, or newly announced ETFs and create a structured candidate watchlist for ETF listing analysis.

ETF Listing Discovery Skill

这个 skill 用于查找新上市、即将上市、已提交申请或刚被媒体/发行人宣布的 ETF/ETP。

它是 etf-listing-analysis 的前置发现层：

ETF listing discovery -> new-etf-watchlist -> ETF listing analysis

它不负责深度判断 ETF 是否值得买入，只负责把候选产品找出来、去重、补齐关键字段、排序，并决定哪些进入 etf-listing-analysis。

Use When

• 用户要求查找最近新上市 ETF
• 用户要求监控新 ETF、ETF 申请、ETF launch、ETF issuer 新产品
• 用户想从 ETF 新发中发现市场偏好、配置方向、主题热度或结构变化
• 用户给出一个主题，要求找相关新 ETF 或申请中的 ETF
• etf-listing-analysis 缺少输入，需要先发现候选产品

Required Inputs

• market_scope 例如 US、global、HK、CN、EU
• discovery_window 例如 last 7 days、last 30 days、YTD、since date
• discovery_mode 例如 listed、upcoming、filed、announced、all
• theme_filter 可选，例如 crypto、AI、covered call、single-stock、duration、China、commodity
• output_limit 默认先保留前 20 个候选
• research_cutoff_date

Source Priority

优先级从高到低：

1. exchange notices 交易所新上市/新发行通知，确认 ticker、上市日期、交易所。
2. issuer launch pages 发行人产品页、新闻稿、招募说明书，确认策略、费用、持仓、指数。
3. regulatory filings SEC/监管文件，确认申请、修订、规则和基金注册信息。
4. ETF industry media ETF.com、ETF Trends、VettaFi、Bloomberg/Reuters 等，用于发现线索和语境。
5. market data AUM、成交、价差、首日交易数据，用于初步排序，不替代上市确认。

Discovery Workflow

1. Define Search Scope

先明确：

• 市场：US / global / local market
• 时间窗口：上市日、公告日、申请日，不能混用
• 状态：已上市、即将上市、已申请、传闻/媒体报道
• 产品范围：ETF only，还是包含 ETN、ETC、ETP、closed-end fund

2. Search Source Buckets

至少覆盖三类来源：

• 交易所或监管来源
• 发行人或指数提供商来源
• ETF 行业媒体或市场数据来源

如果只找到媒体文章，必须标记为 needs_primary_confirmation。

3. Normalize Candidate Records

每个候选至少补齐：

• ticker
• ETF name
• issuer
• exchange
• listing_status
• listing_date 或 filing_date
• product_type
• underlying_exposure
• source_id
• source_url
• source_publish_date 或 last_checked_date
• why_worth_analyzing

4. Deduplicate

去重规则：

• 同 ticker 同 exchange 视为同一产品
• 同一 ETF 的媒体报道、交易所通知、发行人页面合并成一个候选
• share class、dual listing、fund conversion 不能误判为全新产品，必须标记

5. Score Priority

每个候选给出 priority_score，建议 0 到 5：

• 5: 新主题/新资产可达性/多发行人集中推出/上市后快速放量
• 4: 有清晰结构创新、机构配置含义或高热度主题
• 3: 普通但值得观察的新 ETF
• 2: 低费率复制、存量产品变体或主题纯度存疑
• 1: 信息不足、可能只是产品噪音
• 0: 重复、转换、清盘替代或不属于 ETF/ETP 范围

6. Route Next Action

每个候选必须落到一个动作：

• analyze_now 进入 etf-listing-analysis。
• watch_t1 等 5、20、60 个交易日数据。
• needs_primary_confirmation 先找交易所、发行人或监管来源。
• ignore_duplicate 重复或只是 share class / dual listing。
• ignore_noise 暂不跟踪。

Output Package

默认输出 etf-listing-discovery-package：

• new-etf-watchlist.csv
• discovery-log.md
• evidence-log.csv

new-etf-watchlist.csv 是传给 etf-listing-analysis 的入口。

Search Query Patterns

英文查询：

• new ETF launches this week
• site:cboe.com/us/equities/notices/new_listings ETF first trade date
• site:nyse.com ETF lists new fund
• site:sec.gov N-1A ETF prospectus
• {issuer} launches ETF
• {theme} ETF launch
• {theme} ETF filed SEC

中文查询：

• 新上市 ETF
• ETF 新发 上市
• {主题} ETF 上市
• {发行人} 推出 ETF
• ETF 申请 文件

Quality Bar

• 不允许把媒体标题直接写成 confirmed listing
• 不允许把 filed、approved、announced、listed 混成一个状态
• 不允许只列 ticker，不补 issuer、exchange、listing date/source
• 不允许把 dual listing、share class conversion、mutual fund conversion 默认当新 ETF
• 不允许把 ETF 新发数量本身当趋势结论，必须交给 etf-listing-analysis 做 T0/T1 判断

Handoff To ETF Listing Analysis

满足任一条件时进入 etf-listing-analysis：

• priority_score >= 4
• 同一主题 30 天内出现多个 issuer launch/filed
• 产品提供了新的资产可达性、收益结构、杠杆/反向工具或监管突破
• 上市后 AUM、成交或期权活动明显放量
• 成分股流动性较低，可能存在资金传导