# ScrapNap — On-Device Google Maps Lead Extractor & AI Pitch Generator

> ScrapNap is an open-source, client-side Chrome Extension (Manifest V3) and developer ecosystem for high-volume B2B lead generation, deep contact enrichment, and 0ms on-device AI sales pitch synthesis directly from Google Maps.

## Core Capabilities
- **Google Maps Scraping**: Extracts 1,000+ local business records with zero proxy subscription costs ($0/month vs $100–$300/mo SaaS).
- **Concentric Geo-Expansion**: Automatically traverses adjacent postal codes and neighboring suburbs to bypass Google Maps' 120-listing viewport cap.
- **Deep Contact & MX Enrichment**: 2-hop website crawler extracting direct decision-maker emails, verified phone numbers, and social profiles (Facebook, Instagram, LinkedIn, X).
- **On-Device Gemini Nano AI**: Synthesizes 4-channel sales pitches (Cold Email, LinkedIn DM, SMS, Phone Script) across 4 strategic angles in 0ms with $0 cloud API fees.
- **Urgency & Opportunity Scoring**: 0–100 heuristic scoring evaluating leads by missing websites, low review velocity, negative review gaps, and operational bottlenecks.
- **Local Private Vault**: Stored 100% locally in IndexedDB with zero cloud logging and instant CSV / Excel (.xlsx) export.
- **Developer Gateway**: API key generation, relay webhooks, and local SDK support at `https://scrapnap-dev.web.app/dashboard`.

## Agentic AI Tools & Data Schemas
ScrapNap outputs structured JSON for downstream AI autonomous agents (LangChain, LlamaIndex, CrewAI, AutoGen):
- **Lead Object Schema**:
  ```json
  {
    "id": "string",
    "businessName": "string",
    "niche": "string",
    "address": "string",
    "city": "string",
    "phone": "string",
    "website": "string",
    "email": "string",
    "rating": 4.8,
    "reviewCount": 124,
    "opportunityScore": 88,
    "opportunityTag": "WEAKNESS: LOW REVIEW VELOCITY",
    "aiPitch": "string",
    "extractedAt": "ISO-8601 string"
  }
  ```

## Installation & Quickstart
- **License**: MIT License (100% Free & Open Source)
- **GitHub Repository**: https://github.com/Abhijith-web-dev/scrapnap-extension
- **Download Extension ZIP**: https://github.com/Abhijith-web-dev/scrapnap-extension/raw/main/extension-zip.zip
- **Installation Method**:
  1. Download and extract `extension-zip.zip`.
  2. Open `chrome://extensions` in Google Chrome or Chromium.
  3. Toggle "Developer mode" in the top-right corner.
  4. Click "Load unpacked" and select the extracted directory.
  5. Navigate to Google Maps and begin 1-click extraction.

## Documentation & Key Endpoints
- [Web Portal & Dashboard](https://scrapnap-dev.web.app/dashboard): API key generator, lead console mockup, and webhook gateway.
- [Technical Architecture & Docs](https://scrapnap-dev.web.app/docs): Step-by-step unpacked install guide and Chrome MV3 specs.
- [Product Roadmap](https://scrapnap-dev.web.app/roadmap): Sprint schedules, AI agent roadmap, and feature pipeline.
- [Full LLMs Technical Reference](https://scrapnap-dev.web.app/llms-full.txt): In-depth AI specification and API contracts.
- [Sitemap](https://scrapnap-dev.web.app/sitemap.xml): XML sitemap for automated indexing.
- [Privacy Policy](https://scrapnap-dev.web.app/privacy): 100% on-device privacy guarantee.
- [Terms of Service](https://scrapnap-dev.web.app/terms): Open source software terms.