sn-search-finance

金融财经搜索

凭证配置

API key、token 与 cookie 统一建议写在仓库根目录 .env（参考 .env.example），并由 runtime 或用户在执行前加载为同名环境变量。脚本仍只从环境变量或显式 CLI 参数读取凭证；不要把真实密钥写入 skill payload、报告、日志或提交。

用于证券、指数、基金、财务报表、行情、K 线、公告线索、财经新闻和公司基本面的检索。API 脚本和 browser-use 可以混合使用；按任务需要选择，不设固定优先级。

工作流

1. 先确认市场和标的：A 股/港股/美股/全球 ticker、公司名、证券代码、时间区间、需要的数据口径。
2. 结构化数据用 scripts/finance_search.py：yfinance 查全球 ticker、行情、财务、新闻、SEC filings；mootdx 查通达信/A 股行情、K 线、财务包。
3. 需要页面证据、新闻正文、交互筛选、图表核对、脚本失败或字段缺失时，用 browser-use 打开 Yahoo Finance、交易所、上市公司 IR、公告页或搜索结果页交叉核对。
4. 输出结论时保留 ticker/证券代码、市场、数据区间、指标口径和来源 URL；不要把脚本结果当作投资建议。
5. 遇到登录墙、验证码、付费墙、商业授权、异常限流或禁止用途提示时停止该来源，改用可公开访问的页面或说明无法取得。

API 脚本

脚本：scripts/finance_search.py。输出 JSON。依赖按命令懒加载。

首次运行或脚本提示缺库时，使用本技能的依赖清单安装到当前 Python 环境：

python3 -m pip install -r requirements.txt

不要在脚本内部自动安装依赖。若安装失败、网络不可用或包不可用，停止使用对应命令并改用公开网页来源，说明缺少依赖。

yfinance

Yahoo Finance 代码后缀：美股直接用 AAPL；港股可用 0700.HK；A 股可用 600036.SH、600036.SS、000001.SZ，脚本会把 .SH 自动转成 .SS。不想自动转换时加 --no-normalize。

python scripts/finance_search.py yf-search "Tesla" --limit 5 --news-count 5
python scripts/finance_search.py yf-lookup "Tencent" --type stock --limit 10
python scripts/finance_search.py yf-profile AAPL --fields longName,sector,industry,marketCap,currentPrice,trailingPE
python scripts/finance_search.py yf-history AAPL --period 6mo --interval 1d --limit 120
python scripts/finance_search.py yf-download AAPL MSFT NVDA --period 1mo --interval 1d --group-by ticker
python scripts/finance_search.py yf-financials MSFT --statement income --freq yearly
python scripts/finance_search.py yf-financials MSFT --statement balance --freq quarterly
python scripts/finance_search.py yf-news TSLA --limit 8
python scripts/finance_search.py yf-sec-filings AAPL

常用命令：

命令	用途
yf-search	搜公司、ticker、新闻和研究入口
yf-lookup	按金融工具类型查找股票、ETF、指数、基金、期货、外汇、加密资产
yf-profile	基本面画像和 fast_info
yf-history / yf-download	单标的或多标的历史行情
yf-financials	利润表、资产负债表、现金流、盈利数据
yf-news	ticker 相关新闻线索
yf-sec-filings	SEC filings 线索

mootdx

mootdx 使用通达信代码格式，通常是纯数字。脚本会把 600036.SH、600036.SS、000001.SZ 转成 600036、000001。

python scripts/finance_search.py tdx-quotes 600036 000001
python scripts/finance_search.py tdx-bars 600036 --frequency day --offset 120 --adjust qfq
python scripts/finance_search.py tdx-index 000001 --market sh --frequency day --offset 60
python scripts/finance_search.py tdx-stocks --market sh --limit 50
python scripts/finance_search.py tdx-finance 600036
python scripts/finance_search.py tdx-xdxr 600036
python scripts/finance_search.py tdx-affair-files --limit 10
python scripts/finance_search.py tdx-affair-fetch gpcw20231231.zip --downdir tmp
python scripts/finance_search.py tdx-affair-parse gpcw20231231.zip --downdir tmp --limit 100

K 线 --frequency 可用：1m、5m、15m、30m、1h、day、week、mon、3mon、year，也可直接传 mootdx 数字频率。

browser-use 场景

场景	用法
脚本返回新闻线索	打开新闻 URL 或 Yahoo Finance 新闻页核对标题、发布时间、正文要点
财务字段不全	打开 Yahoo Finance Financials、SEC、交易所公告、公司 IR 页面补证
A 股公告/定期报告	配合 sn-search-year-report 或 search-market 技能查官方披露源
图表、复权、行情异常	打开行情页或交易所页面核对口径
公司名无法映射 ticker	用 yf-search、yf-lookup 和网页搜索互相验证