GeoRankers AI MCP 서버를 사용하여 Claude 또는 ChatGPT에서 브랜드의 AI 가시성 데이터 조회하기

브랜드가 AI 답변에 어떻게 노출되는지 확인하는 것은 보통 작업 중인 도구를 떠나 대시보드를 열고, 탭을 클릭하고, 숫자를 문서나 티켓에 다시 복사하는 과정을 거칩니다.

GeoRankers MCP 서버는 이러한 왕복 과정을 제거합니다. GeoRankers 계정을 Claude 또는 ChatGPT에 한 번 연결한 다음, 평이한 언어로 브랜드에 대한 질문을 할 수 있습니다.

솔직히 밝히자면, 저는 GeoRankers의 설립자이므로 이 게시물은 저희 자체 서버를 설명하고 있습니다.

요약 (TL;DR)

GeoRankers가 이미 계산한 제품에 대한 읽기 전용 분석 데이터에 Claude 또는 ChatGPT가 접근할 수 있게 합니다.
대시보드에서 생성하는 개인 액세스 토큰(Personal Access Token)으로 연결합니다.
과거 분석 실행 결과에서 데이터를 읽어옵니다. 질문을 한다고 해서 새로운 분석을 수행하지는 않습니다.
데이터는 브랜드 수준의 집계 데이터이므로, 방향성 신호로 해석해야 합니다.

무엇을 물어볼 수 있나요?

특정 도구 이름을 알 필요가 없습니다. 일반 언어로 질문하면 어시스턴트가 GeoRankers 데이터에서 답변을 찾아줍니다.

다음은 이 서버가 처리하도록 설계된 질문 유형의 예시입니다.

무엇이 GeoRankers에 등록된 제품인가요?

이 제품에 대해 추적하는 키워드는 무엇이며, 각 키워드별로 예측되는 검색 쿼리는 무엇인가요?

최신 가시성 점수와 언급량(share of voice)을 짧은 표로 요약해 주세요.

제 점수가 지난 몇 번의 실행 동안 어떻게 변했나요? 이 실행들은 서로 비교할 만한가요?

이것들은 질문할 수 있는 예시일 뿐, 실제 기록된 세션은 아닙니다. 내부적으로 서버는 애플리케이션, 제품, 키워드, 최신 분석, 시간 경과에 따른 트렌드 및 플랜 정보 등을 다루는 8개의 읽기 전용 도구를 노출합니다. 어시스턴트가 적절한 도구를 선택하므로 사용자가 신경 쓸 필요가 없습니다.

비교 가능한 실행이 중요한 이유?

두 개의 분석 실행이 항상 같은 것을 측정하는 것은 아닙니다. 만약 두 실행 사이에 방법이나 플랫폼 세트가 변경되었다면, 더 높거나 낮은 점수가 가시성의 실제 변화를 의미하지 않을 수 있습니다. 트렌드 데이터는 각 실행이 이전 실행과 비교 가능한지 여부를 표시하므로, 시간 경과에 따른 변화를 문의할 때는 이 기능을 요청하세요.

연결 방법은 무엇인가요?

접근하려면 기존의 GeoRankers 계정이 필요합니다. 대시보드에서 Developers 및 API 페이지를 열고 Personal Access Token을 생성하세요. 이름을 선택하고 만료일을 30일, 90일, 180일, 1년 또는 만료 없음으로 설정할 수 있습니다. 더 짧은 만료 기간이 안전한 기본값입니다.

Claude

Claude는 커스텀 커넥터를 통해 연결됩니다. 웹상의 Claude에서 프로필 메뉴를 열고 Customize로 이동한 다음 Connectors로 가서 GeoRankers라는 이름의 커스텀 커넥터를 추가하세요. 원격 서버 URL에는 사용자 자신의 호스트와 토큰을 사용하여 이 양식을 사용하세요:

대시보드에는 토큰이 채워진 계정의 정확한 URL이 표시됩니다. 토큰은 해당 URL의 일부이므로, 전체를 비밀번호처럼 취급해야 합니다. 티켓, 채팅 또는 스크린샷에 붙여넣지 말고, 유출될 경우 대시보드에서 토큰을 폐기하세요.

ChatGPT

ChatGPT는 커스텀 GPT를 통해 연결됩니다. 하나를 생성하고 액션을 추가한 다음 https://<mcp-host>/openapi.json에서 스키마를 가져오세요. 인증은 Bearer 유형의 API 키로 설정하고 토큰을 붙여넣으세요. 클라이언트 시크릿이나 로그인 URL은 필요하지 않습니다.

기타 클라이언트

