willhaben-mcp

Un servidor MCP que permite a una IA buscar en los anuncios del mercado de willhaben.at y obtener los detalles completos de los anuncios. Envuelve la API de la aplicación móvil de willhaben, obtenida mediante ingeniería inversa, y devuelve los campos importantes a la IA.

Herramientas

search_willhaben(keyword, ...)

Busca en el mercado. keyword es opcional si se pasa una category.

Filtros:

• category (id o nombre)

• condition (nuevo, usado, reacondicionado, ...)

• clothing_size y shoe_size

• color, pattern

• brand

• región, tipo de vendedor, rango de precios, PayLivery, últimas 48 h

• ordenación y paginación

Devuelve una lista recortada de resultados.

get_ad_detail(ad_id)

Todo sobre un anuncio: la descripción completa (sin truncar), todas las imágenes, los atributos detallados, la ruta de categoría y la ubicación exacta. Ejecútalo con un id que hayas obtenido de una búsqueda.

list_categories(query, parent_id)

Busca ids de categoría para el filtro category.

• query: busca en todo el árbol por nombre

• parent_id: navega un nivel hacia abajo (omite ambos para las categorías de nivel superior)

El árbol completo (~3500 categorías) se incluye con el servidor en category-tree.json.

search_brands(category, term)

Las marcas son específicas de cada categoría y hay más de 1000 por categoría, por lo que esto es un autocompletado. Pasa una categoría y un término de búsqueda para obtener los ids de marca coincidentes y luego entrega un id a search_willhaben(brand=...).

Nota: el estado, las tallas, el color, el patrón y la marca dependen de la categoría. Aplicarlos en una categoría amplia puede devolver cero resultados, así que profundiza primero en una subcategoría específica.

Related MCP server: Secondhand MCP

Configuración

pip install -r requirements.txt

Ejecutar

python main.py

El servidor se inicia mediante HTTP de transmisión e imprime dónde está escuchando:

Starting willhaben-mcp server on http://127.0.0.1:8000/mcp

Apunta tu cliente MCP a esa URL. El host, el puerto y la ruta se encuentran en la parte superior de main.py.

Notas

• La API de detalles está protegida por un token de aplicación estático y solo admite HTTP/2. Ambos se gestionan en main.py. Si willhaben rota el token, toma uno nuevo de las cabeceras de solicitud de la aplicación y reemplaza WH_APPLICATION_TOKEN.

• category-tree.json es una instantánea generada del árbol de categorías del mercado de willhaben (id, label, parentId, children). main.py lo carga al inicio para el filtro category y para list_categories. Vuelve a rastrearlo si la taxonomía cambia.

• Los detalles de la API están documentados en search_api.md.

• Esto utiliza la API interna de willhaben, no una oficial. Sé amable con ella.

Aviso legal

Este es un proyecto independiente y no oficial que no está afiliado, respaldado ni conectado con willhaben. "willhaben" y todas las marcas comerciales relacionadas pertenecen a sus respectivos propietarios.

Se publica únicamente con fines educativos y de investigación. Se comunica con la API interna de willhaben, que no está pensada para uso público y puede romperse o cambiar en cualquier momento. Eres responsable de cómo la uses: respeta los Términos de servicio de willhaben, las reglas de robots y la legislación aplicable, y no satures sus servidores ni proceses datos personales de los anuncios. Sin garantía de ningún tipo; úsalo bajo tu propio riesgo.

Si eres titular de derechos y tienes algún problema con este repositorio, abre un issue y responderé con prontitud.

Licencia

MIT LICENSE. Proporcionado "tal cual", sin garantía.