Ermöglicht es KI-Assistenten, Web-Search-API-Benchmarks abzufragen und Live-Such-Spotchecks über Anbieter wie You.com, Tavily, Exa und Parallel durchzuführen.
Auch bekannt als psinglap/websearch-api-eval, websearch-api-eval, websearch-api-eval-mcp
- Stars
- 4
- Tools
- 9
- Downloads, 30 Tage
- —
- Neueste Version
- 1.1.0
- Letzter Commit
- 27. Okt. 2026
- Lizenz
- MIT
Was ist Web Search API Eval MCP?
Web Search API Eval ist ein MCP server. Ermöglicht es KI-Assistenten, Web-Search-API-Benchmarks abzufragen und Live-Such-Spotchecks über Anbieter wie You.com, Tavily, Exa und Parallel durchzuführen. Er stellt 9 Tools bereit, etwa get_overall_results, get_scorecard, compare_providers.
Zusammenfassung generiert aus dem README des Projekts
Über Web Search API Eval MCP server
Dieser Server ermöglicht es Entwicklern, die Performance von Web-Search-APIs zu vergleichen und Live-Spotchecks mit KI-Assistenten durchzuführen. Er bietet Zugriff auf einen spezifischen Benchmark, der You.com, Tavily, Exa und Parallel anhand von dreißig Agent-Queries evaluiert. Nutzer können veröffentlichte Daten abfragen, um herauszufinden, welcher Anbieter am besten für spezifische Anwendungsfälle wie Finanzen oder Versicherungen geeignet ist.
Der Server kann als Hosted Service via URL für Remote-Clients wie ChatGPT und Claude genutzt werden oder lokal via npm für Desktop-Umgebungen wie Cursor, VS Code und Claude Desktop installiert werden. Während die Benchmark-Tools schreibgeschützt sind, erlaubt die lokale Installation Live-Tests über das run_live_search Tool. Diese spezielle Funktion erfordert, dass du deine eigenen API-Keys für YDC, Tavily, Exa oder Parallel in deiner Config bereitstellst, um Latenz und Ergebnisse in Echtzeit zu vergleichen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Web Search API Eval MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenWeb Search API Eval MCP in Claude Code installieren
$ 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-mcpWeb Search API Eval MCP in Cursor installieren
~/.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 in VS Code installieren
.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 in VS Code CLI installieren
$ 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 in Claude Desktop installieren
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 in Codex installieren
$ 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-mcpWeb Search API Eval MCP in Codex config.toml installieren
~/.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 in Gemini CLI installieren
$ 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-mcpWeb Search API Eval MCP in Gemini settings.json installieren
~/.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 tools 9
Erkannt aus dem 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 | — |
Konfiguration
EXA_API_KEYSecretOptional. Exa API key, used only by run_live_search
PARALLEL_API_KEYSecretOptional. Parallel API key, used only by run_live_search
TAVILY_API_KEYSecretOptional. Tavily API key, used only by run_live_search
YDC_API_KEYSecretOptional. You.com API key, used only by run_live_search
| Name | Beschreibung | Typ |
|---|---|---|
| EXA_API_KEY | Optional. Exa API key, used only by run_live_search | Secret |
| PARALLEL_API_KEY | Optional. Parallel API key, used only by run_live_search | Secret |
| TAVILY_API_KEY | Optional. Tavily API key, used only by run_live_search | Secret |
| YDC_API_KEY | Optional. You.com API key, used only by run_live_search | Secret |
Automatisierte Checks
Geluften am 12. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSBestanden
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenWeb 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 Fragen
Wie füge ich Web Search API Eval MCP zu Claude Code hinzu?
Führe 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 in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Web Search API Eval MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Web Search API Eval MCP?
Er stellt 9 Tools bereit, darunter get_overall_results, get_scorecard, compare_providers, recommend_provider, list_questions.
Kann ich Live-Suchen mit meinen eigenen API-Keys durchführen?
Ja, wenn du die lokale npm-Installation nutzt, kannst du das run_live_search Tool mit deinen eigenen Provider-Keys verwenden.
Was ist der Unterschied zwischen einer Live-Suche und dem Benchmark?
Die Benchmark-Tools sind schreibgeschützt und greifen auf veröffentlichte Ergebnisse zu, während run_live_search ein Spotcheck ist, der deine eigenen Credits und Keys nutzt.