sn-search-finance

1# 金融财经搜索
2 
3## 凭证配置
4 
5API key、token 与 cookie 统一建议写在仓库根目录 `.env`（参考 `.env.example`），并由 runtime 或用户在执行前加载为同名环境变量。脚本仍只从环境变量或显式 CLI 参数读取凭证；不要把真实密钥写入 skill payload、报告、日志或提交。
6 
7用于证券、指数、基金、财务报表、行情、K 线、公告线索、财经新闻和公司基本面的检索。API 脚本和 browser-use 可以混合使用；按任务需要选择，不设固定优先级。
8 
9## 工作流
10 
111. 先确认市场和标的：A 股/港股/美股/全球 ticker、公司名、证券代码、时间区间、需要的数据口径。
122. 结构化数据用 `scripts/finance_search.py`：yfinance 查全球 ticker、行情、财务、新闻、SEC filings；mootdx 查通达信/A 股行情、K 线、财务包。
133. 需要页面证据、新闻正文、交互筛选、图表核对、脚本失败或字段缺失时，用 browser-use 打开 Yahoo Finance、交易所、上市公司 IR、公告页或搜索结果页交叉核对。
144. 输出结论时保留 ticker/证券代码、市场、数据区间、指标口径和来源 URL；不要把脚本结果当作投资建议。
155. 遇到登录墙、验证码、付费墙、商业授权、异常限流或禁止用途提示时停止该来源，改用可公开访问的页面或说明无法取得。
16 
17## API 脚本
18 
19脚本：`scripts/finance_search.py`。输出 JSON。依赖按命令懒加载。
20 
21首次运行或脚本提示缺库时，使用本技能的依赖清单安装到当前 Python 环境：
22 
23```bash
24python3 -m pip install -r requirements.txt
25```
26 
27不要在脚本内部自动安装依赖。若安装失败、网络不可用或包不可用，停止使用对应命令并改用公开网页来源，说明缺少依赖。
28 
29### yfinance
30 
31Yahoo Finance 代码后缀：美股直接用 `AAPL`；港股可用 `0700.HK`；A 股可用 `600036.SH`、`600036.SS`、`000001.SZ`，脚本会把 `.SH` 自动转成 `.SS`。不想自动转换时加 `--no-normalize`。
32 
33```bash
34python scripts/finance_search.py yf-search "Tesla" --limit 5 --news-count 5
35python scripts/finance_search.py yf-lookup "Tencent" --type stock --limit 10
36python scripts/finance_search.py yf-profile AAPL --fields longName,sector,industry,marketCap,currentPrice,trailingPE
37python scripts/finance_search.py yf-history AAPL --period 6mo --interval 1d --limit 120
38python scripts/finance_search.py yf-download AAPL MSFT NVDA --period 1mo --interval 1d --group-by ticker
39…