Subito.it MCP Server (через Apify)

MCP (Model Context Protocol) сервер на TypeScript для поиска и парсинга объявлений с Subito.it с использованием Apify Actor azzouzana/subito-scraper-pro-by-search-url.

Запускается мгновенно с помощью npx на любом клиенте, совместимом с MCP (Claude Desktop, Cursor, Gemini Antigravity, Windsurf, VS Code и др.).

🌟 Основные возможности

• 🚀 Запуск через npx без глобальной установки: готов к использованию с npx -y mcp-server-subito-scraper.

• 🇮🇹 Полная поддержка всех категорий Subito.it: Авто (автомобили, мотоциклы), Недвижимость (продажа/аренда), Электроника/IT, Телефония, Мебель, Работа и общий Marketplace.

• 🔍 Умный поиск (subito_search): Автоматически генерирует URL с фильтрами по запросу, категории, региону, минимальной/максимальной цене и доставке TuttoSubito (shp=true).

• 🔗 Парсинг по прямому URL (subito_scrape_by_url): Вставьте любой URL с применёнными на сайте сложными фильтрами.

• 📦 Получение датасета (subito_get_dataset_items): Просматривайте и извлекайте результаты из ранее созданных датасетов Apify.

• 🔑 Гибкая настройка токена: Через переменную окружения (APIFY_TOKEN), параметр командной строки (--token), или непосредственно в запросе/инструменте.

Related MCP server: MCP Apify

🔑 Получение токена Apify

1. Создайте бесплатную учётную запись на Apify.com.

2. Перейдите в Settings > Integrations > API Tokens или на console.apify.com/settings/integrations.

3. Скопируйте ваш Personal API Token (например, apify_api_...).

🛠️ Настройка в клиентах MCP

1. Claude Desktop

Добавьте конфигурацию в файл claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "subito-scraper": {
      "command": "npx",
      "args": ["-y", "mcp-server-subito-scraper"],
      "env": {
        "APIFY_TOKEN": "IL_TUO_TOKEN_APIFY_QUI"
      }
    }
  }
}

В качестве альтернативы, передав токен как аргумент CLI:

{
  "mcpServers": {
    "subito-scraper": {
      "command": "npx",
      "args": ["-y", "mcp-server-subito-scraper", "--token", "IL_TUO_TOKEN_APIFY_QUI"]
    }
  }
}

2. Cursor / Windsurf

В настройках MCP клиента:

{
  "subito-scraper": {
    "command": "npx",
    "args": ["-y", "mcp-server-subito-scraper"],
    "env": {
      "APIFY_TOKEN": "IL_TUO_TOKEN_APIFY_QUI"
    }
  }
}

3. Gemini Antigravity / Agentic IDE

Добавьте блок конфигурации MCP в секцию mcpServers:

{
  "mcpServers": {
    "subito-scraper": {
      "command": "npx",
      "args": ["-y", "mcp-server-subito-scraper"],
      "env": {
        "APIFY_TOKEN": "IL_TUO_TOKEN_APIFY_QUI"
      }
    }
  }
}

🧰 Доступные инструменты

1. subito_search

Автоматически формирует URL Subito и запускает парсер.

2. subito_scrape_by_url

Выполняет парсинг по уже готовому прямому URL поиска.

3. subito_get_dataset_items

Извлекает данные из ранее сохранённого датасета Apify.

4. apify_check_status

Проверяет, действителен ли токен Apify, и показывает информацию об аккаунте.

💻 Локальная разработка и сборка

Если вы хотите клонировать и изменить сервер локально:

# 1. Clona il repository
git clone https://github.com/pindaroli/mcp-server-subito-scraper.git
cd mcp-server-subito-scraper

# 2. Installa le dipendenze
npm install

# 3. Compila il codice TypeScript
npm run build

# 4. Esegui in modalità test
APIFY_TOKEN=tuo_token_qui npm start

Или в режиме разработки с быстрой перезагрузкой:

APIFY_TOKEN=tuo_token_qui npm run dev

🚀 Публикация на NPM и GitHub

Чтобы опубликовать пакет и сделать его доступным для всех через npx mcp-server-subito-scraper:

# Esegui il login a npm
npm login

# Pubblica il pacchetto
npm publish --access public

📄 Лицензия

Этот проект распространяется под лицензией MIT. См. файл LICENSE для подробностей.

Отказ от ответственности: Данный сервер MCP не связан, не спонсируется и не поддерживается официально Subito.it S.r.l. Товарные знаки принадлежат их владельцам.