Writes to LinkedInExtraction

Scrape LinkedIn companies search

scrape_linkedin_companies_search

Search and extract LinkedIn Classic companies from explicit filters or a native search URL.

When to use it

Search and extract companies from LinkedIn Classic using readable filters or a native search URL.

Required scopes

linkedin:accesssalestouch:use

Execution

Synchronous MCP tool call

Requirements

Provide exactly one search mode: filters or url.

Use {query: ...} for locations and industries; ambiguous values return candidate ids.

Example

Ask your agent

Extract Paris companies with active LinkedIn job postings.

Tool arguments

{
  "filters": {
    "location": [
      {
        "query": "Paris"
      }
    ],
    "has_job_postings": true
  },
  "limit": 100
}

MCP response envelope

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: A stored company result with preview, paging, and exports.

Parameters

NameTypeDescription

account_id

string

Connected SalesTouch account id, username, email, handle, or account URL.

filters

object

Explicit LinkedIn Classic company-search filters. Human-readable references are resolved internally. Do not combine with url.

url

string

LinkedIn source URL.

limit

integer

Maximum items to extract.

preview_limit

integer

Maximum preview items to return inline. Defaults to 20.

Aliases are shown independently because MCP clients send a flat JSON object. Use one alias from each required group, not every alias.

Common errors

insufficient_scope

Reconnect the MCP and approve the requested LinkedIn permission.

paid_plan_required

Follow the error's action_url: start the free trial, choose a plan after a trial or subscription ended, or update the payment method after a failed payment. details.reason names which one.

trial_payment_method_required

Retry after a minute if checkout was just completed; otherwise add a payment method in SalesTouch billing to activate the trial and LinkedIn MCP access.