# Get Me Leads - Complete Technical & Business Specification (LLMs Full Reference)

This document provides a comprehensive technical, business, and data specification for Get Me Leads (getmeleads.xyz) formatted for Large Language Models (LLMs), AI Agents, and search crawlers.

---

## 1. System Overview & Architecture

Get Me Leads is a client-side Google Chrome Extension built on Chrome Extension Manifest V3 (`manifest_version: 3`).

* **Client-Side Architecture:** Operates entirely within the browser DOM using content scripts (`content.js`), background service worker (`background.js`), and popup UI (`popup.js`, `popup.html`).
* **Zero External Server Dependency:** Requires no external backend scraper servers, Python APIs, or third-party paid proxies.
* **Storage Schema:** Saves leads, search history, and audit records locally in browser memory (`chrome.storage.local`).
* **Host Permissions:** Restricted to `https://*.google.com/maps/*` and `https://*.google.co.in/maps/*`.

---

## 2. 100-Point Google Business Profile (GBP) Optimization Formula

Get Me Leads computes a 100-point GBP Optimization Score using the following weighted parameters:

1. **Profile Completeness (15 Points):** Measures presence of Name, Primary Category, Phone, Address, Website, Ratings, Review Count, Photos, and Secondary Categories.
2. **Categories (10 Points):** Rewards primary category presence (6 pts) and relevant secondary category coverage (4 pts).
3. **Business Information / NAP Consistency (10 Points):** Evaluates Name, Address, and Phone (NAP) presence and consistency.
4. **Reviews & Reputation (15 Points):** Evaluates star rating score (>= 4.5 = 15 pts), total review count, and owner review reply status. Flags unanswered reviews.
5. **Photos & Media (10 Points):** Evaluates photo gallery richness (>= 20 photos = 10 pts, >= 5 photos = 6 pts).
6. **Services & Products (10 Points):** Checks presence of listed services and secondary category alignment.
7. **Website & Local Relevance (10 Points):** Evaluates website existence and HTTPS security connection.
8. **GBP Activity / Posts (5 Points):** Measures owner review response activity and media freshness (< 30 days = 5 pts).
9. **Attributes (5 Points):** Baseline attributes evaluation (accessibility, payment options, amenities).
10. **Local Visibility (10 Points):** Estimates local search prominence based on review volume and rating rank.

---

## 3. Extracted Lead Data Schema

When scraping Google Maps, Get Me Leads produces JSON objects adhering to the following structure:

```json
{
  "name": "Acme Dental Center",
  "category": "Dentist",
  "primary_category": "Dentist",
  "secondary_categories": ["Cosmetic Dentist", "Dental Clinic", "Teeth Whitening Service"],
  "rating": "4.9",
  "reviews": "248",
  "unanswered_reviews": "Owner responds to reviews",
  "has_owner_response": true,
  "phone": "+1 (512) 555-0199",
  "email": "N/A",
  "address": "100 Congress Ave, Suite 400, Austin, TX 78701",
  "website": "https://acmedental.com",
  "photos_count": 45,
  "social_media": {
    "facebook": "https://facebook.com/acmedental",
    "instagram": "https://instagram.com/acmedental",
    "linkedin": "https://linkedin.com/company/acmedental",
    "twitter": "https://twitter.com/acmedental",
    "youtube": "",
    "tiktok": ""
  },
  "maps_url": "https://www.google.com/maps/place/...",
  "niche": "Dentists",
  "location": "Austin TX",
  "scraped_at": "2025-02-18T12:00:00.000Z",
  "gbp_score": {
    "total_score": 88,
    "breakdown": {
      "profile": "15/15",
      "categories": "10/10",
      "information": "10/10",
      "reviews": "15/15",
      "photos": "10/10",
      "services": "8/10",
      "website": "10/10",
      "activity": "5/5",
      "attributes": "4/5",
      "visibility": "9/10"
    },
    "findings": {
      "critical": [],
      "needs_improvement": ["Incomplete secondary attributes"],
      "good": [
        "Multiple relevant business categories listed",
        "Consistent contact info (NAP)",
        "Strong rating (4.9⭐ with 248 reviews)",
        "Rich photo gallery",
        "Website connected"
      ]
    }
  }
}
```

---

## 4. Pricing & Licensing Tiers

* **Free Trial ($0):** 50 free leads initial quota per device ID in Supabase.
* **Lifetime Pro ($9.99 One-Time):** Unlimited scrapes and leads forever. No monthly subscriptions, caps, or recurring fees.

---

## 5. Security & Privacy Policy

* **100% On-Device Processing:** Zero remote servers, databases, or cloud storage for lead records.
* **No Third-Party Data Transmission:** Scraped leads stay on the user's computer inside `chrome.storage.local`.
* **Manifest V3 Compliant:** Bundles all styling and scripts locally without dynamic remote script execution.