AgentSkillsCN

ip_research

专利、商标及申请相关的 IP 数据研究工具。适用于以下场景： - 根据专利号（如美国、欧洲、世界知识产权组织、日本等）查询专利信息； - 通过关键词、受让人、发明人或分类检索专利数据库； - 获取专利家族、引证信息或法律状态详情； - 查询美国专利商标局的申请状态、档案归档情况，或 PTAB 诉讼进程； - 下载批量的美国专利商标局数据产品； - 查找专利转让记录或所有权历史。

SKILL.md
--- frontmatter
name: ip_research
description: |
  IP data research tools for patents, trademarks, and applications. Use when:
  - Looking up patents by number (US, EP, WO, JP, etc.)
  - Searching patent databases by keyword, assignee, inventor, or classification
  - Getting patent family, citation, or legal status information
  - Checking USPTO application status, file wrapper, or PTAB proceedings
  - Downloading bulk USPTO data products
  - Finding patent assignments or ownership history

IP Research

Async Python clients for patent data. All clients use async with context managers.

Routing

TaskClientReference
Patent lookup/searchGooglePatentsClientgoogle_patents.md
USPTO application statusApplicationsClientuspto_odp.md
USPTO PTAB (IPR/PGR)PtabTrialsClientuspto_odp.md
USPTO bulk dataBulkDataClientuspto_odp.md
USPTO assignmentsUsptoAssignmentsClientuspto_assignments.md
EPO bibliographic/familyEpoOpsClientepo_ops.md
JPO application statusJpoClientjpo.md

Quick Examples

Lookup patent by number

python
from ip_tools.google_patents import GooglePatentsClient

async with GooglePatentsClient() as client:
    patent = await client.get_patent_data("US10123456B2")

Search patents

python
from ip_tools.google_patents import GooglePatentsClient

async with GooglePatentsClient() as client:
    results = await client.search_patents(
        keywords="machine learning",
        assignee="Google",
        limit=25
    )

Check application status

python
from ip_tools.uspto_odp import ApplicationsClient

async with ApplicationsClient() as client:  # Requires USPTO_ODP_API_KEY
    app = await client.get("16123456")
    docs = await client.get_documents("16123456")

Find PTAB proceedings

python
from ip_tools.uspto_odp import PtabTrialsClient

async with PtabTrialsClient() as client:
    results = await client.search_proceedings(query="patent:US10123456")

Environment Variables

VariableRequired For
USPTO_ODP_API_KEYAll ODP clients (Applications, PTAB, BulkData, Petitions)
EPO_OPS_API_KEYEPO OPS client
EPO_OPS_API_SECRETEPO OPS client
JPO_API_USERNAMEJPO client
JPO_API_PASSWORDJPO client

Cache Management

All clients cache to ~/.cache/ip_tools/. See cache.md for TTL, invalidation, and statistics APIs.

Issue Reporting

Source: parkerhancock/ip_tools

Report bugs with: version, minimal reproduction code, and API response if applicable.

References