ClearCompany HRMDirect Jobs API.

import requests

def board_base_url(tenant: str) -> str:
    # e.g. "ecisolutions" -> "https://ecisolutions.hrmdirect.com"
    # Always request over https, even if the source link used http://.
    return f"https://{tenant}.hrmdirect.com"

tenant = "ecisolutions"
base_url = board_base_url(tenant)

import xml.etree.ElementTree as ET
from urllib.parse import urlparse, parse_qs

RSS_PATH = "/employment/rss.php?search=true&dept=-1&city=-1&state=-1"

def list_requisitions(base_url: str) -> list[dict]:
    resp = requests.get(base_url + RSS_PATH, timeout=30)
    resp.raise_for_status()
    root = ET.fromstring(resp.content)
    if root.tag.lower() != "rss":
        raise ValueError("Response was not an RSS envelope")

    listings, seen = [], set()
    for item in root.findall("./channel/item"):
        link = (item.findtext("link") or "").strip()
        req = parse_qs(urlparse(link).query).get("req", [""])[0]
        if not req.isdigit() or req in seen:
            continue  # skip malformed links and duplicate reqs
        seen.add(req)
        listings.append({
            "external_id": req,
            "listing_url": f"{base_url}/employment/view.php?req={req}",
            "title": (item.findtext("title") or "").strip(),
            "posted_at": item.findtext("pubDate"),
        })
    return listings

import time

def fetch_detail_html(base_url: str, req: str) -> str | None:
    url = f"{base_url}/employment/view.php?req={req}"
    resp = requests.get(url, timeout=30)
    if resp.status_code == 404:
        return None  # requisition removed
    if resp.status_code in (403, 429):
        raise RuntimeError(f"Rate limited / blocked (HTTP {resp.status_code})")
    resp.raise_for_status()
    time.sleep(0.4)  # pace requests to stay under the board's limits
    return resp.text

from bs4 import BeautifulSoup

def parse_detail(base_url: str, req: str, html: str) -> dict:
    soup = BeautifulSoup(html, "html.parser")
    detail_url = f"{base_url}/employment/view.php?req={req}"

    h2 = soup.select_one("div.reqResult h2") or soup.select_one("h2")
    title = h2.get_text(strip=True) if h2 else None
    if not title and soup.title:
        title = soup.title.get_text(strip=True).split(" - Careers At")[0].strip()

    desc_el = soup.select_one("div.jobDesc")
    description = desc_el.get_text(" ", strip=True) if desc_el else ""

    fields = {}
    for row in soup.select("table.viewFields tr"):
        name = row.select_one("td.viewFieldName")
        value = row.select_one("td.viewFieldValue")
        if name and value:
            fields[name.get_text(strip=True).rstrip(":")] = value.get_text(strip=True)

    apply_el = soup.select_one("a.applyOnline[href], div.applyDiv a[href]")
    apply_url = apply_el["href"] if apply_el else detail_url

    return {
        "external_id": req,
        "listing_url": detail_url,
        "apply_url": apply_url,
        "title": title,
        "description": description,
        "location": fields.get("Location"),
        "department": fields.get("Department"),
    }