Google Maps Reviews Scraper & Exporter (Pro)

Comprehensive Google Maps review scraper with filtering, multiple export formats, photo downloads, and business metadata

当前为 2025-11-27 提交的版本,查看 最新版本

您需要先安装一个扩展,例如 篡改猴Greasemonkey暴力猴,之后才能安装此脚本。

您需要先安装一个扩展,例如 篡改猴暴力猴,之后才能安装此脚本。

您需要先安装一个扩展,例如 篡改猴暴力猴,之后才能安装此脚本。

您需要先安装一个扩展,例如 篡改猴Userscripts ,之后才能安装此脚本。

您需要先安装一款用户脚本管理器扩展,例如 Tampermonkey,才能安装此脚本。

您需要先安装用户脚本管理器扩展后才能安装此脚本。

(我已经安装了用户脚本管理器,让我安装!)

您需要先安装一款用户样式管理器扩展,比如 Stylus,才能安装此样式。

您需要先安装一款用户样式管理器扩展,比如 Stylus,才能安装此样式。

您需要先安装一款用户样式管理器扩展,比如 Stylus,才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

(我已经安装了用户样式管理器,让我安装!)

作者
sharmanhall
评分
0 0 0
版本
1.0.0
创建于
2025-11-27
更新于
2025-11-27
大小
44.5 KB
许可证
MIT
适用于

Google Maps Reviews Scraper Pro - v1.0.0

What's New (vs Enhanced v0.16)

🐛 Bug Fixes

Issue Before After
"a year ago" dates Returned unknown Now correctly parses to estimated date
Profile image resolution Hardcoded =w36-h36 didn't match actual =w72-h72 Uses regex =w\d+-h\d+[^=]* to match any size
CSV special characters Could break on \r\n in reviews Proper escaping + UTF-8 BOM for Excel
Scroll container detection Fragile .parentElement.parentElement chain Multiple selector strategies with fallback

✨ New Features

Export Options

  • JSON - Full structured data with metadata header
  • CSV - Excel-compatible with BOM encoding
  • XLSX - Multi-sheet workbook (Reviews + Business Info tabs)
  • Copy to Clipboard - JSON format

Business Metadata (auto-extracted)

{
  "name": "Apex Roofing",
  "address": "123 Main St, Denver CO",
  "rating": 4.9,
  "totalReviews": 67,
  "category": "Roofing contractor",
  "url": "https://google.com/maps/place/..."
}

Filtering Options

  • Star rating filter - Checkboxes for 1-5 stars
  • Photos only - Only reviews with attached images
  • Text only - Excludes rating-only reviews (no written content)

Owner Responses (Optional)

Toggle to include/exclude business owner replies:

{
  "owner_response": {
    "text": "Thank you for the kind words!",
    "date_raw": "2 months ago",
    "date_estimated": "2025-09-27"
  },
  "has_owner_response": true
}

Enhanced Reviewer Data

  • reviewer_local_guide_level - Local Guide badge level (1-10)
  • reviewer_review_count - Total reviews by this user
  • reviewer_profile_url - Direct link to contributor profile

Progress Indicator

  • Live progress bar during scroll loading
  • Shows "Loaded 47 / ~312 reviews"
  • Stop button to cancel mid-scrape

Smart Filenames

Auto-generates: Apex_Roofing_reviews_2025-11-27.csv (Previously: google_maps_reviews_2025-11-27.csv)

Photo Downloads

"Download All Photos" button extracts every review photo at max resolution.


Data Schema (v1.0.0)

interface Review {
  // Reviewer
  reviewer_name: string;
  reviewer_profile_url: string;
  reviewer_profile_img: string;        // Now high-res (s400)
  reviewer_local_guide_level: number | null;
  reviewer_review_count: number | null;

  // Review content
  review_id: string;
  review_url: string;
  star_rating: number;                 // 1-5
  review_content: string;
  review_date_raw: string;             // "2 months ago"
  review_date_estimated: string;       // "2025-09-27" (FIXED!)
  review_date_timestamp: number | null;

  // Photos
  review_photos: string[];             // High-res URLs
  review_photo_count: number;

  // Owner response (optional)
  owner_response: {
    text: string;
    date_raw: string;
    date_estimated: string;
  } | null;
  has_owner_response: boolean;

  // Meta
  scraped_at: string;                  // ISO timestamp
}

Installation

  1. Install Tampermonkey browser extension
  2. Click "Create new script"
  3. Paste the entire .user.js file contents
  4. Save (Ctrl+S)
  5. Navigate to any Google Maps place page

Usage Tips

  1. For large review sets (500+): Use the Stop button if you only need a sample
  2. Filtering saves time: Toggle "Only with text" to skip empty ratings
  3. XLSX is best for analysis: Includes separate Business Info sheet
  4. Photo downloads: May open multiple tabs if GM_download isn't available

Known Limitations

  • Google Maps lazy-loads reviews, so scrolling is required (can't skip)
  • Very old reviews (5+ years) may have less precise date estimates
  • Photo download depends on browser permissions
  • Some reviewer badges only visible on expanded profiles

Changelog

v1.0.0 (2025-11-27)

  • Complete rewrite with modular architecture
  • Fixed date parsing for "a/an X ago" format
  • Fixed profile image URL resolution matching
  • Added XLSX export with SheetJS
  • Added business metadata extraction
  • Added owner response capture (optional)
  • Added star/photo/text filtering
  • Added progress indicator with stop button
  • Added smart filename generation
  • Added bulk photo download
  • Improved scroll container detection
  • Improved CSV escaping for Excel compatibility
  • Enhanced UI with toggle switches and sections