技能介绍

要解决什么问题

futunn.com 把美股、港股、A 股上市公司的业务公告（业绩、通函、股东大会等）聚在一个列表里，背后接口是 quote-api/quote-v2/get-news-list。但请求带 WAF 和客户端签名：缺少真实浏览器会话时，quote-token 算不对，常见返回是 {code:500, message:"Params Error"}。手工在网页里逐条点附件，跨三个市场、多 ticker、多财年，很难自动化进本地研报或解析流水线。

技能如何工作

会话：用 Playwright 在有 GUI 的环境做一次交互登录，把 cookies 落到本地；编排里对 login.py 应固定使用 --skip-if-valid，避免在无 TTY/无头环境里反复弹窗。
签名：Python 侧复刻 Futu 的 HmacSHA512 + SHA256 双层截断逻辑，生成 quote-token 等头，再调公告列表与详情。
分市场下载：由 config/companies.json 与 marketProfiles 驱动——HK/CN 从详情页匹配 PDF，单文件落地；US 走 SEC EDGAR accession 目录，按 10-K/10-Q 或中概 6-K/20-F 规则筛主 HTML 与 ex99 附件。
标的补全：传入的 ticker 若不在配置里，companies_registry 会调 Futu predict 接口选市场、写回 JSON，并带上 supportFileTypes、titleKeyWords 等标题/周期过滤默认值。
落地结构：文件写到 workspace/portfolio/<ticker>/filings/ 下，每份公告独立目录 + meta.json（财年、formType、SHA256、来源 URL 等）；stdout 末尾有 summary JSON，单条失败记入 errors 不拖垮整批。

适用边界与注意点

登录：WAF 依赖真实浏览器指纹与 cookie（含 csrfToken）；无图形界面的服务器只能拷贝已有 cookies.json，过期时需回到可交互机器 --interactive 重登。
过滤：supportFileTypes、titleKeyWords、supportPeriodTypes 过严会导致大量 skipped；美股 6-K 会对 ex99-1 内容做「是否业绩公告」二次判定，非财报会正常丢弃。
合规节流：脚本内置请求间隔（详情页、SEC 文件、ticker 间 sleep），勿把间隔调到 0，以免触发 Futu 限流或 IP 临时封禁。
港股代码：须 5 位数字（如 00700），不是 700。