Communitygithub.com

Blaise1030/astro-marketing

검색 엔진 가시성과 순위를 최적화합니다. 'SEO 개선', '검색 최적화', '메타 태그 수정', '구조화된 데이터 추가', '사이트맵 최적화' 또는 '검색 엔진 최적화'를 요청받았을 때 사용합니다.

astro-marketing란 무엇인가요?

이 스킬은 Lighthouse SEO 감사와 Google 검색 가이드라인을 기반으로 한 포괄적인 검색 엔진 최적화(SEO) 도구입니다. 기술 SEO, 온페이지 최적화, 구조화된 데이터를 중점적으로 다루며, Chrome DevTools MCP를 통한 Lighthouse 감사와 에이전트 브라우징 검사를 포함한 증거 기반 감사 워크플로우를 제공합니다. 또한 크롤링 가능성, XML 사이트맵, URL 구조, HTTPS 및 보안 헤더, 제목 태그, 메타 설명, 제목 구조, 이미지 SEO, 내부 링크, 모바일 SEO, 국제 SEO(hreflang) 등 모든 주요 SEO 영역을 상세히 다룹니다. 스킬은 검색 엔진 순위를 예측하지 않으며, 실제 검색 엔진 검증이 필요함을 강조합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용 가능하며, Google Search Console, PageSpeed Insights, Rich Results Test 등의 도구와 통합됩니다.

지원 대상✓Claude Code✓Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/Blaise1030/astro-marketing/tree/HEAD/.agents/skills/seo
원본 보기→모든 스킬 둘러보기

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

미리보기

스킬 README에서

astro-marketing preview
astro-marketing preview
astro-marketing preview
astro-marketing preview

문서

SEO 최적화

Lighthouse SEO 감사 및 Google 검색 가이드라인을 기반으로 한 검색 엔진 최적화. 기술 SEO, 온페이지 최적화 및 구조화된 데이터에 중점을 둡니다.

증거 기반 감사 워크플로우

렌더링된 페이지를 사용할 수 있는 경우:

  1. 해당 기능이 가능할 때 실시간 Lighthouse SEO 및 에이전트 브라우징 검사를 실행합니다. Chrome DevTools MCP를 사용하는 경우 lighthouse_audit를 사용합니다. 결과를 사용하여 렌더링된 페이지의 실패를 현지화합니다.
  2. Lighthouse가 자체적으로 확인할 수 없는 신호를 검사합니다: 응답 헤더, 리디렉션, robots.txt, 사이트맵 적용 범위, 페이지 템플릿 간의 표준 일관성, 구조화된 데이터 적격성, 그리고 사용자가 액세스를 제공하는 경우 Search Console 증거.
  3. 기술적인 크롤링/인덱싱 결과를 콘텐츠 품질 및 권위와 분리합니다. 순위 요소 가중치를 임의로 부여하거나 순위 변경을 약속하지 않습니다.
  4. 소스를 수정하고 동일한 검사를 다시 실행합니다. 인덱싱 또는 순위 결과에 대해서는 검색 엔진 검증이 보류 중임을 보고합니다.

실시간 도구를 사용할 수 없는 경우, 카테고리별 Lighthouse CLI 출력과 직접 소스 및 HTTP 검사를 사용합니다. Lighthouse SEO 점수는 유용한 기술적 검사 하위 집합을 포함하지만, 순위를 예측하는 것은 아닙니다.

영역이 스킬이 확인할 수 있는 내용
크롤링 및 인덱스 제어기술적 구성 및 일관성
렌더링된 메타데이터 및 의미존재 여부, 유효성 및 페이지 템플릿 문제
구조화된 데이터구문 및 적격성 신호, 풍부한 결과는 보장되지 않음
Core Web VitalsCore Web Vitals 스킬의 측정된 필드/랩 증거에 연결
콘텐츠 유용성 및 권위품질 검토, 그러나 인위적인 순위 백분율을 할당하지 않음

