@nomadamas/k-skill 0.1.0

package/skills/court-payment-order-assistant/instruction.md

@@ -0,0 +1,120 @@
+# Court Payment Order Assistant
+
+## What this skill does
+
+대한민국 법원 전자소송 포털에서 **지급명령(독촉) 신청**을 준비해야 할 때, 사용자가 제공한 채권자·채무자·청구내용·증빙 정보를 정리해 신청서 초안, 누락 질문, 첨부 체크리스트, 브라우저 handoff 절차를 만든다.
+
+이 스킬은 참고용 작성 보조다. 법률 자문, 승소 가능성 판단, 관할 확정, 최종 제출 대행을 하지 않는다.
+
+## When to use
+
+- "떼인 돈 지급명령 신청 준비해줘"
+- "전자소송에서 지급명령 신청서 입력 도와줘"
+- "채무자 정보랑 증빙으로 지급명령 초안 만들어줘"
+- "로그인은 내가 할 테니 입력할 내용 정리해줘"
+
+## Prerequisites
+
+- Node.js 18+
+
+- **실제 브라우저는 필수가 아니다.** 이 스킬의 핵심 산출물(지급명령/독촉 초안, 필요서류 체크리스트, 입력값 handoff)은 실제 브라우저를 띄우지 않고 생성된다. 브라우저는 사용자가 공식 포털에서 직접 로그인·확인·제출하는 수동 단계에서만 쓰이며, 그때 권장 순서는 BrowserOS/runtime CDP → 수동 브라우저다.
+- BrowserOS/runtime CDP 우선 사용: 사용자가 직접 띄운 BrowserOS GUI 세션(`KSKILL_BROWSEROS_CDP_URL`, 기본 `http://127.0.0.1:9100`)에 attach한다. 스킬은 BrowserOS를 launch하거나 headless로 띄우지 않는다.
+- 사용자가 직접 처리할 것: 전자소송 로그인, 공동/금융인증서 또는 간편인증, 보안 프로그램, 전자서명, 인지대/송달료 결제, 최종 제출
+
+## Public access path discovered
+
+Official portal:
+
+```text
+https://ecfs.scourt.go.kr/psp/index.on
+```
+
+Observed public surface:
+
+- 전자소송 포털은 공개 상태에서 로그인/사용자등록, `서류제출`, `민사 서류` 영역을 보여준다.
+- 문서 작성은 로그인 이후 가능하다는 경계가 표시된다.
+- 나홀로소송/도움말 영역에서 지급명령(독촉) 설명 진입점을 확인할 수 있다.
+- `https://ecfs.scourt.go.kr/ecf/index.jsp`는 점검/오류 페이지로 redirect될 수 있어, 현재 안정 진입점은 `/psp/index.on`이다.
+
+## Workflow
+
+### 1. Ask for required facts
+
+Use the package to normalize and validate intake:
+
+```js
+const { buildRequiredQuestions, validateIntake } = require("court-payment-order-assistant")
+
+const validation = validateIntake(input)
+if (!validation.canDraft) {
+  console.log(buildRequiredQuestions(input))
+}
+```
+
+Required information:
+
+| Area | Required facts |
+| --- | --- |
+| 채권자 | 성명/상호, 송달 주소, 연락처(가능하면) |
+| 채무자 | 성명/상호, 송달 가능한 주소, 식별정보(가능하면) |
+| 청구 | 원금, 변제기, 청구원인, 신청취지 |
+| 증빙 | 계약서, 차용증, 송금내역, 세금계산서, 독촉 문자/이메일 등 |
+| 법원 | 사용자가 최종 확인할 관할 법원 |
+
+### 2. Prepare a draft and checklist
+
+```js
+const { buildPaymentOrderDraft } = require("court-payment-order-assistant")
+const draft = buildPaymentOrderDraft(input)
+```
+
+Return:
+
+- parties
+- claim statement
+- cause statement
+- evidence list
+- missing fields
+- warnings
+- review checklist
+- stop-before list
+
+### 3. Browser handoff
+
+```js
+const { buildBrowserHandoff } = require("court-payment-order-assistant")
+console.log(buildBrowserHandoff(input))
+```
+
+Fallback order:
+
+1. BrowserOS/runtime CDP: attach to the user-launched BrowserOS GUI session for official portal inspection and reversible field entry after the user manually logs in.
+2. Manual browser: if BrowserOS CDP is unavailable or authentication, certificate, security module, CAPTCHA, or maintenance blocks automation, hand off exact field values for manual entry.
+
+## Stop rules
+
+- Do not click final submit.
+- Do not perform electronic signature.
+- Do not pay 인지대 or 송달료.
+- Do not bypass login, certificate, security module, CAPTCHA, or maintenance pages.
+- Do not tell the user that filing is legally sufficient or guaranteed.
+
+## Done when
+
+- Required facts were collected or missing questions were returned.
+- A draft/checklist was generated for user review.
+- Official portal entry and login-required boundary were confirmed through BrowserOS/runtime CDP or documented fallback.
+- The browser handoff stops before signature, payment, and final submission.
+
+## Failure modes
+
+- Electronic litigation portal maintenance or redirect.
+- Login, certificate, security module, CAPTCHA, popup, or session timeout.
+- Unknown debtor address or wrong jurisdiction.
+- Missing evidence for claim cause or amount.
+- User asks for legal judgment, guaranteed outcome, or final submission without review.
+
+## Notes
+
+- No proxy, API key, or secret is used.
+- This is not legal advice. For disputed facts, large amounts, limitation-period issues, business debt, or uncertain debtor address, recommend professional review.

