linkfox-eureka-description

Eureka 专利说明书数据

此技能将指导你如何从 Eureka 专利数据平台查询专利说明书数据，帮助用户检索特定专利的完整说明书内容。

核心概念

专利说明书（也称为说明书）是随专利申请提交的详细技术文档。它公开了发明的工作原理、优选实施例以及专利法要求的其他技术细节。此工具通过专利内部 ID 或公开公告号识别一项或多项专利，并从 Eureka 平台查询说明书数据。

标识符优先级：同一查询同时提供专利 ID 和公开公告号时，优先使用专利 ID。

同族替代：如果无法获取指定专利的说明书，此工具可以选择返回相关同族专利的说明书。

参数

参数	类型	必填	描述
patentId	string	有条件必填	内部专利 ID。必须至少提供 patentId 或 patentNumber 之一。多个值以逗号分隔；最多 100 个。
patentNumber	string	有条件必填	公开／公告号。必须至少提供 patentId 或 patentNumber 之一。多个值以逗号分隔；最多 100 个。
replaceByRelated	string	否	当无法获取目标专利的说明书时，是否替换为同族专利的说明书。1 = 是，0 = 否。

响应字段

字段	类型	描述
total	integer	返回的专利记录数
data	array	专利说明书对象列表
data[].patentId	string	专利 ID
data[].pn	string	公开公告号
data[].pnRelated	string	替代同族专利的公开公告号（仅在使用同族替代时提供）
data[].description	array	说明书内容章节
columns	array	用于渲染的列定义
costToken	integer	查询消耗的 Token 数
type	string	渲染样式提示

调用方式

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

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-eureka-description-<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 放入上下文。

解决认证和积分问题

发生以下异常情况时，采用以下措施处理：

异常情况

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

措施

• 优先采用技能内的 onboarding.md 引导解决问题。
• 如果找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个技能并按照其引导处理。如果未安装，请先安装：
  • 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装此技能。如果需要用户授权才能下载，必须向用户询问并获得授权；不能自行放弃下载。
• 兜底措施：只有前面两项措施经过所有努力仍无法解决时，才提示用户按照 https://skill.linkfox.com/linkfoxskills/guide.htm 的指引获取 API Key，或前往 https://os.linkfox.com/ 补充积分。

如何构建查询

按公开公告号查询

用户提供专利公开公告号（例如 CN115099012A、US20230012345A1）时，通过 patentNumber 参数传递：

patentNumber: "CN115099012A"

按专利 ID 查询

用户提供内部专利 ID 时，通过 patentId 参数传递：

patentId: "abc123def456"

批量查询

patentId 和 patentNumber 均支持以逗号分隔的多个值进行批量查询（最多 100 个）：

patentNumber: "CN115099012A,US20230012345A1,EP4123456A1"

同族替代

当数据库中没有某项专利的说明书，而用户仍需要相关内容时，请启用同族替代：

patentNumber: "CN115099012A"
replaceByRelated: "1"

使用示例

1. 按公开号查询单项专利说明书

patentNumber: "CN115099012A"

2. 一次查询多项专利的说明书

patentNumber: "CN115099012A,US20230012345A1"

3. 启用同族替代进行查询

patentNumber: "CN115099012A"
replaceByRelated: "1"

4. 按专利 ID 查询

patentId: "some-patent-id"

展示规则

1. 忠实呈现数据：清晰展示返回的说明书内容，不得更改技术细节或添加主观解读。
2. 结构化输出：当说明书包含多个章节（背景、摘要、详细说明、权利要求等）时，请使用清晰的标题展示，方便阅读。
3. 同族替代提示：如果响应包含 pnRelated 字段，请明确告知用户说明书来自相关同族专利，并注明替代公开号。
4. 批量结果：返回多项专利时，请以公开号为标题，清晰区分每项专利的内容。
5. 错误处理：查询失败或无数据时，请说明原因，并建议用户核实专利 ID 或公开号。

重要限制

• 标识符要求：必须提供 patentId 或 patentNumber 中的至少一项；该工具无法按关键词或申请人名称搜索。
• 批量限制：单次请求最多可查询 100 项专利。
• 可用性：数据库中并非所有专利都有说明书。必要时可使用 replaceByRelated: "1" 尝试进行同族替代。
• 优先级规则：如果同时提供 patentId 和 patentNumber，则优先使用 patentId。

用户表达与场景速查

适用——关于专利说明书内容的查询：

用户表达	场景
"Show me the description of patent XX"	查询单项专利说明书
"Get the full specification for these patents"	批量获取专利说明书
"I need the detailed text of CN115099012A"	按公开号查询
"Can you find a family patent's description instead"	同族替代查询
"What does this patent describe technically"	查看说明书内容

不适用——超出专利说明书数据范围的需求：

• 按关键词、申请人或分类搜索专利
• 专利权利要求分析或权利要求对照表生成
• 专利法律状态或审查历史
• 专利布局或统计分析
• 自由实施或侵权意见

积分消耗规则

按动态规则计费：消耗积分 = 81 × max(返回条数, 1)。

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

反馈：

出现以下任一情况时，通过 Feedback API 自动检测并提交反馈：

1. 本技能描述的功能或用途与实际行为不符
2. 技能结果与用户意图不符
3. 用户表达对本技能的不满或赞赏
4. 你认为任何方面有待改进

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

---

如需了解更多优质、专业的跨境电商技能，请访问 LinkFox Skills。