Subito.it MCP サーバー (Apify 経由)

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

🔑 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を自動的に構築し、スクレイパーを実行します。

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. によって公式に提携、スポンサー、またはサポートされているものではありません。商標はそれぞれの所有者に帰属します。