Communitygithub.com

astudio · スキーママークアップ

astudio schema.org 構造化データ (JSON-LD) スキル: 2026年でも有効な型 (Organization、LocalBusiness、Product + Offer + AggregateRating、Article、BreadcrumbList、VideoObject、Event、JobPosting、Course、QAPage) を選択し、可視ページに合わせて記述、リントし、廃止されたリッチリザルト (FAQPage、HowTo、2025年バッチ) をフラグ付けします。Google リッチリザルト テスト と Yandex マイクロデータバリデータをカバーします。「микроразметка」「schema.org」「JSON-LD」「リッチスニペット」「расширенные сниппеты」「разметка товара」「разметка организации」に使用します。astudio-ai-seo の一部です。

astudio · スキーママークアップ とは?

このスキルは、astudio プロジェクトにおける schema.org 構造化データ (JSON-LD) の管理を自動化・標準化するためのものです。2026年時点でもGoogleのリッチリザルトに影響を与える主要な型(Organization、LocalBusiness、Product、Articleなど)に焦点を当て、各ページテンプレートに適切な型を割り当てます。また、FAQPageやHowToなど、既に効果がなくなった型を識別し、誤った期待を避けるためのガイダンスを提供します。ワークフローに従い、既存のマークアップをリントし、可視コンテンツと一致するJSON-LDを生成し、Google リッチリザルト テスト や Yandex マイクロデータバリデータで検証します。さらに、隠しデータや自己評価などのポリシー違反を防ぐルールも含まれており、astudio-ai-seo の一部としてSEO施策を支援します。対応プラットフォームはGoogle、Yandexで、主にウェブサイトのマークアップ改善に使用します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/whoamnesia/ai-seo/tree/HEAD/skills/schema-markup

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

astudio · スキーママークアップ は何をしますか?

<root> = このスキルのベースディレクトリから2階層上。リント: <root>/scripts/schema_lint.py。型のステータス: <root>/reference/facts.md § リッチリザルトのステータス。

構造化データはAIの回答に必須ではありません(Googleがそう述べています)が、事実を明確に示します:あなたが誰か、製品の価格、所在地、記事の著者。これはリッチリザルト、ナレッジパネル、そしてJSON-LDを読み取るすべての消費者の役に立ちます。ページに表示されている内容と一致する場合にのみ効果があります。

ワークフロー

  1. ページテンプレート(ホーム、カテゴリ、製品、記事、お問い合わせ、イベント、求人)を棚卸しする。
  2. 既存のものをリントする: テンプレートごとに schema_lint.py <url> を実行。
  3. テンプレートごとに型を選択する(下の表)。1ページにつき1つの @graph。エンティティには安定した @id 値(https://site.ru/#organization)を割り当て、繰り返し記述せずに参照する。
  4. ページと同じデータソース(CMSフィールド)からJSON-LDを記述し、数値を手動でコピーしない。
  5. 検証する: schema_lint.py、次にGoogle リッチリザルト テスト と Schema Markup Validator、そしてロシア向けにはYandex Webmaster マイクロデータバリデータ。結果をレポートに貼り付ける。
  6. 差分を表示し、承認後にデプロイする。

テンプレート別の型

テンプレート型ページと一致させる項目
ホームOrganization(または LocalBusiness のサブタイプ)、WebSite名前、ロゴ、連絡先;公式プロフィール(VK、Telegram、Яндекс Карты、2ГИС、Wikipedia)への sameAs
製品Product + Offer(+ AggregateRating、表示されている場合は Review)価格、通貨 RUB、在庫状況、評価値と件数
カテゴリBreadcrumbList、ItemList(任意)パンくずリストのテキスト
記事 / ブログArticle/BlogPosting + Person(著者)見出し、プロフィールページ付きの著者名、日付
お問い合わせ / 支店住所、地理、営業時間、電話番号を含む LocalBusiness サブタイプマップやディレクトリと同じNAP
動画ページVideoObjectサムネイル、アップロード日、再生時間
イベント / コース / 求人Event、Course、JobPosting日付、価格、場所、給与
Q&AフォーラムページQAPage実際のユーザーの質問と回答

廃止または効果のない型(メリットとして販売しないこと)

FAQPage(2026年5月7日以降Googleリッチリザルトなし)、HowTo(2023年)、ClaimReview、EstimatedSalary、Learning Video、SpecialAnnouncement、Vehicle Listing、Book Actions(2025年6月12日)。FAQPage/HowToは、可視コンテンツをミラーリングし、他の誰かがそれを利用する場合にのみ維持する;Google SERP効果はないと明記する。

ルール

  • ユーザーが見えるものだけをマークアップする。隠し評価、自社に対する自己評価、ページと異なる価格はGoogleポリシーに違反し、手動による措置を受ける可能性があります。
  • 価格: price にはスペースなしの数字("4990")、priceCurrency: "RUB";HTMLにも同じ価格を表示する。
  • 日付: タイムゾーン付きのISO 8601形式(2026-11-06T10:00:00+03:00)。
  • サイトごとに1つの組織エンティティを @id で参照する。

例: LocalBusiness

{"@context":"https://schema.org","@graph":[{"@type":"CafeOrCoffeeShop","@id":"https://zerno.ru/#org",
"name":"Кофейня «Зерно»","url":"https://zerno.ru/","logo":"https://zerno.ru/logo.svg","telephone":"+7 843 000-00-00",
"address":{"@type":"PostalAddress","streetAddress":"ул. Баумана, 1","addressLocality":"Казань","postalCode":"420111","addressCountry":"RU"},
"geo":{"@type":"GeoCoordinates","latitude":55.7887,"longitude":49.1221},
"openingHoursSpecification":[{"@type":"OpeningHoursSpecification","dayOfWeek":["Monday","Tuesday","Wednesday","Thursday","Friday","Saturday","Sunday"],"opens":"08:00","closes":"22:00"}],
"sameAs":["https://vk.com/zerno","https://yandex.ru/maps/org/000"]}]}

関連スキル