Skip to main content
Glama

경매 물건 검색

search_auctions
Read-onlyIdempotent

진행 중인 한국 법원 부동산 경매 물건을 찾는다(최대 20건). 조건: 지역·읍면동, 용도(여러 개 가능), 아파트 단지·건물명·도로명(keyword), 감정가·최저가 범위, 최저가율 상한(예: 감정가의 50% 이하), 유찰 횟수 범위(신건만=fail_count_max 0), 새로 나온 물건(최근 N일), 전용면적(㎡ 또는 평), 지분 매각 제외, 법원, 매각기일 상한, 권리 표시 [안전]만, 경매레이더 추정 시세 대비 저평가, 입지 우수, 정렬(기일·할인율·저평가·우량 종합). 아파트 'N평형'은 공급면적이라 전용이 더 작다(25평형≈전용 59㎡, 34평형≈전용 84㎡) — 평형으로 물으면 min_area/max_area 로 바꿔 넣는다. 사건번호·법원·주소·용도·전용면적·감정가·최저가·최저가율·유찰·매각기일·권리 표시·위험 사유(risk_flags)·상세 링크를 돌려준다. Search ongoing Korean court real-estate auctions (경매). 예상낙찰가는 주지 않는다.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "region": "<region>"
    },
    "name": "search_auctions"
  }
}

Input Schema