package/skills/court-payment-order-assistant/skill.json

@@ -0,0 +1,10 @@
+{
+  "name": "court-payment-order-assistant",
+  "description": "법원 전자소송 지급명령 신청을 위해 채권자·채무자·청구금액·청구원인·증빙 정보를 인터뷰하고, 신청서 초안과 공식 전자소송 브라우저 입력 handoff를 준비한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.",
+  "profiles": [
+    "vault",
+    "browser",
+    "hard-boundary"
+  ],
+  "frontmatter": "name: court-payment-order-assistant\ndescription: 법원 전자소송 지급명령 신청을 위해 채권자·채무자·청구금액·청구원인·증빙 정보를 인터뷰하고, 신청서 초안과 공식 전자소송 브라우저 입력 handoff를 준비한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.\nlicense: MIT\nmetadata:\n  category: legal\n  locale: ko-KR\n  phase: v1"
+}

package/skills/d2b-notice-search/instruction.md

@@ -0,0 +1,117 @@
+# D2B Notice Search
+
+## What this skill does
+
+국방전자조달시스템(D2B, `www.d2b.go.kr`)의 공개 `입찰공고` 검색 화면을 브라우저로 읽어 국방 조달 공고 후보를 조회한다.
+
+- 공고건명 키워드로 검색한다.
+- 공고구분을 정상공고, 긴급공고, 정정공고, 취소공고, 연기공고, 재공고로 좁힌다.
+- 개찰일자 또는 공고일자 기준 기간을 지정한다.
+- G2B공고번호와 발주기관 조건을 함께 사용할 수 있다.
+- 렌더링된 목록/최근 공고 링크의 제목, 공고번호, 업무구분, 게시일을 추출한다.
+
+입찰, 투찰, 서류 제출, 로그인, 공동인증서/보안 프로그램 조작, 결제는 하지 않는다.
+
+## When to use
+
+- "국방전자조달 냉난방기 공고 찾아줘"
+- "D2B 긴급 물품 공고 조회"
+- "국방전자조달시스템에서 G2B공고번호로 찾아줘"
+- "방위사업청 입찰공고 최신 목록 보여줘"
+
+## Prerequisites
+
+- 인터넷 연결
+- Node.js 18+
+- 기본: Aside Browser
+- fallback: 사용자가 띄운 BrowserOS 세션에 CDP로 붙거나(권장), 로컬 브라우저 사용
+
+## Public access path discovered
+
+### Primary source: official D2B rendered search form
+
+Entry point:
+
+```text
+https://www.d2b.go.kr/index.do
+```
+
+Observed public `입찰공고` fields:
+
+| Field | Meaning |
+| --- | --- |
+| `공고건명` | notice title keyword |
+| `공고구분` | 정상공고 `A`, 긴급공고 `B`, 정정공고 `H`, 취소공고 `J`, 연기공고 `K`, 재공고 `D` |
+| `공고/개찰일` | 개찰일자 `1`, 공고일자 `2` |
+| 시작/마지막 날짜 | date range |
+| `G2B공고번호` | G2B notice number |
+| `발주기관` | ordering organization |
+
+Discovery result: the home page renders a public search form and recent bid links without login. Direct probes to `https://www.d2b.go.kr/openapi/sealedBidAnnounceList.json` can return `400 Bad Request` / deceptive request routing HTML, so browser automation is the stable primary route.
+
+No `k-skill-proxy` route is used because the public page does not require an API key. If a separate free API key route is later confirmed, it must be narrow, allowlisted, cache-backed, and documented before proxying.
+
+## Workflow
+
+### 1. Build a search recipe
+
+```js
+const { buildBrowserAutomationInstructions } = require("d2b-notice-search")
+
+const instructions = buildBrowserAutomationInstructions({
+  keyword: "냉난방기",
+  kind: "물품",
+  noticeType: "긴급공고",
+  dateType: "공고일자",
+  dateStart: "2026-07-01",
+  dateEnd: "2026-08-30",
+  organization: "해병"
+})
+```
+
+### 2. Execute with Aside Browser first
+
+1. Open `https://www.d2b.go.kr/index.do`.
+2. Snapshot the `입찰공고` area.
+3. Fill 공고건명, 공고구분, 공고/개찰일, date range, G2B공고번호, and 발주기관 as needed.
+4. Click `검색`.
+5. Snapshot the resulting list or recent notice links and extract visible fields.
+
+### 3. Fallback order
+
+1. Aside Browser against the official rendered page.
+2. A user-launched BrowserOS session over CDP (or a local browser you own) with the same public form interactions.
+3. Direct HTTP best-effort only. Treat `400 Bad Request`, `deceptive request routing`, TouchEn/security, login, CAPTCHA, queue, or maintenance HTML as an explicit blocked state, not as empty results.
+
+## Supported aliases
+
+| Input aliases | Normalized value |
+| --- | --- |
+| `물품`, `goods`, `pdb` | `PDB` |
+| `용역`, `service`, `services`, `psb` | `PSB` |
+| `공사`, `works`, `construction`, `pcb` | `PCB` |
+| `국외`, `foreign`, `peb` | `PEB` |
+| `정상공고`, `normal`, `A` | `A` |
+| `긴급공고`, `urgent`, `B` | `B` |
+| `정정공고`, `H` | `H` |
+| `취소공고`, `J` | `J` |
+| `연기공고`, `K` | `K` |
+| `재공고`, `D` | `D` |
+| `개찰일자`, `open`, `opening`, `1` | `1` |
+| `공고일자`, `posted`, `notice`, `2` | `2` |
+
+## Done when
+
+- The official D2B page was opened through Aside Browser or the documented browser fallback.
+- The visible search form was filled with the requested conditions.
+- Results or an explicit no-results/blocked state were captured from the rendered page.
+- Direct HTTP failures were classified as blocked/security routing when they return 400/security HTML.
+- No login, bidding, signature, payment, or security bypass was attempted.
+
+## Failure modes
+
+- D2B may change Vue/component markup, placeholders, JavaScript action names, or the openapi route.
+- Direct HTTP may return `400 Bad Request`, traffic/security routing HTML, or maintenance pages.
+- Browser automation can be blocked by security software, certificate prompts, CAPTCHA, login walls, or site maintenance.
+- Date ranges wider than 12 months are rejected by this package to keep user queries narrow.
+- Rendered results can differ by current D2B service state; cite the official D2B URL and visible timestamp/context when answering.

