이 사이트는 별도 설치 없이 HTML 파일을 브라우저로 열어 사용하는 방식입니다. 다만 유튜브·AI 분석 기능을 쓰려면 Google API 키 2개를 발급해야 합니다.
1. 사이트 파일 다운로드
- 첨부된 code_artifact.html 파일을 클릭해 다운로드합니다.
- 원하는 폴더에 보관합니다. 예: 문서/유튜브 떡상 검색기
- 파일을 더블클릭해 Chrome 또는 Edge로 엽니다.
- 상단에 YT, Gemini 입력칸이 보이면 정상입니다.
화면 디자인과 외부 API 호출을 위해 인터넷 연결이 필요합니다.
2. YouTube API 키 만들기
이 키는 키워드로 영상을 검색하고, 조회수·구독자 수를 불러오는 데 사용합니다.
- Google Cloud Console에 접속해 Google 계정으로 로그인합니다.
- 상단의 프로젝트 선택 메뉴 → 새 프로젝트를 누릅니다.
- 프로젝트 이름을 입력합니다. 예: 유튜브 떡상 검색기
- 왼쪽 메뉴 API 및 서비스 → 라이브러리로 이동합니다.
- YouTube Data API v3를 검색한 뒤 사용 설정을 누릅니다.
- 왼쪽 메뉴 API 및 서비스 → 사용자 인증 정보로 이동합니다.
- 상단 사용자 인증 정보 만들기 → API 키를 누릅니다.
- 생성된 키를 복사합니다.
공개 영상 검색처럼 로그인한 사용자 정보가 필요 없는 작업에는 API 키를 사용할 수 있습니다.
3. Gemini API 키 만들기
이 키는 검색 결과를 바탕으로 인기 주제와 콘텐츠 아이디어를 AI가 분석할 때 사용합니다.
- Google AI Studio에 접속합니다.
- 왼쪽의 API Keys 또는 Get API key 메뉴를 엽니다.
- Create API key를 누릅니다.
- 새 프로젝트를 만들거나, 앞에서 만든 Google Cloud 프로젝트를 연결합니다.
- 생성된 Gemini API 키를 복사합니다.
Google AI Studio에서 Gemini 키를 만들고 프로젝트와 연결해 관리할 수 있습니다. ai.google.dev
4. 사이트에 키 입력하기
- 사이트 상단의 YT 칸에 YouTube API 키를 붙여넣습니다.
- Gemini 칸에 Gemini API 키를 붙여넣습니다.
- 키 저장을 누릅니다.
- 이후 같은 브라우저에서 다시 열면 키가 자동으로 채워집니다.
5. 떡상 영상 검색하기
- 가운데 검색창에 분석할 키워드를 입력합니다.예: 바이브 코딩, 재테크, AI 활용법
- 떡상 검색을 누릅니다.
- 사이트가 최대 50개 영상을 불러온 뒤,조회수 ÷ 구독자 수가 높은 순으로 정렬합니다.
- 상위 영상의 제목, 채널, 조회수, 구독자 수, 떡상 지수를 확인합니다.
- 특정 영상을 보고 싶다면 영상 시청을 누릅니다.
6. AI로 주제 분석하기
검색 결과가 나온 뒤:
- AI 주제 분석 실행을 누릅니다.
- Gemini가 상위 떡상 영상 15개를 바탕으로 분석합니다.
- 다음 내용을 확인합니다.
- 떡상 영상의 공통점
- 자주 등장하는 키워드
- 시청자 관심 트렌드
- 제목 후킹 방식
- 다음 영상으로 만들 만한 주제 3가지
7. 오류가 날 때
- “YouTube API 키를 입력해주세요”
→ YT 칸에 키를 넣고 키 저장을 누릅니다.
- “API 요청 중 오류” 또는 403 오류
→ YouTube Data API v3를 사용 설정했는지, 키를 정확히 복사했는지 확인합니다.
- “Gemini API 키를 입력해주세요”
→ Gemini 키를 입력하고 저장한 뒤 다시 분석합니다.
- 파일을 더블클릭했는데 기능이 안 될 때
→ 로컬 웹 서버로 여는 방법이 더 안정적입니다. 파일이 있는 폴더에서 터미널을 열고 아래를 실행한 뒤, 브라우저에서 http://localhost:8000을 엽니다.
plain text
python -m http.server 8000꼭 알아둘 보안 주의사항
이 사이트는 키를 브라우저의 로컬 저장소에 보관하지만, 검색·AI 분석을 실행할 때 키는 Google API에 직접 전달됩니다. 따라서 이 파일에 키를 미리 입력한 채로 다른 사람에게 공유하거나 웹에 업로드하면 안 됩니다. 개인 PC에서만 사용하고, 외부에 공개할 사이트라면 키를 숨길 수 있는 서버 방식으로 바꾸는 것이 안전합니다.
