用途：查询北交所（证券代码 4/8/9 开头）上市公司年度报告的结构化提取结果，返回营收、利润、分红、战略要点等标准字段，供 Agent 直接推理。服务地址为 https://api.clawshire.cn。
主要能力：按证券代码查询年报（GET /api/v1/stock/{sec_code}/announcements，infotype 固定为年报）；按年份查询全市场年报（GET /api/v1/announcements）；按公告链接查询（GET /api/v1/met_link）；财务风险分析（POST /api/v1/financial-analysis/jobs 上传 PDF，轮询 job_id，调用 25+ 条规则输出低/中/高风险评级，需在控制台开通权限）。结果按基本信息、审计情况、主要财务指标、利润表摘要、股本结构、前十大股东、分红情况等结构展示，金额保留原始小数位。
使用方式：调用前检查 CLAWSHIRE_API_KEY 环境变量是否存在，不得明文显示 key；请求头携带 Authorization: Bearer $CLAWSHIRE_API_KEY。无 key 时引导用户到 https://clawshire.cn 注册，并设置 export CLAWSHIRE_API_KEY="sk-xxxxxxxx"。导出表格可用 python clawshire_annual_client.py list --year 2024 --output csv 或 --output excel；单公司导出用 python clawshire_annual_client.py stock 833359 --output excel。财务分析脚本：python scripts/financial_analysis_client.py analyze path/to/年报.pdf，查看规则用 rules 子命令。
适用场景：查询某家北交所公司年报、按年度批量获取全市场年报、根据原文链接提取结构化数据、导出 CSV/Excel、对年报 PDF 做财务风险分析。
限制：免费账户每个 API Key 共 100 次调用额度，年报按条计费；单次查询建议 page_size 不超过 20；北交所年报通常集中在次年 3～4 月披露；财务分析通常耗时 2-8 分钟，PDF 最大 100MB，且需控制台开通权限（即将支持）。错误码 400/401/402/404/500 分别对应参数错误、Key 无效、额度不足、资源不存在、服务器错误。部分字段与规则细节暂未提供。