antigravity-seo-kit 2.0.0

package/.agent/skills/seo/references/local-schema-types.md

@@ -0,0 +1,230 @@
+<!-- Updated: 2026-03-23 -->
+# Local Schema Types & Industry-Specific Patterns (March 2026)
+
+Schema is NOT a direct ranking factor (Confirmed: John Mueller, Gary Illyes). It indirectly impacts visibility through rich results (43% CTR increase, Webstix case study), better entity understanding, and AI search features.
+
+---
+
+## Google-Supported LocalBusiness Subtypes
+
+### Food & Dining
+
+| Schema Type | Use For |
+|-------------|---------|
+| `Restaurant` | Full-service restaurants |
+| `CafeOrCoffeeShop` | Coffee shops, cafes |
+| `BarOrPub` | Bars, pubs, taverns |
+| `Bakery` | Bakeries |
+| `FastFoodRestaurant` | Fast food, quick service |
+| `IceCreamShop` | Ice cream, frozen yogurt |
+| `FoodEstablishment` | Generic food (avoid if specific subtype exists) |
+
+### Healthcare
+
+| Schema Type | Use For |
+|-------------|---------|
+| `MedicalClinic` | Clinics, urgent care (eligible for rich results) |
+| `Hospital` | Hospitals (eligible for rich results) |
+| `Dentist` | Dental offices (eligible for rich results) |
+| `Physician` | Individual doctor pages (use with Person) |
+| `Optician` | Eye care, optical shops |
+| `Pharmacy` | Pharmacies |
+| `MedicalBusiness` | Generic medical (avoid if specific subtype exists) |
+
+### Legal
+
+| Schema Type | Use For | Notes |
+|-------------|---------|-------|
+| `LegalService` | Law firms, legal practices | **Correct type** |
+| ~~`Attorney`~~ | ~~Individual attorneys~~ | **DEPRECATED by Schema.org. Use `LegalService` + `Person`** |
+
+### Home Services
+
+| Schema Type | Use For |
+|-------------|---------|
+| `Plumber` | Plumbing services |
+| `Electrician` | Electrical services |
+| `HVACBusiness` | Heating, ventilation, AC |
+| `RoofingContractor` | Roofing |
+| `GeneralContractor` | General contracting |
+| `HousePainter` | Painting services |
+| `Locksmith` | Locksmith services |
+| `MovingCompany` | Moving services |
+| `HomeAndConstructionBusiness` | Generic (avoid if specific subtype exists) |
+
+### Real Estate
+
+| Schema Type | Use For | Notes |
+|-------------|---------|-------|
+| `RealEstateAgent` | Both agents AND brokerages | No `RealEstateBrokerage` type exists |
+
+### Automotive
+
+| Schema Type | Use For |
+|-------------|---------|
+| `AutoDealer` | Sales departments |
+| `AutoRepair` | Service departments |
+| `AutoPartsStore` | Parts departments |
+
+### Other Common Local Types
+
+`AnimalShelter`, `BeautySalon`, `ChildCare`, `DaySpa`, `DryCleaningOrLaundry`, `EmergencyService`, `EmploymentAgency`, `EntertainmentBusiness`, `FinancialService`, `FireStation`, `FurnitureStore`, `GasStation`, `GolfCourse`, `GovernmentOffice`, `HealthClub`, `Hotel`, `InsuranceAgency`, `Library`, `LodgingBusiness`, `NightClub`, `PetStore`, `PoliceStation`, `PostOffice`, `RecyclingCenter`, `ShoppingCenter`, `SkiResort`, `SportsActivityLocation`, `Store`, `TouristInformationCenter`, `TravelAgency`, `VeterinaryCare`
+
+---
+
+## Required vs Recommended Properties
+
+Per Google Developers documentation (updated December 10, 2025, Confirmed).
+
+### Required (Minimum)
+
+| Property | Type | Notes |
+|----------|------|-------|
+| `name` | Text | Business name, must match GBP exactly |
+| `address` | PostalAddress | With streetAddress, addressLocality, addressRegion, postalCode |
+
+### Recommended
+
+| Property | Type | Notes |
+|----------|------|-------|
+| `aggregateRating` | AggregateRating | Rating summary with reviewCount |
+| `geo` | GeoCoordinates | **Minimum 5 decimal places** (Confirmed, ~1.1m accuracy) |
+| `openingHoursSpecification` | OpeningHoursSpecification | Standard, late-night, 24h, seasonal |
+| `telephone` | Text | Must match GBP and page NAP |
+| `url` | URL | Canonical URL for this location |
+| `priceRange` | Text | Under 100 characters |
+| `image` | URL | Business photo |
+| `review` | Review | Individual reviews |
+| `department` | LocalBusiness | For nested departments (auto dealers) |
+| `menu` | URL or Menu | Restaurants only |
+| `servesCuisine` | Text | Restaurants only |
+
+### SAB-Specific
+
+| Property | Type | Notes |
+|----------|------|-------|
+| `areaServed` | Place/GeoShape | NOT in Google's official recommended list but supported by Schema.org. Industry-recommended for SABs. Use named cities with `sameAs` links to Wikipedia/Wikidata. |
+
+---
+
+## Industry-Specific Schema Patterns
+
+### Restaurant
+```
+Restaurant (or specific subtype)
+  + Menu > MenuSection > MenuItem (name, price, nutrition, suitableForDiet)
+  + ReserveAction (booking capabilities)
+  + OrderAction (takeout/delivery)
+  + servesCuisine, acceptsReservations
+```
+Note: Google Food Ordering (GFO) direct checkout discontinued June 2024. "Order Online" button now redirects to third-party platforms.
+
+### Healthcare
+```
+MedicalClinic (or Hospital, Dentist)
+  + Physician pages: Person + medicalSpecialty + hospitalAffiliation + hasCredential
+  + MedicalSpecialty (helps match "hip replacement surgery" to relevant pages)
+  + sameAs: link to NPI Registry entry and medical board page
+```
+**HIPAA constraint**: Cannot confirm/deny reviewer is a patient in review responses. Fine precedent: $30,000 (Manasa Health Center, 2023).
+
+### Legal
+```
+LegalService (NOT Attorney -- deprecated)
+  + Person on attorney bio pages: jobTitle, worksFor, alumniOf, hasCredential (bar admissions)
+  + makesOffer > Service (one per practice area)
+  + Practitioner GBP: unique phone per attorney, not sole lawyer at firm
+```
+Note: Reviews follow practitioner listing when attorney changes firms.
+
+### Home Services
+```
+Specific subtype (Plumber, Electrician, etc.)
+  + areaServed: named cities with sameAs to Wikipedia/Wikidata
+  + Service on individual service pages, linked via provider
+  + hasOfferCatalog for service listings
+```
+**SAB note**: Service area in GBP does NOT currently impact rankings -- rankings based on verification address (Sterling Sky, March 2025).
+
+### Real Estate
+```
+RealEstateAgent (for both agent and brokerage)
+  + Person on agent pages: memberOf (brokerage), credentials
+  + RealEstateListing + SingleFamilyResidence/Apartment + Offer (pricing)
+  + Event for open houses with organizing agent
+```
+Note: No `RealEstateBrokerage` type exists on Schema.org.
+
+### Automotive
+```
+AutoDealer (sales)
+  + Car/Vehicle: VIN, mileage, fuelType, vehicleTransmission
+  + Offer: price, priceCurrency, availability
+  + Separate GBP: AutoRepair (service), AutoPartsStore (parts)
+```
+**VehicleListing deprecated June 12, 2025** (Confirmed). Use Car + Offer instead. Feed-based Vehicle Listings via Google Merchant Center still functional.
+
+---
+
+## Industry-Specific Citation Sources
+
+### Restaurant
+Yelp, TripAdvisor (1B+ reviews), OpenTable (DA + bookings), DoorDash, UberEats, Grubhub, Foursquare (powers Apple Maps, Uber)
+
+### Healthcare
+Healthgrades (50% of Americans who see a doctor visit), Zocdoc (booking + lead gen), WebMD physician directory (high DA), Vitals, Doximity (80% of US physicians), NPI Registry (entity verification source of truth), state medical board directories
+
+### Legal
+FindLaw (DA~91, dofollow), Martindale-Hubbell (DA~84, peer review since 1868), Avvo (1-10 ratings, auto-created from bar data), Justia (DA~70, free profiles), Super Lawyers (top 5%, selection-based), state bar directories (entity verification)
+
+Note: Internet Brands (KKR) owns Avvo + Martindale + Lawyers.com + Nolo. Thomson Reuters owns FindLaw + Super Lawyers + LawInfo.
+
+### Home Services
+Thumbtack ($400M revenue 2024, integrations with ChatGPT/Alexa/Zillow), BBB, Nextdoor, Yelp. **Declining**: Angi (revenue -30% from 2022 peak), Porch (pivoted to insurance), Houzz (pivoted to SaaS)
+
+### Real Estate
+Zillow (44% of all RE search traffic, integrated into ChatGPT Oct 2025), Homes.com (#2, overtook Realtor.com, 100M monthly visitors), Realtor.com, Redfin (acquired by Rocket Companies Mar 2025), local MLS sites
+
+### Automotive
+Cars.com, AutoTrader, CarGurus, DealerRater (reviews syndicate to Cars.com + OEM sites, supports salesperson ratings), Edmunds, Kelley Blue Book (pricing authority), OEM manufacturer dealer locators (entity verification)
+
+---
+
+## Multi-Location Schema Pattern
+
+```json
+// Homepage: Organization with branchOf references
+{
+  "@context": "https://schema.org",
+  "@type": "Organization",
+  "@id": "https://example.com/#org",
+  "name": "Brand Name",
+  "url": "https://example.com"
+}
+
+// Each location page: individual LocalBusiness
+{
+  "@context": "https://schema.org",
+  "@type": "Dentist",
+  "@id": "https://example.com/locations/downtown/#location",
+  "name": "Brand Name - Downtown",
+  "branchOf": { "@id": "https://example.com/#org" },
+  "address": { ... },
+  "geo": { "latitude": "40.71234", "longitude": "-74.00567" },
+  "telephone": "+1-555-123-4567",
+  "openingHoursSpecification": [ ... ]
+}
+```
+
+Use `@id` for unique identifiers per location. Subdirectory structure recommended: `domain.com/locations/city-name/` (subdirectory consolidates link equity better than subdomain, Bruce Clay study: 50%+ traffic lift).
+
+---
+
+## Deprecated/Invalid Local Schema
+
+| Type | Status | Date | Use Instead |
+|------|--------|------|-------------|
+| `Attorney` | Deprecated by Schema.org | -- | `LegalService` + `Person` |
+| `VehicleListing` | Rich results removed | June 12, 2025 | `Car` + `Offer` |
+| `HowTo` | Rich results removed | September 2023 | None |
+| `SpecialAnnouncement` | Deprecated | July 31, 2025 | None |

package/.agent/skills/seo/references/local-seo-signals.md

@@ -0,0 +1,218 @@
+<!-- Updated: 2026-03-23 -->
+# Local SEO Ranking Signals & Benchmarks (March 2026)
+
+## Source Key
+
+- **Confirmed**: Google official documentation or employee statements
+- **Study**: Data-driven industry research from recognized firms
+- **Consensus**: Practitioner agreement without controlled testing
+- **Caution**: Single-source or unverified claims
+
+---
+
+## Whitespark 2026 Local Search Ranking Factors
+
+Published November 6, 2025. 47 experts surveyed across 187 factors. (Study)
+
+### Local Pack/Maps Factor Groups
+
+| Factor Group | Weight | Trend |
+|---|---|---|
+| GBP Signals | **32%** | Stable (top group) |
+| Review Signals | **~20%** | Up from ~16% in 2023 |
+| On-Page Signals | ~15-19% | Slight decline |
+| Link Signals | Declining | Continued multi-year drop |
+| Behavioral/Engagement | Rising | Clicks, calls, direction requests |
+| Citation Signals | Lower for Pack | But 3 of top 5 AI visibility factors are citation-related |
+| Social Signals | New entry | First time measured |
+| AI Search Signals | New category | Added for the first time |
+
+### Top 15 Individual Local Pack Factors
+
+1. Primary GBP category (score: 193)
+2. Keywords in GBP business title (score: 181)
+3. Proximity of address to search point (score: 176)
+4. Verified GBP
+5. Business open at time of search (Sterling Sky controlled study)
+6. High numerical Google ratings
+7. Quantity of native Google reviews
+8. Additional GBP categories
+9. Review recency/velocity
+10. Dedicated service pages
+11. Domain authority
+12. NAP consistency
+13. Spam listing removal
+14. Quality backlinks
+15. Review sentiment
+
+### Top Negative Factors
+
+1. Incorrect primary category (score: 176) -- single worst mistake
+2. Duplicate profiles at same address (score: 142)
+
+---
+
+## Search Atlas ML Study (August 2025)
+
+XGBoost regression model, explains 92-93% of variance. (Study)
+
+| Factor | Variance Explained |
+|--------|-------------------|
+| Proximity | **55.2%** |
+| Review Count | **19.2%** |
+| Domain Power | 5.9% |
+| Semantic Relevance in Reviews | 5.3% |
+| All others | <5% each |
+
+---
+
+## Review Benchmarks
+
+### Sterling Sky Findings (2025, Study)
+
+- **Magic 10 threshold**: Significant ranking boost at 10 reviews. 9-to-10 = noticeable increase. 10-to-11 = no similar bump.
+- **18-Day Rule**: Rankings "fall off a cliff" if no new reviews for 3 weeks. Velocity > volume.
+
+### BrightLocal LCRS 2026 (February 2026, Study)
+
+| Metric | Value |
+|--------|-------|
+| Only care about reviews in last 3 months | 74% |
+| "Always" read reviews | 41% (up from 29% in 2025) |
+| Only use 4.5+ stars | 31% (up from 17% in 2025) |
+| Only use 4+ stars | 68% (up from 55% in 2025) |
+| Consumers use average review sites | 6 platforms |
+
+### Review Platform Usage (BrightLocal 2026)
+
+| Platform | Usage | Trend |
+|----------|-------|-------|
+| Google | 71% | Down from 83% in 2025 |
+| Instagram | 37% | Rising |
+| TikTok | 29% | Rising |
+| Apple Maps | 27% | Up from 14% in 2025 |
+
+### Enforcement
+
+- Google blocked/removed **240M+ policy-violating reviews** in 2024 (Confirmed, 40% increase over 2023)
+- Review deletion rates up **600%+** Jan-Jul 2025; 38% of deleted were 5-star (Study, GMBapi.com)
+- FTC Consumer Review Rule effective Oct 21, 2024: penalties up to **$53,088/violation** (Confirmed, US law)
+- **Review gating prohibited** by both Google (fake engagement policy) and FTC (Confirmed)
+
+---
+
+## Citation Source Tiers
+
+### Tier 1 (Universal, All Industries)
+
+| Source | Why It Matters |
+|--------|---------------|
+| Google Business Profile | Primary local signal source |
+| Apple Business Connect | Usage nearly doubled, from 14% to 27% (BrightLocal 2026). 1B+ iPhone users |
+| Bing Places | Overhauled Oct 2025. Powers ChatGPT, Copilot, Alexa. 900M queries/day |
+| Facebook | Social + citation signal |
+| Yelp | Still ranks on page 1 for many local queries |
+
+### Tier 2 (Broad Directories)
+
+BBB, YellowPages, Manta, Superpages, Foursquare, Nextdoor
+
+### Tier 3 (Data Aggregators)
+
+| Aggregator | Partnerships |
+|-----------|-------------|
+| Data Axle (formerly Infogroup) | Google, Bing, Apple |
+| Foursquare | Merged with Factual. Powers Uber, Nextdoor, Yahoo, ChatGPT. 500M+ devices |
+| Neustar/TransUnion Digital | 80+ platform partnerships including Bing, Apple |
+
+### Industry-specific directories: see `local-schema-types.md`
+
+---
+
+## GBP Feature Status (March 2026)
+
+### Deprecated/Removed
+
+| Feature | Date | Replacement |
+|---------|------|------------|
+| Q&A section | Dec 3, 2025 | Ask Maps (Gemini AI) |
+| GBP Messaging/Chat | Removed | None |
+| Call History/Tracking | Jul 31, 2024 | None |
+| GBP-hosted websites | Discontinued | Redirect to social/website |
+| School reviews/ratings | Apr 30, 2025 | None |
+
+### Active Features
+
+Posts (with scheduling), Services menu, Attributes (including identity: Women-led, Eco-friendly), Photos/Video, Local Lists (Local Gems, Trending, Top List), AI-generated "Suggest Description", Google Verified badge (replaced Guaranteed/Screened Oct 2025)
+
+### Key GBP Insights
+
+- **Posts**: No direct ranking impact (WebFX empirical testing). Can trigger Post Justifications. (Study)
+- **Photos**: "Likely a ranking benefit adding some vs none, but not continued benefit adding more" (WebFX). Geotagging has NO impact. 45% more direction requests with photos. (Study/Confirmed mix)
+- **Attributes**: Identity attributes have minor, targeted impact for attribute-specific searches only (WebFX/Sterling Sky). General attributes are filter/informational, NOT direct ranking factors. (Study)
+
+---
+
+## Algorithm Updates Affecting Local (2025-2026)
+
+| Update | Date | Impact | Source |
+|--------|------|--------|--------|
+| March 2025 Core | Mar 13-27 | Emphasized E-E-A-T, penalized thin/AI content | Confirmed |
+| June 2025 Core | Jun-Jul 17 | General quality focus | Confirmed |
+| August 2025 Spam | Aug 26-Sep 22 | Targeted keyword stuffing, fake reviews, PBNs. Local Pack often stable | Confirmed |
+| December 2025 Core | Dec 11-29 | Enhanced E-E-A-T, behavioral signal weighting | Confirmed |
+| February 2026 Discover Core | Feb 5-27 | Discover-only; favored local expertise | Confirmed |
+| "Diversity Update" | 2025 | Harder to rank in both map pack AND organic simultaneously | Study (Sterling Sky) |
+
+---
+
+## Voice Search & Assistants
+
+- 58% of voice searches are for local business information (Study, BusinessDasher)
+- Voice queries typically 4-7 words, phrased as complete questions (Consensus)
+- 80%+ of Google Assistant voice answers come from top 3 search results (Study)
+
+| Voice Assistant | Primary Data Source |
+|-----------------|-------------------|
+| Google Assistant | GBP (transitioning to Gemini) |
+| Siri (Apple) | Apple Business Connect + Yelp |
+| Alexa (Amazon) | Bing Places + Yelp + aggregators |
+
+---
+
+## AI Search Impact on Local
+
+| Metric | Value | Source |
+|--------|-------|--------|
+| ChatGPT/AI for local recommendations | 45% of users (up from 6%) | BrightLocal LCRS 2026 |
+| ChatGPT conversion rate | 15.9% | Seer Interactive |
+| Google organic conversion rate | 1.76% | Seer Interactive |
+| AI Overviews on local searches | Up to 68% | Whitespark Q2 2025 |
+| AI Overview CTR reduction for pos 1 | -58% | Ahrefs, Feb 2026 |
+| Brand cited in AIO = organic CTR boost | +35% | Seer Interactive |
+| ChatGPT traffic vs Google for local | ~2% | Sterling Sky, Feb 2026 |
+| Top 5 AI visibility factors: 3 are citation-related | -- | Whitespark 2026 |
+
+**ChatGPT sources**: Bing web index (primary), Yelp, TripAdvisor, BBB, Reddit. Does NOT access GBP directly. (Study, Search Engine Land)
+
+**Perplexity sources**: Authority-first. 40% more from high-authority sites. Averages 21.87 citations per question. (Study, Qwairy)
+
+---
+
+## Local Pack Structure
+
+- Standard: **3 results** (universal)
+- New: Curated Local Lists (Local Gems, Trending) around position 4 (SOCi, Nov 2025)
+- AI-powered local packs (mobile US): Only 1-2 businesses, 32% fewer businesses shown (Sterling Sky)
+- Local pack ads grew from ~1% to **22%** of tracked mobile keywords in 12 months (Sterling Sky/Places Scout)
+- Zero-click rate for local-intent searches: up to **78%** on mobile (Similarweb)
+
+---
+
+## Proximity & Search Behavior
+
+- 46% of all Google searches seek local information (Study)
+- 76% of mobile "near me" searches lead to visit within 24 hours (Confirmed, Google)
+- 900% increase in "near me" searches over two years (Confirmed/Study, Google)
+- Proximity varies: urban 1-2 miles, rural 5-10+ miles, specialty/niche = wider (Consensus)
+- Google uses dynamic weighting per query: "emergency plumber near me" = proximity-dominant; "best plastic surgeon" = prominence-dominant (Consensus)

package/.agent/skills/seo/references/maps-api-endpoints.md

@@ -0,0 +1,160 @@
+<!-- Updated: 2026-03-23 -->
+# DataForSEO Maps & Business Data API Endpoints
+
+## Source Key
+
+- **Docs**: docs.dataforseo.com (official API documentation)
+- **Pricing**: dataforseo.com/pricing (official pricing pages)
+
+---
+
+## Authentication & Limits
+
+- HTTP Basic Auth (login:password)
+- Rate limit: **2,000 API calls/minute** across all endpoints
+- Each POST supports up to **100 tasks** in a single request
+- Minimum deposit: $50. $1 free trial credit. Credits never expire.
+
+---
+
+## Google Maps SERP API (Geo-Grid Backbone)
+
+**Endpoint:** `POST https://api.dataforseo.com/v3/serp/google/maps/live/advanced`
+**Pricing source:** https://dataforseo.com/pricing/serp-api
+
+### Request Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `keyword` | Yes | Search query (e.g., "dentist") |
+| `location_name` | No | Named location (e.g., "Austin,Texas,United States") |
+| `location_code` | No | DataForSEO location code (e.g., 1026339 for Austin) |
+| `location_coordinate` | No | `"latitude,longitude,zoom"` (max 7 decimals, zoom 3z-21z) |
+| `language_code` | No | Default: "en" |
+| `device` | No | "desktop" or "mobile" |
+| `depth` | No | Number of results to return |
+
+**Critical for geo-grid:** Use `location_coordinate` to simulate searches from specific GPS points. Format: `"40.7128,-74.0060,15z"`.
+
+### Response Fields (per business item)
+
+`cid`, `place_id`, `feature_id`, `title`, `domain`, `url`, `category`, `additional_categories`, `address`, `phone` (via `contact_info` array), `rating.value`, `rating.votes_count`, `rating.rating_distribution` (1-5 star breakdown), `price_level`, `attributes` (grouped: accessibility, payments, children), `work_time` (per-day timetable + `current_status`), `popular_times` (hourly by day), `latitude`, `longitude`, `local_business_links` (booking, menu, order URLs)
+
+### Pricing
+
+| Method | Cost per task | Turnaround |
+|--------|--------------|------------|
+| Standard | $0.0006 (100 desktop / 20 mobile results) | Up to 5 min |
+| Priority | $0.0012 | Up to 1 min |
+| **Live** | **$0.002** | Up to 6 sec |
+
+Search operators in keyword multiply cost by 5x.
+
+---
+
+## Google My Business Info API (Single Business Deep-Dive)
+
+**Endpoint:** `POST https://api.dataforseo.com/v3/business_data/google/my_business_info/live`
+**Pricing source:** https://dataforseo.com/pricing/business-data
+
+### Input Options
+
+- `keyword`: Business name + location (e.g., "Starbucks Austin TX")
+- `"cid:XXXX"`: Direct CID lookup
+- `"place_id:XXXX"`: Direct Place ID lookup
+
+### Response Fields
+
+Full profile: `title`, `description`, `category`, `additional_categories`, `category_ids`, `attributes` (available + unavailable, grouped by type), `contact_info` (phone array), `domain`, `url`, `work_hours` (per-day with open/close times), `popular_times`, `cid`, `place_id`, `rating` (with distribution), `address_info` (full breakdown), `latitude`/`longitude`, `photos_count`, `main_image`
+
+**Cost:** $0.0015 per profile (standard queue)
+
+**Use case:** Deep-dive on the TARGET business. Maps SERP for competitor discovery.
+
+---
+
+## Google Reviews API (Sentiment & Velocity)
+
+**Endpoint:** `POST https://api.dataforseo.com/v3/business_data/google/reviews/task_post`
+**Pricing source:** https://dataforseo.com/pricing/business-data
+
+### Parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| `keyword` | Business name + location (or CID/place_id) |
+| `depth` | Number of reviews to retrieve |
+| `sort_by` | `"highest_rating"`, `"lowest_rating"`, `"most_relevant"`, `"newest"` |
+
+### Response Fields (per review)
+
+`review_text`, `original_review_text`, `time_ago`, `timestamp`, `rating.value`, `review_id`, `profile_name`, `profile_url`, `profile_image_url`, `owner_answer` (text + timestamp), `review_images`
+
+### Pricing
+
+| Method | Input Type | Cost |
+|--------|-----------|------|
+| Standard (per 10 reviews) | keyword | $0.003 |
+| Extended (per 20 reviews) | keyword | $0.003 |
+| Extended (per 20 reviews) | place_id/CID | **$0.00075** |
+
+**Optimization:** Always use `place_id` or `cid` input (4x cheaper than keyword).
+
+---
+
+## Google Q&A API
+
+**Endpoint:** `POST https://api.dataforseo.com/v3/business_data/google/questions_and_answers/live`
+
+Returns questions, answers, upvotes, dates, answer sources. Live and standard methods available.
+
+**Use case:** Identify unanswered questions, FAQ gap analysis.
+
+**Note:** Google deprecated GBP Q&A in Dec 2025 (replaced by Ask Maps Gemini AI). This endpoint returns historical data.
+
+---
+
+## Business Listings Search (Pre-Indexed Database)
+
+**Endpoint:** `POST https://api.dataforseo.com/v3/business_data/business_listings/search/live`
+
+Queries DataForSEO's pre-indexed database (not live Google). Faster for bulk category-based queries. Up to 700+ results per query.
+
+**Categories Aggregation:** `/v3/business_data/business_listings/categories_aggregation/live` provides category taxonomy.
+
+**MCP tool name:** `business_data_business_listings_search`
+
+---
+
+## Cross-Platform Review APIs
+
+### Tripadvisor
+
+- Search: `/v3/business_data/tripadvisor/search/task_post`
+- Reviews: `/v3/business_data/tripadvisor/reviews/task_post`
+- Billed per 30 reviews. Standard method only.
+
+### Trustpilot
+
+- Search: `/v3/business_data/trustpilot/search/task_post`
+- Reviews: `/v3/business_data/trustpilot/reviews/task_post`
+- ~$0.00075/task. Standard method only.
+
+---
+
+## Cost Estimation Table
+
+| Operation | API Calls | Est. Cost (Live) |
+|-----------|-----------|-----------------|
+| 7x7 geo-grid, 1 keyword | 49 | $0.098 |
+| 7x7 geo-grid, 3 keywords | 147 | $0.294 |
+| 3x3 geo-grid, 1 keyword | 9 | $0.018 |
+| Target business profile | 1 | $0.0015 |
+| 100 reviews (via place_id) | 5 | $0.00375 |
+| 20 competitor profiles | 20 | $0.03 |
+| GBP posts audit | 1 | ~$0.002 |
+| Q&A retrieval | 1 | ~$0.002 |
+| **Full audit (1-keyword grid)** | **~73** | **~$0.13** |
+| **Full audit (3-keyword grid)** | **~171** | **~$0.33** |
+
+**Formula:** `grid_size^2 x keywords x $0.002` (live) or `x $0.0006` (standard)