@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/boss/detail.js

@@ -1,63 +0,0 @@
-/**
- * BOSS直聘 job detail — fetch full job posting details via browser cookie API.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { requirePage, navigateTo, bossFetch, verbose } from './utils.js';
-cli({
-    site: 'boss',
-    name: 'detail',
-    access: 'read',
-    description: 'BOSS直聘查看职位详情',
-    domain: 'www.zhipin.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    browser: true,
-    args: [
-        { name: 'security-id', positional: true, required: true, help: 'Security ID from search results (securityId field)' },
-    ],
-    columns: [
-        'name', 'salary', 'experience', 'degree', 'city', 'district',
-        'description', 'skills', 'welfare',
-        'boss_name', 'boss_title', 'active_time',
-        'company', 'industry', 'scale', 'stage',
-        'address', 'url',
-    ],
-    func: async (page, kwargs) => {
-        requirePage(page);
-        const securityId = kwargs['security-id'];
-        verbose('Fetching job detail...');
-        // Navigate to zhipin.com first to establish cookie context (referrer + cookies)
-        await navigateTo(page, 'https://www.zhipin.com/web/geek/job');
-        const targetUrl = `https://www.zhipin.com/wapi/zpgeek/job/detail.json?securityId=${encodeURIComponent(securityId)}`;
-        const data = await bossFetch(page, targetUrl);
-        const zpData = data.zpData || {};
-        const jobInfo = zpData.jobInfo || {};
-        const bossInfo = zpData.bossInfo || {};
-        const brandComInfo = zpData.brandComInfo || {};
-        if (!jobInfo.jobName) {
-            throw new Error('该职位信息不存在或已下架');
-        }
-        return [{
-                name: jobInfo.jobName || '',
-                salary: jobInfo.salaryDesc || '',
-                experience: jobInfo.experienceName || '',
-                degree: jobInfo.degreeName || '',
-                city: jobInfo.locationName || '',
-                district: [jobInfo.areaDistrict, jobInfo.businessDistrict].filter(Boolean).join('·'),
-                description: jobInfo.postDescription || '',
-                skills: (jobInfo.showSkills || []).join(', '),
-                welfare: (brandComInfo.labels || []).join(', '),
-                boss_name: bossInfo.name || '',
-                boss_title: bossInfo.title || '',
-                active_time: bossInfo.activeTimeDesc || '',
-                company: brandComInfo.brandName || bossInfo.brandName || '',
-                industry: brandComInfo.industryName || '',
-                scale: brandComInfo.scaleName || '',
-                stage: brandComInfo.stageName || '',
-                address: jobInfo.address || '',
-                url: jobInfo.encryptId
-                    ? 'https://www.zhipin.com/job_detail/' + jobInfo.encryptId + '.html'
-                    : '',
-            }];
-    },
-});

package/clis/boss/exchange.js

@@ -1,46 +0,0 @@
-/**
- * BOSS直聘 exchange — request phone/wechat exchange with a candidate.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { requirePage, navigateToChat, bossFetch, findFriendByUid, verbose } from './utils.js';
-cli({
-    site: 'boss',
-    name: 'exchange',
-    access: 'write',
-    description: 'BOSS直聘交换联系方式（请求手机/微信）',
-    domain: 'www.zhipin.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    browser: true,
-    args: [
-        { name: 'uid', required: true, positional: true, help: 'Encrypted UID of the candidate' },
-        { name: 'type', default: 'phone', choices: ['phone', 'wechat'], help: 'Exchange type: phone or wechat' },
-    ],
-    columns: ['status', 'detail'],
-    func: async (page, kwargs) => {
-        requirePage(page);
-        const exchangeType = kwargs.type || 'phone';
-        verbose(`Requesting ${exchangeType} exchange for ${kwargs.uid}...`);
-        await navigateToChat(page);
-        const friend = await findFriendByUid(page, kwargs.uid, { checkGreetList: true });
-        if (!friend)
-            throw new Error('未找到该候选人');
-        const friendName = friend.name || '候选人';
-        const typeId = exchangeType === 'wechat' ? 2 : 1;
-        const params = new URLSearchParams({
-            type: String(typeId),
-            securityId: friend.securityId || '',
-            uniqueId: String(friend.uid),
-            name: friendName,
-        });
-        await bossFetch(page, 'https://www.zhipin.com/wapi/zpchat/exchange/request', {
-            method: 'POST',
-            body: params.toString(),
-        });
-        const typeLabel = exchangeType === 'wechat' ? '微信' : '手机号';
-        return [{
-                status: '✅ 交换请求已发送',
-                detail: `已向 ${friendName} 发送${typeLabel}交换请求`,
-            }];
-    },
-});

package/clis/boss/greet.js

@@ -1,49 +0,0 @@
-/**
- * BOSS直聘 greet — send greeting to a new candidate (initiate chat).
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { requirePage, navigateToChat, findFriendByUid, clickCandidateInList, typeAndSendMessage, verbose, } from './utils.js';
-cli({
-    site: 'boss',
-    name: 'greet',
-    access: 'write',
-    description: 'BOSS直聘向新候选人发送招呼（开始聊天）',
-    domain: 'www.zhipin.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    browser: true,
-    args: [
-        { name: 'uid', positional: true, required: true, help: 'Encrypted UID of the candidate (from recommend)' },
-        { name: 'security-id', required: true, help: 'Security ID of the candidate' },
-        { name: 'job-id', required: true, help: 'Encrypted job ID' },
-        { name: 'text', default: '', help: 'Custom greeting message (uses default template if empty)' },
-    ],
-    columns: ['status', 'detail'],
-    func: async (page, kwargs) => {
-        requirePage(page);
-        verbose(`Greeting candidate ${kwargs.uid}...`);
-        await navigateToChat(page, 3);
-        // Find candidate in greet list or friend list
-        const friend = await findFriendByUid(page, kwargs.uid, {
-            maxPages: 1,
-            checkGreetList: true,
-        });
-        if (!friend) {
-            throw new Error('未找到该候选人，请确认 uid 是否正确（可从 recommend 命令获取）');
-        }
-        const numericUid = friend.uid;
-        const friendName = friend.name || '候选人';
-        const clicked = await clickCandidateInList(page, numericUid);
-        if (!clicked) {
-            throw new Error('无法在聊天列表中找到该用户，候选人可能不在当前列表中');
-        }
-        await page.wait({ time: 2 });
-        const msgText = kwargs.text || '你好，请问您对这个职位感兴趣吗？';
-        const sent = await typeAndSendMessage(page, msgText);
-        if (!sent) {
-            throw new Error('找不到消息输入框');
-        }
-        await page.wait({ time: 1 });
-        return [{ status: '✅ 招呼已发送', detail: `已向 ${friendName} 发送: ${msgText}` }];
-    },
-});

package/clis/boss/invite.js

@@ -1,64 +0,0 @@
-/**
- * BOSS直聘 invite — send interview invitation to a candidate.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { requirePage, navigateToChat, bossFetch, findFriendByUid, verbose } from './utils.js';
-cli({
-    site: 'boss',
-    name: 'invite',
-    access: 'write',
-    description: 'BOSS直聘发送面试邀请',
-    domain: 'www.zhipin.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    browser: true,
-    args: [
-        { name: 'uid', positional: true, required: true, help: 'Encrypted UID of the candidate' },
-        { name: 'time', required: true, help: 'Interview time (e.g. 2025-04-01 14:00)' },
-        { name: 'address', default: '', help: 'Interview address (uses saved address if empty)' },
-        { name: 'contact', default: '', help: 'Contact person name (uses saved contact if empty)' },
-    ],
-    columns: ['status', 'detail'],
-    func: async (page, kwargs) => {
-        requirePage(page);
-        verbose(`Sending interview invitation to ${kwargs.uid}...`);
-        await navigateToChat(page);
-        const friend = await findFriendByUid(page, kwargs.uid, { checkGreetList: true });
-        if (!friend)
-            throw new Error('未找到该候选人');
-        const friendName = friend.name || '候选人';
-        // Get saved contact info
-        const contactData = await bossFetch(page, 'https://www.zhipin.com/wapi/zpinterview/boss/interview/contactInit', { allowNonZero: true, timeout: 10_000 });
-        const contactName = kwargs.contact || contactData.zpData?.contactName || '';
-        const contactPhone = contactData.zpData?.contactPhone || '';
-        const contactId = contactData.zpData?.contactId || '';
-        // Get saved address
-        const addressData = await bossFetch(page, 'https://www.zhipin.com/wapi/zpinterview/boss/interview/listAddress', { allowNonZero: true, timeout: 10_000 });
-        const savedAddress = addressData.zpData?.list?.[0] || {};
-        const addressText = kwargs.address || savedAddress.cityAddressText || savedAddress.addressText || '';
-        // Parse interview time
-        const interviewTime = new Date(kwargs.time).getTime();
-        if (isNaN(interviewTime)) {
-            throw new Error(`时间格式错误: ${kwargs.time}，请使用格式如 2025-04-01 14:00`);
-        }
-        const params = new URLSearchParams({
-            uid: String(friend.uid),
-            securityId: friend.securityId || '',
-            encryptJobId: friend.encryptJobId || '',
-            interviewTime: String(interviewTime),
-            contactId,
-            contactName,
-            contactPhone,
-            address: addressText,
-            interviewType: '1',
-        });
-        await bossFetch(page, 'https://www.zhipin.com/wapi/zpinterview/boss/interview/invite.json', {
-            method: 'POST',
-            body: params.toString(),
-        });
-        return [{
-                status: '✅ 面试邀请已发送',
-                detail: `已向 ${friendName} 发送面试邀请\n时间: ${kwargs.time}\n地点: ${addressText}\n联系人: ${contactName}`,
-            }];
-    },
-});

package/clis/boss/joblist.js

@@ -1,31 +0,0 @@
-/**
- * BOSS直聘 job list — list my published jobs via boss API.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { requirePage, navigateToChat, bossFetch, verbose } from './utils.js';
-cli({
-    site: 'boss',
-    name: 'joblist',
-    access: 'read',
-    description: 'BOSS直聘查看我发布的职位列表',
-    domain: 'www.zhipin.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    browser: true,
-    args: [],
-    columns: ['job_name', 'salary', 'city', 'status', 'encrypt_job_id'],
-    func: async (page, kwargs) => {
-        requirePage(page);
-        verbose('Fetching job list...');
-        await navigateToChat(page);
-        const data = await bossFetch(page, 'https://www.zhipin.com/wapi/zpjob/job/chatted/jobList');
-        const jobs = data.zpData || [];
-        return jobs.map((j) => ({
-            job_name: j.jobName || '',
-            salary: j.salaryDesc || '',
-            city: j.address || '',
-            status: j.jobOnlineStatus === 1 ? '在线' : '已关闭',
-            encrypt_job_id: j.encryptJobId || '',
-        }));
-    },
-});

package/clis/boss/mark.js

@@ -1,70 +0,0 @@
-/**
- * BOSS直聘 mark — label/mark a candidate.
- *
- * Available labels:
- *   1=新招呼, 2=沟通中, 3=已约面, 4=已获取简历, 5=已交换电话,
- *   6=已交换微信, 7=不合适, 8=牛人发起, 11=收藏
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { requirePage, navigateToChat, bossFetch, findFriendByUid, verbose } from './utils.js';
-import { ArgumentError, EmptyResultError } from '@agentrhq/webcmd/errors';
-const LABEL_MAP = {
-    '新招呼': 1, '沟通中': 2, '已约面': 3, '已获取简历': 4,
-    '已交换电话': 5, '已交换微信': 6, '不合适': 7, '牛人发起': 8, '收藏': 11,
-};
-cli({
-    site: 'boss',
-    name: 'mark',
-    access: 'write',
-    description: 'BOSS直聘给候选人添加标签',
-    domain: 'www.zhipin.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    browser: true,
-    args: [
-        { name: 'uid', positional: true, required: true, help: 'Encrypted UID of the candidate' },
-        { name: 'label', required: true, help: 'Label name (新招呼/沟通中/已约面/已获取简历/已交换电话/已交换微信/不合适/收藏) or label ID' },
-        { name: 'remove', type: 'boolean', default: false, help: 'Remove the label instead of adding' },
-    ],
-    columns: ['status', 'detail'],
-    func: async (page, kwargs) => {
-        requirePage(page);
-        const labelInput = kwargs.label;
-        const remove = kwargs.remove || false;
-        // Resolve label to ID
-        let labelId;
-        if (LABEL_MAP[labelInput]) {
-            labelId = LABEL_MAP[labelInput];
-        }
-        else if (!isNaN(Number(labelInput))) {
-            labelId = Number(labelInput);
-        }
-        else {
-            const entry = Object.entries(LABEL_MAP).find(([k]) => k.includes(labelInput));
-            if (entry) {
-                labelId = entry[1];
-            }
-            else {
-                throw new ArgumentError(`未知标签: ${labelInput}。可用标签: ${Object.keys(LABEL_MAP).join(', ')}`);
-            }
-        }
-        verbose(`${remove ? 'Removing' : 'Adding'} label ${labelId} for ${kwargs.uid}...`);
-        await navigateToChat(page);
-        const friend = await findFriendByUid(page, kwargs.uid, { checkGreetList: true });
-        if (!friend)
-            throw new EmptyResultError('boss candidate search');
-        const friendName = friend.name || '候选人';
-        const action = remove ? 'deleteMark' : 'addMark';
-        const params = new URLSearchParams({
-            friendId: String(friend.uid),
-            friendSource: String(friend.friendSource ?? 0),
-            labelId: String(labelId),
-        });
-        await bossFetch(page, `https://www.zhipin.com/wapi/zprelation/friend/label/${action}?${params.toString()}`);
-        const labelName = Object.entries(LABEL_MAP).find(([, v]) => v === labelId)?.[0] || String(labelId);
-        return [{
-                status: remove ? '✅ 标签已移除' : '✅ 标签已添加',
-                detail: `${friendName}: ${remove ? '移除' : '添加'}标签「${labelName}」`,
-            }];
-    },
-});

package/clis/boss/recommend.js

@@ -1,45 +0,0 @@
-/**
- * BOSS直聘 recommend — view recommended candidates (新招呼/greet sort list).
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { requirePage, navigateToChat, bossFetch, fetchRecommendList, verbose } from './utils.js';
-cli({
-    site: 'boss',
-    name: 'recommend',
-    access: 'read',
-    description: 'BOSS直聘查看推荐候选人（新招呼列表）',
-    domain: 'www.zhipin.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    browser: true,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of results to return' },
-    ],
-    columns: ['name', 'job_name', 'last_time', 'labels', 'encrypt_uid', 'security_id', 'encrypt_job_id'],
-    func: async (page, kwargs) => {
-        requirePage(page);
-        verbose('Fetching recommended candidates...');
-        await navigateToChat(page);
-        // Get label definitions for mapping
-        const labelData = await bossFetch(page, 'https://www.zhipin.com/wapi/zprelation/friend/label/get', {
-            allowNonZero: true,
-        });
-        const labelMap = {};
-        if (labelData.code === 0 && labelData.zpData?.labels) {
-            for (const l of labelData.zpData.labels) {
-                labelMap[l.labelId] = l.label;
-            }
-        }
-        const friends = await fetchRecommendList(page);
-        const limit = kwargs.limit || 20;
-        return friends.slice(0, limit).map((f) => ({
-            name: f.name || '',
-            job_name: f.jobName || '',
-            last_time: f.lastTime || '',
-            labels: (f.relationLabelList || []).map((id) => labelMap[id] || String(id)).join(', '),
-            encrypt_uid: f.encryptUid || '',
-            security_id: f.securityId || '',
-            encrypt_job_id: f.encryptJobId || '',
-        }));
-    },
-});

package/clis/boss/resume.js

@@ -1,150 +0,0 @@
-/**
- * BOSS直聘 resume — view candidate resume/profile via chat page UI scraping (boss side).
- *
- * Flow: navigate to chat page → click on candidate → scrape the right panel info.
- *
- * Right panel HTML structure:
- *  .base-info-single-detial → name, gender, age, experience, degree
- *  .experience-content.time-list → time ranges (icon-base-info-work / icon-base-info-edu)
- *  .experience-content.detail-list → details (company·position / school·major·degree)
- *  .position-content → job being discussed + expectation
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { requirePage, navigateToChat, findFriendByUid, clickCandidateInList } from './utils.js';
-cli({
-    site: 'boss',
-    name: 'resume',
-    access: 'read',
-    description: 'BOSS直聘查看候选人简历（招聘端）',
-    domain: 'www.zhipin.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    browser: true,
-    args: [
-        { name: 'uid', required: true, positional: true, help: 'Encrypted UID of the candidate (from chatlist)' },
-    ],
-    columns: [
-        'name', 'gender', 'age', 'experience', 'degree', 'active_time',
-        'work_history', 'education',
-        'job_chatting', 'expect',
-    ],
-    func: async (page, kwargs) => {
-        requirePage(page);
-        await navigateToChat(page, 3);
-        const friend = await findFriendByUid(page, kwargs.uid, { maxPages: 5 });
-        if (!friend)
-            throw new Error('未找到该候选人，请确认 uid 是否正确');
-        const numericUid = friend.uid;
-        const clicked = await clickCandidateInList(page, numericUid);
-        if (!clicked) {
-            throw new Error('无法在聊天列表中找到该用户，请确认聊天列表中有此人');
-        }
-        await page.wait({ time: 2 });
-        // Scrape the right panel
-        const resumeInfo = await page.evaluate(`
-      (() => {
-        const container = document.querySelector('.base-info-single-container') || document.querySelector('.base-info-content');
-        if (!container) return { error: 'no container found' };
-
-        const nameEl = container.querySelector('.base-name');
-        const name = nameEl ? nameEl.textContent.trim() : '';
-
-        let gender = '';
-        const detailDiv = container.querySelector('.base-info-single-detial');
-        if (detailDiv) {
-          const uses = detailDiv.querySelectorAll('use');
-          for (const u of uses) {
-            const href = u.getAttribute('xlink:href') || u.getAttribute('href') || '';
-            if (href.includes('icon-men')) { gender = '男'; break; }
-            if (href.includes('icon-women')) { gender = '女'; break; }
-          }
-        }
-
-        const activeEl = container.querySelector('.active-time');
-        const activeTime = activeEl ? activeEl.textContent.trim() : '';
-
-        let age = '', experience = '', degree = '';
-        if (detailDiv) {
-          for (const el of detailDiv.children) {
-            if (el.classList.contains('name-contet') || el.classList.contains('high-light-orange') ||
-                el.classList.contains('resume-btn-content') || el.classList.contains('label-remark-content') ||
-                el.classList.contains('base-info-item')) continue;
-            const text = el.textContent.trim();
-            if (!text) continue;
-            if (text.match(/\\d+岁/)) age = text;
-            else if (text.match(/年|经验|应届/)) experience = text;
-            else if (['博士', '硕士', '本科', '大专', '高中', '中专', '中技', '初中'].some(d => text.includes(d))) degree = text;
-          }
-        }
-
-        const workTimes = [], eduTimes = [], workDetails = [], eduDetails = [];
-
-        const timeList = container.querySelector('.experience-content.time-list');
-        if (timeList) {
-          for (const li of timeList.querySelectorAll('li')) {
-            const useEl = li.querySelector('use');
-            const href = useEl ? (useEl.getAttribute('xlink:href') || useEl.getAttribute('href') || '') : '';
-            const timeSpan = li.querySelector('.time');
-            const timeText = timeSpan ? timeSpan.textContent.trim() : li.textContent.trim();
-            if (href.includes('base-info-edu')) eduTimes.push(timeText);
-            else workTimes.push(timeText);
-          }
-        }
-
-        const detailList = container.querySelector('.experience-content.detail-list');
-        if (detailList) {
-          for (const li of detailList.querySelectorAll('li')) {
-            const useEl = li.querySelector('use');
-            const href = useEl ? (useEl.getAttribute('xlink:href') || useEl.getAttribute('href') || '') : '';
-            const valueSpan = li.querySelector('.value');
-            const valueText = valueSpan ? valueSpan.textContent.trim() : li.textContent.trim();
-            if (href.includes('base-info-edu')) eduDetails.push(valueText);
-            else workDetails.push(valueText);
-          }
-        }
-
-        const workHistory = [];
-        for (let i = 0; i < Math.max(workTimes.length, workDetails.length); i++) {
-          const parts = [];
-          if (workTimes[i]) parts.push(workTimes[i]);
-          if (workDetails[i]) parts.push(workDetails[i]);
-          if (parts.length) workHistory.push(parts.join('  '));
-        }
-
-        const education = [];
-        for (let i = 0; i < Math.max(eduTimes.length, eduDetails.length); i++) {
-          const parts = [];
-          if (eduTimes[i]) parts.push(eduTimes[i]);
-          if (eduDetails[i]) parts.push(eduDetails[i]);
-          if (parts.length) education.push(parts.join('  '));
-        }
-
-        const positionContent = container.querySelector('.position-content');
-        let jobChatting = '', expect = '';
-        if (positionContent) {
-          const posNameEl = positionContent.querySelector('.position-name');
-          if (posNameEl) jobChatting = posNameEl.textContent.trim();
-          const expectEl = positionContent.querySelector('.position-item.expect .value');
-          if (expectEl) expect = expectEl.textContent.trim();
-        }
-
-        return { name, gender, age, experience, degree, activeTime, workHistory, education, jobChatting, expect };
-      })()
-    `);
-        if (resumeInfo.error) {
-            throw new Error('无法获取简历面板: ' + resumeInfo.error);
-        }
-        return [{
-                name: resumeInfo.name || friend.name || '',
-                gender: resumeInfo.gender || '',
-                age: resumeInfo.age || '',
-                experience: resumeInfo.experience || '',
-                degree: resumeInfo.degree || '',
-                active_time: resumeInfo.activeTime || '',
-                work_history: (resumeInfo.workHistory || []).join('\\n') || '(未获取到)',
-                education: (resumeInfo.education || []).join('\\n') || '(未获取到)',
-                job_chatting: resumeInfo.jobChatting || '',
-                expect: resumeInfo.expect || '',
-            }];
-    },
-});