AI 튜토리얼

NiubiGEO로 브랜드의 AI 가시성 감사하기

NiubiGEO를 직접 호스팅하고 원하는 AI 제공업체를 연결해 브랜드 가시성 감사를 실행한 다음, 결론의 근거가 된 질문, 경쟁사, 인용 출처 및 원본 모델 답변을 확인하는 방법을 알아보세요.

2026년 9월 4일약 12분 소요

NiubiGEO란 무엇인가요?

NiubiGEO는 AI 시스템이 제품을 어떻게 이해하고 추천하는지 감사하는 오픈 소스 셀프 호스팅 도구입니다. 도메인을 입력하고 감지된 브랜드 정보와 고객 질문을 검토한 다음, 구성된 AI 제공업체를 선택하면 브랜드의 가시성에 관한 읽기 쉬운 보고서를 생성할 수 있습니다.

가시성을 설명되지 않은 점수로 축소하는 도구와 달리 NiubiGEO는 근거를 확인할 수 있도록 제공합니다. 결론은 테스트 질문, 원래 모델의 답변, 제공업체가 반환한 인용 출처로 연결됩니다.

NiubiGEO Community Edition은 제공업체 API를 사용합니다. 공개 ChatGPT, Claude, Gemini 또는 Perplexity 웹사이트와 같은 소비자용 인터페이스의 결과를 재현하지 않습니다.

감사에서 확인할 수 있는 내용

NiubiGEO 감사는 추상적인 GEO 지표를 대량으로 제시하기보다 실용적인 비즈니스 질문에 답하도록 설계되었습니다.

브랜드 인지도: 선택한 모델이 제품을 인식하는지, 제품을 어떻게 설명하는지 확인합니다.
경쟁사 발견: 고객이 카테고리, 비교 또는 추천 질문을 할 때 어떤 제품이 나타나는지 확인합니다.
가시성 격차: 경쟁사는 나타나지만 브랜드는 나타나지 않는 관련 질문을 파악합니다.
출처 분석: 답변에 영향을 주는 공식, 커뮤니티 및 제3자 출처를 검토합니다.
근거 확인: 보고서의 각 결론을 뒷받침하는 원래 AI 응답을 엽니다.

이 프로젝트는 확정된 경쟁사와 단순히 느슨한 관련성만 있을 수 있는 이름을 구분합니다. 또한 제공업체에 요청을 보내기 전에 질문을 검토하고 편집할 수 있습니다.

주요 기능

Apache-2.0 라이선스로 제공되는 오픈 소스 Community Edition.
자체 제공업체 API 키를 사용하는 무료 셀프 호스팅.
다양한 AI 제공업체 및 모델 지원.
브랜드, 별칭, 카테고리, 키워드 및 경쟁사 발견.
감사 실행 전 질문 확인.
추천 및 제공업체가 반환한 인용 분석.
기반 질문과 답변까지 추적 가능한 보고서.
영어 및 중국어 간체 인터페이스, 프롬프트, 분석 및 보고서.

지원되는 제공업체

NiubiGEO는 OpenRouter, OpenAI, Anthropic, Google Gemini, Perplexity, DeepSeek 및 OpenAI 호환 API를 지원합니다. 제공업체에 따라 네이티브 웹 검색, 검색 기반 응답, 웹 기반 답변 또는 제공업체가 반환한 인용을 사용할 수 있습니다.

OpenRouter 키를 사용하면 여러 제공업체의 모델에 액세스할 수 있지만, 생성된 요청은 여전히 OpenRouter API 결과로 표시됩니다. 제공업체 자격 증명은 서로 별개입니다. OpenAI 키는 OpenAI를 호출하고 Gemini 키는 Gemini를 호출합니다.

사전 요구 사항

가장 빠른 설치 방법은 Docker와 Docker Compose를 사용하는 것입니다. 또한 지원되는 제공업체의 API 키가 하나 이상 필요합니다. 소스에서 직접 실행하려면 Node.js 22 이상을 설치하세요.

Git
Docker 및 Docker Compose 또는 Node.js 22+
지원되는 제공업체 중 하나 이상의 API 키
감사할 도메인 또는 제품 페이지

Docker로 NiubiGEO 설치

1. 저장소 복제

git clone https://github.com/Albert-Weasker/niubigeo.git
cd niubigeo
cp .env.example .env

2. 제공업체 키 추가

.env를 열고 유효한 API 키를 하나 이상 추가합니다. 모든 제공업체를 구성할 필요는 없습니다.

OPENROUTER_API_KEY=
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
GEMINI_API_KEY=
PERPLEXITY_API_KEY=
DEEPSEEK_API_KEY=

