# Seo Schema

> Détecter, valider et générer des données structurées Schema.org (JSON-LD) pour {{COMPANY_NAME}} — Organization, Article, FAQ (si éligible), Event, Person, etc. Connaît les types actifs, restreints et dépréciés par Google. Utiliser quand l'utilisateur dit « schema », « données structurées », « rich results », « JSON-LD », « balisage » ou après publication d'un article/d'une page.

- **Type:** Skill
- **Install:** `agentstack add skill-littlpinguin-marketing-cockpit-template-seo-schema`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Littlpinguin](https://agentstack.voostack.com/s/littlpinguin)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Littlpinguin](https://github.com/Littlpinguin)
- **Source:** https://github.com/Littlpinguin/marketing-cockpit-template/tree/main/.claude/skills/seo-schema

## Install

```sh
agentstack add skill-littlpinguin-marketing-cockpit-template-seo-schema
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# seo-schema — données structurées

Skill d'analyse et de génération technique (pas de copy — pas de doctrine de marque requise, mais les données injectées doivent venir de sources réelles : site, `01-brand/messaging-framework.md`). Adapté du plugin claude-seo (AgriciDaniel, MIT) — voir `docs/vendored-seo.md`.

## Détection

1. Scanner la source de la page : JSON-LD `` (format à privilégier — préférence déclarée de Google), Microdata (`itemscope`/`itemprop`), RDFa.
2. Valider : `@context` présent, `@type` valide, propriétés requises par type, URLs absolues, formats de date ISO, aucun texte placeholder résiduel.
3. Signaler les types dépréciés ou restreints (liste ci-dessous).

## Statut des types (état février 2026 — re-vérifier à chaque re-sync)

**ACTIFS (recommander librement)** : Organization, LocalBusiness, SoftwareApplication, WebApplication, Product, Offer, Service, Article, BlogPosting, NewsArticle, Review, AggregateRating, BreadcrumbList, WebSite, WebPage, Person, ProfilePage, ContactPage, VideoObject, ImageObject, Event, JobPosting, Course, DiscussionForumPosting.

**RESTREINTS** :
- **FAQPage** : rich results réservés aux sites gouvernementaux et de santé faisant autorité (restriction août 2023). Le balisage reste utile pour la compréhension machine (GEO), mais ne pas promettre de rich result.

**DÉPRÉCIÉS (ne jamais recommander)** :
- **HowTo** (rich results supprimés sept. 2023), **SpecialAnnouncement** (juil. 2025), **ClaimReview**, **VehicleListing**, **CourseInfo**, **EstimatedSalary**, **LearningVideo** (retirés 2025).

> **Rendu JavaScript** : du JSON-LD injecté en JS peut être traité avec retard. Pour un balisage sensible au temps (Event, Offer), l'inclure dans le HTML servi côté serveur.

## Génération

1. Identifier le type de page (article, événement, page entreprise, offre…).
2. Choisir le(s) type(s) de schema appropriés.
3. Générer un JSON-LD valide avec propriétés requises + recommandées.
4. **Uniquement des données véridiques et vérifiables.** Marquer clairement `[À COMPLÉTER]` ce qui manque — ne jamais inventer un téléphone, une adresse, une note.
5. Valider avant de livrer (parse JSON + propriétés requises).

## Gabarits usuels pour {{COMPANY_NAME}}

### Organization (page d'accueil / à propos)
```json
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "{{COMPANY_NAME}}",
  "url": "{{COMPANY_WEBSITE}}",
  "logo": "[URL logo]",
  "sameAs": ["[LinkedIn]", "[autres profils]"]
}
```

### Article / BlogPosting (articles 09-seo/)
```json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "[Titre]",
  "author": { "@type": "Person", "name": "[Auteur]" },
  "datePublished": "[YYYY-MM-DD]",
  "dateModified": "[YYYY-MM-DD]",
  "image": "[URL image]",
  "publisher": {
    "@type": "Organization",
    "name": "{{COMPANY_NAME}}",
    "logo": { "@type": "ImageObject", "url": "[URL logo]" }
  }
}
```

### Event (webinaires, événements 07-events/)
```json
{
  "@context": "https://schema.org",
  "@type": "Event",
  "name": "[Nom]",
  "startDate": "[YYYY-MM-DDTHH:MM+01:00]",
  "eventAttendanceMode": "https://schema.org/OnlineEventAttendanceMode",
  "location": { "@type": "VirtualLocation", "url": "[URL]" },
  "organizer": { "@type": "Organization", "name": "{{COMPANY_NAME}}", "url": "{{COMPANY_WEBSITE}}" }
}
```

## Sortie

- Tableau de validation : `| Schema | Type | Statut ✅/⚠️/❌ | Problèmes |`
- Opportunités manquantes par page
- Snippets JSON-LD prêts à intégrer (fichier à côté du livrable concerné, ex. `09-seo/articles/…` ou `05-web-content/…`)

## Gestion d'erreur

| Cas | Action |
|---|---|
| Aucun balisage détecté | Le dire, puis recommander les types adaptés au contenu de la page |
| JSON-LD invalide | Pointer l'erreur de syntaxe précise et fournir la version corrigée |
| Type déprécié détecté | Signaler avec la date de retrait, proposer remplacement ou suppression |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Littlpinguin](https://github.com/Littlpinguin)
- **Source:** [Littlpinguin/marketing-cockpit-template](https://github.com/Littlpinguin/marketing-cockpit-template)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-littlpinguin-marketing-cockpit-template-seo-schema
- Seller: https://agentstack.voostack.com/s/littlpinguin
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.