> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aeolo.io/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 기존 사이트 디자인에 Aeolo 글을 표시하고 측정·검색 준비를 확인합니다.

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

## 코딩 에이전트에게 요청

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

```text theme={null}
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 계정 연결만으로 분석 태그가 설치되지 않으며 제출 접수만으로 색인이 확인되지 않습니다.

## 피드 연결

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

## 완료 기준

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

빈 피드라면 해당 채널에 **발행된 글**이 있는지 확인합니다. 초안은 피드에 나오지 않습니다. 소유권 확인, 콘텐츠 제공, 검색엔진 색인은 별도 단계입니다.

[전체 v2 구현 가이드](https://aeolo.io/integrate/content-feed.md)에는 로더와 프레임워크별 예시가 포함되어 있습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.