get_most_litigated_patents
Identify top 10 litigated patents by litigation count to assess risk in a specific technology area. Use keywords, IPC codes, or filters like application year, publication year, or patent authority for targeted results.
Instructions
Identify the patents involved in the most litigation cases, indicating potential risk in a technology space. Returns the Top 10 patents by litigation count. Note: Search must contain either keywords or IPC. If both are provided, IPC is prioritized.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apply_end_time | No | Patent application end year (yyyy format). Filters by application filing date. | |
| apply_start_time | No | Patent application start year (yyyy format). Filters by application filing date. | |
| authority | No | Patent authority code (e.g., CN, US, EP, JP). Filters by patent office. Use OR for multiple, e.g., "US OR EP". | |
| ipc | No | Patent IPC classification code. Used to specify a particular technology field. | |
| keywords | No | Keywords to search within patent title and abstract/summary. Supports AND, OR, NOT logic. Example: "mobile phone AND (screen OR battery)" | |
| public_end_time | No | Patent publication end year (yyyy format). Filters by publication date. | |
| public_start_time | No | Patent publication start year (yyyy format). Filters by publication date. |
Implementation Reference
- src/index.ts:273-277 (handler)The handler function that implements the core logic for the 'get_most_litigated_patents' tool. It constructs search parameters and calls the PatSnap API endpoint 'most-asserted' to retrieve the most litigated patents.async function getMostLitigatedPatents(args: BasePatentArgs): Promise<ServerResult> { const params = buildCommonSearchParams(args); // No 'lang' parameter for this endpoint return callPatsnapApi('most-asserted', params, 'get most litigated patents'); }
- src/index.ts:303-316 (schema)The base input schema used by the 'get_most_litigated_patents' tool (and others) for validating input parameters like keywords, IPC, dates, and authority.const basePatentInputSchema = { type: 'object' as const, // Use 'as const' for stricter type checking properties: { keywords: { type: 'string', description: 'Keywords to search within patent title and abstract/summary. Supports AND, OR, NOT logic. Example: "mobile phone AND (screen OR battery)"' }, ipc: { type: 'string', description: 'Patent IPC classification code. Used to specify a particular technology field.' }, apply_start_time: { type: 'string', description: 'Patent application start year (yyyy format). Filters by application filing date.' }, apply_end_time: { type: 'string', description: 'Patent application end year (yyyy format). Filters by application filing date.' }, public_start_time: { type: 'string', description: 'Patent publication start year (yyyy format). Filters by publication date.' }, public_end_time: { type: 'string', description: 'Patent publication end year (yyyy format). Filters by publication date.' }, authority: { type: 'string', description: 'Patent authority code (e.g., CN, US, EP, JP). Filters by patent office. Use OR for multiple, e.g., "US OR EP".' } }, // Add a note about requiring keywords or IPC for most tools description: "Requires either 'keywords' or 'ipc' to be specified for a meaningful search. If both are provided, IPC is prioritized by the API." };
- src/index.ts:377-380 (registration)Registration of the tool in the ListToolsRequestHandler, specifying the name, description, and input schema reference.name: 'get_most_litigated_patents', description: 'Identify the patents involved in the most litigation cases, indicating potential risk in a technology space. Returns the Top 10 patents by litigation count. Note: Search must contain either keywords or IPC. If both are provided, IPC is prioritized.', inputSchema: basePatentInputSchema },
- src/index.ts:402-402 (registration)Internal registration mapping the tool name to its handler function in the toolImplementations object used by CallToolRequestHandler.'get_most_litigated_patents': getMostLitigatedPatents,
- src/index.ts:213-213 (schema)TypeScript type definition for the base arguments used in the handler function.type BasePatentArgs = { keywords?: string; ipc?: string; apply_start_time?: string; apply_end_time?: string; public_start_time?: string; public_end_time?: string; authority?: string };