sn-search-year-report

检索并定位上市公司年报、定期报告与披露文件的免费官方来源。

需要检索上市公司年报、定期披露或债券和海外公司报告时用，从免费官方渠道定位 PDF 或详情页并返回公司代码、报告期、披露日和来源 URL。只采可公开访问的免费来源，遇到付费、登录墙或验证码会自动放弃，不做绕过。适合合规地收集年报与披露文件用于尽职调查或研究。

# Search Year Report

## 凭证配置

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

只使用免费、官方、可正常访问的年报/年度账目/定期报告来源。遇到商业库、订阅、试用额度、付费下载、登录墙、验证码、防护页、不可访问页面，立即丢弃，不要绕过限制。

输出时保留公司/证券代码、报告期、文件标题、披露日期、PDF 或详情页 URL、来源名称。

## 工作流

1. 先判断主体类型：A 股/港股/美股/英企/日本上市公司/发债主体/加拿大/新加坡/澳洲。
2. `scripts/year_report_api.py` 和 browser-use 可混合使用：脚本适合结构化查询，网页适合站内筛选、页面确认、下载公开 PDF。
3. 没有脚本覆盖或需要交互筛选的来源，用 browser-use 打开下表网页，通过站内搜索、筛选公告类别、定位 PDF 或详情页。
4. 只接受官方披露源；公司官网 IR 可作补充，但不能替代官方源。
5. 中国普通非上市企业通常没有公开完整财务年报；工商年报不是审计财报，且本技能已丢弃不可稳定访问的工商公示系统。

## API 脚本

脚本位置：`scripts/year_report_api.py`。只依赖 Python 标准库。

```bash
python scripts/yea