@mambalabsdev/mcp-job-board-keyword-signal-scanner 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mamba Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+# Job Board Keyword Signal Scanner MCP Server
+
+An MCP server that scans a company's job board for the roles you care about. It wraps the Mamba Labs Job Board Keyword Signal Scanner actor on Apify and returns a Clay-ready flat JSON row to any MCP client.
+
+## What it does
+
+Give it a company domain and a set of role categories, and it scans Greenhouse, Lever, Ashby, Workday, and Rippling for matching open roles. Pick from GTM, Engineering, Finance, Operations, Executive, or pass your own custom keywords. You get back a flat row of matched role counts and titles per category, ready for Clay, a CRM, or an AI agent workflow. All of the scanning runs on Apify. This package is a thin client that calls the actor and hands back the result.
+
+## Quick start
+
+You need Node.js 18 or newer and an Apify account with an API token.
+
+Add this to your Claude Desktop config:
+
+```json
+{
+  "mcpServers": {
+    "mamba-job-board-scanner": {
+      "command": "npx",
+      "args": ["-y", "@mambalabsdev/mcp-job-board-keyword-signal-scanner"],
+      "env": {
+        "APIFY_TOKEN": "your-apify-token"
+      }
+    }
+  }
+}
+```
+
+Get your token at https://console.apify.com/account/integrations, paste it in, and restart Claude Desktop. The `scan_job_board_keywords` tool will be available.
+
+## Prerequisites
+
+- Node.js 18 or newer
+- An Apify account with an API token
+
+## Example prompts
+
+- "Is stripe.com hiring engineers? Scan their job board for Engineering roles."
+- "Check openai.com for GTM and Executive openings."
+- "Scan figma.com for Finance and Operations roles."
+- "Look for roles matching 'machine learning' and 'platform' at datadoghq.com using custom keywords."
+
+## Inputs
+
+- `company_domain` (required): the bare company domain, no `https://` and no trailing slash. Example: `stripe.com`
+- `role_categories` (required): one or more of GTM, Engineering, Finance, Operations, Executive, Custom.
+- `custom_keywords` (optional): keyword strings to match when Custom is included.
+- `enable_fallback` (optional): fall back to a pre-indexed job database when the live ATS cascade finds nothing.
+- `previous_roles_detected` and `previous_run_date` (optional): pass a prior run's results to compute newly added or removed roles over time.
+
+## Output
+
+The tool returns the actor's flat JSON row for the scanned company, including matched role counts and titles per requested category, the ATS platform detected, and optional change tracking. See the Apify Store page for the full output schema.
+
+## Full actor documentation
+
+This server is a thin client and holds no scanning logic. For the complete input and output reference, pricing, and run history, see the Apify Store page:
+
+https://apify.com/mambalabs/job-board-keyword-signal-scanner
+
+## Mamba Labs GTM Suite
+
+This is one of six actors in the Mamba Labs GTM Suite, covering hiring signals, tech stack detection, signal aggregation, job board keyword scanning, LinkedIn URL resolution, and ICP scoring. See them all at https://apify.com/mambalabs.
+
+## License
+
+MIT
+
+Built by Mamba Labs. https://apify.com/mambalabs

