cardossier-market-api

CarDossier Poland Market API — MCP サーバー

mcp-name: io.github.Joyall-au/cardossier-market-api

CarDossier Market APIを介して、AI アシスタント（Claude、Cursor、Windsurf、およびMCP互換のあらゆるエージェント）にポーランドの中古車市場データへのリアルタイムアクセスを提供するMCP（Model Context Protocol）サーバーです。

できること

このサーバーは、AI エージェントが次のような質問に回答するための5つのツールを公開します。

• 「2019年式のToyota Corollaは、現在ポーランドでいくらくらいですか？」
• 「ディーゼル車のBMWの価格は、過去6か月間で上がっていますか、それとも下がっていますか？」
• 「ポーランドでは中古のVolkswagen Golfはどのくらいの速さで売れますか？」
• 「2020年式のAudi A4は、マゾフシェ県とシロンスク県のどちらが安いですか？」
• 「2018年式のFord Focusにオートマチックトランスミッションを付けると、価格はいくら上がりますか？」

利用可能なツール

ツール	説明	クレジット
get_market_valuation	任意のメーカー／モデル／年式の平均価格、中央値、P25、P75	8
get_price_history	最大24か月分の月次価格推移	10
get_market_liquidity	推定販売日数（車が売れるまでの速さ）	6
get_valuation_factors	トランスミッションの種類、燃料の種類、輸入状況が価格に与える影響	12
get_regional_pricing	ポーランドの全16県の価格比較	8

データソース：ポーランドを代表する自動車マーケットプレイスの有効な掲載情報140万件以上。毎日更新されます。

車名は自動的に解決されます — VW Golf、BMW 3 Series / 320d、Mercedes C-Class、Audi A4、XC60などに対応しています。レスポンスには、集計対象となったマーケットプレイス上のモデルが正確に表示されます。失敗した呼び出しは自動的に返金されます。

🚀 キーなしで試す

APIでは、実際のデータを使った1 IPアドレスあたり1日5回のキー不要デモ呼び出しを利用できるため、このサーバーはインストール後すぐに動作します。

pip install cardossier-mcp-server
cardossier-mcp

利用枠を増やすには、無料登録してください。メールOTPで50クレジットを取得できます。クレジットカードは不要です。その後、CARDOSSIER_API_KEYを設定してください。

前提条件

• Python 3.9+
• 任意：CarDossier APIキー — 無料登録して50クレジットを無料で取得できます（クレジットカード不要）。または、5,000クレジットで49ドルからの有料パッケージを購入できます。

インストール

# From PyPI (recommended)
pip install cardossier-mcp-server

# Or from source
git clone https://github.com/Joyall-au/cardossier-mcp-server.git
cd cardossier-mcp-server
pip install mcp requests

使い方

1. APIキーを設定（任意）

export CARDOSSIER_API_KEY="your_api_key_here"   # omit to use the keyless demo tier

2. サーバーを起動

cardossier-mcp
# or from a source checkout: python mcp_server.py

3. Claude Desktopに接続

以下をClaude Desktopの設定ファイルに追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "cardossier": {
      "command": "cardossier-mcp",
      "env": {
        "CARDOSSIER_API_KEY": "your_api_key_here"
      }
    }
  }
}

4. CursorまたはWindsurfに接続

MCP設定に追加します。

{
  "cardossier": {
    "command": "cardossier-mcp",
    "env": {
      "CARDOSSIER_API_KEY": "your_api_key_here"
    }
  }
}

やり取りの例

接続後、AI アシスタントに次のように質問できます。

「2020年式のディーゼル車のBMW 3 Seriesは、ポーランドで現在いくらくらいですか？」

エージェントはmake=BMW, model=3 Series, year=2020, fuel_type=dieselを指定してget_market_valuationを呼び出し、価格の統計分布を返します。

「Toyota Corollaの価格が過去1年間でどう変化したか教えてください」

エージェントはmonths=12を指定してget_price_historyを呼び出し、月次の価格推移を返します。

「ポーランドの地域ごとに中古のSkoda Octaviaの価格を比較してください」

エージェントはget_regional_pricingを呼び出し、県ごとの内訳を返します。

APIリファレンス

APIドキュメント全文：car-dossier.com/en/api/docs
OpenAPI 3.1仕様：car-dossier.com/openapi.yaml
FAQ：car-dossier.com/en/api/faq/

料金

CarDossier Market API は、従量課金制のクレジットシステムを採用しています。クレジットに有効期限はありません。

無料トライアル： car-dossier.com/en/api/pricing で登録すると、50 クレジットをすぐに受け取れます。クレジットカードは不要です。市場価格の査定リクエストを約 6 回利用できます。

パッケージ	料金	クレジット	査定リクエストの目安
無料トライアル	$0	50	約 6 回
Starter	$49	5,000	約 625 回
Growth	$129	15,000	約 1,875 回
Pro	$299	40,000	約 5,000 回
Business	$699	100,000	約 12,500 回

無料で始める — 50 クレジットを獲得 →

ライセンス

MIT License — 詳細は LICENSE をご覧ください。

概要

CarDossier が開発。ポーランドを代表する車両履歴・市場データプラットフォームです。