init

providers/remotive.mjs

@@ -0,0 +1,42 @@
+// @ts-check
+/** @typedef {import('./_types.js').Provider} Provider */
+
+// Remotive provider — board-wide aggregator feed
+// (https://remotive.com/api/remote-jobs). Returns { jobs: [...] }. The full
+// feed (no ?search=) is fetched so scan.mjs's title_filter can gate on the
+// configured AI/ML titles; the feed's own ?search= is too narrow (a substring
+// match that misses e.g. "ML Engineer").
+//
+// Wire in via a `job_boards:` entry with `provider: remotive`.
+
+const FEED_URL = 'https://remotive.com/api/remote-jobs';
+
+/** @type {Provider} */
+export default {
+  id: 'remotive',
+
+  /**
+   * Fetches and normalizes postings from the Remotive public feed.
+   * @param {{ name?: string }} entry - The job_boards entry being processed.
+   * @param {{ fetchJson: (url: string, opts?: { redirect?: 'error'|'follow'|'manual' }) => Promise<any> }} ctx - HTTP context.
+   * @returns {Promise<Array<{title: string, url: string, company: string, location: string}>>}
+   */
+  async fetch(entry, ctx) {
+    // redirect:'error' prevents SSRF via server-side redirects
+    const json = await ctx.fetchJson(FEED_URL, { redirect: 'error' });
+    if (!json || !Array.isArray(json.jobs)) {
+      throw new Error(`remotive: unexpected API response — expected { jobs: [...] }, got keys: [${json ? Object.keys(json).join(', ') : 'null'}]`);
+    }
+
+    return json.jobs
+      .filter(j => j && typeof j === 'object'
+        && typeof j.title === 'string' && j.title.trim() !== ''
+        && typeof j.url === 'string' && /^https?:\/\//i.test(j.url.trim()))
+      .map(j => ({
+        title: j.title.trim(),
+        url: j.url.trim(),
+        company: typeof j.company_name === 'string' && j.company_name.trim() ? j.company_name.trim() : (entry.name || 'Remotive'),
+        location: typeof j.candidate_required_location === 'string' ? j.candidate_required_location.trim() : '',
+      }));
+  },
+};