k-skill/docs
TaeyoungPark 91eeaf607a
feat: add SH notice search skill (#218)
* feat: add SH notice search skill

* fix(sh-notice): require srchTp for keyword search, parse real attachments, cap pageSize

- Default srchTp to title ("1") when srchWord is provided without an explicit
  type. SH 게시판 ignores srchWord without srchTp and silently returns the full
  list, so /v1/sh-notice/search?q=행복주택 was returning all 1608 notices.
- Rewrite parseAttachments to ignore icon-template anchors (.pdf, .hwp, ...)
  and require existFile() onclick for real file rows. Multi-attachment notices
  now expose every real attachment with the correct filename.
- Drop unverified download_hint field from attachment objects; preview_url
  remains the only documented stable path.
- Cap pageSize at 10 to match the SH board's fixed page size and update docs
  to direct callers to use the page parameter for more results.
- Add multiItmSeq digits-only validation and a 100-char keyword length cap to
  bound cache cardinality.
- Add README, docs/install.md, packages/k-skill-proxy/README.md, and
  docs/features/sh-notice-search.md entries to register the skill in the
  repo's public surface.

Verified live against www.i-sh.co.kr:
- q=행복주택 → 96 hits (was 1608, unfiltered)
- seq=303994 → 11 real attachments with correct filenames (was 1 with '.pdf')
- pageSize=50 → caps at 10 with correct summary.page_size
- Validation errors return 400 with clear messages.

---------

Co-authored-by: Jeffrey (Dongkyu) Kim <vkehfdl1@gmail.com>
2026-05-09 00:09:45 +09:00
..
assets Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
features feat: add SH notice search skill (#218) 2026-05-09 00:09:45 +09:00
adding-a-skill.md Guide crawler skills toward reusable discovery (#195) 2026-05-01 22:11:04 +09:00
install.md feat: add SH notice search skill (#218) 2026-05-09 00:09:45 +09:00
releasing.md Align Changesets release flow with generated package changelogs 2026-03-30 22:27:07 +09:00
roadmap.md Add court-auction-notice-search skill and package (#167) 2026-04-29 16:36:55 +09:00
security-and-secrets.md feat: 국가데이터처 KOSIS 통계 조회(kosis-stats) 스킬 추가 (#216) 2026-05-08 23:06:19 +09:00
setup.md feat: 국가데이터처 KOSIS 통계 조회(kosis-stats) 스킬 추가 (#216) 2026-05-08 23:06:19 +09:00
sources.md feat: 국가데이터처 KOSIS 통계 조회(kosis-stats) 스킬 추가 (#216) 2026-05-08 23:06:19 +09:00