Skip to main content
Glama

급매 경매 물건

realty_auction_alerts
Read-onlyIdempotent

유찰이 쌓여 최저입찰가가 크게 떨어진 경매 물건을 골라낸다.

유찰이 누적돼 최저입찰가가 크게 떨어진 물건을 찾는다. "○○에서 유찰 많은 물건"은
sido/sigungu로 좁혀라.

유찰이 많다는 건 싸다는 뜻이기도 하지만 권리관계·물건 하자 등 팔리지 않는 이유가
있다는 뜻이기도 하다. 결과를 추천으로 제시하지 말고 확인이 필요한 후보로 제시하라.

**같은 축의 다른 문**: realty_search_auctions(min_bid_count)로도 유찰 물건을 거를 수
있다 — 조건 필터·목록이 목적이면 그쪽, 저감 큰 후보 발굴(극단 할인 컷 포함)이면 이쪽.
둘을 합쳐 세지 마라(같은 물건이 양쪽에 나온다).

Input Schema

NameRequiredDescriptionDefault
sidoNo시도 (예: 세종, 경기도) ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 **한쪽으로 읽지 않고 거절한다**(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라.
limitNo반환 개수 (최대 50) (허용 범위 1~50)
sigunguNo시군구 (예: 강남구, 수원시) ⚠️ 시도 없이 시군구만 주면 **합치지 않고 거절한다**(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다.
usage_nameNo물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. 부분일치라 '빌라'는 '연립주택,다세대,빌라' 행에 걸린다(**표기를 바꾸지 않는다** — '다세대'로 자동 매핑하는 것은 낙찰가율 통계 realty_auction_sale_rate 쪽이다). '토지'는 이 원장에 없는 이름이라 거절된다 — 대지·임야·전답으로 나뉘어 있다. 비우면 전 종류
min_bid_countNo최소 유찰 횟수 (허용 범위 0~100)
max_discount_pctNo감정가 대비 최대 할인율(%) — 80%+ 극단 할인은 지분매각·대지권 없음 등 특수물건이 대부분이라, 실수요 후보를 찾을 땐 79 이하로 걸러라 (허용 범위 0~100)
min_discount_pctNo감정가 대비 최소 할인율(%) (허용 범위 0~100)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / sigungu / description
      Previous value: -"시군구 (예: 강남구, 수원시)"New value: +"시군구 (예: 강남구, 수원시) ⚠️ 시도 없이 시군구만 주면 **합치지 않고 거절한다**(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다."
  2. Changed1 schema field changed
    • changedInput schema / properties / usage_name / description
      Previous value: -"물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. '빌라'는 표준 분류가 아니라 서버가 '다세대'로 매핑하고 그 사실을 응답에 공시한다. 비우면 전 종류"New value: +"물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. 부분일치라 '빌라'는 '연립주택,다세대,빌라' 행에 걸린다(**표기를 바꾸지 않는다** — '다세대'로 자동 매핑하는 것은 낙찰가율 통계 realty_auction_sale_rate 쪽이다). '토지'는 이 원장에 없는 이름이라 거절된다 — 대지·임야·전답으로 나뉘어 있다. 비우면 전 종류"
  3. Changed1 schema field changed
    • changedInput schema / properties / sido / description
      Previous value: -"시도 (예: 세종, 경기도)"New value: +"시도 (예: 세종, 경기도) ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 **한쪽으로 읽지 않고 거절한다**(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라."
  4. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
      -  "additionalProperties": true,
      -  "title": "realty_auction_alertsDictOutput",
      -  "type": "object"
      -}New value: +null
  5. Changed1 schema field changed
    • addedInput schema / properties / usage_name / description
      Added value: +"물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. '빌라'는 표준 분류가 아니라 서버가 '다세대'로 매핑하고 그 사실을 응답에 공시한다. 비우면 전 종류"
  6. Changed4 schema fields changed
    • changedInput schema / properties / limit / description
      Previous value: -"반환 개수 (최대 50)"New value: +"반환 개수 (최대 50) (허용 범위 1~50)"
    • changedInput schema / properties / max_discount_pct / description
      Previous value: -"감정가 대비 최대 할인율(%) — 80%+ 극단 할인은 지분매각·대지권 없음 등 특수물건이 대부분이라, 실수요 후보를 찾을 땐 79 이하로 걸러라"New value: +"감정가 대비 최대 할인율(%) — 80%+ 극단 할인은 지분매각·대지권 없음 등 특수물건이 대부분이라, 실수요 후보를 찾을 땐 79 이하로 걸러라 (허용 범위 0~100)"
    • changedInput schema / properties / min_bid_count / description
      Previous value: -"최소 유찰 횟수"New value: +"최소 유찰 횟수 (허용 범위 0~100)"
    • changedInput schema / properties / min_discount_pct / description
      Previous value: -"감정가 대비 최소 할인율(%)"New value: +"감정가 대비 최소 할인율(%) (허용 범위 0~100)"
  7. Changed3 schema fields changed
    • addedInput schema / properties / max_discount_pct
      Added value: +{
      +  "default": 100,
      +  "description": "감정가 대비 최대 할인율(%) — 80%+ 극단 할인은 지분매각·대지권 없음 등 특수물건이 대부분이라, 실수요 후보를 찾을 땐 79 이하로 걸러라",
      +  "maximum": 100,
      +  "minimum": 0,
      +  "title": "Max Discount Pct",
      +  "type": "integer"
      +}
    • addedInput schema / properties / sido
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "시도 (예: 세종, 경기도)",
      +  "title": "Sido"
      +}
    • addedInput schema / properties / sigungu
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "시군구 (예: 강남구, 수원시)",
      +  "title": "Sigungu"
      +}
  8. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare readOnly/idempotent/non-destructive/openWorld, so the safety profile is covered. The description adds genuine context beyond that: many failed bids signal rights/hazard problems, and results should be framed as candidates needing verification, not recommendations. It does not cover auth needs, rate limits, or result ordering.

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?

The first two sentences are near-duplicates ('유찰이 쌓여 최저입찰가가 크게 떨어진 경매 물건을 골라낸다' vs '유찰이 누적돼 최저입찰가가 크게 떨어진 물건을 찾는다'), which is redundant. The useful routing and caveat content is front-loaded but preceded by that repetition.

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 7-parameter, no-output-schema tool, the description covers purpose, caveats, regional narrowing, and the key sibling distinction. It is largely complete; only return-format nuances (which the schema does not provide) are absent.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3; the schema carries the heavy parameter detail. The description still adds useful guidance by tying sido/sigungu to the region-narrowing use case, slightly above the structured fields.

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: it selects auction properties whose minimum bid price has dropped sharply due to accumulated failed bids. It explicitly names the sibling realty_search_auctions and the axis distinguishing them, so an agent can separate them without opening schemas.

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

Usage Guidelines5/5

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

Gives explicit when-to-use guidance ('조건 필터·목록이 목적이면 그쪽, 저감 큰 후보 발굴이면 이쪽') plus a concrete warning not to combine the two because items overlap. It also instructs how to narrow ('○○에서 유찰 많은 물건' → sido/sigungu).

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.