willhaben-mcp

willhaben.at のマーケットプレイス出品をAIが検索し、広告の詳細情報を取得できるMCPサーバーです。willhabenのリバースエンジニアリングされたモバイルアプリAPIをラップし、重要なフィールドをAIに返します。

ツール

search_willhaben(keyword, ...)

マーケットプレイスを検索します。category を渡す場合、keyword は任意です。

フィルター:

• category（IDまたは名前）

• condition（新品、中古、再生品など）

• clothing_size と shoe_size

• color、pattern

• brand

• 地域、出品者タイプ、価格帯、PayLivery、過去48時間

• 並び順とページネーション

絞り込まれたヒットリストを返します。

get_ad_detail(ad_id)

1件の広告に関するすべての情報: 完全な（切り詰められていない）説明、すべての画像、項目別の属性、カテゴリパス、正確な場所。検索で取得したIDに対して実行します。

list_categories(query, parent_id)

category フィルター用のカテゴリIDを検索します。

• query: ツリー全体を名前で検索

• parent_id: 1階層下を閲覧（両方省略するとトップレベルカテゴリ）

完全なツリー（約3500カテゴリ）はサーバーに同梱され、category-tree.json に格納されています。

search_brands(category, term)

ブランドはカテゴリ固有で、カテゴリごとに1000以上あるため、これはタイプアヘッドです。カテゴリと検索語を渡して一致するブランドIDを取得し、そのIDを search_willhaben(brand=...) に渡します。

注: condition、サイズ、色、パターン、ブランドはカテゴリに依存します。広いカテゴリでこれらを適用するとヒット数がゼロになることがあるため、まず特定のサブカテゴリに絞り込んでください。

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

MCPクライアントをそのURLに向けてください。ホスト、ポート、パスは main.py の先頭にあります。

注記

• 詳細APIは静的アプリトークンで保護され、HTTP/2のみをサポートしています。どちらも main.py で処理されます。willhabenがトークンをローテーションした場合は、アプリのリクエストヘッダーから新しいものを取得し、WH_APPLICATION_TOKEN を置き換えてください。

• category-tree.json はwillhabenのマーケットプレイスカテゴリツリー（id、label、parentId、children）の生成済みスナップショットです。main.py は起動時にこれを読み込み、category フィルターと list_categories に使用します。分類体系が変更された場合は再クロールしてください。

• APIの詳細は search_api.md に文書化されています。

• これはwillhabenの内部APIを使用しており、公式のものではありません。丁寧に扱ってください。

免責事項

これは独立した非公式のプロジェクトであり、willhabenとは提携、承認、または関連していません。「willhaben」および関連するすべての商標は、それぞれの所有者に帰属します。

教育および研究目的でのみ公開されています。これはwillhabenの内部APIと通信するもので、一般公開を意図しておらず、いつでも壊れたり変更されたりする可能性があります。使用方法については自己責任です: willhabenの利用規約、robotsルール、適用される法律を尊重し、サーバーに過剰な負荷をかけたり、出品から個人データを処理したりしないでください。いかなる保証もありません。自己責任で使用してください。

権利者でこのリポジトリについて懸念がある場合は、issueを開いてください。迅速に対応します。

ライセンス

MIT LICENSE。「現状のまま」提供され、保証はありません。