문서
유형별 페이지, 목록 페이지, 새 경로
콘텐츠 엔진이 회사와 직무처럼 여러 요소로 주소가 구성되는 페이지를 작성하고, 목록 페이지를 최신 상태로 유지하며, 경로를 추가하거나 삭제하는 방법을 설명합니다.
사이트의 일부 섹션은 여러 요소를 조합해 만들어집니다. 예를 들어 /interviews/google/software-engineer처럼 회사와 직무마다 면접 가이드가 있는 경우입니다. 콘텐츠 엔진은 이러한 구조를 사용자의 기존 페이지에서 읽어 내고, 사람들이 실제로 검색하는 조합의 페이지를 작성합니다. 또한 해당 페이지들의 항목을 모아 보여 주는 목록 페이지를 관리하고, 새 회사 같은 값을 추가하거나 기존 값을 삭제할 수도 있습니다. 새 주소에 페이지를 작성하기 전에는 항상 사이트에 먼저 확인합니다.
AutoPSEO가 구조를 파악하는 방법
구조는 별도로 선언하지 않아도 사용자의 기존 페이지에서 파악합니다. AutoPSEO는 스캔할 때마다 주소를 섹션과 깊이별로 묶습니다.
- 그룹으로 인정받으려면 섹션 아래 2단계 이상의 깊이에 있는 페이지가 6개 이상이어야 하고, 각 세그먼트의 값이 여러 페이지에 걸쳐 반복되어야 합니다. 이렇게 하면
/interviews/{company}/{role}같은 패턴이 만들어집니다. - 각 값의 이름은 페이지 제목에서 읽어 옵니다. 그래서
goldman-sachs는 "Goldman Sachs"로 인식되고,bcg가 Boston Consulting Group의 약칭이라는 것처럼 이니셜도 알아봅니다. - 사람들이 이 페이지들을 어떻게 검색하는지는 Search Console 데이터로 파악합니다. 어떤 표현이 해당 검색어의 20% 이상을 차지하면 하나의 검색 표현으로 인정합니다.
- 페이지가 따르는 개수와 목록 구성은 AutoPSEO가 보관한 페이지 사본(5개 이상)을 기준으로 측정합니다. 개수는 페이지의 90%가 속하는 범위를 기준으로 하고, 목록은 페이지의 80%가 포함하고 있을 때 하나의 목록으로 인정합니다.
AutoPSEO에 맡긴 섹션, 즉 해당 경로에 관리형 콘텐츠 유형이 있는 섹션에만 이 구조가 적용됩니다. 어떤 섹션을 맡길지는 사이트가 웹훅으로 알려 줍니다(전송). 그 밖의 섹션 정보는 모두 페이지에서 읽어 옵니다.
유형별 페이지 작성
- 라우팅. 검색어에 각 요소의 값이 이름, 별칭 또는 주소 세그먼트 형태로 하나씩 모두 들어 있으면 해당 유형의 콘텐츠 유형으로 연결됩니다. 예를 들어 "amazon data engineer interview questions"는 회사
amazon, 직무data-engineer로 인식됩니다. - 브리프에는 주소, 선택된 값, 그리고 해당 값에 대해 사용자의 페이지가 이미 설명하는 내용이 담깁니다. 이 내용은 브리프를 만드는 시점에 실시간으로 읽어 옵니다.
- 검증. 글에 나오는 모든 숫자는 해당 페이지나 값에 기록된 사실에 있어야 합니다. 별도 페이지가 있는 값은 H1이나 직접 답변에 이름이 들어가야 하고, 각 목록은 정해진 항목 수를 채워야 하며, 주소는 아직 사용되지 않은 상태여야 합니다. 자체 AI는 값을
parts로content_get_brief와content_submit에 전달합니다. - 번역에서도 모든 목록의 길이가 동일하게 유지됩니다.
- 전송 데이터에는
{ "company": "google", "role": "software-engineer" }와 같은article.parts가 포함됩니다.
사람들이 검색하는 조합 계획하기
스캔할 때마다 패턴상 가능하지만 아직 페이지가 없는 조합을 최대 500개 주소까지 정리하고, 각 주소에 페이지를 받을 수 있는지 path.check로 사이트에 50개씩 묻습니다. 거부된 주소는 사유와 함께 기록되며 다시 묻지 않습니다. 사이트가 응답하지 않은 주소는 다음 스캔에서 다시 묻습니다. path.check가 연결되어 있지 않으면 "연결할 때까지 새 페이지를 계획하지 않습니다."
수락된 주소는 스캔당 최대 200개까지 리서치 크레딧으로 월간 검색량을 조회합니다. 월 검색량이 10회 이상인 조합은 사이트가 이미 주소를 수락했으므로 모델 검토 없이 백로그에 계획됩니다. 그보다 적은 조합은 "독립된 페이지를 만들기에는 검색량이 너무 적음"이라는 사유로 제외됩니다.
목록 페이지
목록 페이지는 같은 값을 공유하는 모든 페이지에서 하나의 목록을 모아 보여 줍니다. 예를 들어 /interview-questions/data-engineer는 해당 직무의 모든 샘플 질문을 모으고, 각 항목은 출처가 된 페이지로 연결됩니다. AutoPSEO는 사이트가 맡긴 섹션 중 스캔에서 허브로 인식된 섹션에 대해서만 목록 페이지를 만듭니다. 허브로 인식되려면 해당 섹션의 페이지가 어느 한 요소의 값 중 60% 이상, 그리고 최소 3개를 포함해야 합니다.
- 목록 페이지는 모든 언어로 존재하며, 번역이 없는 항목은 원문 텍스트가 표시됩니다.
- 전송 데이터에는
article.kind = "list"와article.parts가 표시되고, 본문은{ title, h1, items: [{ from, text }] }형식입니다. - 목록이 모으는 페이지가 바뀔 때마다 다시 만들어지며, 이때 모델, 검토, 할당량은 사용되지 않고, 다른 페이지가 가진 주소를 차지하지도 않습니다(유지 관리).
- 직접 편집할 수 없습니다. 클레임, 재작성, 롤백, 삭제, 병합은 모두 거부됩니다. 해당 콘텐츠 유형에는 다른 페이지로 구성됨이라고 표시됩니다.
새 경로
새 경로란 주소의 첫 번째 요소에 새로운 값을 추가하는 것입니다. 예를 들어 /interviews/jane-street처럼 새 회사를 추가하는 경우입니다.
- 제안. 자체 AI가
content_propose_value로 값을 제안하거나, AutoPSEO가 검색 수요에서 한 달에 한 번 찾아냅니다. 기존 검색어에서 회사 부분을 뺀 검색어의 키워드 제안을 요청하고, 모델이 회사 이름이 들어간 표현을 골라 콘텐츠 유형당 최대 5개를 제안합니다. 제안 대상은 전체 월 검색량이 100회 이상이고 단일 검색어 기준으로도 10회 이상인 값입니다. 탐색 기능을 쓰려면path.add가 연결되어 있고 리서치 크레딧이 있어야 합니다. - 확인. 모든 제안은 먼저 사이트로 전달됩니다.
new: { part, value, name }을 담은path.check를 보냅니다. 거부되면 사유가 기록되고 해당 값은 다시 제안되지 않습니다. - 작성. 수락된 값은 대기열에 값 작업으로 등록됩니다. 웹을 읽을 수 있는 작성자만 이 작업을 맡을 수 있습니다. 자체 AI나 무인 실행기의 값 세션이 이에 해당합니다(자체 AI). AutoPSEO의 작성기는 값 작업을 건너뛰며, 값 작업은 할당량을 소모하지 않습니다.
- 제출. 작성자는 브리프(규칙, 다른 값에 대한 사용자의 페이지 2개, 새 값이 포함된 검색어)를 읽고
content_submit_value를 보냅니다. 여기에는 이름, 별칭 최대 10개, 공식 https 사이트, 다른 공식 페이지 최대 5개, 160자 이하의 설명, 그리고 3~12개의 사실이 들어갑니다. 각 사실은 https 출처, 확인한 날짜(최근 1년 이내), 등급을 갖춘 평서문 한 문장입니다. 출처가 해당 값의 공식 사이트이면official, 그렇지 않으면reported입니다. 값을 등록하려면 official 사실이 1개 있거나, 서로 다른 2개 이상의 사이트에서 가져온 reported 사실이 3개 있어야 합니다. 현재 규칙은 회사의 채용 방식에 관한 사실을 요구합니다. - 검토 및 전송. 값은 초안과 마찬가지로 검토를 기다립니다. 이후
path.add가 전송 발신함을 통해 사이트로 전달되며, 사이트가 해당 명령을 연결하지 않은 동안에는 대기합니다. - 수락 또는 거부. 수락되면 값이 사이트에 있음으로 표시되고, 사실과 함께 콘텐츠 유형의 값에 추가되며, 다음 스캔에서 해당 페이지가 계획됩니다.
invalid_value로 거부되면 사유와 함께 작성자에게 돌아가고, 세 번째 거부는 최종 거부입니다. 그 밖의 오류 코드는 즉시 최종 거부로 처리됩니다.
콘텐츠 페이지의 "AutoPSEO가 제안, 추가 또는 삭제한 경로"에는 모든 값이 작성 중, 검토 중, 사이트로 전송됨, 사이트에 있음, 제외됨 같은 상태와 함께 표시됩니다.
경로 삭제
이 작업은 사람만 시작할 수 있습니다. 콘텐츠 페이지의 경로 삭제("삭제할 경로", "주소를 연결할 위치(선택)")를 사용하거나, 사용자의 승인을 받아 MCP로 content_remove_path를 호출합니다. path.remove는 사이트에 해당 값과 그 경로 아래의 모든 페이지를 삭제하고, 해당 주소로 들어오는 요청을 redirectTo로 301 리디렉션하도록 요청합니다. 다른 주소를 지정하지 않으면 사이트에 있는 해당 콘텐츠 유형의 자체 페이지로 연결됩니다.
- 콘텐츠 유형에 값이 하나뿐이라면 그 값은 삭제할 수 없습니다.
- 사이트가 삭제를 수락하거나
not_found와 함께 404로 응답하면, AutoPSEO가 보관한 해당 페이지 사본은 추가 전송 없이 내려가고, 해당 페이지에 대해 전송 대기 중이던 항목은 폐기되며, 관련 작업과 해당 값에 계획된 주제는 제외 처리되고, 값은 콘텐츠 유형에서 제거됩니다. 다만 기존 페이지는 스캔 결과에 계속 나타날 수 있습니다. - 사이트가 409
in_use같은 다른 오류로 거부하면 아무것도 변경되지 않습니다.
path.check, path.add, path.remove의 페이로드 형식은 전송에서 확인할 수 있습니다.