AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载本篇技术指南基于GitHub_Trending/mar/marketingskills仓库中 skills/schema/references/schema-examples.md 编写系统覆盖 Organization、WebSite、Article、Product、SoftwareApplication、FAQPage、HowTo、BreadcrumbList、LocalBusiness、Event 等 10 类常用 schema.org 类型的完整 JSON-LD 示例并给出多类型组合graph与 Next.js 服务端渲染的落地实现。读者读完可掌握从页面类型评估、JSON-LD 编写、多类型组合到验证上线、排查报错的完整实战链路直接复制文中代码用于自己的站点。一、为什么需要 schema markup从 Rich Results 到 AI 可解析性在正式进入示例之前先明确结构化数据在仓库体系中的定位。仓库中 skills/schema/SKILL.md 将其定义为核心目标实现 schema.org 标记帮助搜索引擎理解内容并触发搜索结果中的富结果rich results。这一目标在仓库内被多个相邻技能复用与深化seo-audit 技能将 Missing product schema 列为电商站点常见问题之一并在 skills/seo-audit/SKILL.md 中强调一个关键坑web_fetch和curl无法可靠检测结构化数据——许多 CMS 插件AIOSEO、Yoast、RankMath通过客户端 JavaScript 注入 JSON-LD静态 HTML 中看不到。因此检测 schema 必须用浏览器工具、Google Rich Results Test 或 Screaming Frog它们会渲染 JavaScript。ai-seo 技能把 schema 视为 Agent Readiness 解析层parseability的关键要素见 skills/ai-seo/references/agent-readiness.md并在 skills/ai-seo/SKILL.md 中给出 Schema Markup for AI 映射表Article/BlogPosting、HowTo、FAQPage、Product、ItemList、Review、Organization 分别帮助 AI 引擎提取哪些信息并指出带 schema 的内容在非 Google AI 引擎上 AI 可见性可提升约 30-40%。programmatic-seo 技能在预发布清单中要求 Schema markup implemented见 skills/programmatic-seo/SKILL.md用于模板化页面的批量结构化标记。site-architecture 技能在面包屑章节中同时给出 BreadcrumbList 的 microdata 与 JSON-LD 两种实现见 skills/site-architecture/references/navigation-patterns.md。因此本文的示例文档不仅是富结果的实现手册也是 AI 搜索可见性与大规模模板页面的基础设施层。实现前的四条核心原则按 skills/schema/SKILL.md 的 Core Principles动手前先确立四条纪律准确优先schema 必须精确反映页面真实内容不标记不存在的内容内容变更后同步更新。使用 JSON-LDGoogle 推荐 JSON-LD 格式更易实现与维护可放置于head或body末尾。遵循 Google 指南只使用 Google 支持的标记类型避免作弊手法逐条核对富结果资格要求。全部验证部署前测试、在 Search Console 中监控、及时修复报错。二、常用类型速查表与必备属性开始写代码前先用 skills/schema/SKILL.md 提供的速查表完成页面类型 → schema 类型 → 必备属性的映射类型适用场景必备属性Organization公司首页/关于页name, urlWebSite首页站内搜索框name, urlArticle博客文章、新闻headline, image, datePublished, authorProduct商品页name, image, offersSoftwareApplicationSaaS/App 页name, offersFAQPageFAQ 内容mainEntityQA 数组HowTo教程name, stepBreadcrumbList任意带面包屑的页面itemListElementLocalBusiness本地商户页name, addressEvent活动、网络研讨会name, startDate, location仓库为该技能配置的评估用例skills/schema/evals/evals.json也印证了这套映射给 SaaS 首页加 Organization 时应同时推荐 WebSite含 SearchAction与 SoftwareApplication/Product电商商品页应包含 Product Offer AggregateRating Review BreadcrumbList博客文章应包含 Article BreadcrumbList。下面逐一给出每个类型的完整 JSON-LD 示例。三、10 类核心 schema 的完整 JSON-LD 示例以下示例全部来自 skills/schema/references/schema-examples.md保留原始结构并在关键处补充字段说明可直接复制替换为你的真实数据。3.1 Organization公司/品牌组织用于公司或品牌首页、关于页是实体识别的基础信号ai-seo 技能将其列为 Organization entity recognition 的核心 schema。{ context: https://schema.org, type: Organization, name: Example Company, url: https://example.com, logo: https://example.com/logo.png, sameAs: [ https://twitter.com/example, https://linkedin.com/company/example, https://facebook.com/example ], contactPoint: { type: ContactPoint, telephone: 1-555-555-5555, contactType: customer service } }按 skills/schema/SKILL.md 的 Quick Referencename、url为必备logo、sameAs社交资料、contactPoint为推荐。sameAs数组用于将不同平台的官方账号与同一实体关联是知识图谱Knowledge Panel构建的重要输入。3.2 WebSite含 SearchAction开启站内搜索框用于首页可触发搜索结果中的站内搜索框sitelinks search box。{ context: https://schema.org, type: WebSite, name: Example, url: https://example.com, potentialAction: { type: SearchAction, target: { type: EntryPoint, urlTemplate: https://example.com/search?q{search_term_string} }, query-input: required namesearch_term_string } }要点说明urlTemplate中的{search_term_string}是占位符会被用户的搜索词替换。query-input的写法固定为required namesearch_term_string其中required表示该参数必填name必须与urlTemplate中的占位符名一致——两者不一致是常见报错点。3.3 Article / BlogPosting文章与博客用于博客文章与新闻文章。这是 AI 引擎最常提取的内容类型之一作者、日期、主题识别。{ context: https://schema.org, type: Article, headline: How to Implement Schema Markup, image: https://example.com/image.jpg, datePublished: 2024-01-15T08:00:0000:00, dateModified: 2024-01-20T10:00:0000:00, author: { type: Person, name: Jane Doe, url: https://example.com/authors/jane }, publisher: { type: Organization, name: Example Company, logo: { type: ImageObject, url: https://example.com/logo.png } }, description: A complete guide to implementing schema markup..., mainEntityOfPage: { type: WebPage, id: https://example.com/schema-guide } }属性说明与最佳实践必备属性headline、image、datePublished、author推荐属性dateModified、publisher、description来自 skills/schema/SKILL.md。author建议用Person类型且附url作者主页增强 E-E-A-T 信号ai-seo 技能强调具名作者 资质可提升被引用率。publisher.logo必须是ImageObject且 Google 要求 logo 宽度不小于 112px 才符合富结果资格这是常见验证报错来源。datePublished/dateModified必须使用 ISO 8601 时间格式含时区偏移如2024-01-15T08:00:0000:00。mainEntityOfPage用于声明该 schema 对应的规范页面 URL。3.4 Product商品电商或 SaaS用于商品详情页可触发搜索结果中的价格、库存、评分展示。{ context: https://schema.org, type: Product, name: Premium Widget, image: https://example.com/widget.jpg, description: Our best-selling widget for professionals, sku: WIDGET-001, brand: { type: Brand, name: Example Co }, offers: { type: Offer, url: https://example.com/products/widget, priceCurrency: USD, price: 99.99, availability: https://schema.org/InStock, priceValidUntil: 2024-12-31 }, aggregateRating: { type: AggregateRating, ratingValue: 4.8, reviewCount: 127 } }要点必备name、image、offers含price与availability推荐sku、brand、aggregateRating、review。priceCurrency使用 ISO 4217 货币代码USD、EUR、CNY 等。availability是 schema.org 枚举值必须写完整 URL如https://schema.org/InStock不能写裸字符串InStock——枚举值不精确是常见验证错误SKILL.md 的 Common Errors 明确列出 enumerations exact。aggregateRating.ratingValue与reviewCount用字符串数字即可。注意 Google 对评分有额外要求至少一个真实 Review、评分来自真实用户仅堆评分有违规风险。电商场景可叠加BreadcrumbList导航与Review单条评论这是 evals.json 中第 4 个评估用例的明确预期输出。3.5 SoftwareApplicationSaaS / App 落地页用于 SaaS 产品页与应用落地页。SaaS 首页场景下通常与 Organization、WebSite 配合使用。{ context: https://schema.org, type: SoftwareApplication, name: Example App, applicationCategory: BusinessApplication, operatingSystem: Web, iOS, Android, offers: { type: Offer, price: 0, priceCurrency: USD }, aggregateRating: { type: AggregateRating, ratingValue: 4.6, ratingCount: 1250 } }要点必备name、offers。applicationCategory应使用 schema.org 预定义的枚举值如BusinessApplication、GameApplication、MultimediaApplication同样要求精确枚举。operatingSystem是自由文本可列出支持的平台price为0表示免费应用。3.6 FAQPage常见问题页用于包含常见问题的页面可触发搜索结果中直接展示问答的富结果。{ context: https://schema.org, type: FAQPage, mainEntity: [ { type: Question, name: What is schema markup?, acceptedAnswer: { type: Answer, text: Schema markup is a structured data vocabulary that helps search engines understand your content... } }, { type: Question, name: How do I implement schema?, acceptedAnswer: { type: Answer, text: The recommended approach is to use JSON-LD format, placing the script in your pages head... } } ] }要点必备mainEntityQuestion/Answer 对数组结构为 FAQPage → Question → Answer 三层嵌套。按 evals.json 第 2 个评估用例实现时须注意 Google 对 FAQ schema 的指南答案应是事实性的而非促销性内容促销型 FAQ 不满足富结果资格。FAQ 块同时也是 ai-seo 技能中 Direct QA extraction 的核心结构对非 Google 的 AI 引擎尤其有效。若页面有 20 个问题可全部列出或抽取 2-3 个代表性示例并说明完整结构但页面主体应真实包含这些问答内容准确优先原则。3.7 HowTo教程步骤用于教学类内容与教程结构化步骤便于搜索引擎与 AI 引擎提取过程信息。{ context: https://schema.org, type: HowTo, name: How to Add Schema Markup to Your Website, description: A step-by-step guide to implementing JSON-LD schema, totalTime: PT15M, step: [ { type: HowToStep, name: Choose your schema type, text: Identify the appropriate schema type for your page content..., url: https://example.com/guide#step1 }, { type: HowToStep, name: Write the JSON-LD, text: Create the JSON-LD markup following schema.org specifications..., url: https://example.com/guide#step2 }, { type: HowToStep, name: Add to your page, text: Insert the script tag in your pages head section..., url: https://example.com/guide#step3 } ] }要点必备name、step。totalTime使用 ISO 8601 时长格式PT15M表示 15 分钟PT1H30M表示 1 小时 30 分。每一步用HowToStep类型url可指向页内锚点#step1。步骤式结构对应 ai-seo 技能中的 Step extraction for process queries。3.8 BreadcrumbList面包屑导航用于任何带面包屑导航的页面为搜索引擎提供页面层级结构信号。site-architecture 技能在 skills/site-architecture/references/navigation-patterns.md 中也强调面包屑应配合 schema markup 实现并提供 microdata 与 JSON-LD 两种写法这里给出 JSON-LD 版本{ context: https://schema.org, type: BreadcrumbList, itemListElement: [ { type: ListItem, position: 1, name: Home, item: https://example.com }, { type: ListItem, position: 2, name: Blog, item: https://example.com/blog }, { type: ListItem, position: 3, name: SEO Guide, item: https://example.com/blog/seo-guide } ] }要点必备itemListElement含position、name、item的数组。position从 1 开始连续递增。面包屑层级必须与实际 URL 结构一致——site-architecture 技能将 Breadcrumbs that dont match URLs 列为反模式breadcrumb 显示 Products Widget 但 URL 是/shop/widget-pro。与 programmatic-seo 的索引策略呼应批量模板页都应配套 BreadcrumbList避免孤立页面orphan pages。3.9 LocalBusiness本地商户用于本地商户门店页可触发本地富结果。地址、营业时间、经纬度都是关键字段。{ context: https://schema.org, type: LocalBusiness, name: Example Coffee Shop, image: https://example.com/shop.jpg, address: { type: PostalAddress, streetAddress: 123 Main Street, addressLocality: San Francisco, addressRegion: CA, postalCode: 94102, addressCountry: US }, geo: { type: GeoCoordinates, latitude: 37.7749, longitude: -122.4194 }, telephone: 1-555-555-5555, openingHoursSpecification: [ { type: OpeningHoursSpecification, dayOfWeek: [Monday, Tuesday, Wednesday, Thursday, Friday], opens: 08:00, closes: 18:00 } ], priceRange: $$ }要点必备name、address。address使用PostalAddress子类型addressCountry用 ISO 3166-1 alpha-2 国家代码US、CN、JP 等。geo使用GeoCoordinates经纬度为十进制数字字符串。openingHoursSpecification的dayOfWeek是星期枚举数组opens/closes用 24 小时制 HH:MM。本地商户还应注意 NAPName-Address-Phone一致性seo-audit 技能将 Inconsistent NAP 和 Missing local schema 列为本地商户常见问题schema 中的信息应与页面可见内容、Google Business Profile 保持一致。3.10 Event活动、网络研讨会、会议用于活动页、网络研讨会、行业会议可触发活动富结果。仓库的 skills/events 技能体系webinar-funnel、speaking、sponsorship-roi 等对应的落地页均可套用此模板。{ context: https://schema.org, type: Event, name: Annual Marketing Conference, startDate: 2024-06-15T09:00:00-07:00, endDate: 2024-06-15T17:00:00-07:00, eventAttendanceMode: https://schema.org/OnlineEventAttendanceMode, eventStatus: https://schema.org/EventScheduled, location: { type: VirtualLocation, url: https://example.com/conference }, image: https://example.com/conference.jpg, description: Join us for our annual marketing conference..., offers: { type: Offer, url: https://example.com/conference/tickets, price: 199, priceCurrency: USD, availability: https://schema.org/InStock, validFrom: 2024-01-01 }, performer: { type: Organization, name: Example Company }, organizer: { type: Organization, name: Example Company, url: https://example.com } }要点必备name、startDate、location。线上活动用VirtualLocation含url配合eventAttendanceMode的枚举 URLhttps://schema.org/OnlineEventAttendanceMode线下活动则用Place加地址。eventStatus使用 schema.org 枚举EventScheduled、EventPostponed、EventCancelled等同样写完整 URL。时间格式为 ISO 8601 且含时区偏移-07:00跨时区活动尤其要写清。四、多类型组合用 graph 在一页挂载多个 schema一个页面往往同时承载多个实体公司 站点 面包屑 文章。推荐用graph在一个 JSON-LD 脚本块中组合多个类型避免页面堆叠大量script标签。{ context: https://schema.org, graph: [ { type: Organization, id: https://example.com/#organization, name: Example Company, url: https://example.com }, { type: WebSite, id: https://example.com/#website, url: https://example.com, name: Example, publisher: { id: https://example.com/#organization } }, { type: BreadcrumbList, itemListElement: [...] } ] }关键技巧id建立实体间引用。上例中WebSite.publisher通过id指向Organization两个类型在同一图中被关联为同一实体而非两个孤立对象。这是 evals.json 第 1 个评估用例的明确要求Should use graph for multiple schema types on one page也是 SaaS 首页的标准组合方式Organization WebSite含 SearchAction SoftwareApplication/Product。五、验证与测试上线前必须做的检查schema 写完之后按 skills/schema/SKILL.md 的 Validation and Testing 章节完成验证闭环。验证工具Google Rich Results Test最常用会渲染 JavaScript可捕获 JS 注入的 JSON-LD能直接看到可触发的富结果预览与报错。Schema.org Validator官方校验器做语法与结构检查。Search ConsoleEnhancements增强报告监控已上线页面的结构化数据状态与错误。seo-audit 技能特别提醒web_fetch与curl会剥离script标签、无法看到 JS 注入的 schema因此不要仅凭抓取结果就判定页面没有 schema这会产生虚假审计结论。三类高频错误SKILL.md 原文缺少必备属性Missing required properties对照 Google 官方文档核对必备字段如 Article 必须有author。非法值Invalid values日期必须是 ISO 8601 格式URL 必须是完整限定地址枚举值必须精确匹配 schema.org 的枚举 URL不能写缩写。与页面内容不一致Mismatch with page contentschema 标记了页面上不存在的内容如评分、FAQ 问答违反准确优先原则也是 Google 反作弊的重点。上线清单SKILL.md Testing Checklist在 Rich Results Test 中验证通过无错误errors且无警告warnings与页面可见内容一致所有必备属性均已包含一个容易被误解的事实验证通过 ≠ 必然展示富结果。Google 会自行决定是否以及何时展示富结果——schema 合法只是资格条件不保证出现。这一认知在 evals.json 第 5 个评估用例中被明确要求排查富结果不出现时应先区分警告 vs 错误、有资格 vs 已展示并在 Search Console 的结构化数据报告中持续观察。六、实现落地从静态站到 Next.js 动态渲染静态站点直接将 JSON-LD 写入 HTML 模板。多个页面复用的 schema如 Organization、WebSite应抽成 include/partial避免每个页面复制粘贴导致维护失控。动态站点React / Next.js用组件渲染 schema并确保服务端渲染SSR因为 Googlebot 对纯客户端渲染内容无法稳定读取。以 skills/schema/references/schema-examples.md 结尾的 Next.js 示例为骨架export default function ProductPage({ product }) { const schema { context: https://schema.org, type: Product, name: product.name, // ... other properties }; return ( Head script typeapplication/ldjson dangerouslySetInnerHTML{{ __html: JSON.stringify(schema) }} / /Head {/* Page content */} / ); }实践要点script的type必须是application/ldjson。dangerouslySetInnerHTML用于把 JSON 字符串注入脚本块JSON.stringify(schema)负责序列化对象。动态字段product.name、日期、作者、价格从 CMS 或数据层注入保证 schema 与页面内容永远同步——这正对应 evals.json 第 3 个评估用例中address how to populate dynamic fields from the CMS的要求。在大规模模板页programmatic-seo 场景中同一组件可驱动成百上千个页面配合graph组合 Organization/WebSite/BreadcrumbList实现结构化数据层面的模板化。CMS / WordPress使用插件Yoast、Rank Math、Schema Pro或主题修改 自定义字段映射到结构化数据。注意插件注入的 JSON-LD 多为客户端 JS 渲染验证时需用会渲染 JS 的工具。七、与仓库其他技能的协作边界最后给出仓库内的技能分工方便读者按需调用来自 skills/schema/SKILL.md 的 Related Skills 及 skills/seo-audit/SKILL.md 的调度规则seo-audit整体 SEO 审计含 schema 审查若用户的问题是流量下降、排名丢失这类整体诊断应优先走 seo-audit 而非 schemaevals.json 第 6 个用例明确了这一边界。ai-seoAI 搜索优化——schema 帮助 AI 理解内容是 Parseability 解析层的一部分。programmatic-seo模板化批量页面的 schema 输出如每页一套 BreadcrumbList Organization。site-architecture面包屑结构与导航 schema 规划。延伸阅读skills/schema/SKILL.mdschema 技能的完整方法论、速查表、验证清单skills/schema/evals/evals.json6 个评估用例覆盖 SaaS 首页、FAQ、博客、电商、排错、边界分流skills/ai-seo/references/agent-readiness.md结构化数据在 Agent 可解析性中的定位skills/programmatic-seo/references/playbooks.md12 种批量页面模式及 schema 配套skills/site-architecture/references/navigation-patterns.md面包屑的 microdata 与 JSON-LD 双写法将本文 10 类示例与 graph 组合、Next.js 组件化方案配合使用即可为从公司首页、博客、电商商品页到本地商户、活动页的几乎所有页面类型交付一套可验证、可维护、对搜索与 AI 引擎都友好的结构化数据方案。赞分享AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载相关推荐ComfyUI-WanVideoWrapper 十分钟上手从提示词到成片的 AI 视频生成ComfyUI WanVideoWrapper 十分钟上手从提示词到成片的 AI 视频生成 ComfyUI WanVideoWrapper 是 ComfyUI人工智能大模型媒体生成vLLM 结构化输出实战指南choice、regex、JSON Schema 与 EBNF 语法的完整落地方案vLLM 结构化输出实战指南choice、regex、JSON Schema 与 EBNF 语法的完整落地方案 vLLM 通过约束解码constrained人工智能大模型模型推理服务推理引擎本地部署Next.js 中集成 next-seo默认 SEO、Open Graph 与 JSON-LD 结构化数据的完整示例解析Next.js 中集成 next seo默认 SEO、Open Graph 与 JSON LD 结构化数据的完整示例解析 在 Next.js 应用中统一管理前端后端Web框架SSR前端构建上一篇ESP IoT Solution 存储方案深度解析NVS / FAT / SPIFFS / LittleFS 文件系统选型与实战指南下一篇Bilibili-Evolved 快速收藏组件详解视频页一键收藏与快捷键绑定实现创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考