SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场linkfox-zhihuiya-patent-forward-citation

linkfox-zhihuiya-patent-forward-citation

数据与分析

查看项目

更新于 10-15 09:05

技能介绍

用途

本技能用于从智慧芽（Zhihuiya）专利数据库查询专利的前向引用（forward citation）详情，帮助用户了解某件专利在申请过程中引用了哪些专利文献和非专利文献。前向引用是专利分析的基础内容，通过了解一件专利引用的在先技术，有助于评估其新颖性、保护范围和技术脉络。

主要能力

  • 查询指定专利引用的其他专利文献（citedPatents）。
  • 查询指定专利引用的非专利文献（citedOthers），如学术论文、技术报告等。
  • 支持通过专利 ID（patentId）或公开/公告号（patentNumber）查询，两者至少提供一个；同时提供时以 patentId 优先。
  • 支持批量查询，多个值用英文逗号分隔，每个参数单次最多 100 条。

使用方式

调用方式有两种：

  1. API 端点：POST /zhihuiya/patentForwardCitation（完整参数、响应与错误码见 references/api.md）。
  2. Python 脚本：python scripts/zhihuiya_cited_references.py '<JSON 参数>' [--inline]。

参数说明：

  • patentId（string，条件必填）：专利 ID，多个用英文逗号分隔，最多 100 条。
  • patentNumber（string，条件必填）：公开/公告号，多个用英文逗号分隔，最多 100 条。

规则：patentId 与 patentNumber 至少提供一个；两者都提供时优先使用 patentId；多个值用英文逗号分隔；每个参数单次最多 100 条。

响应字段包括：total（返回记录总数）、data（专利引用结果列表，含 patentId、pn、citedPatents、citedOthers）、columns（渲染用列定义）、costToken（查询消耗的 token 数）、type（渲染样式提示）。

输出策略（脚本默认行为）：

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-patent-forward-citation-<timestamp>.json；<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID；禁止写入 /tmp，当前目录不可写则报错。
  • 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout。
  • 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）。
  • 加 --inline 强制全量打印到 stdout（同样落盘）。

读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24 小时本地缓存。失败或空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

认证与算力问题：当出现未配置 API Key（环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY）、响应 401 或 402 状态码、或响应提示算力或余额不足（消息含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义）时，采用 references/onboarding.md 引导解决。

适用场景

  • 用户询问“XX 专利引用了哪些专利”。
  • 用户想查看某专利的参考文献。
  • 用户想了解某专利引用的在先技术。
  • 用户想列出某专利引用的文献。
  • 用户需要对某专利进行引用分析（专利与文献引用合并）。
  • 用户想了解某专利引用了哪些文档。

不适用场景：后向/反向引用（谁引用了该专利）、专利有效性或法律状态、专利族分析、专利全文检索、专利分类或景观分析。

限制

  • 必须提供 patentId 或 patentNumber 中的至少一个。
  • 每个参数单次最多 100 条。
  • 按动态规则计费：消耗算力 = 81 × 返回 data 条数，每条为 1 条专利引证文献结果。本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。
  • 仅展示 API 返回的数据，不得推断或编造引用详情。
  • 查询失败时需根据错误响应说明原因，并建议用户核实专利 ID 或公开/公告号。
  • 批量查询时按专利分组组织结果；若某专利无引用，应明确告知用户而非展示空表。

展示规则

  • 清晰呈现数据：以结构化表格展示引用结果，区分专利引用与非专利文献引用。
  • 汇总计数：始终说明被引专利和被引非专利文献的总数。
  • 不编造：只展示 API 返回的数据。
  • 错误处理：查询失败时根据错误响应解释原因，并建议用户核实专利 ID 或公开/公告号。
  • 批量结果：查询多个专利时，按专利分组组织结果。
  • 空结果：若某专利无引用，明确告知用户。

反馈

当出现以下情况时，通过 Feedback API 自动检测并报告反馈：技能描述的功能或目的与实际行为不符；技能结果与用户意图不符；用户对本技能表达不满或赞扬；任何可改进之处。按 references/api.md 的说明调用反馈 API，不要打断用户流程。