감성개발자의 Blog

Article

Laravel SEO 메타 태그 설정 가이드

개요

Laravel 프로젝트에서 검색 엔진 최적화(SEO)의 첫 단계는 기본 메타 태그를 일관되게 설정하는 것입니다. 이 글은 artesaos/seotools 패키지를 사용하여 title, description, Open Graph, Twitter Card 같은 핵심 메타 태그를 빠르게 구성하는 실무 중심의 가이드입니다.

SEO는 검색 의도 파악과 콘텐츠 품질이 가장 중요하지만, 그 전에 메타 태그 자동화 구조가 잘 갖춰져 있으면 개발과 관리가 훨씬 수월합니다.

SEOTools 패키지란

artesaos/seotools는 Laravel 5.8+ 및 Lumen을 지원하는 패키지로, 다음 항목들을 빠르게 관리할 수 있습니다:

항목설명
Title/Meta Description검색 결과에 표시되는 기본 메타 태그
Open GraphSNS 링크 공유 시 미리보기 정보
Twitter Card트위터 공유 최적화
JSON-LD검색 엔진 구조화 데이터

다만 sitemap, canonical 태그, RSS 피드 같은 항목은 이 패키지의 범위 밖입니다. SEO 자동화의 기초만 담당하는 도구로 봐야 합니다.

설치 및 설정

1단계: 패키지 설치

composer require artesaos/seotools

2단계: 프로바이더 등록 (필요한 경우만)

Laravel 5.5+ 는 자동 발견(package discovery)을 지원하므로 수동 등록이 불필요합니다. 그러나 더 오래된 버전이라면:

// config/app.php
'providers' => [
    Artesaos\SEOTools\Providers\SEOToolsServiceProvider::class,
],

'aliases' => [
    'SEOMeta' => Artesaos\SEOTools\Facades\SEOMeta::class,
    'OpenGraph' => Artesaos\SEOTools\Facades\OpenGraph::class,
    'Twitter' => Artesaos\SEOTools\Facades\TwitterCard::class,
],

3단계: 설정 파일 발행

php artisan vendor:publish --provider="Artesaos\SEOTools\Providers\SEOToolsServiceProvider"

실무 적용 전략

SEOTools를 효과적으로 사용하려면 다음 단계를 따릅니다:

1) 글로벌 기본값 설정

// config/seotools.php
'defaults' => [
    'title' => '기본 사이트 제목',
    'description' => '기본 설명 (150-160자)',
]

2) 페이지별 메타 태그 분기

게시글, 상품, 문서 같이 구조가 다른 페이지만 메타 태그를 별도로 설정합니다:

// 컨트롤러에서
SEOMeta::setTitle($post->title);
SEOMeta::setDescription($post->summary);
OpenGraph::setUrl(route('post.show', $post->id));
OpenGraph::addImage($post->image_url);

3) HTML에서 렌더링

<head>
    {!! SEOMeta::generate() !!}
    {!! OpenGraph::generate() !!}
    {!! Twitter::generate() !!}
</head>

주의할 점

버전 확인: Laravel 버전에 따라 프로바이더 등록 방식이 다릅니다. Laravel 11+ 라면 bootstrap/providers.php를 확인하세요.

메타 문안 품질: 패키지가 자동화하는 것은 기술적 구조뿐입니다. 각 페이지의 title과 description은 여전히 사람이 신중하게 작성해야 합니다.

범위의 한계: sitemap, canonical, trailing slash 처리 같은 SEO 항목은 다른 방식으로 별도 처리해야 합니다.

검증 체크리스트

  • 패키지 설치 완료
  • 프로바이더 등록 (필요시)
  • 설정 파일 발행 완료
  • 글로벌 기본값 설정
  • 한두 페이지에서 메타 태그 검증 (개발자 도구 → Elements)

마치며

Laravel 프로젝트의 SEO 시작은 “완벽한 전략”보다 “일관된 기초 구조”가 중요합니다. artesaos/seotools로 메타 태그 자동화를 먼저 확립한 후, 검색 의도와 콘텐츠 품질 개선으로 나아가는 것이 현실적입니다. 메타 태그는 기술 문제이므로 패키지로 빠르게 처리하고, SEO 전략은 마케팅 팀과 함께 검토하는 방식을 권장합니다.

댓글