linkfox-google-patent-search

Google Patents Search

此技能可搜索 Google Patents 公共数据库，返回匹配的专利及其公开编号、标题、发明人、受让人、日期、CPC 分类和 PDF 链接。适用于跨境卖家在上架产品前进行自由实施（FTO）检查、现有技术检索和专利侵权风险筛查。

核心概念

Google Patents Search 会在 Google Patents 公共专利库中运行查询（q）。查询支持 Google Patents 原生高级语法（例如 owner:"company"、inventor:"name"、日期范围）。结果会以按相关性排序的专利列表形式返回（也可包含 Google Scholar 文章）。

此技能返回的是包含书目信息字段的专利列表。如需获取此处检出的特定专利的详细书目信息、全文、法律状态、专利族或图片，请将返回的 patentId/publicationNumber 传入相应的 linkfox-zhihuiya-bibliography / linkfox-zhihuiya-legal-status / linkfox-zhihuiya-patent-family 技能。

数据字段

每个 organicResults[] 条目（一个匹配的专利）：

Field	Description
publicationNumber	公开（公告）编号
patentId	专利 ID
title	专利（或 Scholar 文章）标题
snippet	结果摘要 / 摘要内容
inventor	发明人
assignee	受让人
filingDate	申请日期
publicationDate	公开 / 公告日期
grantDate	授权日期
priorityDate	优先权日期
language	专利语言
cpc	合作专利分类（仅在聚类时提供）
cpcDescription	CPC 描述
countryStatus	各国法律状态映射
position	搜索结果位置
rank	结果排名（聚类时可能与位置不同）
patentLink	Google Patents 链接
pdf	专利 PDF 链接
thumbnail	专利缩略图
figures	图片列表（thumbnail、full）
scholar	是否为 Google Scholar 结果
scholarId / scholarLink / author / authorEtal / publicationVenue / urlHostname	Scholar 文章字段（当 scholar=true 时提供）
serpapiLink	结果详情 API 链接

顶层字段：

Field	Description
organicResults	专利搜索结果列表
searchParameters	回显的查询参数
searchInformation	搜索元数据（结果总数、耗时等）
pagination / serpapiPagination	分页信息
summary	结果摘要
costToken	此次查询的算力成本
message	提供方信息消息（查询成功但无结果时可能出现）

调用方式

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

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-google-patent-search-<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/No permission/API package quota/套餐到期/需充值/请充值”或类似含义的内容。

参数指南

参数	必填	默认值	描述
q	是	-	Google Patents 搜索查询，支持原生高级语法（例如 owner:"Company"、inventor:"Lee"、日期运算符）。最多 1000 个字符
num	否	10	每页结果数，范围为 10–100
page	否	1	页码，从 1 开始
country	否	-	国家/地区代码，以逗号分隔（例如 US,CN,WO）
language	否	-	语言，以逗号分隔（Google Patents 官方语言值）
before	否	-	最晚日期，格式为 `priority
after	否	-	最早日期，格式与 before 相同
sort	否	-	new（最新）或 old（最早）；默认值 = 相关性
type	否	-	结果类型：PATENT 或 DESIGN
status	否	-	专利状态：GRANT 或 APPLICATION
patents	否	true	是否包含专利结果
scholar	否	false	是否包含 Google Scholar 结果
litigation	否	-	诉讼状态：YES 或 NO
inventor	否	-	发明人，以逗号分隔
assignee	否	-	受让人，以逗号分隔
clustered	否	-	按分类聚类；提供方目前仅支持 true
dups	否	-	去重模式；默认值 = 按专利族去重，language = 按公开文本去重

查询语法

q 接受 Google Patents 的高级查询运算符。常见形式：

运算符	含义
(wireless earbuds)	全文 / 通用关键词
owner:"Company Inc"	受让人/所有者匹配
inventor:"J Lee"	发明人匹配
before:publication:20250101 / after:filing:20200101	日期范围（也可通过 before/after 参数传入）

使用示例

1. 基本关键词搜索

在 Google Patents 检索 wireless earbuds 相关专利，返回 10 条

操作：{"q": "wireless earbuds", "num": 10}

2. 按国家/地区 + 状态筛选

检索美国授权的 wireless earbuds 专利

操作：{"q": "wireless earbuds", "country": "US", "status": "GRANT"}

3. 日期范围 + 按最新排序

检索 2024 年至今公开的 wireless earbuds 专利，按最新排序

操作：{"q": "wireless earbuds", "after": "publication:20240101", "sort": "new"}

4. 按受让人搜索

检索受让人 Apple 的专利

操作：{"q": "owner:\"Apple\"", "assignee": "Apple"}

5. 分页

继续检索 wireless earbuds，查看第 2 页，每页 20 条

操作：{"q": "wireless earbuds", "page": 2, "num": 20}

显示规则

1. 将结果以表格形式呈现：逐项显示 publicationNumber、title、inventor、assignee、publicationDate/grantDate。
2. 显示总数：始终注明 searchInformation/pagination 中的命中总数及当前页范围。
3. 日期格式：将 filingDate/publicationDate/grantDate/priorityDate 显示为易读的日期。
4. 链接：提供 patentLink 和 pdf，方便用户直接打开专利。
5. 学术搜索结果：当 scholar=true 时，在视觉上将 Scholar 文章与专利区分开。
6. 大量结果：先提供摘要表格，注明总数，并询问用户是否要展开查看特定专利。
7. 通过同级技能展开详情：若要获取已找到专利的完整书目信息/法律状态/专利族详情，请引导用户使用 linkfox-zhihuiya-bibliography / linkfox-zhihuiya-legal-status；不要重新调用此搜索技能查询详情。
8. 不得编造：仅显示响应中实际包含的字段；绝不编造未返回的标题、日期或受让人。

重要限制

• q 是主要搜索输入项：不带 q 的查询不会返回有意义的结果。
• num 范围为 10–100；超出范围的值会被拒绝。
• 仅输出列表：此技能返回书目列表字段。全文、法律状态、专利族和图片必须通过专用的 linkfox-zhihuiya-* 技能获取。
• 空结果或出错时不自动重试：如果查询没有命中结果或发生错误，请勿自动替换关键词或改写查询；请先向用户确认（每次调用都会消耗算力）。
• clustered 目前仅支持 true，这是上游提供方的限制。
• 日期参数使用 priority|filing|publication:YYYYMMDD 格式，不能只填写日期。

用户表达与场景速查

适用——在 Google Patents 上发现专利：

用户说法	场景
"检索 wireless earbuds 的专利"	基本关键词搜索
"查谷歌专利" / "Google Patents 搜一下"	一般专利搜索
"美国授权的 XX 专利"	国家 + 状态筛选
"2024 年至今公开的 XX 专利"	日期范围筛选
"受让人是 Apple 的专利"	受让人搜索
"翻到第 2 页"	分页

不适用——需求超出 Google Patents 列表搜索范围：

• 已知专利号的书目详情 / 全文 / 法律状态（使用 linkfox-zhihuiya-bibliography 等）
• 基于图片的专利搜索（使用 linkfox-zhihuiya-patent-image-search）
• 使用字段范围布尔语法的智慧芽 Analytics 表达式搜索（使用 linkfox-zhihuiya-retrieval-patent-search）

边界判断：当用户想在公开的 Google Patents 专利库中按关键词 / 发明人 / 受让人 / 国家 / 日期发现专利时，使用此技能。当用户提供专利号并想了解其详细元数据时，使用 linkfox-zhihuiya-* 技能。

算力消耗规则

消耗 8 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

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

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

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

---

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