💼 JazzHR Jobs API: JazzHR에서 채용 중인 모든 회사 검색

Apify에서 JazzHR API를 위한 Python 및 MCP 빠른 시작 가이드입니다. 한 번의 검색으로 플랫폼의 모든 고용주를 포함하므로, 굳이 먼저 회사 채용 URL을 찾아다닐 필요가 없습니다.

• Actor: JazzHR Jobs API on Apify

• 입력 스키마: 입력 매개변수

• 무료 API 토큰 받기: apify.com

대부분의 JazzHR 도구는 아무것도 하기 전에 회사의 보드 URL을 요구합니다. 이 도구는 그 보드를 이미 전부 알고 있습니다. 플랫폼 전체를 대상으로 지정하면 제목, 고용주, 위치, 고용 형태, 실제 게시 날짜, 지원 링크, 그리고 전체 설명을 markdown, HTML, 일반 텍스트 중 원하는 형태로 반환하는 구조화된 채용 공고 데이터를 제공합니다. 또한 JazzHR에서 채용 중인 모든 회사의 디렉터리도 반환할 수 있는데, 어떤 회사의 보드를 전체로 읽을 가치가 있는지 결정하기 전에 유용하게 쓸 수 있습니다.

텍스트 둘러보기

JazzHR API는 JazzHR이 applytojob.com에서 호스팅하는 공개 채용 게시판을 읽습니다. 모든 입력은 선택 사항입니다. 아무것도 설정하지 않고 실행하면 플랫폼 전반의 샘플을 얻고, keywords, location, employmentType, remoteOnly, postedAfter로 범위를 좁힐 수 있습니다. 키워드는 채용 공고를 열기 전에 공고 URL과 매칭되므로, 필터링하면 실행 범위가 좁아질 뿐만 아니라 비용도 낮아집니다. 각 행에는 title, companyName, locationText, employmentType, datePosted, validThrough, applyUrl, descriptionMarkdown이 담겨 옵니다. outputMode를 companiesOnly로 전환하면 고용주별로 하나의 행과 함께 현재 열려 있는 채용 공고 수를 반환하므로, JazzHR을 사용하는 회사 목록을 만들 수 있습니다. urlsOnly로 전환하면 몇 번의 업스트림 요청만으로 전체 채용 공고 인덱스를 얻을 수 있으며, 이는 현재 등록된 공고를 살펴보는 가장 저렴한 방법입니다. newJobsOnly를 켜면 예약된 실행마다 이전에 보지 못한 채용 공고만 반환합니다.

빠른 시작

전제 조건: Python 3.11 이상, uv, 그리고 apify.com에서 받은 무료 Apify API 토큰.

git clone https://github.com/johnisanerd/Apify-JazzHR-Jobs-API.git
cd Apify-JazzHR-Jobs-API
uv sync
cp .env.example .env          # paste your token into .env
uv run python jazzhr-jobs-api-example.py

각 예제는 별도의 플래그입니다.

uv run python jazzhr-jobs-api-example.py --example jobs        # full job records
uv run python jazzhr-jobs-api-example.py --example companies   # employer directory
uv run python jazzhr-jobs-api-example.py --example urls        # job index, no descriptions
uv run python jazzhr-jobs-api-example.py --example new-jobs    # delta mode
uv run python jazzhr-jobs-api-example.py --example all

모든 예제는 의도적으로 적은 수의 행을 요청합니다. 반환된 행 수만큼 비용을 지불하므로, 먼저 데이터 형태를 확인한 다음 maxItems를 높이세요.

이 API를 사용하는 이유

회사 URL이 필요 없습니다. 다른 도구는 무엇보다 회사 보드를 먼저 제공해야 합니다. 여기서는 입력을 비워 두면 검색이 플랫폼의 모든 고용주를 포함합니다.

다른 곳에서 판매하지 않는 디렉터리. companiesOnly 모드는 JazzHR에서 채용 중인 모든 회사와 채용 중인 공고 수를 반환합니다. JazzHR을 사용하는 회사를 발굴호자는 바로 이 목록입니다.

LLM에 전달할 준비가 된 설명. markdown을 요청하고 HTML을 먼저 제거하지 않고 결과를 곧바로 모델에 넘겨주세요.

공고마다 두 가지 소스. 실제 등록 공고의 약 절반은 구조화된 직업 데이터를 전혀 게시하지 않습니다. 이 공고들은 대신 페이지 마크업에서 읽혀 오므로 절반만 채워진 채로 오는 대신 제목, 회사, 위치, 설명까지 모두 채워져 옵니다. parseStatus 필드가 어떤 종류의 행인지 알려줍니다.

만료된 공고는 건너뛰며 비용이 발생하지 않습니다. 플랫폼 인덱스의 약 5분의 1은 이미 마감된 공고를 가리킵니다. 죽은 링크가 아니라 실제로 수신한 공고에 대해서만 비용이 청구됩니다.

