SEO schema markup generator: create JSON-LD structured data for FAQ, HowTo, Article, Product, and LocalBusiness rich results in Google. Part of a 20-skill SEO & GEO suite. 结构化标记/结构化数据/富摘要/JSON-LD/谷歌富媒体
SEO schema markup generator: create JSON-LD structured data for FAQ, HowTo, Article, Product, and LocalBusiness rich results in Google. Part of a 20-skill SEO & GEO suite. 结构化标记/结构化数据/富摘要/JSON-LD/谷歌富媒体
version
6.0.0
license
Apache-2.0
compatibility
Claude Code ≥1.0, skills.sh marketplace, ClawHub marketplace, Vercel Labs skills ecosystem. No system packages required. Optional: MCP network access for SEO tool integrations.
Use when generating JSON-LD structured data, Schema.org markup, or rich snippet markup for a page.
argument-hint
<page URL or content type>
allowed-tools
WebFetch
metadata
{"author":"aaron-he-zhu","version":"6.0.0","geo-relevance":"medium","tags":["seo","structured-data","json-ld","rich-results","faq-schema","howto-schema","product-schema","article-schema","schema-org","结构化数据","構造化データ","스키마마크업","datos-estructurados"],"triggers":["add schema markup","generate structured data","JSON-LD","rich snippets","FAQ schema","schema.org","structured data markup","add FAQ rich results","I want star ratings in Google","product markup","recipe schema","add structured data to my page","how to add schema markup","how to get rich snippets","结构化数据","Schema标记","JSON-LD生成","富摘要","添加结构化数据","要星级评分","搜索结果要好看","構造化データ","スキーママークアップ","リッチリザルト","스키마 마크업","구조화 데이터","datos estructurados","marcado schema","dados estruturados","shema markup","structred data"]}
Schema Markup Generator
Generate valid JSON-LD structured data in seconds and unlock rich results in Google — describe your page (or paste a URL) and this skill selects the right schema types, maps your content to all required properties, and outputs copy-paste-ready markup with a SERP preview showing what your rich result will look like.
Quick example: Generate FAQ schema for a page about SEO with 3 questions → get validated JSON-LD, an implementation guide for <head> or </body>, and a live SERP preview of the expanded result.
System role: Build layer skill. It turns briefs and signals into assets that other skills can review, publish, and monitor.
With ~~web crawler connected:
Automatically crawl and extract page content (visible text, headings, lists, tables), existing schema markup, page metadata, and structured content elements that map to schema properties.
With manual data only:
Ask the user to provide:
Page URL or full HTML content
Page type (article, product, FAQ, how-to, local business, etc.)
Specific data needed for schema (prices, dates, author info, Q&A pairs, etc.)
Current schema markup (if optimizing existing)
Proceed with the full workflow using provided data. Note in the output which data is from automated extraction vs. user-provided data.
Instructions
When a user requests schema markup:
Identify Content Type and Rich Result Opportunity
Reference the CORE-EEAT Benchmark item O05 (Schema Markup) for content-type to schema mapping:
Source of each data point clearly stated (~~web crawler extraction, user-provided, or manual entry)
Example
User: "Generate FAQ schema for a page about SEO with 3 questions"
Output:
## FAQ Schema for SEO Page### Schema Markup```json
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is SEO?",
"acceptedAnswer": {
"@type": "Answer",
"text": "SEO (Search Engine Optimization) is the practice of optimizing websites and content to rank higher in search engine results pages (SERPs). It involves technical optimizations, content creation, and link building to increase organic visibility and drive qualified traffic to your website."
}
},
{
"@type": "Question",
"name": "How long does SEO take to work?",
"acceptedAnswer": {
"@type": "Answer",
"text": "SEO typically takes 3-6 months to show significant results, though this varies based on competition, domain authority, and effort invested. New websites may take 6-12 months, while established sites with existing authority can see improvements in 1-3 months for less competitive keywords."
}
},
{
"@type": "Question",
"name": "Is SEO better than paid advertising?",
"acceptedAnswer": {
"@type": "Answer",
"text": "SEO and paid advertising serve different purposes. SEO provides sustainable, long-term traffic without per-click costs but takes time to build. Paid advertising delivers immediate results but stops when you stop paying. Most successful businesses use both: paid ads for immediate leads and SEO for long-term growth."
}
}
]
}
Implementation: Wrap the above JSON-LD in <script type="application/ld+json">...</script> and place in <head> or before </body>. Test with ~~schema validator.
SERP Preview
SEO Guide: Complete Beginner's Tutorial
yoursite.com/seo-guide/
Learn SEO from scratch with our comprehensive guide...
▼ What is SEO?
SEO (Search Engine Optimization) is the practice of optimizing...
▼ How long does SEO take to work?
SEO typically takes 3-6 months to show significant results...
▼ Is SEO better than paid advertising?
SEO and paid advertising serve different purposes...
## Schema Type Quick Reference
| Content Type | Schema Type | Key Properties |
|--------------|-------------|----------------|
| Blog Post | BlogPosting/Article | headline, datePublished, author |
| Product | Product | name, price, availability |
| FAQ | FAQPage | Question, Answer |
| How-To | HowTo | step, totalTime |
| Local Business | LocalBusiness | address, geo, openingHours |
| Recipe | Recipe | ingredients, cookTime |
| Event | Event | startDate, location |
| Video | VideoObject | uploadDate, duration |
| Course | Course | provider, name |
| Review | Review | itemReviewed, ratingValue |
## Tips for Success
1. **Match visible content** - Schema must reflect what users see
2. **Don't spam** - Only add schema for relevant content
3. **Keep updated** - Update dates and prices when they change
4. **Test thoroughly** - Validate before deploying
5. **Monitor Search Console** - Watch for errors and warnings
## Schema Type Decision Tree
> **Reference**: See [references/schema-decision-tree.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/schema-markup-generator/references/schema-decision-tree.md) for the full decision tree (content-to-schema mapping), industry-specific recommendations, implementation priority tiers (P0-P4), and validation quick reference.
### Save Results
After delivering content or optimization output to the user, ask:
> "Save these results for future sessions?"
If yes, write a dated summary to `memory/content/YYYY-MM-DD-<topic>.md` containing:
- One-line description of what was created
- Target keyword and content type
- Open loops or items needing review
- Source data references
**Gate check recommended**: Run content-quality-auditor before publishing (PostToolUse hook will remind automatically).
If any findings should influence ongoing strategy, recommend promoting key conclusions to `memory/hot-cache.md`.
## Reference Materials
- [Schema Templates](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/schema-markup-generator/references/schema-templates.md) - Copy-ready JSON-LD templates for all schema types
- [Validation Guide](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/schema-markup-generator/references/validation-guide.md) - Common errors, required properties, testing workflow
## Next Best Skill
- **Primary**: [technical-seo-checker](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/technical-seo-checker/SKILL.md) — verify implementation quality and deployment readiness.
## Related Skills in This Suite
| Phase | Skills |
|-------|--------|
| **Research** | [keyword-research](../../research/keyword-research/SKILL.md), [competitor-analysis](../../research/competitor-analysis/SKILL.md), [serp-analysis](../../research/serp-analysis/SKILL.md), [content-gap-analysis](../../research/content-gap-analysis/SKILL.md) |
| **Build** | [seo-content-writer](../seo-content-writer/SKILL.md), [geo-content-optimizer](../geo-content-optimizer/SKILL.md), [meta-tags-optimizer](../meta-tags-optimizer/SKILL.md), [schema-markup-generator](../schema-markup-generator/SKILL.md) |
| **Optimize** | [on-page-seo-auditor](../../optimize/on-page-seo-auditor/SKILL.md), [technical-seo-checker](../../optimize/technical-seo-checker/SKILL.md), [internal-linking-optimizer](../../optimize/internal-linking-optimizer/SKILL.md), [content-refresher](../../optimize/content-refresher/SKILL.md) |
| **Monitor** | [rank-tracker](../../monitor/rank-tracker/SKILL.md), [backlink-analyzer](../../monitor/backlink-analyzer/SKILL.md), [performance-reporter](../../monitor/performance-reporter/SKILL.md), [alert-manager](../../monitor/alert-manager/SKILL.md) |
| **Cross-cutting** | [content-quality-auditor](../../cross-cutting/content-quality-auditor/SKILL.md), [domain-authority-auditor](../../cross-cutting/domain-authority-auditor/SKILL.md), [entity-optimizer](../../cross-cutting/entity-optimizer/SKILL.md), [memory-management](../../cross-cutting/memory-management/SKILL.md) |
> **Install the full suite**: See [README](https://github.com/aaron-he-zhu/seo-geo-claude-skills) for one-command install of all 20 skills.
