크롬 확장 프로그램 배포: 권한과 심사 준비하기
AI로 SEO 확장 프로그램을 만든 경험을 바탕으로 내 크롬에서 실행하는 단계부터 스토어 심사 준비까지 설명합니다. 권한 소명, 원격 코드와 API의 차이, 개인정보 처리방침을 실제 동작과 대조하는 방법을 다룹니다.

세 줄로 먼저 읽기
- 크롬 확장 프로그램은 확장 프로그램 관리 화면의 개발자 모드로 내 브라우저에서 먼저 실행해 보고, ZIP 파일과 스토어 설명을 준비해 심사에 제출합니다.
- 권한 설명과 원격 코드 답변은 실제 코드에 맞춰야 하며 API로 데이터만 주고받는 것과 외부 코드를 받아 실행하는 것은 다릅니다.
- Chrome은 웹페이지 내용도 사용자 데이터로 보기 때문에 페이지를 읽는 확장 프로그램은 로컬에서만 처리해도 개인정보 처리방침이 필요합니다.
업무에 쓰려고 AI의 도움을 받아 SEO 분석용 크롬 확장 프로그램을 만들었습니다. SEO는 검색엔진이 웹페이지 내용을 이해하도록 제목과 구조 등을 정리하는 작업입니다. 크롬 확장 프로그램은 브라우저에 기능을 추가하는 작은 프로그램입니다.
코드를 만드는 일보다 어려웠던 것은 Chrome 웹 스토어의 심사 질문에 답하는 일이었습니다. 권한이 필요한 이유와 원격 코드를 쓰는지 답하려면, 만든 프로그램이 실제로 무엇을 하는지 설명할 수 있어야 했습니다.
이 글은 그 경험을 바탕으로 완성한 확장 프로그램을 내 브라우저에서 실행해 보고 심사 자료를 준비하는 순서를 설명합니다. 코드를 처음부터 짜는 방법은 다루지 않습니다. 권한과 데이터 처리 설명은 2026년 10월 4일 Chrome 공식 문서 기준입니다.
확장 프로그램을 만든 뒤 스토어에 올리기까지
1. 내 크롬에서 실행개발자 모드로 불러와
제목이 맞게 나오는지
2. 권한 소명권한마다 실제로
하는 일을 한 문장으로
3. 원격 코드 답변외부에서 받은 코드를
실행하는지
4. 처리방침무엇을 어디로 보내고
어디에 저장하는지
5. 제출과 심사ZIP 업로드 뒤
검토 상태 확인
제가 만든 도구는 무엇을 하나요?
Claude 같은 생성형 AI와 작업하며 manifest.json과 JavaScript 코드를 수정했습니다. manifest.json은 확장 프로그램의 이름, 버전, 필요한 권한을 선언하는 설정 파일입니다.
이 도구는 현재 웹페이지의 HTML, 즉 페이지 구조를 나타내는 코드를 읽고 제목과 설명 등을 점검합니다. 아래는 AI 분석을 실행한 뒤 키워드와 제목 제안을 보여 주는 개발 당시 화면입니다. 화면의 점수는 도구가 자체 기준으로 매긴 값이며 검색 순위나 검색엔진의 공식 점수가 아닙니다.
심사 질문에 답하려면 화면이 뜨는 것보다 더 많은 것을 알아야 합니다. 언제 페이지를 읽는지, 무엇을 외부로 보내는지, 어디에 저장하는지를 설명할 수 있어야 합니다.
내 크롬에서 먼저 실행하기
준비물은 데스크톱 Chrome과 본인이 만든 확장 프로그램 폴더입니다. 폴더를 열었을 때 manifest.json이 바로 보여야 합니다. 원본 코드에서 배포 파일을 따로 만드는 프로젝트라면, 코드를 실행 가능한 파일로 만드는 빌드 과정을 거친 결과 폴더를 씁니다. 어느 폴더가 원본이고 어느 폴더가 배포용인지 모르겠다면 AI에게 두 폴더의 위치와 배포 파일을 만드는 명령을 먼저 물어봅니다.
확장 프로그램을 내 크롬에 불러와 시험하는 순서
1. 관리 화면 열기주소창에
chrome://extensions
2. 개발자 모드스위치를 켜면
불러오기 버튼이 보임
3. 폴더 불러오기manifest.json이 든 폴더 선택
목록에 이름이 뜨면 성공
4. 공개 페이지에서 실행표시한 제목이 페이지 소스의
title과 같으면 성공
5. 다른 페이지에서 다시제목이 새 페이지 값으로
바뀌면 성공
3번의 불러오기 버튼은 압축해제된 확장 프로그램을 로드합니다 또는 Load unpacked로 표시됩니다. 4번에서는 분석해도 되는 공개 페이지를 열고 확장 프로그램 아이콘을 누른 뒤, 브라우저의 페이지 소스 보기에서 <title>을 찾아 도구가 표시한 제목과 비교합니다. SEO 점수가 높게 나오는 것은 정상 작동의 근거가 되지 못합니다.
5번에서 이전 페이지의 제목이 남아 있다면 새 페이지를 읽는 부분부터 고쳐야 합니다. 페이지가 실행 중에 제목을 바꾸는 사이트는 소스와 현재 값이 다를 수 있어서, 처음 비교할 때는 제목이 고정된 간단한 페이지를 고릅니다.
등록이 실패하면 오류에 적힌 파일 이름과 경로부터 봅니다. chrome://로 시작하는 브라우저 내부 페이지는 일반 웹페이지와 달리 확장 프로그램의 접근이 제한되므로 시험 대상으로 쓰지 않습니다. 코드를 고친 뒤에는 확장 프로그램 목록의 새로고침을 누르고 대상 웹페이지도 새로고침해 다시 시험합니다. 시험을 멈추려면 해당 확장 프로그램의 켜기 스위치를 끕니다. 자세한 화면 순서는 Chrome 로컬 실행 안내에 있습니다.
내 크롬에 불러왔다고 스토어에 게시된 것은 아닙니다. 개발자 등록 안내대로 스토어에 올리려면 일회성 등록비를 내야 하고, AI 분석에 쓰는 API 사용료는 그와 별도로 나갈 수 있습니다.
권한 요청 소명: 실제 동작을 한 문장으로 적기
권한 요청 소명은 프로그램이 그 권한을 왜 쓰는지 설명하는 일입니다. 먼저 manifest.json의 permissions와 host_permissions를 봅니다. 앞의 것은 기능 권한, 뒤의 것은 접근할 웹 주소 범위를 선언하는 항목입니다. 웹페이지 안에서 실행하는 코드인 콘텐츠 스크립트가 어느 주소에 들어가는지도 함께 봅니다. 권한 선언은 허용 범위만 보여 주고, 실제로 읽거나 보낸 항목까지 알려 주지는 않습니다.
아래 문장은 작성 방법을 보여 주는 예시입니다. 자신의 코드가 같은 방식으로 동작할 때만 쓸 수 있습니다.
| 권한 | 동작이 같을 때 쓸 수 있는 설명 예시 |
|---|---|
activeTab | 사용자가 확장 아이콘을 누르면 현재 탭의 페이지를 분석하려고 일시적으로 접근합니다 |
scripting | 분석 대상으로 지정된 페이지에서 제목과 메타 설명을 읽는 코드를 실행합니다 |
storage | 사용자가 선택한 언어와 테마 설정을 storage.local에 저장합니다 |
activeTab 안내에 따르면 activeTab은 아이콘 클릭 같은 사용자 동작이 있을 때 현재 탭에만 임시로 접근하게 합니다. 접근이 언제까지 유지되는지는 출처로 정해집니다. 출처는 주소의 통신 방식과 호스트, 포트를 합친 기준이며, https://example.com/a에서 같은 사이트의 /b로 옮기면 출처가 같고 다른 사이트로 가면 출처가 바뀝니다.
아이콘을 누른 뒤 activeTab 접근이 유지되는 경우
| 그다음 한 일 | |
|---|---|
| 아이콘을 누른 현재 탭 | 제공 |
| 같은 출처 안의 다른 페이지로 이동 | 유지될 수 있음 |
| 다른 출처의 페이지로 이동 | 제공하지 않음 |
| 탭을 닫음 | 제공하지 않음 |
| 아이콘을 누르지 않은 다른 사이트 | 제공하지 않음 |
scripting 권한은 읽기 전용이 아닙니다. 실행하는 코드에 따라 페이지를 바꿀 수도 있으므로, "읽기만 한다"고 쓰려면 코드가 실제로 값을 읽기만 하는지 봐야 합니다.
storage도 이름만으로 로컬 저장인지 알 수 없습니다. 저장 방식 안내를 보면 storage.local은 그 브라우저에만 저장하고, storage.sync는 사용자가 동기화를 켰을 때 다른 Chrome 브라우저와 데이터를 맞춥니다. 언어 설정을 storage.sync에 둔다면 "로컬에만 저장한다"는 문장은 고쳐야 합니다.
권한마다 어디서 쓰이는지는 AI가 코드를 읽고 찾게 할 수 있습니다. "심사를 통과할 문장을 써 줘"보다 파일 근거를 함께 달라고 요청해야 설명이 코드와 맞는지 대조할 수 있습니다.
scripting, content.js, 제목과 메타 설명 읽기
storage, settings.js, storage.local에 언어 저장
답변에 파일 근거가 없거나 설명과 코드가 다르면 제출 문장을 아직 확정하지 않습니다. 코드를 볼 줄 아는 사람과 함께 대조하고, 쓰지 않는 권한은 manifest에서 빼서 필요한 범위만 요청하게 고칩니다.
원격 코드와 외부 API는 무엇이 다른가요?
제 도구는 Gemini API로 AI 분석을 요청합니다. API는 프로그램끼리 요청과 결과를 주고받는 연결 방식입니다. 외부와 통신한다고 해서 원격 코드를 쓰는 것은 아닙니다.
원격 코드 공식 안내에 따르면 원격 코드는 확장 프로그램 파일에 들어 있지 않은 실행 코드를 외부에서 받아 브라우저에서 실행하는 경우입니다. JavaScript나 WebAssembly가 여기에 들어갑니다. 판단 기준은 통신 여부가 아니라 받은 것을 코드로 실행하는지입니다.
외부에서 받은 것을 어떻게 쓰는지에 따른 원격 코드 여부
| 항목 | |||
|---|---|---|---|
| 외부 서버와 통신 | 제공 | 제공 | 제공 |
| 받은 내용을 코드로 실행 | 제공하지 않음 | 제공 | 제공 |
| 원격 코드에 해당 | 제공하지 않음 | 제공 | 제공 |
Manifest V3는 manifest_version이 3인 확장 프로그램 규격이고, 이 규격에서는 확장 프로그램이 실행하는 코드를 패키지 안에 넣어야 합니다. eval 같은 함수 하나만 찾아서는 판단할 수 없고, 함께 넣은 라이브러리가 외부 코드를 받아 실행하는지도 봐야 합니다. 심사 질문에 '아니요'로 답하기 전에 제출할 파일과 포함된 라이브러리를 이렇게 확인해 두면 답변과 코드가 어긋나지 않습니다.
개인정보 처리방침: 로컬과 외부 전송을 구별하기
처음에는 별도 서버를 운영하지 않으니 데이터 처리도 없다고 생각하기 쉽습니다. 하지만 페이지 내용을 Gemini에 보내 분석한다면 외부 서비스로 보내는 과정이 있습니다. "우리 서버에 저장하지 않는다"와 "외부로 보내지 않는다"는 서로 다른 설명입니다. 페이지 제목을 Gemini API로 보내 설명문을 받는 확장이라면 "모든 데이터는 내 기기에서만 처리한다"는 문장은 사실과 다릅니다.
사용자 데이터 정책 FAQ에 따르면 Chrome이 말하는 사용자 데이터에는 이름과 이메일뿐 아니라 웹페이지 내용과 탐색 활동도 들어갑니다. 이런 데이터를 다루는 확장 프로그램은 로컬에서만 처리하더라도 처리방침이 필요합니다.
처리방침을 코드와 맞춰 쓰는 순서
1. 수집 항목페이지 제목, 본문,
설정값 중 무엇을
2. 사용 목적분석 결과 표시처럼
왜 쓰는지
3. 받는 곳Gemini API처럼
데이터가 가는 서비스
4. 저장 위치와 기간storage.local인지 sync인지
언제까지 남는지
5. 삭제 방법사용자가 지우는 방법
각 항목은 코드와, 연결한 서비스의 데이터 보관 조건에 대조해 씁니다. AI 서비스로 보내는 내용을 빼놓거나, 확인하지 않은 채 "저장하지 않음"이라고 적지 않습니다.
저는 처리방침을 Google Sites에 문서로 올리고 그 URL을 제출했습니다. 별도 서버 없이도 문서를 공개할 수 있지만, 다른 서비스의 문장을 복사해 넣는 것으로는 부족합니다. 실제 처리에 맞춘 내용을 게시하고, 로그아웃한 브라우저에서도 그 URL이 열리는지 봅니다.
제출 준비부터 심사 결과 확인까지
스토어 제출에는 개발자 계정과 게시할 ZIP 파일이 필요합니다. ZIP은 여러 파일을 하나로 묶은 압축 파일입니다. 확장 프로그램의 배포 파일과 아이콘 등을 담고, 비밀 키나 필요 없는 개발 파일이 들어가지 않았는지 봅니다.
개발자 대시보드에서 제출하는 순서
1. ZIP 업로드개발자 대시보드의
새 항목
2. 스토어 등록정보기능 설명과
실제 화면
3. 개인정보 보호단일 목적, 권한 근거,
데이터 처리
4. 배포 범위와 테스트 안내심사자가 기능을
재현할 방법
5. 검토 제출자동 게시 여부를 정한 뒤
제출하여 검토받기
Chrome 개발자 대시보드에 로그인해 새 항목에서 ZIP을 올리면 등록정보와 개인정보 보호 항목을 채우는 화면이 이어집니다. 외부 계정이 있어야 동작하는 기능이라면 4번에서 심사자가 재현할 방법을 적어 둡니다. 제출하여 검토받기를 누르기 전에는 승인 후 자동으로 게시할지 정하고, 게시 시점을 직접 고르려면 자동 게시 선택을 해제합니다. 전체 절차는 공식 게시 절차에 나와 있습니다.
화면의 검토 대기 중은 제출이 접수된 상태이고, 이후 심사 상태는 대시보드와 등록 이메일에서 봅니다. 내 크롬에서 작동하는 상태, 심사에 제출한 상태, 스토어에 공개된 상태는 서로 다른 단계입니다.
제출이 막히면 화면에 뜬 제출 불가 사유와 비어 있는 항목부터 봅니다. 반려되면 사유를 보관하고, 지적된 코드나 설명을 어떻게 바꿨는지 기록한 뒤 다시 제출합니다. 다음 버전을 올릴 때도 바뀐 파일로 내 크롬 실행과 권한 설명을 다시 대조하면 같은 문제로 반려되는 일을 줄일 수 있습니다.
자주 묻는 질문
API를 호출하면 원격 코드를 쓴다는 뜻인가요?
API에서 데이터를 받아 표시하는 것만으로는 원격 코드가 아닙니다. 외부에서 받은 내용을 실행 코드로 쓰는지와 함께 넣은 라이브러리의 동작을 봐야 판단할 수 있습니다.
로컬에서만 처리하면 개인정보 처리방침이 없어도 되나요?
웹페이지 내용을 다루는 확장 프로그램은 로컬에서만 처리해도 처리방침이 필요합니다. Chrome은 웹페이지 내용도 사용자 데이터로 보기 때문에, 외부 서버가 있는지만으로 판단하지 않습니다.
권한 소명 예시를 그대로 써도 되나요?
자신의 코드가 같은 동작을 할 때만 쓸 수 있습니다. 실행 계기, 읽는 항목, 저장 위치와 외부 전송을 코드에서 찾은 뒤 그 동작을 그대로 설명하는 문장으로 씁니다.

제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
외부 API에서 JSON 설명문만 받아 표시하고, 받은 내용을 코드로 실행하지 않는다면 무엇을 확인해야 할까요?

새 글과 AI 소식을 메일로 받아 보세요
AI가 바꾸는 일과 도구, 측정 실무 이야기를 매주 한 번 보내 드려요.
이 글이 도움이 되었나요?
AI 검색에 인용되려면 먼저 크롤링과 색인이 되어야 합니다. 그 순서를 다룹니다
코스 전체 보기 →