Writes to LinkedInExtraction

Scrape LinkedIn jobs search

scrape_linkedin_jobs_search

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

When to use it

Search and extract jobs 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 companies, locations, industries, functions, and job titles.

Example

Ask your agent

Extract remote Growth jobs around Paris posted this week.

Tool arguments

{
  "filters": {
    "job_title": [
      {
        "query": "Growth Manager"
      }
    ],
    "location": [
      {
        "query": "Paris"
      }
    ],
    "workplace_type": [
      "REMOTE"
    ],
    "date_posted": "PAST_WEEK"
  },
  "limit": 100
}

MCP response envelope

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

Expected: A stored job 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 job-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.