Subito.it MCP Server (via Apify)

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: MCP Apify

🔑 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.

2. subito_scrape_by_url

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

3. subito_get_dataset_items

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

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.