court-auction-notice-search 实战指南：把韩国法院不动产拍卖公告查成 JSON，还能躲开 1 小时 IP 封禁

court-auction-notice-search 实战指南把韩国法院不动产拍卖公告查成 JSON还能躲开 1 小时 IP 封禁【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skillk-skill 仓库里的 court-auction-notice-search 包直连韩国法院拍卖信息网站 courtauction.go.kr 的内部接口把不动产拍卖公告、案件进度转成结构化 JSON。它默认每 2 秒才查一次、一个会话只查 10 次专门用来在不开浏览器的情况下避开该站的 IP 封禁。它解决什么问题想象一下你问 Agent明天首尔中央地方法院有哪些房子要拍卖评估价多少如果 Agent 只会打开网页复制粘贴那结果不可控、也不可复用。而 courtauction.go.kr 这个官方站点没有公开 Open API页面按钮点下去其实是在向 WebSquare 框架韩国政务站常见的前端框架的内部 XHR 接口提交结构化 JSON。court-auction-notice-search 做的事情就是把这条隐藏通道变成一组可以直接require的函数和一条同名 CLI让查公告 → 展开物件 → 追案件变成确定性的数据流。对普通用户这意味着一句江南区 5 亿以下、流拍过一次的物件帮我找出来就能得到干净的字段对开发者这意味着不用自己逆向政府站点的请求体。它能做什么 / 它拒绝做什么能力边界在 instruction.md 里写得很直白值得先看清楚再动手接得住的活按拍卖日期月或特定日 法院 投标区分기일입찰/기간입찰拉公告列表再逐张展开出案件号、用途、地址、评估价감정평가액、最低拍卖价최저매각가、备注用法院代码 案件号如2024타경100001直查一件拍卖案拿到案件信息、各期拍卖日程、配当请求终期、相关案件与利害关系人自由条件检索物件地区、用途、最低拍卖价区间、评估价区间、拍卖日期范围、流拍次数、面积㎡都能当筛子附赠四张代码表法院事务所60 个、投标区分、用途分类、19 个 시·도市道地区代码。明确不接的活动产拍卖汽车、工程机械——v1 范围外某一天所有法院的日程汇总、物件照片 URL、物件明细书/现状调查书/评估书 PDF 下载——都是留待后续的 follow-up 议题投标书自动填写、自动提交——设计为 read-only真正的入札投标必须人到法院完成。这条红线写在 README 顶部没有任何商量余地。另外提醒它给出的价格是公告时点的快照法院可以更正、撤回、延期响应里的correctionCount、cancellationCount字段就是为此存在的。三步跑起来这节的目标是让你 5 分钟内看到真实数据。装好包之后npm install court-auction-notice-searchNode 18最短路径是 CLI# 第 1 步拿法院代码表找到首尔中央地方法院是 B000210 court-auction-notice-search codes courts --pretty | head -10 # 第 2 步查 2026-04-27 该院公告传特定日会先按月查、再按该日过滤 court-auction-notice-search notices --date 2026-04-27 --court-code B000210 --pretty # 第 3 步案件号直查2024-100001 这种写法会被自动规范成 2024타경100001 court-auction-notice-search case --court-code B000210 --case-number 2024타경100001 --pretty想要展开公告这一步用 Node API 更顺列表返回的每张卡片带着raw字段原样丢给详情函数即可不用手工拼参数。const { searchSaleNotices, getSaleNoticeDetail } require(court-auction-notice-search); const notices await searchSaleNotices({ date: 2026-04-27, courtCode: B000210 }); console.log(公告 ${notices.count} 张); // 卡片对象原样传入即可展开内部会自动取出加密的 jdbnCd 令牌 const detail await getSaleNoticeDetail(notices.items[0]); const [first] detail.items; console.log(first.caseNumber, first.usage, first.address); console.log(감정:, first.appraisedPrice, 최저:, first.minimumSalePrice);为什么卡片要原样传因为详情接口需要jdbnCd——一个由列表响应返回的加密令牌外部无法凭空构造。价格字段是韩元整数展示时建议同时给千位逗号格式和亿/万换算。found:false / status:204表示案件查不到或非公开此时应让用户复核案件号格式与法院代码而不是反复重试。原理白话版怎么调政府站点还不被封这节讲机制只点到为止想深挖看 src/transport/http.js 即可。先说背景courtauction.go.kr 的机器人拦截非常激进大约 16 次请求/30 秒就会触发 1 小时 IP 封禁。所以这个包的默认节奏是慢即是稳——把每会话调用次数想成话费额度默认 10 次打完就报BUDGET_EXCEEDED停机两次通话之间强制间隔 2 秒再随机加 0~1000 毫秒的抖动让流量看起来像人手操作单次请求 15 秒超时。请求通道上它把浏览器当成备用钥匙而不是主钥匙公告、案件、物件三类查询的正常路径全是直接 HTTP先 GET 一次官方页面做 warmup 领 Cookie再带着X-Requested-With: XMLHttpRequest和韩语Accept-Language头 POST JSON。只有自由条件检索searchProperties遇到 WAF 型 HTTP 400 时才按你已打开的运行时浏览器BrowserOS/Aside/Chrome CDP→ 本地 Playwright 启动的顺序降级换钥匙。注意两个细节被封data.ipcheck false时默认立刻抛BLOCKED停下只有你显式传fallbackOnBlocked: true才会再试连上用户自己的浏览器后退出时只关自己开的页签绝不关浏览器 profile。代码表这块有个小设计值得学用途分类里存在跨层级的同名比如아파트如果按名字乱匹配就会静默污染请求体所以 src/codetables/index.js 采用认不出就原样透传fail-open把错误交还给上游而不是猜一个错码。地区代码同理——只有 시·도 有 19 行静态表시·군·구/읍·면·동 直接传原始代码。安全与合规必须转述的三句话这个技能对 Agent 的要求比大多数工具严每次交付结果时都要把下面三件事原样告诉终端用户这是写在 SKILL.md 里的硬性义务——数据只是法원경매정보 站公开信息的转述实际投标前必须回法院原始公告核对站点极敏感快速连查可能让当前 IP 被锁约 1 小时锁了就得等工具是 read-only不会替任何人投标。此外还有几条通用安全红线未经用户明确批准不碰支付、发送消息/邮件、最终提交、取消、公开发布不在聊天、文件或 shell 参数里明文留凭据不绕过登录、CAPTCHA、身份核验、电子签名——走到哪一步走不通就把下一步的官方操作精确准备好交给用户。常见坑与自查清单被封 1 小时怎么办BLOCKED→ 原因站点返回ipcheckfalse当前 IP 已被拦。对策别自动重试只会拖长封禁换 IP/网络或等约 1 小时后由人用浏览器访问站点走完解封页面。BUDGET_EXCEEDED报错了→ 原因这是有意设置的安全阀默认 10 次/会话。对策确需更多就新建客户端或把maxCallsPerSession调大、CLI 用--max-calls 20同时提醒用户封禁风险。UPSTREAM_ERROR频出→ 最常见原因是会话过期或jdbnCd令牌对不上。对策重置客户端、从 warmup 重新开始检查是不是详情调用没带上列表返回的原始卡片。自由检索直接 HTTP 400→ 这是 WAF 在拦裸请求包会自动尝试浏览器 fallback若PLAYWRIGHT_UNAVAILABLE报错说明rebrowser-playwright/playwright-core都没装补装其一即可。另外pageSize只认 10/20/50/100默认 10传1这种值会被本地直接拒绝——因为线上接口对任意值返回 400。NETWORK_ERROR→ 超时或断连查网络与--timeout-ms默认 15000。交付前的自查清单已提示 IP 封禁风险与仅供参考、投标前核对原文展开的公告 JSON 里caseNumber / usage / address / appraisedPrice / minimumSalePrice齐了案件直查found:false时给出了可执行的复核指引全程没有自动重试被封请求收尾时告知用户本会话还剩几次调用额度。延伸阅读机制、字段、边界都摸清了之后按这个顺序走源码效率最高门面与参数校验看 src/index.js限流与错误构造在 src/transport/http.js包内完整的 API 清单、Endpoint 请求体对照表和 fallback 安全边界整理在 packages/court-auction-notice-search/README.md。想理解响应长什么样test/fixtures/ 里的notices-sample.json、case-found-sample.json、blocked.json等夹具是现成的样本在包目录跑npm run lint npm run test可以验证你的环境是否正常。这套直连优先、浏览器备用、额度兜底的组合也是仓库里其他政务类技能共用的保守范式。【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考