Communitygithub.com

헤라우트 SEO

사이트와 서버에 대한 심층적이고 읽기 전용의 SEO 조사 도구입니다. 'Google이 왜 이 사이트를 색인하지 않고 방문자를 보내지 않는지, 그리고 정확히 무엇을 해야 하는지'에 대한 답변을 제공합니다.

헤라우트 SEO란 무엇인가요?

Heraut SEO는 웹사이트의 유기적 트래픽 부재 또는 색인 문제의 근본 원인을 찾기 위해 설계된 포괄적인 읽기 전용 SEO 감사 스킬입니다. 네 가지 병렬 트랙(Google Search Console 및 GA4 데이터 분석, 서버 로그 및 DNS 확인된 Googlebot 활동 검사, Google이 보는 코드 및 콘텐츠 분석, DataForSEO 및 Perplexity를 활용한 외부 경쟁 환경 조사)을 실행하여 증거 기반의 진단을 제공합니다. 감사가 완료되면 '상황-복잡성-질문-원인 트리-단계별 계획-30/60/90일 KPI' 형식의 컨설팅 스타일 보고서를 생성하며, 각 주장에 대해 측정값과 가정을 명확히 구분합니다. 이 스킬은 프랑스어 트리거(예: 'enquete SEO', 'pourquoi Google n'indexe pas mon site')를 지원하며, 콘텐츠 파이프라인이 효과를 내지 못하거나 블로그 글이 색인되지 않는 모든 사이트에 사용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/koffih/claude-skill-heraut-seo/tree/HEAD

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

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

문서

헤라우트 SEO은(는) 무엇을 하나요?

헤라우트 (전령)는 도메인을 세상에 알리는 자입니다. 아무도 그 소식을 듣지 못할 때, 이 스킬은 그 이유를 조사하고 모든 주장에 대한 증거를 제시하며, 소유자가 실행할 수 있는 계획을 반환합니다.

이 스킬은 실제 사례에서 비롯되었습니다: 58,000개의 URL과 1,000개의 생성된 게시물, 매일 비용을 지출하는 콘텐츠 파일럿, 블로그 노출 제로. 답변은 파일럿이 찾던 곳(페이지 재작성)이 아니라 사이트 전체의 품질, 권위, 수요에 있었습니다. 아래 방법은 첫 번째 가설을 확인하는 대신 그러한 답변을 찾도록 설계되었습니다.

규칙

  1. 읽기 전용, 모든 곳에서. 프로덕션 변경, 데이터베이스 쓰기, 재시작, Google에 제출하는 작업(색인 요청, 사이트맵 추가/제거) 없음. 조사는 설명할 뿐이며, 계획은 나중에 한 번에 하나씩 결정된 변경 사항을 적용합니다.
  2. 모든 주장에 증거. 명령어, 숫자, 날짜, 파일. 측정된 것과 가정된 것을 표시하십시오. 표본은 개수가 아닙니다: n을 제공하십시오.
  3. 사이트에 부드럽게. 한 번에 하나의 요청, 최소 1.5초 지연(politesse.delai_s). 소규모 서버는 감사 중 다운될 수 있습니다.
  4. 유료 API는 상한선 이내. budgets.dataforseo_usd와 budgets.perplexity_usd는 모든 호출 전에 스크립트에 의해 적용되며, 모든 비용이 기록됩니다. 총 지출액을 보고하십시오.
  5. 출력에 비밀 정보 없음. 키가 있는 위치는 명명하되, 값을 절대 명시하지 마십시오. 스크립트는 환경 변수 또는 설정에 명명된 env 파일에서 키를 읽습니다.

파일 위치

스크립트는 scripts/ 디렉토리에 있습니다 (보통 ~/.claude/skills/heraut-seo/scripts). Python 표준 라이브러리만 사용하며, Google 토큰에 openssl을 사용합니다. 모든 스크립트는 --config <site.json> --dossier <investigation folder> 인수를 받아 CSV와 JSON 파일을 생성하며, 먼저 읽을 resume.json 파일도 생성합니다.

스크립트트랙설명
sitemap.py코드전체 사이트맵 트리, 모든 URL의 유형 및 언어, lastmod 정직성, 중복
gsc.py performanceGoogle월별 및 페이지 유형별 16개월 데이터, 최근 28일 대비 이전 기간, 쿼리, 국가, 섹션
gsc.py sitemapsGoogle제출된 사이트맵, 오류, 보류 중, Google의 마지막 읽기 시간
gsc.py echantillon / inspecter / analyserGoogle계층화된 URL 검사 (일일 2,000회 할당량, 재개 가능), 유형별 커버리지, 이전 실행 대비 변화
ga4.pyGoogle연간 채널, 당시와 현재의 Google 유기적 트래픽, AI 어시스턴트, 봇 유사 비율
pages.py코드표본 페이지 읽기: 언어, canonical, hreflang, robots, 단어 수, JSON-LD, 블로그 링크, Googlebot 대 브라우저 표시
logs.py서버실제 Googlebot (DNS 확인됨) 일별, 유형별, 낭비, 응답 시간, 팔로우된 URL의 첫 방문
ttfb.py서버유형별, warm, cold 및 origin 별 최초 바이트까지의 시간
dataforseo.py외부실제 SERP, 순위가 매겨진 키워드, 사이트 및 경쟁사의 백링크, 볼륨, bilan
perplexity.py외부날짜와 출처가 포함된 심층 연구 (Agent API, effort)

조사 단계별 진행

0. 프레임 설정 (10분, 필요시 소유자와 함께)

  • 소유자의 질문을 그들의 언어로 작성하고, 증상을 숫자(노출, 클릭, 게시된 게시물, 지출된 비용)로 기록합니다.
  • 이미 알려진 정보 확인: 이전 감사, 메모, 콘텐츠 파이프라인 및 데이터베이스. 이를 복사할 사실이 아니라 확인할 가설로 취급합니다.
  • config.example.json에서 사이트 파일을 작성합니다: 도메인, 사이트맵, 언어, 페이지 유형을 경로 정규식으로 (가장 중요한 부분: 모든 개수는 유형별), 추적할 섹션(블로그), Search Console 속성, GA4 ID, 서비스 계정 키 경로, 시장(DataForSEO 위치 코드), 36개 경쟁사, 사용자가 입력할 1530개의 실제 쿼리, 예산.
  • 시작 전 접근 권한 확인: gsc.py sitemaps 응답, GA4 응답, 로그 읽기 가능 여부 (종종 root 및 adm 그룹만 가능: 소유자에게 요청, 거절을 우회하지 마십시오).

1. 4개 트랙 병렬 실행

사이트의 다른 감사 파일 옆에 enquete-YYYY-MM-DD/ 폴더를 만들고, references/brief.md에서 BRIEF.md를 작성한 다음, 각자 브리프와 해당 트랙 파일을 가지고 4명의 조사자(하위 에이전트)를 동시에 시작합니다. 각 조사자는 상단에 10줄 요약이 포함된 volet-<track>.md 파일과 원시 데이터 파일을 작성합니다.

트랙파일핵심 질문
Googlereferences/track-google.mdGoogle이 페이지를 알고, 크롤링하고, 유지하고 있습니까? 상황이 좋아지고 있습니까, 나빠지고 있습니까?
서버references/track-server.md실제 Googlebot이 방문하고, 무엇을 읽으며, 속도를 늦추거나 차단하는 것이 있습니까?
코드 및 콘텐츠references/track-code-content.mdGoogle이 사이트를 읽을 때 무엇을 발견합니까: 페이지 수, 콘텐츠의 얇음 정도, 링크 연결 방식, 정직성?
외부references/track-outside.md실제 검색에서 누가 이기고 있으며, 어떤 권위로, 사이트가 작성하는 내용에 대한 수요가 있습니까?

sitemap.py를 먼저 실행하고 (나머지 트랙은 여기서 표본을 추출), 그 다음 트랙을 실행합니다. gsc.py inspecter는 전체 표본에서 몇 시간이 걸릴 수 있습니다: 백그라운드에서 실행하십시오.

2. 종합

네 개의 보고서를 읽고, references/cause-tree.md를 사용하여 답변을 구성합니다: 여기에는 실제로 관찰된 원인, 각 원인을 확인하거나 배제하는 측정치, 함정(기술 감사가 깨끗하게 나와도 사이트가 괜찮다는 의미는 아님)이 나열되어 있습니다.

references/report.md에 따라 보고서를 작성합니다: 먼저 짧은 답변, 상황, 복잡성, 질문, 각 가지에 증거가 있는 원인 트리, 현재 프로그램이 작동하지 않는 이유, 각 단계에 '완료 조건'이 있는 단계별 계획, 30/60/90일 KPI, 소유자를 위한 결정, 조사의 한계, 출처. 세션이 가능할 때 페이지로 게시하고 (기본적으로 비공개), 그렇지 않으면 HTML 파일로 게시합니다.

3. 인계

  • 소유자에게 링크, 핵심 진단 5줄, 조사 비용, 측정할 수 없었던 것을 제공합니다.
  • 그런 다음 결정 사항들을 한 번에 하나씩, 각각 그 근거가 되는 사실과 권장 사항과 함께 제시합니다. 다음 질문을 하기 전에 각 결정된 단계를 적용합니다.
  • 평결과 그에 따른 운영 규칙(예: '핵심 페이지가 색인될 때까지 새 콘텐츠 금지')을 프로젝트 기록이 유지되는 곳에 저장합니다.

다른 서버 또는 사이트에서 실행

접근 권한(Search Console 키, 로그)이 있는 머신에 스킬을 설치하고, config.example.json을 사이트 폴더에 복사하여 작성한 후, 0~3단계를 실행합니다. 조사 날짜별로 폴더를 하나씩 유지하여 다음 실행과 비교할 수 있습니다: gsc.py analyser --avant <old inspection.jsonl>은 어떤 URL이 색인에 추가되거나 제거되었는지 URL별로 보여줍니다.

계획 시작 후 6090일 후에 조사를 다시 실행합니다. 실행 사이에 매일 50100개의 URL을 회전 검사하는 것이 색인 변화를 확인하는 가장 저렴한 방법입니다.

이 스킬이 하지 않는 일

이 스킬은 사이트를 변경하거나, 콘텐츠를 작성하거나, 색인을 요청하거나, 링크를 구매하지 않습니다. 제품이나 비즈니스 모델을 판단하지 않으며, 검색이 사람들을 사이트로 데려올 수 있는지 여부만 평가합니다. SEO 도구의 점수(순위, 스팸 점수, 예상 트래픽)는 측정치가 아닌 모델입니다: 인용할 때 이를 명시하십시오.

관련 스킬