단순 스냅샷이 아니라 피드. 델타 모드는 이미 반환한 공고를 기억하므로, 예약 실행은 새 공고만 제공합니다.

레시피

이 Actor에 대해서는 아직 스토어 예제 페이지가 게시되지 않았습니다. 위의 스크립트 예제 네 개가 같은 내용을 다룹니다: 필터링된 채용 공고 검색, 고용주 디렉터리, 저렴한 채용 인덱스, 델타 피드.

일정 팁. 입력 내용을 Apify Console에 Task로 저장하고, newJobsOnly를 켠 다음 매일 또는 매주 예약하세요. 이후로는 데이터셋에 마지막 실행 이후 새로 등록된 공고만 포함되므로, 누군가 건드리지 않아도 파이프라인이 항상 최신 상태를 유지합니다.

사용 예시

기본 실행에 해당하는 방식:

{
  "keywords": ["nurse", "registered nurse"],
  "location": "TX",
  "employmentType": "FULL_TIME",
  "postedAfter": "2026-01-01",
  "descriptionFormat": "markdown",
  "maxItems": 10
}

고급형, 스태핑 에이전시를 건너뛰고 모든 설명 형식을 반환하는 원격 전용 검색:

{
  "keywords": ["software engineer"],
  "remoteOnly": true,
  "excludeCompanies": ["someagency"],
  "descriptionFormat": "all",
  "maxConcurrency": 25,
  "maxItems": 100
}

입력 매개변수

모든 매개변수는 선택 사항입니다.

출력 형식

전체 채용 공고 레코드:

{
  "id": "job_20260617184930_ZL9U2ROWTQWMZDDD",
  "jobId": "vMHpWDZa3l",
  "title": "Account Executive",
  "companyName": "Ease Inc",
  "companySlug": "easeinc",
  "companyWebsite": "http://www.ease.io",
  "boardUrl": "https://easeinc.applytojob.com",
  "applyUrl": "https://easeinc.applytojob.com/apply/vMHpWDZa3l/Account-Executive",
  "canonicalUrl": "https://careers.easeinc.com/apply/vMHpWDZa3l/Account-Executive",
  "city": "Irvine",
  "region": "CA",
  "postalCode": "92618",
  "country": "US",
  "locationText": "Irvine, CA, US",
  "isRemote": true,
  "employmentType": "FULL_TIME",
  "experienceLevel": "Mid Level",
  "datePosted": "2026-06-17",
  "validThrough": "2026-09-15",
  "descriptionMarkdown": "Ease is hiring an Account Executive...",
  "parseStatus": "full",
  "scrapedAt": "2026-08-24T18:22:04Z"
}

고용주 디렉터리는 더 적은 항목의 행을 반환합니다:

{
  "companySlug": "10pearls",
  "boardUrl": "https://10pearls.applytojob.com",
  "jobCount": 21,
  "sampleJobTitles": ["AI Solutions Architect", "Associate Account Executive Intern"],
  "scrapedAt": "2026-08-24T18:22:04Z"
}

사용자가 자주 찾는 검색

이건 JazzHR 구제 도구인가요? (스크레이퍼인가요?)

공개 페이지를 스크레이퍼처럼 읽으며, 돌려받는 것은 API입니다: 구조화 JSON, 필터, 안정적인 필드 이름, HTML이 필요하지 않은 한 그대로 두는 구조입니다. 직접 채용 공고를 스크래핑해 보려고 했다면, 파서 관리를 남이 유지해 주는 버전이 바로 이겁니다.

applytojob.com이 무엇인가요?

JazzHR이 고객 채용 페이지를 호스팅하는 도메인입니다. JazzHR을 통해 채용하는 회사는 company.applytojob.com 보드를 받게 되며, 지원 이메일도 이 도메인에서 오기 때문에 어떤 회사에 지원한 다음 이 도메인을 검색하는 사람이 많은 것입니다.

JazzHR을 사용하는 회사는 어떻게 찾나요?

outputMode를 companiesOnly로 설정하세요. 고용주별로 하나의 행을 보드 URL과 채용 공고 수와 함께 받게 됩니다. --example companies 스크립트가 바로 이 작업을 수행합니다.

Python에서 JazzHR API를 어떻게 사용하나요?

이 저장소를 클론하고 uv sync를 실행하고 .env에 Apify 토큰을 넣은 다음 예시를 운행합니다. rows() 헬퍼는 전체 패턴을 보여줍니다: Actor를 호출한 후 데이터셋을 반복하는 것입니다.

일정 실행이나 MCP를 통해 실행할 수 있나요?

