---
name: pheme-job-search
description: 한국어 자연어 문장(하고 싶은 업무·관심 직무)으로 pheme(피미)에서 관련 채용공고를 검색한다. 사용자가 한국 채용공고를 찾거나 직무명을 모른 채 "이런 일 하는 자리 있어?"처럼 설명할 때 사용한다. 인증 없음, IP당 분당 30회 제한, 서버 측 호출 전용.
metadata:
  publisher: pheme.my
  homepage: https://pheme.my/
  version: "1.0.0"
---

# pheme 채용공고 검색

## 언제 쓰나
- 사용자가 한국 채용공고를 찾고 싶어 할 때
- 직무명을 모르더라도 "Java로 API 개발하는 백엔드", "브랜드 전략 기획하는 마케팅"처럼 하고 싶은 일을 설명할 때

## 호출 방법
엔드포인트는 하나이고 인증이 없다.

    GET https://pheme.my/api/search/use_content?content={검색 문장}

- `content` (필수): 하고 싶은 업무를 설명하는 **한국어 한 문장**. 키워드 나열보다 "~하는 직무" 형태가 잘 동작한다. URL 인코딩한다.
- 예: `GET https://pheme.my/api/search/use_content?content=Java%EB%A1%9C%20API%EB%A5%BC%20%EA%B0%9C%EB%B0%9C%ED%95%98%EB%8A%94%20%EB%B0%B1%EC%97%94%EB%93%9C%20%EC%A7%81%EB%AC%B4`
- 문장 분석 후 검색하므로 응답에 몇 초 걸릴 수 있다.

## 응답 형식
    {
      "success": true,
      "data": [
        {
          "id": 123,
          "info_id": 456,
          "company_name": "회사명",
          "job_title": "공고 제목",
          "jikmu": "직무",
          "input_text": "공고 요약",
          "process_homepage": "https://example.com/recruit/123",
          "career_end_dt": "2026-11-30T00:00:00.000Z",
          "experience_type_name": "경력",
          "work_type_name": "정규직"
        }
      ]
    }

| 필드 | 의미 |
|---|---|
| `company_name` | 회사명 |
| `job_title` | 공고 제목 |
| `jikmu` | 직무 |
| `input_text` | 공고 요약 |
| `process_homepage` | 기업 채용 페이지 링크. 사용자에게 공고를 안내할 때 이 링크를 쓴다 |
| `career_end_dt` | 마감일(ISO 8601). null이면 "마감일 미정", 오늘 기준 ±1년 밖이면 "상시"로 표시 |
| `experience_type_name` | 신입/경력 |
| `work_type_name` | 고용형태 |

모든 문자열 필드는 null일 수 있다. 결과는 관련도 순이다.

## 오류와 제한
- IP당 분당 30회를 넘으면 `429`와 `{ "message": "요청이 너무 많습니다. 잠시 후 다시 시도해주세요." }` → 잠시 뒤 재시도.
- 그 외 실패는 `success`가 `true`가 아니거나 `error.message`가 담겨 온다.
- 브라우저(CORS) 호출은 허용되지 않는다. 서버 측에서 호출한다.

## 결과 전달 규칙
- 회사명 · 공고 제목 · 직무 · 신입/경력 · 고용형태 · 마감일 순으로 간결하게 정리한다.
- 공고마다 `process_homepage` 링크를 붙인다. 지원은 해당 기업 페이지에서 한다.
- 결과가 비면 문장을 더 구체적으로 바꿔 한 번 더 시도한다.
- 출처는 "pheme(피미) · https://pheme.my"로 표기한다.