carsensor Price Range MCP Server для AI-агентов

Если вы создаёте AI-агента, чат-бота или приложение, которому нужно ответить на вопрос «является ли запрашиваемая цена подержанного автомобиля справедливой?» — не догадку, а число, основанное на реальных рыночных данных, — этот MCP-сервер даёт вам именно это одним вызовом инструмента. resolvePriceRange(carModel, year) возвращает диапазон рыночных цен (min / max / median), вычисляемый в реальном времени на основе официальной статистики цен по моделям и годам с carsensor.net — тех же данных, которые carsensor публикует на своих страницах 相場 (рыночная цена), преобразованных в структурированное, готовое к использованию число, а не страницу, которую вам пришлось бы читать и интерпретировать самостоятельно.

Что вы получаете:

• Один инструмент, resolvePriceRange, принимающий только название модели автомобиля и год — никаких ключей API для управления базовым источником данных, никакого HTML для самостоятельного парсинга

• priceRangeYen: { min, max, median } плюс sampleSize (сколько реальных объявлений carsensor лежит в основе оценки) и confidence (normal / low — честно пониженный, а не скрытый, когда год не может быть полностью проверен по собственным данным carsensor; см. «Известные ограничения»)

• Постоянный хостинг через Apify Standby mode — никакого сервера для самостоятельного запуска. Подключайте любой MCP-клиент (Claude Desktop, Claude Code, своего собственного агента) напрямую к стабильному HTTPS-адресу или вызывайте его как обычный Streamable HTTP MCP-сервер из кода вашего приложения

{
  "ok": true,
  "carModel": "プリウス",
  "year": 2018,
  "priceRangeYen": { "min": 750000, "max": 4772500, "median": 1573112 },
  "sampleSize": 412,
  "confidence": "normal",
  "disclaimer": "carsensor.net上の公開情報(相場ページの価格×年式集計)を基にした参考値です。個体差・装備差・実際の商談結果は反映されません。"
}

Оплата за событие — см. «Цены» ниже. Полные детали ввода/вывода, настройка и техническое описание приведены ниже на этой странице.

⚠️ Отказ от ответственности (пожалуйста, прочтите)

• Этот Actor автоматически получает информацию, которая публично доступна на carsensor.net. Вы несёте ответственность за то, как вы получаете и используете эти данные.

• Условия использования владельца сайта, robots.txt или блокировка доступа могут измениться без предварительного уведомления, что может привести к прекращению работы этого Actor или непредвиденному изменению его вывода.

• priceRangeYen — это статистическая оценка, полученная на основе собственных опубликованных агрегированных данных carsensor по ценам × модельным годам, а не гарантия реальной стоимости конкретного автомобиля. Она не учитывает состояние, комплектацию/класс или пробег (см. «Известные ограничения»). Всегда проверяйте цену конкретного автомобиля на самом carsensor.net перед принятием любого решения о покупке или продаже на основе этих данных.

Для кого это?

• AI-агенты и чат-боты, которым нужно обосновать ответ на вопрос «сколько это на самом деле стоит?» реальными рыночными данными, а не собственными (часто устаревшими или выдуманными) знаниями модели о ценах на подержанные автомобили

• Разработчики приложений/инструментов, создающие функции покупки автомобилей, оценки стоимости или расчёта trade-in, которые хотят получить готовый поиск ценового диапазона вместо того, чтобы самостоятельно парсить и поддерживать интеграцию с carsensor.net

• Все, кто хочет получить это как обычный вызов MCP-инструмента, а не пакетный скрапинг — этот Actor является одноинструментным, вызываемым по требованию аналогом нашего пакетного Actor carsensor-resale-value-scout (который оценивает целые списки объявлений на основе тех же рыночных данных)

Что он не может делать (пожалуйста, прочтите перед интеграцией)

• Пробег пока не поддерживается как входной параметр. Используются только модель автомобиля и год — ценовой диапазон отражает собственный агрегат carsensor по модельным годам, а не оценку с поправкой на пробег. В будущей версии это может быть добавлено.