NameRequiredDescriptionDefault
dongNo읍면동 앞부분. 예: '천호', '백석'
sortNo'date'(기일 가까운 순, 기본) · 'discount'(감정가 대비 많이 떨어진 순) · 'value'(추정 시세 대비 저평가 큰 순) · 'quality'(권리·저평가·입지 종합 우량 순)
courtNo법원. 예: '수원', '서울중앙', '성남지원'
limitNo최대 건수(1~20, 기본 10)
regionYes지역. 예: '서울', '서울 마포구', '경기 수원시 장안구', '수도권'
keywordNo아파트 단지명·건물명·도로명·지번 일부. 예: '래미안', '헬리오시티', '테헤란로'
max_areaNo전용면적 상한(㎡)
min_areaNo전용면적 하한(㎡). 예: 59 (국민평형 84)
safe_onlyNotrue 면 경매레이더 권리 표시가 [안전]인 물건만(위험이 없다는 보장은 아님)
max_pyeongNo전용면적 상한(평)
min_pyeongNo전용면적 하한(평). ㎡ 값(min_area)이 있으면 그것을 쓴다
undervaluedNotrue 면 경매레이더 추정 시세보다 최저가가 낮은(저평가) 물건만
sale_date_toNo매각기일 이 날짜까지(YYYY-MM-DD)
exclude_shareNotrue 면 지분 매각(지분 경매) 물건을 뺀다
good_locationNotrue 면 경매레이더 입지 점수 우수 물건만
max_appraisalNo감정가 상한(원)
max_bid_priceNo최저가 상한(원)
min_appraisalNo감정가 하한(원)
min_bid_priceNo최저가 하한(원)
property_typeNo용도. 예: 아파트, 다세대, 오피스텔, 단독주택, 근린, 토지, 임야, 공장
fail_count_maxNo유찰 횟수 상한. 신건만=0
fail_count_minNo유찰 횟수 하한
new_since_daysNo최근 N일 안에 새로 등록된 물건만(1~90)
property_typesNo용도 여러 개. 예: ['아파트','오피스텔']
max_min_price_ratioNo최저가÷감정가 상한. 예: 0.5 = 감정가의 50% 이하로 떨어진 물건

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed15 schema fields changed
    • addedInput schema / properties / court
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "법원. 예: '수원', '서울중앙', '성남지원'",
      +  "title": "Court"
      +}
    • addedInput schema / properties / exclude_share
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "true 면 지분 매각(지분 경매) 물건을 뺀다",
      +  "title": "Exclude Share"
      +}
    • addedInput schema / properties / fail_count_max
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "유찰 횟수 상한. 신건만=0",
      +  "title": "Fail Count Max"
      +}
    • addedInput schema / properties / good_location
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "true 면 경매레이더 입지 점수 우수 물건만",
      +  "title": "Good Location"
      +}
    • addedInput schema / properties / keyword
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "아파트 단지명·건물명·도로명·지번 일부. 예: '래미안', '헬리오시티', '테헤란로'",
      +  "title": "Keyword"
      +}
    • addedInput schema / properties / max_area
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "전용면적 상한(㎡)",
      +  "title": "Max Area"
      +}
    • addedInput schema / properties / max_min_price_ratio
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "최저가÷감정가 상한. 예: 0.5 = 감정가의 50% 이하로 떨어진 물건",
      +  "title": "Max Min Price Ratio"
      +}
    • addedInput schema / properties / max_pyeong
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "전용면적 상한(평)",
      +  "title": "Max Pyeong"
      +}
    • addedInput schema / properties / min_area
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "전용면적 하한(㎡). 예: 59 (국민평형 84)",
      +  "title": "Min Area"
      +}
    • addedInput schema / properties / min_pyeong
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "전용면적 하한(평). ㎡ 값(min_area)이 있으면 그것을 쓴다",
      +  "title": "Min Pyeong"
      +}
    • addedInput schema / properties / new_since_days
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "최근 N일 안에 새로 등록된 물건만(1~90)",
      +  "title": "New Since Days"
      +}
    • addedInput schema / properties / property_types
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "용도 여러 개. 예: ['아파트','오피스텔']",
      +  "title": "Property Types"
      +}
    • addedInput schema / properties / safe_only
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "true 면 경매레이더 권리 표시가 [안전]인 물건만(위험이 없다는 보장은 아님)",
      +  "title": "Safe Only"
      +}
    • changedInput schema / properties / sort / description
      Previous value: -"'date'(기일 가까운 순, 기본) 또는 'discount'(감정가 대비 많이 떨어진 순)"New value: +"'date'(기일 가까운 순, 기본) · 'discount'(감정가 대비 많이 떨어진 순) · 'value'(추정 시세 대비 저평가 큰 순) · 'quality'(권리·저평가·입지 종합 우량 순)"
    • addedInput schema / properties / undervalued
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "true 면 경매레이더 추정 시세보다 최저가가 낮은(저평가) 물건만",
      +  "title": "Undervalued"
      +}
  2. First observed

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/non-destructive, and the description adds real behavior on top: the 20-result ceiling, the exact result fields (사건번호·위험 사유·상세 링크 등), and an explicit caveat that safe_only is not a risk guarantee. It stays silent on pagination beyond the cap and on how empty results should be read, which keeps it from a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose and dense, but the filter catalogue is essentially a prose restatement of the 25-parameter schema crammed into one long run-on sentence. The pyeong conversion and the no-price-prediction note earn their place; the wholesale condition list is partially redundant.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 25-parameter search with no output schema, the description compensates well by naming the returned fields and the result cap. Minor gaps remain around behavior when the 20-item limit truncates matches and around the meaning of the region shorthand ('수도권'), but nothing an agent needs to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is already 100%, yet the description still adds meaning the schema lacks: the pyeong-to-square-meter mapping (25평형≈전용 59㎡, 34평형≈전용 84㎡), the '신건만 = fail_count_max 0' encoding, and a worked example for the 최저가율 상한 (감정가의 50% 이하). These disambiguate the trickiest of the 25 parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('진행 중인 한국 법원 부동산 경매 물건을 찾는다') plus a hard scope cap (최대 20건) and enumerates what is returned. The closing line '예상낙찰가는 주지 않는다' draws a boundary against a prediction-style sibling, so an agent can tell what this tool is and is not.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete call-shaping guidance: how to express filters (지역·읍면동, 용도 여러 개, 유찰 횟수 범위, 신건만=fail_count_max 0) and an explicit conversion rule for Korean apartment pyeong ('평형으로 물으면 min_area/max_area 로 바꿔 넣는다'). It stops short of naming an alternative tool or saying when to prefer estimate_bid/get_case instead, so routing remains partly inferred.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources