AIアシスタントがウェブ検索APIのベンチマークを照会し、You.com、Tavily、Exa、Parallelなどのプロバイダー間でライブ検索のスポットチェックを実行できるようにします。
別名 psinglap/websearch-api-eval, websearch-api-eval, websearch-api-eval-mcp
- スター
- 4
- ツール
- 9
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.1.0
- 最終コミット
- 2026年10月27日
- ライセンス
- MIT
Web Search API Eval MCPとは
Web Search API EvalはMCPサーバーです。 AIアシスタントがウェブ検索APIのベンチマークを照会し、You.com、Tavily、Exa、Parallelなどのプロバイダー間でライブ検索のスポットチェックを実行できるようにします。. 9個のツールを提供しており、get_overall_results, get_scorecard, compare_providersなどがあります。
プロジェクトのREADMEから生成された概要
Web Search API Eval MCP server について
このMCP serverは、AIアシスタントを利用する開発者が、ウェブ検索APIのパフォーマンス比較やライブでのスポットチェックを行うことを可能にします。30個のエージェントクエリを通じて、You.com、Tavily、Exa、Parallelを評価した特定のベンチマークへのアクセスを提供します。ユーザーは公開されたデータを照会して、金融や保険などの特定のユースケースにどのプロバイダーが最適かを確認できます。
このサーバーは、ChatGPTやClaudeなどのリモートクライアント向けにURL経由のホスト型サービスとして利用できるほか、Cursor、VS Code、Claude Desktopなどのデスクトップ環境向けにnpmを使用してローカルにインストールすることも可能です。ベンチマークツールは読み取り専用ですが、ローカルインストールではrun_live_searchツールによるライブテストが可能です。この機能を利用してリアルタイムのレイテンシや結果を比較するには、設定ファイルにYDC、Tavily、Exa、またはParallelの自身のAPIキーを提供する必要があります。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Web Search API Eval MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにWeb Search API Eval MCPをインストール
$ claude mcp add --env 'EXA_API_KEY=<YOUR_EXA_API_KEY>' --env 'PARALLEL_API_KEY=<YOUR_PARALLEL_API_KEY>' --env 'TAVILY_API_KEY=<YOUR_TAVILY_API_KEY>' --env 'YDC_API_KEY=<YOUR_YDC_API_KEY>' websearch-api-eval -- npx -y websearch-api-eval-mcpCursorにWeb Search API Eval MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"websearch-api-eval": {
"command": "npx",
"args": [
"-y",
"websearch-api-eval-mcp"
],
"env": {
"EXA_API_KEY": "<YOUR_EXA_API_KEY>",
"PARALLEL_API_KEY": "<YOUR_PARALLEL_API_KEY>",
"TAVILY_API_KEY": "<YOUR_TAVILY_API_KEY>",
"YDC_API_KEY": "<YOUR_YDC_API_KEY>"
}
}
}
}VS CodeにWeb Search API Eval MCPをインストール
.vscode/mcp.json
{
"servers": {
"websearch-api-eval": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"websearch-api-eval-mcp"
],
"env": {
"EXA_API_KEY": "<YOUR_EXA_API_KEY>",
"PARALLEL_API_KEY": "<YOUR_PARALLEL_API_KEY>",
"TAVILY_API_KEY": "<YOUR_TAVILY_API_KEY>",
"YDC_API_KEY": "<YOUR_YDC_API_KEY>"
}
}
}
}VS Code CLIにWeb Search API Eval MCPをインストール
$ code --add-mcp '{"name":"websearch-api-eval","type":"stdio","command":"npx","args":["-y","websearch-api-eval-mcp"],"env":{"EXA_API_KEY":"<YOUR_EXA_API_KEY>","PARALLEL_API_KEY":"<YOUR_PARALLEL_API_KEY>","TAVILY_API_KEY":"<YOUR_TAVILY_API_KEY>","YDC_API_KEY":"<YOUR_YDC_API_KEY>"}}'Claude DesktopにWeb Search API Eval MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"websearch-api-eval": {
"command": "npx",
"args": [
"-y",
"websearch-api-eval-mcp"
],
"env": {
"EXA_API_KEY": "<YOUR_EXA_API_KEY>",
"PARALLEL_API_KEY": "<YOUR_PARALLEL_API_KEY>",
"TAVILY_API_KEY": "<YOUR_TAVILY_API_KEY>",
"YDC_API_KEY": "<YOUR_YDC_API_KEY>"
}
}
}
}CodexにWeb Search API Eval MCPをインストール
$ codex mcp add websearch-api-eval --env 'EXA_API_KEY=<YOUR_EXA_API_KEY>' --env 'PARALLEL_API_KEY=<YOUR_PARALLEL_API_KEY>' --env 'TAVILY_API_KEY=<YOUR_TAVILY_API_KEY>' --env 'YDC_API_KEY=<YOUR_YDC_API_KEY>' -- npx -y websearch-api-eval-mcpCodex config.tomlにWeb Search API Eval MCPをインストール
~/.codex/config.toml
[mcp_servers.websearch-api-eval] command = "npx" args = ["-y", "websearch-api-eval-mcp"] [mcp_servers.websearch-api-eval.env] EXA_API_KEY = "<YOUR_EXA_API_KEY>" PARALLEL_API_KEY = "<YOUR_PARALLEL_API_KEY>" TAVILY_API_KEY = "<YOUR_TAVILY_API_KEY>" YDC_API_KEY = "<YOUR_YDC_API_KEY>"
Gemini CLIにWeb Search API Eval MCPをインストール
$ gemini mcp add -s user -e 'EXA_API_KEY=<YOUR_EXA_API_KEY>' -e 'PARALLEL_API_KEY=<YOUR_PARALLEL_API_KEY>' -e 'TAVILY_API_KEY=<YOUR_TAVILY_API_KEY>' -e 'YDC_API_KEY=<YOUR_YDC_API_KEY>' websearch-api-eval npx -- -y websearch-api-eval-mcpGemini settings.jsonにWeb Search API Eval MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"websearch-api-eval": {
"command": "npx",
"args": [
"-y",
"websearch-api-eval-mcp"
],
"env": {
"EXA_API_KEY": "<YOUR_EXA_API_KEY>",
"PARALLEL_API_KEY": "<YOUR_PARALLEL_API_KEY>",
"TAVILY_API_KEY": "<YOUR_TAVILY_API_KEY>",
"YDC_API_KEY": "<YOUR_YDC_API_KEY>"
}
}
}
}Web Search API Eval MCPツール 9
READMEから検出get_overall_resultsget_scorecardcompare_providersrecommend_providerlist_questionsget_questionget_chartsget_methodologyhow_to_run_locally
| get_overall_results | — | |
| get_scorecard | — | |
| compare_providers | — | |
| recommend_provider | — | |
| list_questions | — | |
| get_question | — | |
| get_charts | — | |
| get_methodology | — | |
| how_to_run_locally | — |
設定
EXA_API_KEYシークレットOptional. Exa API key, used only by run_live_search
PARALLEL_API_KEYシークレットOptional. Parallel API key, used only by run_live_search
TAVILY_API_KEYシークレットOptional. Tavily API key, used only by run_live_search
YDC_API_KEYシークレットOptional. You.com API key, used only by run_live_search
| 名前 | 説明 | 種類 |
|---|---|---|
| EXA_API_KEY | Optional. Exa API key, used only by run_live_search | シークレット |
| PARALLEL_API_KEY | Optional. Parallel API key, used only by run_live_search | シークレット |
| TAVILY_API_KEY | Optional. Tavily API key, used only by run_live_search | シークレット |
| YDC_API_KEY | Optional. You.com API key, used only by run_live_search | シークレット |
自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用合格
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見るWeb Search API Eval: MCP server
An MCP server that lets Claude, ChatGPT, Cursor and other AI assistants answer questions about the Web Search API Eval benchmark (You.com, Tavily, Exa and Parallel on 30 agent queries), and run your own live search spot checks.
Use it two ways:
| Hosted (no install) | Local (npm) | |
|---|---|---|
| Connect | https://websearch-api-eval.psberkeleymba.workers.dev/mcp |
npx -y websearch-api-eval-mcp |
| Works in | Claude, ChatGPT, any remote MCP client | Claude Desktop, Claude Code, Cursor, VS Code, any stdio MCP client |
| Benchmark tools | ✅ | ✅ |
run_live_search with your own keys |
— | ✅ |
Install
Claude Code
claude mcp add websearch-api-eval -- npx -y websearch-api-eval-mcp
Claude Desktop, Cursor, VS Code (add to the client's MCP config):
{
"mcpServers": {
"websearch-api-eval": {
"command": "npx",
"args": ["-y", "websearch-api-eval-mcp"],
"env": {
"YDC_API_KEY": "optional",
"TAVILY_API_KEY": "optional",
"EXA_API_KEY": "optional",
"PARALLEL_API_KEY": "optional"
}
}
}
}
The keys are optional and only used by run_live_search. Leave out any provider you don't have a key for. Requires Node.js 18 or later.
Hosted, no install: in Claude, Settings → Connectors → Add custom connector → paste the hosted URL. In ChatGPT, create an app in Developer mode with the same URL and no authentication.
Tools
| Tool | Returns |
|---|---|
get_overall_results |
Headline, overall scorecard, per-use-case summary, which API fits which agent, developer activation |
get_scorecard |
Full scorecard for overall, gtm, insurance or finance |
compare_providers |
Two or more providers side by side, optionally filtered by metric keyword |
recommend_provider |
Which API fits an agent's need, with supporting numbers |
list_questions |
The 30 questions, filterable by use case |
get_question |
One question: task, search call, answer key, sources, what each API returned and its score |
get_charts |
The published graphs; with chart_id, also the image |
get_methodology |
How tests ran and were graded, the 10 metrics and their standards, limits |
how_to_run_locally |
Steps and keys to rerun the full benchmark on your own machine |
search, fetch |
Generic search and document fetch (used by ChatGPT research features) |
run_live_search (local only) |
Sends one query to each provider using your own API keys and returns latency, result count and top results |
The benchmark tools are read-only and read the published results (run Oct 8, 2026). run_live_search calls the providers directly from your machine with your keys and uses your own credits; a single call is a spot check, not a graded benchmark. For the full graded run, use the harness.
Example questions
- "Which web search API is fastest for a voice agent?"
- "Compare Exa and Parallel on finance."
- "What was question F5 and who got it right?"
- "Show me the overall scorecard chart."
- "Run a live search for 'FOMC minutes' and compare the providers."
Data and updates
Results come from data/*.json on the published site, built from the Evaluation page by data/build_data.py. After a new benchmark run, rebuild the data and push; both the hosted and npm servers pick it up with no redeploy or new release.
Develop
cd mcp
npm install
npx wrangler dev # hosted server locally at http://localhost:8787/mcp
npm run build # npm package entry at dist/cli.js
npx @modelcontextprotocol/inspector@0.17.2 node dist/cli.js # call tools by hand
npx wrangler deploy # deploy the hosted server
npm publish # publish the npm package
Built with the official MCP TypeScript SDK. Registry entry: io.github.psinglap/websearch-api-eval (server.json).
Privacy and support
No sign-in, no cookies, no storage, no request logging. Privacy Policy · Terms · Support · MIT License
Web Search API Eval MCPのよくある質問
Web Search API Eval MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'EXA_API_KEY=<YOUR_EXA_API_KEY>' --env 'PARALLEL_API_KEY=<YOUR_PARALLEL_API_KEY>' --env 'TAVILY_API_KEY=<YOUR_TAVILY_API_KEY>' --env 'YDC_API_KEY=<YOUR_YDC_API_KEY>' websearch-api-eval -- npx -y websearch-api-eval-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Web Search API Eval MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Web Search API Eval MCPが提供するツールは
9個のツールを提供しており、get_overall_results, get_scorecard, compare_providers, recommend_provider, list_questionsなどがあります。
自分のAPIキーを使用してライブ検索を実行できますか?
はい、ローカルのnpmインストールを使用する場合、自身のプロバイダーキーを使用してrun_live_searchツールを利用できます。
ライブ検索とベンチマークの違いは何ですか?
ベンチマークツールは読み取り専用で公開された結果にアクセスするものです。一方、run_live_searchは自身のクレジットとキーを使用するスポットチェックです。