Business Listing Aggregator

Audits a business’s name, address, phone, and hours across Google Maps, Yelp, Facebook, BBB, and Apple Maps, reporting discrepancies in JSON or HTML.

Security Scan

The skill's code, instructions, and requested configuration are consistent with a listing-audit scraper that optionally uses a Google Places API key; nothing in the package indicates hidden exfiltration or unrelated credential requests.

Purpose & Capability

Name/description (audit business listings across Google/Yelp/Facebook/BBB/Apple) match the provided code and SKILL.md. The only credential mentioned is an optional GOOGLE_PLACES_API_KEY used to call Google Places — appropriate and proportional for the stated enrichment behavior. No unexpected services, binaries, or credentials are requested.

Instruction Scope

The SKILL.md and skill.py explicitly instruct the agent to fetch platform search pages and to fall back to web scraping when no Google key is provided. This behavior is consistent with the stated purpose but has legal/operational implications: scraping third-party sites may violate Terms of Service and can trigger blocking. The instructions also encourage editing the PLATFORMS dict, which expands scope if a user modifies it to target other sites.

Install Mechanism

No install spec; this is instruction+script only and relies on Python stdlib (requests optional). No external downloads or archive extraction are performed, so install risk is low.

Credentials

Only an OPTIONAL GOOGLE_PLACES_API_KEY and simple config (TIER, DEFAULT_LOCATION, LOG_LEVEL) are referenced in SKILL.md/.env.example. The code does not require unrelated secrets or multiple credential types.

Persistence & Privilege

Skill is user-invocable and not always-enabled. It does not request permanent platform-level privileges nor modify other skills' configuration. Autonomous invocation is allowed by platform default but is not combined here with any broad credential access.

Assessment

This skill appears to be what it says: a multi-platform listing auditor that scrapes search pages and can optionally use Google Places for structured results. Before installing or running it, consider: 1) Legal/ToS: scraping may violate site Terms of Service — only audit businesses you own or have written permission to audit (the SKILL.md also warns this). 2) Reliability & blocking: the tool uses simple browser-like headers and basic rate delays; heavy or frequent use can get your IP blocked. Use a proper API key (Google Places) when possible. 3) Privacy: results can contain phone numbers and addresses (PII). Ensure you have the right to collect/store that data and protect any reports you write to disk. 4) Review & sandbox: although no exfiltration endpoints are present, review the full code (the truncated portion in the package) and run it in a restricted/sandboxed environment if you’re concerned. 5) Accuracy & maintenance: HTML scraping via regex is brittle; expect false negatives and maintain the PLATFORMS patterns as sites change. If you need automated, high-volume, or commercial audits, prefer official APIs and rate-limited architectures.

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

Feature	Free	Pro ($19/mo)	Bundle ($39/mo)
Businesses monitored	1	10	Unlimited
Check frequency	Monthly	Weekly	Daily
Platforms checked	Google Maps, Yelp, Facebook	Google Maps, Yelp, Facebook, BBB, Apple Maps	All 5 platforms
Output formats	Terminal text	JSON + HTML	JSON + HTML + PDF
Exportable report	No	Yes	Yes
API access	No	Yes	Yes
Priority support	No	No	Yes

---

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": "[phone]",
        "yelp": "[phone]",
        "facebook": "[phone]"
      },
      "consensus": "[phone]",
      "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 →