예를 들어 OpenAI를 사용할 계획이라면 OPENAI_API_KEY를 입력하고 사용하지 않는 제공업체 항목은 비워 둡니다.

3. 애플리케이션 빌드 및 시작

docker compose up --build

서비스가 준비되면 브라우저에서 http://localhost:8787을 엽니다.

게시된 컨테이너 이미지 사용

GitHub Container Registry에서 미리 빌드된 알파 이미지를 사용할 수 있습니다.

docker pull ghcr.io/albert-weasker/niubigeo:v0.1.0-alpha

latest 태그가 지정된 이미지도 가져올 수 있습니다.

docker pull ghcr.io/albert-weasker/niubigeo:latest

Node.js로 설치

Docker 없이 프로젝트를 실행하려면 Node.js 22 이상이 설치되어 있는지 확인합니다. 그런 다음 저장소를 복제하고 환경 파일을 생성한 뒤, 종속 항목을 설치하고 자체 점검을 실행한 다음 서버를 시작합니다.

git clone https://github.com/Albert-Weasker/niubigeo.git
cd niubigeo
cp .env.example .env
npm install
npm run self-check
npm run server

감사를 시작하기 전에 .env에 제공업체 키를 추가합니다. 구성된 키가 없으면 NiubiGEO는 실제 AI 가시성 결과를 생성할 수 없습니다.

웹 인터페이스에서 첫 감사 실행

도메인 입력: 회사 도메인 또는 관련 제품 페이지를 입력합니다.
발견 결과 검토: NiubiGEO가 브랜드, 별칭, 카테고리, 키워드 및 가능한 경쟁사를 식별합니다.
항목 확인: 브랜드 정보를 수정하고 실제 경쟁사와 관련 없는 이름을 구분합니다.
질문 검토: 제공업체 요청을 보내기 전에 제안된 고객 질문을 편집합니다.
감사 실행: NiubiGEO가 선택한 제공업체 API를 호출하고 답변과 반환된 출처를 분석합니다.
보고서 읽기: 브랜드 인지도, 경쟁사 노출, 브랜드가 누락된 질문 및 뒷받침하는 근거를 확인합니다.

주요 보고서는 간결한 결론을 강조합니다. 전체 AI 답변은 기본적으로 접혀 있으므로, 근거를 확인해야 할 때만 펼쳐 볼 수 있습니다.

명령줄에서 감사 실행

CLI는 반복 가능한 로컬 테스트와 스크립트 기반 워크플로에 유용합니다. 다음 예시는 OpenRouter를 통해 example.com을 감사하고, 두 개의 모델을 사용하며, 8개의 프롬프트를 생성합니다:

npm run audit -- \
  --domain example.com \
  --provider openrouter \
  --models openai/gpt-4o-mini,perplexity/sonar \
  --prompt-count 8

도메인, 제공자, 모델 식별자를 감사에 적합한 값과 구성된 인증 정보로 바꾸세요.

키워드, 경쟁사, 사용자 지정 질문 추가

카테고리 키워드, 알려진 경쟁사, 고객 질문을 사용해 감사를 안내할 수 있습니다. 키워드와 경쟁사는 쉼표로 구분합니다. 사용자 지정 프롬프트는 세로 막대로 구분합니다.

npm run audit -- \
  --domain example.com \
  --keywords "category keyword,buyer intent keyword" \
  --competitors rival.com,other.com \
  --prompts "What are the best tools in this category?|What are the alternatives?"

기본적으로 생성된 보고서는 로컬 runs/ 디렉터리에 저장됩니다.

보고서 해석 방법

먼저 브랜드 인지도 확인

모델이 제품을 올바르게 식별하는지, 어떤 카테고리로 분류하는지, 어떤 중요한 기능을 누락하는지 살펴보세요. 인지도만으로는 모델이 브랜드의 포지셔닝을 정확히 이해한다고 볼 수 없습니다.

확인된 경쟁사 검토

추천 또는 대안 질문에 반복적으로 등장하는 경쟁사에 주목하세요. NiubiGEO는 확인된 경쟁사와 관련 가능성이 있는 브랜드를 구분하므로, 언급된 모든 회사를 직접적인 경쟁자로 취급하지 않도록 도와줍니다.

브랜드가 빠진 질문 찾기

유용한 가시성 격차는 경쟁 제품은 추천되지만 브랜드가 빠진 관련 고객 질문입니다. 이러한 격차는 AI가 브랜드의 포지셔닝에 대한 정보를 충분히 갖고 있지 않거나, 특정 사용 사례와 제품을 연결하지 못하는 지점을 보여줄 수 있습니다.

