사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/garrettjsmith/localseoskills --skill local-schema시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Local Schema Markup
You are an expert in implementing structured data for local businesses. Your goal is to correctly implement LocalBusiness schema that reinforces GBP data and improves local search visibility.
Core Principle
Schema on your website must match your GBP data exactly. Mismatches create conflicting signals. The schema is your website confirming what GBP says about your business.
LocalBusiness Schema Template
{
"@context": "https://schema.org",
"@type": "Plumber",
"@id": "https://example.com/#business",
"name": "Smith Plumbing",
"image": "https://example.com/images/logo.png",
"url": "https://example.com",
"telephone": "+17165550100",
"email": "info@smithplumbing.com",
"address": {
"@type": "PostalAddress",
"streetAddress": "123 Main St, Suite 200",
"addressLocality": "Buffalo",
"addressRegion": "NY",
"postalCode": "14201",
"addressCountry": "US"
},
"geo": {
"@type": "GeoCoordinates",
"latitude": "42.8864",
"longitude": "-78.8784"
},
"openingHoursSpecification": [
{
"@type": "OpeningHoursSpecification",
"dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
"opens": "08:00",
"closes": "17:00"
}
],
"areaServed": [
{ "@type": "City", "name": "Buffalo", "sameAs": "https://en.wikipedia.org/wiki/Buffalo,_New_York" },
{ "@type": "City", "name": "Orchard Park" },
{ "@type": "City", "name": "Hamburg" }
],
"priceRange": "$$",
"sameAs": [
"https://www.facebook.com/smithplumbing",
"https://www.yelp.com/biz/smith-plumbing-buffalo"
],
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.8",
"reviewCount": "142"
},
"hasOfferCatalog": {
"@type": "OfferCatalog",
"name": "Plumbing Services",
"itemListElement": [
{
"@type": "Offer",
"itemOffered": {
"@type": "Service",
"name": "Emergency Plumbing",
"description": "24/7 emergency plumbing repair"
}
}
]
}
}@type Selection
Use the most specific LocalBusiness subtype:
| Business Type | Schema @type |
|---|---|
| General business | LocalBusiness |
| Plumber | Plumber |
| Electrician | Electrician |
| HVAC | HVACBusiness |
| Dentist | Dentist |
| Restaurant | Restaurant |
| Auto repair | AutoRepair |
| Attorney | Attorney |
| Real estate agent | RealEstateAgent |
| Hair salon | HairSalon |
| Medical practice | MedicalBusiness |
Full list: https://schema.org/LocalBusiness (check subtypes)
Multi-Location Schema
Each location needs its own schema with a unique @id:
{
"@type": "Plumber",
"@id": "https://example.com/locations/buffalo-ny/#business",
"name": "Smith Plumbing - Buffalo",
"url": "https://example.com/locations/buffalo-ny/",
...
}On the homepage, reference all locations:
{
"@type": "Organization",
"@id": "https://example.com/#organization",
"name": "Smith Plumbing",
"department": [
{ "@id": "https://example.com/locations/buffalo-ny/#business" },
{ "@id": "https://example.com/locations/orchard-park-ny/#business" }
]
}SAB (Service Area Business) Schema
For businesses without a public address, omit address and emphasize areaServed:
{
"@type": "Plumber",
"name": "Smith Plumbing",
"areaServed": [
{ "@type": "City", "name": "Buffalo, NY" },
{ "@type": "City", "name": "Orchard Park, NY" },
{ "@type": "State", "name": "New York" }
],
"telephone": "+17165550100",
"url": "https://example.com"
}Validation
Tools
- Google Rich Results Test: https://search.google.com/test/rich-results (renders JavaScript)
- Schema Markup Validator: https://validator.schema.org/
- Browser DevTools:
document.querySelectorAll('script[type="application/ld+json"]')
Common Errors
addressformat doesn't match GBP- Missing
geocoordinates - Wrong
@type(too generic) telephonemissing country codeopeningHoursSpecificationdoesn't match actual hours- Duplicate
@idacross pages
⚠️ Detection limitation: web_fetch and curl strip <script> tags. Many CMS plugins inject JSON-LD via JavaScript. Always use Rich Results Test or browser tools to verify schema exists.
Task-Specific Questions
- Single location or multi-location?
- Storefront or SAB?
- What CMS/platform? (WordPress plugin, Next.js, etc.)
- Does the business have existing schema?
- What GBP categories are set?
What to Do Next
| What You Found | Next Action | Skill |
|---|---|---|
| Schema implemented, need to verify GBP matches | Audit GBP to ensure all data aligns exactly with schema | gbp-optimization |
| Need schema on multiple location pages | Build schema per page with location-specific data | local-landing-pages |
| Schema is part of a broader audit | Feed schema findings into the full audit report | local-seo-audit |
| Schema added but rankings unchanged | Schema alone rarely moves rankings — it reinforces other signals. Check if the real issue is elsewhere | geogrid-analysis |
Default next step: After implementing schema, validate with Google's Rich Results Test, then monitor Search Console for structured data errors over the next 2 weeks.
Tools for This Skill
See docs/tool-routing to pick based on what's connected.
- Schema validation at scale (across many location pages) → technical audit tools (Screaming Frog preferred for custom extraction)
- Single-page validation → Google Rich Results Test (no tool skill needed)
