Subito.it MCP 서버 (Apify 기반)

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

🔑 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을 자동으로 구성하고 스크래퍼를 실행합니다.

2. subito_scrape_by_url

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

3. subito_get_dataset_items

이전에 저장된 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.과 공식적으로 제휴, 후원 또는 지원되지 않습니다. 등록 상표는 각 소유자의 자산입니다.