alirezarezvani/claude-skills / marketing-skill/skills/local-seo-manager
local-seo-manager
VerifiedUse for any local business's Google Business Profile, Maps ranking, service-area pages, citations or review replies, before writing. Checks NAP consistency with nap_checker.py and generates LocalBusiness schema and area pages with its scripts.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.6 KB |
| references/local-schema-types.md | markdown | 7.9 KB |
| references/local-seo-checklist.md | markdown | 6.0 KB |
| references/review-response-templates.md | markdown | 8.3 KB |
| scripts/nap_checker.py | script | 12.5 KB |
| scripts/schema_generator.py | script | 10.8 KB |
| scripts/service_area_generator.py | script | 11.6 KB |
scripts/schema_generator.py
View on GitHub#!/usr/bin/env python3
"""
schema_generator.py — LocalBusiness JSON-LD schema generator for local service businesses.
Generates valid schema.org JSON-LD for LocalBusiness, HomeAndConstructionBusiness,
Service, and FAQPage types — ready to paste into WordPress (Rank Math custom schema
or wp_head hook) or any HTML <head>.
Usage:
python3 schema_generator.py [--config config.json] [--type local-business|service-area|faq]
If no config provided, runs with embedded sample data.
Output: JSON-LD block(s) ready for <script type="application/ld+json"> tags.
"""
import json
import argparse
from typing import Dict, List, Optional
# ─── Schema builders ──────────────────────────────────────────────────────────
def build_local_business(config: Dict) -> Dict:
"""Build LocalBusiness + HomeAndConstructionBusiness schema."""
address = config.get('address', {})
schema = {
"@context": "https://schema.org",
"@type": ["LocalBusiness", "HomeAndConstructionBusiness"],
"name": config['business_name'],
"url": config['website'],
"telephone": config['phone'],
"priceRange": config.get('price_range', '$$'),
"image": config.get('logo_url', ''),
"description": config.get('description', ''),
"address": {
"@type": "PostalAddress",
"streetAddress": address.get('street', ''),
"addressLocality": address.get('city', ''),
"addressRegion": address.get('state', ''),
"postalCode": address.get('zip', ''),
"addressCountry": "US"
},
"openingHoursSpecification": _build_hours(config.get('hours', {})),
"sameAs": config.get('social_profiles', []),
"hasMap": config.get('google_maps_url', ''),
"areaServed": _build_area_served(config.get('service_areas', [])),
"knowsAbout": config.get('services', []),
"aggregateRating": _build_aggregate_rating(config.get('reviews', {})),
}
# Only emit geo coordinates when BOTH are supplied — blank lat/long is invalid
# per the Rich Results validator this skill tells users to run.
lat = config.get('latitude', '')
lng = config.get('longitude', '')
if lat not in ('', None) and lng not in ('', None):
schema["geo"] = {"@type": "GeoCoordinates", "latitude": lat, "longitude": lng}
# Clean empty values
schema = {k: v for k, v in schema.items() if v not in ('', [], {}, None)}
return schema
def build_service(config: Dict, service_name: str, neighborhood: str = '', description: str = '') -> Dict:
"""Build Service schema for a specific service page."""
schema = {
"@context": "https://schema.org",
"@type": "Service",
"serviceType": service_name,
"provider": {
"@type": "LocalBusiness",
"name": config['business_name'],
"telephone": config['phone'],
"url": config['website'],
},
"areaServed": {
"@type": "City",
"name": config.get('city', ''),
},
"description": description or f"Professional {service_name.lower()} in {neighborhood or config.get('city', '')}.",
}
if neighborhood:
schema["areaServed"] = {
"@type": "Place",
"name": f"{neighborhood}, {config.get('city', '')}",
}
return schema
def build_faq_page(faqs: List[Dict]) -> Dict:
"""Build FAQPage schema from list of {question, answer} dicts."""
return {
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": faq['question'],
"acceptedAnswer": {
"@type": "Answer",
"text": faq['answer']
}
}
for faq in faqs
]
}
def build_service_area_page_schemas(config: Dict, neighborhood: str, primary_service: str, faqs: Optional[List[Dict]] = None) -> List[Dict]:
"""Return all schema blocks needed for a service area page."""
schemas = [
build_local_business(config),
build_service(config, primary_service, neighborhood),
]
if faqs:
schemas.append(build_faq_page(faqs))
return schemas
# ─── Helpers ──────────────────────────────────────────────────────────────────
def _build_hours(hours: Dict) -> List[Dict]:
if not hours:
return []
day_map = {
'monday': 'Monday', 'tuesday': 'Tuesday', 'wednesday': 'Wednesday',
'thursday': 'Thursday', 'friday': 'Friday', 'saturday': 'Saturday', 'sunday': 'Sunday'
}
specs = []
for day, times in hours.items():
if times and times.get('open') and times.get('close'):
specs.append({
"@type": "OpeningHoursSpecification",
"dayOfWeek": f"https://schema.org/{day_map.get(day.lower(), day)}",
"opens": times['open'],
"closes": times['close']
})
return specs
def _build_area_served(areas: List[str]) -> List[Dict]:
return [{"@type": "Place", "name": area} for area in areas]
def _build_aggregate_rating(reviews: Dict) -> Optional[Dict]:
# Require BOTH count and average — never fabricate a rating value. Google
# cross-checks aggregateRating against GBP; a made-up score risks a manual
# action (see references/local-schema-types.md).
if not reviews or not reviews.get('count') or not reviews.get('average'):
return None
return {
"@type": "AggregateRating",
"ratingValue": str(reviews['average']),
"bestRating": "5",
"worstRating": "1",
"ratingCount": str(reviews['count'])
}
def format_as_script_tag(schema: Dict) -> str:
return f'<script type="application/ld+json">\n{json.dumps(schema, indent=2)}\n</script>'
# ─── Sample data ──────────────────────────────────────────────────────────────
SAMPLE_CONFIG = {
"business_name": "Smart Solution Appliances",
"website": "https://smartsolutionappliances.com",
"phone": "(415) 555-0100",
"price_range": "$$",
"city": "San Francisco",
"description": "Professional appliance repair in San Francisco. Same-day service for washers, dryers, refrigerators, dishwashers, and ovens.",
"address": {
"street": "123 Market Street",
"city": "San Francisco",
"state": "CA",
"zip": "94102"
},
"hours": {
"monday": {"open": "08:00", "close": "18:00"},
"tuesday": {"open": "08:00", "close": "18:00"},
"wednesday": {"open": "08:00", "close": "18:00"},
"thursday": {"open": "08:00", "close": "18:00"},
"friday": {"open": "08:00", "close": "18:00"},
"saturday": {"open": "09:00", "close": "15:00"},
"sunday": {"open": "", "close": ""}
},
"services": ["Washer Repair", "Dryer Repair", "Refrigerator Repair", "Dishwasher Repair", "Oven Repair"],
"service_areas": ["San Francisco", "Richmond District", "Mission District", "Pacific Heights", "Sunset District"],
"social_profiles": [
"https://www.yelp.com/biz/smart-solution-appliances-san-francisco",
"https://www.facebook.com/smartsolutionappliances"
],
"reviews": {"average": 4.8, "count": 124}
}
SAMPLE_FAQS = [
{
"question": "How quickly can you reach the Richmond District for appliance repair?",
"answer": "We offer same-day service in the Richmond District. Call before noon and we can typically arrive the same afternoon."
},
{
"question": "What appliance brands do you service in the Richmond District?",
"answer": "We repair all major brands including Samsung, LG, Whirlpool, GE, Bosch, Maytag, KitchenAid, Frigidaire, and Electrolux."
},
{
"question": "Are your technicians licensed and insured in San Francisco?",
"answer": "Yes. All Smart Solution Appliances technicians are fully licensed, bonded, and insured in California."
},
{
"question": "Do you offer a warranty on appliance repairs in Richmond District?",
"answer": "Yes. All repairs come with a 90-day parts and labor warranty."
},
]
# ─── Main ─────────────────────────────────────────────────────────────────────
def main():
parser = argparse.ArgumentParser(
description='LocalBusiness JSON-LD schema generator',
formatter_class=argparse.RawDescriptionHelpFormatter,
epilog=__doc__
)
parser.add_argument('--config', help='Path to business config JSON')
parser.add_argument('--type', choices=['local-business', 'service-area', 'faq'], default='local-business',
help='Schema type to generate')
parser.add_argument('--neighborhood', help='Neighborhood (for service-area type)', default='')
parser.add_argument('--service', help='Service name (for service-area type)', default='Appliance Repair')
parser.add_argument('--faqs', help='Path to FAQs JSON (for faq type)')
parser.add_argument('--html', action='store_true', help='Output as <script> HTML tag')
args = parser.parse_args()
if args.config:
with open(args.config) as f:
config = json.load(f)
else:
config = SAMPLE_CONFIG
print('[INFO] No --config provided. Using sample data.\n')
faqs = None
if args.faqs:
with open(args.faqs) as f:
faqs = json.load(f)
elif args.type in ('service-area', 'faq'):
faqs = SAMPLE_FAQS
if args.type == 'local-business':
schemas = [build_local_business(config)]
elif args.type == 'service-area':
schemas = build_service_area_page_schemas(
config,
neighborhood=args.neighborhood or 'Richmond District',
primary_service=args.service,
faqs=faqs
)
elif args.type == 'faq':
schemas = [build_faq_page(faqs or SAMPLE_FAQS)]
else:
schemas = [build_local_business(config)]
for schema in schemas:
if args.html:
print(format_as_script_tag(schema))
else:
print(json.dumps(schema, indent=2))
print()
if not args.html:
print('─' * 65)
print('Paste each block inside a <script type="application/ld+json"> tag.')
print('Validate at: https://validator.schema.org/')
print('Test rich results at: https://search.google.com/test/rich-results')
if __name__ == '__main__':
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |