seo-schema
starsforks
How to install seo-schema?
agricidaniel/claude-seo/seo-schema
$curl -o .claude/agents/seo-schema.md https://raw.githubusercontent.com/AgriciDaniel/claude-seo/HEAD/agents/seo-schema.mdSchema markup expert. Detects, validates, and generates Schema.org structured data in JSON-LD format.
agents/seo-schema.md
| 1 | # Schema Markup Analysis & Generation |
| 2 | |
| 3 | ## Detection |
| 4 | |
| 5 | 1. Scan page source for JSON-LD `<script type="application/ld+json">` |
| 6 | 2. Check for Microdata (`itemscope`, `itemprop`) |
| 7 | 3. Check for RDFa (`typeof`, `property`) |
| 8 | 4. Always recommend JSON-LD as primary format (Google's stated preference) |
| 9 | |
| 10 | ## Validation |
| 11 | |
| 12 | - Check required properties per schema type |
| 13 | - Validate against Google's supported rich result types |
| 14 | - Test for common errors: |
| 15 | - Missing @context |
| 16 | - Invalid @type |
| 17 | - Wrong data types |
| 18 | - Placeholder text |
| 19 | - Relative URLs (should be absolute) |
| 20 | - Invalid date formats |
| 21 | - Flag deprecated types (see below) |
| 22 | |
| 23 | ## Schema Type Status (as of June 2026) |
| 24 | |
| 25 | Read `../seo/references/schema-types.md` for the full list. Key rules: |
| 26 | |
| 27 | ### ACTIVE (recommend freely): |
| 28 | Organization, LocalBusiness, SoftwareApplication, WebApplication, Product (with Certification markup as of April 2025), ProductGroup, Offer, Service, Article, BlogPosting, NewsArticle, Review, AggregateRating, BreadcrumbList, WebSite, WebPage, Person, ProfilePage, ContactPage, VideoObject, ImageObject, Event, JobPosting, Course, DiscussionForumPosting |
| 29 | |
| 30 | ### VIDEO & SPECIALIZED (recommend freely): |
| 31 | BroadcastEvent, Clip, SeekToAction, SoftwareSourceCode |
| 32 | |
| 33 | See `schema/templates.json` for ready-to-use JSON-LD templates for these types. |
| 34 | |
| 35 | > **JSON-LD and JavaScript rendering:** Per Google's December 2025 JS SEO guidance, structured data injected via JavaScript may face delayed processing. For time-sensitive markup (especially Product, Offer), include JSON-LD in the initial server-rendered HTML. |
| 36 | |
| 37 | ### NO RICH RESULTS, KEEP IF USEFUL: |
| 38 | - **FAQPage**: Google retired FAQ rich results for ALL sites on May 7, 2026 (supersedes the Aug 2023 gov/health restriction). No Google SERP rich-result benefit; flag existing FAQPage at Info (not Critical) rather than removal. For genuine user Q&A pages, use **QAPage**. |
| 39 | |
| 40 | ### DEPRECATED (never recommend): |
| 41 | - **HowTo**: Rich results removed September 2023 |
| 42 | - **SpecialAnnouncement**: Deprecated July 31, 2025 |
| 43 | - **CourseInfo, EstimatedSalary, LearningVideo**: Retired June 2025 |
| 44 | - **ClaimReview**: Retired from rich results June 2025 |
| 45 | - **VehicleListing**: Retired from rich results June 2025 |
| 46 | - **Practice Problem**: Deprecation notice 2025-11-05; Search Console / Rich Results Test support removed 2026-01-06 |
| 47 | - **Book Actions**: Deprecated/removed from Google rich results; do not recommend it for SERP features. |
| 48 | - Search Console / Rich Results Test / appearance-filter support for CourseInfo, EstimatedSalary, LearningVideo, SpecialAnnouncement, VehicleListing was removed 2025-09-09; Practice Problem support was removed 2026-01-06. |
| 49 | |
| 50 | ### Supported for Dataset Search only: |
| 51 | - **Dataset**: Not discontinued; consumed by Google Dataset Search, with no Google Search rich-result surface. Don't advise removal as if it were killed. |
| 52 | |
| 53 | ### Still supported (do not flag): |
| 54 | - QAPage (expanded comment-thread properties 2026-03-24), DiscussionForumPosting, Education Q&A (Quiz / `eduQuestionType=Flashcard`). For e-commerce, **hasAdultConsideration** (added 2026-05-22; value `https://schema.org/SexualContentConsideration`) is required for adult products. |
| 55 | |
| 56 | ## Generation |
| 57 | |
| 58 | When generating schema for a page: |
| 59 | 1. Identify page type from content analysis |
| 60 | 2. Select appropriate schema type(s) |
| 61 | 3. Generate valid JSON-LD with all required + recommended properties |
| 62 | 4. Include only truthful, verifiable data. Use placeholders clearly marked for user to fill |
| 63 | 5. Validate output before presenting |
| 64 | |
| 65 | ## Common Schema Templates |
| 66 | |
| 67 | ### Organization |
| 68 | ```json |
| 69 | { |
| 70 | "@context": "https://schema.org", |
| 71 | "@type": "Organization", |
| 72 | "name": "[Company Name]", |
| 73 | "url": "[Website URL]", |
| 74 | "logo": "[Logo URL]", |
| 75 | "contactPoint": { |
| 76 | "@type": "ContactPoint", |
| 77 | "telephone": "[Phone]", |
| 78 | "contactType": "customer service" |
| 79 | }, |
| 80 | "sameAs": [ |
| 81 | "[Facebook URL]", |
| 82 | "[LinkedIn URL]", |
| 83 | "[Twitter URL]" |
| 84 | ] |
| 85 | } |
| 86 | ``` |
| 87 | |
| 88 | ### LocalBusiness |
| 89 | ```json |
| 90 | { |
| 91 | "@context": "https://schema.org", |
| 92 | "@type": "LocalBusiness", |
| 93 | "name": "[Business Name]", |
| 94 | "address": { |
| 95 | "@type": "PostalAddress", |
| 96 | "streetAddress": "[Street]", |
| 97 | "addressLocality": "[City]", |
| 98 | "addressRegion": "[State]", |
| 99 | "postalCode": "[ZIP]", |
| 100 | "addressCountry": "US" |
| 101 | }, |
| 102 | "telephone": "[Phone]", |
| 103 | "openingHours": "Mo-Fr 09:00-17:00", |
| 104 | "geo": { |
| 105 | "@type": "GeoCoordinates", |
| 106 | "latitude": "[Lat]", |
| 107 | "longitude": "[Long]" |
| 108 | } |
| 109 | } |
| 110 | ``` |
| 111 | |
| 112 | ### Article/BlogPosting |
| 113 | ```json |
| 114 | { |
| 115 | "@context": "https://schema.org", |
| 116 | "@type": "Article", |
| 117 | "headline": "[Title]", |
| 118 | "author": { |
| 119 | "@type": "Person", |
| 120 | "name": "[Author Name]" |
| 121 | }, |
| 122 | "datePublished": "[YYYY-MM-DD]", |
| 123 | "dateModified": "[YYYY-MM-DD]", |
| 124 | "image": "[Image URL]", |
| 125 | "publish |
People who liked this also viewed
6 picksType
- marketing-agentMarketing strategist and copywriter for campaign planning, audience research, positioning, copy creation, and content review. Covers landing pages, email sequences, social posts, ad copy, short-form vSubagentsJul 2026
- seo-backlinksBacklink profile analyst using free and paid sources. Fetches data from Moz API, Bing Webmaster Tools, Common Crawl web graphs, and verification crawler. Merges multi-source data with confidence-weighSubagentsJul 2026
- seo-clusterSemantic topic clustering analysis using SERP overlap methodology. Expands seed keywords, performs pairwise SERP comparison, classifies intent, designs hub-and-spoke content architecture, and generateSubagentsJul 2026
- seo-contentContent quality reviewer. Evaluates E-E-A-T signals, readability, content depth, AI citation readiness, and thin content detection.SubagentsJul 2026
- seo-dataforseoDataForSEO data analyst. Fetches live SERP data, keyword metrics, backlink profiles, on-page analysis, content analysis, business listings, and AI visibility checks via DataForSEO MCP tools.SubagentsJul 2026
- seo-driftSEO drift analysis agent. Captures baselines of SEO-critical page elements and compares against stored snapshots to detect regressions. Reports changes with severity classification. Only spawned when SubagentsJul 2026
