왜 열어 두나
측정을 파는 쪽이 자료를 열어 두지 않으면, 사는 쪽은 그 숫자를 믿는 수밖에 없습니다. 리포트 한 줄이 이상해도 확인할 자리가 없고, 사내 보고에서 질문 하나가 나오면 거기서 막힙니다.
그래서 저희는 발행물 색인과 공개 집계 데이터를 열쇠 없이 공개합니다. 같은 주소를 누구나 열어 같은 값을 받기 때문에, 저희 수치는 믿어 달라고 부탁드릴 대상이 아니라 그 자리에서 검산하실 수 있는 대상입니다. 고객 리포트와 측정 원자료는 이 레일에 들어오지 않습니다 — 그 경계는 신뢰 센터에 적어 두었습니다.
여기부터 시작하세요
입구는 하나입니다. /data를 열면 나머지 주소가 전부 그 안에 적혀 있어서, 이 페이지를 먼저 읽지 않아도 거기서부터 따라가실 수 있습니다. 브라우저 주소창에 붙여 넣어도 그대로 보입니다.
| 주소 | 무엇이 돌아오나 | 형식 |
|---|---|---|
| /data | 레일 입구. 아래 두 주소를 가리킵니다 | JSON |
| /data/index.json | 공개 발행물 색인 — 무엇을 언제 냈고 어느 주소에 있는지 | JSON |
| /data/openapi.json | 위 색인의 형식 설명 (OpenAPI 3.1) | JSON |
| /datasets/ai-visibility-aggregates.json | 공개 집계 — 사람이 읽는 공개 집계 지면도 있습니다 | JSON |
| /datasets/ai-answer-surface-aggregates.json | 화면별 집계 — 사람이 읽는 화면별 집계 지면도 있습니다 | JSON |
| /rsl.xml | 공개 발행물의 이용 조건 통지 | XML |
| /sitemap.xml | 공개 지면 목록과 최종 변경일 | XML |
| /insights/feed.xml | 한국어 인사이트 갱신 알림 | RSS |
영어·일본어 발행물 알림은 /en/research/feed.xml · /jp/research/feed.xml에 있습니다.
에이전트가 직접 부르는 창구
AI 에이전트가 사람 손을 거치지 않고 우리 자료를 물어볼 수 있는 창구도 열어 두었습니다.
MCP(Model Context Protocol)는 에이전트와 자료 제공자 사이의 공개 규약이고, 우리 창구
주소는 /mcp입니다.
부르는 법
POST 한 번이면 됩니다
JSON-RPC 2.0 메시지를 /mcp로 POST 하면 됩니다. 세션을 만들 필요가 없는
읽기 전용 창구라, 한 번의 요청이 한 번의 답으로 끝납니다.
쓸 수 있는 도구
다섯 가지
공개 클레임 조회, 발행물 색인 요약, 용어 정의 조회, 화면별 언급률 조회, 그리고 지면 하나를 넣으면 구조를 훑어 주는 점검 도구입니다.
이용 한도
키 없이 열려 있습니다
주소당 분당 30회까지 자유롭게 부르실 수 있고, 외부 지면을 실제로 가져오는 점검 도구만 분당 5회로 따로 둡니다.
색인에는 무엇이 들어 있나
/data/index.json은 우리가 공개한 것들의 목록입니다. 발행물마다 제목, 공개 주소, 최종 변경일, 그리고 그 글이 근거로 등록한 주장 식별자가 함께 들어 있습니다. 주장 식별자를 공개 클레임 레지스트리에서 찾으면 그 수치가 어떤 출처와 기준일로 등록됐는지 볼 수 있습니다.
이 레일에는 공개 지면에 이미 실린 것만 담습니다. 고객 리포트의 내용과 측정 원자료는 계약 당사자에게만 갑니다 — 그 경계는 신뢰 센터에 적혀 있습니다.
가져다 쓰실 때
공개 발행물은 출처를 밝히면 무료로 인용하실 수 있습니다. 조건을 사람 말로 적으면 「어디서 가져왔는지 밝혀 주세요」 한 줄이고, 같은 내용을 기계가 읽도록 적은 것이 /rsl.xml입니다. 국제 표준 라이선스(CC BY 4.0)를 그대로 참조합니다.
다시 쓰실 때 필요한 표기는 회사 이름과 그 페이지 주소입니다. 수치를 인용하실 때는 같은 페이지에 적힌 측정 조건, 그러니까 질의 수와 측정한 화면, 반복 횟수와 측정일까지 함께 옮겨 주시면 읽는 분이 그 수치가 덮는 범위를 저희와 같은 크기로 보게 됩니다.
바뀌면 어떻게 알리나
주소는 그대로 두고 내용만 갱신하는 것을 원칙으로 합니다. 지면이 실제로 바뀌면 /sitemap.xml의 최종 변경일이 함께 올라가고, 발행물 알림은 위 RSS로 나갑니다. 형식이 바뀌는 변경은 /data/openapi.json에 먼저 반영합니다.
필요한 형식이 여기 없으면 알려 주세요. 어떤 도구에 어떻게 붙이려는지 적어 주시면 그에 맞춰 회신합니다.
문의 남기기