{"_id":"@guhcostan/web-search-mcp","_rev":"4-76747863d01035ba0a21647caf530ac2","name":"@guhcostan/web-search-mcp","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.2":{"name":"@guhcostan/web-search-mcp","version":"1.0.2","keywords":["mcp","modelcontextprotocol","web","search","scrape"],"author":"","license":"MIT","_id":"@guhcostan/web-search-mcp@1.0.2","maintainers":[{"name":"guhcostan","email":"guhcostan@gmail.com"}],"bin":{"web-search-mcp":"dist/server.js"},"dist":{"shasum":"6e74a4842578a3545780f3748142be8f4677f0b0","tarball":"https://registry.npmjs.org/@guhcostan/web-search-mcp/-/web-search-mcp-1.0.2.tgz","fileCount":4,"integrity":"sha512-NXqsQ8Wuqlw+ofwhEPP8AvtNhmUlXDcEx3WaS5MHb5s8nIW8NQDRs00Dujol6UOxEqbyzgv8n+fpVe6AIW96+w==","signatures":[{"sig":"MEQCIG2c+Yf/aggY0zhj6UU8y7ICCpK8f4YyIxhi5ZEwXCXYAiAr1AazTOLWFPl4lrDuRot1t8DKxMcQiDk3KSzl4xT7hQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9164},"type":"module","engines":{"node":">=20"},"prepare":"npm run build","scripts":{"lint":"eslint .","test":"vitest run","build":"npm run clean && tsc -p tsconfig.build.json","check":"tsc -p tsconfig.json --noEmit && eslint . && vitest run","clean":"rimraf dist","smoke":"tsx scripts/smoke.ts","start":"tsx src/server.ts"},"_npmUser":{"name":"guhcostan","email":"guhcostan@gmail.com"},"_npmVersion":"10.5.2","description":"MCP server to search the web and fetch page contents","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.23.8","jsdom":"^26.1.0","dotenv":"^17.2.1","undici":"^7.13.0","@mozilla/readability":"^0.6.0","@modelcontextprotocol/sdk":"^1.17.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.3","eslint":"^9.32.0","rimraf":"^6.0.1","vitest":"^3.2.4","globals":"^16.3.0","typescript":"^5.9.2","@types/node":"^24.2.0","@types/jsdom":"^21.1.7","@typescript-eslint/parser":"^8.39.0","@typescript-eslint/eslint-plugin":"^8.39.0"},"_npmOperationalInternal":{"tmp":"tmp/web-search-mcp_1.0.2_1754660798996_0.21616789655134183","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@guhcostan/web-search-mcp","version":"1.0.3","keywords":["mcp","modelcontextprotocol","web","search","scrape"],"author":"","license":"MIT","_id":"@guhcostan/web-search-mcp@1.0.3","maintainers":[{"name":"guhcostan","email":"guhcostan@gmail.com"}],"bin":{"web-search-mcp":"dist/server.js"},"dist":{"shasum":"2e19c7a785e99db3b1d59d410aea6ee47309ff33","tarball":"https://registry.npmjs.org/@guhcostan/web-search-mcp/-/web-search-mcp-1.0.3.tgz","fileCount":4,"integrity":"sha512-0FnnsVEDXA72sMeWE+KkK4+f/w7PjDXLBRj3KWmxhaAfvPwnkWsAiQoMO8SJSArbnNT09BLW6nX3XtmEttwPLQ==","signatures":[{"sig":"MEUCIElfzhEQoTIMA6hznaaTGJk8pNMhziZdzAOfNhVDmKjDAiEA5jch5PY4QG5CM2+prP98d62Em0qvESLcHxpHjUNCnJY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9370},"type":"module","engines":{"node":">=20"},"prepare":"npm run build","scripts":{"lint":"eslint .","test":"vitest run","build":"npm run clean && tsc -p tsconfig.build.json","check":"tsc -p tsconfig.json --noEmit && eslint . && vitest run","clean":"rimraf dist","smoke":"tsx scripts/smoke.ts","start":"tsx src/server.ts"},"_npmUser":{"name":"guhcostan","email":"guhcostan@gmail.com"},"_npmVersion":"10.5.2","description":"MCP server to search the web and fetch page contents","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.23.8","jsdom":"^26.1.0","dotenv":"^17.2.1","undici":"^7.13.0","@mozilla/readability":"^0.6.0","@modelcontextprotocol/sdk":"^1.17.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.3","eslint":"^9.32.0","rimraf":"^6.0.1","vitest":"^3.2.4","globals":"^16.3.0","typescript":"^5.9.2","@types/node":"^24.2.0","@types/jsdom":"^21.1.7","@typescript-eslint/parser":"^8.39.0","@typescript-eslint/eslint-plugin":"^8.39.0"},"_npmOperationalInternal":{"tmp":"tmp/web-search-mcp_1.0.3_1754660860919_0.18559367383049818","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@guhcostan/web-search-mcp","version":"1.0.4","keywords":["mcp","modelcontextprotocol","web","search","scrape"],"author":"","license":"MIT","_id":"@guhcostan/web-search-mcp@1.0.4","maintainers":[{"name":"guhcostan","email":"guhcostan@gmail.com"}],"homepage":"https://github.com/guhcostan/web-search-mcp#readme","bugs":{"url":"https://github.com/guhcostan/web-search-mcp/issues"},"bin":{"web-search-mcp":"dist/server.js"},"dist":{"shasum":"bdb1528cc2231c7bfd01b8d2dbe2befe23d6737b","tarball":"https://registry.npmjs.org/@guhcostan/web-search-mcp/-/web-search-mcp-1.0.4.tgz","fileCount":4,"integrity":"sha512-FYPurhhWqPjxwxh3BPY3Mz8QrVGO6mC61VPK6yU3AEW4THAuE/qmjJY8unWFAAUj+H7zeGo3AGZRKpapXTKCJA==","signatures":[{"sig":"MEQCIE+Zk4JgOJcG8GyBdKHkmgvjvmV76FJ57OiYFXeJB0CqAiB6BCZcdUJCzvzddfBv13D1KVcWz3pCvFf5IdXSfEM7WQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9626},"type":"module","engines":{"node":">=20"},"gitHead":"6f606435a07caf974a7e61d88ce9931ce01ff079","prepare":"npm run build","scripts":{"lint":"eslint .","test":"vitest run","build":"npm run clean && tsc -p tsconfig.build.json","check":"tsc -p tsconfig.json --noEmit && eslint . && vitest run","clean":"rimraf dist","smoke":"tsx scripts/smoke.ts","start":"tsx src/server.ts"},"_npmUser":{"name":"guhcostan","email":"guhcostan@gmail.com"},"repository":{"url":"git+https://github.com/guhcostan/web-search-mcp.git","type":"git"},"_npmVersion":"10.5.2","description":"MCP server to search the web and fetch page contents","directories":{},"_nodeVersion":"20.13.1","dependencies":{"zod":"^3.23.8","jsdom":"^26.1.0","dotenv":"^17.2.1","undici":"^7.13.0","@mozilla/readability":"^0.6.0","@modelcontextprotocol/sdk":"^1.17.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.3","eslint":"^9.32.0","rimraf":"^6.0.1","vitest":"^3.2.4","globals":"^16.3.0","typescript":"^5.9.2","@types/node":"^24.2.0","@types/jsdom":"^21.1.7","@typescript-eslint/parser":"^8.39.0","@typescript-eslint/eslint-plugin":"^8.39.0"},"_npmOperationalInternal":{"tmp":"tmp/web-search-mcp_1.0.4_1754661057990_0.6484260215428741","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@guhcostan/web-search-mcp","version":"1.0.5","type":"module","description":"MCP server to search the web and fetch page contents","bin":{"web-search-mcp":"dist/server.js"},"scripts":{"start":"tsx src/server.ts","clean":"rimraf dist","build":"npm run clean && tsc -p tsconfig.build.json","lint":"eslint .","test":"vitest run","check":"tsc -p tsconfig.json --noEmit && eslint . && vitest run","smoke":"tsx scripts/smoke.ts"},"engines":{"node":">=20"},"publishConfig":{"access":"public"},"prepare":"npm run build","repository":{"type":"git","url":"git+https://github.com/guhcostan/web-search-mcp.git"},"bugs":{"url":"https://github.com/guhcostan/web-search-mcp/issues"},"homepage":"https://github.com/guhcostan/web-search-mcp#readme","keywords":["mcp","modelcontextprotocol","web","search","scrape"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.17.2","@mozilla/readability":"^0.6.0","dotenv":"^17.2.1","jsdom":"^26.1.0","undici":"^7.13.0","zod":"^3.23.8"},"devDependencies":{"@types/jsdom":"^21.1.7","@types/node":"^24.2.0","@typescript-eslint/eslint-plugin":"^8.39.0","@typescript-eslint/parser":"^8.39.0","eslint":"^9.32.0","globals":"^16.3.0","rimraf":"^6.0.1","tsx":"^4.20.3","typescript":"^5.9.2","vitest":"^3.2.4"},"_id":"@guhcostan/web-search-mcp@1.0.5","gitHead":"e70b1baba9b72fea7943b309ceb78eeb457bdccf","_nodeVersion":"20.13.1","_npmVersion":"10.5.2","dist":{"integrity":"sha512-MhrVrcEFN4eJ8Azw/fF9f4P2T/6+oKOxw2Wg5dSc7RJZNnjA8jr37VqkaHAtfNyOSz06XR/TL+Ue6U8lcOixjg==","shasum":"dcb898db4946e1dffdb680e2e07908cac4da9b5a","tarball":"https://registry.npmjs.org/@guhcostan/web-search-mcp/-/web-search-mcp-1.0.5.tgz","fileCount":4,"unpackedSize":9630,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAOLV3z7iPiSn4RTy5Uitwdw9uLE4pd3yH+iVmTfNKT9AiBPIhLPtN9x+k4XIbQOCvMjk2bDccG6DreKoZPstaPgzA=="}]},"_npmUser":{"name":"guhcostan","email":"guhcostan@gmail.com"},"directories":{},"maintainers":[{"name":"guhcostan","email":"guhcostan@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/web-search-mcp_1.0.5_1754661129529_0.5714049264992975"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-08T13:46:38.869Z","modified":"2025-08-08T13:52:09.876Z","1.0.2":"2025-08-08T13:46:39.178Z","1.0.3":"2025-08-08T13:47:41.095Z","1.0.4":"2025-08-08T13:50:58.151Z","1.0.5":"2025-08-08T13:52:09.714Z"},"bugs":{"url":"https://github.com/guhcostan/web-search-mcp/issues"},"license":"MIT","homepage":"https://github.com/guhcostan/web-search-mcp#readme","keywords":["mcp","modelcontextprotocol","web","search","scrape"],"repository":{"type":"git","url":"git+https://github.com/guhcostan/web-search-mcp.git"},"description":"MCP server to search the web and fetch page contents","maintainers":[{"name":"guhcostan","email":"guhcostan@gmail.com"}],"readme":"## Web Search MCP\n\nMinimal MCP server that can search the web and extract readable page content, similar to Cursor's built-in web context.\n\n### Features\n\n- **search_web**: Query the web (DuckDuckGo HTML) and return result URLs and titles\n- **fetch_page**: Fetch any URL and extract readable content using Mozilla Readability + JSDOM\n\n### Requirements\n\n- Node.js 20+ (recommended: 20.18.1+)\n\n### Install\n\n```bash\nnpm install\n```\n\n### Run (stdio)\n\n```bash\nnpm start\n```\n\n### Install globally\n\n```bash\nnpm i -g @guhcostan/web-search-mcp\n```\n\nThen reference the binary `web-search-mcp`.\n\n### Integrate with Cursor (MCP)\n\nAdd to your Cursor MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"web-search-mcp\": { \"command\": \"web-search-mcp\" }\n  }\n}\n```\n\nAlternatively, without global install, use npx:\n\n```json\n{\n  \"mcpServers\": {\n    \"web-search-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@guhcostan/web-search-mcp@latest\"]\n    }\n  }\n}\n```\n\n### Tools\n\n- **search_web**\n  - input:\n    - `query` (string, required)\n    - `limit` (number, optional, 1–10, default 5)\n  - output: array of `{ url: string; title?: string; snippet?: string }`\n\n- **fetch_page**\n  - input:\n    - `url` (string URL, required)\n  - output: `{ url: string; title?: string; content: string }`\n\n### Development\n\nType-check, lint and tests:\n\n```bash\nnpm run check\n```\n\nRun individually:\n\n```bash\nnpm run build\nnpm run lint\nnpm test\n```\n\n### Notes\n\n- Web search uses DuckDuckGo HTML; results may vary and are HTML-scraped (no API key required)\n- Be mindful of target site terms of use and robots policies when fetching pages\n\n### License\n\nMIT\n\n","readmeFilename":"README.md"}