Developers

리옵트 애즈 개발자 리소스

리옵트 애즈(reopt ads)는 사람이 보는 화면과 같은 내용을 기계가 읽을 수 있는 형태로도 제공합니다. 매체 인벤토리와 운영 가이드는 인증 없이 읽을 수 있고, 광고 데이터를 바꾸는 작업은 승인 절차를 거치는 제품 화면에서만 이뤄집니다.

한눈에 보기

OpenAPI 3.1: /openapi.json (별칭 /api/openapi.json)
MCP 서버: /api/mcp · 매니페스트 /.well-known/mcp.json
마크다운 협상: 모든 페이지 URL + Accept: text/markdown
사이트 안내: /llms.txt · /llms-full.txt
검색 API: /api/search
URL 목록: /sitemap.xml
RSS 피드: /inventory/rss.xml · /tools/rss.xml

마크다운 콘텐츠 협상

공개 페이지는 모두 Accept: text/markdown으로 요청하면 같은 주소에서 마크다운 본문을 돌려줍니다. 응답에는 Vary: Accept, Accept-Encoding과 대응하는 HTML을 가리키는 Link: rel="canonical"이 붙습니다. q-value를 존중하므로 text/markdown;q=0.2, text/html;q=0.9처럼 HTML을 더 원하면 HTML을 받습니다. 없는 경로는 마크다운으로도 404이며, 본문에 사이트맵과 llms.txt 링크가 들어갑니다.

curl -H 'Accept: text/markdown' https://ads.reopt.ai/inventory/youtube-shorts
curl https://ads.reopt.ai/api/agent/markdown/guide/approval

협상 헤더를 보낼 수 없는 클라이언트는 /api/agent/markdown/{경로}를 직접 호출하세요. HTML 페이지 응답의 Vary는 Next.js가 직접 확정하므로 Accept가 포함되지 않습니다. 마크다운 협상 응답에는 포함됩니다.

MCP 서버

Model Context Protocol 2025-06-18 Streamable HTTP 서버를 /api/mcp에서 제공합니다. 인증이 없고 상태를 두지 않는 읽기 전용 서버라 세션 ID를 발급하지 않으며, 요청 하나에 JSON 응답 하나로 끝납니다. 서버가 먼저 말을 거는 SSE 스트림은 열지 않습니다.

search_inventory — 광고 가능한 매체를 키워드, 매체 유형, 캠페인 목표, 카테고리로 검색합니다. 각 결과에는 집행 조건과 상세 페이지 URL이 포함됩니다.
get_inventory_item — 매체 ID로 집행 조건, 지면, 측정 지표, 출처를 포함한 상세 정보를 마크다운으로 반환합니다.
list_guides — 광고 요청, 승인 절차, 지면 설계, 정산, 정책 문서의 목록과 설명을 반환합니다.
get_guide — 가이드 문서의 전체 본문을 마크다운으로 반환합니다.

curl -X POST https://ads.reopt.ai/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

권한 모델

이 도메인의 공개 엔드포인트는 모두 인증이 필요 없는 읽기 전용입니다. 캠페인 생성, 예산 변경, 소재 등록처럼 광고 데이터를 바꾸는 공개 API는 제공하지 않습니다. 승인형 마켓플레이스에서 집행 조건은 파트너 승인을 거쳐 확정되므로, 쓰기 작업은 로그인한 대시보드의 승인 흐름에서만 이뤄집니다.

대시보드 로그인은 리옵트 플랫폼(Brandapp) OAuth 2.0 authorization code 흐름을 사용합니다. 리옵트 애즈가 요청하는 스코프는 openid profile email 세 개뿐이며, 광고 데이터 쓰기 스코프는 요청하지 않습니다. 인가 서버가 지원하는 전체 스코프는 다음과 같고, 에이전트는 필요한 최소 범위만 요청해야 합니다.

openid: OpenID Connect 기본 인증
profile: 사용자 프로필 정보 읽기
email: 사용자 이메일 정보 읽기
brandapp:read: Brandapp 리소스 읽기
brandapp:write: Brandapp 리소스 쓰기
eav:read: EAV 엔티티·레코드 읽기
eav:write: EAV 엔티티·레코드 쓰기
workflow:execute: 워크플로우 실행

기계 판독용 정의는 OpenAPI 문서의 components.securitySchemes.brandappOAuth2에 있습니다.

에이전트가 지켜야 할 것

도달 수와 단가는 출처에서 확인된 값만 담겨 있습니다. 비어 있는 값을 추정해 채우지 말고 “공개 정보 없음”, “경매 또는 공식 문의” 그대로 전하세요.
매체 항목의 출처 블록에는 매체사 공식 자료 URL과 확인일이 들어 있습니다. 조건을 인용할 때 함께 제시하세요.
승인 성향(적극 수용, 조건 수용, 문의 요망)은 집행 가능성의 힌트일 뿐 승인 보장이 아닙니다.
파트너 승인과 사용자 동의는 다릅니다. 개인정보·개인화·알림성 노출은 별도의 사용자 동의가 필요합니다.

문의

연동 방식(SDK, 태그, API)은 서비스 구조와 지면 유형에 따라 달라집니다. 사용 중인 스택과 노출하려는 지면 유형을 적어 contact@reopt.ai로 보내거나 문의하기를 이용하세요. 리옵트 플랫폼 전체의 API·MCP 문서는 reopt.ai/docs에 있습니다.

리옵트 애즈

관심0 대시보드로 이동이동