web-search-zaimcp — Minimal CommonJS Utility

• Zero-dependency helper that calls the BigModel MCP webSearchPrime tool.
• Pure JavaScript (CommonJS), easy to embed in any agent framework or script.
• Handles double-stringified JSON and {items|results|data} wrappers. Each call now creates a fresh connection and closes it afterwards.

Files

• src/index.js — exports webSearchPrime(queryOrParams, options).
• examples/run-web-search.js — CLI example that loads .env and prints normalized results.

Prerequisites

• Node.js 18+.
• Install deps already listed in package.json (@modelcontextprotocol/sdk, dotenv).

Environment Setup

• Set BIGMODEL_API_KEY in your shell or add it to .env at repo root.
• Utilities never call dotenv automatically; every script should do require('dotenv').config() first.

Run the Example

• node examples/run-web-search.js "你的查询"
• Without args it defaults to 福建舰正式服役的外媒报道.
• Output prints - title + URL + optional summary snippet.

webSearchPrime Usage

• CommonJS: const { webSearchPrime } = require('web-search-zaimcp')
• ESM/TypeScript (CJS package default import):
  • import pkg from 'web-search-zaimcp'; const { webSearchPrime } = pkg;
  • Or createRequire: const { webSearchPrime } = createRequire(import.meta.url)('web-search-zaimcp')
• Accepts either a string ('query') or full MCP params object.
• Supported params mirror BigModel’s tool: search_query, count (1-50), content_size, location, search_domain_filter, search_recency_filter.
• options (all optional):
  • apiKey (defaults to process.env.BIGMODEL_API_KEY).
  • endpoint (defaults to official WebSearch Prime MCP endpoint).
  • reuseConnection (deprecated; ignored — connections are per call).

TypeScript

• This package ships src/index.d.ts and sets "types" and exports.types.
• With NodeNext resolution, exports.default enables ESM default import to the CJS entry.

Return Value

• { items, rawBlocks } where each item includes { title, url, summary, icon, siteName, media, publishedAt, refer, raw }.
• rawBlocks exposes the original MCP text blocks for debugging or custom parsing.

Integrating With Agents

• Wrap webSearchPrime inside any framework’s tool abstraction (LangChain StructuredTool, deepagents, LangGraph, custom orchestrators).
• Typical handler: const { items } = await webSearchPrime(args); return JSON.stringify(items).

Further Customization

• Add your own timeout wrapper via Promise.race if needed.
• For TS users, consider adding a thin .d.ts file or porting the helper to .ts with types.
• Modify _normalizeItems in src/index.js if you need different fields.