get_wheel_of_innovation
Analyze hierarchical keyword and IPC relationships in patent data to uncover common terms and their associations. Supports filtering by date, authority, and language for targeted technology insights.
Instructions
Provides a two-tiered hierarchical view of keywords/phrases in a technology space. Identify common terms and their associations. Based on the most recent 5,000 publications. Either keywords or IPC classification must be specified.
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)" | |
| lang | No | Language setting. Default is "en" (English). Choose "cn" (Chinese) or "en". | |
| 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:232-238 (handler)The handler function implementing the core logic for the 'get_wheel_of_innovation' tool. It constructs URL parameters from input args, defaults language to 'en', and delegates to the shared callPatsnapApi helper for the API call.async function getWheelOfInnovation(args: LangPatentArgs): Promise<ServerResult> { const params = buildCommonSearchParams(args); if (!args.lang) { // Add default lang if not provided params.append('lang', 'en'); } return callPatsnapApi('wheel-of-innovation', params, 'get wheel of innovation'); }
- src/index.ts:346-350 (schema)Schema registration for the tool in the ListTools response, defining name, description, and referencing the input schema (langPatentInputSchema).{ name: 'get_wheel_of_innovation', description: 'Provides a two-tiered hierarchical view of keywords/phrases in a technology space. Identify common terms and their associations. Based on the most recent 5,000 publications. Either keywords or IPC classification must be specified.', inputSchema: langPatentInputSchema },
- src/index.ts:396-396 (registration)Registration of the handler function in the toolImplementations map, which maps tool names to their handler functions for dispatching in CallToolRequestHandler.'get_wheel_of_innovation': getWheelOfInnovation,
- src/index.ts:318-324 (schema)Shared input schema definition for language-enabled patent search tools (LangPatentArgs), extending base schema with optional 'lang' field. Referenced by get_wheel_of_innovation schema.const langPatentInputSchema = { ...basePatentInputSchema, properties: { ...basePatentInputSchema.properties, lang: { type: 'string', description: 'Language setting. Default is "en" (English). Choose "cn" (Chinese) or "en".' } } };
- src/index.ts:213-214 (schema)TypeScript type definitions for input arguments: BasePatentArgs for common fields, LangPatentArgs extending it with optional lang, used in handler signature.type BasePatentArgs = { keywords?: string; ipc?: string; apply_start_time?: string; apply_end_time?: string; public_start_time?: string; public_end_time?: string; authority?: string }; type LangPatentArgs = BasePatentArgs & { lang?: string };