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

Subito.it の広告を検索・スクレイピングするための、Apify Actor azzouzana/subito-scraper-pro-by-search-url を活用した TypeScript ベースの MCP (Model Context Protocol) サーバーです。

MCP 互換クライアント(Claude Desktop、Cursor、Gemini Antigravity、Windsurf、VS Code など)で npx を使って即座に実行できます。


🌟 主な機能

  • 🚀 グローバルインストール不要で npx で実行: npx -y mcp-server-subito-scraper ですぐに使用可能。

  • 🇮🇹 Subito.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. 設定 > 統合 > APIトークン または console.apify.com/settings/integrations にアクセスします。

  3. 個人用APIトークン (例: 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"
      }
    }
  }
}

🧰 利用可能なツール

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
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers