@pipeworx/us-auctions

Lotes de subastas de EE. UU. en directo de las dos mitades del mercado — aproximadamente 1.900 casas de subastas comerciales y todas las fuentes accesibles de excedentes gubernamentales, bienes incautados y escrituras por impuestos —, buscables por palabra clave, estado o distancia desde un código postal, además de los precios de venta que los sitios de subastas eliminan cuando un lote se cierra.

Parte de Pipeworx — una puerta de enlace MCP que conecta agentes de IA con 1481+ fuentes de datos en directo.

Herramientas

• us_auctions_search(keyword?, state?, asset_type?, segment?, source?, auction_house?, near_zip?, radius_miles?, max_price?, closing_within_hours?, limit?) — la búsqueda general de lotes. Pasa near_zip y los resultados se devuelven ordenados por distancia, con distance_miles en cada fila.

• us_auctions_closing_soon(...) — el mismo conjunto ordenado por el cierre más próximo, con hours_remaining. Responde a «¿en qué puedo seguir pujando?».

• us_auction_events(state?, keyword?, auction_house?, closes_after?, closes_before?, min_lots?, limit?) — las ventas en sí, no los lotes. «¿Qué subastas hay cerca de mí la próxima semana?».

• us_auction_houses(state?, keyword?, limit?) — qué casas de subastas cubrimos y cuánto tienen en directo cada una, ordenadas por número de lotes. Introduce un nombre de nuevo en las dos herramientas anteriores.

• us_auctions_sold_comps(keyword?, asset_type?, state?, segment?, limit?) — precio realizado mínimo / mediano / medio / máximo, más ejemplos recientes. El factor diferencial.

• us_auctions_coverage() — recuentos por fuente, recuento de ventas abiertas, comparables conservados y hora de última actualización por fuente.

Related MCP server: GovAuctions MCP server

Autenticación

El llamante no necesita clave. La puerta de enlace inyecta las credenciales de datos del pack en cada llamada; el pack en sí no tiene estado y no guarda ningún secreto.

Relación con los packs vecinos

• gov-auctions — la misma tienda filtrada a segment='government'. Se mantiene separado porque se publica en npm y en el MCP Registry bajo ese contrato más restringido, y quien pida pickups excedentes no debe empezar a recibir antigüedades de ventas de herencias.

• gsa-auctions — la API en directo de excedentes federales de la GSA. No está respaldada por una base de datos, así que sus lotes no están en esta tienda y no aparecen aquí.

Fuentes de datos

Recopiladas por workers/auction-scraper (un adaptador por fuente, con cursor reanudado entre ejecuciones de cron). Consulta ese worker para conocer las trampas específicas de cada fuente.

• hibid — comercial. GraphQL, sin autenticación. Alrededor de 1.900 casas de subastas de EE. UU.

• govdeals, allsurplus — excedentes estatales, locales y empresariales. allsurplus también cubre govliquidation.com y go-dove.com, que son el mismo catálogo servido bajo dominios diferentes: no crees adaptadores para esos.

• publicsurplus, bid4assets, irs, txauction — el resto de la mitad gubernamental.

Cosas que la próxima persona tendría que redescubrir por las malas

• Las funciones de agregación y group= están DESACTIVADAS en este proyecto (PGRST123). No existe count(). Los recuentos exactos provienen de Prefer: count=exact y de la cola de Content-Range; el resumen por casa en us_auction_houses se calcula en el pack sobre una extracción acotada de filas, no mediante la base de datos.

• final_price > 0, nunca simplemente not.is.null. El barrido de cierre congela final_price a partir de la última puja conocida, y un lote comercial que no recibió pujas se congela en cero. Contarlos como comparables arrastra todas las medianas hacia $0 mientras la respuesta sigue teniendo un aspecto perfectamente válido.

• Las fechas de los eventos son FECHAS DE CALENDARIO LOCALES, no instantes. closes_on / starts_on son fechas porque HiBid publica las horas de venta sin zona horaria. closes_at a nivel de lote SÍ es un instante real (derivado de una cuenta atrás), por lo que closing_within_hours se basa en los lotes y us_auction_events en las fechas. No «arregles» esto parseando la cadena local: eso mueve silenciosamente las ventas nocturnas de la costa oeste al día siguiente.

• La búsqueda sin filtrar son dos consultas, no un único or=. Ordenar por closes_at mientras se combina closes_at >= now() con closes_at IS NULL mediante OR no puede servirse desde un índice; en la llamada más simple posible escaneó todo el conjunto activo y agotó el tiempo de espera de 8 s de la sentencia, alternando entre un 500 rotundo y un resultado vacío silencioso. La división devuelve las mismas filas en el mismo orden.

• Las coordenadas son centroides de código postal. La mayoría de las fuentes publican un código postal y nada más preciso, así que la posición de un lote es la posición de su localidad. distance_miles es a nivel de localidad; la respuesta lo indica y debería seguir indicándolo.

• La búsqueda por palabras clave es primero de texto completo y después de subcadena. search_tsv (una columna almacenada ponderada, migración 092) aplica la lematización y llega hasta la descripción; el paso de trigramas con ILIKE solo se ejecuta cuando el texto completo no ha encontrado nada, porque los títulos de las subastas están llenos de números de modelo parciales que un tsquery no puede emparejar dentro de una palabra.

Inicio rápido

Añádelo a tu cliente MCP (Claude Desktop, Cursor, Windsurf, etc.):

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

Qué sirve realmente este endpoint

tools/list en https://gateway.pipeworx.io/us-auctions/mcp devuelve las herramientas de la tabla anterior más las meta-herramientas compartidas de Pipeworx — ask_pipeworx, discover_tools, search_within, remember/recall y el resto del conjunto de la puerta de enlace. Por eso el número de herramientas que ves es mayor que el de esta tabla: un endpoint de un solo pack enumera actualmente unas 30 herramientas compartidas junto con las propias del pack. La respuesta initialize de la conexión indica su alcance exacto, y es la respuesta autorizada para un día concreto.

Esto es deliberado, no una multiplexación accidental. Las meta-herramientas son las que permiten a una conexión con alcance acotado responder a una pregunta que este pack no cubre — a través de ask_pipeworx, que enruta por todo el catálogo — sin que tengas que añadir un segundo servidor MCP. Actualmente no hay forma de montar un endpoint de pack sin ellas; si los esquemas adicionales te cuestan más contexto de lo que vale el enrutamiento, conéctate a la puerta de enlace completa una sola vez en lugar de a varios endpoints de pack.

O conéctate a la puerta de enlace completa de Pipeworx para que las herramientas de todos los packs aparezcan listadas directamente, en lugar de solo las de este:

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

Ambas URL llegan a la misma puerta de enlace y a las mismas 1481+ fuentes de datos. La única diferencia es qué herramientas de qué pack están listadas directamente; ask_pipeworx llega a todas desde cualquiera de las dos.

Uso con ask_pipeworx

En lugar de llamar a las herramientas directamente, puedes hacer preguntas en inglés sencillo; esto funciona tanto en el endpoint del pack anterior como en la puerta de enlace completa:

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

La puerta de enlace elige la herramienta adecuada y rellena los argumentos automáticamente.

Más información

• Documentación y guías

• pipeworx.io

Licencia

MIT