package/skills/d2b-notice-search/skill.json

@@ -0,0 +1,10 @@
+{
+  "name": "d2b-notice-search",
+  "description": "국방전자조달시스템(D2B) 공개 입찰공고 검색 화면에서 공고건명·공고구분·공고/개찰일·G2B공고번호·발주기관 조건으로 공고를 조회한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.",
+  "profiles": [
+    "proxy",
+    "browser",
+    "hard-boundary"
+  ],
+  "frontmatter": "name: d2b-notice-search\ndescription: 국방전자조달시스템(D2B) 공개 입찰공고 검색 화면에서 공고건명·공고구분·공고/개찰일·G2B공고번호·발주기관 조건으로 공고를 조회한다. 돌쇠에서는 가능한 가장 가까운 합법적 공식 단계까지 준비한다.\nlicense: MIT\nmetadata:\n  category: procurement\n  locale: ko-KR\n  phase: v1"
+}

package/skills/daangn-cars-search/instruction.md

@@ -0,0 +1,91 @@
+# Daangn Cars Search
+
+## What this skill does
+
+당근중고차 공개 Remix `_data` JSON route를 사용해 차량 목록과 상세 정보를 읽기 전용으로 조회한다.
+
+최종 사용자는 자연어로 요청해도 되고, 필요하면 아래의 Python helper를 직접 실행한다. 외부 패키지나 k-skill-proxy 없이 Python 표준 라이브러리만 사용한다.
+
+## When to use
+
+- "당근중고차 합정동 레이 찾아봐"
+- "당근에서 천만원 이하 중고차 검색"
+- "이 당근 중고차 URL 상세 봐줘"
+
+## When not to use
+
+- 당근 계정 로그인이 필요한 작업
+- 채팅, 찜, 거래 제안, 문의, 지원, 예약, 계약, 구매처럼 상대방 또는 계정에 영향을 주는 작업
+- CAPTCHA/봇 차단/로그인벽 우회가 필요한 작업
+
+## Prerequisites
+
+- 인터넷 연결
+- Python 3.9+
+- 이 저장소 루트에서 실행하거나, 스크립트 경로를 절대경로로 지정
+
+## Data surfaces
+
+- Region resolver: `https://www.daangn.com/kr/api/v1/regions/keyword?keyword=<지역명>`
+- Search `_data`: `/kr/cars/?in=<지역명>-<id>&onlyOnSale=1&_data=routes/kr.cars._index`
+- Detail `_data`: `<car-url>?_data=routes%2Fkr.cars.%24car_post_id`
+
+## Workflow
+
+1. 사용자 요청에서 키워드, 지역명, 가격/거래 유형 같은 필터를 추출한다.
+2. 지역명이 있으면 region resolver로 내부 region id를 찾는다.
+3. 목록 검색은 category별 `_data` route를 호출한다.
+4. 상세 URL이 주어지면 category별 detail route 또는 공개 HTML 메타를 조회한다.
+5. 결과를 짧게 정리하되 source URL과 적용 지역을 보존한다.
+
+## Commands
+
+```bash
+python3 daangn-cars-search/scripts/daangn_cars.py search "레이" --region "합정동" --limit 5
+python3 daangn-cars-search/scripts/daangn_cars.py search --region "합정동" --price-max 10000000 --limit 5
+python3 daangn-cars-search/scripts/daangn_cars.py detail "https://www.daangn.com/kr/cars/.../"
+```
+
+## Output fields
+
+- title, price, price_text, region, status, driveDistance, carData, chatRoomCount, url
+- detail: carPost 원문
+
+## Region handling
+
+지역 필터가 있으면 먼저 당근 지역 검색 API로 내부 지역 id를 해석한다.
+
+```text
+https://www.daangn.com/kr/api/v1/regions/keyword?keyword=합정동
+→ 서울특별시 마포구 합정동, id=231
+→ in=합정동-231
+```
+
+동일한 지명이 여러 지역에 있으면 다음 우선순위로 선택한다.
+
+1. 사용자가 입력한 문자열이 `name`, `name1`, `name2`, `name3` 중 하나와 정확히 맞는 후보
+2. 서울 `depth=3` 동 단위 후보
+3. 첫 번째 후보
+
+응답에는 항상 `effective_region` 또는 실제 적용된 지역명을 포함한다. 사용자의 의도와 다른 지역으로 보이면 결과를 단정하지 말고 후보 확인을 요청한다. IP/쿠키 기본 위치에 의존하지 않는다.
+
+## Safety and scope
+
+- 읽기 전용 검색/상세 조회만 수행한다.
+- 로그인, 채팅, 찜, 거래 제안, 지원, 문의, 예약, 계약, 구매 자동화는 하지 않는다.
+- 공개 웹 표면이 바뀌거나 빈 응답/봇 차단/로그인벽이 나오면 실패 모드로 보고하고 우회하지 않는다.
+- 결과는 실시간 재고/공고 상태와 달라질 수 있으므로 source URL을 함께 제시한다.
+
+## Failure modes
+
+- 당근의 Remix route 이름이나 JSON shape가 변경되면 `_data` 조회가 실패할 수 있다.
+- 지역명이 넓거나 중복되면 다른 행정동이 선택될 수 있다.
+- 검색 결과가 0건이어도 사이트 정책/지역 기본값/필터 조합 때문일 수 있으므로 source URL을 보존한다.
+- 상세 조회는 삭제/종료/비공개 전환된 글에서 실패할 수 있다.
+
+## Done when
+
+- 지역명이 있으면 지역 id를 해석하고 적용했다.
+- 목록 조회 또는 상세 조회를 최소 1회 수행했다.
+- 결과에 source URL과 effective region을 포함했다.
+- 인증/거래성 액션은 수행하지 않았다.

