linkfox-zhihuiya-pdf-data

根据专利 ID 或公开公告号获取智慧芽(PatSnap)专利 PDF 全文下载链接,支持批量获取及原文不可用时的同族专利替代。适用于下载、查看或批量导出已知专利的全文文档,无需明确提及智慧芽;不适用于按关键词或申请人发现专利、引证与法律状态分析、权利要求解读翻译或专利组合及技术布局分析。

SKILL.md

GitHub

智慧芽专利 PDF 全文获取

适用范围

适用

用户已知专利标识,希望获取单件或多件专利的 PDF 全文下载链接,或在原文不可用时获取同族专利文档。

场景速查

用户表达 查询场景
下载这个专利的 PDF 根据已知标识获取单件专利全文。
获取这些专利的全文文档 批量获取专利 PDF 链接。
我有公开号,想查看全文 根据公开公告号获取文档。
原文没有 PDF,能否找同族文档 按用户意图使用同族专利替代。
批量导出这些专利 PDF 汇总已知专利的文档链接与可用情况。

前置条件

先确定专利标识与替代意图:取得用户提供的智慧芽专利 ID 或公开公告号;是否接受同族文档应以用户要求为准。具体参数约束见 references/api.md。

获取专利全文流程

  1. 整理用户提供的专利标识,区分智慧芽 ID 和公开公告号;按 references/api.md 准备请求,并核对是否允许同族替代。
  2. 根据所需请求次数预估算力消耗;超过单次 100 件上限时按批次计费。已有明确授权时按授权范围执行。
  3. 优先复用相同参数的已有结果,按需获取 PDF 链接。失败或空结果时先解释原因,建议核对标识或考虑同族替代,后续请求遵守成本约束。
  4. 展示每件专利的文档链接及来源,说明原文不可用、缺失结果和同族替代情况。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 references/api.md。
  • 脚本调用(推荐):python scripts/zhihuiya_pdf_data.py '<JSON 参数>' [--inline]。
  • 成本约束:本工具会消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

输出策略

  • 始终保存完整响应,目标路径为 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-pdf-data-<timestamp>.json。<cwd> 为脚本运行时的工作目录,<session> 优先取环境变量 SESSION_ID,用于聚合同一任务的数据。禁止写入 /tmp,当前目录不可写时应报错。
  • 序列化响应不超过 8000 个 UTF-8 字节:保存后,将完整 JSON 打印到标准输出。
  • 序列化响应超过 8000 个 UTF-8 字节:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 total、costToken)、最大列表字段的长度和前 3 条样本。
  • 添加 --inline 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

执行规则

算力消耗预估

3 算力/次。按需请求次数预估,单次请求内不按返回的 data 条数倍增;拆分批次或重新请求会分别计费,本地缓存命中不发起请求。

声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

解决认证和算力问题

出现以下情况时,按 references/onboarding.md 的指引处理:

  • 未配置接口密钥:LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY 均为空。
  • 响应状态码为 401 或 402。
  • 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

约束与建议

  • 区分标识概念:专利 ID 是智慧芽内部数字标识;公开公告号是公开使用的专利编号,例如 US20230012345A1、CN115000000A。标识选择与批量限制见 references/api.md。
  • 理解同族替代:同族专利的 PDF 可帮助获取相关文档,不能把它标成所查询专利自身的原文;并非所有专利都有可用 PDF。
  • 清晰展示链接:单件结果可用列表;批量结果用表格,列出公开号、专利 ID、可点击的 PDF 链接及替代说明。
  • 标明文档来源:使用同族替代时明确写明替代来源的公开号,让用户区分原专利与同族文档。相关字段见 references/api.md。
  • 解释不可用结果:未返回文档链接时,说明 PDF 暂不可用;失败或空结果按实际错误解释,建议核对专利 ID 或公开号。尚未使用同族替代时,可建议用户考虑该选项,不自动追加请求。

使用示例

按公开公告号获取单件专利

{"patentNumber": "US20230012345A1"}

按公开公告号批量获取

{"patentNumber": "CN115000000A,CN115000001A,CN115000002A"}

按智慧芽专利 ID 获取

{"patentId": "12345678"}

原文不可用时使用同族文档

{"patentNumber": "EP4000000A1", "replaceByRelated": "1"}

按专利 ID 批量获取

{"patentId": "11111111,22222222,33333333"}

使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。


更多优质、专业的跨境电商技能,请访问 LinkFox Skill。