기술 SEO

크롤링 가능성

robots.txt:

# /robots.txt
User-agent: *
Allow: /

# 관리자/비공개 영역 차단
Disallow: /admin/
Disallow: /api/
Disallow: /private/

# 렌더링에 필요한 리소스 차단하지 않음
# ❌ Disallow: /static/

Sitemap: https://example.com/sitemap.xml

메타 로봇:

<!-- 기본값: 인덱싱 가능, 링크 추적 가능 -->
<meta name="robots" content="index, follow">

<!-- 특정 페이지 인덱싱 금지 -->
<meta name="robots" content="noindex, nofollow">

<!-- 인덱싱 가능하지만 링크 추적하지 않음 -->
<meta name="robots" content="index, nofollow">

<!-- 스니펫 제어 -->
<meta name="robots" content="max-snippet:150, max-image-preview:large">

표준 URL:

<!-- 중복 콘텐츠 문제 방지 -->
<link rel="canonical" href="https://example.com/page">

<!-- 자기 참조 표준 (권장) -->
<link rel="canonical" href="https://example.com/current-page">

<!-- 페이지가 매겨진 콘텐츠의 경우 -->
<link rel="canonical" href="https://example.com/products">
<!-- 또는 명시적 페이지 매김을 위해 rel="prev" / rel="next" 사용 -->

XML 사이트맵

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://example.com/</loc>
    <lastmod>2024-01-15</lastmod>
    <changefreq>daily</changefreq>
    <priority>1.0</priority>
  </url>
  <url>
    <loc>https://example.com/products</loc>
    <lastmod>2024-01-14</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
</urlset>

사이트맵 모범 사례:

  • 사이트맵당 최대 50,000개의 URL 또는 50MB
  • 대규모 사이트의 경우 사이트맵 인덱스 사용
  • 표준 URL만 포함하고 인덱싱 가능한 URL만 포함
  • 콘텐츠가 변경되면 lastmod 업데이트
  • Google Search Console에 제출

URL 구조

✅ 좋은 URL:
https://example.com/products/blue-widget
https://example.com/blog/how-to-use-widgets

❌ 나쁜 URL:
https://example.com/p?id=12345
https://example.com/products/item/category/subcategory/blue-widget-2024-sale-discount

URL 지침:

  • 하이픈 사용, 밑줄 사용 금지
  • 소문자만 사용
  • 짧게 유지 (75자 미만)
  • 대상 키워드를 자연스럽게 포함
  • 가능하면 매개변수 사용 금지
  • 항상 HTTPS 사용

HTTPS 및 보안

<!-- 모든 리소스가 HTTPS를 사용하도록 보장 -->
<img src="https://example.com/image.jpg">

<!-- 다음 아님: -->
<img src="http://example.com/image.jpg">

SEO 신뢰 신호를 위한 보안 헤더:

Strict-Transport-Security: max-age=31536000; includeSubDomains
X-Content-Type-Options: nosniff
X-Frame-Options: DENY

온페이지 SEO

제목 태그

<!-- ❌ 누락 또는 일반 -->
<title>Page</title>
<title>Home</title>

<!-- ✅ 주요 키워드와 함께 설명적 -->
<title>판매 중인 블루 위젯 | 프리미엄 품질 | 예시 스토어</title>

제목 태그 지침:

  • 대략적인 린팅 프록시로만 50–60자를 사용하고 합격/불합격 기준으로 삼지 마십시오. Google은 렌더링된 장치 너비에 맞게 제목 링크를 자르므로, 도구에서 지원하는 경우 미리보기 너비를 확인하십시오.
  • 페이지 주제를 자연스럽게 앞부분에 설명하십시오.
  • 모든 페이지에 대해 고유하게 만드십시오.
  • 사용자가 결과를 구별하는 데 도움이 될 때 브랜드를 추가하십시오.
  • 적절할 때 행동 지향적으로 만드십시오.

