韩国法院拍卖公告怎么查court-auction-notice-search 只读技能全拆解【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill「今天哪里有不动产拍卖」想程序化回答这个问题目标只有韩国大法院官网法원경매정보법원경매정보即法院拍卖信息站 courtauction.go.kr。它没有公开 API还会按 IP 封杀自动化流量。k-skill 项目里的 court-auction-notice-search 技能就是为这个场景做的只读查询客户端把 매각공고不动产拍卖公告和案件数据转成 Agent 可直接消费的结构化 JSON同时把触发 IP 封禁的风险压到最低。你在对付一个怎样的站点先说清楚战场后面所有设计都能对上号。courtauction.go.kr 有三个硬约束没有公开 Open API。站点是 WebSquare韩国政务网站常用的前端框架搭的页面上点一下查询按钮实际是向后端发一个结构化 JSON 的 XHR浏览器前端发起的异步 HTTP 请求。技能做的事就是直接复制这些内部 XHR 端点路径以/pgj/开头如POST /pgj/pgj143/selectRletDspslPbanc.on查公告列表。IP 级激进拦截。站点 WAFWeb 应用防火墙挡机器人用的组件大约 30 秒内收到 16 次请求就会把该 IP 封 1 小时左右封禁靠自然过期解除。数据仅供参考。它是参考工具价格、拍卖日期、场所都以公告时点为准会因更正、撤回、延期而变化真正投标前必须回法院原始公告逐条核对。所以这个技能的姿态是只读 慢不写任何东西、不替人投标用保守的调用节奏换 IP 存活率。三个查询怎么写从提问到结构化 JSON技能的三个入口对应三类真实提问。以下按你怎么问 → 调什么 → 拿回什么走一遍。① 某月/某日某法院有什么拍卖公告调searchSaleNotices({ date, courtCode, bidType })返回公告卡片列表items[]。用户选定某张卡片后把卡片对象原样传给getSaleNoticeDetail(notice)不要自己拼参数——因为请求体里的jdbnCd法院审判部门令牌是列表响应里返回的加密 token外部无法凭空构造源码会自动从卡片raw里抽出来。详情响应items[]每条含caseNumber案件号、usage用途、address、appraisedPrice评估价、minimumSalePrice最低拍卖价、remarks价格都是韩元整数展示时记得换算亿/万。② 案件 2024타경100001 进展如何调getCaseByCaseNumber({ courtCode, caseNumber })。found: falseHTTP 204时不要反复重试给用户可执行的核对建议案件号格式是否为年份타경编号、法院选对没有。found: true时拿回caseInfo案件名/受理日/裁判部/状态、items[]目的物与地址、schedule[]各期拍卖日的最低价与结果、claimDeadline分配请求期限、relatedCases、stakeholders足以支撑对话式追问。③ 江南区 5 亿以下、流拍过一两次的高层公寓调searchProperties()。region传 시·도市/道的代码或韩语名시·군·구/읍·면·동 没有静态表直接传原始代码如{ sido:11, sigungu:11680, dong:11680101 }给了区域请求体里cortStDvs自动置2地番地址搜索不给区域则置1公告模式。usage接受大/中/小分类代码5 位如 건물20000或大分类韩语名priceRange、appraisedPriceRange、area是{ min, max }数值区间flbdCount유찰流拍次数只收整数pageSize只认10/20/50/100传1之类会被本地直接拒绝因为 live 端点会回 HTTP 400。三个查询共用的核心参数速查参数传法说明dateYYYY-MM/YYYYMM/YYYY-MM-DD/YYYYMMDD必填。站点搜索按钮实际按月YYYYMM查询传具体日期时先查整月再按日过滤courtCode如B000210首尔中央地方法院必须匹配正则^B\d{6}$空串表示全部法院代码表可经getCourtCodes()获取bidTypedate/period对应 기일입찰期日投标代码000331/ 기간입찰期间投标000332留空两种都查caseNumber2024타경1000012024-100001、2024_100001、2024 100001会被自动归一化为2024타경100001代码表的解析策略是认识的就翻译不认识的原样透传fail-openresolveUsageCode遇到同名歧义比如아파트同时存在于多个层级时宁可透传原文让上游报错也不静默映射到错误层级的代码避免污染请求体。怎么把数据稳定拿回来三层传输与预算机制拿到结构只是前提能持续拿到数据才是难点。该技能把传输分三层且浏览器永远是备胎。第一层直接 HTTP默认通道。公告列表、公告详情、案件直查、自由检索的正常路径都不需要真浏览器。每次 POST 前会先做一次 warmup GET 拿会话 Cookie请求头带X-Requested-With: XMLHttpRequest、韩语Accept-LanguageReferer按端点动态填充全部伪装成站点前端的正常 XHR。第二层用户已有浏览器CDP 回退。只有自由检索searchProperties会启用浏览器回退且触发条件收得很窄WAF 型 HTTP 400UPSTREAM_ERROR且statusCode 400或BLOCKED且调用方显式传了fallbackOnBlocked: true。CDPChrome DevTools Protocol远程驱动已运行浏览器的协议连接顺序按平台macOS 上 Aside → BrowserOS → Chrome/Chromium其他平台先试 BrowserOS可用provider、cdpUrl选项或KSKILL_BROWSER_PROVIDER等环境变量干预。这里有个安全边界连上的浏览器是用户自己的回退结束只清理由适配器创建的 page/context/tab 并断开 automation 客户端绝不关闭 BrowserOS/Aside/Chrome 的 profile。第三层本地 Playwright浏览器自动化库launch。所有 runtime provider 都连不上时本地chromium.launch起一个全新实例用完连同 browser 一起关。依赖rebrowser-playwright或playwright-core两者都是 optionalDependency模块没装时回退自动失效PLAYWRIGHT_UNAVAILABLE与 provider 名写错的UNKNOWN_PROVIDER会 fail-closed 立即抛错而不是含糊降级。传{ fallback: false }可以完全关掉自动回退。无论哪一层限流四件套都在生效相邻调用最小间隔 2000ms--min-delay-ms可调大间隔上再叠加0~1000ms 随机 jitter把调用节奏打散、避免指纹化每会话预算 10 次调用超限抛BUDGET_EXCEEDED响应里data.ipcheck false即立刻抛BLOCKED并停止不做任何自动重试重试只会拖长封禁。需要更多调用量时正确姿势是开新会话new CourtAuctionHttpClient()或显式调大maxCallsPerSession对同一个 Playwright 客户端连续 10~15 次间隔调用是稳定的要更高突发量就加 3~5 秒 sleep 并换新客户端。五分钟上手Node.js 侧三个核心函数加一个BLOCKED捕获就是最小闭环包名即 npm 包名bin 同名const { searchSaleNotices, getSaleNoticeDetail, getCaseByCaseNumber } require(court-auction-notice-search); (async () { const notices await searchSaleNotices({ date: 2026-04-27, // 查整月后按日过滤 courtCode: B000210, // 首尔中央地方法院 bidType: date }); for (const notice of notices.items) { const detail await getSaleNoticeDetail(notice); for (const it of detail.items) { console.log(it.caseNumber, it.address, it.minimumSalePrice); } } const found await getCaseByCaseNumber({ courtCode: B000210, caseNumber: 2024-100001 // 自动归一化为 2024타경100001 }); console.log(found.found ? found.caseInfo.caseName : 未找到请核对法院与案件号); })().catch((err) { if (err.code BLOCKED) console.error(IP 已被封约 1 小时后或换网络再试勿自动重试); else throw err; });CLI 侧最常用的三条# 法院事务所代码表找到目标法院的 B 开头代码 court-auction-notice-search codes courts --pretty | head -20 # 拍卖公告列表date 可给月或具体日期 court-auction-notice-search notices --date 2026-04 --court-code B000210 --bid-type date --pretty # 案件号直查 court-auction-notice-search case --court-code B000210 --case-number 2024타경100001 --pretty # 把节奏调得更慢最小间隔 3s、本会话只许 5 次 court-auction-notice-search notices --date 2026-04 --min-delay-ms 3000 --max-calls 5全局标志还有--json默认、--pretty、--include-rawfalse、--timeout-ms自由检索走search子命令支持--region 시도[:시군구[:읍면동]]、--usage-large、--price-min/max、--page-size 10|20|50|100等。错误码与处理对照出错时按error.code分支处理五个码的行为各不相同错误码触发条件处理建议BLOCKED响应data.ipcheck false命中 IP 封禁⚠️ 立即停止不要自动重试告知用户等待约 1 小时后换 IP/网络再来BUDGET_EXCEEDED会话调用预算默认 10 次耗尽这是有意的安全阀新开客户端/会话继续或显式调大maxCallsPerSession同时向用户提示封禁风险UPSTREAM_ERROR站点返回一般性错误最常见原因是会话过期或jdbnCd令牌失效从 warmup 重新建立会话再试细节看error.upstreamMessageNETWORK_ERROR超时默认 15s或连接失败原始异常在error.cause检查网络与timeoutMsPLAYWRIGHT_UNAVAILABLE需要浏览器回退但 Playwright 模块未安装npm i rebrowser-playwright或npm i playwright-coreBLOCKED错误对象会额外携带upstreamUrl: courtauction.go.kr与upstreamPayload方便把封禁证据原样转述给用户。这些事它不做这些事必须说边界先划死。以下都不在 v1 范围Agent 收到相关请求时应直接拒绝或说明动产拍卖汽车、工程机械——只覆盖不动产自动投标——不代填、不提交投标书投标必须由人在法院完成同一天所有法院的日程查询、物件照片URL、物件明细书/现状调查书/评估书 PDF下载——均列为后续议题未实现。同时每次交互都必须向用户交代四件事这是该技能写死的合规话术数据只是官网公开信息的原样转述实际投标前必须回法院原始公告核对站点对自动化非常敏感快速连续查询可能导致 IP 被封约 1 小时价格评估/最低拍卖价、拍卖日期、场所都以公告时点为准可能因更正、撤回、延期变化响应里的correctionCount、cancellationCount就是线索技能是 read-only不执行任何投标动作。任务算不算完成看这几条自检已说明封禁风险与仅供参考提示公告已展开且 JSON 含caseNumber/usage/address/appraisedPrice/minimumSalePricefound: false时给了用户可执行的核对动作遇到封禁没有自动重试结束时告知用户剩余调用预算让对方知道还有多少查询余量。源码怎么读建议按这条路径进入每层只回答一个问题instruction.md——Agent 视角的行为规则与话术要求README——Public API、端点表、回退层级与限流默认值src/index.js——门面参数归一化、请求体构造与浏览器回退编排都在这里src/transport/http.js——直接 HTTP 客户端端点常量、warmup、jitter、预算检查、错误工厂src/normalize.js——把韩文 raw 列名翻成英文键的映射逻辑src/codetables/——投标区分/用途/地区三份静态 JSON 与解析函数。理解响应结构不用凭空想象test/fixtures 下有公告列表、公告详情、案件命中、自由检索、封禁响应等真实样本 JSON其中canonical-search-body.json是用真实浏览器提交捕获的规范请求体对着它读searchControllerMain.on的字段含义最省力。政务站点、无公开 API、反爬敏感这三个条件叠加时这个技能给出的组合拳可以整套搬走直连内部端点优先、浏览器只做窄条件回退、最小间隔加 jitter 加会话预算加封禁即停、静态代码表 fail-open 透传、合规提示与预算告知写进行为规则而不是靠模型自觉。缺任何一条长期跑在敏感站点上都会露馅。【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考