Skip to main content
Glama
mcp-server-subito-scraper

mcp-server-subito-scraper

by pindaroli

Subito.it MCP Server (via Apify)

License: MIT Node.js Model Context Protocol

MCP (Model Context Protocol)-Server basierend auf TypeScript zum Durchsuchen und Scrapen von Anzeigen auf Subito.it unter Verwendung des Apify-Actors azzouzana/subito-scraper-pro-by-search-url.

Sofort ausführbar mit npx auf jedem MCP-kompatiblen Client (Claude Desktop, Cursor, Gemini Antigravity, Windsurf, VS Code usw.).


🌟 Hauptfunktionen

  • 🚀 Ausführung mit npx ohne globale Installation: einsatzbereit mit npx -y mcp-server-subito-scraper.

  • 🇮🇹 Vollständige Unterstützung aller Subito.it-Kategorien: Motori (Autos, Motorräder), Immobili (Verkauf/Miete), Elettronica/Informatica, Telefonia, Arredamento, Lavoro und allgemeiner Marktplatz.

  • 🔍 Intelligente Suche (subito_search): Automatische URL-Generierung mit Filtern für Suchbegriff, Kategorie, Region, Mindest-/Höchstpreis und TuttoSubito-Versand (shp=true).

  • 🔗 Direktes Scraping per URL (subito_scrape_by_url): Füge jede URL mit komplexen Filtern ein, die direkt auf der Website angewendet wurden.

  • 📦 Dataset abrufen (subito_get_dataset_items): Ergebnisse aus zuvor erstellten Apify-Datasets anzeigen und extrahieren.

  • 🔑 Flexible Token-Konfiguration: Über Umgebungsvariable (APIFY_TOKEN), Kommandozeilenparameter (--token) oder direkt im Prompt/Tool.


Related MCP server: OLX MCP Server

🔑 Apify-Token erhalten

  1. Erstelle ein kostenloses Konto auf Apify.com.

  2. Gehe zu Settings > Integrations > API Tokens oder console.apify.com/settings/integrations.

  3. Kopiere deinen Personal API Token (z. B. apify_api_...).


🛠️ Konfiguration in MCP-Clients

1. Claude Desktop

Füge die Konfiguration zur Datei claude_desktop_config.json hinzu:

  • 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"
      }
    }
  }
}

Alternativ, Übergabe des Tokens als CLI-Argument:

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

2. Cursor / Windsurf

In den MCP-Einstellungen des Clients:

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

3. Gemini Antigravity / Agentic IDE

Füge den MCP-Konfigurationsblock im Abschnitt mcpServers hinzu:

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

🧰 Verfügbare Werkzeuge (Tools)

1. subito_search

Erstellt automatisch die Subito-URL und führt den Scraper aus.

Parameter

Typ

Beschreibung

Standard

query

string (erforderlich)

Suchtext (z. B. "MacBook Pro M3", "Vespa 125")

-

category

string (optional)

Kategorie (z. B. "usato", "auto", "moto", "case", "informatica", "telefonia", "arredamento")

"usato"

region

string (optional)

Italienische Region (z. B. "italia", "lombardia", "lazio", "piemonte", "veneto")

"italia"

minPrice

number (optional)

Mindestpreis in Euro

-

maxPrice

number (optional)

Höchstpreis in Euro

-

shippingOnly

boolean (optional)

Nur Anzeigen mit TuttoSubito-Versand filtern

false

sortBy

string (optional)

Sortierung: "datedesc", "priceasc", "pricedesc"

"datedesc"

maxItems

number (optional)

Maximale Anzahl der zu extrahierenden Anzeigen

30

timeoutSecs

number (optional)

Maximales Ausführungs-Timeout in Sekunden

300

token

string (optional)

Apify-Token (überschreibt Umgebungsvariable)

-


2. subito_scrape_by_url

Führt das Scraping basierend auf einer bereits vorbereiteten Such-URL durch.

Parameter

Typ

Beschreibung

Standard

searchUrl

string (erforderlich)

Vollständige Subito.it-Such-URL

-

maxItems

number (optional)

Maximale Anzahl der zu extrahierenden Anzeigen

30

timeoutSecs

number (optional)

Timeout in Sekunden

300

token

string (optional)

Benutzerdefinierter Apify-Token

-


3. subito_get_dataset_items

Ruft die extrahierten Daten aus einem zuvor gespeicherten Apify-Dataset ab.

Parameter

Typ

Beschreibung

Standard

datasetId

string (erforderlich)

ID des Apify-Datasets

-

limit

number (optional)

Anzahl der zu lesenden Elemente

50

offset

number (optional)

Offset für Paginierung

0

token

string (optional)

Apify-Token

-


4. apify_check_status

Überprüft, ob der Apify-Token gültig ist, und zeigt Kontoinformationen an.


💻 Lokale Entwicklung und Kompilierung

Wenn du den Server lokal klonen und bearbeiten möchtest:

# 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

Oder im Entwicklungsmodus mit schnellem Neuladen:

APIFY_TOKEN=tuo_token_qui npm run dev

🚀 Veröffentlichung auf NPM und GitHub

Um das Paket zu veröffentlichen und für alle über npx mcp-server-subito-scraper verfügbar zu machen:

# Esegui il login a npm
npm login

# Pubblica il pacchetto
npm publish --access public

📄 Lizenz

Dieses Projekt wird unter der MIT-Lizenz vertrieben. Siehe die Datei LICENSE für Details.

Haftungsausschluss: Dieser MCP-Server wird nicht offiziell von Subito.it S.r.l. unterstützt, gesponsert oder ist mit diesem verbunden. Eingetragene Marken gehören ihren jeweiligen Eigentümern.

Available Tools

4 tools
apify_check_statusB

Checks the status of the Apify account and validates the API token

Inputs: token.

subito_get_dataset_itemsC

Fetches scraped items from a previously generated Apify dataset ID

Inputs: datasetId (required), limit, token, offset.

subito_scrape_by_urlB

Scrapes classified ads directly from a Subito.it search URL using Apify Actor (azzouzana/subito-scraper-pro-by-search-url)

Inputs: searchUrl (required), token, maxItems, timeoutSecs.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 4 tools

    Disambiguation4/5

    Each tool targets a distinct aspect: scraping by URL vs. by search parameters, checking account status, and retrieving dataset items. There is slight potential confusion between subito_scrape_by_url and subito_search, but their descriptions clarify the difference (URL vs. keyword-based).

    Naming Consistency4/5

    Tool names use a consistent verb_noun pattern with a domain prefix (subito_). Names are descriptive and follow a predictable structure, though subito_search could optionally be subito_search_by_keywords for perfect parallelism with subito_scrape_by_url.

    Tool Count5/5

    Four tools are appropriate for a focused scraping server: two scraping methods, one status check, and one data retrieval tool. Each tool has a clear purpose and no unnecessary bloat.

    Completeness3/5

    The tool surface covers scraping, search, status checking, and data retrieval, but lacks ability to list or manage datasets (e.g., delete old datasets). An agent scraping multiple times may accumulate datasets without cleanup, which is a notable gap.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers