@pipeworx/us-auctions

시장의 양쪽 절반에서 실시간 미국 경매 물품(약 1,900개의 상업용 경매업체와 접근 가능한 모든 정부 잉여, 압류 및 세금 체납 재산(tax-deed) 소스)을 키워드, 주(state), ZIP 코드로부터의 거리로 검색할 수 있으며, 경매 사이트가 물품 마감 시 삭제하는 낙찰 가격도 포함됩니다.

Pipeworx의 일부 — AI 에이전트를 1481개 이상의 실시간 데이터 소스에 연결하는 MCP 게이트웨이입니다.

도구

• us_auctions_search(keyword?, state?, asset_type?, segment?, source?, auction_house?, near_zip?, radius_miles?, max_price?, closing_within_hours?, limit?) — 일반적인 물품 검색입니다. near_zip을 전달하면 결과가 거리순으로 정렬되어 각 행에 distance_miles가 포함됩니다.

• us_auctions_closing_soon(...) — 동일한 풀을 마감이 가장 임박한 순서로 정렬하며 hours_remaining을 포함합니다. "아직 입찰할 수 있는 것이 무엇인지"에 답합니다.

• us_auction_events(state?, keyword?, auction_house?, closes_after?, closes_before?, min_lots?, limit?) — 개별 물품이 아니라 경매 자체를 다룹니다. "다음 주에 내 근처에서 어떤 경매가 열리나요" 같은 질문에 답합니다.

• us_auction_houses(state?, keyword?, limit?) — 우리가 다루는 경매업체와 각 업체가 실시간으로 보유한 물품 수를 물품 수 기준으로 정렬해 제공합니다. 이름을 위 두 도구에 다시 입력할 수 있습니다.

• us_auctions_sold_comps(keyword?, asset_type?, state?, segment?, limit?) — 최소/중앙값/평균/최대 실현 가격과 최근 사례를 제공합니다. 차별화 요소입니다.

• us_auctions_coverage() — 소스별 수, 진행 중인 경매 수, 유지 중인 비교 사례 수, 소스별 마지막 새로고침 시각을 제공합니다.

Related MCP server: GovAuctions MCP server

인증

호출자에게는 키가 필요 없습니다. 게이트웨이가 호출마다 팩의 데이터 자격 증명을 주입합니다. 팩 자체는 상태가 없으며 비밀을 보유하지 않습니다.

인접한 팩과의 관계

• gov-auctions — 동일한 저장소를 segment='government'로 필터링한 것입니다. 더 좁은 계약으로 npm과 MCP Registry에 게시되므로 별도로 유지됩니다. 잉여 업트럭을 찾는 호출자가 유산 매각 골동품을 받기 시각해서는 안 되기 때문입니다.

• gsa-auctions — 실시간 GSA 연방 잉여 API입니다. DB 기반이 아니므로 해당 물품은 이 저장소에 없으며 여기에 나다나지 않습니다.

데이터 소스

workers/auction-scraper가 수집합니다(소스당 하나의 어댑터, cron 실행 간 커서 재개 방식). 소스별 주의사항은 해당 워커를 참조하세요.

• hibid — 상업용. GraphQL, 인증 없음. 미국 경매업체 약 1,900곳.

• govdeals, allsurplus — 주/지방 정부 및 기업 잉여 물품. allsurplus는 govliquidation.com 및 go-dove.com도 포함하는데, 이는 서로 다른 도메인으로 제공되는 동일한 카탈로그이므로 해당 사이트용 어댑터를 만들지 마세요.

• publicsurplus, bid4assets, irs, txauction — 정부 절반의 나머지 소스입니다.

다음 사람이 어렵게 다시 발견하게 될 사항들

• 이 프로젝트에서는 집계 함수와 group=이 비활성화되어 있습니다(PGRST123). count()는 존재하지 않습니다. 정확한 수는 Prefer: count=exact와 Content-Range 꼬리에서 얻습니다. us_auction_houses의 업체별 롤업은 데이터베이스가 아니라 팩 내부에서 제한된 행 풀을 대상으로 계산됩니다.

• final_price > 0을 기준으로 해야 하며, 단순히 not.is.null을 사용해서는 안 됩니다. 마감 정리 스윕이 마지막으로 알려진 입찰가로 final_price를 고정하며, 입찰이 하나도 없는 상업용 물품은 0으로 고정됩니다. 이를 비교 사례로 집계하면 응답이 여전히 완벽하게 정상적으로 보이는 동안 모든 중앙값이 $0 쪽으로 끌려갑니다.

