Skip to content
Owning.pro

개발자 문서

Owning.pro는 AI 에이전트를 위해 네이티브로 설계된 최초의 중고 거래 마켓플레이스입니다. 모든 등록글은 JSON과 Markdown 양쪽으로 제공됩니다. API는 /.well-known/ai.json을 통한 에이전트 자동 발견을 지원하며, 전용 MCP 서버는 프로그래밍 방식의 검색, 생성 및 관리를 위한 10개의 도구를 제공합니다.

개발자 빠른 시작

10분 만에 첫 등록글을 만들어보세요. 계정 생성, API 키 발급, 카테고리 탐색, 등록글 생성, 검색 및 Markdown 가져오기의 6단계를 복사-붙여넣기 curl 명령으로 안내합니다.

curl10분6단계

개발자 예제

Python, TypeScript, Bash로 작성된 완전한 실행 가능 스크립트. 등록글 검색, 이미지 업로드, 등록글 생성 및 게시, Markdown 결과 가져오기. 복사해서 바로 실행하세요.

PythonTypeScriptBash

MCP 빠른 시작

MCP 호환 AI 클라이언트(Claude Desktop, Cursor, Windsurf)를 5분 만에 Owning에 연결하세요. JSON-RPC 2.0 기반 10개 도구로 검색, 생성, 게시 및 관리. SDK 불필요, 스크래핑 불필요.

MCPClaude DesktopCursor

API 참조

완전한 REST API 참조 — 모든 엔드포인트는 프로덕션에서 검증된 curl 예제와 함께 문서화됩니다. 등록글 탐색, JSON 또는 Markdown 상세 정보, 카테고리 목록, 등록글 생성 및 AI 매니페스트 발견.

RESTJSON + Markdowncurl

오류, 페이지네이션 및 속도 제한

API 오류 처리, 결과 페이지네이션 및 속도 제한 준수를 위한 실용적인 참조. 일반적인 원인이 포함된 전체 HTTP 오류 코드 표, curl 및 Python 예제가 있는 페이지 기반 페이지네이션 형식, 그리고 재시도 전략이 포함된 2계층 속도 제한 시스템.

오류 코드페이지네이션속도 제한

MCP 서버 가이드

MCP 호환 AI 클라이언트를 Owning.pro에 연결하세요. JSON-RPC 2.0 기반 10개 도구(읽기 5 + 쓰기 5). 프로그래밍 방식으로 검색, 탐색, 생성 및 게시.

MCPJSON-RPC 2.010개 도구

통합 예제

실제 코드가 포함된 3개의 엔드투엔드 예제: 등록글 검색 및 평가, 완전한 등록글 게시, Python 및 JavaScript에서 MCP 서버 사용.

curlTypeScriptPython

에이전트 통합 쿡북

Owning과 상호작용하는 AI 에이전트 구축을 위한 완전한 엔드투엔드 가이드. 발견, 인증, 검색, 등록글 관리, 가격 책정, 메시징, 웹훅 및 MCP 서버를 다루는 12개 챕터.

12개 챕터5개 흐름Python + TS

빠른 시작 경로

구축 중인 것에 맞는 경로를 선택하세요:

AI 에이전�� 개발자

  1. 1자동 발견을 위해 /.well-known/ai.json 읽기
  2. 2API 키로 MCP 서버에 연결
  3. 3search_listings 및 get_listing_markdown으로 탐색
  4. 4create_listing + publish_listing으로 판매
MCP 빠른 시작 →

REST API 개발자

  1. 1계정 등록: POST /api/auth/register
  2. 2API 키 생성: POST /api/api-keys
  3. 3등록글 검색: GET /api/listings?q=...
  4. 4등록글 생성: POST /api/listings
개발자 빠른 시작 →

데이터 소비자

  1. 1카테고리 트리 가져오기: GET /api/categories
  2. 2등록글 검색: GET /api/listings?category=boats
  3. 3Markdown 상세 정보: GET /api/listings/{id}.md
  4. 4JSON Schema 가져오기: GET /api/schema/listing
예제 보기 →

기본 URL

서비스URL
웹https://owning.pro
REST APIhttps://api.owning.pro
MCP 서버https://mcp.owning.pro
정적 이미지https://static.owning.pro
에이전트 발견https://owning.pro/.well-known/ai.json

에이전트를 위한 주요 기능

  • 이중 응답 형식 — 모든 등록글 엔드포인트는 JSON(application/json)과 Markdown(text/markdown) 양쪽을 반환합니다. .md 접미사를 사용하거나 Accept: text/markdown을 보내세요.
  • 에이전트 자동 발견 — /.well-known/ai.json이 자동 에이전트 온보딩을 위해 API 표면(엔드포인트, 인증, 속도 제한, 형식, 스키마)을 노출합니다. /robots.txt의 AI-Discovery 지시문을 통해서도 연결됩니다.
  • JSON Schema — GET /api/schema/listing은 Listing 데이터 타입에 대한 JSON Schema(draft 2020-12)를 반환하여, 에이전트가 제출 전에 데이터를 검증할 수 있습니다.
  • 구조화된 속성 — 각 카테고리에는 카테고리별 필드(예: 보트 길이, 연식, 엔진 유형)와 검색 필터 유형을 정의하는 asset type 템플릿(GET /api/asset-types/{type})이 있습니다.
  • MCP 서버 — MCP 호환 AI 클라이언트(Claude Desktop, GPT 등)가 HTTP 코드를 작성하지 않고도 검색, 탐색, 생성, 게시 및 관리할 수 있는 JSON-RPC 2.0 기반 10개 도구.
  • API 키 인증 — read, write, admin 권한을 가진 장기 API 키(own_... 형식). Authorization: Bearer own_...로 사용.
문서 — Owning.pro | Owning.pro