get_top_assignees
Identify top companies with the largest patent portfolios in specific technology areas to analyze competitive landscapes and market players.
Instructions
Shows the top companies (assignees) with the largest patent portfolios. Identify largest players and competitive threats. Returns up to the top 10 assignees. Note: Search must contain either keywords or IPC. If both are provided, IPC is prioritized.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | No | Keywords to search within patent title and abstract/summary. Supports AND, OR, NOT logic. Example: "mobile phone AND (screen OR battery)" | |
| ipc | No | Patent IPC classification code. Used to specify a particular technology field. | |
| apply_start_time | No | Patent application start year (yyyy format). Filters by application filing date. | |
| apply_end_time | No | Patent application end year (yyyy format). Filters by application filing date. | |
| public_start_time | No | Patent publication start year (yyyy format). Filters by publication date. | |
| public_end_time | No | Patent publication end year (yyyy format). Filters by publication 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". | |
| lang | Yes | Language setting. Default is "en" (English). Choose "cn" (Chinese) or "en". |
Implementation Reference
- src/index.ts:259-264 (handler)The handler function for the 'get_top_assignees' tool. It constructs search parameters using buildCommonSearchParams, sets a default language of 'en' if not provided, and delegates to the shared callPatsnapApi helper for the 'applicant-ranking' endpoint.
async function getTopAssignees(args: LangPatentArgs): Promise<ServerResult> { const params = buildCommonSearchParams(args); if (!args.lang) { // Add default lang if not provided params.append('lang', 'en'); } return callPatsnapApi('applicant-ranking', params, 'get top assignees'); - src/index.ts:366-370 (registration)Registration of the 'get_top_assignees' tool in the ListToolsRequestHandler response. Specifies the tool name, description, and input schema.
{ name: 'get_top_assignees', description: 'Shows the top companies (assignees) with the largest patent portfolios. Identify largest players and competitive threats. Returns up to the top 10 assignees. Note: Search must contain either keywords or IPC. If both are provided, IPC is prioritized.', inputSchema: langRequiredPatentInputSchema }, - src/index.ts:400-400 (registration)Associates the tool name 'get_top_assignees' with its handler function in the toolImplementations map used for dispatching tool calls.
'get_top_assignees': getTopAssignees, - src/index.ts:326-329 (schema)Schema definition specific to tools requiring the 'lang' parameter, used as inputSchema for 'get_top_assignees'.
const langRequiredPatentInputSchema = { ...langPatentInputSchema, required: ['lang'] }; - src/index.ts:214-214 (schema)TypeScript type definition for the arguments accepted by the get_top_assignees handler.
type LangPatentArgs = BasePatentArgs & { lang?: string };