用途:查询 A 股上市公司公告的结构化提取结果,可按日期范围、证券代码或公告原文链接检索。服务地址为 https://api.clawshire.cn。
主要能力:提供三个查询接口——GET /api/v1/announcements(按日期查询)、GET /api/v1/stock/{sec_code}/announcements(按证券代码查询)、GET /api/v1/met_link?met_link=<url_encoded_link>(按公告链接查询)。这三个接口无需认证即可调用。结果展示包含公司(sec_name、sec_code)、类型(infotype)、日期(doc_date)、原文链接(met_link)及 extracted_info 完整 JSON。
使用方式:调用前须检查 CLAWSHIRE_API_KEY 环境变量是否存在,只判断存在性,不得明文输出 key。若接口需要认证,请求头携带 Authorization: Bearer $CLAWSHIRE_API_KEY。日期格式为 YYYY-MM-DD,证券代码为 6 位数字。未指定数量时默认 page_size=20,page_size 最大 100,超出需分页。API Key 需登录 https://clawshire.cn 控制台手动创建,不支持通过接口注册获取,设置方式为 export CLAWSHIRE_API_KEY="sk-xxxxxxxx"。
适用场景:获取某天或某段时间内全部公告提取结果、关注特定上市公司公告、根据公告原文链接获取结构化提取内容。
限制:免费账户每个 API Key 共 100 次调用额度;每次查询日期范围建议不超过 30 天;建议用宽日期范围加类别筛选减少翻页。错误码 400 为参数错误,401 为 API Key 无效,404 为资源不存在,500 为服务器错误需稍后重试。注册与文档见 https://clawshire.cn/api-docs。