mcp-server-subito-scraper
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
npxohne globale Installation: einsatzbereit mitnpx -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
Erstelle ein kostenloses Konto auf Apify.com.
Gehe zu Settings > Integrations > API Tokens oder console.apify.com/settings/integrations.
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.jsonWindows:
%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 |
|
| Suchtext (z. B. | - |
|
| Kategorie (z. B. |
|
|
| Italienische Region (z. B. |
|
|
| Mindestpreis in Euro | - |
|
| Höchstpreis in Euro | - |
|
| Nur Anzeigen mit TuttoSubito-Versand filtern |
|
|
| Sortierung: |
|
|
| Maximale Anzahl der zu extrahierenden Anzeigen |
|
|
| Maximales Ausführungs-Timeout in Sekunden |
|
|
| 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 |
|
| Vollständige Subito.it-Such-URL | - |
|
| Maximale Anzahl der zu extrahierenden Anzeigen |
|
|
| Timeout in Sekunden |
|
|
| Benutzerdefinierter Apify-Token | - |
3. subito_get_dataset_items
Ruft die extrahierten Daten aus einem zuvor gespeicherten Apify-Dataset ab.
Parameter | Typ | Beschreibung | Standard |
|
| ID des Apify-Datasets | - |
|
| Anzahl der zu lesenden Elemente |
|
|
| Offset für Paginierung |
|
|
| 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 startOder 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 toolsapify_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.
subito_searchB
Searches Subito.it for ads by keywords, category, region, price range, and shipping, then scrapes the results via Apify
Inputs: query (required), token, region, sortBy, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
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).
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.
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.
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
Related MCP Connectors
Jobs, ads, SEO, keywords, YouTube and AliExpress data for AI agents. Runs on Apify.
Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store ⚡
Extract emails and phones from any website via Apify.
Aurelix web data tools (jobs, leads, e-commerce, ads, SEO) for AI agents via Apify's MCP server.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI agents to search Reddit for posts, comments, and users or monitor for high-intent leads and brand mentions. It functions by delegating scraping tasks to high-performance Apify cloud actors.261 npm7MIT
- AlicenseAqualityCmaintenanceEnables searching and retrieving details from OLX classifieds across multiple domains (Portugal, Poland, Bulgaria, Romania, Ukraine) using browser automation.257 npm29MIT
- AlicenseNot gradedqualityDmaintenanceEnables web scraping, browser automation, and dataset management through Apify's actor platform.MIT
- AlicenseAqualityDmaintenanceEnables searching, viewing details, and filtering listings on Letgo.com by using Playwright to bypass Akamai anti-bot protection.61MIT