用途:把用户自备的 PDF 转成结构化 JSON。上传 PDF 后用自然语言描述要提取的字段,即可得到结构化结果,适用于简历、合同、研报、说明书等任意 PDF。
主要能力:多文档批量提取;多轮迭代修正(如统一金额格式);Schema 复用与本地 Schema 库;本地提取缓存以节省额度;提取完成后输出字段覆盖率摘要。
使用方式:服务地址为 https://api.clawshire.cn,需先设置 CLAWSHIRE_API_KEY。脚本仅用 Python 标准库,无需第三方依赖。典型流程为 upload 上传获得 document_id,schema-create 与 schema-chat 设计字段,session-create 创建会话,extract --auto-end 执行提取并输出结果。示例: $SCRIPT upload 合同.pdf $SCRIPT schema-create --doc-ids <document_id> $SCRIPT schema-chat <conversation_id> "提取甲方、乙方、合同金额、签署日期" --save-as 合同 $SCRIPT session-create --name "合同提取" --from-lib 合同 --doc-ids <document_id> $SCRIPT extract --session-id <session_id> --doc-ids <document_id> --out result.json --auto-end 也提供完整 7 步 API 工作流,含上传、Schema 对话、创建 Session、执行提取、迭代修正与归档。
适用场景:需要从 PDF 提取结构化信息、把文档内容转成 JSON/表格、批量解析同类文档并复用字段模板时。
限制:schema-chat 约 30 秒至 3 分钟,extract 约 1 至 5 分钟,需告知用户等待;401 检查 API Key,413 单文件超过平台 MAX_UPLOAD_MB,503 插件未启用或未配置引擎 URL,502 引擎超时或 SSE 报错需重试。平台需启用 MEME_PLUGIN_REFLECT_ENGINE_ENABLED。本技能不需要 met_uuid;若只有公告链接,应使用 clawshire-data-query。