seo

[{"code":"payment","match":"pricing","path":"SKILL.md"},{"code":"env_var","match":"GOOGLE_API_KEY","path":"references/cwv-thresholds.md"},{"code":"api_key_mention","match":"Api-Key","path":"references/cwv-thresholds.md"},{"code":"api_key_mention","match":"API key","path":"references/free-backlink-sources.md"},{"code":"payment","match":"/mo","path":"references/free-backlink-sources.md"},{"code":"payment","match":"pricing","path":"references/local-schema-types.md"},{"code":"payment","match":"Pricing","path":"references/maps-api-endpoints.md"},{"code":"payment","match":"pricing","path":"references/maps-api-endpoints.md"},{"code":"endpoint","match":"https://api.dataforseo.com/v3/serp/google/maps/live/advanced`","path":"references/maps-api-endpoints.md"},{"code":"endpoint","match":"https://api.dataforseo.com/v3/business_data/google/my_business_info/live`","path":"references/maps-api-endpoints.md"},{"code":"endpoint","match":"https://api.dataforseo.com/v3/business_data/google/reviews/task_post`","path":"references/maps-api-endpoints.md"},{"code":"endpoint","match":"https://api.dataforseo.com/v3/business_data/google/questions_and_answers/live`","path":"references/maps-api-endpoints.md"},{

# Backlink Quality Scoring Methodology

## Toxic Link Indicators (30 Patterns)

### Definite Spam (auto-flag)
1. Link from domain with 10,000+ outbound links per page
2. Link from domain with no indexed pages in Google
3. Link from domain registered <30 days ago with 100+ outbound links
4. Exact-match anchor text from 5+ unrelated domains
5. Links from doorway pages (thin content, keyword-stuffed)
6. Links from hacked sites (pharma/casino injections)
7. Links from known link networks (check against known PBN lists)
8. Footer/sidebar site-wide links from unrelated domains
9. Links from auto-generated content (spun articles)
10. Links from domains with manual Google penalties

### Likely Spam (manual review)
11. Links from domains with >90% outbound link ratio
12. Foreign-language domains linking to English content (and vice versa)
13. Links from expired/auctioned domains repurposed for link building
14. Links from pages with >50 outbound links
15. Links from sites with no real traffic (parked domains)
16. Reciprocal link patterns across 10+ domains
17. Links from Web 2.0 properties with thin content
18. Links from article directories (EzineArticles, ArticleBase)
19. Links from low-q

<!-- Updated: 2026-06-21 -->
# Core Web Vitals Thresholds (June 2026)

## Current Metrics

| Metric | Good | Needs Improvement | Poor |
|--------|------|-------------------|------|
| LCP (Largest Contentful Paint) | ≤2.5s | 2.5s–4.0s | >4.0s |
| INP (Interaction to Next Paint) | ≤200ms | 200ms–500ms | >500ms |
| CLS (Cumulative Layout Shift) | ≤0.1 | 0.1–0.25 | >0.25 |

## Key Facts
- INP replaced FID (First Input Delay) on **March 12, 2024**. FID was removed from Chrome's field-data tools (CrUX API, PageSpeed Insights) on **September 9, 2024** (Lighthouse is a lab tool that never reported FID). INP is the sole interactivity metric.
- Evaluation uses the **75th percentile** of real user data (field data from CrUX).
- Google assesses at the **page level** and the **origin level**.
- Core Web Vitals are a **tiebreaker** ranking signal: they matter most when content quality is similar between competitors.
- **Thresholds unchanged since original definitions**: ignore claims of "tightened thresholds" from SEO blogs.
- **Anti-hallucination guard**: There is **no "Visual Stability Index" (VSI)**, **no "Core Web Vitals 2.0"**, no "Engagement Reliability" metric, and no LCP-lowered-to-2.0s 

# E-E-A-T Evaluation Framework
## Per Google Quality Rater Guidelines (September 11, 2025); currency-checked June 2026

## Overview

E-E-A-T = **E**xperience, **E**xpertise, **A**uthoritativeness, **T**rustworthiness

**Trust is the most important member of the family** (Google's own wording);
Experience, Expertise, and Authoritativeness support the assessment of Trust.
E-E-A-T is a **concept in the Quality Rater Guidelines**, not a direct ranking
score — it informs the core ranking and helpful-content systems.

> **No "watershed" framing.** Google never characterized the December 2025 (or
> any 2026) core update as "extending E-E-A-T to ALL competitive queries," and
> never published per-industry traffic-drop percentages. Those figures and the
> "watershed" narrative are third-party SEO-blog interpretation — do not assert
> them as Google fact. Google's only on-record description of broad core updates
> is generic ("a regular update designed to better surface relevant, satisfying
> content … from all types of sites").

> **Continuous core updates.** Google now documents (changelog 2025-12-09) that
> it continually makes **smaller, unannounced core updates** between the major
> one

# Free Backlink Data Sources

Reference for the seo-backlinks skill. Loaded on demand when analyzing backlinks
with free sources.

## Source Comparison

| Source | Auth | Any Domain? | Data Quality | Coverage vs Commercial | Rate Limit |
|--------|------|-------------|-------------|----------------------|------------|
| **Moz API** | API key (free signup) | Yes | ★★★★☆ | ~70% for DA/PA | 1 req/10s, 2,500 rows/mo |
| **Bing Webmaster** | API key (free) | Verified sites only | ★★★☆☆ | ~15% (Bing index) | Generous |
| **Common Crawl** | None (public) | Yes | ★★★☆☆ | ~25-40% domains | N/A |
| **Verification Crawler** | None | Yes | ★★★★★ (binary) | N/A (checks known links) | 1 req/s per domain |
| **DataForSEO** (paid) | API key | Yes | ★★★★★ | ~90%+ | Per plan |

## Confidence Weighting

When merging data from multiple sources, apply confidence weights to each metric:

| Source | Weight | Rationale |
|--------|--------|-----------|
| DataForSEO | 1.00 | Commercial-grade, real-time, comprehensive |
| Verification Crawler | 0.95 | Direct observation (binary: link exists or not) |
| Moz API | 0.85 | Large index (45.5T links), established metrics, 3-day update lag |
| Bing Webmaster | 0.7

<!-- 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

<!-- 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 a

<!-- 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

### 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 |

**C

<!-- Updated: 2026-03-23 -->
# Free Maps APIs for claude-seo

## Source Key

- **Docs**: Official API documentation for each service
- **Policy**: Official usage policies and terms

---

## Overpass API (Best Free Option for Competitor Discovery)

**Base URL:** `https://overpass-api.de/api/interpreter`
**Docs:** https://wiki.openstreetmap.org/wiki/Overpass_API
**License:** ODbL (attribution required: "Data from OpenStreetMap")

### Rate Limits

- Slot-based: ~2 concurrent queries per IP
- Guideline: ~10,000 requests/day, ~1 GB/day download
- Default timeout: 180 seconds, 512 MiB memory per query
- Use `[timeout:25]` for lighter queries

### Query Templates

**Restaurants within 5km radius:**
```bash
curl -s "https://overpass-api.de/api/interpreter" \
  --data-urlencode 'data=[out:json][timeout:25];(node["amenity"="restaurant"](around:5000,LAT,LNG);way["amenity"="restaurant"](around:5000,LAT,LNG););out body;>;out skel qt;'
```

**All businesses on a street:**
```bash
curl -s "https://overpass-api.de/api/interpreter" \
  --data-urlencode 'data=[out:json][timeout:25];way["name"="STREET_NAME"]["addr:city"="CITY"];(._;>;);out body;'
```

**Competitor POIs by category in bounding box:**

---
name: seo
description: "Comprehensive SEO analysis for any website or business type. Full site audits, single-page analysis, technical SEO (crawlability, indexability, Core Web Vitals with INP), schema markup, content quality (E-E-A-T), image optimization, sitemap analysis, and GEO for AI Overviews/ChatGPT/Perplexity. Industry detection for SaaS, e-commerce, local, publishers, agencies. Triggers on: SEO, audit, schema, Core Web Vitals, sitemap, E-E-A-T, AI Overviews, GEO, technical SEO, content quality, page speed."
user-invocable: true
argument-hint: "[command] [url]"
license: MIT
metadata:
  author: AgriciDaniel
  version: "2.2.5"
  category: seo
---

# SEO: Universal SEO Analysis Skill

**Invocation:** `/seo $1 $2` where `$1` is the command and `$2` is the URL or argument.

**Runtime:** Run bundled Python tools through `claude-seo run <script.py>`. Plugin
installs expose this command automatically. Repository users run
`./bin/claude-seo`; manual installers rewrite the command to the isolated
launcher path. Never invoke bundled scripts with a bare Python interpreter.

Comprehensive SEO analysis across all industries (SaaS, local services,
e-commerce, publishers, agencies). Or