mcp-server-subito-scraper
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: OLX MCP Server
🔑 Apify 토큰 얻기
Apify.com에서 무료 계정을 만드세요.
Settings > Integrations > API Tokens 또는 console.apify.com/settings/integrations로 이동하세요.
Personal API Token (예:
apify_api_...)을 복사하세요.
🛠️ MCP 클라이언트 설정
1. Claude Desktop
claude_desktop_config.json 파일에 설정을 추가하세요:
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"
}
}
}
}또는 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을 자동으로 구성하고 스크래퍼를 실행합니다.
매개변수 | 유형 | 설명 | 기본값 |
|
| 검색할 텍스트 (예: | - |
|
| 카테고리 (예: |
|
|
| 이탈리아 지역 (예: |
|
|
| 최소 가격 (유로) | - |
|
| 최대 가격 (유로) | - |
|
| TuttoSubito 배송 광고만 필터링 |
|
|
| 정렬: |
|
|
| 추출할 최대 광고 수 |
|
|
| 최대 실행 시간 제한 (초) |
|
|
| Apify 토큰 (환경 변수 값을 덮어씁니다) | - |
2. subito_scrape_by_url
이미 준비된 검색 URL을 기반으로 스크래핑을 실행합니다.
매개변수 | 유형 | 설명 | 기본값 |
|
| 완전한 Subito.it 검색 URL | - |
|
| 추출할 최대 광고 수 |
|
|
| 시간 제한 (초) |
|
|
| 사용자 정의 Apify 토큰 | - |
3. subito_get_dataset_items
이전에 저장된 Apify 데이터셋에서 추출된 데이터를 가져옵니다.
매개변수 | 유형 | 설명 | 기본값 |
|
| Apify 데이터셋 ID | - |
|
| 읽을 항목 수 |
|
|
| 페이지네이션 오프셋 |
|
|
| 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 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.
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.231 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