linkfox-zhihuiya-simple-bibliography

Zhihuiya 专利简要书目信息

本技能将指导你如何使用 Zhihuiya 专利数据库查询专利简要书目信息，帮助用户高效获取结构化专利元数据。

核心概念

Zhihuiya 简要书目信息工具可检索专利的基本书目信息（首页信息）。提供一个或多个专利 ID 或公开号后，它会返回结构化元数据，包括标题、摘要、申请人、发明人、专利权人、分类号、申请日期、优先权声明和引用信息。

查询模式：你可以通过 patentId（Zhihuiya 内部专利 ID）或 patentNumber（公开公开号／授权号）查询专利。如果同时提供这两个参数，则优先使用 patentId。多个值以逗号分隔，每次请求最多 100 个。

参数指南

参数	类型	必填	说明
patentId	string	有条件必填	Zhihuiya 内部专利 ID。多个值以逗号分隔，最多 100 个。必须至少提供 patentId 或 patentNumber 其中之一。
patentNumber	string	有条件必填	公开公开号／授权号（例如，US11234567B2、CN115000000A）。多个值以逗号分隔，最多 100 个。必须至少提供 patentId 或 patentNumber 其中之一。

优先级规则：同时提供 patentId 和 patentNumber 时，API 将使用 patentId，并忽略 patentNumber。

响应数据字段

字段	API 名称	说明
专利 ID	patentId	Zhihuiya 内部专利标识符
标题	title	专利标题
摘要	abstractContent	专利摘要文本
公开号	publicationNumber	公开号
公开号／授权号	pn	完整的公开号／授权号
国家代码	country	专利所属国家的代码
公开国家	publicationCountry	专利公开所在国家
公开日期	publicationDate	公开日期
公开种类	publicationKind	公开号种类代码
专利类型	patentType	专利类型（例如，发明、实用新型、外观设计）
种类代码	kind	专利种类代码
申请号	applicationNo	申请号
申请日期	applicationDate	专利申请日期
申请人	applicants	申请人列表
发明人	inventors	发明人列表
专利权人	assignees	专利权人／所有人列表
专利权人地址	assigneeAddresses	专利权人地址列表
IPC 主分类	ipcMain	IPC 主分类号
IPC 其他分类	ipcFurther	其他 IPC 分类号
CPC 主分类	cpcMain	CPC 主分类号
CPC 其他分类	cpcFurther	其他 CPC 分类号
LOC	loc	洛迦诺分类号（外观设计专利）
GBC	gbc	GBC 分类号
优先权声明	priorityClaims	优先权声明条目列表
PCT 申请号	pctApplicationNo	PCT 国际申请号
PCT 申请日期	pctFilingDate	PCT 国际申请日期
PCT 进入日期	pctEntryDate	PCT 国家阶段进入日期
引用的专利	citedPatents	被引用专利文献列表
引用的非专利文献	citedNonPatents	被引用非专利文献列表

调用方式

• API 端点：POST /zhihuiya/simpleBibliography（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/zhihuiya_simple_bibliography.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话中相同参数组合默认只调用一次，脚本带有 24h 本地缓存。失败或结果为空时，不得自动更换关键词、翻页或修改邮编连续试探；如需继续检索，先向用户说明会产生额外消耗。

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-simple-bibliography-<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 加载到上下文中。

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

• 未配置 API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应 401 或 402 状态码
• 响应提示算力或余额不足：消息包含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义的内容。

使用示例

1. 按公开号查询单件专利

User: "Show me the bibliographic info for patent US11234567B2."
Action: Call with patentNumber = "US11234567B2"

2. 按公开号查询多件专利

User: "Get the basic info for CN115000000A, EP4000000A1, and JP2023100000A."
Action: Call with patentNumber = "CN115000000A,EP4000000A1,JP2023100000A"

3. 按智慧芽专利 ID 查询专利

User: "Retrieve bibliography for patent IDs abc123 and def456."
Action: Call with patentId = "abc123,def456"

4. 获取发明人和申请人信息

User: "Who are the inventors and applicants for patent US20230001234A1?"
Action: Call with patentNumber = "US20230001234A1", then extract the inventors and applicants fields from the response.

5. 查看专利分类号

User: "What IPC and CPC codes does patent EP3999999B1 have?"
Action: Call with patentNumber = "EP3999999B1", then present ipcMain, ipcFurther, cpcMain, and cpcFurther from the response.

6. 获取专利摘要和引文

User: "Show me the abstract and cited patents for CN114000000B."
Action: Call with patentNumber = "CN114000000B", then display abstractContent and citedPatents.

展示规则

1. 清晰呈现数据：以结构清晰的表格或分组部分展示书目信息。对于单件专利，使用键值布局；对于多件专利，使用包含最相关列的表格。
2. 选择性展示：结果包含许多字段时，优先显示标题、公开号、申请人、发明人、申请日期、公开日期、主要 IPC/CPC 分类号和摘要。仅在用户明确要求时显示其他字段。
3. 列表字段：对于数组字段（发明人、申请人、专利权人、分类号、引文），根据长度以逗号分隔值或项目符号列表展示。
4. 空字段：省略值为 null 或为空的字段，不要显示空白条目。
5. 错误处理：查询失败时，根据错误消息说明原因，并建议用户核实专利号或 ID 格式。
6. 批量结果提示：一次查询多件专利时，提醒用户每次请求最多可查询 100 件。

重要限制

• 最大批量数量：每次请求最多可查询 100 个专利 ID 或公开号。
• 至少需要一个标识符：必须提供 patentId 或 patentNumber；两者都省略将导致错误。
• patentId 优先：如果同时提供两个参数，则只使用 patentId。
• 数据范围：本工具仅返回简单书目信息，不返回全文权利要求、详细说明、法律状态或专利族信息。

用户表达与场景速查

适用——专利著录数据检索：

用户表达	场景
“查询专利 XX” / “获取专利 XX 的信息”	单项专利著录信息查询
“专利 XX 的发明人是谁” / “申请人是谁”	发明人 / 申请人检索
“XX 的 IPC 分类号是什么” / “XX 的分类”	分类号查询
“显示 XX 的摘要”	摘要检索
“专利 XX 的申请日期是什么时候” / “XX 的公开日期”	日期信息查询
“XX 引用了哪些专利”	引用文献查询
“获取这些专利的著录数据：A、B、C”	批量著录信息查询
“专利基本信息” / “专利首页数据”	常规著录信息检索

不适用——超出简单著录数据查询范围：

• 专利权利要求全文或详细说明
• 专利法律状态或审查历史
• 专利族 / 等同专利分析
• 专利估值或专利布局分析
• 自由实施或侵权分析
• 按关键词或语义查询专利（此工具需要具体的专利标识符）

算力消耗规则

按动态规则计费：消耗算力 = 81 × 返回 data 条数。每条为 1 条简版专利著录项结果

重要：本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。

反馈：

在符合以下任一条件时，通过 Feedback API 自动检测并报告反馈：

1. 本技能描述的功能或用途与实际行为不符
2. 本技能的结果与用户意图不符
3. 用户对本技能表示不满或赞扬
4. 任何你认为可以改进的内容

按照 references/api.md 中的说明调用反馈 API。不要打断用户的操作流程。

---

如需获取更多优质、专业的跨境电商技能，请设置 LinkFox Skills。