Business Listing Aggregator — SKILL.md

Skill Name: Business Listing Aggregator
Version: 1.0.0
Category: Business Intelligence / Monitoring
Author: EdgeIQ Labs
Python: 3.8+

What It Does

Takes a business name + location and audits its presence across major platforms (Google Maps, Yelp, BBB, Facebook, Apple Maps). It detects and reports discrepancies in business name, address, phone number, and operating hours — producing a clean structured report in JSON or HTML format.

Designed for business owners, agency marketers, and reputation managers who need to catch listing drift before it damages SEO or drives away customers.

Tier Comparison

Features

• Multi-platform citation check — Google Maps, Yelp, Facebook, BBB, Apple Maps
• Field-level discrepancy detection — flags mismatches in name, address, phone, hours
• Consensus determination — highlights which platform differs from the majority
• Structured output — JSON (machine-readable) and HTML (human-readable) formats
• Optional Google Places API — pass a key for enriched, structured data; falls back to web scraping when not provided
• Confidence scoring — each check includes a confidence rating (High/Medium/Low)
• Tier-based platform coverage — Free checks 3 platforms; Pro adds BBB + Apple Maps; Bundle covers all

Usage

Command Line

python skill.py --business "Joe's Pizza" --location "Brooklyn, NY"
python skill.py --business "Joe's Pizza" --location "Brooklyn, NY" --output json --outfile report.json
python skill.py --business "Joe's Pizza" --location "Brooklyn, NY" --output html --outfile report.html
python skill.py --business "Joe's Pizza" --location "Brooklyn, NY" --tier pro --verbose
python skill.py --help

Python API

from skill import BusinessListingAggregator

aggregator = BusinessListingAggregator(tier="pro", google_places_api_key=None)
report = aggregator.audit("Joe's Pizza", "Brooklyn, NY")
print(report)

Interactive

python skill.py --interactive

Output Example (JSON)

{
  "business_name": "Joe's Pizza",
  "location": "Brooklyn, NY",
  "audit_timestamp": "2026-04-23T11:15:00Z",
  "tier": "pro",
  "platforms_checked": ["google_maps", "yelp", "facebook", "bbb", "apple_maps"],
  "discrepancies": [
    {
      "field": "phone",
      "platforms": {
        "google_maps": "+1-718-555-1234",
        "yelp": "+1-718-555-9999",
        "facebook": "+1-718-555-1234"
      },
      "consensus": "+1-718-555-1234",
      "discrepant_platforms": ["yelp"],
      "severity": "high",
      "recommendation": "Update Yelp listing to match consensus"
    },
    {
      "field": "hours",
      "platforms": {
        "google_maps": "Mon-Sat 10am-10pm",
        "yelp": "Mon-Sat 11am-9pm",
        "facebook": "Mon-Sat 10am-10pm"
      },
      "consensus": "Mon-Sat 10am-10pm",
      "discrepant_platforms": ["yelp"],
      "severity": "medium",
      "recommendation": "Update Yelp hours to match consensus"
    }
  ],
  "summary": {
    "total_platforms": 5,
    "platforms_with_issues": 1,
    "overall_health": "good"
  }
}

Pricing

Lifetime License: $39 — your tool forever, all features included permanently. Optional Monthly: $7/mo — for those who prefer recurring billing (cancel anytime). 👉 Buy Lifetime — $39 👉 Subscribe Monthly — $7/mo 👉 Subscribe Monthly — $7/mo

Pro Upgrade (deprecated)

All features now included in Lifetime purchase.

Legal Notice

IMPORTANT: Only monitor businesses you own or have explicit written permission to audit. Scraping or automated access to third-party platforms may violate those platforms' Terms of Service. EdgeIQ Labs and the skill authors accept no liability for misuse. Comply with all applicable laws and platform policies.

Environment Variables

See .env.example for required and optional configuration.

GOOGLE_PLACES_API_KEY=   # Optional — enables structured Google Places data
TIER=free                 # free | pro | bundle
DEFAULT_LOCATION=         # Optional default location
LOG_LEVEL=INFO            # DEBUG | INFO | WARNING | ERROR

Dependencies

• Python 3.8+
• requests (optional — for Google Places API; falls back to stdlib urllib)
• Standard library: json, re, time, sys, argparse, datetime, os, html

Install optional dependencies:

pip install requests

🔗 More from EdgeIQ Labs

edgeiqlabs.com — Security tools, OSINT utilities, and micro-SaaS products for developers and security professionals.

• 🛠️ Subdomain Hunter — Passive subdomain enumeration via Certificate Transparency
• 📸 Screenshot API — URL-to-screenshot API for developers
• 🔔 uptime.check — URL uptime monitoring with alerts
• 🛡️ headers.check — HTTP security headers analyzer

👉 Visit edgeiqlabs.com →