제목 링크 재작성은 잘림과 별도로 처리하십시오. Google은 <title>이 짧은 경우에도 표시되는 페이지 제목, 제목, 앵커 텍스트 및 기타 출처에서 다른 제목 링크를 구성할 수 있습니다. 자동으로 단축하지 말고 정확성과 일관성을 조사하십시오. Google의 제목 링크 안내를 참조하십시오.

메타 설명

<!-- ❌ 누락 또는 중복 -->
<meta name="description" content="">

<!-- ✅ 설득력 있고 고유함 -->
<meta name="description" content="무료 배송으로 프리미엄 블루 위젯을 쇼핑하세요. 30일 반품 보장. 10,000명 이상의 고객이 평가한 4.9/5. 오늘 주문하고 20% 할인을 받으세요.">

메타 설명 지침:

  • 린팅 프록시로만 대략 150–160자를 사용하십시오. 스니펫은 쿼리 및 장치에 따라 다르며, Google은 메타 설명 대신 페이지 콘텐츠를 선택할 수 있습니다.
  • 페이지 주제를 자연스럽게 사용하십시오.
  • 설득력 있는 행동 유도 문구를 포함하십시오.
  • 모든 페이지에 대해 고유하게 만드십시오.
  • 페이지 콘텐츠와 일치해야 합니다.

제목 구조

<!-- ❌ 잘못된 구조 -->
<h2>스토어에 오신 것을 환영합니다</h2>
<h4>제품</h4>
<h1>문의하기</h1>

<!-- ✅ 적절한 계층 구조 -->
<h1>블루 위젯 - 프리미엄 품질</h1>
  <h2>제품 특징</h2>
    <h3>내구성</h3>
    <h3>디자인</h3>
  <h2>고객 리뷰</h2>
  <h2>가격</h2>

제목 지침:

  • 기본 페이지 제목을 설명적으로 만들고 계층 구조를 명확하게 하십시오. 유효한 HTML에 둘 이상의 <h1>이 포함되어 있다고 해서 페이지를 실패로 처리하지 마십시오.
  • 논리적 계층 구조 (수준을 건너뛰지 마십시오)
  • 키워드를 자연스럽게 포함하십시오.
  • 설명적이고 일반적이지 않아야 합니다.

이미지 SEO

<!-- ❌ 좋지 않은 이미지 SEO -->
<img src="IMG_12345.jpg">

<!-- ✅ 최적화된 이미지 -->
<img src="blue-widget-product-photo.webp"
     alt="크롬 마감 처리된 블루 위젯, 제어판이 보이는 측면"
     width="800"
     height="600"
     loading="lazy">

이미지 지침:

  • 키워드가 포함된 설명적인 파일 이름
  • 대체 텍스트는 이미지 내용을 설명합니다.
  • 압축되고 적절한 크기로 조정됨
  • WebP/AVIF 및 대체 형식
  • 아래쪽 이미지는 지연 로딩

내부 링크

<!-- ❌ 비설명적 -->
<a href="/products">여기를 클릭하세요</a>
<a href="/widgets">더 읽기</a>

<!-- ✅ 설명적인 앵커 텍스트 -->
<a href="/products/blue-widgets">블루 위젯 컬렉션 살펴보기</a>
<a href="/guides/widget-maintenance">위젯 유지 관리 방법 알아보기</a>

링크 지침:

  • 키워드가 포함된 설명적인 앵커 텍스트
  • 관련 내부 페이지에 링크
  • 페이지당 합리적인 링크 수
  • 끊어진 링크를 신속하게 수정
  • 계층 구조를 위해 브레드크럼 사용

구조화된 데이터 (JSON-LD)