둘 다 가능합니다. Apify Console에 입력 내용을 Task로 저장하고, 가능하면 newJobsOnly를 켜고 예약하세요. MCP의 경우 아래 설치 섹션에서 이 Actor를 Claude, Cursor 또는 ChatGPT의 도구로 추가합니다.

Claude Cowork Desktop에 설치

Cowork는 데스크톱 앱의 자동화 모드입니다. JazzHR Jobs API를 도구로 사용하려면 Apify MCP 서버를 커넥터로 추가하세요.

1. Claude 데스크톱 앱을 열고 설정 → 커넥터로 이동합니다(또는 등 설정 → 개발자 → 구성 편집 정보 claude_desktop_config.json을 직접 편집합니다).

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 이 Actor만 채워 둔 Apify MCP 서버를 추가합니다.

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/jazzhr-jobs-api"
      ]
    }
  }
}

3. 앱을 다시 시작합니다. Cowork가 도구를 처음 호출할 때 브라우저에서 OAuth 단계를 완료하거나, 커넥터 설정에 Apify API 토큰을 추가해 OAuth를 건너뛸니다.

4. Cowork 채팅에서 해당 도구가 사용 가능한지 확인하고 JazzHR Jobs API를 실행하도록 요청합니다.

데스크톱 앱을 다운로드하여 무료 체험 시작: https://claude.ai/referral/uIlpa7nPLg 더 많은 도움말: https://docs.apify.com/platform/integrations/claude-desktop

Claude Code에 설치

Claude Code는 명령줄 도구입니다. Actor의 MCP 서버를 한 명령어로 추가합니다.

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/jazzhr-jobs-api"

브라우저 OAuth 대신 토큰을 사용하려면:

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/jazzhr-jobs-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

그런 다음 claude mcp list로 확인하거나 세션 내에서 /mcp를 실행하세요. Claude Code에 JazzHR Jobs API를 호출하라고 요청합니다.

Claude Code를 무료로 사용해 보세요: https://claude.ai/referral/uIlpa7nPLg Claude Code MCP 설명서: https://code.claude.com/docs/en/mcp

Claude(웹사이트)에 설치

claude.ai에서 Apify를 커넥터로 추가한 다음, 이 Actor의 도구만 활성화합니다.

1. 설정 → 커넥터 → 커넥터 찾기 설정하고 Apify MCP 서버를 검색합니다. 설치합니다. 메시지가 나타나면 활성화하거나 업데이트합니다..

2. 연결 시 Apify API 토큰으로 인증하고 johnvc/jazzhr-jobs-api 도구를 활성화합니다.

3. 어떤 채팅에서든, + → 커넥터를 열고 Apify를 켬니다.

4. 또는 사용자 지정 커넥터 추가를 선택하고 전체 MCP URL https://mcp.apify.com/?tools=actors,docs,actor/... 피드 추가를 붙여 넣고, 요청이 나오면 OAuth를 사용합니다.

5. Claude에게 JazzHR Jobs API를 실행하도록 요청하세요.

웹에서 Claude 열기: https://claude.ai

Cursor에 설치

Cursor는 프로젝트 파일 .cursor/mcp.json에서 MCP 서버를 읽습니다.

1. 프로젝트에서 .cursor/mcp.json을 만듭니다.

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/jazzhr-jobs-api"
    }
  }
}

2. 브라우저 OAuth 대신 토큰 인증을 사용하려면 헤더를 추가하세요.

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/jazzhr-jobs-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor → 설정 → MCP를 열고 apify 서버가 연결되어 있는 것(초록색 점)을 확인합니다.

4. Composer 또는 Chat에서 Cursor에 JazzHR Jobs API를 호출하도록 요청하세요.

Cursor가 새로 우신가요? 여기서 받으세요: https://cursor.com/referral?code=XQK0VBLI3NNX

*** — ——

ChatGPT에 설치

ChatGPT는 개발자 모드를 통해 Apify MCP 서버에 연결합니다(ChatGPT Pro, Plus, Business, Enterprise 및 Education 요금제에서 사용 가능합니다).

1. 프로필 아이콘을 클릭한 다음 설정 > 앱으로 이동합니다. 앱 만들기 버튼이 보이지 않으면 고급 설정을 열고 개발자 모드를 활성화합니다.

2. 앱 만들기를 클릭하고 양식을 작성합니다.

   • 이름: Apify

   • MCP 서버 URL: https://mcp.apify.com/?tools=actors,docs,johnvc/jazzhr-jobs-api

   • 인증: OAuth

3. 만들기를 클릭하고 Apify와의 연결을 승인합니다.

4. 대화에서 앱을 사용하려면 채팅에서 **+**를 클릭하고 개발자 모드를 선택한 다음 Apify를 선택합니다.

더 많은 도움말: https://docs.apify.com/platform/integrations/mcp

Apify의 johnvc가 정성을 담아 만들었습니다.

최종 업데이트: 2026.08.24