package/skills/daangn-cars-search/scripts/daangn_cars.py

@@ -0,0 +1,72 @@
+#!/usr/bin/env python3
+import argparse, json, re, sys, urllib.parse, urllib.request
+from html import unescape
+
+HEADERS = {"User-Agent":"Mozilla/5.0", "Accept":"application/json,text/html;q=0.9,*/*;q=0.8"}
+
+def fetch_json(url):
+    req = urllib.request.Request(url, headers=HEADERS)
+    with urllib.request.urlopen(req, timeout=25) as r:
+        return json.load(r)
+
+def fetch_text(url):
+    req = urllib.request.Request(url, headers={"User-Agent":"Mozilla/5.0", "Accept":"text/html"})
+    with urllib.request.urlopen(req, timeout=25) as r:
+        return r.read().decode('utf-8', 'ignore')
+
+def won(v):
+    if v in (None, ''): return '-'
+    try: return f"{int(float(v)):,}원"
+    except Exception: return str(v)
+
+def resolve_region(region):
+    if not region: return None
+    url = 'https://www.daangn.com/kr/api/v1/regions/keyword?keyword=' + urllib.parse.quote(region)
+    data = fetch_json(url)
+    locs = data.get('locations') or []
+    if not locs: raise SystemExit(f'지역 후보 없음: {region}')
+    # Exact dong/name match first, then Seoul depth-3, then first candidate.
+    exact = [x for x in locs if region in (x.get('name'), x.get('name1'), x.get('name2'), x.get('name3'))]
+    seoul = [x for x in locs if x.get('name1') == '서울특별시' and x.get('depth') == 3]
+    sel = (exact or seoul or locs)[0]
+    return sel
+
+def region_param(sel):
+    return urllib.parse.quote(f"{sel['name']}-{sel['id']}")
+
+def absolute(href):
+    if not href: return ''
+    if href.startswith('http'): return href
+    return 'https://www.daangn.com' + href
+
+def print_json(obj):
+    print(json.dumps(obj, ensure_ascii=False, indent=2))
+
+
+def cmd_search(args):
+    sel=resolve_region(args.region) if args.region else None
+    params=[]
+    if sel: params.append(('in', f"{sel['name']}-{sel['id']}"))
+    if args.only_on_sale: params.append(('onlyOnSale','1'))
+    if args.price_max: params.append(('priceMax', str(args.price_max)))
+    if args.price_min: params.append(('priceMin', str(args.price_min)))
+    params.append(('_data','routes/kr.cars._index'))
+    url='https://www.daangn.com/kr/cars/?'+urllib.parse.urlencode(params)
+    data=fetch_json(url); arr=((data.get('carAllPage') or {}).get('carPosts') or [])
+    if args.keyword:
+        arr=[a for a in arr if args.keyword.lower() in (a.get('title') or '').lower()]
+    arr=arr[:args.limit]
+    items=[{'title':a.get('title'),'price':a.get('price'),'price_text':won(a.get('price')),'region':(a.get('region') or {}).get('name'),
+            'status':a.get('status'),'driveDistance':a.get('driveDistance'),'carData':a.get('carData'),
+            'chatRoomCount':a.get('chatRoomCount'),'url':absolute(a.get('href'))} for a in arr]
+    print_json({'source':url,'effective_region':data.get('searchRegion') or sel,'count':len(items),'items':items})
+
+def cmd_detail(args):
+    u=args.url.rstrip('/')+'/?_data=routes%2Fkr.cars.%24car_post_id'
+    data=fetch_json(u); print_json({'source':u,'carPost':data.get('carPost') or data})
+
+p=argparse.ArgumentParser(description='Daangn cars read-only search/detail')
+sub=p.add_subparsers(dest='cmd', required=True)
+s=sub.add_parser('search'); s.add_argument('keyword', nargs='?'); s.add_argument('--region'); s.add_argument('--price-min',type=int); s.add_argument('--price-max',type=int); s.add_argument('--only-on-sale',action='store_true',default=True); s.add_argument('--limit',type=int,default=10); s.set_defaults(func=cmd_search)
+d=sub.add_parser('detail'); d.add_argument('url'); d.set_defaults(func=cmd_detail)
+args=p.parse_args(); args.func(args)

