jd-intel 0.1.1 → 0.2.0

package/README.md

@@ -119,6 +119,24 @@ If `npx jd-intel-mcp install` fails, edit the config directly.
 
 Restart Claude Desktop.
 
+### Updating
+
+`npx -y jd-intel-mcp` auto-updates within ~24 hours via npm's cache. To force an update immediately:
+
+```bash
+npx clear-npx-cache
+```
+
+Then quit and reopen Claude Desktop.
+
+If you installed the library or CLI directly:
+
+```bash
+npm install jd-intel@latest       # force latest
+# or
+npm update jd-intel               # respect semver
+```
+
 ---
 
 ## MCP tools
@@ -177,6 +195,7 @@ No custom parsing per company.
 | Greenhouse | Shipped | Most widely used ATS in tech |
 | Ashby | Shipped | Growing fast with startups |
 | Lever | Shipped | Common at mid-stage companies |
+| SmartRecruiters | Shipped | Enterprise and mid-market |
 | BambooHR | Planned | Mid-market companies |
 | Workday | Planned | Large enterprises |
 
@@ -203,18 +222,18 @@ All filters AND together. Deep dive on patterns and gotchas: [docs/filters.md](d
 
 **Shipped**
 - Library, CLI, and MCP server (three surfaces of one toolkit)
-- Greenhouse, Ashby, Lever adapters
+- Greenhouse, Ashby, Lever, SmartRecruiters adapters
 - Title, topic, location, and date filters
 - Salary extraction from JD text
 - Verified company registry (100+ companies)
 
 **Next**
+- TeamTailor adapter (European startup coverage)
 - Anthropic MCP marketplace submission
-- Setup guide with screenshots (non-technical walkthrough)
-- Remote MCP transport (for Claude.ai Custom Connectors)
 
 **Planned**
-- BambooHR and Workday adapters
+- BambooHR and Workable adapters
+- Workday support (scoped scraper — large enterprise universe)
 - Temporal tracking (when roles open, close, reopen)
 - Change detection
 - Resume-aware fit scoring

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jd-intel",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Fetch and normalize job descriptions across every major ATS (Greenhouse, Lever, Ashby) — for your AI assistant, no copy-paste.",
   "type": "module",
   "main": "src/index.js",

package/registry/smartrecruiters.json

@@ -0,0 +1,13 @@
+[
+  {"slug": "Visa",           "name": "Visa",            "sector": "payments"},
+  {"slug": "Wise",           "name": "Wise",            "sector": "fintech"},
+  {"slug": "Wabtec",         "name": "Wabtec",          "sector": "rail / industrial"},
+  {"slug": "Sutherland",     "name": "Sutherland",      "sector": "bpo / cx"},
+  {"slug": "AveryDennison",  "name": "Avery Dennison",  "sector": "materials"},
+  {"slug": "PublicStorage",  "name": "Public Storage",  "sector": "real estate"},
+  {"slug": "Sportradar",     "name": "Sportradar",      "sector": "sports data"},
+  {"slug": "Entain",         "name": "Entain",          "sector": "gaming"},
+  {"slug": "Picnic",         "name": "Picnic",          "sector": "grocery delivery"},
+  {"slug": "Hootsuite",      "name": "Hootsuite",       "sector": "social media management"},
+  {"slug": "BusinessWire",   "name": "Business Wire",   "sector": "pr / newswire"}
+]

package/src/adapters/index.js

@@ -1,11 +1,13 @@
 export { fetchGreenhouse, hasGreenhouse } from './greenhouse.js';
 export { fetchLever, hasLever } from './lever.js';
 export { fetchAshby, hasAshby } from './ashby.js';
+export { fetchSmartrecruiters, hasSmartrecruiters } from './smartrecruiters.js';
 
 export const ADAPTERS = {
   greenhouse: { fetch: (...args) => import('./greenhouse.js').then(m => m.fetchGreenhouse(...args)), has: (...args) => import('./greenhouse.js').then(m => m.hasGreenhouse(...args)) },
   lever: { fetch: (...args) => import('./lever.js').then(m => m.fetchLever(...args)), has: (...args) => import('./lever.js').then(m => m.hasLever(...args)) },
   ashby: { fetch: (...args) => import('./ashby.js').then(m => m.fetchAshby(...args)), has: (...args) => import('./ashby.js').then(m => m.hasAshby(...args)) },
+  smartrecruiters: { fetch: (...args) => import('./smartrecruiters.js').then(m => m.fetchSmartrecruiters(...args)), has: (...args) => import('./smartrecruiters.js').then(m => m.hasSmartrecruiters(...args)) },
 };
 
 export const ATS_NAMES = Object.keys(ADAPTERS);

package/src/adapters/smartrecruiters.js

@@ -0,0 +1,108 @@
+import { normalize, stripHtml } from '../normalizer.js';
+
+const BASE_URL = 'https://api.smartrecruiters.com/v1/companies';
+const PAGE_SIZE = 100;
+
+/**
+ * Fetch all postings from a SmartRecruiters company.
+ * Public API, no auth required.
+ * Docs: https://developers.smartrecruiters.com/reference/postingsget-1
+ *
+ * Two-step flow (unavoidable N+1):
+ *   - The postings LIST endpoint omits the job description entirely.
+ *   - jd-intel's contract is "full JD text", so we must fetch each
+ *     posting's DETAIL endpoint to get jobAd.sections.
+ * Large enterprise tenants with hundreds of openings will therefore be
+ * slow against SmartRecruiters specifically. This is the API's shape,
+ * not a bug here.
+ *
+ * @param {string} slug - SmartRecruiters company identifier (e.g., 'Visa')
+ * @returns {Promise<Array>} Normalized job objects
+ */
+export async function fetchSmartrecruiters(slug) {
+  // 1. Page through the postings list.
+  const postings = [];
+  let offset = 0;
+
+  while (true) {
+    const listUrl = `${BASE_URL}/${slug}/postings?limit=${PAGE_SIZE}&offset=${offset}`;
+    const resp = await fetch(listUrl);
+
+    if (!resp.ok) {
+      if (resp.status === 404) return []; // Company not found
+      throw new Error(`SmartRecruiters API error for ${slug}: ${resp.status}`);
+    }
+
+    const data = await resp.json();
+    const content = data.content || [];
+    postings.push(...content);
+
+    offset += PAGE_SIZE;
+    if (content.length === 0 || offset >= (data.totalFound || 0)) break;
+  }
+
+  // 2. Fetch detail per posting for the description.
+  const jobs = await Promise.all(postings.map(async (p) => {
+    let sections = {};
+    let postingUrl = '';
+
+    try {
+      const detailResp = await fetch(`${BASE_URL}/${slug}/postings/${p.id}`);
+      if (detailResp.ok) {
+        const detail = await detailResp.json();
+        sections = detail.jobAd?.sections || {};
+        postingUrl = detail.postingUrl || detail.applyUrl || '';
+      }
+    } catch {
+      // Detail fetch failed: fall back to list-only fields (no description).
+    }
+
+    const description = [
+      sections.jobDescription?.text,
+      sections.qualifications?.text,
+      sections.additionalInformation?.text,
+    ].filter(Boolean).join('\n\n');
+
+    const loc = p.location || {};
+    const place = loc.fullLocation
+      || [loc.city, loc.region, loc.country].filter(Boolean).join(', ');
+    let location = place;
+    if (loc.remote) location = `Remote - ${place}`.replace(/ - $/, ' ');
+    else if (loc.hybrid) location = `Hybrid - ${place}`.replace(/ - $/, ' ');
+
+    return normalize({
+      companySlug: slug,
+      company: p.company?.name || slug,
+      title: p.name || '',
+      department: p.department?.label || p.function?.label || '',
+      location,
+      description: stripHtml(description),
+      url: postingUrl,
+      postedAt: p.releasedDate || null,
+      salary: null, // SmartRecruiters has no structured salary; normalizer parses text
+      metadata: {
+        smartRecruitersId: p.id,
+        refNumber: p.refNumber || '',
+        function: p.function?.label || '',
+        experienceLevel: p.experienceLevel?.label || '',
+        typeOfEmployment: p.typeOfEmployment?.label || '',
+      },
+    }, 'smartrecruiters');
+  }));
+
+  return jobs;
+}
+
+/**
+ * Check if a company exists on SmartRecruiters.
+ * (HEAD isn't reliably supported on the postings endpoint, so use a
+ * minimal GET.)
+ */
+export async function hasSmartrecruiters(slug) {
+  try {
+    const resp = await fetch(`${BASE_URL}/${slug}/postings?limit=1`);
+    return resp.ok;
+  } catch {
+    return false;
+  }
+}