Riggle

개발자·AI 에이전트 안내Riggle for developers and AI agents

AI 에이전트는 사람의 촬영 설명을 리글로 넘길 수 있습니다. 그 사람이 링크를 열면 메시지 창에 브리프가 들어가 있고, 직접 검토하고 보냅니다.An AI agent can hand a person's shoot to Riggle. They open a link, find the brief in Riggle's message box, review it and send it themselves.

에이전트가 할 수 있는 것What agents can do

리글은 에이전트에게 답변이나 데이터를 주지 않습니다. 에이전트가 할 수 있는 일은 브리프 시작 하나입니다. 아래 세 방법은 모두 같은 riggle.kr 링크를 만듭니다. 리글은 대신 보내거나 저장하지 않고, 인증도 필요 없습니다.Riggle gives agents no answers and no data. The one thing an agent can do is start a brief. The three methods below all produce the same riggle.kr link. Riggle never sends or stores anything on the person's behalf, and no authentication is needed.

언제 쓰나요: 한국에서 영상·사진 촬영을 준비하며 장비 리스트, 조명 셋업, 대략적인 대여 예산, 지역별 렌탈샵이 필요할 때.When to use it: someone is preparing a photo or video shoot in Korea and needs a gear list, a lighting setup, a rough rental budget or rental shops by region.
규칙: 이름·이메일·전화번호는 넣지 마세요(이메일과 전화번호가 있으면 거부됩니다). 브리프는 4,000자까지이며, 요청 본문으로만 보내고 URL 쿼리에는 넣지 마세요. 로그인·렌탈 요청·멤버십 결제는 그 사람이 직접 합니다.Rules: leave out names, emails and phone numbers (briefs with an email or phone number are refused). Briefs are limited to 4,000 characters; send them in the request body, never in a URL query string. Sign-in, rental requests and membership purchases stay with the person.

MCP 서버MCP server

제품 서버 https://riggle.kr/mcp(Streamable HTTP, 인증 없음)는 도구 start_riggle_brief 하나를 제공합니다. 이 도구에는 링크를 "리글에서 열기" 버튼으로 보여 주는 MCP Apps 카드(ui://riggle/brief-card)가 연결되어 있습니다. 문서 서버 https://riggle.kr/mcp/docs는 도구 read_riggle_docs와 안내 문서를 리소스로 제공합니다. 서버 카드: /mcp/server-card, /mcp/docs/server-card.The product server https://riggle.kr/mcp (Streamable HTTP, no authentication) has one tool, start_riggle_brief, with an MCP Apps card (ui://riggle/brief-card) that shows the link as an "Open in Riggle" button. The documentation server https://riggle.kr/mcp/docs offers the tool read_riggle_docs and the guides as resources. Server cards: /mcp/server-card, /mcp/docs/server-card.

{
  "mcpServers": {
    "riggle": { "type": "http", "url": "https://riggle.kr/mcp" },
    "riggle-docs": { "type": "http", "url": "https://riggle.kr/mcp/docs" }
  }
}

링크 APILink API

POST https://riggle.kr/api/v1/brief-link에 JSON으로 브리프를 보내면 url을 돌려줍니다. 인증은 필요 없고, 한 클라이언트당 분당 약 30회로 제한됩니다(최선 노력 방식). 전체 명세: openapi.json.Send the brief as JSON to POST https://riggle.kr/api/v1/brief-link and get back a url. No authentication; limited to about 30 requests a minute per client (best effort). Full description: openapi.json.

curl -X POST https://riggle.kr/api/v1/brief-link \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 7f1c2e9a-shoot-1' \
  -d '{"brief": "Two-day product video for a coffee brand in a Seoul studio, Sony FX3"}'

{
  "url": "https://riggle.kr/#brief=Two-day%20product%20video%20for%20a%20coffee%20brand%20in%20a%20Seoul%20studio%2C%20Sony%20FX3",
  "brief_characters": 68,
  "note": "Give this link to the person. ..."
}