package/skills/daangn-cars-search/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "daangn-cars-search",
+  "description": "당근중고차 공개 웹 데이터로 차량을 검색하고, 돌쇠에서는 공식 계정 표면에서 문의·찜·거래 준비까지 진행한다.",
+  "profiles": [
+    "proxy",
+    "action:commerce"
+  ],
+  "frontmatter": "name: daangn-cars-search\ndescription: 당근중고차 공개 웹 데이터로 차량을 검색하고, 돌쇠에서는 공식 계정 표면에서 문의·찜·거래 준비까지 진행한다.\nlicense: MIT\nmetadata:\n  category: automotive\n  locale: ko-KR\n  phase: v1"
+}

package/skills/daangn-jobs-search/instruction.md

@@ -0,0 +1,90 @@
+# Daangn Jobs Search
+
+## What this skill does
+
+당근알바 공개 Remix `_data` JSON route로 채용/알바 공고 목록과 상세 정보를 읽기 전용으로 조회한다.
+
+최종 사용자는 자연어로 요청해도 되고, 필요하면 아래의 Python helper를 직접 실행한다. 외부 패키지나 k-skill-proxy 없이 Python 표준 라이브러리만 사용한다.
+
+## When to use
+
+- "당근알바 합정동 카페 찾아봐"
+- "홍대 근처 주말 알바 검색"
+- "이 당근알바 공고 상세 봐줘"
+
+## When not to use
+
+- 당근 계정 로그인이 필요한 작업
+- 채팅, 찜, 거래 제안, 문의, 지원, 예약, 계약, 구매처럼 상대방 또는 계정에 영향을 주는 작업
+- CAPTCHA/봇 차단/로그인벽 우회가 필요한 작업
+
+## Prerequisites
+
+- 인터넷 연결
+- Python 3.9+
+- 이 저장소 루트에서 실행하거나, 스크립트 경로를 절대경로로 지정
+
+## Data surfaces
+
+- Region resolver: `https://www.daangn.com/kr/api/v1/regions/keyword?keyword=<지역명>`
+- Search `_data`: `/kr/jobs/?in=<지역명>-<id>&search=<keyword>&_data=routes/kr.jobs._index`
+- Detail fallback: `<job-url>` redirects to `jobs.daangn.com/job-posts/<id>` and exposes public HTML title/meta/JSON-LD. The helper first tries the legacy `_data` route and falls back to HTML meta when that route returns an empty response.
+
+## Workflow
+
+1. 사용자 요청에서 키워드, 지역명, 가격/거래 유형 같은 필터를 추출한다.
+2. 지역명이 있으면 region resolver로 내부 region id를 찾는다.
+3. 목록 검색은 category별 `_data` route를 호출한다.
+4. 상세 URL이 주어지면 category별 detail route 또는 공개 HTML 메타를 조회한다.
+5. 결과를 짧게 정리하되 source URL과 적용 지역을 보존한다.
+
+## Commands
+
+```bash
+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/.../"
+```
+
+## Output fields
+
+- title, company, region, address, salary, salaryType, workDays, workTimeStart, workTimeEnd, closed, url
+- detail: `jobPost` 원문 if the `_data` route is available; otherwise public page `title`, `meta`, and `json_ld`
+
+## Region handling
+
+지역 필터가 있으면 먼저 당근 지역 검색 API로 내부 지역 id를 해석한다.
+
+```text
+https://www.daangn.com/kr/api/v1/regions/keyword?keyword=합정동
+→ 서울특별시 마포구 합정동, id=231
+→ in=합정동-231
+```
+
+동일한 지명이 여러 지역에 있으면 다음 우선순위로 선택한다.
+
+1. 사용자가 입력한 문자열이 `name`, `name1`, `name2`, `name3` 중 하나와 정확히 맞는 후보
+2. 서울 `depth=3` 동 단위 후보
+3. 첫 번째 후보
+
+응답에는 항상 `effective_region` 또는 실제 적용된 지역명을 포함한다. 사용자의 의도와 다른 지역으로 보이면 결과를 단정하지 말고 후보 확인을 요청한다. IP/쿠키 기본 위치에 의존하지 않는다.
+
+## Safety and scope
+
+- 읽기 전용 검색/상세 조회만 수행한다.
+- 로그인, 채팅, 찜, 거래 제안, 지원, 문의, 예약, 계약, 구매 자동화는 하지 않는다.
+- 공개 웹 표면이 바뀌거나 빈 응답/봇 차단/로그인벽이 나오면 실패 모드로 보고하고 우회하지 않는다.
+- 결과는 실시간 재고/공고 상태와 달라질 수 있으므로 source URL을 함께 제시한다.
+
+## Failure modes
+
+- 당근의 Remix route 이름이나 JSON shape가 변경되면 `_data` 조회가 실패할 수 있다.
+- 지역명이 넓거나 중복되면 다른 행정동이 선택될 수 있다.
+- 검색 결과가 0건이어도 사이트 정책/지역 기본값/필터 조합 때문일 수 있으므로 source URL을 보존한다.
+- 상세 조회는 삭제/종료/비공개 전환된 글에서 실패할 수 있다.
+
+## Done when
+
+- 지역명이 있으면 지역 id를 해석하고 적용했다.
+- 목록 조회 또는 상세 조회를 최소 1회 수행했다.
+- 결과에 source URL과 effective region을 포함했다.
+- 인증/거래성 액션은 수행하지 않았다.

