# 마켓파일럿 API (api.marketpilot.it)

> 자영업자·소상공인 마케팅 실행 플랫폼의 AI 에이전트용 API.
> 서비스·상품 조회부터 회원가입·견적·주문·주문내역·포인트 충전·문의 접수까지 수행할 수 있어요.
> 사이트 전체 안내는 https://www.marketpilot.it/llms.txt , 사람이 읽는 개발자 문서는 https://www.marketpilot.it/developers

## 먼저 읽을 것

- [API 인덱스](https://api.marketpilot.it/v1/ai): 어떤 엔드포인트가 있는지 한눈에 (JSON)
- [주문 API 문서](https://api.marketpilot.it/v1/ai/docs): 인증·가입·주문 2단계·포인트 충전·문의 전환까지 전체 플로우 (마크다운)
- [OpenAPI 스펙](https://api.marketpilot.it/v1/ai/openapi.json): GPTs Actions·자체 에이전트 연결용
- [MCP 서버 명세](https://api.marketpilot.it/.well-known/mcp.json): Streamable HTTP, Bearer mk_ 키

## 인증 없이 바로 쓸 수 있는 것

- [서비스·상품 카탈로그](https://api.marketpilot.it/v1/public/ai-catalog): 서비스별 적합 고객·기대 효과·태그 + 상품 단가·최소주문 ([마크다운](https://api.marketpilot.it/v1/public/ai-catalog.md))
- [공개 문의 폼 목록](https://api.marketpilot.it/v1/public/ai-forms): 어디에 무엇을 보내면 되는지 ([마크다운](https://api.marketpilot.it/v1/public/ai-forms.md))
- 회원가입: `POST https://api.marketpilot.it/v1/public/ai-signup/send-code` → `POST https://api.marketpilot.it/v1/public/ai-signup`
- 상담·견적 문의: `POST https://api.marketpilot.it/v1/public/ai-inquiry`

## API 키가 필요한 것

`Authorization: Bearer mk_...` — 키는 가입 응답으로 받거나 https://www.marketpilot.it/developer/api-keys 에서 발급해요.

- 상품 조회 `GET /v1/ai/products`
- 견적 `POST /v1/ai/orders/quote` → 주문 확정 `POST /v1/ai/orders` (사용자 확인 후 confirm:true)
- 주문내역 `GET /v1/ai/orders`, 진행상황 `GET /v1/ai/orders/{id}`
- 포인트 `GET /v1/ai/point/balance`, 충전 신청 `POST /v1/ai/point/charge-requests`

## 주의

- 주문은 견적 → 사용자 확인 → 확정 2단계예요. 사람의 승인 없이 확정하지 마세요.
- 이름·이메일·약관 동의는 사용자에게 직접 확인받고 넣으세요. 임의로 지어내면 안 돼요.