Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo-schema
saas-seo-schema
UnverifiedValidate and generate Schema.org JSON-LD (`SoftwareApplication`, `Organization`, `Offer`).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.5 KB |
SKILL.md
View on GitHub---
name: saas-seo-schema
description: "Validate and generate Schema.org JSON-LD (`SoftwareApplication`, `Organization`, `Offer`)."
argument-hint: "[url or generate]"
user-invocable: true
---
<!-- Generated from .claude/skills by scripts/sync-agent-skills.py. -->
## Running this workflow on this client
Run commands from the project root (use Git Bash on Windows if `bash` points to an unavailable WSL distro). Shared studio files live in `.claude/`; follow `.agents/PORTABLE-RUNTIME.md` and `.claude/docs/config-resolution.md` for client tools, delegation, and approval rules.
Run `bash .claude/hooks/yaml-helper.sh resolve_config --keys locale,review_mode,automation` and use its output below.
Resolved above — use as-is; `--review` overrides `review_mode` for this run.
# Schema.org Structured Data for SaaS
> **Locale & User Profile**: Match `locale` (`pt-BR` → natural Brazilian Portuguese questions/options, overriding English examples; `en` → English) and `user_profile` (`founder` → plain business language with `(Recomendado)` first, zero tech jargon; `developer` → technical). Keep code/tests in English.
Detects, validates, and authors Schema.org JSON-LD markup optimized for SaaS products, rich results in search engines, and entity resolution in AI answer engines.
---
## 1. Supported Schema Types (2026 Standards)
### ACTIVE (Recommended for SaaS):
- `SoftwareApplication` / `WebApplication`: Core for SaaS platforms (name, applicationCategory, operatingSystem, offers, aggregateRating).
- `Organization`: Company identity, logo, social profiles (`sameAs`), founder, contact points.
- `WebSite`: SearchAction for site search, publisher, name.
- `Product` & `Offer`: Subscription pricing tiers, trial periods, currency, billing frequencies.
- `BreadcrumbList`: Navigation hierarchy.
- `QAPage`: Genuine user Q&A forums (distinct from retired FAQPage).
- `ProfilePage` & `Person`: Author authority and founder credentials for E-E-A-T.
### RETIRED / DEPRECATED (Do NOT recommend for rich results):
- `FAQPage`: Retired for Google Search rich results on May 7, 2026. Keep existing markup as Info only, never count on rich snippet accordions.
- `HowTo`: Retired September 2023.
- `SpecialAnnouncement`, `CourseInfo`, `EstimatedSalary`: Retired 2025.
---
## 2. Server-Rendered React Server Component Pattern
In Next.js 14+ App Router, structured data should be rendered server-side so bots crawling without full JS execution index entities immediately:
```tsx
// components/seo/SoftwareSchema.tsx
import React from 'react';
interface SoftwareSchemaProps {
name: string;
description: string;
price: string;
currency?: string;
ratingValue?: string;
reviewCount?: string;
}
export function SoftwareSchema({
name,
description,
price,
currency = 'USD',
ratingValue = '4.9',
reviewCount = '120',
}: SoftwareSchemaProps) {
const jsonLd = {
'@context': 'https://schema.org',
'@type': 'SoftwareApplication',
name,
description,
applicationCategory: 'BusinessApplication',
operatingSystem: 'Cloud',
offers: {
'@type': 'Offer',
price,
priceCurrency: currency,
availability: 'https://schema.org/InStock',
},
aggregateRating: {
'@type': 'AggregateRating',
ratingValue,
reviewCount,
},
};
return (
<script
type="application/ld+json"
dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
/>
);
}
```
---
## 3. Tool Execution
```bash
python scripts/seo/parse_html.py <url> --json
python scripts/seo/schema_generate.py profile --script-tag
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |