Subito.it MCP Server (via Apify)

TypeScript-based MCP (Model Context Protocol) server for searching and scraping listings from Subito.it using the Apify Actor azzouzana/subito-scraper-pro-by-search-url.

Instantly executable with npx on any MCP-compatible client (Claude Desktop, Cursor, Gemini Antigravity, Windsurf, VS Code, etc.).

🌟 Key Features

• 🚀 Run with npx, no global install: ready to use with npx -y mcp-server-subito-scraper.

• 🇮🇹 Full support for all Subito.it categories: Motors (cars, motorcycles), Real Estate (sale/rent), Electronics/IT, Phones, Furniture, Jobs, and General Marketplace.

• 🔍 Smart search (subito_search): Automatically generates URLs with filters for query, category, region, min/max price, and TuttoSubito shipping (shp=true).

• 🔗 Direct URL scraping (subito_scrape_by_url): Paste any URL with complex filters applied directly from the site.

• 📦 Dataset retrieval (subito_get_dataset_items): View and extract results from previously created Apify datasets.

• 🔑 Flexible Token Configuration: Via environment variable (APIFY_TOKEN), command-line parameter (--token), or directly in the prompt/tool.

Related MCP server: MCP Apify

🔑 Getting an Apify Token

1. Create a free account at Apify.com.

2. Go to Settings > Integrations > API Tokens or console.apify.com/settings/integrations.

3. Copy your Personal API Token (e.g. apify_api_...).

🛠️ Configuration in MCP Clients

1. Claude Desktop

Add the configuration to the claude_desktop_config.json file:

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

Alternatively, passing the token as a CLI argument:

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

2. Cursor / Windsurf

In the client's MCP settings:

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

3. Gemini Antigravity / Agentic IDE

Add the MCP configuration block in the mcpServers section:

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

🧰 Available Tools

1. subito_search

Automatically builds the Subito URL and runs the scraper.

2. subito_scrape_by_url

Scrapes from a ready-made direct search URL.

3. subito_get_dataset_items

Retrieves extracted data from a previously saved Apify dataset.

4. apify_check_status

Checks that the Apify token is valid and displays account information.

💻 Local Development and Compilation

If you want to clone and modify the server locally:

# 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

Or in development mode with hot reload:

APIFY_TOKEN=tuo_token_qui npm run dev

🚀 Publishing to NPM and GitHub

To publish the package and make it available to everyone via npx mcp-server-subito-scraper:

# Esegui il login a npm
npm login

# Pubblica il pacchetto
npm publish --access public

📄 License

This project is distributed under the MIT license. See the LICENSE file for details.

Disclaimer: This MCP server is not officially affiliated with, sponsored, or endorsed by Subito.it S.r.l. All trademarks belong to their respective owners.