사용자가 스키마 마크업을 요청하거나 감사에서 구조화된 데이터 문제가 발견되면 구조화된 데이터 참조를 읽으십시오. 여기에는 Organization, Article, Product, FAQ 및 Breadcrumb 예제와 검증 링크가 포함되어 있습니다.

  • 보이는 정확한 콘텐츠를 설명하십시오. 풍부한 결과를 얻기 위해 유형이나 주장을 추가하지 마십시오.
  • 가장 구체적인 적용 가능한 유형을 사용하십시오. 식별자와 절대 URL이 렌더링 간에 안정적으로 유지되도록 하십시오.
  • 렌더링된 출력을 검증하십시오. 구문 통과가 검색 엔진 적격성 또는 표시를 보장하지 않습니다.

에이전트 브라우징 및 AI 검색 가능성

다음 개념을 분리하여 유지하십시오:

  • Lighthouse Agentic Browsing은 어시스턴트가 렌더링된 페이지를 이해하고 상호 작용하는 데 도움이 되는 기술적 신호를 측정합니다. 현재 검사에는 에이전트 접근성 트리, 선택적 llms.txt 및 WebMCP 등록, 스키마 및 양식 적용 범위(있는 경우)가 포함됩니다.
  • 검색 인덱싱 및 순위는 검색 엔진 시스템에 의존하며 Agentic Browsing 점수에서 추론할 수 없습니다.
  • AI 수집 또는 인용은 제품에 따라 다릅니다. 기술적으로 탐색 가능한 페이지나 유효한 llms.txt 파일이 AI 제품이 이를 수집, 순위 지정 또는 인용한다는 것을 증명하지는 않습니다.

의미론적 HTML, 설명적인 레이블, 크롤링 가능한 콘텐츠, 정확한 메타데이터 및 명확한 페이지 구조를 우선시하십시오. 이는 사람, 검색 엔진 및 에이전트 모두에게 이점이 됩니다. 애플리케이션에 노출할 유용한 작업이 있고 사용자가 해당 통합을 원하는 경우에만 WebMCP 도구를 추가하십시오. Lighthouse로 도구 이름, 설명, 스키마 및 양식 주석을 검증하십시오.

크롤러 제어는 제품별로 다릅니다

포괄적인 "AI 봇" 규칙을 적용하는 대신 문서화된 각 사용자 에이전트를 별도로 감사하십시오:

제어문서화된 목적차단의 효과
OAI-SearchBotChatGPT 검색 검색ChatGPT 요약 및 스니펫에 페이지 콘텐츠가 포함되는 것을 방지합니다. 링크와 제목은 타사 검색을 통해 여전히 표시될 수 있습니다.
PerplexityBotPerplexity 검색 인덱싱해당 크롤러가 차단된 콘텐츠를 검색 결과에 인덱싱하는 것을 방지합니다.
Claude-SearchBot / Claude-UserClaude 검색 인덱싱 / 사용자 지향 검색검색 가시성을 낮추거나 사용자 지향 요청에 대한 검색을 방지할 수 있습니다.
Google-ExtendedGoogle이 크롤링하는 콘텐츠의 특정 Gemini 교육 및 근거 사용을 제어합니다.Google 검색 포함 또는 순위에 영향을 미치지 않습니다.

GPTBot 및 ClaudeBot과 같은 교육 제어는 검색 및 사용자 가져오기 제어와 구별됩니다. GoogleOther는 일반 크롤러이며 AI 검색 가시성 스위치가 아닙니다. 공급업체의 유지 관리 문서에서 현재 이름과 결과를 확인하십시오: OpenAI, Perplexity, Anthropic 및 Google.

llms.txt는 선택 사항입니다

llms.txt는 실험적인 제안이며, 공급업체 간 검색 표준이 아닙니다. Lighthouse는 /llms.txt의 가용성과 형태를 검증할 수 있지만, 대상 제품이 이를 읽는다는 것을 보여주지는 않습니다. 사용자가 요청하거나 문서화된 소비자가 지원하는 경우에만 추가하십시오. 크롤링 가능성, 의미론적 HTML, 정확한 메타데이터 및 유용한 콘텐츠보다 우선하여 권장하지 마십시오. 순위 또는 인용 요소로 취급하거나, 사이트맵을 복제하거나, 이 감사를 높이기 위해 콘텐츠를 재구성하지 마십시오.

