SEO Setup
alisamadiii/Portfolio
Full SEO/metadata setup and audit for client websites (Astro, Next.js, any static site).
生成和验证 JSON-LD 结构化数据,支持 Article、BlogPosting、Organization、WebPage、Product、LocalBusiness 等 Schema.org 类型。自动检测页面类型,验证语法,检查必需字段,提供 Google Rich Results 测试工具链接和 Next.js 组件代码示例。
$ npx skills add huifer/claude-code-seo --skill structured-data -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install huifer/claude-code-seo structured-data --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/huifer/claude-code-seo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/structured-data .claude/skills/structured-data && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "structured-data" agent skill from https://github.com/huifer/claude-code-seo/tree/main/skills/structured-data into .claude/skills/structured-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structured-data", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/huifer/claude-code-seo/tree/main/skills/structured-dataType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add huifer/claude-code-seo --skill structured-data -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install huifer/claude-code-seo structured-data --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huifer/claude-code-seo.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/structured-data .agents/skills/structured-data && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "structured-data" agent skill from https://github.com/huifer/claude-code-seo/tree/main/skills/structured-data into .agents/skills/structured-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structured-data", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add huifer/claude-code-seo --skill structured-data -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install huifer/claude-code-seo structured-data --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huifer/claude-code-seo.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/structured-data .cursor/skills/structured-data && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "structured-data" agent skill from https://github.com/huifer/claude-code-seo/tree/main/skills/structured-data into .cursor/skills/structured-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structured-data", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/huifer/claude-code-seo.git --path skills/structured-data--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add huifer/claude-code-seo --skill structured-data -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install huifer/claude-code-seo structured-data --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huifer/claude-code-seo.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/structured-data .gemini/skills/structured-data && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "structured-data" agent skill from https://github.com/huifer/claude-code-seo/tree/main/skills/structured-data into .gemini/skills/structured-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structured-data", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install huifer/claude-code-seo structured-dataInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add huifer/claude-code-seo --skill structured-data -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/huifer/claude-code-seo.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/structured-data .github/skills/structured-data && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "structured-data" agent skill from https://github.com/huifer/claude-code-seo/tree/main/skills/structured-data into .github/skills/structured-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structured-data", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add huifer/claude-code-seo --skill structured-data -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install huifer/claude-code-seo structured-data --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/huifer/claude-code-seo.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/structured-data .opencode/skills/structured-data && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "structured-data" agent skill from https://github.com/huifer/claude-code-seo/tree/main/skills/structured-data into .opencode/skills/structured-data/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "structured-data", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
structured-data生成和验证 JSON-LD 结构化数据,支持 Article、BlogPosting、Organization、WebPage、Product、LocalBusiness 等 Schema.org 类型。自动检测页面类型,验证语法,检查必需字段,提供 Google Rich Results 测试工具链接和 Next.js 组件代码示例。
Structured Data is an agent skill from huifer/claude-code-seo. 生成和验证 JSON-LD 结构化数据,支持 Article、BlogPosting、Organization、WebPage、Product、LocalBusiness 等 Schema.org 类型。自动检测页面类型,验证语法,检查必需字段,提供 Google Rich Results 测试工具链接和 Next.js 组件代码示例。
Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Marketing & SEO, covering Schema markup. It works with Next.js. The repository describes itself as: Next.js SEO assistant plugin for Claude Code CLI. Automated SEO audits with 100-point scoring across 6 dimensions. Covers metadata, structured data, E-E-A-T, content strategy… The licence is MIT.
5 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 8b723e4. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are json, typescript and markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
schema.orgAlso links to:
search.google.comvalidator.schema.orgdevelopers.google.comFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Structured Data loads about 1.4k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 350 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from huifer/claude-code-seo at commit 8b723e4, republished under its MIT licence (© huifer). 350 words, ~1,426 tokens.
.claude/skills/structured-data/SKILL.md (or your agent's skills folder).你是结构化数据专家,精通 Schema.org 标准和 JSON-LD 实现。
当用户需要结构化数据时,你会:
自动检测页面类型
检查现有实现
生成优化的结构化数据
验证和测试
Next.js 集成
分析页面内容:
- 读取页面文件
- 识别页面类型(博客文章、产品页面、关于页面等)
- 提取关键信息(标题、作者、日期、价格等)
- 检测语言(中文/英文)确定 Schema 类型:
常见映射:
- 博客文章 → BlogPosting 或 Article
- 新闻文章 → NewsArticle
- 产品页面 → Product
- 关于页面 → Organization
- 本地商家 → LocalBusiness 或子类型
- 普通页面 → WebPage
- FAQ 页面 → FAQPage
- 评论 → Review 或 AggregateRating使用 Grep 搜索现有的 JSON-LD:
搜索模式:
- "@context": "https://schema.org"
- application/ld+json
- itemScope基础结构模板:
{
"@context": "https://schema.org",
"@type": "[Type]",
"[requiredField1]": "[value1]",
"[requiredField2]": "[value2]",
"[recommendedField1]": "[value1]",
"[recommendedField2]": "[value2]"
}Article/BlogPosting 必需字段:
Product 必需字段:
Organization 必需字段:
App Router 方法:
// app/[page]/page.tsx
const jsonLd = {
'@context': 'https://schema.org',
'@type': 'Article',
// ... 其他字段
}
export default function Page() {
return (
<>
<script
type="application/ld+json"
dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
/>
{/* 页面内容 */}
</>
)
}Pages Router 方法:
// pages/[page].tsx
import Head from 'next/head'
export default function Page() {
const jsonLd = {
'@context': 'https://schema.org',
'@type': 'Article',
// ... 其他字段
}
return (
<>
<Head>
<script
type="application/ld+json"
dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
/>
</Head>
{/* 页面内容 */}
</>
)
}# 结构化数据分析报告
## 当前状态
✓ 检测到现有 JSON-LD 实现
✓ Schema 类型:Article
⚠️ 缺少推荐字段:dateModified, publisher
## 问题诊断
❌ 缺少 image 字段
❌ author 信息不完整
⚠️ image 尺寸不符合推荐值
## 优化建议
1. 添加高质量图片(1200x630px 推荐)
2. 完善 author 信息(包含 @type 和 name)
3. 添加 publisher 信息
4. 添加 dateModified 字段生成可直接使用的 Next.js 组件代码,包括:
提供测试工具链接:
{
"@context": "https://schema.org",
"@type": "Article",
"inLanguage": "zh-CN",
"name": "文章标题",
"description": "文章描述"
}{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Article",
"headline": "文章标题"
},
{
"@type": "Organization",
"name": "公司名称"
}
]
}// 动态生成 JSON-LD
const jsonLd = {
'@context': 'https://schema.org',
'@type': 'BlogPosting',
'headline': post.title,
'datePublished': post.publishedAt,
'author': {
'@type': 'Person',
'name': post.author.name
}
}保持准确
完整字段
测试验证
性能优化
<head> 中语言支持
中文内容:
英文内容:
当检测到以下情况时,主动提供结构化数据建议:
/structured-data - 快速生成指定页面的结构化数据/seo-audit - 检查结构化数据完整性/seo-check - 验证 JSON-LD 实现© huifer, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/structured-data of huifer/claude-code-seo.
Open the folder on GitHubat commit 8b723e4
Structured Data next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Structured Data this skillhuifer/claude-code-seo | 110 | — | ~1.4k | Automated safety check: Pass | MIT | |
| SEO Setupalisamadiii/Portfolio | 180 | — | ~1.7k | Automated safety check: Pass | None | |
| Persian SEOTronIsHere/vibefarsiui | 210 | — | ~1.7k | Automated safety check: Warn | None | |
| SEOgridaco/grida | 2.7k | — | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| Nextjs SEO Boosterkennyzir/7deer_skills | 322 | — | ~229 | Automated safety check: Pass | MIT | |
| SEO Geoericrisco/rsc-harness | 174 | — | ~2.8k | Automated safety check: Pass | MIT |
alisamadiii/Portfolio
Full SEO/metadata setup and audit for client websites (Astro, Next.js, any static site).
TronIsHere/vibefarsiui
Technical and on-page SEO for Persian (Farsi) websites: lang and hreflang for fa-IR, RTL-safe metadata, Persian titles and descriptions, slug and URL strategy for Persian content, ZWNJ and keyword…
gridaco/grida
SEO best practices for the Grida project across Next.js pages, blog posts, and documentation.
kennyzir/7deer_skills
A complete SEO toolkit for Next.js applications, including structured data (Schema.org), dynamic sitemap generation, and meta tags.
ericrisco/rsc-harness
A skill your agent uses when one existing page needs to rank in Google AND get cited by AI answer engines — auditing a URL for on-page SEO, structured-data JSON-LD, GEO citation levers, Core Web…
thedaviddias/Front-End-Checklist
Audits article pages for freshness signals, covering the Last-Modified header, Article JSON-LD dateModified and a visible last-updated date, and fixes mismatches.
huifer/claude-code-seo
AI 内容创作专家,生成高质量的 SEO 和 GEO 优化内容,支持多种内容类型和风格. An agent skill from huifer/claude-code-seo.
huifer/claude-code-seo
分析博客文章和页面内容的质量,包括标题结构、关键词密度、可读性、内链机会、图片 alt 文本等。提供 E-E-A-T 权威性建设(Experience, Expertise, Authoritativeness, Trustworthiness)和内容策略建议,包括支柱页面、集群内容、作者权威性、关键词蚕食检测、Featured Snippets 优化、多媒体内容优化。
huifer/claude-code-seo
生成式引擎优化专家,分析和优化内容在 AI 搜索引擎(ChatGPT、Claude、Perplexity、Google SGE)中的可见性和引用率。
huifer/claude-code-seo
基于项目内容分析主题和关键词,生成客座博客搜索策略。提供 Google 高级搜索语法、客座博客资源列表(从 resources/guest-blog-sources.md 读取)和投稿邮件模板(从 templates/guest-blog-pitch.md 读取)。自动评估客座博客质量(DA、相关性、流量),提供个性化的投稿建议和优先级排序。
huifer/claude-code-seo
本地 SEO 分析和优化专家。自动检测项目是否需要本地 SEO,分析 NAP(Name, Address, Phone)一致性、本地关键词优化、Google Business Profile (GBP) 优化和本地结构化数据生成。提供本地商家搜索引擎排名优化建议,包括 NAP 标准化、本地关键词策略、GBP 完整性检查、评论策略、地图嵌入和本地 SEO 审计。
huifer/claude-code-seo
分析和优化 Next.js 项目的元数据,包括 title、description、Open Graph、Twitter Cards。自动检测 App Router 或 Pages Router,提供长度建议、关键词优化和最佳实践指导。支持中英文双语 SEO 分析。
Works with
Categories
生成和验证 JSON-LD 结构化数据,支持 Article、BlogPosting、Organization、WebPage、Product、LocalBusiness 等 Schema.org 类型。自动检测页面类型,验证语法,检查必需字段,提供 Google Rich Results 测试工具链接和 Next.js 组件代码示例。. Structured Data is an agent skill from huifer/claude-code-seo.
Structured Data fits situations like: tasks that involve Schema markup.
Run `npx skills add huifer/claude-code-seo --skill structured-data -a claude-code`. Or copy the skill folder (skills/structured-data in huifer/claude-code-seo) into .claude/skills/structured-data in your project. Claude Code loads it when a task matches its description.
Run `npx skills add huifer/claude-code-seo --skill structured-data -a codex`. Or copy the skill folder (skills/structured-data in huifer/claude-code-seo) into .agents/skills/structured-data in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add huifer/claude-code-seo --skill structured-data -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/structured-data, .gemini/skills/structured-data, .github/skills/structured-data and .opencode/skills/structured-data in your project.
SKILL.md names no scripts, command-line tools or credentials: Structured Data is instructions for the agent only.
SKILL.md names 4 domains. In commands or code: schema.org; the agent is likely to contact it when it follows the instructions. As links in the text: search.google.com, validator.schema.org and developers.google.com. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Structured Data is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Structured Data: SEO Setup (alisamadiii/Portfolio, 180 stars), Persian SEO (TronIsHere/vibefarsiui, 210 stars), SEO (gridaco/grida, 2.7k stars) and Nextjs SEO Booster (kennyzir/7deer_skills, 322 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
huifer (a GitHub user) maintains it in huifer/claude-code-seo, which has 110 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on January 4, 2026.
Source: huifer/claude-code-seo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.