package/build/index.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const here = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
+const APIFY_TOKEN = process.env.APIFY_TOKEN;
+if (!APIFY_TOKEN) {
+    console.error([
+        "APIFY_TOKEN is not set.",
+        "This server needs an Apify API token to run the Job Board Keyword Signal Scanner actor.",
+        "Create a token at https://console.apify.com/account/integrations and pass it as the APIFY_TOKEN environment variable.",
+    ].join("\n"));
+    process.exit(1);
+}
+// The tilde between the org name and the actor name is Apify's required separator.
+const ACTOR_ENDPOINT = "https://api.apify.com/v2/acts/mambalabs~job-board-keyword-signal-scanner/run-sync-get-dataset-items?timeout=300";
+const server = new McpServer({
+    name: "mamba-job-board-keyword-signal-scanner",
+    version: pkg.version,
+});
+server.tool("scan_job_board_keywords", "Scan a company's job board for roles in chosen categories across Greenhouse, Lever, Ashby, Workday, and Rippling. Pick from GTM, Engineering, Finance, Operations, Executive, or supply custom keywords. Returns a flat, Clay-ready JSON row of matched role counts and titles per category.", {
+    company_domain: z
+        .string()
+        .describe("Bare company domain without https:// and without a trailing slash. Example: stripe.com"),
+    role_categories: z
+        .array(z.string())
+        .describe("One or more role categories to scan for. Valid values: GTM, Engineering, Finance, Operations, Executive, Custom. Use Custom together with custom_keywords."),
+    custom_keywords: z
+        .array(z.string())
+        .optional()
+        .describe("Keyword strings to match when Custom is included in role_categories. Required only if Custom is requested."),
+    enable_fallback: z
+        .boolean()
+        .optional()
+        .describe("If true, falls back to a pre-indexed job database when the live ATS cascade finds nothing."),
+    previous_roles_detected: z
+        .string()
+        .optional()
+        .describe("Comma-separated matched role titles from a previous run, used to compute newly added or removed roles."),
+    previous_run_date: z
+        .string()
+        .optional()
+        .describe("ISO date of the previous run, e.g. 2026-03-15. Used for tracking changes over time."),
+}, async ({ company_domain, role_categories, custom_keywords, enable_fallback, previous_roles_detected, previous_run_date, }) => {
+    const input = { company_domain, role_categories };
+    if (custom_keywords !== undefined)
+        input.custom_keywords = custom_keywords;
+    if (enable_fallback !== undefined)
+        input.enable_fallback = enable_fallback;
+    if (previous_roles_detected !== undefined)
+        input.previous_roles_detected = previous_roles_detected;
+    if (previous_run_date !== undefined)
+        input.previous_run_date = previous_run_date;
+    let response;
+    try {
+        response = await fetch(ACTOR_ENDPOINT, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${APIFY_TOKEN}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(input),
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            isError: true,
+            content: [{ type: "text", text: `Could not reach the Apify API: ${message}` }],
+        };
+    }
+    if (!response.ok) {
+        let detail = "";
+        try {
+            const body = (await response.json());
+            if (body?.error?.message)
+                detail = ` ${body.error.message}`;
+        }
+        catch {
+            detail = "";
+        }
+        let message;
+        switch (response.status) {
+            case 401:
+                message = "Invalid Apify token. Check your APIFY_TOKEN environment variable.";
+                break;
+            case 402:
+                message =
+                    "Insufficient Apify credits. Check your account balance at https://console.apify.com/billing";
+                break;
+            case 408:
+                message =
+                    "Actor run timed out after 300 seconds. Try again, or run the actor on Apify directly for longer jobs.";
+                break;
+            default:
+                message = `Apify request failed with status ${response.status}.${detail}`;
+        }
+        return { isError: true, content: [{ type: "text", text: message }] };
+    }
+    const items = await response.json();
+    return {
+        content: [{ type: "text", text: JSON.stringify(items, null, 2) }],
+    };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mambalabsdev/mcp-job-board-keyword-signal-scanner",
+  "version": "1.0.0",
+  "description": "MCP server for Job Board Keyword Signal Scanner. Scans Greenhouse, Lever, Ashby, Workday, and Rippling for roles in any category via Apify. Clay-ready output.",
+  "type": "module",
+  "bin": {
+    "mcp-job-board-keyword-signal-scanner": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x build/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "gtm",
+    "job-board",
+    "hiring",
+    "ats",
+    "apify",
+    "clay",
+    "lead-generation"
+  ],
+  "author": "Mamba Labs <labs@mambamindsetgrowth.com>",
+  "license": "MIT",
+  "homepage": "https://apify.com/mambalabs/job-board-keyword-signal-scanner",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mambalabsdev/mcp-job-board-keyword-signal-scanner"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.6.0"
+  }
+}