AI导哈

谷歌地图数据提取服务

Outscraper MCP服务器提供高效的谷歌地图数据提取服务，包括企业搜索和客户评论获取，适用于市场调研和潜在客户开发。

  • by jayozer
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 jayozer/outscraper-mcp

使用说明

Outscraper MCP服务器

一个精简的模型上下文协议（MCP）服务器，提供访问Outscraper的谷歌地图数据提取服务。此服务器实现了 2个必备工具 用于高可靠性地提取谷歌地图数据。

🚀 功能特性

谷歌地图数据提取

  • 🗺️ 谷歌地图搜索 - 搜索包含详细信息的企业和地点
  • ⭐ Google 地图评价 - 从任何Google Maps地点提取客户评价

高级功能

  • 数据丰富化 - 通过丰富参数增加联系信息以提升结果
  • 多语言支持 - 搜索并提取不同语言的数据
  • 区域过滤 - 针对特定国家/地区定位以获取本地化结果
  • 灵活排序 - 按相关性、日期、评分等对评论进行排序。
  • 基于时间的过滤 - 使用截止日期参数按日期筛选评论
  • 高容量支持 - 自动处理大型请求的异步处理

📦 安装

通过Smithery安装（推荐）

通过……自动为Claude Desktop安装Outscraper MCP服务器 Smithery（注：此词在常规语境下可能不是一个标准的英文单词，但根据音译可理解为“史密斯里”或类似发音的名称，具体含义需结合上下文确定。若指某个特定公司、品牌或地名，则需具体情境来翻译。）：

npx -y @smithery/cli install outscraper-mcp --client claude

通过PyPI安装

# Using pip
pip install outscraper-mcp

# Using uv (recommended)
uv add outscraper-mcp

# Using uvx for one-time execution
uvx outscraper-mcp

手动安装

git clone https://github.com/jayozer/outscraper-mcp
cd outscraper-mcp

# Using uv (recommended)
uv sync

# Using pip
pip install -e .

🔧 配置

获取您的API密钥

  1. 在……注册 Outscraper（可译为“外爬”或根据具体语境译为更贴切的名称，但“Outscraper”本身作为一个专有名词或品牌名，直接翻译可能无法完全传达其原意，因此保留原名）
  2. 从个人资料页面获取您的API密钥

设置环境变量

export OUTSCRAPER_API_KEY="your_api_key_here"

或者创建一个 .env 文件：

OUTSCRAPER_API_KEY=your_api_key_here

🛠️ 客户端配置

Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文决定是否需要具体翻译）

添加到您的 claude_desktop_config.json：

通过史密斯里路（自动）：

{
  "mcpServers": {
    "outscraper": {
      "command": "npx",
      "args": ["-y", "@smithery/cli", "run", "outscraper-mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

通过本地安装方式：

{
  "mcpServers": {
    "outscraper": {
      "command": "uvx",
      "args": ["outscraper-mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

通过手动安装：

{
  "mcpServers": {
    "outscraper": {
      "command": "uv",
      "args": ["run", "python", "-m", "outscraper_mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor AI（游标人工智能）

使用UVX进行自动安装（推荐）：

{
  "mcpServers": {
    "outscraper": {
      "command": "uvx",
      "args": ["outscraper-mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

手动安装：

{
  "mcpServers": {
    "outscraper": {
      "command": "outscraper-mcp",
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

光标用户须知配置文件通常位于：

  • macOS（苹果电脑操作系统）： ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Windows： %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
  • Linux： ~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

🛠️ 工具参考

谷歌地图搜索

在谷歌地图上搜索商家和地点

# Parameters:
query: str              # Search query (e.g., 'restaurants brooklyn usa')
limit: int = 20         # Number of results (max: 400)
language: str = "en"    # Language code
region: str = None      # Country/region code (e.g., 'US', 'GB')
drop_duplicates: bool = False  # Remove duplicate results
enrichment: List[str] = None   # Additional services ['domains_service', 'emails_validator_service']

谷歌地图评论

从Google Maps地点提取评论

# Parameters:
query: str              # Place query, place ID, or business name
reviews_limit: int = 10 # Number of reviews per place (0 for unlimited)
limit: int = 1          # Number of places to process
sort: str = "most_relevant"  # Sort order: 'most_relevant', 'newest', 'highest_rating', 'lowest_rating'
language: str = "en"    # Language code
region: str = None      # Country/region code
cutoff: int = None      # Unix timestamp for reviews after specific date

🚀 运行服务器

开发与测试

# FastMCP Inspector - Web-based testing dashboard
fastmcp dev outscraper_mcp/server.py

# Then open your browser to: http://127.0.0.1:6274
# Interactive testing of Google Maps tools with real-time responses

标准I/O传输（默认）

# Via PyPI installation
outscraper-mcp

# Via uv
uv run python -m outscraper_mcp

# Via manual installation
python -m outscraper_mcp

HTTP传输

from outscraper_mcp import mcp

if __name__ == "__main__":
    mcp.run(transport="streamable-http", host="127.0.0.1", port=8000)

💡 使用示例

示例1：查找餐厅并获取评论

# 1. Search for restaurants
results = google_maps_search(
    query="italian restaurants manhattan nyc",
    limit=5,
    language="en",
    region="US"
)

# 2. Get reviews for a specific place
reviews = google_maps_reviews(
    query="ChIJrc9T9fpYwokRdvjYRHT8nI4",  # Place ID from search results
    reviews_limit=20,
    sort="newest"
)

示例2：带丰富信息的潜在客户生成

# Find businesses with enhanced contact information
businesses = google_maps_search(
    query="digital marketing agencies chicago",
    limit=20,
    enrichment=["domains_service", "emails_validator_service"]
)

# Get detailed reviews for sentiment analysis
for business in businesses:
    if business.get('place_id'):
        reviews = google_maps_reviews(
            query=business['place_id'],
            reviews_limit=10,
            sort="newest"
        )

示例3：市场调研

# Research competitors in specific area
competitors = google_maps_search(
    query="coffee shops downtown portland",
    limit=50,
    region="US"
)

# Analyze recent customer feedback
recent_reviews = google_maps_reviews(
    query="coffee shops downtown portland",
    reviews_limit=100,
    sort="newest"
)

🔄 与MCP客户端的集成

此服务器兼容任何MCP客户端，包括：

📊 速率限制与定价

  • 检查 Outscraper定价 当前汇率
  • API密钥的使用情况会按请求进行追踪
  • 考虑为频繁访问的数据实现缓存机制

🐛 故障排除

常见问题

  1. 导入错误确保你已正确安装该软件包

    pip install --upgrade outscraper-mcp

  2. API密钥错误请验证您的API密钥设置是否正确

    echo $OUTSCRAPER_API_KEY

  3. 无结果检查您的查询参数是否有效

  4. 速率限制如需在请求之间设置延迟

启用调试日志记录

import logging
logging.basicConfig(level=logging.DEBUG)

🤝 贡献（或：参与贡献）

  1. 为仓库创建分支（或：克隆仓库）
  2. 创建一个特性分支
  3. 做出你的更改
  4. 添加测试
  5. 提交拉取请求

📄 许可证

实验性软件许可协议 - 详情请参见LICENSE文件。

通知： 这款软件为实验性质，可免费用于任何目的。由Jay Ozer创建。

🔗 链接

由Blu Goldens打造

相关 MCP