Cloudflare Web Search API 공개, AI 에이전트용 웹 검색 가격과 쓰는 법

올린이 geul날짜 2026.10.06 10:37조회 0

Cloudflare가 2026년 10월 2일, AI 에이전트와 앱이 웹을 검색할 수 있는 Web Search API를 오픈 베타로 내놓음
검색 엔진은 Ceramic.ai, Exa, Linkup 가운데 고르고, 어느 곳을 골라도 결과 형식은 같음
1,000건 요금은 Ceramic 0.25달러, Linkup 5달러, Exa 7달러이고 AI Gateway 크레딧에서 빠짐
REST API나 Workers의 AI 바인딩으로 부를 수 있음
Hacker News에서 478점을 받았고, 가격 차이와 검색 품질, 결과 저장 제한을 두고 이야기가 오감

Web Search API는 무엇인가

에이전트가 검색어를 보내면 제목, URL, 설명이 담긴 결과 목록을 돌려줌
모델이 학습 뒤에 나온 소식을 모르거나 주소를 짐작해 여는 일을 실제 검색 결과로 막으려는 기능
AI Gateway를 거쳐 돌아감
- AI Gateway는 여러 AI 모델 호출을 한곳에서 기록하고 결제하는 Cloudflare 서비스
- 모델 호출과 같은 로그, 분석, 결제, 접근 제어가 검색에도 그대로 적용됨
세 제공사 모두 Cloudflare의 검증된 봇(verified bot) 크롤링 기준을 지키기로 함

검색 제공사별 가격 비교

제공사	1,000건 가격	특징	요청 데이터 보관 안 함(ZDR)
Ceramic.ai (기본값)	0.25달러	400억 쪽이 넘는 자체 색인, 결과 설명이 최대 8,000자	지원
Linkup	5달러	빠른 검색 모드로 AI 답변 없이 결과만 돌려줌	지원
Exa	7달러	키워드 검색과 임베딩 검색을 섞은 자체 엔진, 질문과 맞닿은 부분을 발췌해 줌	미지원

가장 싼 Ceramic과 가장 비싼 Exa는 28배 차이
크레딧은 Cloudflare 대시보드의 AI Gateway 화면에서 충전함
- 충전할 때 5% 수수료가 붙음 (100달러 충전하면 105달러 결제)
제공사 API 키가 이미 있으면 BYOK(자기 키 쓰기)로 연결할 수 있음
ZDR 표기는 문서마다 다름. 위 표는 제공사 문서를 따름
- 출시 공지에는 Cloudflare를 거친 요청이면 세 곳 모두 지원한다고 적음
- 제공사 문서 표에는 Exa가 "No"로 나옴

쓰는 법

REST API
- 주소는 POST https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/websearch/
- API 토큰에 Workers AI 읽기, AI Gateway 읽기 권한이 필요함

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/websearch/ \
  --request POST \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "query": "Cloudflare Workers 요금",
    "provider": "ceramic",
    "limit": 5,
    "options": { "gateway": { "id": "default" } }
  }'

Workers
- wrangler 설정에 AI 바인딩([ai] binding = "AI")을 넣고 env.AI.websearch()를 부름

const response = await env.AI.websearch({
  gatewayId: "default",
  query: "Cloudflare Workers 요금",
  provider: "exa",
  limit: 5,
});
const results = await response.json();

요청 값
- query: 검색어, 최대 1,024자
- provider: ceramic, exa, linkup 중 하나. 빼면 ceramic
- limit: 결과 수 1~10개, 기본 10개
- byokAlias: 게이트웨이에 저장해 둔 제공사 키 이름
응답은 items 배열과 metadata로 옴
- items에는 결과마다 url, title, description
- metadata에는 검색어, 요청 ID, 걸린 시간(ms)

Hacker News 반응

478점, 댓글 221개 (10월 6일 확인)
가격
- 제공사 사이 28배 차이에 놀라는 반응이 많음
- Serper(1,000건 1달러) 같은 다른 검색 API와 견주는 댓글이 이어짐
이용 약관
- Ceramic 약관이 검색 결과를 저장하거나 모으는 것을 막는다는 지적이 나옴
- 캐시를 어디까지 해도 되는지 문구가 애매하다는 의견도 있음
검색 품질
- Ceramic으로 찾았더니 Google과 DuckDuckGo에서 나오는 결과가 하나도 안 나왔다는 후기가 있음
Cloudflare를 향한 비판
- 한쪽에서는 봇 차단을 팔면서, 다른 쪽에서는 검증된 봇이 긁어 온 결과를 판다는 지적
대안으로 Brave Search API, Kagi API, 직접 띄우는 SearXNG와 Firecrawl이 거론됨

아직 모르는 것

베타 기간의 무료 사용량과 호출 횟수 제한은 공개 문서에 없음
한국어 검색 품질에 대한 언급도 없음. 한국어 서비스에 쓰려면 제공사별로 직접 시험해 봐야 함

Web Search API는 무엇인가

검색 제공사별 가격 비교

쓰는 법

Hacker News 반응

아직 모르는 것

댓글