에이전트 검색(RAG)
에이전트를 위해 만든 검색 API — DeepSeek, Tencent Yuanbao, Tavily, Exa — 와 검색 증강에 필요한 도구들: 같은 호출로 받는 페이지 본문, prompt용 Markdown, 배치 쿼리, MCP. 카탈로그의 모든 엔진도 소스로 사용할 수 있습니다.
include_content: N을 추가하면 상위 N개 결과의 본문이 Markdown으로 같은 응답에 담겨 옵니다. 검색과 읽기를 한 번의 요청으로 — RAG의 핵심 단계입니다. 페이지당 3크레딧, 실패한 페이지는 무료입니다.
format: markdown은 결과와 페이지 본문을 포함한 전체 응답을 하나의 Markdown 문서로 반환하므로, JSON을 파싱하지 않고 바로 컨텍스트에 붙여넣을 수 있습니다.
POST /v1/batch는 요청당 최대 5개 검색을 실행합니다. 하나의 질문을 여러 소스에, 또는 여러 하위 질문을 한 번에. 각각 단일 검색과 동일하게 과금됩니다.
Batch API →공식 MCP 서버는 Claude Code, Cursor 등의 클라이언트에 search, batch, fetch, list_services를 제공합니다. HTTP를 직접 호출하는 에이전트에게는 SKILL.md가 언제 무엇을 쓸지 알려줍니다.
설치 →POST /v1/ai-search는 이 API들을 답변 중심 형식으로 조회합니다. 인용된 결과와 함께, 소스가 제공하는 경우(DeepSeek, Tavily) 짧은 합성 답변도 반환합니다. auto는 가장 저렴한 것부터 시도하고, 하나가 다운되면 다음으로 넘어갑니다.
API 레퍼런스 →이미 URL을 알고 있나요? POST /v1/fetch는 해당 페이지의 본문을 깔끔한 Markdown으로 반환합니다. 페이지당 5크레딧, 실패하면 무료입니다.
웹 페이지 수집 →소스 및 가격
성공한 실시간 호출당 크레딧이며, 실시간 카탈로그 기준입니다. 1,000크레딧 ≈ $1.
| 소스 | 결과 유형 | 크레딧 / 호출 | 상태 |
|---|---|---|---|
| DeepSeek Search | 웹 | 5 | 제공 중 |
| Tavily | 웹 | 48 | 제공 중 |
| Exa | 웹 | 21 | 제공 중 |
| Tencent Yuanbao Search | 웹 | 6 | 제공 중 |
예시: 검색과 읽기를 한 번에
curl https://api.serphubapi.com/v1/search \
-H "X-API-Key: shapi_..." \
-H "Content-Type: application/json" \
-d '{"q": "EU AI Act obligations for GPAI models",
"engine": "google", "include_content": 3,
"format": "markdown"}'하나의 Markdown 문서를 반환합니다. 검색 결과에 이어 상위 3개 페이지의 본문이 담깁니다. 검색 10크레딧 + 읽은 페이지당 3크레딧.
또는 MCP 서버를 연결하세요
{
"mcpServers": {
"serphubapi": {
"command": "uvx",
"args": ["serphubapi-mcp"],
"env": { "SERPHUBAPI_API_KEY": "shapi_xxxxxxxx" }
}
}
}키와 함께 MCP 클라이언트 설정에 붙여넣으세요. 에이전트는 search, batch, fetch, list_services를 사용할 수 있습니다.