오류는 항상 {"error": {"code", "message", "hint"}} 형식의 JSON입니다.Errors are always JSON shaped {"error": {"code", "message", "hint"}}.

code	HTTP	의미Meaning
`brief_missing`, `invalid_json`	400	본문에 brief 문자열이 없거나 JSON이 아님No brief string, or the body is not JSON
`method_not_allowed`	405	POST만 지원Only POST is supported
`payload_too_large`	413	본문이 16KB 초과Body over 16 KB
`brief_empty`, `brief_too_long`, `contact_details`	422	빈 브리프, 4,000자 초과, 이메일·전화번호 포함Empty, over 4,000 characters, or contains an email or phone number
`rate_limited`	429	Retry-After 초만큼 기다린 뒤 다시 시도Wait Retry-After seconds, then retry
`not_found`	404	`/api/v1` 아래 없는 경로No endpoint at that `/api/v1` path

요청 제한 헤더: 링크 API의 POST 응답에는 RateLimit-Policy·RateLimit(IETF 초안)과 RateLimit-Limit·RateLimit-Remaining·RateLimit-Reset이 붙고, 링크 API와 MCP 서버의 429에는 Retry-After가 붙습니다.Rate-limit headers: the link API's POST responses carry RateLimit-Policy and RateLimit (IETF draft) plus RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset; any 429 from the link API or an MCP server carries Retry-After.
멱등성: 선택 헤더 Idempotency-Key를 보낼 수 있습니다. 부수 효과가 없는 작업이라 같은 키와 본문으로 다시 보내면 같은 링크를 돌려주며, 성공한 JSON 응답은 키를 헤더로 되돌려 줍니다.Idempotency: send an optional Idempotency-Key header. The operation has no side effects, so a retry with the same key and body returns the same link; a successful JSON response echoes the key.
버전 정책: 경로로 버전을 나눕니다(/api/v1). v1 안의 변경은 선택 필드나 오류 코드 추가처럼 하위 호환되는 것만 합니다. 호환되지 않는 변경은 /api/v2로 내고, v1은 최소 90일 동안 Deprecation·Sunset 헤더와 함께 계속 동작하며 이 페이지에 미리 알립니다.Versioning: versioned in the path (/api/v1). Changes within v1 are additive only (new optional fields or error codes). A breaking change ships as /api/v2; v1 keeps working for at least 90 days with Deprecation and Sunset headers, announced on this page.
API 목록: /api/v1은 엔드포인트와 문서 위치를 JSON으로 알려 줍니다.API index: /api/v1 lists the endpoints and documentation as JSON.

링크 직접 만들기Building the link yourself

https://riggle.kr/#brief= 뒤에 URL 인코딩한 브리프를 붙이면 됩니다. # 뒤의 내용은 서버로 전송되지 않습니다.Append the URL-encoded brief to https://riggle.kr/#brief=. Everything after # stays in the browser and is never sent to a server.

https://riggle.kr/#brief=Wedding%20video%20in%20Seoul%2C%20one%20camera%2C%20two%20days

브라우저 에이전트(WebMCP)Browser agents (WebMCP)

WebMCP를 지원하는 브라우저에서는 riggle.kr 페이지가 start_riggle_brief 도구를 등록합니다. 홈페이지의 기본 HTML에도 같은 이름의 선언형 폼(toolname)이 있습니다. 둘 다 메시지 창을 채우기만 하고 보내지 않으며, 다른 초안이 이미 있으면 덮어쓰지 않습니다.In browsers that support WebMCP, riggle.kr registers a start_riggle_brief tool, and the homepage's raw HTML carries a declarative form with the same toolname. Both only fill the message box, never send, and never overwrite a different draft.

탐색 파일Discovery files

문의: contact@riggle.kr · 문의하기Questions: contact@riggle.kr · Contact