Servidor MCP de Subito.it (vía Apify)

Servidor MCP (Model Context Protocol) basado en TypeScript para buscar y extraer anuncios de Subito.it aprovechando el Actor de Apify azzouzana/subito-scraper-pro-by-search-url.

Ejecutable al instante con npx en cualquier cliente compatible con MCP (Claude Desktop, Cursor, Gemini Antigravity, Windsurf, VS Code, etc.).

🌟 Funcionalidades Principales

• 🚀 Ejecución con npx sin instalación global: listo para usar con npx -y mcp-server-subito-scraper.

• 🇮🇹 Soporte completo para todas las categorías de Subito.it: Motores (coches, motos), Inmuebles (venta/alquiler), Electrónica/Informática, Telefonía, Mobiliario, Trabajo y Marketplace general.

• 🔍 Búsqueda inteligente (subito_search): Genera automáticamente las URL con filtros por consulta, categoría, región, precio mínimo/máximo y envío TuttoSubito (shp=true).

• 🔗 Extracción directa desde URL (subito_scrape_by_url): Pega cualquier URL con filtros complejos aplicados directamente desde el sitio.

• 📦 Recuperación de Dataset (subito_get_dataset_items): Visualiza y extrae resultados de datasets de Apify creados anteriormente.

• 🔑 Configuración flexible del Token: Mediante variable de entorno (APIFY_TOKEN), parámetro de línea de comandos (--token), o directamente en el prompt/herramienta.

Related MCP server: MCP Apify

🔑 Obtener el Token de Apify

1. Crea una cuenta gratuita en Apify.com.

2. Ve a Settings > Integrations > API Tokens o a console.apify.com/settings/integrations.

3. Copia tu Personal API Token (ej. apify_api_...).

🛠️ Configuración en Clientes MCP

1. Claude Desktop

Añade la configuración al archivo 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"
      }
    }
  }
}

Alternativamente, pasando el token como argumento CLI:

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

2. Cursor / Windsurf

En la configuración MCP del cliente:

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

3. Gemini Antigravity / Agentic IDE

Añade el bloque de configuración MCP en la sección mcpServers:

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

🧰 Herramientas Disponibles (Tools)

1. subito_search

Construye automáticamente la URL de Subito y ejecuta el scraper.

2. subito_scrape_by_url

Realiza la extracción a partir de una URL de búsqueda directa ya preparada.

3. subito_get_dataset_items

Recupera los datos extraídos de un dataset de Apify previamente guardado.

4. apify_check_status

Verifica que el token de Apify sea válido y muestra la información de la cuenta.

💻 Desarrollo Local y Compilación

Si deseas clonar y modificar el servidor localmente:

# 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

O en modo desarrollo con recarga rápida:

APIFY_TOKEN=tuo_token_qui npm run dev

🚀 Publicación en NPM y GitHub

Para publicar el paquete y hacerlo disponible para todos mediante npx mcp-server-subito-scraper:

# Esegui il login a npm
npm login

# Pubblica il pacchetto
npm publish --access public

📄 Licencia

Este proyecto se distribuye bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.

Descargo de responsabilidad: Este servidor MCP no está afiliado, patrocinado ni respaldado oficialmente por Subito.it S.r.l. Las marcas registradas pertenecen a sus respectivos propietarios.