저는 Claude와 ChatGPT에 대해서만 설명했습니다. 왜냐하면 대시보드가 이 두 가지를 안내하기 때문입니다. 원격 서버 URL을 허용하는 다른 MCP 클라이언트도 동일한 엔드포인트로 작동할 수 있지만, 이는 테스트되지 않았습니다.

내부적으로는 어떻게 작동하나요?

어시스턴트가 실제로 호출하고 있는 것이 무엇인지 알고 싶다면, 8개의 도구가 있으며 그 모든 것은 읽기(read) 작업입니다.

list_applications는 계정이 접근할 수 있는 애플리케이션 목록을 반환합니다. 그 외 모든 것은 애플리케이션 ID에서 시작됩니다.
list_products는 하나의 애플리케이션에 속한 제품 목록을 반환합니다.
get_product은 단일 제품의 상세 정보를 반환합니다.
get_product_keywords는 제품별 추적 키워드와 그와 연결된 예측 검색어 쿼리를 함께 반환합니다.
get_product_analytics는 가시성 점수(visibility score), 언급 점유율(share of voice), 브랜드 성과를 포함하여 가장 최근에 계산된 분석 데이터를 반환합니다.
get_analytics_trend는 과거 결과를 반환하므로, 점수가 실행(run)별로 어떻게 변했는지 확인할 수 있습니다.
get_current_subscription 및 get_subscription_plans는 플랜 및 사용량 정보를 반환합니다.

이 데이터를 스크립트에 연결하여 사용할 경우, 두 가지 응답 필드를 아는 것이 중요합니다.

추세 데이터(trend data)에는 comparable_with_previous 플래그가 포함되어 있으며, 이 값이 false일 때 그 이유 목록을 제공합니다. 분석 결과에서 geo_score는 null일 수 있으며, status 필드가 그 이유를 설명합니다. 문서화된 값으로는 ok, insufficient_data, incomplete_coverage, scoring_quality_issue, 그리고 legacy_unavailable가 있으므로, 점수를 사용하기 전에 반드시 status로 분기 처리해야 합니다.

토큰은 pat_으로 시작해야 하며, 서버는 다른 모든 것을 거부합니다. 권한은 제품(products), 분석(analytics), 계정(account)별 리소스마다 설정됩니다. 오늘날 모든 도구는 읽기 전용(read)만 필요합니다.

제한 사항은 무엇인가요?

이 데이터는 브랜드 수준의 집계된 정보입니다. 사용자별, 계정별 또는 잠재 고객별로 제공되는 것이 아니므로 그렇게 해석해서는 안 됩니다. 또한 ChatGPT나 Gemini 앱에서 개인이 보는 것과 일치한다고 주장하지 않는데, 그 이유는 답변이 세션, 위치, 시간에 따라 다르기 때문입니다. 정확한 위치를 단언하기보다는, 점수와 언급률을 사용하여 비교 가능한 실행(comparable runs) 전반에 걸친 움직임을 추적하는 데 사용하십시오.

GeoRankers가 이를 MCP를 통해 공개하는 이유는 무엇인가요?

GeoRankers는 '답변 안정성(answer stability)'이라 부르는 개념을 통해 브랜드의 AI 가시성을 접근합니다. 이는 동일한 구매 질문에 대해 반복적으로 실행했을 때 브랜드가 얼마나 자주 나타나는지를 측정하며, 각 답변의 출처와 함께 분석됩니다. 한 번의 실행 결과는 오해를 불러일으킬 수 있지만, 여러 번의 실행에서 나타나는 패턴은 무시하기 더 어렵습니다. 이 데이터를 어시스턴트에 통합하면 이미 분석을 수행하는 곳과 가깝게 유지할 수 있습니다.

이러한 사고 과정에 대한 배경 정보는 GeoRankers guide를 참고하세요.

FAQ

저를 위해 새로운 분석을 실행해 줄 수 있나요?

아니요. 이미 완료된 분석 실행 결과만 읽어옵니다.

토큰을 URL에 넣는 것이 안전한가요?

작동은 하지만, 해당 URL을 가진 사람은 누구나 귀하의 데이터를 읽을 수 있으므로 비공개로 유지하고, 짧은 만료 시간을 설정하며, 유출 시에는 반드시 토큰을 취소해야 합니다.

특정 잠재 고객이나 계정에 대한 가시성을 볼 수 있나요?

아니요. 데이터는 브랜드 수준이며 집계된(aggregate) 형태입니다.

여러분께 드리는 질문

만약 브랜드가 AI 답변에 얼마나 자주 나타나는지 추적한다면, 언급률이 의미를 가지기 위해 동일한 질문을 몇 번 반복 실행해야 하며, 그 숫자를 정하게 된 계기는 무엇인가요?