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 (
) against the public Google Patents corpus. The query supports Google Patents' native advanced syntax (e.g.
,
, 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
/
into the corresponding
linkfox-zhihuiya-bibliography
/
linkfox-zhihuiya-legal-status
/
linkfox-zhihuiya-patent-family
skills.
Data Fields
Each
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 (, ) |
| scholar | Whether this is a Google Scholar result |
| scholarId / scholarLink / author / authorEtal / publicationVenue / urlHostname | Scholar-article fields (present when ) |
| 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
- Python 脚本：
python scripts/google_patent_search.py '<JSON 参数>' [--inline]
- 成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索或翻页时先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：
- 始终将完整响应写入
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-google-patent-search-<timestamp>.json
- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 /、最大列表字段的长度 + 前 3 条样本）
- 加 强制全量打印到 stdout（同样落盘）
读数据建议：先看摘要判断是否足够；需要具体字段时优先用
或
从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
解决认证和积分问题
发生以下异常情况时，采用 references/onboarding.md 引导解决问题：
异常情况
- 未配置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. , , 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. ) |
| language | No | - | Languages, comma-separated (Google Patents official language values) |
| before | No | - | Max date, format `priority |
| after | No | - | Min date, same format as |
| sort | No | - | (newest) or (earliest); default = relevance |
| type | No | - | Result type: or |
| status | No | - | Patent status: or |
| patents | No | true | Whether to include patent results |
| scholar | No | false | Whether to include Google Scholar results |
| litigation | No | - | Litigation status: or |
| inventor | No | - | Inventor(s), comma-separated |
| assignee | No | - | Assignee(s), comma-separated |
| clustered | No | - | Cluster by classification; provider currently only supports |
| dups | No | - | Dedup mode; default = by patent family, = by publication text |
Query syntax
accepts Google Patents' advanced query operators. Common forms:
| Operator | Meaning |
|---|
| Full-text / general keyword |
| Assignee/owner match |
| Inventor match |
before:publication:20250101
| Date bounds (also passable as / 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
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 , , , , / per item.
- Show totals: always state the total hit count from / and the current page range.
- Date formatting: render /// as readable dates.
- Links: surface and so the user can open the patent directly.
- Scholar results: when , 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
- No fabrication: only display fields actually present in the response; never invent titles, dates, or assignees not returned.
Important Limitations
- is the primary search input: a query without yields no meaningful results.
- 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 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).
- currently only supports per the upstream provider.
- Date params use the
priority|filing|publication:YYYYMMDD
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
- 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
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
. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.