19 REST API (개발자·시스템 연동용) — GEOcare 사용자 매뉴얼
핵심 요약
- REST API는 MCP와 동일한 기능을 표준 HTTP(GET/POST)로 제공하여 개발자와 시스템 연동에 활용된다.
- bmp.ai 등 외부 시스템 연동, 자체 서비스 확장, ChatGPT/Make/Zapier 등 노코드 자동화에 사용할 수 있다.
- 계정 메뉴 'REST API'(/v3/rest-api)에서 API 키를 발급받고 Bearer 토큰으로 Base URL을 호출하는 3단계로 연동한다.
- GET /api, GET/POST /api/call, GET /openapi.json 등의 엔드포인트와 약 41종의 MCP와 동일한 도구를 제공한다.
- 호출 시 계정 단위로 site_domain을 지정해야 하며, 실행형 도구는 confirm 인자가 필요하고 키 노출 시 즉시 폐기해야 한다.
# 19 REST API (개발자·시스템 연동용)
19 REST API (개발자·시스템 연동용)
_표준 HTTP로 GEOcare를 외부 시스템·자체 서비스에 연동_
개발자·연동 · 경로 /v3/rest-api
> 📌 목적: REST API는 MCP와 똑같은 기능을 표준 HTTP(GET/POST)로 제공합니다. AI에서도 쓸 수 있지만, 주로 다른 시스템과의 연동(예: bmp.ai)·자체 GEO 데이터 기반 서비스 확장을 하려는 개발자를 위한 것입니다.
MCP vs REST API — 무엇을 쓸까
| 구분 | MCP | REST API |
|---|---|---|
| 주 사용자 | Claude 등 AI/LLM 에이전트 | 개발자 · 연동 시스템(bmp.ai 등) |
| 방식 | JSON-RPC · 자동 도구 인식(tools/list) | 표준 HTTP · OpenAPI 자동 인식 |
| 연결 | AI 클라이언트 커넥터에 등록 | 코드/도구에서 endpoint 호출 |
| 인증 | 계정 토큰(공용) | 계정 토큰(공용 — 같은 키) |
| 대표 용도 | 대화로 조회·실행 | 시스템 확장·자동화·자체 데이터 활용 |
누구를 위한 것인가
- ✅ 연동 시스템 개발자 — bmp.ai 등 사내·외부 시스템이 서버-투-서버로 GEO 데이터를 가져가거나 분석을 트리거
- ✅ 자체 서비스 확장 — 자사 대시보드·리포트·자동화 파이프라인에 GEOcare 데이터/실행 임베드
- ✅ 노코드 자동화 — ChatGPT Custom GPT(Actions) · Make · Zapier에 OpenAPI를 import해 바로 호출
연동 방법 (3단계)
- API 키 발급 — 계정 메뉴 → 'REST API'(/v3/rest-api)에서 발급. MCP 키와 공용(계정 단위).
- Base URL · 인증 설정 — Authorization 헤더에 Bearer 토큰을 담아(또는 쿼리 파라미터 key) Base URL을 호출.
- 호출 또는 OpenAPI import — 직접 HTTP 호출하거나, openapi.json을 ChatGPT Actions · Make · Zapier · Postman에 import해 자동 호출.
엔드포인트
| 메서드 · 경로 | 용도 |
|---|---|
GET /api | 도구 카탈로그(공개) — 사용 가능한 도구 목록 |
GET/POST /api/call | 디스패치형 호출 — {tool, arguments} |
GET/POST /api/call/{tool} | 도구별 경로 — OpenAPI operation 1:1 (arguments = 본문/쿼리) |
GET /openapi.json | OpenAPI 3.1 명세(공개) — 외부 도구 자동 import용 |
GET /docs | API 문서(Redoc) — 사람용 매뉴얼 |
Base URL: https://nntuztaehnywdbttrajy.supabase.co/functions/v1/geocare-user-mcp/api
호출 예제
① 내 사이트 목록 (가장 먼저)
- 메서드: GET
- 경로:
{Base URL}/call/list_my_sites - 헤더:
Authorization에 Bearer 형식으로 API 키 전달
② SoM 요약 조회 (site\_domain 지정)
- 메서드: POST
- 경로:
{Base URL}/call/get_som_summary - 헤더:
Authorization(Bearer 형식 API 키),Content-Type: application/json - 본문(JSON):
{ "site_domain": "example.com" }표준 자동 연동 (OpenAPI)
openapi.json을 import하면 엔드포인트·파라미터가 자동 인식됩니다 — ChatGPT Custom GPT(Actions) · Make · Zapier · Postman · bmp.ai. (= MCP가 AI에게 도구를 자동 인식시키는 것의 REST 표준판)
제공 기능(도구)
MCP와 동일한 도구 세트(약 41종)를 제공합니다 — 전체 목록은 \[18 MCP 연결] 페이지의 도구 카탈로그 참조. 라이브 최신 목록은 GET /openapi.json.
사용 규칙
- 계정 단위 — 호출마다
site_domain지정 (먼저list_my_sites) - 실행형(action)은
"confirm": true인자 필요 - 키 노출 시 'REST API' 화면에서 즉시 폐기. 키 = 계정 자격증명
자주 묻는 질문
REST API와 MCP는 어떤 차이가 있나요?
둘 다 동일한 기능을 제공하지만 MCP는 Claude 등 AI/LLM 에이전트가 JSON-RPC 방식으로 자동 인식해 사용하고, REST API는 개발자나 bmp.ai 같은 연동 시스템이 표준 HTTP로 endpoint를 호출하는 방식입니다. 인증은 계정 토큰을 공용으로 사용합니다.
REST API 키는 어디서 발급받나요?
계정 메뉴의 'REST API'(/v3/rest-api) 화면에서 발급받을 수 있습니다. 이 키는 MCP 키와 계정 단위로 공용으로 사용됩니다.
가장 먼저 호출해야 하는 API는 무엇인가요?
GET 방식의 {Base URL}/call/list_my_sites를 가장 먼저 호출해 내 사이트 목록을 확인해야 합니다. 이후 호출부터는 site_domain을 지정해서 사용합니다.
ChatGPT나 Make, Zapier에도 연동할 수 있나요?
네, openapi.json을 import하면 엔드포인트와 파라미터가 자동 인식되어 ChatGPT Custom GPT(Actions), Make, Zapier, Postman, bmp.ai 등에 바로 연동할 수 있습니다.
API 키가 노출되면 어떻게 하나요?
키는 계정 자격증명과 동일하므로 노출 시 'REST API' 화면에서 즉시 폐기해야 합니다.