菜单
대한민국 부모 생활정보를 여러 소스에서 수집·정규화하는 내부 파이프라인 스킬. 출처·수집시각·freshness를 기록하며 학교·축제·행사·문화·트렌드 데이터를 모은다(packages/k-parent-source-naver runCollector). "여러 소스에서 부모 데이터 모아줘", "행사 수집 파이프라인 만들어줘" 같은 수집 작업에 사용. 최종 사용자용 단건 조회는 각 도메인 스킬(k-parent-school-info, k-parent-play-finder 등)을 쓴다.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
대한민국 부모가 아이와 볼/들을 콘텐츠를 찾을 때 쓰는 스킬. YouTube Data API(packages/k-parent-source-youtube, safeSearch strict)로 교과 연계 영상·차 안 오디오형 콘텐츠·부모자녀 대화 주제를 추천한다. "차에서 들려줄 만한 거 추천해줘", "초3 과학 단원 연계 영상", "아이랑 대화할 주제 알려줘" 같은 요청에 사용.
대한민국 부모가 문화센터·도서관·지자체 강좌와 체험 프로그램을 찾을 때 쓰는 스킬. 서울 공공서비스예약·도서관정보나루·문화포털(packages/k-parent-source-seoul/library/culture)로 지역·연령·접수기간 기준으로 안내한다. "백화점 문화센터 강좌", "도서관 프로그램 신청", "주말 체험 강좌 찾아줘" 같은 요청에 사용. 접수기간이 있는 강좌·체험·예약형 전용이며, 야외 놀거리는 k-parent-play-finder, 축제는 k-parent-festival-finder. 예약·결제는 사용자 승인 전에는 실행하지 않습니다.
대한민국 부모를 위한 가족 축제·행사 찾기 스킬. 한국관광공사 TourAPI searchFestival로 날짜·지역 기준 축제를 검색하고, 가족(아이) 동반 적합도를 정리해 추천한다. "이번 주말 가족 축제", "다음 달 우리 동네 행사", "아이랑 갈 만한 봄 축제" 같은 요청에 사용. 시작·종료일이 있는 명명된 축제·행사 전용이며, 상시 놀거리·실내 장소는 k-parent-play-finder, 여행 코스는 k-parent-travel-recommender.
대한민국 부모가 유치원·어린이집을 비교할 때 쓰는 스킬. 어린이집정보공개·유치원현황(packages/k-parent-source-childinfo)으로 운영시간·비용·교직원·급식/위생/안전·CCTV/차량·방과후를 비교한다. "근처 유치원 비교해줘", "국공립 유치원 모집 언제야", "어린이집 방과후 되는 곳 찾아줘" 같은 요청에 사용. 초·중·고 학교는 k-parent-school-info.
대한민국 부모의 일반 지식·생활 판단 질문에 출처 기반으로 답하는 스킬. 더 구체적인 k-parent 스킬이 다루지 않는 영역을 보조한다. "예방접종 일정 일반적으로 어떻게 돼", "초등 입학 전에 뭘 준비해야 해", 특정 스킬로 분류되지 않는 부모 생활 질문에 사용. 학교·유치원·신청·식단 등 구체 조회는 해당 전용 스킬로 라우팅한다.
대한민국 부모가 아이 식단을 챙길 때 쓰는 스킬. NEIS 학교 급식·유치원 식단·가정 식단 후보를 아이 알레르기(1~19번) 기준으로 정리한다(packages/k-parent-source-neis, k-parent-brief). "이번 주 급식 뭐야", "알레르기 빼고 식단 짜줘", "유치원 식단표 확인해줘" 같은 요청에 사용. 학교 공지·학사일정 전반은 k-parent-school-info.
| name | k-parent-data-collector |
| description | 대한민국 부모 생활정보를 여러 소스에서 수집·정규화하는 내부 파이프라인 스킬. 출처·수집시각·freshness를 기록하며 학교·축제·행사·문화·트렌드 데이터를 모은다(packages/k-parent-source-naver runCollector). "여러 소스에서 부모 데이터 모아줘", "행사 수집 파이프라인 만들어줘" 같은 수집 작업에 사용. 최종 사용자용 단건 조회는 각 도메인 스킬(k-parent-school-info, k-parent-play-finder 등)을 쓴다. |
| license | MIT |
| metadata | {"category":"parenting","locale":"ko-KR","phase":"implemented"} |
여러 공개/상용 출처(공식 API, 상용 API, 프록시, 캐시)에서 부모 생활정보를 수집·정규화하고, provenance(출처)와 freshness(신선도)를 관리한다. 차단되거나 오래된(stale) 출처 실패를 숨기지 않고 그대로 노출한다.
k-parent-source-naver의 runCollector(tasks, options)를 사용한다.
이 러너는 의존성 주입 방식이라 특정 source 패키지를 직접 require하지 않으며, 각 task가 자신의 fetch()를 제공한다.
const { runCollector } = require("k-parent-source-naver");
const report = await runCollector([
{
name: "naver-shop",
source: { name: "Naver Shopping", url: "https://openapi.naver.com/v1/search/shop.json", type: "commercial" },
fetch: () => fetchShopping({ query: "물티슈" }).then((r) => r.items),
},
{
name: "coupang",
source: { name: "Coupang Partners", url: "https://api-gateway.coupang.com", type: "affiliate" },
fetch: () => fetchProducts({ keyword: "물티슈" }).then((r) => r.items),
},
], { now: new Date() });
반환값: { collectedAt, dedupeNote, okCount, failureCount, hasFailures, results, failures }.
각 result에는 source(freshness 포함), collectedAt, count, rows가 들어 있다.
source name, source type(API/HTML/PDF/RSS/calendar/screenshot), region/department, crawl frequency, legal/robots/terms notes를 기록한다.
각 출처를 { name, source, fetch } task로 감싸 runCollector로 실행한다.
raw payload는 출처별 원본 행으로 rows에 보존되고, source URL/fetched_at/freshness가 자동 기록된다.
모든 결과에 출처(이름/유형/URL)와 fetchedAt, freshness 상태(fresh/stale/unknown)를 표시한다.
stale 데이터는 stale임을 명시하고 출처 링크를 함께 제공한다.
차단(blocked)되거나 오류 난 출처는 failures 배열에 blocked: true, error, status와 함께 노출된다.
실패를 조용히 삼키거나 빈 결과로 위장하지 않고, 어떤 출처가 실패했는지 사용자에게 보고한다.
러너는 출처별 원본 행을 보존한다. 중복 제거는 호출자가 source/productId/link 기준으로 수행한다(dedupeNote 참고).
k-parent-core의 guardActionCandidate).