nv_search_companies
Search for companies in Sales Navigator using filters like employee size, location, industry, and revenue to identify potential business targets.
Instructions
Allows you to search for companies in Sales Navigator applying various filtering criteria. (nv.searchCompanies action).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| term | No | Optional. Keyword or phrase to search. | |
| limit | No | Optional. Number of search results to return. Defaults to 25, with a maximum value of 1000. | |
| filter | No | Optional. Object that specifies filtering criteria for companies. When multiple filter fields are specified, they are combined using AND logic. |
Implementation Reference
- src/utils/linked-api-tool.ts:36-58 (handler)Base OperationTool class with execute method that implements the core handler logic for tools like nv_search_companies by invoking the corresponding LinkedAPI operation.
export abstract class OperationTool<TParams, TResult> extends LinkedApiTool<TParams, TResult> { public abstract readonly operationName: TOperationName; public override execute({ linkedapi, args, workflowTimeout, progressToken, }: { linkedapi: LinkedApi; args: TParams; workflowTimeout: number; progressToken?: string | number; }): Promise<TMappedResponse<TResult>> { const operation = linkedapi.operations.find( (operation) => operation.operationName === this.operationName, )! as Operation<TParams, TResult>; return executeWithProgress(this.progressCallback, operation, workflowTimeout, { params: args, progressToken, }); } } - src/linked-api-tools.ts:58-58 (registration)Registration of the NvSearchCompaniesTool instance in the LinkedApiTools constructor's tools array.
new NvSearchCompaniesTool(progressCallback), - Zod schema defining the input parameters for nv_search_companies tool.
protected override readonly schema = z.object({ term: z.string().optional(), limit: z.number().min(1).max(1000).optional(), filter: z .object({ locations: z.array(z.string()).optional(), industries: z.array(z.string()).optional(), sizes: z .array( z.enum([ '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+', ]), ) .optional(), annualRevenue: z .object({ min: z.string().optional(), max: z.string().optional(), }) .optional(), }) .optional(), }); - src/tools/nv-search-companies.ts:7-114 (handler)NvSearchCompaniesTool class definition, including name, operationName, zod schema, and MCP tool schema via getTool().
export class NvSearchCompaniesTool extends OperationTool<TNvSearchCompaniesParams, unknown> { public override readonly name = 'nv_search_companies'; public override readonly operationName = OPERATION_NAME.nvSearchCompanies; protected override readonly schema = z.object({ term: z.string().optional(), limit: z.number().min(1).max(1000).optional(), filter: z .object({ locations: z.array(z.string()).optional(), industries: z.array(z.string()).optional(), sizes: z .array( z.enum([ '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+', ]), ) .optional(), annualRevenue: z .object({ min: z.string().optional(), max: z.string().optional(), }) .optional(), }) .optional(), }); public override getTool(): Tool { return { name: this.name, description: 'Allows you to search for companies in Sales Navigator applying various filtering criteria. (nv.searchCompanies action).', inputSchema: { type: 'object', properties: { term: { type: 'string', description: 'Optional. Keyword or phrase to search.', }, limit: { type: 'number', description: 'Optional. Number of search results to return. Defaults to 25, with a maximum value of 1000.', }, filter: { type: 'object', description: 'Optional. Object that specifies filtering criteria for companies. When multiple filter fields are specified, they are combined using AND logic.', properties: { sizes: { type: 'array', description: 'Optional. Array of enums representing employee count ranges. Matches if company size falls within any of the listed ranges.', items: { type: 'string', enum: [ '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+', ], }, }, locations: { type: 'array', description: 'Optional. Array of free-form strings representing locations. Matches if company is headquartered in any of the listed locations.', items: { type: 'string' }, }, industries: { type: 'array', description: 'Optional. Array of enums representing industries. Matches if company works in any of the listed industries. Takes specific values available in the LinkedIn interface.', items: { type: 'string' }, }, annualRevenue: { type: 'object', description: 'Optional. Object representing company annual revenue range in million USD.', properties: { min: { type: 'string', enum: ['0', '0.5', '1', '2.5', '5', '10', '20', '50', '100', '500', '1000'], }, max: { type: 'string', enum: ['0.5', '1', '2.5', '5', '10', '20', '50', '100', '500', '1000', '1000+'], }, }, }, }, }, }, }, }; } } - src/linked-api-tools.ts:14-14 (registration)Import of NvSearchCompaniesTool for registration.
import { NvSearchCompaniesTool } from './tools/nv-search-companies.js';