홈 > 문서

Fusepie 문서

하나의 API로 409개 API를 호출하세요.
인텐트 한 줄이면 충분합니다.

30초 시작

API 키 발급, 문서 읽기, CORS 설정 없이 — 인텐트 한 줄로 시작하세요.

1

인텐트 입력

필요한 데이터를 자연어로 설명하세요.

?intent=서울 내일 날씨

2

Fusepie 자동 매칭

임베딩 기반 벡터 검색으로 409개 중 최적 API를 선택합니다.

text-embedding-3-small → 코사인 유사도 top-k

3

표준 JSON 응답

인증, 호출, 파싱 전부 대신 처리. OpenAPI 3.1 표준 JSON을 반환합니다.

{ "source": "...", "data": { ... } }

빠른 시작

curl
curl "https://api.fusepie.com/resolve?intent=서울 내일 날씨"
# 응답
{
"source": "기상청 단기예보 API",
"latency": "124ms",
"data": {
"city": "Seoul",
"temp": 12,
"condition": "맑음",
"humidity": 65
}
}

자연어 → 최적 API 자동 매칭

인텐트를 입력하면 Fusepie가 가장 적합한 API를 자동으로 찾아 호출합니다.

작동 방식

1입력한 인텐트를 text-embedding-3-small로 벡터화
2409개 API 임베딩과 코사인 유사도 계산 (top-k=3)
3가장 적합한 API 선택 + 인증 자동 처리
4응답을 OpenAPI 3.1 표준 JSON으로 정규화

인텐트 예시

인텐트선택되는 API카테고리
서울 날씨기상청 단기예보날씨
비트코인 가격업비트 API금융
강남 맛집 찾기카카오 로컬지도
DART 삼성전자 공시금융감독원 DART금융
인천공항 항공편항공정보 API교통

직접 API 지정도 가능: /resolve?intent=날씨&api=kma-forecast — 특정 API를 강제 지정해서 호출할 수 있습니다.

브라우저에서 바로 테스트

Fusepie의 Playground에서 API 키 없이 바로 테스트할 수 있어요. 각 API 상세 페이지 → Playground 탭에서 실제 요청/응답을 확인하세요.

Playground 사용법

1API 디렉토리에서 원하는 API를 클릭
2상세 페이지에서 "Playground" 탭 클릭
3파라미터 입력 후 "실행" 버튼
4실제 API 응답 확인 (서버사이드 프록시로 CORS 자동 해결)

AI 에이전트와 즉시 연동

Fusepie MCP 서버를 한 번 설정하면, Claude/GPT/Cursor 등 AI 도구에서 409개 API를 자연어로 사용할 수 있어요.

Claude DesktopCursorWindsurfLangChainCrewAI

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json

json
{
"mcpServers": {
"fusepie": {
"command": "npx",
"args": ["-y", "@fusepie/mcp"],
"env": {
"FUSEPIE_API_KEY": "your_fusepie_key"
}
}
}
}

MCP 도구 3가지

search_apis(query)자연어로 관련 API 검색
get_api_spec(id)특정 API의 OpenAPI 3.1 스펙 반환
list_categories()카테고리 목록 반환

💡 사용 예시: Claude에게 “서울 날씨를 기상청 API로 조회해줘” → Fusepie MCP가 자동으로 올바른 API 선택 + 호출 + 응답 정리

모든 API에 OpenAPI 3.1 스펙 자동 제공

모든 API에 대해 OpenAPI 3.1 스펙을 자동으로 생성합니다. AI 에이전트, SDK 자동 생성, API 클라이언트 도구와 바로 연동 가능해요.

엔드포인트: GET /api/{api-id}/openapi

예시: GET /api/kma-forecast/openapi

json
{
"openapi": "3.1.0",
"info": {
"title": "기상청 단기예보 API",
"version": "1.0"
},
"paths": {
"/getVilageFcst": {
"get": {
"summary": "동네 예보 조회",
"parameters": [
{ "name": "base_date", "in": "query", "required": true },
{ "name": "nx", "in": "query", "required": true },
{ "name": "ny", "in": "query", "required": true }
]
}
}
}
}

API 상세 페이지에서 “OpenAPI Spec” 버튼으로도 접근할 수 있습니다.

API 접근 방식 3단계

Fusepie는 각 API의 인증 요구 사항에 따라 세 단계로 분류합니다.

L0

무인증

Fusepie가 직접 호출합니다. 사용자 키가 불필요합니다. 가장 간편한 레벨로, 빠른 프로토타이핑과 테스트에 적합합니다.

L1

무료

본인의 API 키를 사용합니다. Fusepie가 헤더/파라미터에 자동으로 주입해 줍니다. 포털에서 무료로 발급받을 수 있습니다.

L2

유료

본인의 유료 API 키를 사용합니다. 결제 플랜이 필요한 전문 데이터 API들이 해당됩니다.

자주 묻는 질문

추가 리소스