• Разрешение названия модели иногда может давать сбой или быть медленным при первом использовании для незнакомой модели — см. «Известные ограничения» для объяснения и того, как кэширование смягчает эту проблему после первого вызова.

• Это статистическая оценка, а не экспертная оценка. См. Отказ от ответственности выше.

Ввод / Вывод

Ввод (аргументы вызова MCP-инструмента):

Вывод (успех):

Вывод (модель не найдена / нет данных для этого года): { "ok": false, "reason": "no_code_resolved" | "no_matching_data", "message": "..." } — не тарифицируется (см. «Цены»).

Пример использования

Claude Desktop / конфигурация любого MCP-клиента:

{
  "mcpServers": {
    "carsensor-price-range": {
      "url": "https://woolen-snake--carsensor-price-range-mcp.apify.actor/mcp",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

Прямой вызов из вашего приложения (Node.js, @modelcontextprotocol/sdk):

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const transport = new StreamableHTTPClientTransport(
  new URL('https://woolen-snake--carsensor-price-range-mcp.apify.actor/mcp'),
  { requestInit: { headers: { Authorization: `Bearer ${process.env.APIFY_TOKEN}` } } },
);
const client = new Client({ name: 'my-app', version: '1.0.0' });
await client.connect(transport);

const result = await client.callTool({
  name: 'resolvePriceRange',
  arguments: { carModel: 'プリウス', year: 2018 },
});
console.log(JSON.parse(result.content[0].text));

Цены

Фиксированная цена независимо от того, был ли вызов обслужен из кэша или вызвал новый запрос к carsensor.net — см. «Как была установлена цена» ниже для полного обоснования, включая то, почему многоуровневая тарификация по кэшу была сознательно отклонена.

Как была установлена цена

$0.03 находится между базовым уровнем классификации этого семейства Actor ($0.015, например, listing-extracted на нашем Actor carsensor-resale-value-scout) и его более тяжёлым уровнем производных сигналов ($0.045–$0.065, например, value-score-computed) — что отражает тот факт, что ценовой диапазон является вычисленным рыночным сигналом, а не простым получением данных, в то время как базовые затраты на инфраструктуру этого инструмента (значительно меньше $0.001/вызов, большинство вызовов обслуживается из кэша) оставляют большой запас в любом случае.

Почему попадания и промахи кэша тарифицируются одинаково: ценность, которую вы получаете — priceRangeYen, sampleSize, confidence — идентична в обоих случаях; кэширование — это чисто внутренняя оптимизация производительности/затрат, а не разница в том, что вы получаете. Разная тарификация также создала бы извращённый стимул сокращать TTL кэша (больше промахов = больше дохода), что прямо противоречит цели этого инструмента — минимизировать нагрузку на carsensor.net.

Источник данных и расчёт

Использует собственную публично опубликованную страницу 相場 (рыночная цена) carsensor.net для определённой модели (/usedcar/souba/{makerCode}_S{modelCode}/), в частности её перекрёстную таблицу «цена × модельный год» (ценовой диапазон, диапазон лет, количество объявлений в каждой ячейке) — официальные агрегированные данные, которые сам carsensor вычисляет из своего собственного живого инвентаря, а не сторонняя оценка.

• median — это средневзвешенное по количеству значение середины ценового диапазона каждого соответствующего диапазона лет

• min / max берутся из фактических границ ценовых диапазонов соответствующих ячеек (открытые диапазоны, например, «¥4,150,000 или более», аппроксимируются эвристикой ±15% — эмпирическая корректировка, а не статистически выведенная)

• Это агрегированные данные по классу (например, все комплектации Toyota Prius вместе), а не цены отдельных объявлений — они не учитывают различия в комплектации/классе, оборудовании или состоянии

Кэширование (2 уровня)

Попадание в кэш на обоих уровнях означает ноль HTTP-запросов к carsensor.net для этого вызова. В версии, размещённой на Apify, этот кэш ограничен одним запуском/экземпляром контейнера Standby — параллельные сеансы могут попадать на разные экземпляры контейнера с независимыми кэшами, поэтому реальный уровень попаданий в размещённой версии может быть ниже, чем в одном долго работающем локальном процессе. Будущая версия может перенести это в Key-Value Store Apify (общий для всех запусков), если это окажется важным на практике.

Интервал доступа и журналирование

Запросы к carsensor.net выполняются с минимальным интервалом 1000 мс (по умолчанию 1500 мс) как мера снижения нагрузки — тот же минимум, который используется в нашем Actor carsensor-resale-value-scout. Каждый вызов журналируется (модель, год, попадание/промах кэша по уровням, фактически выполненные HTTP-запросы, время ответа, результат) для будущего мониторинга — не раскрывается вызывающим сторонам, используется только для ответственной эксплуатации этого Actor.

FAQ

Почему confidence иногда равен "low"? Ось годов carsensor имеет открытый нижний диапазон в своих собственных данных (например, «2012 или ранее»). Любой год на этой границе или раньше будет соответствовать ему, независимо от того, существовала ли модель на самом деле в этом году — нет способа полностью проверить правдоподобие только по этим данным, поэтому confidence честно понижается, а не сообщается как определённый. См. поле note в таких ответах для конкретной причины.

Почему мой первый вызов для данной модели занимает несколько секунд, а повторные вызовы намного быстрее? Первый вызов для незнакомой модели требует до 3 реальных запросов к carsensor.net (поиск → страница деталей → страница рыночных цен), чтобы определить, что это за модель. После определения сопоставление модель→код кэшируется практически навсегда, а сами данные о ценах кэшируются на 12 часов — поэтому повторные вызовы для той же модели выполняются почти мгновенно.

Учитывается ли пробег? Пока нет — см. «Что он не может делать».

Чем это отличается от carsensor-resale-value-scout? Этот Actor — пакетный скрапер: дайте ему поисковый запрос, получите список живых объявлений, каждое из которых оценено на основе тех же рыночных данных. Этот Actor — одноразовый, вызываемый по требованию аналог, созданный для AI-агентов и приложений, которым нужно одно число для одной модели/года, а не список для скрапинга и обработки.

Известные ограничения

• Разрешение имени модели не выполняется прямым поиском — оно проходит через собственный freeword search carsensor и читает страницу подходящего объявления для определения модели. Для действительно нераспознанной модели (опечатка, несуществующая модель) страница результатов поиска carsensor всё равно содержит виджет «you might also like» с посторонними автомобилями; этот Actor явно обнаруживает и исключает этот виджет, чтобы он не был принят за реальное совпадение — подтверждено живым тестированием.

• confidence не может полностью проверить, правдоподобен ли запрошенный год для данной модели — см. FAQ.

• Это агрегат на уровне грейда, а не цена отдельного объявления — см. «Data source and calculation».

• Файловый кэш является отдельным для каждого контейнера в хостируемой (Apify Standby) версии — см. «Caching».

• Базовая логика скрейпинга этого инструмента намеренно продублирована из кодовой базы carsensor-resale-value-scout, а не импортирована из неё, чтобы два независимо развёрнутых Actor'а оставались развязанными. Изменение разметки carsensor.net, затрагивающее один из них, может потребовать соответствующего исправления в другом.

• Не указан в Smithery: ответ аутентификации Apify Standby не соответствует OAuth-discovery, что ломает автоматическое сканирование подключения Smithery ещё до того, как оно дойдёт до собственной аутентификации на основе конфигурации этого сервера — обходной путь пока не планируется.

Возможные будущие расширения (не реализованы в этой версии)

• Пробег как третий входной параметр, с использованием матрицы цена×пробег carsensor (подтверждено, что данные доступны для получения, но пока не подключено)

• Перенос кэша в Key-Value Store Apify, чтобы он был общим для всех экземпляров контейнеров Standby

• Размещение в дополнительных каталогах MCP помимо Apify Store