콘텐츠 피드로 웹사이트 연결 - Aeolo

직접 코드를 수정할 수 있는 Next.js, Astro, React Router 등의 사이트에 적합합니다. 글 본문은 서버 또는 빌드 시점 HTML에 포함해야 합니다. Aeolo가 렌더링하는 페이지를 그대로 경로에 연결하려면 서브폴더 연결을 사용합니다.

코딩 에이전트에게 요청

사이트 프로젝트에서 Codex·Claude Code·Cursor 등을 열고 다음을 전달합니다.

https://aeolo.io/integrate/content-feed.md 의 v2 가이드를 읽고 진행해줘.
1. aeo CLI 버전을 확인하고 필요하면 업데이트해줘.
2. 브랜드와 GEO/SEO 진단 기준값을 확인해줘.
3. GA4 수집, GSC 소유권과 Aeolo 속성 선택을 확인해줘.
4. 사이트맵과 색인 요청 대상 URL을 준비해줘.
5. 합의한 발행 경로를 사용하거나 만들어줘.
6. 콘텐츠 연결 후 공개 페이지를 검증하고, 승인된 범위에서만
   URL 제출을 진행한 뒤 실제 결과를 보고해줘.

기존 콘텐츠, URL, 디자인과 분석 소유권을 유지해줘.
AEOLO_KEY는 내가 서버 환경에 비공개로 설정하게 해줘.
비밀키를 프롬프트·로그·브라우저 코드에 넣지 마.
공유 로더를 사용하고 페이지네이션·언어·오류·제거 동작을 검증해줘.
각 단계는 통과·실패·대기로 구분하고 로컬 구현·배포·제출·색인을
실제 근거로 따로 보고해줘.

단계별 확인

단계	확인할 내용
도구·브랜드	실행 버전, 브랜드, 시장과 사용 가능한 주장
GEO/SEO 기준값	사이트 진단, 기술적 문제, 주제와 페이지 기회
GA4·GSC	실제 이벤트 수집, 소유권, 선택된 속성
색인 준비	정본 URL, 사이트맵, 색인 가능 상태와 제출 방식
발행 경로	호스트, 글 경로, 채널, 메뉴와 배포 접근
구현·검증	서버 HTML, 언어, 메타데이터, 갱신, 사이트맵, 공개 결과
후속 측정	제출 증거, 관찰된 색인과 비교 가능한 성과

Google 로그인·DNS 접근·발행 승인이 대기 중이어도 로컬 구현과 테스트는 진행할 수 있습니다. Google 계정 연결만으로 분석 태그가 설치되지 않으며 제출 접수만으로 색인이 확인되지 않습니다.

피드 연결

사이트 화면에서 브랜드와 기존 사이트를 선택하거나 커스텀 사이트를 추가합니다. 실제 글 주소(예: https://yourdomain.com/blog)와 언어별 경로를 확인합니다.
Aeolo의 소유권 확인 태그를 HTML에 넣고 배포한 뒤 검증합니다. 이후 제공되는 피드 URL과 한 번 표시되는 키를 서버 전용 환경 변수로 저장합니다.
해당 사이트에 발행 승인된 실제 글을 사용해 배포와 피드 갱신 후 확인합니다.

완료 기준

기존 디자인의 글 목록에 발행된 글이 표시됩니다.
고객 도메인의 글 URL에 전체 본문이 서버 HTML로 제공됩니다.
canonical과 사이트맵이 같은 정본 주소를 가리킵니다.
여러 언어를 운영하면 각 언어의 글이 열립니다.
발행된 수정 사항이 설정된 갱신 주기 뒤에 반영됩니다.

빈 피드라면 해당 채널에 발행된 글이 있는지 확인합니다. 초안은 피드에 나오지 않습니다. 소유권 확인, 콘텐츠 제공, 검색엔진 색인은 별도 단계입니다. 전체 v2 구현 가이드에는 로더와 프레임워크별 예시가 포함되어 있습니다.