MCP Market Russia API

Каталог строительных компаний и проектов домов России для AI-агентов, аналитиков и разработчиков

3 395+ компаний140+ проектов21 MCP Tool19 REST API6 AI-эндпоинтов
Быстрый стартТарифыЭндпоинтыПопробоватьАвторизацияОшибкиMCP

Быстрый старт

Начните за 3 шага

1

Зарегистрируйте API-ключ

POST-запрос для бесплатного ключа

# Регистрация curl -X POST http://212.193.27.12:8000/api/register \ -H "Content-Type: application/json" \ -d '{"name": "Иван", "email": "ivan@example.com"}'
2

Получите ключ

API вернёт уникальный ключ

{"api_key": "mcp_free_a1b2c3...", "plan": "free", "requests_limit": 100}
3

Делайте запросы

Передавайте ключ в параметре api_key

# Поиск компаний curl "http://212.193.27.12:8000/api/v1/search/companies?q=каркас&api_key=ВАШ_КЛЮЧ" # AI-рекомендации (Pro+) curl "http://212.193.27.12:8000/api/v1/ai/recommend?budget=5000000&api_key=ВАШ_КЛЮЧ"

Тарифные планы

Выберите подходящий план

Free

Для знакомства

0 ₽ /мес
  • 100 запросов/мес
  • Поиск компаний и проектов
  • Категории и регионы
  • Базовая статистика
  • Сравнение компаний

Starter

Для аналитиков

2 990 ₽ /мес
  • 5 000 запросов/мес
  • Всё из Free
  • Аналитика рынка
  • Лучшие компании
  • Сравнение цен
  • Аналитический отчёт

Pro

Для AI-разработчиков

7 990 ₽ /мес
  • 50 000 запросов/мес
  • Всё из Starter
  • AI-анализ отзывов
  • AI-рекомендации
  • Оценка стоимости
  • Тренды рынка
  • Глубокий профиль
  • Сравнение регионов

Enterprise

Крупный бизнес

По запросу
  • Безлимит запросов
  • Всё из Pro
  • Выделенный сервер
  • SLA 99.9%
  • Персональная поддержка

API Эндпоинты

Полный список методов

Поиск Free

GET/api/v1/search/companiesПоиск компаний
ПараметрТипОписание
qstringПоисковый запрос
regionstringФильтр по региону
categorystringФильтр по категории
limitintКол-во (по умолч. 20)
GET/api/v1/search/projectsПоиск проектов домов
ПараметрТипОписание
qstringПоисковый запрос
min_pricefloatМин. цена
max_pricefloatМакс. цена

Компании Free

GET/api/v1/companiesСписок компаний с пагинацией
ПараметрТипОписание
limitintКол-во (макс 100)
offsetintСмещение
regionstringРегион
GET/api/v1/companies/{id}Информация о компании (UUID)

Рыночные данные Free

GET/api/v1/categoriesКатегории строительства
GET/api/v1/regionsРегионы присутствия
GET/api/v1/statsОбщая статистика
GET/api/v1/compareСравнение компаний
ПараметрТипОписание
ids requiredstringUUID через запятую

Аналитика Starter+

GET/api/v1/analytics/marketОбзор рынка
ПараметрТипОписание
regionstringРегион
categorystringКатегория
GET/api/v1/analytics/best-companiesРейтинг лучших
GET/api/v1/analytics/price-comparisonСравнение цен
GET/api/v1/analytics/reportАналитический отчёт

AI-инструменты Pro+

GET/api/v1/ai/reviewsAI-анализ отзывов
ПараметрТипОписание
company_idUUIDID компании

sentiment, reliability_score, review_summary, red_flags

GET/api/v1/ai/recommendAI-подбор подрядчиков
ПараметрТипОписание
budgetfloatБюджет (руб)
regionstringРегион
categorystringТип строительства
GET/api/v1/ai/estimateОценка стоимости
ПараметрТипОписание
areafloatПлощадь (кв.м)
regionstringРегион
materialstringМатериал
GET/api/v1/ai/trendsТренды рынка
GET/api/v1/ai/deep-profileГлубокий профиль компании
GET/api/v1/ai/region-compareСравнение регионов

Аккаунт

POST/api/registerРегистрация API-ключа

JSON body:

ПолеТипОписание
name requiredstringВаше имя
email requiredstringEmail

Попробуйте API

Отправьте запрос прямо из браузера

Интерактивная песочница

Авторизация

Как использовать API-ключ

Передача ключа

Параметр api_key в URL:

GET /api/v1/search/companies?q=test&api_key=mcp_free_abc123

Лимиты

ПланЛимитДоступ
Free100/месSearch, Companies, Market Data
Starter5 000/мес+ Analytics
Pro50 000/мес+ AI Tools
EnterpriseБезлимитВсе + SLA

Коды ошибок

Стандартные ответы

КодОшибкаОписание
401invalid_api_keyНеверный ключ
403plan_upgrade_requiredНужен более высокий план
429rate_limit_exceededПревышен лимит
404not_foundНе найдено
{"error": "plan_upgrade_required", "required_plan": "starter", "upgrade_info": "Starter: 2990 руб/мес"}

MCP для AI-агентов

Подключите к Claude, GPT или другому AI-агенту через Model Context Protocol

21 инструмент через MCP streamable-http transport:

search_companies, search_projects, get_company, get_project, get_categories, get_regions, get_stats, compare_companies, calculate_cost, request_quote, market_analytics, find_best_companies, price_comparison, company_portfolio, market_report, review_analysis, contractor_recommendation, project_estimator, trend_analyzer, company_deep_profile, region_comparison

Endpoint

https://mcp-market.ru/mcp/

Подключение из Claude Desktop

{"mcpServers": {"mcp-market-russia": {"url": "https://mcp-market.ru/mcp/"}}}

Прямой JSON-RPC (curl)

1. initialize — получить session ID:

curl -i -X POST https://mcp-market.ru/mcp/ \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}' # ответ содержит header: mcp-session-id: <sid>

2. notifications/initialized — подтвердить готовность:

curl -X POST https://mcp-market.ru/mcp/ \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Mcp-Session-Id: <sid>" \ -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

3. tools/list — получить список 21 инструмента:

curl -X POST https://mcp-market.ru/mcp/ \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Mcp-Session-Id: <sid>" \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

4. tools/call — вызвать инструмент (пример: поиск компаний):

curl -X POST https://mcp-market.ru/mcp/ \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Mcp-Session-Id: <sid>" \ -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_companies","arguments":{"query":"забор","limit":3}}}'
Важно: ответы возвращаются как Server-Sent Events (text/event-stream). Парсите строку, начинающуюся с data: , как JSON. Header Mcp-Session-Id обязателен для всех запросов после initialize.