mars-tw/open-seo-advisor-skill

開源、可攜、不綁定單一廠商的全域 SEO 顧問技能 - 蒸餾 SEO 權威方法論，協助任何產業做 SEO 健檢、修復、內容產出

Open SEO Advisor – 무엇인가요

Open SEO Advisor는 오픈소스 CLI 도구이자 AI 코딩 에이전트(예: Claude Code, Codex, OpenCode)용 스킬입니다. 이 도구는 사이트 건강 상태 점검, 기술적 수정 제안, 보안 감사, 콘텐츠 생성, WordPress 플러그인 스켈레톤 생성, 광고 캠페인 조언, 그리고 여러 AI 어시스턴트 역할을 조율하는 "매트릭스" 기능을 하나의 명령줄 인터페이스로 통합하여 로컬에서 실행하거나 AI 에이전트에 의해 호출할 수 있습니다. 로컬에서 실행 가능하며, 선택적 유료 API와 통합 가능하며, 상세한 보고서와 개발을 위한 정적 사이트 스켈레톤을 제공합니다.

핵심 기능 ("일곱 가지 모드")

모드	기능
컨설턴트	전체 사이트를 스캔하여 평이한 언어로 된 보고서와 우선순위가 매겨진 작업 목록을 생성합니다.
엔지니어	`sitemap.xml`, `robots.txt`, 캐논컬 태그, `hreflang` 등 기술적 SEO 항목을 탐지하고 수정 제안을 합니다.
보안	노출된 파일, 오래된 CMS, 악성 리디렉션, HTTPS 문제와 같은 SEO 관련 보안 위험을 탐지합니다.
콘텐츠 작가	LLM(Claude, OpenAI GPT, 또는 로컬 모델)을 호출하여 최고의 실천 가이드라인에 따라 SEO 친화적인 콘텐츠를 작성합니다.
플러그인 개발자	SEO 중심의 WordPress 플러그인 또는 기타 CMS 확장용 시작 코드를 생성합니다.
메타 광고	메타(Facebook/Instagram) 광고 계정을 분석하고, 실제 지출이 명시적 승인을 거쳐야 하는 드라이런 최적화 계획을 출력합니다.
이미지 자료	구성 가능한 이미지 제공자(기본은 OpenAI DALL-E)를 사용하여 광고, 기사, 소셜 게시물용 이미지 자산을 생성합니다.

고급 수준의 "AI 매트릭스" 오케스트레이터

개별 모드를 넘어서, 이 도구는 matrix 명령어를 제공합니다. 이 명령어는 단일 비즈니스 목표(예: "새 제품을 홍보하고 문의를 늘리기")를 입력받습니다. 내부 컨트롤러(NORA라고 명명됨)는 전략, 마케팅, 영업, 재무, 법무 등 26개의 AI 역할 에이전트로 구성된 로스터에 작업을 할당합니다. 각 역할은 적절한 모드를 호출하고, 시스템은 출력물을 하나의 결과물로 통합합니다. 발행이나 자금 지출과 같은 고위험 단계는 항상 수동 확인이 필요합니다.

사용 방법

스탠드얼론 CLI – 패키지를 설치한 후 seo-advisor 명령어를 직접 실행합니다. 예시:
```
seo-advisor audit consultant --url https://example.com --out ./report
```
이 명령어는 4가지 보고서(Markdown, JSON, HTML, 초보자용 요약)를 생성합니다.
AI 에이전트 스킬 – 리포지토리를 OpenCode 또는 Codex 스킬 디렉터리에 복제합니다. 에이전트에게 다음과 같이 프롬프트를 보낼 수 있습니다:

"$open‑seo‑advisor를 사용해서 GPT 이미지와 임mersive 스크롤 애니메이션을 갖춘 쇼핑 사이트를 만들어줘. 무료 호스팅을 우선시해." 에이전트는 브랜드 정의, 스토리보드 작성, GPT 이미지 생성, 사이트 스켈레톤 생성, 그리고 배포 선택(Cloudflare, Firebase, GCP Cloud Run)을 안내합니다.
오프라인 사이트 빌더 – seo-advisor website init 명령어는 정적 사이트 스켈레톤, 이미지 프롬프트 목록, 배포 설정 파일을 생성합니다. 여전히 LLM/이미지 API를 수동으로 실행하고, 전자상거래 로직을 추가해야 합니다.

리포지토리에 실제로 포함된 내용

Python 패키지 (scripts/) : seo-advisor 엔트리포인트를 노출합니다.
문서 : 빠른 시작, 아키텍처, 모드별 세부 정보, 기능 맵을 포함합니다.
예제 데모 : GPT 생성 이미지를 사용한 임머시브 스토리텔링 사이트("리프 홈" 및 "공필화" 데모). 이는 no-index 데모 페이지로, 설명용입니다.
CI 워크플로우 및 Apache-2.0 라이선스.

제한 사항 및 검증 노트 (README에 명시됨)

CLI는 오프라인 분석만 수행합니다. 명시적으로 쓰기/배포 단계를 승인하지 않는 한, 실시간 사이트를 수정하지 않습니다.
생성된 GPT 이미지, 다중 페이지 전자상거래 흐름, 결제 통합은 자동화되지 않습니다. 스켈레톤 생성 후 에이전트가 적절한 API를 호출해야 합니다.
SEO 영향(순위, AI 검색 인용)은 사이트가 라이브되고 인덱싱된 후 측정해야 하며, 이 도구는 메타데이터, 캐논컬 태그 등이 올바르게 설정되었음을 보장할 뿐입니다.
데모 사이트는 noindex,follow로 제공되며, 프로덕션 준비된 예시가 아닙니다.

누가 도움이 될 수 있을까?

SEO 컨설턴트 : 재현 가능하고 스크립트 가능한 감사를 원하며, LLM에 보고서 생성을 위임하고 싶은 사람.
SEO 인식 정적 사이트 또는 WordPress 사이트를 개발하는 개발자 : 콘텐츠도 스켈레톤화할 수 있는 단일 도구를 선호하는 사람.
AI 에이전트 플랫폼 사용자 (OpenCode, Claude Code, Codex) : SEO, 콘텐츠, 마케팅 작업을 오케스트레이션할 수 있는 즉시 사용 가능한 "스킬"을 찾는 사람.
소규모 기업 : 비용을 낮추면서 AI 생성 콘텐츠와 이미지를 실험하고 싶은 사람 (도구는 기본적으로 읽기 전용, 무료 티어 API 사용).

빠른 시작 체크리스트

플랫폼별 설치 스크립트(install.sh 또는 install.ps1)를 실행합니다.
seo-advisor를 실행하고 인터랙티브 프롬프트에 응답하거나, seo-advisor audit consultant --url https://your‑site.com처럼 특정 모드를 실행합니다.
생성된 보고서를 검토하고, P0–P3 항목을 수동으로 처리하거나 AI 에이전트가 워크플로우를 계속하도록 합니다.
준비가 되면 seo-advisor website 명령어로 사이트를 스켈레톤화한 후, 선택한 호스팅으로 배포합니다.

기여 및 커뮤니티

본 프로젝트는 기여를 환영합니다: 추가 CMS용 커넥터, 추가 분석기, 언어 로컬라이제이션, AI 매트릭스 로직 개선 등. 설정 방법은 CONTRIBUTING.md를 참조하고, 오픈된 작업은 이슈 트래커에서 확인하세요.

결론: Open SEO Advisor는 일반 CLI로 실행하거나 AI 코딩 에이전트의 스킬로 사용할 수 있는 진정한 AI 강화 SEO 툴킷입니다. 완전한 기능의 전자상거래 플랫폼을 제공하는 대신, 감사, 개선 안내, 콘텐츠 생성에 중점을 둡니다.