# 19 REST API (개발자·시스템 연동용) — GEOcare 사용자 매뉴얼

>  19 REST API (개발자·시스템 연동용) 19 REST API (개발자·시스템 연동용) 표준 HTTP로 GEOcare를 외부 시스템·자체 서비스에 연동 개발자·연동 · 경로 /v3/rest api 📌 목적: REST API는 MCP와 똑같은 기능 을 표준 HTTP(GET/POS

## 핵심 요약


# 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단계)

1. **API 키 발급** — 계정 메뉴 → 'REST API'(/v3/rest-api)에서 발급. MCP 키와 공용(계정 단위).
2. **Base URL · 인증 설정** — Authorization 헤더에 Bearer 토큰을 담아(또는 쿼리 파라미터 key) Base URL을 호출.
3. **호출 또는 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):

```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' 화면에서 즉시 폐기. 키 = 계정 자격증명


## FAQ


---
출처: https://bizspring.ai/kb/ref/manual/geocare-사용자-매뉴얼-19-rest-api-개발자-시스템-연동용 · 최종 갱신 2026-08-23T14:32:40.831494+00:00