schema-jsonld

Generates and validates Schema.org JSON-LD structured data for web pages.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/Arianna-Lupi/SEO-Skills --skill schema-jsonld-arianna-lupi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: schema-jsonld
Source: https://github.com/Arianna-Lupi/SEO-Skills/tree/main/skills/schema-jsonld
Command: npx skills add https://github.com/Arianna-Lupi/SEO-Skills --skill schema-jsonld-arianna-lupi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Writing valid Schema.org structured data by hand is error-prone, and marking up content that does not exist on the page can trigger Google manual penalties. This Skill generates correct JSON-LD markup for the right page type and validates required properties before publication. ## Core Features & Use Cases - Type-aware JSON-LD generation: Supports Article, BlogPosting, Product, FAQPage, HowTo, BreadcrumbList, LocalBusiness, Organization, and WebSite with required and recommended property checks. - Deterministic validation script: A Python stdlib-only script builds the JSON-LD object and reports missing required fields and warnings without inventing markup. - Rich results guidance: Identifies which rich results (stars, FAQ dropdowns, breadcrumbs, sitelinks) competitors show via optional SerpApi or Ahrefs MCP, so you implement markup that matters. - Use Case: You publish a blog article and want author markup and breadcrumbs in Google. The Skill outputs a ready-to-paste <script type="application/ld+json"> block validated against Rich Results Test requirements. ## Quick Start Generate validated JSON-LD structured data for my blog article page so it can show rich results in Google.

Frequently Asked Questions about schema-jsonld

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate JSON-LD structured data for a web page?▼

Identify the page type (article, product, FAQ, etc.), then run the schema_gen.py script with --type and --field arguments, or provide a full JSON object via --json. It outputs a validated JSON-LD object with missing required properties and warnings listed.

What schema types does this structured data generator support?▼

It supports Article, BlogPosting, Product, FAQPage, HowTo, BreadcrumbList, LocalBusiness, Organization, and WebSite. Each type has a built-in map of required and recommended properties based on Schema.org and Google Rich Results guidelines.

Does the schema generator require Python packages or API keys?▼

No external dependencies are required; the script uses only the Python 3 standard library and works offline. SerpApi or Ahrefs MCP connections are optional and only used to check which rich results competitors display.

Why is marking up invisible content in JSON-LD risky?▼

Google issues manual spam penalties when structured data describes content that is not visible on the page, such as FAQPage markup without visible FAQs or fake ratings. The Skill warns against this and only marks up content that actually exists.

How do I validate JSON-LD before publishing it?▼

Paste the generated markup into Google's Rich Results Test and the Schema.org validator, aiming for zero errors and resolving applicable warnings. After deployment, check the Enhancements report in Google Search Console to confirm the markup was parsed correctly.