AI导哈

分类广告搜索服务

一个用于搜索和浏览意大利最大分类广告网站subito.it的MCP服务器，提供搜索、详情获取、比较和市场分析功能。

  • by monossido
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 monossido/mcp-server-subito

使用说明

mcp 服务器

MCP（模型上下文协议）服务器，用于搜索和浏览意大利最大的分类广告市场subito.it上的列表。

仅用于测试和教育目的。 看 法律和伦理考虑 使用前。

特性

  • 使用过滤器（关键字、类别、地区、价格、卖家类型）搜索列表
  • 检索完整的列表详细信息（描述、图像、广告商信息、结构化功能）
  • 并排比较多个列表
  • 从参考广告中查找可比较的列表
  • 通过各个方面（价格分布、顶级类别、地区）进行市场分析
  • 默认情况下符合robots.txt
  • 内置速率限制

安装

本地AI代理

将以下内容添加到您的 claude_desktop_config.json 或其他配置文件：

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

随着 --ignore-robots-txt 已启用（多页扫描所需）：

{
  "mcpServers": {
    "subito": {
      "command": "npx",
      "args": ["-y", "mcp-server-subito", "--ignore-robots-txt"]
    }
  }
}

光标

首选 光标设置→ 工具和集成→ 新建MCP服务器 并使用与上述相同的配置。

工具

search_listings

使用可选过滤器在subito.it上搜索列表。

参数 类型 说明
query string 搜索关键字（例如。 iphone, bicicletta)
category number 类别ID--使用 list_categories 浏览
region number 区域ID--使用 list_regions 浏览
province number 用于更具体位置筛选的省份ID
minPrice number 最低价格（欧元）
maxPrice number 最高价格（欧元）
sort enum relevance, date_desc, price_asc, price_desc
startPage number 起始页（默认值：1）
maxPages number 要扫描的页数，1-50页（需要 --ignore-robots-txt 对于>1）
sellerType enum private 或 professional
includeFacets boolean 将价格/类别/地区聚合添加到响应中

get_listing_details

按URL检索单个列表的完整详细信息。

参数 类型 说明
url string 完整的subito.it列表URL

返回标题、描述、价格、位置、图像、广告商信息和结构化特征。

compare_listings

获取2-10个列表，并返回一个标准化的比较表，包括价格、地点、卖家类型、品牌、型号、年份、状况和图片数量。

参数 类型 说明
urls string[] 2到10 subito.it列出URL

find_comparable_listings

给定一个引用列表URL，会自动导出一个搜索查询，并返回结构上最相似的活动列表以及显式匹配信号。

参数 类型 说明
listingUrl string 引用列表URL
limit number 要返回的最大结果数（默认值：10，最大值：20）
maxPages number 要扫描的页面（需要 --ignore-robots-txt 对于>1）

list_categories

返回subito.it类别及其ID的完整列表。

list_regions

返回所有意大利地区和省份及其ID，以便在搜索筛选器中使用。

配置

标志 默认值 描述
--ignore-robots-txt off 禁用robots.txt强制。每次搜索需要扫描多个页面。
--allow-unknown-robots off 如果无法访问robots.txt，请继续而不是阻止请求（失败打开）。

发展

# Install dependencies
npm install

# Build
npm run build

# Run locally
node build/index.js

# Watch mode
npm run dev

# Tests
npm test

法律和伦理考虑

此工具旨在 仅供个人、测试和教育使用.

使用此服务器即表示您同意：

  • 尊重subito。这是服务条款。 自动访问可能会违反他们的ToS。您对自己的使用负全部责任。
  • 尊重robots.txt。 默认情况下，此服务器强制执行 robots.txt 指令。这 --ignore-robots-txt flag绕过了此检查——只有在您有正当理由并理解其含义的情况下才使用它。
  • 请勿用于商业抓取或批量数据收集。 此服务器不是为大规模数据收集而设计或设计的。
  • 请勿使用垃圾邮件或骚扰广告商 超出正常的平台交互。
  • 限制您的请求速率。 服务器包括内置的速率限制，但避免运行可能影响subito基础设施的激进扫描。
  • 不要重新分发抓取的数据 以侵犯subito的方式。这是知识产权。

作者对误用此工具不承担任何责任。

许可证

AGPL v3© 洛伦佐·布拉盖托

相关 MCP