모바일 SEO

반응형 디자인

<!-- ❌ 모바일 친화적이지 않음 -->
<meta name="viewport" content="width=1024">

<!-- ✅ 반응형 뷰포트 -->
<meta name="viewport" content="width=device-width, initial-scale=1">

탭 대상

/* ❌ 모바일용으로 너무 작음 */
.small-link {
  padding: 4px;
  font-size: 12px;
}

/* ✅ 적절한 탭 대상 */
.mobile-friendly-link {
  padding: 12px;
  font-size: 16px;
  min-height: 48px;
  min-width: 48px;
}

글꼴 크기

/* ❌ 모바일에서 너무 작음 */
body {
  font-size: 10px;
}

/* ✅ 확대하지 않고 읽을 수 있음 */
body {
  font-size: 16px;
  line-height: 1.5;
}

국제 SEO

Hreflang 태그

<!-- 다국어 사이트용 -->
<link rel="alternate" hreflang="en" href="https://example.com/page">
<link rel="alternate" hreflang="es" href="https://example.com/es/page">
<link rel="alternate" hreflang="fr" href="https://example.com/fr/page">
<link rel="alternate" hreflang="x-default" href="https://example.com/page">

언어 선언

<html lang="en">
<!-- 또는 -->
<html lang="es-MX">

SEO 감사 체크리스트

중요

  • HTTPS 활성화
  • robots.txt에서 크롤링 허용
  • 중요한 페이지에 noindex 없음
  • 제목 태그가 존재하고 고유함
  • 기본 페이지 제목이 설명적이고 계층 구조가 논리적임

높은 우선 순위

  • 메타 설명 존재
  • 사이트맵 제출됨
  • 표준 URL 설정됨
  • 모바일 반응형
  • Core Web Vitals 통과

중간 우선 순위

  • 구조화된 데이터 구현됨
  • 내부 링크 전략
  • 이미지 대체 텍스트
  • 설명적인 URL
  • 브레드크럼 탐색
  • 에이전트 액세스가 중요한 경우 Agentic Browsing 실패 검토됨

지속적

  • Search Console에서 크롤링 오류 수정
  • 콘텐츠가 변경되면 사이트맵 업데이트
  • 순위 변경 모니터링
  • 끊어진 링크 확인
  • Search Console 인사이트 검토

도구

도구용도
Google Search Console인덱싱 모니터링, 문제 해결
Google PageSpeed Insights성능 + Core Web Vitals
Rich Results Test구조화된 데이터 검증
실시간 Lighthouse 감사 (Chrome DevTools MCP: lighthouse_audit)에이전트를 위한 렌더링된 SEO 및 Agentic Browsing 검사
Lighthouse CLISEO 감사 대체
Screaming Frog크롤링 분석

참조

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Blaise1030/astro-marketing

Audit and improve web accessibility following WCAG 2.2 guidelines. Use when asked to "improve accessibility", "a11y audit", "WCAG compliance", "screen reader support", "keyboard navigation", or "make accessible".

Blaise1030/astro-marketing

Optimize Core Web Vitals (LCP, INP, CLS) for better page experience using field and lab evidence. Use when asked to "improve Core Web Vitals", "fix LCP", "reduce CLS", "optimize INP", "page experience optimization", or "fix layout shifts".

Blaise1030/astro-marketing

Optimize web performance for faster loading and better user experience. Use when asked to "speed up my site", "optimize performance", "reduce load time", "fix slow loading", "improve page speed", or "performance audit".

Blaise1030/astro-marketing

Build scalable design systems with Tailwind CSS v4, design tokens, component libraries, and responsive patterns. Use when creating component libraries, implementing design systems, or standardizing UI patterns.

관련 스킬

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community