willhaben-mcp

Сервер MCP, который позволяет ИИ искать объявления на willhaben.at и получать полные детали объявлений. Он оборачивает обратно разработанный API мобильного приложения willhaben и возвращает ИИ только важные поля.

Инструменты

search_willhaben(keyword, ...)

Поиск по площадке. keyword необязателен, если вы передаёте category.

Фильтры:

• category (id или название)

• condition (новое, б/у, восстановленное, ...)

• clothing_size и shoe_size

• color, pattern

• brand

• регион, тип продавца, диапазон цен, PayLivery, последние 48 часов

• сортировка и пагинация

Возвращает сокращённый список результатов.

get_ad_detail(ad_id)

Вся информация об одном объявлении: полное (не сокращённое) описание, все изображения, детальные атрибуты и точное местоположение. Запускайте с id, полученным из поиска.

list_categories(query, parent_id)

Поиск id категорий для фильтра category.

• query: поиск по всему дереву категорий по названию

• parent_id: просмотр на один уровень вниз (опустите оба параметра, чтобы получить верхний уровень)

Полное дерево (~3500 категорий) поставляется вместе с сервером в файле category-tree.json.

search_brands(term, category)

Бренды привязаны к категориям, и их более 1000 на каждую категорию, поэтому это поиск по мере ввода. Передайте категорию и поисковый запрос, чтобы получить подходящие id брендов, а затем передайте id в search_willhaben(brand=...).

Примечание: состояние, размеры, цвет, узор и бренд зависят от категории. Применение их в широкой категории может не дать результатов, поэтому сначала уточните категорию.

Related MCP server: Secondhand MCP

Настройка

pip install -r requirements.txt

Запуск

python main.py

Сервер запускается через потоковый HTTP и выводит адрес, по которому он слушает:

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

Укажите URL вашего MCP-клиента. Хост, порт и путь указаны вверху файла main.py.

Примечания

• API деталей защищён статическим токеном приложения и работает только по HTTP/2. Всё это обрабатывается в main.py. Если willhaben сменит токен, возьмите новый из заголовков запросов их приложения и замените WH_APPLICATION_TOKEN.

• category-tree.json — это сгенерированный снимок дерева категорий willhaben (id, название, parentId, дети). main.py загружает его при запуске для фильтра category и list_categories. Если таксономия изменится, обойдите дерево заново.

• Детали API описаны в search_api.md.

• Здесь используется внутренний API willhaben, а не официальный. Относитесь к нему бережно.

Отказ от ответственности

Это независимый неофициальный проект, не связанный с willhaben и не поддерживаемый им. Товарный знак «willhaben» и все связанные товарные знаки принадлежат их правообладателям.

Проект опубликован в образовательных и исследовательских целях. Он обращается к внутреннему API willhaben, который не предназначен для публичного использования и может измениться или перестать работать в любой момент. Вы несёте ответственность за то, как вы его используете: соблюдайте Условия предоставления услуг willhaben, правила для роботов и действующее законодательство, не перегружайте их серверы и не обрабатывайте персональные данные из объявлений. Никаких гарантий; используйте на свой страх и риск.

Если вы являетесь правообладателем и у вас есть претензии к этому проекту, пожалуйста, откройте issue, и я оперативно отвечу.

Лицензия

ЛИЦЕНЗИЯ MIT. Предоставляется «как есть», без каких-либо гарантий.