mirror of https://github.com/NomaDamas/k-skill.git synced 2026-06-24 02:04:11 +00:00

Jeffrey (Dongkyu) Kim 3109b6684a Keep Daangn jobs detail resilient

Add an HTML metadata fallback because the public jobs detail _data route currently returns an empty response while the redirected public page still exposes read-only title/meta data.

Constraint: PR 237 must remain read-only and avoid proxy/auth additions for public Daangn surfaces
Rejected: Treating the 204 _data response as acceptable | it breaks the documented detail command
Confidence: high
Scope-risk: narrow
Directive: Keep Daangn jobs detail on public HTML/meta fallback unless a stable JSON detail surface is verified
Tested: npm run ci; live daangn_jobs.py search/detail smoke
Not-tested: authenticated or interactive Daangn actions, intentionally out of scope

2026-05-14 00:40:00 +09:00

1.9 KiB

Raw Permalink Blame History

당근알바 검색 가이드 (`daangn-jobs-search`)

당근알바 공개 웹 데이터 표면을 사용해 키워드·지역 기반 알바 공고를 검색하고, 개별 공고 상세를 읽기 전용으로 확인하는 스킬입니다.

사용 시나리오

"당근알바 합정동 카페 알바 찾아봐"
"홍대 근처 주말 알바 검색해줘"
"이 당근알바 공고 상세 요약해줘"

구현 표면

브라우저 자동화, 로그인, 채팅, 지원, 문의 자동화를 사용하지 않습니다.

지역 해석: https://www.daangn.com/kr/api/v1/regions/keyword?keyword=<지역명>
검색: https://www.daangn.com/kr/jobs/?in=<지역명>-<id>&search=<키워드>&_data=routes/kr.jobs._index
상세: <공고 URL> → jobs.daangn.com/job-posts/<id> 공개 HTML의 title/meta/JSON-LD(헬퍼는 legacy _data를 먼저 시도 후 빈 응답이면 HTML 메타로 fallback)

로컬 실행

python3 daangn-jobs-search/scripts/daangn_jobs.py search "카페" --region "합정동" --limit 5
python3 daangn-jobs-search/scripts/daangn_jobs.py detail "https://www.daangn.com/kr/jobs/.../"

지역 필터

지역명은 당근 region API로 내부 id를 해석한 뒤 in=<지역명>-<id> 형태로 검색 URL에 넣습니다.

합정동 → 서울특별시 마포구 합정동, id=231 → in=합정동-231

출력 해석

검색 결과는 title, company, region, address, salary, salaryType, workDays, workTimeStart, workTimeEnd, closed, url을 우선 확인합니다. 상세 조회는 가능하면 jobPost 원문을 사용하고, 공개 _data가 빈 응답이면 HTML title/meta/JSON-LD를 근거로 정리합니다.

제한사항

공개 Remix _data route 이름이나 JSON shape가 바뀌면 실패할 수 있습니다.
마감·삭제·비공개 전환된 공고는 상세 조회가 실패할 수 있습니다.
지원, 채팅, 문의, 개인정보 제출 자동화는 범위 밖입니다.

1.9 KiB Raw Permalink Blame History

당근알바 검색 가이드 (daangn-jobs-search)