| name | linkfox-google-patent-search |
| description | 通过 Google Patents 公开专利数据库检索全球专利，支持关键词、发明人、受让人、国家、日期、专利状态等多维筛选，返回专利公开号、标题、发明人、申请/公开/授权日期、受让人、CPC 分类、PDF 链接等核心著录数据。当用户提到谷歌专利、Google Patents、专利检索、专利搜索、查专利、专利防侵权、FTO 排查、prior art search、专利侵权排查时触发此技能。即使用户未明确提及"Google Patents"，只要用户希望通过关键词或著录条件检索专利文献，也应触发此技能。 |
Google Patents Search
This skill searches the public Google Patents database, returning matching patents with publication numbers, titles, inventors, assignees, dates, CPC classifications, and PDF links. Useful for cross-border sellers doing freedom-to-operate (FTO) checks, prior-art searches, and patent-infringement risk screening before listing a product.
Core Concepts
Google Patents Search runs a query (q) against the public Google Patents corpus. The query supports Google Patents' native advanced syntax (e.g. owner:"company", inventor:"name", date ranges). Results are returned as a ranked list of patents (and optionally Google Scholar articles).
This skill returns a list of patents with bibliographic fields. To retrieve detailed bibliographic data, full text, legal status, family, or images for a specific patent found here, feed the returned patentId/publicationNumber into the corresponding linkfox-zhihuiya-bibliography / linkfox-zhihuiya-legal-status / linkfox-zhihuiya-patent-family skills.
Data Fields
Each organicResults[] item (one matching patent):
| Field | Description |
|---|
| publicationNumber | Publication (announcement) number |
| patentId | Patent ID |
| title | Patent (or Scholar article) title |
| snippet | Result snippet / abstract |
| inventor | Inventor(s) |
| assignee | Assignee(s) |
| filingDate | Filing date |
| publicationDate | Publication / issue date |
| grantDate | Grant date |
| priorityDate | Priority date |
| language | Patent language |
| cpc | Cooperative Patent Classification (only when clustered) |
| cpcDescription | CPC description |
| countryStatus | Per-country legal status map |
| position | Search result position |
| rank | Result rank (may differ from position when clustered) |
| patentLink | Google Patents link |
| pdf | Patent PDF link |
| thumbnail | Patent thumbnail |
| figures | Figure list (thumbnail, full) |
| scholar | Whether this is a Google Scholar result |
| scholarId / scholarLink / author / authorEtal / publicationVenue / urlHostname | Scholar-article fields (present when scholar=true) |
| serpapiLink | Result detail-API link |
Top-level fields:
| Field | Description |
|---|
| organicResults | Patent search result list |
| searchParameters | Echoed query parameters |
| searchInformation | Search metadata (total results, time, etc.) |
| pagination / serpapiPagination | Pagination info |
| summary | Result summary |
| costToken | Token cost for this query |
| message | Provider info message (may appear when query succeeds but yields no results) |
调用方式
- 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/套餐到期/需充值/请充值"，或类似含义的内容。
Parameter Guide
| Parameter | Required | Default | Description |
|---|
| q | Yes | - | Google Patents search query, supports native advanced syntax (e.g. owner:"Company", inventor:"Lee", date operators). Max 1000 chars |
| num | No | 10 | Results per page, range 10–100 |
| page | No | 1 | Page number, starting from 1 |
| country | No | - | Country codes, comma-separated (e.g. US,CN,WO) |
| language | No | - | Languages, comma-separated (Google Patents official language values) |
| before | No | - | Max date, format `priority |
| after | No | - | Min date, same format as before |
| sort | No | - | new (newest) or old (earliest); default = relevance |
| type | No | - | Result type: PATENT or DESIGN |
| status | No | - | Patent status: GRANT or APPLICATION |
| patents | No | true | Whether to include patent results |
| scholar | No | false | Whether to include Google Scholar results |
| litigation | No | - | Litigation status: YES or NO |
| inventor | No | - | Inventor(s), comma-separated |
| assignee | No | - | Assignee(s), comma-separated |
| clustered | No | - | Cluster by classification; provider currently only supports true |
| dups | No | - | Dedup mode; default = by patent family, language = by publication text |
Query syntax
q accepts Google Patents' advanced query operators. Common forms:
| Operator | Meaning |
|---|
(wireless earbuds) | Full-text / general keyword |
owner:"Company Inc" | Assignee/owner match |
inventor:"J Lee" | Inventor match |
before:publication:20250101 / after:filing:20200101 | Date bounds (also passable as before/after params) |
Usage Examples
1. Basic keyword search
在 Google Patents 检索 wireless earbuds 相关专利，返回 10 条
Action: {"q": "wireless earbuds", "num": 10}
2. Filter by country + status
检索美国授权的 wireless earbuds 专利
Action: {"q": "wireless earbuds", "country": "US", "status": "GRANT"}
3. Date range + sort newest
检索 2024 年至今公开的 wireless earbuds 专利，按最新排序
Action: {"q": "wireless earbuds", "after": "publication:20240101", "sort": "new"}
4. Assignee search
检索受让人 Apple 的专利
Action: {"q": "owner:\"Apple\"", "assignee": "Apple"}
5. Paginate
继续检索 wireless earbuds，查看第 2 页，每页 20 条
Action: {"q": "wireless earbuds", "page": 2, "num": 20}
Display Rules
- Present results as a table: show
publicationNumber, title, inventor, assignee, publicationDate/grantDate per item.
- Show totals: always state the total hit count from
searchInformation/pagination and the current page range.
- Date formatting: render
filingDate/publicationDate/grantDate/priorityDate as readable dates.
- Links: surface
patentLink and pdf so the user can open the patent directly.
- Scholar results: when
scholar=true, visually distinguish Scholar articles from patents.
- Large result sets: present a summary table first, note the total, and offer to expand specific patents.
- Expand via sibling skills: to get full bibliographic/legal/family detail for a found patent, direct the user to
linkfox-zhihuiya-bibliography / linkfox-zhihuiya-legal-status; do not re-query this search skill for details.
- No fabrication: only display fields actually present in the response; never invent titles, dates, or assignees not returned.
Important Limitations
q is the primary search input: a query without q yields no meaningful results.num range 10–100; values outside the range are rejected.- List-only output: this skill returns bibliographic list fields. Full text, legal status, family, and images must be fetched via dedicated
linkfox-zhihuiya-* skills.
- No auto-retry on empty/error: if the query returns no hits or an error, do not automatically swap keywords or rewrite the query; confirm with the user first (each call costs credits).
clustered currently only supports true per the upstream provider.- Date params use the
priority|filing|publication:YYYYMMDD form, not bare dates.
User Expression & Scenario Quick Reference
Applicable — Discover patents on Google Patents:
| User Says | Scenario |
|---|
| "检索 wireless earbuds 的专利" | Basic keyword search |
| "查谷歌专利" / "Google Patents 搜一下" | General patent search |
| "美国授权的 XX 专利" | Country + status filter |
| "2024 年至今公开的 XX 专利" | Date range filter |
| "受让人是 Apple 的专利" | Assignee search |
| "翻到第 2 页" | Pagination |
Not applicable — Needs beyond Google Patents list search:
- Bibliographic detail / full text / legal status of a known patent number (use
linkfox-zhihuiya-bibliography etc.)
- Image-based patent search (use
linkfox-zhihuiya-patent-image-search)
- Zhihuiya Analytics expression search with field-scoped boolean syntax (use
linkfox-zhihuiya-retrieval-patent-search)
Boundary judgment: When the user wants to discover patents by keyword/inventor/assignee/country/date on the public Google Patents corpus → this skill. When they have a patent number and want its detailed metadata → the linkfox-zhihuiya-* skills.
积分消耗规则
消耗 8 积分。
用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
- The functionality or purpose described in this skill does not match actual behavior
- The skill's results do not match the user's intent
- The user expresses dissatisfaction or praise about this skill
- Anything you believe could be improved
Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.
