Позволяет ИИ-ассистентам запрашивать бенчмарки веб-поисковых API и проводить живые проверки поиска через таких провайдеров, как You.com, Tavily, Exa и Parallel.
Также известен как psinglap/websearch-api-eval, websearch-api-eval, websearch-api-eval-mcp
- Звёзды
- 4
- Инструменты
- 9
- Загрузки, 30 дней
- —
- Последняя версия
- 1.1.0
- Последний коммит
- 27 окт. 2026 г.
- Лицензия
- MIT
Что такое Web Search API Eval MCP?
Web Search API Eval — это MCP server. Позволяет ИИ-ассистентам запрашивать бенчмарки веб-поисковых API и проводить живые проверки поиска через таких провайдеров, как You.com, Tavily, Exa и Parallel. Он предоставляет 9 инструментов, например get_overall_results, get_scorecard, compare_providers.
Сводка сгенерирована из README проекта
О Web Search API Eval MCP server
Этот сервер позволяет разработчикам, использующим ИИ-ассистентов, сравнивать производительность веб-поисковых API и проводить живые проверки. Он предоставляет доступ к специализированному бенчмарку, оценивающему You.com, Tavily, Exa и Parallel на основе тридцати запросов агентов. Пользователи могут запрашивать опубликованные данные, чтобы определить, какой провайдер лучше всего подходит для конкретных сценариев, таких как финансы или страхование.
Этот сервер можно использовать как хостинговый сервис через URL для удаленных клиентов, таких как ChatGPT и Claude, или установить локально через npm для десктопных сред, таких как Cursor, VS Code и Claude Desktop. Хотя инструменты бенчмарка доступны только для чтения, локальная установка позволяет проводить живое тестирование с помощью инструмента run_live_search. Эта функция требует наличия ваших собственных API-ключей для YDC, Tavily, Exa или Parallel в конфигурации для сравнения задержки и результатов в реальном времени.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Web Search API Eval MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка 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Установка Web Search API Eval MCP в Cursor
~/.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>"
}
}
}
}Установка Web Search API Eval MCP в VS Code
.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>"
}
}
}
}Установка Web Search API Eval MCP в VS Code CLI
$ 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>"}}'Установка Web Search API Eval MCP в Claude Desktop
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>"
}
}
}
}Установка Web Search API Eval MCP в Codex
$ 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-mcpУстановка Web Search API Eval MCP в Codex config.toml
~/.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>"
Установка Web Search API Eval MCP в Gemini CLI
$ 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-mcpУстановка Web Search API Eval MCP в Gemini settings.json
~/.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
Определено из READMEget_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 | Секрет |
Автоматические проверки
Запущено 12 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийПройдено
- Open source лицензия (OSI)Пройдено
- Коммит или релиз за последний годПройдено
- Имя пакета не похоже на популярный пакетПройдено
- Удаленная конечная точка использует HTTPSПройдено
- Деструктивные инструменты помеченыПройдено
- Нет скрытых инструкций для моделиПройдено
- Нет критических предупреждений в пакете или его зависимостяхПройдено
README
Открыть на GitHubWeb 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 и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет 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 — это точечная проверка, которая использует ваши собственные ключи и кредиты.