EdgeIQ 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 optional API usage line up with its stated purpose (auditing business listings via web requests and optional Google Places API); nothing in the package requests unrelated credentials or unusual system access, though the scraper behavior can violate third‑party Terms of Service and should be used with permission.

Purpose & Capability

Name/description match the implementation: PLATFORMS and TIER_PLATFORMS include Google Maps, Yelp, Facebook, BBB, and Apple Maps; optional GOOGLE_PLACES_API_KEY is declared and used for structured data. No unrelated env vars, binaries, or installs are requested.

Instruction Scope

SKILL.md and skill.py instruct the agent to fetch HTML pages (web scraping) and parse fields (name, address, phone, hours). That behavior is expected for a listing aggregator, but scraping may violate platform Terms of Service and could be blocked; the skill also includes User-Agent headers and rate-delay logic. The SKILL.md correctly warns about needing permission. Review the rest of the truncated code to confirm there are no hidden data transmissions or logging to external endpoints.

Install Mechanism

No install spec and no external downloads; the package is pure Python and uses only stdlib urllib (requests is optional). This is low-risk for installation.

Credentials

Only an optional GOOGLE_PLACES_API_KEY and simple TIER/LOG_LEVEL defaults are referenced. No unrelated secrets or multiple unrelated credentials are requested.

Persistence & Privilege

always is false, the skill does not request persistent system privileges, and there is no indication it modifies other skills or system-wide config.

Assessment

This skill appears to do what it claims: it fetches public pages (or uses the Google Places API if you supply a key) and extracts fields to build a discrepancy report. Before installing or running it: (1) only audit listings you own or have explicit permission to audit — scraping can violate platform Terms of Service; (2) prefer supplying a legitimate Google Places API key instead of relying on scraping where supported; (3) review the full skill.py (the provided snippet is truncated) to confirm there are no hidden network endpoints, telemetry, or data-exfiltration routines; (4) run it in a controlled environment and avoid providing high‑privilege credentials to untrusted skills; and (5) consider rate limits and respectful delays to avoid being IP-blocked by target platforms.

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"
  }
}

---

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