package/skills/daangn-jobs-search/scripts/daangn_jobs.py

@@ -0,0 +1,98 @@
+#!/usr/bin/env python3
+import argparse, json, re, sys, urllib.parse, urllib.request
+from html import unescape
+
+HEADERS = {"User-Agent":"Mozilla/5.0", "Accept":"application/json,text/html;q=0.9,*/*;q=0.8"}
+
+def fetch_json(url):
+    req = urllib.request.Request(url, headers=HEADERS)
+    with urllib.request.urlopen(req, timeout=25) as r:
+        body = r.read()
+        if not body:
+            raise ValueError(f'빈 JSON 응답: {url}')
+        return json.loads(body)
+
+def fetch_text(url):
+    req = urllib.request.Request(url, headers={"User-Agent":"Mozilla/5.0", "Accept":"text/html"})
+    with urllib.request.urlopen(req, timeout=25) as r:
+        return r.read().decode('utf-8', 'ignore')
+
+def won(v):
+    if v in (None, ''): return '-'
+    try: return f"{int(float(v)):,}원"
+    except Exception: return str(v)
+
+def resolve_region(region):
+    if not region: return None
+    url = 'https://www.daangn.com/kr/api/v1/regions/keyword?keyword=' + urllib.parse.quote(region)
+    data = fetch_json(url)
+    locs = data.get('locations') or []
+    if not locs: raise SystemExit(f'지역 후보 없음: {region}')
+    # Exact dong/name match first, then Seoul depth-3, then first candidate.
+    exact = [x for x in locs if region in (x.get('name'), x.get('name1'), x.get('name2'), x.get('name3'))]
+    seoul = [x for x in locs if x.get('name1') == '서울특별시' and x.get('depth') == 3]
+    sel = (exact or seoul or locs)[0]
+    return sel
+
+def region_param(sel):
+    return urllib.parse.quote(f"{sel['name']}-{sel['id']}")
+
+def absolute(href):
+    if not href: return ''
+    if href.startswith('http'): return href
+    return 'https://www.daangn.com' + href
+
+def print_json(obj):
+    print(json.dumps(obj, ensure_ascii=False, indent=2))
+
+def parse_html_detail(url):
+    html = fetch_text(url)
+    title = re.search(r'<title>(.*?)</title>', html, re.S)
+    meta = {}
+    for m in re.finditer(r'<meta[^>]+(?:property|name)=["\']([^"\']+)["\'][^>]+content=["\']([^"\']*)["\']', html):
+        key, value = m.group(1), unescape(m.group(2)).strip()
+        if key in ('description', 'og:title', 'og:description', 'og:image'):
+            meta[key] = value
+    json_ld = []
+    for m in re.finditer(r'<script[^>]*type=["\']application/ld\+json["\'][^>]*>(.*?)</script>', html, re.S):
+        try:
+            json_ld.append(json.loads(unescape(m.group(1))))
+        except Exception:
+            pass
+    return {
+        'source': url,
+        'title': unescape(title.group(1)).strip() if title else meta.get('og:title'),
+        'meta': meta,
+        'json_ld': json_ld[:3],
+    }
+
+
+def cmd_search(args):
+    sel=resolve_region(args.region) if args.region else None
+    params=[]
+    if sel: params.append(('in', f"{sel['name']}-{sel['id']}"))
+    if args.keyword: params.append(('search', args.keyword))
+    params.append(('_data','routes/kr.jobs._index'))
+    url='https://www.daangn.com/kr/jobs/?'+urllib.parse.urlencode(params)
+    data=fetch_json(url); arr=((data.get('jobsAllPage') or {}).get('jobPosts') or [])[:args.limit]
+    items=[{'title':a.get('title'),'company':a.get('workplaceCompanyName'),'region':a.get('workplaceRegion'),
+            'address':a.get('workplaceRoadNameAddress'),'salary':a.get('salary'),'salaryType':a.get('salaryType'),
+            'workDays':a.get('workDays'),'workTimeStart':a.get('workTimeStart'),'workTimeEnd':a.get('workTimeEnd'),
+            'closed':a.get('closed'),'url':absolute(a.get('href') or a.get('jobsWebDetailUrl'))} for a in arr]
+    print_json({'source':url,'effective_region':data.get('searchRegion') or sel,'count':len(items),'items':items})
+
+def cmd_detail(args):
+    u=args.url.rstrip('/')+'/?_data=routes%2Fkr.jobs.%24job_post_id'
+    try:
+        data=fetch_json(u)
+        print_json({'source':u,'jobPost':data.get('jobPost') or data})
+    except Exception:
+        detail = parse_html_detail(args.url)
+        detail['data_source_attempted'] = u
+        print_json(detail)
+
+p=argparse.ArgumentParser(description='Daangn jobs read-only search/detail')
+sub=p.add_subparsers(dest='cmd', required=True)
+s=sub.add_parser('search'); s.add_argument('keyword', nargs='?'); s.add_argument('--region'); s.add_argument('--limit',type=int,default=10); s.set_defaults(func=cmd_search)
+d=sub.add_parser('detail'); d.add_argument('url'); d.set_defaults(func=cmd_detail)
+args=p.parse_args(); args.func(args)

package/skills/daangn-jobs-search/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "daangn-jobs-search",
+  "description": "당근알바 공개 웹 데이터로 공고를 검색하고, 돌쇠에서는 공식 계정 표면에서 지원서 작성·채팅·승인 기반 전송까지 진행한다.",
+  "profiles": [
+    "proxy",
+    "action:communication"
+  ],
+  "frontmatter": "name: daangn-jobs-search\ndescription: 당근알바 공개 웹 데이터로 공고를 검색하고, 돌쇠에서는 공식 계정 표면에서 지원서 작성·채팅·승인 기반 전송까지 진행한다.\nlicense: MIT\nmetadata:\n  category: jobs\n  locale: ko-KR\n  phase: v1"
+}