• 이벤트 날짜는 인스턴트가 아니라 현지 달력 날짜입니다. closes_on / starts_on은 HiBid가 시간대 없이 판매 시간을 게시하기 때문에 날짜입니다. 물품 수준의 closes_at은 진정한 인스턴트(카운트다운에서 파생)이므로 closing_within_hours는 물품을 기준으로 하고 us_auction_events는 날짜를 기준으로 합니다. 로컬 문자열을 파싱해 이 문제를 "고치지" 마십시오. 그러면 서부 해안 지역의 저녁 판매가 조용히 다음 날로 옮겨갑니다.

• 필터 없는 검색은 하나의 or=가 아니라 두 개의 쿼리입니다. closes_at >= now()를 closes_at IS NULL과 OR로 결합하면서 closes_at으로 정렬하는 것은 인덱스로 처리할 수 없으며, 가장 단순한 호출에서도 전체 활성 풀을 스캔하여 8초 문장 실행 제한 시간을 초과했습니다. 그 결과는 명백한 500 오류와 조용한 빈 결과 사이를 오갔습니다. 분할된 쿼리는 동일한 행을 동일한 순서로 반환합니다.

• 좌표는 ZIP 중심점입니다. 대부분의 소스는 ZIP 코드와 그보다 더 정밀한 정보는 게시하지 않으므로 물품의 위치는 해당 도시의 위치입니다. distance_miles는 도시 수준입니다. 응답에도 그렇게 명시되어 있으며, 계속 명시되어야 합니다.

• 키워드 검색은 full-text를 먼저, 부분 문자열 검색을 그다음에 수행합니다. search_tsv(가중치가 적용된 저장 컬럼, 마이그레이션 092)는 어간을 추출하고 설명까지 검색합니다. trigram ILIKE 패스는 full-text 검색에서 아무것도 찾지 못했을 때만 실행되는데, 경매 제목에는 tsquery가 단어 내부에서 매칭할 수 없는 부분 모델 번호가 가득하기 때문입니다.

빠른 시작

MCP 클라이언트(Claude Desktop, Cursor, Windsurf 등)에 추가하세요:

{
  "mcpServers": {
    "us-auctions": {
      "url": "https://gateway.pipeworx.io/us-auctions/mcp"
    }
  }
}

이 엔드포인트가 실제로 제공하는 것

https://gateway.pipeworx.io/us-auctions/mcp의 tools/list는 위 표의 도구들뿐 아니라 공유 Pipeworx 메타 도구들 — ask_pipeworx, discover_tools, search_within, remember/recall 및 나머지 게이트웨이 전체 세트 — 도 반환합니다. 따라서 표시되는 도구 수는 이 표보다 많습니다. 단일 팩 엔드포인트는 현재 팩 자체 도구와 함께 약 30개의 공유 도구를 나열합니다. 연결의 initialize 응답이 정확한 범위를 명시하며, 특정 시점에 대한 권위 있는 답변입니다.

이는 우연한 멀티플렉싱이 아니라 의도된 설계입니다. 메타 도구 덕분에 범위가 제한된 연결이 두 번째 MCP 서버를 추가하지 않고도 이 팩이 다루지 않는 질문에 — 전체 카탈로그를 라우팅하는 ask_pipeworx를 통해 — 답할 수 있습니다. 현재 메타 도구 없이 팩 엔드포인트를 마운트할 방법은 없습니다. 추가 스키마가 라우팅의 가치보다 더 많은 컨텍스트를 소모한다면 여러 팩 엔드포인트에 연결하는 대신 전체 게이트웨이에 한 번 연결하세요.

또는 전체 Pipeworx 게이트웨이에 연결하면 이 팩 하나만이 아니라 모든 팩의 도구가 직접 나열됩니다:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

두 URL 모두 동일한 게이트웨이와 동일한 1481개 이상의 데이터 소스에 연결됩니다. 유일한 차이는 어떤 팩의 도구가 직접 나열되는지뿐입니다. ask_pipeworx는 어느 쪽에서든 모든 도구에 접근할 수 있습니다.

ask_pipeworx와 함께 사용하기

도구를 직접 호출하는 대신 평이한 영어로 질문할 수 있습니다. 이 기능은 위의 팩 엔드포인트와 전체 게이트웨이 모두에서 작동합니다:

ask_pipeworx({ question: "your question about Us Auctions data" })

게이트웨이가 올바른 도구를 선택하고 인수를 자동으로 채웁니다.

더 보기

• 문서 및 가이드

• pipeworx.io

라이선스

MIT