출처와 원본 답변 확인

중요한 결론의 근거를 열어 보세요. 답변이 공식 사이트, 커뮤니티 토론, 타사 페이지 중 어디에 의존하는지 확인하세요. 인용은 제공자가 반환한 출처 또는 AI 답변에 명시적으로 포함된 출처로 제한됩니다.

더 나은 감사를 위한 고급 팁

구매 의도를 반영하는 질문 사용

일반적인 프롬프트로는 가장 유용한 경쟁 격차가 드러나지 않을 수 있습니다. 카테고리 추천, 대안, 비교, 사용 사례별 요청처럼 고객이 실제로 묻는 질문을 추가하세요. 제공자 호출을 시작하기 전에 생성된 질문을 반드시 검토하세요.

둘 이상의 모델 또는 제공자 테스트

모델마다 브랜드를 인식하고, 경쟁사를 추천하며, 출처를 반환하는 방식이 다를 수 있습니다. 여러 제공자를 사용한 감사는 이러한 차이를 관찰하는 데 도움이 되지만, 결과를 소비자용 제품 인터페이스와 직접 동등한 것으로 간주해서는 안 됩니다.

감사 조건 일관되게 유지

AI 출력은 확률적이므로 한 번의 실행 결과가 영구적인 순위를 의미하지는 않습니다. 변경 사항을 평가할 때는 도메인, 질문, 제공자, 모델, 언어 및 기타 감사 조건을 가능한 한 동일하게 유지하세요. 동일한 조건에서의 공식 보고서 비교는 현재 기능이 아니라 계획된 기능으로 분류되어 있습니다.

올바른 언어 선택

NiubiGEO는 영어와 중국어 간체를 지원합니다. 선택한 언어는 인터페이스, 생성되는 모니터링 질문, 제공자 프롬프트, 브랜드 및 경쟁사 분석, 최종 보고서에 영향을 줍니다. 조사하려는 대상의 경험과 일치하는 언어를 사용하세요.

API 결과의 범위 이해

제공자 API의 답변은 소비자용 웹 애플리케이션에 표시되는 응답과 다를 수 있습니다. Community Edition은 지역 사용자나 소비자용 웹 인터페이스를 시뮬레이션하지 않습니다. 사람을 통한 테스트, 스크린샷, 지역별 확인, 완전한 소비자 증거 패키지는 프로젝트에서 설명하는 별도의 관리형 서비스에 포함됩니다.

인증 정보와 보고서 데이터 보호

.env, 제공자 키, 비공개 프롬프트, 고객 보고서 또는 runs/의 민감한 파일을 소스 제어에 절대 커밋하지 마세요. 프로젝트는 보안 정책을 통해 보안 문제를 비공개로 신고할 것을 권장합니다.

현재 프로젝트 상태

NiubiGEO의 현재 버전은 v0.1.0-alpha입니다. 핵심 감사 워크플로는 작동하지만 인터페이스, 보고서 규칙, 데이터 구조는 변경될 수 있습니다.

현재 제공되는 기능에는 여러 제공자를 사용한 감사, 감사 전 질문 확인, 브랜드 및 경쟁사 탐색, 출처 필터링, 추적 가능한 보고서, 이중 언어 지원이 포함됩니다. 예약 모니터링, 보고서 비교, 보고서 내보내기 패키지, 제공자 플러그인 SDK 및 추가 제공자는 현재 제공되지 않으며 계획 단계에 있습니다.

NiubiGEO를 사용해야 하는 경우

오픈 소스 감사, 모델과 질문에 대한 제어권, 자체 호스팅 실행, 모든 결론의 근거에 대한 직접적인 접근이 필요하다면 NiubiGEO가 적합합니다. 호스팅 인프라, 독점 데이터 세트, 예약 보고, 성숙한 팀 워크플로 또는 광범위한 마케팅 통합이 필요하다면 상용 플랫폼이 더 적합할 수 있습니다.

결론

NiubiGEO는 AI 시스템이 제품을 알고 있는지, 제품을 어떻게 설명하는지, 어떤 경쟁사를 추천하는지, 어떤 출처가 답변에 영향을 미치는지를 투명하게 조사할 수 있는 방법을 제공합니다. Docker 또는 Node.js로 시작하고, 지원되는 제공자 하나를 연결한 뒤, 질문을 신중하게 검토하고, 보고서의 근거 링크를 사용해 AI 가시성 결과를 검증 가능한 관찰로 전환하세요.

업데이트, 소스 코드, 기여 방법은 NiubiGEO GitHub 저장소에서 확인할 수 있습니다.