@pipeworx/us-auctions

Текущие лоты аукционов США из обеих частей рынка — примерно 1 900 коммерческих аукционных домов и все доступные источники правительственных излишков, конфискованного имущества и налоговых аукционов — с поиском по ключевому слову, штату или расстоянию от почтового индекса, плюс цены продаж, которые аукционные сайты удаляют после закрытия лота.

Часть Pipeworx — MCP-шлюза, подключающего ИИ-агентов к 1481+ живым источникам данных.

Инструменты

• 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() — количество по каждому источнику, количество открытых торгов, сохранённые comps, время последнего обновления по каждому источнику.

Related MCP server: GovAuctions MCP server

Аутентификация

Вызывающей стороне ключи не нужны. Шлюз при каждом вызове подставляет учётные данные пакета; сам пакет не хранит состояние и не содержит секретов.

Связь с соседними пакетами

• gov-auctions — то же хранилище, отфильтрованное по segment='government'. Держится отдельно, потому что публикуется в npm и MCP Registry под этим более узким контрактом, и тот, кто спрашивает излишки пикапов, не должен получать антиквариат с распродаж имущества.

• gsa-auctions — живой API GSA по федеральным излишкам. Не основан на БД, поэтому его лоты не попадают в это хранилище и здесь не появляются.

Источники данных

Собираются через 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 фиксируется по последнему известному предложению, а коммерческий лот без ставок фиксируется на нуле. Если считать их comps, каждая медиана утаскивается к $0, при том что ответ всё ещё выглядит абсолютно корректным.

• Даты событий — это ЛОКАЛЬНЫЕ КАЛЕНДАРНЫЕ ДАТЫ, а не моменты времени. closes_on / starts_on — даты, потому что HiBid публикует время торгов без часового пояса. closes_at на уровне лота — это настоящий момент времени (полученный из обратного отсчёта), поэтому closing_within_hours опирается на лоты, а us_auction_events — на даты. Не «исправляйте» это разбором локальной строки — это незаметно перенесёт вечерние торги Западного побережья на следующий день.

• Поиск без фильтров — это два запроса, а не один or=. Сортировка по closes_at при OR-объединении closes_at >= now() и closes_at IS NULL не может обслуживаться из индекса, и при самом простом возможном вызове он просканировал весь активный пул и превысил 8-секундный таймаут выполнения запроса — чередуя жёсткую ошибку 500 и молча пустой результат. Разбиение возвращает те же строки в том же порядке.

• Координаты — это центроиды ZIP-кодов. Большинство источников публикуют только ZIP и ничего точнее, поэтому позиция лота — это позиция его города. distance_miles задаётся на уровне города; в ответе это указано, и так должно оставаться.

• Поиск по ключевым словам — сначала полнотекстовый, затем по подстроке. search_tsv (взвешенная сохранённая колонка, миграция 092) выполняет стемминг и охватывает описание; триграммный проход ILIKE выполняется только тогда, когда полнотекстовый поиск ничего не нашёл, потому что в названиях аукционов полно частичных номеров моделей, которые tsquery не может сопоставить внутри слова.

Быстрый старт

Добавьте в ваш MCP-клиент (Claude Desktop, Cursor, Windsurf и т. д.):

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

Что на самом деле предоставляет эта конечная точка

tools/list по адресу https://gateway.pipeworx.io/us-auctions/mcp возвращает инструменты из таблицы выше плюс общие мета-инструменты Pipeworx — ask_pipeworx, discover_tools, search_within, remember/recall и остальной набор уровня шлюза. Так что количество инструментов, которое вы видите, больше, чем в этой таблице: конечная точка одного пакета в настоящее время перечисляет около 30 общих инструментов наряду с собственными инструментами пакета. В ответе initialize соединения указана точная область его действия, и он является авторитетным ответом на конкретный день.

Это сделано намеренно, а не случайное мультиплексирование. Мета-инструменты — это то, что позволяет ограниченному соединению ответить на вопрос, который этот пакет не покрывает — через ask_pipeworx, маршрутизирующий по всему каталогу, — без добавления второго MCP-сервера. Сейчас нет способа подключить конечную точку пакета без них; если дополнительные схемы отнимают у вас больше контекста, чем стоит маршрутизация, подключитесь один раз к полному шлюзу, а не к нескольким конечным точкам пакетов.

Или подключитесь к полному шлюзу 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