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

mcp-server-subito-scraper

by pindaroli

Subito.it MCP 서버 (Apify 기반)

License: MIT Node.js Model Context Protocol

TypeScript 기반 MCP (Model Context Protocol) 서버로, Apify 액터 azzouzana/subito-scraper-pro-by-search-url를 활용하여 Subito.it 의 광고를 검색하고 스크래핑합니다.

MCP 호환 클라이언트(Claude Desktop, Cursor, Gemini Antigravity, Windsurf, VS Code 등)에서 npx로 즉시 실행 가능합니다.


🌟 주요 기능

  • 🚀 글로벌 설치 없이 npx로 실행: npx -y mcp-server-subito-scraper로 바로 사용 가능.

  • 🇮🇹 모든 Subito.it 카테고리 완전 지원: 자동차/오토바이, 부동산(매매/임대), 전자제품/IT, 통신, 가구, 구인/구직, 일반 마켓플레이스.

  • 🔍 스마트 검색 (subito_search): 쿼리, 카테고리, 지역, 최소/최대 가격, TuttoSubito 배송(shp=true) 필터가 포함된 URL을 자동 생성.

  • 🔗 직접 URL 스크래핑 (subito_scrape_by_url): 사이트에서 직접 적용한 복잡한 필터가 포함된 URL을 붙여넣기.

  • 📦 데이터셋 조회 (subito_get_dataset_items): 이전에 생성된 Apify 데이터셋에서 결과를 확인하고 추출.

  • 🔑 유연한 토큰 설정: 환경 변수(APIFY_TOKEN), 명령줄 인수(--token), 또는 프롬프트/도구에서 직접 전달 가능.


Related MCP server: OLX MCP Server

🔑 Apify 토큰 얻기

  1. Apify.com에서 무료 계정을 만드세요.

  2. Settings > Integrations > API Tokens 또는 console.apify.com/settings/integrations로 이동하세요.

  3. Personal API Token (예: apify_api_...)을 복사하세요.


🛠️ MCP 클라이언트 설정

1. Claude Desktop

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

또는 CLI 인수로 토큰을 전달하는 방법:

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

2. Cursor / Windsurf

클라이언트의 MCP 설정에서:

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

3. Gemini Antigravity / Agentic IDE

mcpServers 섹션에 MCP 설정 블록을 추가하세요:

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

🧰 사용 가능한 도구 (Tools)

1. subito_search

Subito URL을 자동으로 구성하고 스크래퍼를 실행합니다.

매개변수

유형

설명

기본값

query

string (필수)

검색할 텍스트 (예: "MacBook Pro M3", "Vespa 125")

-

category

string (선택)

카테고리 (예: "usato", "auto", "moto", "case", "informatica", "telefonia", "arredamento")

"usato"

region

string (선택)

이탈리아 지역 (예: "italia", "lombardia", "lazio", "piemonte", "veneto")

"italia"

minPrice

number (선택)

최소 가격 (유로)

-

maxPrice

number (선택)

최대 가격 (유로)

-

shippingOnly

boolean (선택)

TuttoSubito 배송 광고만 필터링

false

sortBy

string (선택)

정렬: "datedesc", "priceasc", "pricedesc"

"datedesc"

maxItems

number (선택)

추출할 최대 광고 수

30

timeoutSecs

number (선택)

최대 실행 시간 제한 (초)

300

token

string (선택)

Apify 토큰 (환경 변수 값을 덮어씁니다)

-


2. subito_scrape_by_url

이미 준비된 검색 URL을 기반으로 스크래핑을 실행합니다.

매개변수

유형

설명

기본값

searchUrl

string (필수)

완전한 Subito.it 검색 URL

-

maxItems

number (선택)

추출할 최대 광고 수

30

timeoutSecs

number (선택)

시간 제한 (초)

300

token

string (선택)

사용자 정의 Apify 토큰

-


3. subito_get_dataset_items

이전에 저장된 Apify 데이터셋에서 추출된 데이터를 가져옵니다.

매개변수

유형

설명

기본값

datasetId

string (필수)

Apify 데이터셋 ID

-

limit

number (선택)

읽을 항목 수

50

offset

number (선택)

페이지네이션 오프셋

0

token

string (선택)

Apify 토큰

-


4. apify_check_status

Apify 토큰이 유효한지 확인하고 계정 정보를 표시합니다.


💻 로컬 개발 및 컴파일

서버를 로컬에서 클론하고 수정하려면:

# 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

또는 빠른 리로드가 가능한 개발 모드로:

APIFY_TOKEN=tuo_token_qui npm run dev

🚀 NPM 및 GitHub에 배포

패키지를 게시하여 모든 사용자가 npx mcp-server-subito-scraper로 사용할 수 있도록 하려면:

# Esegui il login a npm
npm login

# Pubblica il pacchetto
npm publish --access public

📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

면책: 이 MCP 서버는 Subito.it S.r.l.과 공식적으로 제휴, 후원 또는 지원되지 않습니다. 등록 상표는 각 소유자의 자산입니다.

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
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers