job-pro 0.7.2 → 0.7.3

package/dist/moka.js

@@ -0,0 +1,412 @@
+// Generic Moka (北森外 — `app.mokahr.com` 招聘) adapter factory.
+//
+// Moka is a SaaS ATS used by many Chinese tech companies (Megvii, DeepSeek,
+// Galaxy Universal, StepFun, Cambricon, Geely, …). Each tenant publishes a
+// public portal at one of these URL shapes:
+//
+//   https://app.mokahr.com/campus-recruitment/<orgSlug>/<siteId>
+//   https://app.mokahr.com/campus_apply/<orgSlug>/<siteId>
+//   https://app.mokahr.com/social-recruitment/<orgSlug>/<siteId>
+//   https://app.mokahr.com/recommendation-recruitment/<orgSlug>/<siteId>
+//
+// The SSR HTML always embeds an `<input id="init-data" value="<HTML-escaped JSON>">`
+// containing the first page of jobs + an `aesIv` constant. For deeper
+// pagination the SPA POSTs to
+//   /api/outer/ats-apply/website/jobs/v2?orgId=<slug>
+// and receives an AES-CBC encrypted envelope `{data, necromancer}`. We
+// decrypt with key=necromancer (utf8) and iv=aesIv (utf8) to obtain the
+// plain JSON page.
+//
+// This factory hides that machinery. Adapters declare `{ orgSlug, channels }`
+// (one channel per public portal URL) and get the eight canonical verbs.
+import { extractResumeSignals, scoreOverlap, checkResume } from "./tencent.js";
+import { createDecipheriv } from "node:crypto";
+export { checkResume };
+// ---------- shared headers ----------
+const DEFAULT_HEADERS = {
+    "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
+    Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+    "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
+};
+const API_ENDPOINT = "https://app.mokahr.com/api/outer/ats-apply/website/jobs/v2";
+// ---------- shared helpers ----------
+function htmlDecode(s) {
+    return s
+        .replace(/&quot;/g, '"')
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&#x27;/g, "'")
+        .replace(/&#39;/g, "'");
+}
+function parseInitData(html) {
+    const m = html.match(/<input[^>]*id="init-data"[^>]*value="([^"]+)"/);
+    if (!m)
+        return null;
+    try {
+        return JSON.parse(htmlDecode(m[1]));
+    }
+    catch {
+        return null;
+    }
+}
+async function fetchPortalHtml(url) {
+    // Moka does a locale-cookie redirect dance: first request returns 302 +
+    // Set-Cookie; we capture them, then re-issue.
+    let response;
+    try {
+        response = await fetch(url, { method: "GET", headers: DEFAULT_HEADERS, redirect: "manual" });
+    }
+    catch (err) {
+        return { ok: false, message: `network error: ${err instanceof Error ? err.message : err}` };
+    }
+    const cookies = [];
+    const headersAny = response.headers;
+    if (typeof headersAny.getSetCookie === "function") {
+        for (const v of headersAny.getSetCookie.call(response.headers) ?? []) {
+            const c = v.split(";")[0];
+            if (c)
+                cookies.push(c);
+        }
+    }
+    if (cookies.length === 0) {
+        const raw = response.headers.get("set-cookie");
+        if (raw)
+            cookies.push(...raw.split(/,(?=[^;]+=)/).map((c) => c.split(";")[0].trim()));
+    }
+    const cookieHeader = cookies.join("; ");
+    let r2;
+    try {
+        r2 = await fetch(url, {
+            method: "GET",
+            headers: { ...DEFAULT_HEADERS, Cookie: cookieHeader },
+            redirect: "follow",
+        });
+    }
+    catch (err) {
+        return { ok: false, message: `network error: ${err instanceof Error ? err.message : err}` };
+    }
+    if (!r2.ok)
+        return { ok: false, message: `HTTP ${r2.status}` };
+    const html = await r2.text();
+    return { ok: true, html, cookieHeader, message: "ok" };
+}
+function decryptMokaEnvelope(envelope, aesIv) {
+    if (!envelope.data || !envelope.necromancer)
+        return null;
+    try {
+        const key = Buffer.from(envelope.necromancer, "utf8");
+        const iv = Buffer.from(aesIv, "utf8");
+        const decipher = createDecipheriv("aes-128-cbc", key, iv);
+        const plain = Buffer.concat([
+            decipher.update(Buffer.from(envelope.data, "base64")),
+            decipher.final(),
+        ]);
+        return JSON.parse(plain.toString("utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+async function fetchEncryptedPage(orgSlug, siteId, pageNum, pageSize, aesIv, cookieHeader, portalUrl) {
+    const url = `${API_ENDPOINT}?orgId=${encodeURIComponent(orgSlug)}`;
+    const body = {
+        orgId: orgSlug,
+        siteId: String(siteId),
+        pageNum,
+        pageSize,
+        needStat: true,
+    };
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers: {
+                ...DEFAULT_HEADERS,
+                Accept: "application/json,*/*",
+                "Content-Type": "application/json",
+                Origin: "https://app.mokahr.com",
+                Referer: portalUrl,
+                Cookie: cookieHeader,
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    catch (err) {
+        return { ok: false, message: `network error: ${err instanceof Error ? err.message : err}` };
+    }
+    if (!response.ok)
+        return { ok: false, message: `HTTP ${response.status}` };
+    let envelope;
+    try {
+        envelope = await response.json();
+    }
+    catch {
+        return { ok: false, message: "bad JSON from upstream" };
+    }
+    const decoded = decryptMokaEnvelope(envelope, aesIv);
+    if (!decoded || decoded.code !== 0 || !decoded.data) {
+        return { ok: false, message: decoded?.msg || envelope?.msg || "decrypt or upstream error" };
+    }
+    return {
+        ok: true,
+        jobs: decoded.data.jobs ?? [],
+        total: decoded.data.jobStats?.total ?? 0,
+        message: "ok",
+    };
+}
+function buildCityMap(groups) {
+    const out = {};
+    if (!groups)
+        return out;
+    for (const g of groups) {
+        if (typeof g.cityId === "number" && g.label)
+            out[g.cityId] = g.label;
+    }
+    return out;
+}
+function workCitiesFor(job, cityMap) {
+    const cities = (job.locations ?? [])
+        .map((l) => {
+        if (typeof l.cityId === "number" && cityMap[l.cityId])
+            return cityMap[l.cityId];
+        return l.country || "";
+    })
+        .filter((s) => s.length > 0);
+    const uniq = [];
+    for (const c of cities)
+        if (!uniq.includes(c))
+            uniq.push(c);
+    return uniq.join(" / ");
+}
+function commitmentFor(job) {
+    if (typeof job.commitment === "string" && job.commitment.length > 0)
+        return job.commitment;
+    if (job.hireMode === 1)
+        return "全职";
+    if (job.hireMode === 2)
+        return "实习";
+    return "";
+}
+function matchesKeyword(job, kw) {
+    if (!kw)
+        return true;
+    const lc = kw.toLowerCase();
+    return ((job.title ?? "").toLowerCase().includes(lc) ||
+        (job.zhineng?.name ?? "").toLowerCase().includes(lc) ||
+        (job.department?.name ?? "").toLowerCase().includes(lc));
+}
+// ---------- createAdapter ----------
+export function createAdapter(cfg) {
+    const SOURCE = `app.mokahr.com/${cfg.orgSlug}`;
+    const portalUrl = (ch) => `https://app.mokahr.com/${ch.kind}/${cfg.orgSlug}/${ch.siteId}`;
+    function pickChannel(recruitType) {
+        const want = recruitType ?? cfg.defaultRecruitType ?? "social";
+        return cfg.channels.find((c) => c.recruitType === want) ?? cfg.channels[0];
+    }
+    function summarize(job, cityMap, ch) {
+        return {
+            post_id: String(job.id),
+            title: job.title ?? "",
+            project: job.zhineng?.name ?? "",
+            recruit_label: commitmentFor(job),
+            bgs: job.department?.name ?? "",
+            work_cities: workCitiesFor(job, cityMap),
+            apply_url: `${portalUrl(ch)}#/jobs/${encodeURIComponent(job.id)}`,
+        };
+    }
+    async function searchPositions(opts = {}) {
+        const ch = pickChannel(opts.recruitType);
+        const url = portalUrl(ch);
+        const pageSize = opts.pageSize ?? 20;
+        const page = opts.page ?? 1;
+        const keyword = opts.keyword ?? "";
+        const portal = await fetchPortalHtml(url);
+        if (!portal.ok || !portal.html) {
+            return {
+                ok: false,
+                source: SOURCE,
+                message: portal.message,
+                query: { recruitType: ch.recruitType, keyword, page, pageSize },
+                positions: [],
+                total: 0,
+            };
+        }
+        const init = parseInitData(portal.html);
+        if (!init || !init.jobs || !init.jobStats) {
+            return {
+                ok: false,
+                source: SOURCE,
+                message: "Moka init-data missing jobs/jobStats",
+                query: { recruitType: ch.recruitType, keyword, page, pageSize },
+                positions: [],
+                total: 0,
+            };
+        }
+        const cityMap = buildCityMap(init.jobsGroupedByLocation);
+        let jobs = init.jobs;
+        const total = init.jobStats.total ?? jobs.length;
+        if (page > 1 && init.aesIv && portal.cookieHeader) {
+            const more = await fetchEncryptedPage(cfg.orgSlug, ch.siteId, page, pageSize, init.aesIv, portal.cookieHeader, url);
+            if (!more.ok || !more.jobs) {
+                return {
+                    ok: false,
+                    source: SOURCE,
+                    message: `pagination failed: ${more.message}`,
+                    query: { recruitType: ch.recruitType, keyword, page, pageSize },
+                    positions: [],
+                    total,
+                };
+            }
+            jobs = more.jobs;
+        }
+        const filtered = jobs.filter((j) => matchesKeyword(j, keyword));
+        const sliced = filtered.slice(0, pageSize);
+        return {
+            ok: true,
+            source: SOURCE,
+            query: { recruitType: ch.recruitType, keyword, page, pageSize },
+            page,
+            page_size: pageSize,
+            total,
+            positions: sliced.map((j) => summarize(j, cityMap, ch)),
+        };
+    }
+    async function fetchAllPositions(opts = {}) {
+        const ch = pickChannel(opts.recruitType);
+        const url = portalUrl(ch);
+        const pageSize = opts.pageSize ?? 20;
+        const maxPages = Math.max(1, opts.maxPages ?? 50);
+        const keyword = opts.keyword ?? "";
+        const portal = await fetchPortalHtml(url);
+        if (!portal.ok || !portal.html) {
+            return {
+                ok: false,
+                source: SOURCE,
+                message: portal.message,
+                total: 0,
+                fetched: 0,
+                positions: [],
+            };
+        }
+        const init = parseInitData(portal.html);
+        if (!init || !init.jobs || !init.jobStats || !init.aesIv) {
+            return {
+                ok: false,
+                source: SOURCE,
+                message: "Moka init-data missing required fields",
+                total: 0,
+                fetched: 0,
+                positions: [],
+            };
+        }
+        const cityMap = buildCityMap(init.jobsGroupedByLocation);
+        const total = init.jobStats.total ?? 0;
+        const collected = [...init.jobs];
+        let page = 2;
+        while (collected.length < total && page <= maxPages) {
+            const more = await fetchEncryptedPage(cfg.orgSlug, ch.siteId, page, pageSize, init.aesIv, portal.cookieHeader ?? "", url);
+            if (!more.ok || !more.jobs || more.jobs.length === 0)
+                break;
+            collected.push(...more.jobs);
+            page += 1;
+        }
+        const filtered = collected.filter((j) => matchesKeyword(j, keyword));
+        return {
+            ok: true,
+            source: SOURCE,
+            total,
+            fetched: filtered.length,
+            positions: filtered.map((j) => summarize(j, cityMap, ch)),
+        };
+    }
+    async function fetchPositionDetail(postId) {
+        const ch = pickChannel();
+        return {
+            ok: false,
+            source: SOURCE,
+            message: "Moka detail endpoint requires the same encrypted-session flow; not implemented. " +
+                "Use the apply_url deeplink for the full JD.",
+            post_id: postId,
+            apply_url: `${portalUrl(ch)}#/jobs/${encodeURIComponent(postId)}`,
+        };
+    }
+    async function fetchDictionaries() {
+        const ch = pickChannel();
+        const url = portalUrl(ch);
+        const portal = await fetchPortalHtml(url);
+        if (!portal.ok || !portal.html) {
+            return { ok: false, source: SOURCE, message: portal.message };
+        }
+        const init = parseInitData(portal.html);
+        if (!init)
+            return { ok: false, source: SOURCE, message: "Moka init-data missing" };
+        return {
+            ok: true,
+            source: SOURCE,
+            locations: init.jobsGroupedByLocation ?? [],
+            moka_orgs: cfg.channels.map((c) => ({
+                slug: cfg.orgSlug,
+                id: c.siteId,
+                url: portalUrl(c),
+                recruitType: c.recruitType,
+            })),
+        };
+    }
+    const NOTICES_MSG = `${cfg.label}: no public notices endpoint on Moka tenant`;
+    async function listNotices() {
+        return { ok: false, source: SOURCE, message: NOTICES_MSG, notices: [] };
+    }
+    async function getNotice(noticeId) {
+        return { ok: false, source: SOURCE, message: NOTICES_MSG, notice_id: noticeId };
+    }
+    async function findNoticesByQuestion(question, _opts = {}) {
+        return { ok: false, source: SOURCE, question, message: NOTICES_MSG, matches: [] };
+    }
+    async function matchResume(text, opts = {}) {
+        const { terms, cities } = extractResumeSignals(text ?? "");
+        const candidates = Math.max(20, opts.candidates ?? 100);
+        const search = await fetchAllPositions({
+            pageSize: 20,
+            maxPages: Math.ceil(candidates / 15),
+        });
+        if (!search.ok) {
+            return {
+                ok: false,
+                source: SOURCE,
+                extracted_terms: terms,
+                city_preferences: cities,
+                matches: [],
+                message: search.message,
+            };
+        }
+        const topN = Math.max(1, opts.topN ?? 10);
+        const scored = search.positions
+            .map((p) => ({
+            p,
+            score: scoreOverlap(`${p.title} ${p.project} ${p.bgs}`, terms, cities).score,
+        }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, topN)
+            .map((x) => x.p);
+        return {
+            ok: true,
+            source: SOURCE,
+            extracted_terms: terms,
+            city_preferences: cities,
+            matches: scored,
+        };
+    }
+    return {
+        searchPositions,
+        fetchAllPositions,
+        fetchPositionDetail,
+        fetchDictionaries,
+        listNotices,
+        getNotice,
+        findNoticesByQuestion,
+        matchResume,
+        checkResume,
+    };
+}
+export { extractResumeSignals, scoreOverlap };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "job-pro",
-  "version": "0.7.2",
-  "description": "Query Chinese big-tech campus recruiting from your terminal. 50 companies, 43 live: Tencent, ByteDance, Alibaba, Meituan, Xiaohongshu, JD, Kuaishou, Xiaomi, Baidu, NetEase, Didi, Bilibili, PDD, NIO, MiniMax, Huawei, Weibo, miHoYo, Ping An, SenseTime, Trip.com, Unitree, BYD, Li Auto, Moonshot, Zhipu, iQIYI, Megvii, Agibot, DeepSeek, 01.AI, Galaxy Universal, StepFun, Baichuan, XPeng, WeRide, HoYoverse, iFlytek, OPPO, vivo, SF Express, Horizon Robotics, Cambricon. No signup, no token, no server.",
+  "version": "0.7.3",
+  "description": "Query Chinese big-tech campus recruiting from your terminal. 50 companies, 45 live: Tencent, ByteDance, Alibaba, Meituan, Xiaohongshu, JD, Kuaishou, Xiaomi, Baidu, NetEase, Didi, Bilibili, PDD, NIO, MiniMax, Huawei, Weibo, miHoYo, Ping An, SenseTime, Trip.com, Unitree, BYD, Ant Group, Li Auto, Moonshot, Zhipu, iQIYI, Megvii, Agibot, DeepSeek, 01.AI, Galaxy Universal, StepFun, Baichuan, XPeng, WeRide, HoYoverse, iFlytek, OPPO, vivo, SF Express, Horizon Robotics, Cambricon, Geely. No signup, no token, no server.",
   "homepage": "https://job.ha7ch.com",
   "repository": "https://github.com/HA7CH/job-pro",
   "license": "MIT",