@mambalabsdev/mcp-linkedin-jobs-feed 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +122 -2
- package/SECURITY.md +31 -0
- package/build/index.js +201 -0
- package/package.json +48 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Mamba Labs
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,123 @@
|
|
|
1
|
-
#
|
|
1
|
+
# LinkedIn Jobs Feed MCP Server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://smithery.ai/servers/mambabuilt/mcp-linkedin-jobs-feed) [](https://glama.ai/mcp/servers/mambalabsdev/mcp-linkedin-jobs-feed) [](https://registry.modelcontextprotocol.io/v0/servers?search=com.mambabuilt/mcp-linkedin-jobs-feed&limit=1) [](https://www.npmjs.com/package/@mambalabsdev/mcp-linkedin-jobs-feed) [](https://www.npmjs.com/package/@mambalabsdev/mcp-linkedin-jobs-feed) [](https://github.com/mambalabsdev/mcp-linkedin-jobs-feed/blob/main/LICENSE) [](https://mcpservers.org/servers/mambalabsdev/mcp-linkedin-jobs-feed)
|
|
4
|
+
|
|
5
|
+
An MCP server for the Mamba Labs LinkedIn Jobs Feed actor on Apify. Give it job searches and locations. It returns one row per job from LinkedIn's public job search, with the employer's own website domain attached.
|
|
6
|
+
|
|
7
|
+
## What's Inside
|
|
8
|
+
|
|
9
|
+
- [What it does](#what-it-does)
|
|
10
|
+
- [Quick start](#quick-start)
|
|
11
|
+
- [Prerequisites](#prerequisites)
|
|
12
|
+
- [Example prompts](#example-prompts)
|
|
13
|
+
- [Tool](#tool)
|
|
14
|
+
- [Inputs](#inputs)
|
|
15
|
+
- [Pricing](#pricing)
|
|
16
|
+
- [Your keys](#your-keys)
|
|
17
|
+
- [Full actor documentation](#full-actor-documentation)
|
|
18
|
+
- [License](#license)
|
|
19
|
+
|
|
20
|
+
## What it does
|
|
21
|
+
|
|
22
|
+
- **Source**: LinkedIn's public guest job search and job posting pages only. No login, no cookie, no profile or company page reads.
|
|
23
|
+
- **Employer domain**: a company name autocomplete, then a web search, once per employer and cached; returned only when the domain clearly matches the company name (`domain_status` `resolved`), otherwise empty and labeled.
|
|
24
|
+
- **Rows**: one `job` row per job with the posting details, and one free `search` row per search and location with `jobs_found` and `jobs_returned`.
|
|
25
|
+
- **Filters and schedules**: posted within, workplace type, experience level, job type, excluded companies, and `only_new` with a `state_key`.
|
|
26
|
+
|
|
27
|
+
All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.
|
|
28
|
+
|
|
29
|
+
## Quick start
|
|
30
|
+
|
|
31
|
+
You need Node.js 18 or newer and an Apify account with an API token.
|
|
32
|
+
|
|
33
|
+
Add this to your Claude Desktop config (`claude_desktop_config.json`), Cursor, or any MCP client:
|
|
34
|
+
|
|
35
|
+
```json
|
|
36
|
+
{
|
|
37
|
+
"mcpServers": {
|
|
38
|
+
"mamba-linkedin-jobs-feed": {
|
|
39
|
+
"command": "npx",
|
|
40
|
+
"args": [
|
|
41
|
+
"-y",
|
|
42
|
+
"@mambalabsdev/mcp-linkedin-jobs-feed"
|
|
43
|
+
],
|
|
44
|
+
"env": {
|
|
45
|
+
"APIFY_TOKEN": "your-apify-token"
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Restart the client. The `search_linkedin_jobs` tool appears.
|
|
53
|
+
|
|
54
|
+
## Prerequisites
|
|
55
|
+
|
|
56
|
+
- Node.js 18 or newer.
|
|
57
|
+
- An Apify API token from [console.apify.com/account/integrations](https://console.apify.com/account/integrations), set as `APIFY_TOKEN`. The server lists its tool without a token; a call needs one.
|
|
58
|
+
|
|
59
|
+
## Example prompts
|
|
60
|
+
|
|
61
|
+
- "Find account executive jobs posted in Germany this week and give me the hiring companies' domains."
|
|
62
|
+
- "Which companies in London posted a head of sales or SDR manager job in the last 24 hours?"
|
|
63
|
+
- "Every morning, list new remote RevOps jobs in the United States with the company domain."
|
|
64
|
+
|
|
65
|
+
## Tool
|
|
66
|
+
|
|
67
|
+
`search_linkedin_jobs`. One tool. Example arguments:
|
|
68
|
+
|
|
69
|
+
```json
|
|
70
|
+
{
|
|
71
|
+
"keywords": [
|
|
72
|
+
"account executive"
|
|
73
|
+
],
|
|
74
|
+
"locations": [
|
|
75
|
+
"Germany"
|
|
76
|
+
],
|
|
77
|
+
"max_jobs_per_search": "5"
|
|
78
|
+
}
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Inputs
|
|
82
|
+
|
|
83
|
+
Every buyer facing input of the actor, unchanged. Omitted inputs take the actor's own defaults. Numbers and booleans are sent as strings.
|
|
84
|
+
|
|
85
|
+
| Input | Type | Description |
|
|
86
|
+
|---|---|---|
|
|
87
|
+
| `keywords` | array | One job search per line, as you would type it in LinkedIn's job search, for example account executive, or sdr manager saas. Up to 50 searches per run (keywords times locations) |
|
|
88
|
+
| `locations` | array | Optional. One location per line, as LinkedIn's job search takes it: a country (Germany), a city (London, England, United Kingdom), or a region (European Union). Each search runs once per location. Empty searches worldwide |
|
|
89
|
+
| `posted_within` | string | Only jobs posted in this window, as LinkedIn dates them |
|
|
90
|
+
| `workplace_types` | array | Optional. Any of: on_site, remote, hybrid |
|
|
91
|
+
| `experience_levels` | array | Optional. Any of: internship, entry, associate, mid_senior, director, executive |
|
|
92
|
+
| `job_types` | array | Optional. Any of: full_time, part_time, contract, temporary, internship, volunteer, other |
|
|
93
|
+
| `max_jobs_per_search` | string | Job rows returned per search, newest first. Default 100, up to 1000 (LinkedIn shows guests about 1,000 results per search) |
|
|
94
|
+
| `exclude_companies` | array | Optional. Drop jobs whose company name contains one of these, ignoring case, for example staffing agencies you do not want |
|
|
95
|
+
| `include_details` | string | true reads each job's public posting page. No extra charge |
|
|
96
|
+
| `find_company_domain` | string | true looks up each employer's own website domain by name with a web search, and returns it only when the domain clearly matches the name. No extra charge |
|
|
97
|
+
| `only_new` | string | true returns only jobs that an earlier run with the same state key did not return. The first run returns every job in the window |
|
|
98
|
+
| `state_key` | string | Names the saved state for only new jobs. Use one key per schedule, for example ae-germany-daily |
|
|
99
|
+
| `reset_state` | string | true forgets the saved state for this state key |
|
|
100
|
+
| `max_charge_usd` | string | Optional. The run stops before it would charge more than this |
|
|
101
|
+
|
|
102
|
+
## Pricing
|
|
103
|
+
|
|
104
|
+
Pay per event on Apify, billed to your Apify account. Prices in USD.
|
|
105
|
+
|
|
106
|
+
| Event | Free plan | Bronze | Silver | Gold |
|
|
107
|
+
|---|---|---|---|---|
|
|
108
|
+
| `job-row`, one job returned, with details and the employer domain | $0.0015 | $0.001425 | $0.00135 | $0.001275 |
|
|
109
|
+
| `apify-actor-start`, per run start | $0.001 | $0.001 | $0.001 | $0.001 |
|
|
110
|
+
|
|
111
|
+
Search rows and the row for a refused input are free. Posting details and the domain lookup carry no extra charge.
|
|
112
|
+
|
|
113
|
+
## Your keys
|
|
114
|
+
|
|
115
|
+
The actor needs no key and no LinkedIn account. It reads public job pages and a public search results page and holds no key of any kind. Mamba Labs pays the platform and proxy costs of the run.
|
|
116
|
+
|
|
117
|
+
## Full actor documentation
|
|
118
|
+
|
|
119
|
+
[apify.com/mambalabs/linkedin-jobs-feed](https://apify.com/mambalabs/linkedin-jobs-feed)
|
|
120
|
+
|
|
121
|
+
## License
|
|
122
|
+
|
|
123
|
+
MIT. See [LICENSE](LICENSE).
|
package/SECURITY.md
ADDED
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# Security Policy
|
|
2
|
+
|
|
3
|
+
## Supported versions
|
|
4
|
+
|
|
5
|
+
The latest published `1.x` release of
|
|
6
|
+
`@mambalabsdev/mcp-linkedin-jobs-feed` receives security updates.
|
|
7
|
+
|
|
8
|
+
| Version | Supported |
|
|
9
|
+
| ------- | ------------------ |
|
|
10
|
+
| 1.x | :white_check_mark: |
|
|
11
|
+
| < 1.0 | :x: |
|
|
12
|
+
|
|
13
|
+
## Reporting a vulnerability
|
|
14
|
+
|
|
15
|
+
Please do not open a public GitHub issue for security reports.
|
|
16
|
+
|
|
17
|
+
Email security reports to **labs@mambamindsetgrowth.com** with:
|
|
18
|
+
|
|
19
|
+
- a description of the issue and its impact,
|
|
20
|
+
- steps to reproduce, and
|
|
21
|
+
- any relevant logs or proof of concept.
|
|
22
|
+
|
|
23
|
+
We aim to acknowledge reports within 3 business days and to provide a remediation
|
|
24
|
+
timeline after triage. Coordinated disclosure is appreciated.
|
|
25
|
+
|
|
26
|
+
## Handling of credentials
|
|
27
|
+
|
|
28
|
+
This server reads an `APIFY_TOKEN` from the environment and uses it only to call
|
|
29
|
+
the Apify API on your behalf. The token is never logged or written to disk by this
|
|
30
|
+
package. Treat your `APIFY_TOKEN` as a secret and rotate it at
|
|
31
|
+
https://console.apify.com/account/integrations if you believe it has been exposed.
|
package/build/index.js
ADDED
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { readFileSync } from "node:fs";
|
|
3
|
+
import { fileURLToPath } from "node:url";
|
|
4
|
+
import { dirname, join } from "node:path";
|
|
5
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
6
|
+
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
7
|
+
import { z } from "zod";
|
|
8
|
+
const here = dirname(fileURLToPath(import.meta.url));
|
|
9
|
+
const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
|
|
10
|
+
// Distinctive UA so Apify run meta.userAgent marks MCP-originated runs.
|
|
11
|
+
const USER_AGENT = `mambalabs-mcp ${pkg.name}@${pkg.version}`;
|
|
12
|
+
// Drop undefined values so optional inputs are not sent to the actor.
|
|
13
|
+
function compact(obj) {
|
|
14
|
+
const out = {};
|
|
15
|
+
for (const [k, v] of Object.entries(obj)) {
|
|
16
|
+
if (v !== undefined)
|
|
17
|
+
out[k] = v;
|
|
18
|
+
}
|
|
19
|
+
return out;
|
|
20
|
+
}
|
|
21
|
+
// How long the actor run itself is allowed to take, in seconds. One value for
|
|
22
|
+
// every Mamba Labs wrapper, set 2026-10-05.
|
|
23
|
+
const ACTOR_RUN_TIMEOUT_SECS = 1800;
|
|
24
|
+
// How long this wrapper waits for that run, in milliseconds. The actor's own
|
|
25
|
+
// timeout plus two minutes, so the run's own TIMED-OUT status is what the
|
|
26
|
+
// caller sees rather than the wrapper giving up first and reporting nothing.
|
|
27
|
+
const WRAPPER_WAIT_MS = (ACTOR_RUN_TIMEOUT_SECS + 120) * 1000;
|
|
28
|
+
const POLL_INTERVAL_MS = 3000;
|
|
29
|
+
const TERMINAL = new Set(["SUCCEEDED", "FAILED", "TIMED-OUT", "ABORTED", "ABORTING"]);
|
|
30
|
+
const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
|
|
31
|
+
// Shared caller. actorPath is the actor's immutable Apify actor ID (a stable key
|
|
32
|
+
// that survives Store renames). The /v2/acts/{id} endpoint accepts it directly,
|
|
33
|
+
// so a Store rename never breaks these calls.
|
|
34
|
+
//
|
|
35
|
+
// START AND POLL, NOT RUN-SYNC. Apify's synchronous endpoints carry a platform
|
|
36
|
+
// ceiling of 300 seconds on the HTTP wait itself and answer 408 past it whatever
|
|
37
|
+
// the timeout parameter says, so a long run reads as a timeout even though the
|
|
38
|
+
// actor goes on to finish. Starting the run, polling it to a terminal status and
|
|
39
|
+
// then reading the dataset is the only way to wait as long as the actor needs.
|
|
40
|
+
//
|
|
41
|
+
// The token is read here rather than at module load, so the tool registers
|
|
42
|
+
// unconditionally and a server started without APIFY_TOKEN still advertises its
|
|
43
|
+
// capabilities instead of reporting none.
|
|
44
|
+
async function runActor(actorPath, actorLabel, input) {
|
|
45
|
+
const APIFY_TOKEN = process.env.APIFY_TOKEN;
|
|
46
|
+
if (!APIFY_TOKEN) {
|
|
47
|
+
return { isError: true, content: [{ type: "text", text: "APIFY_TOKEN is not set. Create a token at https://console.apify.com/account/integrations and set it as the APIFY_TOKEN environment variable." }] };
|
|
48
|
+
}
|
|
49
|
+
const headers = {
|
|
50
|
+
Authorization: `Bearer ${APIFY_TOKEN}`,
|
|
51
|
+
"Content-Type": "application/json",
|
|
52
|
+
"User-Agent": USER_AGENT,
|
|
53
|
+
};
|
|
54
|
+
const httpError = async (response) => {
|
|
55
|
+
let detail = "";
|
|
56
|
+
try {
|
|
57
|
+
const body = (await response.json());
|
|
58
|
+
if (body?.error?.message)
|
|
59
|
+
detail = ` ${body.error.message}`;
|
|
60
|
+
}
|
|
61
|
+
catch {
|
|
62
|
+
detail = "";
|
|
63
|
+
}
|
|
64
|
+
switch (response.status) {
|
|
65
|
+
case 400:
|
|
66
|
+
return `The ${actorLabel} run was rejected as invalid input.${detail}`;
|
|
67
|
+
case 401:
|
|
68
|
+
return "Invalid Apify token. Check your APIFY_TOKEN environment variable.";
|
|
69
|
+
case 402:
|
|
70
|
+
return "Insufficient Apify credits. Check your account balance at https://console.apify.com/billing";
|
|
71
|
+
default:
|
|
72
|
+
return `Apify request to ${actorLabel} failed with status ${response.status}.${detail}`;
|
|
73
|
+
}
|
|
74
|
+
};
|
|
75
|
+
// 1. Start the run.
|
|
76
|
+
let started;
|
|
77
|
+
try {
|
|
78
|
+
started = await fetch(`https://api.apify.com/v2/acts/${actorPath}/runs?timeout=${ACTOR_RUN_TIMEOUT_SECS}`, { method: "POST", headers, body: JSON.stringify(input) });
|
|
79
|
+
}
|
|
80
|
+
catch (err) {
|
|
81
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
82
|
+
return { isError: true, content: [{ type: "text", text: `Could not reach the Apify API: ${message}` }] };
|
|
83
|
+
}
|
|
84
|
+
if (!started.ok) {
|
|
85
|
+
return { isError: true, content: [{ type: "text", text: await httpError(started) }] };
|
|
86
|
+
}
|
|
87
|
+
let run;
|
|
88
|
+
try {
|
|
89
|
+
run = (await started.json()).data ?? {};
|
|
90
|
+
}
|
|
91
|
+
catch (err) {
|
|
92
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
93
|
+
return { isError: true, content: [{ type: "text", text: `The ${actorLabel} run start returned a response that could not be parsed: ${message}` }] };
|
|
94
|
+
}
|
|
95
|
+
const runId = run.id;
|
|
96
|
+
if (!runId) {
|
|
97
|
+
return { isError: true, content: [{ type: "text", text: `The ${actorLabel} run start returned no run id, so there is nothing to wait for.` }] };
|
|
98
|
+
}
|
|
99
|
+
// 2. Poll to a terminal status.
|
|
100
|
+
const deadline = Date.now() + WRAPPER_WAIT_MS;
|
|
101
|
+
let status = run.status ?? "READY";
|
|
102
|
+
let datasetId = run.defaultDatasetId;
|
|
103
|
+
while (!TERMINAL.has(status)) {
|
|
104
|
+
if (Date.now() >= deadline) {
|
|
105
|
+
return {
|
|
106
|
+
isError: true,
|
|
107
|
+
content: [{ type: "text", text: `The ${actorLabel} run ${runId} was still ${status} after ${Math.round(WRAPPER_WAIT_MS / 1000)} seconds and this call stopped waiting. The run itself is still on Apify: read it at https://console.apify.com/actors/runs/${runId}` }],
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
await sleep(POLL_INTERVAL_MS);
|
|
111
|
+
let poll;
|
|
112
|
+
try {
|
|
113
|
+
poll = await fetch(`https://api.apify.com/v2/actor-runs/${runId}`, { headers });
|
|
114
|
+
}
|
|
115
|
+
catch (err) {
|
|
116
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
117
|
+
return { isError: true, content: [{ type: "text", text: `Lost contact with the Apify API while waiting for ${actorLabel} run ${runId}: ${message}` }] };
|
|
118
|
+
}
|
|
119
|
+
if (!poll.ok) {
|
|
120
|
+
return { isError: true, content: [{ type: "text", text: await httpError(poll) }] };
|
|
121
|
+
}
|
|
122
|
+
const body = (await poll.json());
|
|
123
|
+
status = body.data?.status ?? status;
|
|
124
|
+
datasetId = body.data?.defaultDatasetId ?? datasetId;
|
|
125
|
+
}
|
|
126
|
+
// 3. A run that did not succeed is a failure the caller must see, never an
|
|
127
|
+
// empty success. Surfacing it here is what keeps a crashed run from reading
|
|
128
|
+
// as "no results found".
|
|
129
|
+
if (status !== "SUCCEEDED") {
|
|
130
|
+
return {
|
|
131
|
+
isError: true,
|
|
132
|
+
content: [{ type: "text", text: `The ${actorLabel} run did not succeed (run ID: ${runId}, status: ${status}).` }],
|
|
133
|
+
};
|
|
134
|
+
}
|
|
135
|
+
if (!datasetId) {
|
|
136
|
+
return { isError: true, content: [{ type: "text", text: `The ${actorLabel} run ${runId} succeeded but reported no dataset, so there is nothing to return.` }] };
|
|
137
|
+
}
|
|
138
|
+
// 4. Read the dataset.
|
|
139
|
+
let ds;
|
|
140
|
+
try {
|
|
141
|
+
ds = await fetch(`https://api.apify.com/v2/datasets/${datasetId}/items?format=json`, { headers });
|
|
142
|
+
}
|
|
143
|
+
catch (err) {
|
|
144
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
145
|
+
return { isError: true, content: [{ type: "text", text: `Could not read the ${actorLabel} dataset: ${message}` }] };
|
|
146
|
+
}
|
|
147
|
+
if (!ds.ok) {
|
|
148
|
+
return { isError: true, content: [{ type: "text", text: await httpError(ds) }] };
|
|
149
|
+
}
|
|
150
|
+
let items;
|
|
151
|
+
try {
|
|
152
|
+
items = await ds.json();
|
|
153
|
+
}
|
|
154
|
+
catch (err) {
|
|
155
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
156
|
+
return { isError: true, content: [{ type: "text", text: `The ${actorLabel} run returned a response that could not be parsed: ${message}` }] };
|
|
157
|
+
}
|
|
158
|
+
if (!Array.isArray(items)) {
|
|
159
|
+
const asObj = items;
|
|
160
|
+
const detail = asObj?.error?.message
|
|
161
|
+
? `${asObj.error.message}`
|
|
162
|
+
: JSON.stringify(items);
|
|
163
|
+
return { isError: true, content: [{ type: "text", text: `The ${actorLabel} run did not return a dataset. ${detail}` }] };
|
|
164
|
+
}
|
|
165
|
+
return { content: [{ type: "text", text: JSON.stringify(items, null, 2) }] };
|
|
166
|
+
}
|
|
167
|
+
const server = new McpServer({
|
|
168
|
+
name: "mamba-linkedin-jobs-feed",
|
|
169
|
+
version: pkg.version,
|
|
170
|
+
});
|
|
171
|
+
// LinkedIn Jobs Feed (immutable actor ID SH6N0d8cz46BhCC8B). Every buyer facing input of the actor
|
|
172
|
+
// is exposed. The actor takes numbers and booleans as strings, so those inputs are strings here too.
|
|
173
|
+
server.registerTool("search_linkedin_jobs", {
|
|
174
|
+
title: "Search LinkedIn jobs with the employer domain",
|
|
175
|
+
description: "Search LinkedIn jobs by keywords and location and return one row per job with the employer's own website domain attached. Reads only LinkedIn's public guest job search and job posting pages, with no login. Each job row carries title, company, company page, location, posting date, job link, and by default the description, seniority level, employment type, job function, industries, and applicant count. The employer domain comes from a public company name autocomplete, then a web search, and is returned only when it clearly matches (domain_status resolved). Filters: posted within 24h, week, or month; workplace type; experience level; job type; excluded companies. only_new with a state_key returns only jobs earlier runs did not return. One free search row per search and location gives the counts. A run that does not succeed is returned as an error with its run ID. Read-only; requires an APIFY_TOKEN; Apify charges per job row returned and once per run start; search rows are free.",
|
|
176
|
+
annotations: {
|
|
177
|
+
title: "Search LinkedIn jobs with the employer domain",
|
|
178
|
+
readOnlyHint: true,
|
|
179
|
+
destructiveHint: false,
|
|
180
|
+
idempotentHint: false,
|
|
181
|
+
openWorldHint: true,
|
|
182
|
+
},
|
|
183
|
+
inputSchema: {
|
|
184
|
+
keywords: z.array(z.string()).optional().describe("One job search per line, as you would type it in LinkedIn's job search, for example account executive, or sdr manager saas. Up to 50 searches per run (keywords times locations)"),
|
|
185
|
+
locations: z.array(z.string()).optional().describe("Optional. One location per line, as LinkedIn's job search takes it: a country (Germany), a city (London, England, United Kingdom), or a region (European Union). Each search runs once per location. Empty searches worldwide"),
|
|
186
|
+
posted_within: z.enum(["24h", "week", "month", "any"]).optional().describe("Only jobs posted in this window, as LinkedIn dates them"),
|
|
187
|
+
workplace_types: z.array(z.string()).optional().describe("Optional. Any of: on_site, remote, hybrid"),
|
|
188
|
+
experience_levels: z.array(z.string()).optional().describe("Optional. Any of: internship, entry, associate, mid_senior, director, executive"),
|
|
189
|
+
job_types: z.array(z.string()).optional().describe("Optional. Any of: full_time, part_time, contract, temporary, internship, volunteer, other"),
|
|
190
|
+
max_jobs_per_search: z.string().optional().describe("Job rows returned per search, newest first. Default 100, up to 1000 (LinkedIn shows guests about 1,000 results per search)"),
|
|
191
|
+
exclude_companies: z.array(z.string()).optional().describe("Optional. Drop jobs whose company name contains one of these, ignoring case, for example staffing agencies you do not want"),
|
|
192
|
+
include_details: z.enum(["true", "false"]).optional().describe("true reads each job's public posting page. No extra charge"),
|
|
193
|
+
find_company_domain: z.enum(["true", "false"]).optional().describe("true looks up each employer's own website domain by name with a web search, and returns it only when the domain clearly matches the name. No extra charge"),
|
|
194
|
+
only_new: z.enum(["false", "true"]).optional().describe("true returns only jobs that an earlier run with the same state key did not return. The first run returns every job in the window"),
|
|
195
|
+
state_key: z.string().optional().describe("Names the saved state for only new jobs. Use one key per schedule, for example ae-germany-daily"),
|
|
196
|
+
reset_state: z.enum(["false", "true"]).optional().describe("true forgets the saved state for this state key"),
|
|
197
|
+
max_charge_usd: z.string().optional().describe("Optional. The run stops before it would charge more than this"),
|
|
198
|
+
},
|
|
199
|
+
}, async (args) => runActor("SH6N0d8cz46BhCC8B", "LinkedIn Jobs Feed", compact(args)));
|
|
200
|
+
const transport = new StdioServerTransport();
|
|
201
|
+
await server.connect(transport);
|
package/package.json
CHANGED
|
@@ -1,6 +1,50 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mambalabsdev/mcp-linkedin-jobs-feed",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "MCP server for LinkedIn Jobs Feed. Search LinkedIn jobs by keyword and location and get one row per job with the employer website domain, description, seniority, and applicants. No login. Runs on Apify. Clay-ready output.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"bin": {
|
|
7
|
+
"mcp-linkedin-jobs-feed": "./build/index.js"
|
|
8
|
+
},
|
|
9
|
+
"files": [
|
|
10
|
+
"build",
|
|
11
|
+
"README.md",
|
|
12
|
+
"LICENSE",
|
|
13
|
+
"SECURITY.md"
|
|
14
|
+
],
|
|
15
|
+
"scripts": {
|
|
16
|
+
"build": "tsc && chmod +x build/index.js",
|
|
17
|
+
"test": "npm run build && node --test test/*.test.js",
|
|
18
|
+
"prepublishOnly": "npm run build"
|
|
19
|
+
},
|
|
20
|
+
"keywords": [
|
|
21
|
+
"mcp",
|
|
22
|
+
"model-context-protocol",
|
|
23
|
+
"linkedin-jobs",
|
|
24
|
+
"jobs",
|
|
25
|
+
"job-search",
|
|
26
|
+
"hiring-signals",
|
|
27
|
+
"company-domain",
|
|
28
|
+
"apify",
|
|
29
|
+
"clay"
|
|
30
|
+
],
|
|
31
|
+
"author": "Mamba Labs <labs@mambamindsetgrowth.com>",
|
|
32
|
+
"license": "MIT",
|
|
33
|
+
"homepage": "https://apify.com/mambalabs/linkedin-jobs-feed",
|
|
34
|
+
"repository": {
|
|
35
|
+
"type": "git",
|
|
36
|
+
"url": "https://github.com/mambalabsdev/mcp-linkedin-jobs-feed"
|
|
37
|
+
},
|
|
38
|
+
"engines": {
|
|
39
|
+
"node": ">=18"
|
|
40
|
+
},
|
|
41
|
+
"dependencies": {
|
|
42
|
+
"@modelcontextprotocol/sdk": "^1.32.0",
|
|
43
|
+
"zod": "^4.4.3"
|
|
44
|
+
},
|
|
45
|
+
"devDependencies": {
|
|
46
|
+
"@types/node": "^26.2.0",
|
|
47
|
+
"typescript": "5.9.3"
|
|
48
|
+
},
|
|
49
|
+
"mcpName": "com.mambabuilt/mcp-linkedin-jobs-feed"
|
|
50
|
+
}
|