进阶配置

进阶配置

Finnhub / Tushare / Market API 数据源升级,让系统的”眼睛”看得更远。

ℹ️ 说明

开箱即用只需 RSS(零 API Key)。以下是让系统能力持续进化的路径。先确保你已经跑通最小闭环(跑一下市场洞察 + 跑一下投资雷达),再来升级数据源。

Level 1:Finnhub Free API Key(推荐)

它能带来什么

能力无 Finnhub Key有 Finnhub Key
美股/Crypto 价格Yahoo Finance 回退Finnhub 实时报价 + Yahoo 互备
英文新闻仅 RSS 源+ Finnhub 持仓匹配新闻
P15 触发检测自动标记财报/并购等关键事件
个股新闻company-news 按 Ticker 精准拉取

如何获取

  1. 访问 finnhub.io 注册免费账号
  2. 在 Dashboard 中复制你的 API Key
  3. 编辑 .env 文件:
BASH
FINNHUB_API_KEY=你的key

验证

BASH
# 测试价格查询
python3 Eyes/scripts/fetch_price_api.py –symbols “AAPL,NVDA” –output /tmp/test_price.json

# 测试新闻拉取
python3 Eyes/scripts/fetch_finnhub_news.py –hours 24 –output /tmp/test_news.json

免费 Key 的限制

  • 每分钟 60 次 API 调用
  • 仅覆盖美股和 Crypto(A股/港股不支持)
  • 行情数据有 15 分钟延迟
  • 个股新闻窗口最长 1 年
💡 提示

对于 YMOS 的使用场景(日频扫描 + 事件触发),免费 Key 完全够用。

Finnhub 可用能力速查

API端点YMOS 用途
实时报价/quote?symbol=AAPL投资雷达价格扫描
个股新闻/company-news?symbol=AAPL&from=...&to=...P4 关注点更新
大盘新闻/news?category=general市场洞察补充数据
基础指标/stock/metric?symbol=AAPL&metric=allP1/P4 基本面数据
同行对比/stock/peers?symbol=AAPLP1 竞争格局
财报日历/calendar/earnings?from=...&to=...事件触发预警
市场状态/stock/market-status?exchange=US价格扫描时间判断

Level 1+:Tushare Token(A 股用户推荐)

它能带来什么

能力无 Tushare有 Tushare
A 股价格(.SS/.SZ)Yahoo Finance 回退(延迟高、偶尔不稳定)Tushare 实时报价 + Yahoo 互备
A 股日线数据支持历史日线查询

如何获取

  1. 访问 tushare.pro 注册账号
  2. 在个人中心获取 Token
  3. 编辑 .env 文件:
BASH
TUSHARE_TOKEN=你的token

免费 Token 的限制

  • 注册并完善个人信息后获得 120 积分(不消耗),达到日常接口调用的使用门槛
  • 部分高级接口需要更高积分等级
  • 仅覆盖 A 股(.SS/.SZ),美股/港股/Crypto 走 Finnhub 或 Yahoo

三源价格路由机制

YMOS 的价格扫描自动分流(Eyes/scripts/fetch_price_router.py):

MARKDOWN
Ticker 后缀判断:
  .SS / .SZ → Tushare(无 Token 时回退 Yahoo)
  .HK       → Yahoo Finance
  其他       → Finnhub(无 Key 时回退 Yahoo)
💡 提示

Finnhub 和 Tushare 可独立配置,互不影响。建议:美股用户配 Finnhub,A 股用户配 Tushare,两市都看就都配。

Level 2:Market Data API(yongmai.xyz)

它能带来什么

一个已经清洗、分类、去重的中英文市场事件数据源。相当于把 28 个 RSS 源的抓取 + CIO 处理全部在服务端完成。

维度纯 RSSMarket Data API
数据源数量15 个免费 RSS28 个(含 RSSHub 搭建类)
预处理需要本地消耗 Token 处理服务端已完成清洗与分类
中文源几乎都需要 RSSHub 搭建中转原生支持高质量中文资讯与研报
输出格式原始 RSS JSON直接可用的结构化 Markdown

如何获取

⚠️ 注意

这不是一个商业化的 SaaS 产品。这是我个人实盘每天在用的底层数据管道。请先确保你已经用纯 RSS 路径跑通了完整的市场洞察→投资雷达→策略分析闭环。

前往 yongmai.xyz/register-2 注册账户,在用户中心自助开通并获取专属 API Key。

配置

BASH
YMOS_MARKET_API_URL=https://yongmai.xyz/wp-json/tib/v1/reports
YMOS_MARKET_API_KEY=你的key

RSS 信息源自定义

当前默认源

YMOS 内置 15 个免费 RSS 源,分为 5 个分类:

分类数量主要源
美股3Bloomberg Markets, CNBC Markets, FT Markets
宏观2CNBC Finance, The Economist
科技5Bloomberg Tech, FT Tech, TechCrunch, Nvidia Blog, The Verge
Crypto1Bloomberg Crypto
深度洞察4Seeking Alpha, Stratechery, Bloomberg Opinion, TechInAsia

