헤라우트 SEO은(는) 무엇을 하나요?
헤라우트 (전령)는 도메인을 세상에 알리는 자입니다. 아무도 그 소식을 듣지 못할 때, 이 스킬은 그 이유를 조사하고 모든 주장에 대한 증거를 제시하며, 소유자가 실행할 수 있는 계획을 반환합니다.
이 스킬은 실제 사례에서 비롯되었습니다: 58,000개의 URL과 1,000개의 생성된 게시물, 매일 비용을 지출하는 콘텐츠 파일럿, 블로그 노출 제로. 답변은 파일럿이 찾던 곳(페이지 재작성)이 아니라 사이트 전체의 품질, 권위, 수요에 있었습니다. 아래 방법은 첫 번째 가설을 확인하는 대신 그러한 답변을 찾도록 설계되었습니다.
규칙
- 읽기 전용, 모든 곳에서. 프로덕션 변경, 데이터베이스 쓰기, 재시작, Google에 제출하는 작업(색인 요청, 사이트맵 추가/제거) 없음. 조사는 설명할 뿐이며, 계획은 나중에 한 번에 하나씩 결정된 변경 사항을 적용합니다.
- 모든 주장에 증거. 명령어, 숫자, 날짜, 파일. 측정된 것과 가정된 것을 표시하십시오. 표본은 개수가 아닙니다: n을 제공하십시오.
- 사이트에 부드럽게. 한 번에 하나의 요청, 최소 1.5초 지연(
politesse.delai_s). 소규모 서버는 감사 중 다운될 수 있습니다. - 유료 API는 상한선 이내.
budgets.dataforseo_usd와budgets.perplexity_usd는 모든 호출 전에 스크립트에 의해 적용되며, 모든 비용이 기록됩니다. 총 지출액을 보고하십시오. - 출력에 비밀 정보 없음. 키가 있는 위치는 명명하되, 값을 절대 명시하지 마십시오. 스크립트는 환경 변수 또는 설정에 명명된 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 performance | 월별 및 페이지 유형별 16개월 데이터, 최근 28일 대비 이전 기간, 쿼리, 국가, 섹션 | |
gsc.py sitemaps | 제출된 사이트맵, 오류, 보류 중, Google의 마지막 읽기 시간 | |
gsc.py echantillon / inspecter / analyser | 계층화된 URL 검사 (일일 2,000회 할당량, 재개 가능), 유형별 커버리지, 이전 실행 대비 변화 | |
ga4.py | 연간 채널, 당시와 현재의 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 파일과 원시 데이터 파일을 작성합니다.
| 트랙 | 파일 | 핵심 질문 |
|---|---|---|
| references/track-google.md | Google이 페이지를 알고, 크롤링하고, 유지하고 있습니까? 상황이 좋아지고 있습니까, 나빠지고 있습니까? | |
| 서버 | references/track-server.md | 실제 Googlebot이 방문하고, 무엇을 읽으며, 속도를 늦추거나 차단하는 것이 있습니까? |
| 코드 및 콘텐츠 | references/track-code-content.md | Google이 사이트를 읽을 때 무엇을 발견합니까: 페이지 수, 콘텐츠의 얇음 정도, 링크 연결 방식, 정직성? |
| 외부 | 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 도구의 점수(순위, 스팸 점수, 예상 트래픽)는 측정치가 아닌 모델입니다: 인용할 때 이를 명시하십시오.