エージェント検索（RAG）
エージェント向けに設計された検索API（DeepSeek、Tencent Yuanbao、Tavily、Exa）と、その周辺で検索拡張に必要なツール：同じ呼び出しでのページ本文取得、プロンプト用のMarkdown、バッチクエリ、MCP。カタログ内のすべてのエンジンもソースとして使えます。
include_content: N を追加すると、上位N件の結果が本文のMarkdown付きで同じレスポンスに返ります。検索と読み取りが1回の往復で完了します。これがRAGの中核となるステップです。1ページあたり3クレジット、取得に失敗したページは無料です。
format: markdown を指定すると、レスポンス全体（結果とページ本文）が1つのMarkdownドキュメントとして返るため、JSONを解析せずにそのままコンテキストに貼り付けられます。
POST /v1/batch はリクエストあたり最大5件の検索を実行します。1つの質問を複数のソースで、または複数のサブ質問を一度に。各検索は単一の検索と同様に課金されます。
バッチ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で返します。1ページ5クレジット、失敗時は無料です。
Webページ取得 →ソースと料金
成功したリアルタイム呼び出し1回あたりのクレジット（ライブカタログより）。1,000クレジット ≈ $1。
| ソース | 結果タイプ | クレジット / 回 | ステータス |
|---|---|---|---|
| DeepSeek Search | Web | 5 | 提供中 |
| Tavily | Web | 48 | 提供中 |
| Exa | Web | 21 | 提供中 |
| Tencent Yuanbao Search | Web | 6 | 提供中 |
例：検索と読み取りを1回の呼び出しで
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"}'1つのMarkdownドキュメントを返します：検索結果に続いて、上位3ページの本文。検索に10クレジット＋読み取ったページごとに3クレジット。
またはMCPサーバーを接続
{
"mcpServers": {
"serphubapi": {
"command": "uvx",
"args": ["serphubapi-mcp"],
"env": { "SERPHUBAPI_API_KEY": "shapi_xxxxxxxx" }
}
}
}APIキーを入れて、MCPクライアントの設定に貼り付けます。エージェントは search、batch、fetch、list_services を使えるようになります。