如何自定义

编辑 Eyes/scripts/rss_sources.json,按以下格式增减源:

JSON
{
  “name”: “你的源名称”,
  “url”: “https://example.com/feed/”,
  “category”: “美股”,
  “priority”: “medium”,
  “note”: “简要说明”
}

补充 RSS:与 Market Data API 并行使用

如果你已经配置了 Market Data API(Level 2),但还想额外订阅一些 API 覆盖不到的 RSS 源(如特定行业博客、独立分析师),可以创建补充 RSS 配置:

  1. 复制 Eyes/scripts/rss_sources_custom.json.examplerss_sources_custom.json
  2. 填入你的自定义 RSS 源(格式与 rss_sources.json 一致)
  3. 市场洞察 SOP 会自动检测此文件,存在即拉取,不存在即跳过

补充 RSS 与主数据源独立运行——无论你用 API 还是默认 RSS 作为主数据源,补充 RSS 都会额外拉取并作为 P13 分析的补充输入。

BASH
# 补充 RSS 的调用方式(SOP 自动处理,通常不需要手动执行)
python3 Eyes/scripts/fetch_rss.py 1 \
  –config Eyes/scripts/rss_sources_custom.json \
  –output “Eyes/市场洞察/Raw_Data/YYYY-MM/supplementary_rss_YYYYMMDD.json”

更多源参考

完整的 28 源清单(含需 RSSHub 搭建的中文源):yongmai.xyz/tib-rss-list/

Level 3:更多金融数据 API

YMOS 的脚本层是模块化的——每个数据源一个独立脚本,统一输出 JSON。核心模式:一个端点 + 一个 API Key → 输出 JSON → 喂给 SOP 处理链

推荐的金融数据服务商

服务商免费层主要能力适合场景
Tiingo美股历史行情、新闻、IEX 实时数据替代/补充 Finnhub 行情
Alpha Vantage美股/外汇/Crypto 行情、技术指标技术分析、回测数据
Polygon.io有限美股实时/历史行情、期权链精准行情、期权策略(P10)
Benzinga Pro API付费实时新闻、评级变动、内部交易高频事件驱动

如何接入新数据源

  1. 创建脚本Eyes/scripts/fetch_[source_name].py,参考现有脚本结构
  2. 更新 .env.example:添加新的 API Key 变量
  3. 更新 SOP:在对应 SOP 中添加可选的数据拉取步骤
  4. Agent 自动识别:只要脚本存在且 API Key 配置了,SOP 步骤会自动执行

定时任务设置

日常三步闭环

YMOS 的核心日常工作流是三步依次执行:

MARKDOWN
1. 跑一下市场洞察     → 拉取数据 + P13 分析         ~3-5 分钟
2. 跑一下投资雷达     → 趋势回顾 + 价格扫描 + 建议   ~5-8 分钟
3. 跑一下策略分析     → 消费雷达建议 + 策略路由       ~10-15 分钟/标的
⚠️ 注意

依赖关系:2 依赖 1 的市场洞察输出,3 依赖 2 的投资雷达建议。必须按顺序执行,每步间隔 5-15 分钟确保前一步完成。

推荐时间窗口

场景市场洞察投资雷达策略分析适用说明
A股盘中10:3010:4511:00盘中捕捉异动,及时响应
美股盘前20:3020:4521:00美股开盘前做好功课
收盘后复盘收盘后 30min+15min+15min复盘当日行情,规划明日

核心原则:在你有时间审阅报告的时段之前跑完

怎么设置

把 SOP 路径和指令告诉 AI。以 Claude Code 为例:

MARKDOWN
请读取 /你的路径/YMOS/总入口暗号.md

帮我设置三个定时任务:
1. 每天 10:30 执行「跑一下市场洞察」
2. 每天 10:45 执行「跑一下投资雷达」
3. 每天 11:00 执行「跑一下策略分析」
重要

务必带上 总入口暗号.md 的完整路径。Agent 需要通过这个文件定位你的 YMOS 目录和所有 SOP。没有记忆功能的 Agent 每次执行都需要这个路径作为入口。

策略分析的自动调研

定时触发 跑一下策略分析 时,除了消费”策略分析建议”,还会自动消费投资雷达的”调研建议”:

  • 如果某标的缺少 P1/P4、信息过期(>30天)、或新关注未建档,策略分析会先调用初始调研 SOP 补全
  • 补全后再进入策略路由,确保分析有完整的个股上下文
  • 用户不需要手动 调研一下 TICKER——定时任务链会自动处理

数据层级对比

层级数据源CIO 处理Finnhub NewsP13 输入质量成本
基础(开箱即用)15 个免费 RSS需要良好免费
+FinnhubRSS + FinnhubRSS 部分需要更好免费(注册)
+Market API结构化 API不需要可选最佳按需联系